{
+ const name = await prompt({
+ header: "What is the new client name?",
+ });
+ if (typeof name === "string") {
+ const result = await netSend("clientSetName", {name});
+ }
+ }}
+ >
+ {clientData?.client.name || ""}
+
+
+
+
+ );
+}
+
+function AppRoutes() {
+ useCardDataSubscribe();
+ return (
+
+ : }
+ />
+ } />
+ } />
+ } />
+
+ );
+}
+function App() {
+ return (
+
+
+
+ );
+}
+
+export default App;
diff --git a/client/src/cards/README.md b/client/src/cards/README.md
new file mode 100644
index 00000000..442587a6
--- /dev/null
+++ b/client/src/cards/README.md
@@ -0,0 +1,137 @@
+# Cards & Cores
+
+This folder contains the React components and data requirements for the Cards
+and Cores in Thorium Nova. These are the main UI building blocks.
+
+Each Card is an individual screen that contains all of the controls and switches
+to perform some function on the Simulator. Cards can be granular, such as a card
+that only raises and lowers the shields, or a card that organizes and relays
+orders to security teams; cards could also combine functionality, such as a card
+that shows a sensor grid, navigation controls, and weapons controls on a single
+screen for single-player simulations.
+
+Cores are used by the Flight Director to adjust individual aspects of the
+simulation. Like Cards, Cores can be individual and granular, like changing the
+alert condition or setting a timer; or they can combine many functions together,
+like displaying all of the ships in a solar system on a starmap, along with
+metadata about those ships.
+
+## Conventions
+
+Cards and Cores are all exported from the `index.ts` file located in this
+folder, each in their own list. Both should be React components that are more or
+less self-contained. Card identifiers should just be the name of the card, like
+"WeaponsControl" or "Navigation", while Cores should append "Core" to the name,
+like "SystemsCore" and "DamageControlCore".
+
+## DataContext
+
+There is a fairly common type used in the data fetching functions called
+`DataContext`. This represents data and methods associated with a specific
+client that should be available any time there's data fetching happening. It
+includes the client's ID, a reference to the server data store which includes
+all of the client objects, the flight data store which includes the ECS world
+and all of the entities, and several getter functions to make accessing things
+easier, like the ship entity that the client is assigned to.
+
+## Defining Data Dependencies
+
+Data is handled separately from the components themselves, to make sure the
+server doesn't have to load more code than it needs to, and vice versa. Data
+needs are defined in a `subscriptions.ts` file inside the card folder. There are
+two exports from this file: One for low-frequency subscriptions and another for
+high-frequency data streams.
+
+### Subscriptions
+
+Subscriptions are intended for low-frequency (less than twice a second) updates
+that might have larger data payloads. This is the most commonly used method for
+transferring data from the server to the client.
+
+Subscriptions are defined by exporting a `subscriptions` object from
+`subscriptions.ts`. The properties of this object represent different
+subscription action names. These action names are used by the `pubsub.publish`
+function to actually trigger sending the data to the client. Calling
+`pubsub.publish` usually happens in an input definition, but it could happen in
+an infrequently triggered ECS System.
+
+Let's look at a complete example to see how all the parts work together.
+
+```ts
+// /client/src/cards/WeaponsControl/subscriptions.ts
+export const subscriptions = {
+ phasers: {
+ filter: (params: {shipId: string}, context: DataContext) => {
+ return context.ship.id === params.shipId;
+ },
+ fetch: (context: DataContext) => {
+ const phaserSystems = context.flight.ecs.entities.filter(
+ entity =>
+ !!entity.components.phasers &&
+ entity.components.shipAssignment.shipId === context.ship.id
+ );
+
+ return phaserSystems;
+ },
+ },
+};
+
+// /server/src/inputs/phasers.ts
+export const phasersInput = {
+ phasersCharge(context: DataContext, params: {phaserId: number}) {
+ const phaserEntity = context.flight.ecs.getEntityById(params.phaserId);
+ phaserEntity.components.phasers.charging = true;
+ pubsub.publish("phasers", {
+ shipId: phaserEntity.components.shipAssignment.shipId,
+ });
+ },
+};
+```
+
+We'll go through each of these pieces one by one. Check out the
+`/server/src/inputs/README.md` file for more information on inputs.
+
+#### Action Name
+
+The property names of the `subscriptions` object are the action names which are
+used by `pubsub.publish`. These action names are not unique across all of
+Thorium Nova, since many cards might rely on the same `pubsub.publish` calls to
+trigger subscriptions. This does mean that the `filter` function for a given
+action name should have the same params across all of Thorium Nova.
+
+TypeScript will automatically add type checking and autocomplete for these names
+when you use `pubsub.publish`.
+
+#### filter (Optional)
+
+The filter function takes two parameters - the publish params and DataContext -
+and returns a boolean. This function is called for each client. If the function
+returns true, then that client will get a subscription update; otherwise it
+won't. If this function is omitted, every client will get the subscription
+update when `pubsub.publish` is called.
+
+The first `params` parameter should always have a type annotation on it. This is
+automatically picked up by the `pubsub.publish` function.
+
+#### fetch
+
+The required fetch function only receives the DataContext for a given client.
+Using only that, it grabs the necessary data that corresponds to that particular
+subscription for that particular client. This most likely means finding specific
+entities associated with the ship the client is assigned to. Whatever is
+returned by this function will be sent to the client.
+
+The fetch function doesn't take any extra parameters, because it has to be
+called when the client first connects, and aside from the data context, the
+server doesn't know anything else about the client's state.
+
+#### pubsub.publish
+
+The publish function is available through the `pubsub` module located in
+`/server/src/utils/pubsub.ts`. It's called with a subscription action name, and
+optionally any params which are sent to the `fetch` function.
+
+#### Suggestions for Writing Subscriptions
+
+Subscriptions should be defined as narrowly as possible, and cards should have
+as many subscriptions as are necessary to get all of the data.
diff --git a/client/src/cards/clients/data.ts b/client/src/cards/clients/data.ts
new file mode 100644
index 00000000..f494546f
--- /dev/null
+++ b/client/src/cards/clients/data.ts
@@ -0,0 +1,12 @@
+import {DataContext} from "server/src/utils/DataContext";
+
+export const subscriptions = {
+ clientList: {
+ fetch: async (context: DataContext) => {
+ const data = Object.values(context.server.clients).map(c =>
+ c.serialize()
+ );
+ return data;
+ },
+ },
+};
diff --git a/client/src/cards/clients/index.tsx b/client/src/cards/clients/index.tsx
new file mode 100644
index 00000000..340367dd
--- /dev/null
+++ b/client/src/cards/clients/index.tsx
@@ -0,0 +1,7 @@
+export const card = () => {
+ return (
+
+
Clients
+
+ );
+};
diff --git a/client/src/cards/data.ts b/client/src/cards/data.ts
new file mode 100644
index 00000000..5b570388
--- /dev/null
+++ b/client/src/cards/data.ts
@@ -0,0 +1,65 @@
+import {DataContext} from "server/src/utils/DataContext";
+import fs from "fs/promises";
+import {thoriumPath} from "server/src/utils/appPaths";
+import type {FlightDataModel} from "server/src/classes/FlightDataModel";
+import {Entity} from "server/src/utils/ecs";
+
+// This file is used for any subscriptions which all clients
+// make, regardless of what cards they have.
+export const subscriptions = {
+ client: {
+ filter: (params: {clientId: string}, context: DataContext) => {
+ return context.clientId === params.clientId;
+ },
+ fetch: (context: DataContext) => {
+ // TODO Aug 31, 2021 - Merge this data with the flight client data
+ // or create a new subscription just for the flight client.
+ const {id, name, connected} = context.server.clients[context.clientId];
+ return {id, name, connected};
+ },
+ },
+ flight: {
+ fetch(context: DataContext) {
+ const flight = context.flight;
+ if (!flight) return null;
+ const {id, date, name, paused} = flight;
+ return {id, date, name, paused};
+ },
+ },
+ flights: {
+ async fetch(context: DataContext) {
+ let files: string[];
+ try {
+ files = await fs.readdir(`${thoriumPath}flights/`);
+ } catch {
+ await fs.mkdir(`${thoriumPath}flights/`);
+ files = [];
+ }
+ const flightFiles = files.filter(f => f.includes(".flight"));
+ const flightData = await Promise.all(
+ flightFiles.map(async flightName => {
+ const raw = await fs.readFile(
+ `${thoriumPath}flights/${flightName}`,
+ "utf-8"
+ );
+ const data = JSON.parse(raw);
+ return {...data, date: new Date(data.date)} as FlightDataModel;
+ })
+ );
+ return flightData;
+ },
+ },
+ dots: {
+ fetch(context: DataContext) {
+ return (
+ context.flight?.ecs.entities
+ .filter(e => e.components.position && e.components.velocity)
+ .map(e => ({id: e.id, color: e.components.color?.color})) || []
+ );
+ },
+ },
+};
+
+export function dataStream(entity: Entity, context: DataContext): boolean {
+ return !!(entity.components.position && entity.components.velocity);
+}
diff --git a/client/src/cards/dataList.ts b/client/src/cards/dataList.ts
new file mode 100644
index 00000000..95aba579
--- /dev/null
+++ b/client/src/cards/dataList.ts
@@ -0,0 +1,7 @@
+// The exported name _must_ be the same as the name of the card.
+export * as Clients from "./Clients/data";
+export * as Flights from "./Flights/data";
+
+// This is a special set of data that is available
+// on all cards.
+export * as allData from "./data";
diff --git a/client/src/cards/flights/data.ts b/client/src/cards/flights/data.ts
new file mode 100644
index 00000000..f716e341
--- /dev/null
+++ b/client/src/cards/flights/data.ts
@@ -0,0 +1,12 @@
+import {DataContext} from "server/src/utils/DataContext";
+
+export const subscriptions = {
+ flightsList: {
+ filter: (params: {flights: boolean}) => {
+ return params?.flights;
+ },
+ fetch: (context: DataContext) => {
+ return Object.values(context.server.clients).map(c => c.serialize());
+ },
+ },
+};
diff --git a/client/src/cards/flights/index.tsx b/client/src/cards/flights/index.tsx
new file mode 100644
index 00000000..9261d37f
--- /dev/null
+++ b/client/src/cards/flights/index.tsx
@@ -0,0 +1,15 @@
+import {DataContext} from "server/src/utils/types";
+
+export const card = () => {
+ return (
+
+ );
+};
+
+export default Credits;
diff --git a/client/src/components/QuoteOfTheDay.tsx b/client/src/components/QuoteOfTheDay.tsx
new file mode 100644
index 00000000..b50f9e06
--- /dev/null
+++ b/client/src/components/QuoteOfTheDay.tsx
@@ -0,0 +1,186 @@
+import {useRef} from "react";
+
+const quotes = [
+ "Not all who wander are lost",
+ "If you don’t know where your destination is, you don’t know how long you have to wander",
+ "Its origin and purpose are still a total mystery...",
+ "For everything, there is a first time",
+ "I like to believe that there are always possibilities",
+ "Sometimes a feeling is all we humans have to go on.",
+ "Failure is the mark of a life well lived. In turn, the only way to live without failure is to be of no use to anyone.",
+ "History has its eyes on you.",
+ "We take one step at a time. In doing so we reach toward the unknown.",
+ "Where does this lead us? Where do we go?",
+ "If you listen carefully, the silence is beautiful.",
+ "The man who has no imagination has no wings.",
+ "Life before death. Strength before weakness. Journey before destination.",
+ "We are the ones we have been waiting for.",
+ "While you live, shine; have no grief at all. Life exists only for a short while and Time demands his due.",
+ "I am burdened with glorious purpose.",
+ "The hardest choices require the strongest wills.",
+ "Like a snowflake in a blizzard...",
+ "Fun isn’t something one considers when balancing the universe. But this… does put a smile on my face.",
+ "The work is done, as it always will be. I am inevitable.",
+ "It's better to look good than to feel good.",
+ "Some of us have to work for a living!",
+ "Educating minds with the discipline of wonder.",
+ "While others sleep, you dream.",
+ "I may not have gone where I intended to go, but I think I have ended up where I needed to be.",
+ // Douglas Adams
+ "Don't Panic.",
+ "Time is an illusion. Lunchtime doubly so.",
+ "I'd far rather be happy than right any day.",
+ "For a moment, nothing happened. Then, after a second or so, nothing continued to happen.",
+ "Reality is frequently inaccurate.",
+ "It is a mistake to think you can solve any major problems just with potatoes.",
+ // AI Generated Ship Names
+ "Dangerous But Not Unbearably So",
+ "So much for subtlety",
+ "Just as likely to still be an intergalactic jellyfish.",
+ "And the world will fall with ignorance...",
+ "You don't know I'm not crazy.",
+ "If you cannot do great things, do small things in a great way.",
+ "This is the way. I have spoken.",
+ "Suffering exists. It has a cause. It has an end. And there is a noble path to ending it.",
+ "We are what they grow beyond. That is the true burden of all masters.",
+ "We grow small trying to be great.",
+ "The whole point of getting things done is knowing what to leave undone.",
+ "The days are long, but the years are short.",
+ "I preferred to be called Nobody.",
+ "He who least needs tomorrow, will most gladly greet tomorrow.",
+ /* Banksy */
+ "They say you die twice; Once when you stop breathing and again when someone says your name for the last time.",
+ "There's nothing more dangerous than someone who wants to make the world a better place.",
+ "There are three kinds of people in this world: those who like you, those who hate you, and those who don't care about you.",
+ "I need someone to protect me from all the measures they take in order to protect me.",
+ "If you get tired, learn to rest, not to quit.",
+ "Be positive, patient, and persistent.",
+ "This revolution is for display purposes only.",
+ /* Back to regularly scheduled programming */
+ "Nobody knows what their story is until the end.",
+ "Love isn't a triangle. It's a five dimensional blob.",
+ "This spaceship doesn't come with an insurance plan.",
+ "There is some good news. There’s some cake left!",
+ "In case you were wondering, I am, by definition, the best version of myself.",
+ "I'm not crazy, I'm just colorful.",
+ "What we do in life, echoes in eternity.",
+ "Institutions have a future … but people have no future. People have only hope.",
+ // Klingon Proverbs
+ "Destroying an empire to win a war is no victory. And ending a battle to save an empire is no defeat.",
+ "Great people do not seek power; they have power thrust upon them.",
+ "I am not afraid. I will not hide my face behind stone and mortar. I will stand before the wind and make it respect me.",
+ "What are the tools you use to create memories?",
+ // Buffy
+ "The one and only, the original, accept-no-substitute.",
+ "The monkey's the only cookie animal that gets to wear clothes. You know that?",
+ 'Like is the hippo goin\', "Hey man. Where are my pants? I have my hippo dignity."',
+ 'The monkey\'s just, "I mock you with my monkey pants!"',
+ "And then there's a big coup in the zoo.",
+ "Man can't turn his back on what he came from. Besides, black is slimming.",
+ // The Good Place
+ "It's not a joke; I'm a legit snack!",
+ // Natalie
+ "Words are the threads that weave the tapestries of life.",
+ "Salutations of the seasons be upon you.",
+ "Little victories, my friends. Little victories.",
+ "It is what we can’t see that fuels our imagination.",
+ "This is Art holding a Mirror up to Life. That’s why everything is exactly the wrong way around.",
+ "Listen to the quiet.",
+ "Don't try to be a great man, just be a man. And let history make its own judgments.",
+ // Horrible Goose
+ "Your garden? I make it terrible! I make a puzzle of your garden!",
+ "Here I come again!",
+ "You cannot anticipate me because your brain is so big and weighty and far from the ground, but my brain is aerodynamic and small and ground-sure and I have all I need in my wicked goose-body, and also I have your radio.",
+ "I put my honk in a jar so there is more honk!",
+ // AI Generated Spaceship Names
+ "Still Wrong, After All These Years.",
+ "I'll just be over here.",
+ "I do the best I can.",
+ "Would you like to know more?",
+ "I did it for Science!",
+ "Can't Win 'Em All.",
+ "Extreme Problems call for Extreme Solutions.",
+ "An attempt at perspective.",
+ "This is my time, and I control it.",
+ "All theory, dear friend, is grey, but the golden tree of life springs ever green.",
+ // Ubuntu
+ "I am what I am because of who we all are.",
+ "What shall I build or write against the fall of night?",
+ // Catch-22
+ "There was no telling what people might find out if they felt free to ask whatever questions they wanted to.",
+ "Just because you're paranoid doesn't mean they aren't after you.",
+ "He knew everything there was to know about literature, except how to enjoy it.",
+ "Insanity is contagious.",
+ "Brains are weird, man. Weird, and grey, and squishy.",
+ "You are entitled to your own opinion, but you are not entitled to your own facts.",
+ "It is not incumbent on you to complete the task, but neither are you free to desist from it.",
+ "May you live in interesting times.",
+ // Will Durant
+ "We are what we repeatedly do. Excellence, then, is not an act, but a habit.",
+ // Ms Frizzle
+ "Take chances, make mistakes, and get messy.",
+ "The best way to know is to do.",
+ "Looks can be deceiving. Oftentimes what is isn’t, and what isn’t is.",
+ "If you keep asking questions, you’ll keep getting answers.",
+ "If you don’t look, you’ll never see. And what you don’t see can be very hard to find.",
+ "Where the road ends, adventure begins!",
+ // Soren Kierkegaard
+ "Life can only be understood backwards; but it must be lived forwards.",
+ // Swyx
+ "Small minds discuss tactics, average minds discuss strategy, great minds discuss destiny",
+ // Something about yeast not feeling pain?
+ "Ow! My very being!",
+ // Soren, ST:Generations
+ "They say time is the fire in which we burn.",
+ "Fragile. Not like flowers. Like bombs.",
+ // MLK
+ "A time comes when silence is betrayal.",
+ // The Fall of Kang
+ "So honor the valiant who die 'neath your sword, But pity the warrior who slays all his foes.",
+ // Dragonforce
+ "On towards the wilderness, our quest carries on.",
+ "Far beyond the sundown, far beyond the moonlight, deep inside our hearts and all our souls",
+ // Chinese Maxim
+ "Of all the thirty-six stratagems, to know when to quit is the best.",
+ // Exhalation
+ "I am not that air; I am the pattern that it assumed, temporarily.",
+ // Random book quotes
+ "You want to fight a god? You’d better have one on your side too.",
+ "All we have to decide is what to do with the time that is given us.",
+ "The truth is, once you learn how to die, you learn how to live.",
+ "It is only with the heart that one can see rightly; what is essential is invisible to the eye.",
+ "I'm not much, but I'm all I have.",
+ "Sometimes I can hear my bones straining under the weight of all the lives I'm not living.",
+ "We have big plans. Oh yes. We're fumbling in the dark, but at least we're in motion.",
+ "Sad things are beautiful in a way which can only be explained to those who already understand.",
+ "My life amounts to no more than one drop in a limitless ocean. Yet what is any ocean, but a multitude of drops?",
+ "Time moves slowly, but passes quickly.",
+ "What a treacherous thing to believe that a person is more than a person.",
+ "All human wisdom is in these two words: Wait and Hope!",
+ "The mystery of life isn't a problem to solve, but a reality to experience.",
+ "Fear is the mind killer.",
+ "Down to earth, but looking at the stars.",
+ "I don't want deep pockets; I want conversation.",
+ "What's the worth of a grand if you waste a thousand years?",
+ "The man whistling tunes pianos.",
+ // Rules of Acquisition
+ "Opportunity plus instinct equals profit.",
+ "You can't buy fate.",
+ "More is good... all is better.",
+ "The riskier the road, the greater the profit.",
+ "Sometimes the only thing more dangerous than a question is an answer.",
+ "Free advice is seldom cheap.",
+ // Chaucer
+ "See yonder, lo, the Galaxy which men calleth the Milky Way, for it is white.",
+];
+
+const QuoteOfTheDay = () => {
+ const quote = useRef(quotes[Math.floor(Math.random() * quotes.length)]);
+ return (
+
+