@joystyk/catalog 0.0.0 → 0.2.0

package/dist/wire.d.ts

@@ -0,0 +1,108 @@
+import * as z from 'zod/mini';
+export declare const MODES: readonly ["solo", "ai", "pass-and-play", "p2p", "server", "daily"];
+/** Whether a game can be played yet. Every placeholder is `coming-soon`. */
+export declare const GAME_STATUSES: readonly ["coming-soon", "available"];
+export type GameStatus = (typeof GAME_STATUSES)[number];
+export declare const GameSummarySchema: z.ZodMiniObject<{
+    id: z.ZodMiniString<string>;
+    name: z.ZodMiniString<string>;
+    summary: z.ZodMiniString<string>;
+    category: z.ZodMiniString<string>;
+    tags: z.ZodMiniArray<z.ZodMiniString<string>>;
+    modes: z.ZodMiniArray<z.ZodMiniEnum<{
+        daily: "daily";
+        ai: "ai";
+        server: "server";
+        solo: "solo";
+        "pass-and-play": "pass-and-play";
+        p2p: "p2p";
+    }>>;
+    players: z.ZodMiniObject<{
+        min: z.ZodMiniInt;
+        max: z.ZodMiniInt;
+        default: z.ZodMiniOptional<z.ZodMiniInt>;
+    }, z.core.$strip>;
+    status: z.ZodMiniEnum<{
+        "coming-soon": "coming-soon";
+        available: "available";
+    }>;
+    placeholder: z.ZodMiniBoolean<boolean>;
+    featured: z.ZodMiniBoolean<boolean>;
+}, z.core.$strip>;
+/** What a card, a grid tile and a lineup row need. */
+export type GameSummary = z.infer<typeof GameSummarySchema>;
+export declare const GameDetailSchema: z.ZodMiniObject<{
+    id: z.ZodMiniString<string>;
+    name: z.ZodMiniString<string>;
+    summary: z.ZodMiniString<string>;
+    category: z.ZodMiniString<string>;
+    tags: z.ZodMiniArray<z.ZodMiniString<string>>;
+    modes: z.ZodMiniArray<z.ZodMiniEnum<{
+        daily: "daily";
+        ai: "ai";
+        server: "server";
+        solo: "solo";
+        "pass-and-play": "pass-and-play";
+        p2p: "p2p";
+    }>>;
+    players: z.ZodMiniObject<{
+        min: z.ZodMiniInt;
+        max: z.ZodMiniInt;
+        default: z.ZodMiniOptional<z.ZodMiniInt>;
+    }, z.core.$strip>;
+    status: z.ZodMiniEnum<{
+        "coming-soon": "coming-soon";
+        available: "available";
+    }>;
+    placeholder: z.ZodMiniBoolean<boolean>;
+    featured: z.ZodMiniBoolean<boolean>;
+    description: z.ZodMiniString<string>;
+    pageTitle: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    rules: z.ZodMiniArray<z.ZodMiniString<string>>;
+    aiLevels: z.ZodMiniArray<z.ZodMiniString<string>>;
+    essentialMotion: z.ZodMiniBoolean<boolean>;
+    aiContent: z.ZodMiniBoolean<boolean>;
+    assets: z.ZodMiniString<string>;
+    options: z.ZodMiniOptional<z.ZodMiniCustom<import("@joystyk/contracts").GameOption[], import("@joystyk/contracts").GameOption[]>>;
+    attribution: z.ZodMiniOptional<z.ZodMiniObject<{
+        text: z.ZodMiniString<string>;
+        href: z.ZodMiniString<string>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** What a game page needs. */
+export type GameDetail = z.infer<typeof GameDetailSchema>;
+export declare const GameSummaryListSchema: z.ZodMiniArray<z.ZodMiniObject<{
+    id: z.ZodMiniString<string>;
+    name: z.ZodMiniString<string>;
+    summary: z.ZodMiniString<string>;
+    category: z.ZodMiniString<string>;
+    tags: z.ZodMiniArray<z.ZodMiniString<string>>;
+    modes: z.ZodMiniArray<z.ZodMiniEnum<{
+        daily: "daily";
+        ai: "ai";
+        server: "server";
+        solo: "solo";
+        "pass-and-play": "pass-and-play";
+        p2p: "p2p";
+    }>>;
+    players: z.ZodMiniObject<{
+        min: z.ZodMiniInt;
+        max: z.ZodMiniInt;
+        default: z.ZodMiniOptional<z.ZodMiniInt>;
+    }, z.core.$strip>;
+    status: z.ZodMiniEnum<{
+        "coming-soon": "coming-soon";
+        available: "available";
+    }>;
+    placeholder: z.ZodMiniBoolean<boolean>;
+    featured: z.ZodMiniBoolean<boolean>;
+}, z.core.$strip>>;
+export declare const CategoryInfoSchema: z.ZodMiniObject<{
+    id: z.ZodMiniString<string>;
+    name: z.ZodMiniString<string>;
+    noun: z.ZodMiniString<string>;
+    description: z.ZodMiniString<string>;
+    games: z.ZodMiniInt;
+}, z.core.$strip>;
+/** A category that has at least one game. Every page's seed carries the full list. */
+export type CategoryInfo = z.infer<typeof CategoryInfoSchema>;

package/dist/wire.js

@@ -0,0 +1,74 @@
+import { isGameId, isGameOptions } from "@joystyk/contracts";
+import * as z from "zod/mini";
+//#region src/wire.ts
+var MODES = [
+	"solo",
+	"ai",
+	"pass-and-play",
+	"p2p",
+	"server",
+	"daily"
+];
+/** Whether a game can be played yet. Every placeholder is `coming-soon`. */
+var GAME_STATUSES = ["coming-soon", "available"];
+var count = z.int().check(z.positive());
+var gameId = z.string().check(z.refine(isGameId, "not a kebab-case game id"));
+var GameSummarySchema = z.object({
+	id: gameId,
+	name: z.string(),
+	summary: z.string(),
+	category: z.string(),
+	tags: z.array(z.string()),
+	modes: z.array(z.enum(MODES)),
+	/** `default`: the table size the launcher starts at against the computer (the manifest's `players.default`). */
+	players: z.object({
+		min: count,
+		max: count,
+		default: z.optional(count)
+	}),
+	status: z.enum(GAME_STATUSES),
+	/** True while the entry is a stand-in written before the game exists. */
+	placeholder: z.boolean(),
+	featured: z.boolean()
+});
+var GameDetailSchema = z.extend(GameSummarySchema, {
+	description: z.string(),
+	/**
+	* The manifest's `pageTitle`, the fuller name people search for ("Klondike Solitaire"):
+	* the page's title, heading and structured data use it. Cards and the launcher use `name`.
+	*/
+	pageTitle: z.optional(z.string()),
+	/** A short rules summary; the full rules arrive with the game. */
+	rules: z.array(z.string()),
+	aiLevels: z.array(z.string()),
+	essentialMotion: z.boolean(),
+	/** The game plays AI-generated content, so the launcher asks for the notice first (D-44). */
+	aiContent: z.boolean(),
+	/** The game manifest's `assets`: its asset list, which "Make available offline" pins. */
+	assets: z.string(),
+	options: z.optional(z.custom(isGameOptions)),
+	attribution: z.optional(z.object({
+		text: z.string().check(z.minLength(1), z.maxLength(500)),
+		href: z.string().check(z.refine((value) => {
+			try {
+				const url = new URL(value);
+				return url.protocol === "https:" && url.username === "" && url.password === "";
+			} catch {
+				return false;
+			}
+		}, "credit links must use HTTPS"))
+	}))
+});
+var GameSummaryListSchema = z.array(GameSummarySchema);
+var CategoryInfoSchema = z.object({
+	id: z.string(),
+	name: z.string(),
+	/** Lowercase singular for prose and titles, e.g. "dice game". */
+	noun: z.string(),
+	description: z.string(),
+	games: count
+});
+//#endregion
+export { CategoryInfoSchema, GAME_STATUSES, GameDetailSchema, GameSummaryListSchema, GameSummarySchema, MODES };
+
+//# sourceMappingURL=wire.js.map

package/dist/wire.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire.js","names":[],"sources":["../src/wire.ts"],"sourcesContent":["// Catalog data as it crosses the wire: the store seed in every page and the /api/games\n// responses. Plain JSON, decoded in the browser through Zod's Standard Schema interface\n// (D-18, D-22; browser code uses zod/mini). The server builds these values from the\n// registry, so the client never bundles the registry itself.\nimport { isGameId, isGameOptions, type Mode } from '@joystyk/contracts';\nimport * as z from 'zod/mini';\n\nexport const MODES = ['solo', 'ai', 'pass-and-play', 'p2p', 'server', 'daily'] as const satisfies readonly Mode[];\n\n/** Whether a game can be played yet. Every placeholder is `coming-soon`. */\nexport const GAME_STATUSES = ['coming-soon', 'available'] as const;\nexport type GameStatus = (typeof GAME_STATUSES)[number];\n\nconst count = z.int().check(z.positive());\nconst gameId = z.string().check(z.refine(isGameId, 'not a kebab-case game id'));\n\nexport const GameSummarySchema = z.object({\n  id: gameId,\n  name: z.string(),\n  summary: z.string(),\n  category: z.string(),\n  tags: z.array(z.string()),\n  modes: z.array(z.enum(MODES)),\n  /** `default`: the table size the launcher starts at against the computer (the manifest's `players.default`). */\n  players: z.object({ min: count, max: count, default: z.optional(count) }),\n  status: z.enum(GAME_STATUSES),\n  /** True while the entry is a stand-in written before the game exists. */\n  placeholder: z.boolean(),\n  featured: z.boolean(),\n});\n\n/** What a card, a grid tile and a lineup row need. */\nexport type GameSummary = z.infer<typeof GameSummarySchema>;\n\nexport const GameDetailSchema = z.extend(GameSummarySchema, {\n  description: z.string(),\n  /**\n   * The manifest's `pageTitle`, the fuller name people search for (\"Klondike Solitaire\"):\n   * the page's title, heading and structured data use it. Cards and the launcher use `name`.\n   */\n  pageTitle: z.optional(z.string()),\n  /** A short rules summary; the full rules arrive with the game. */\n  rules: z.array(z.string()),\n  aiLevels: z.array(z.string()),\n  essentialMotion: z.boolean(),\n  /** The game plays AI-generated content, so the launcher asks for the notice first (D-44). */\n  aiContent: z.boolean(),\n  /** The game manifest's `assets`: its asset list, which \"Make available offline\" pins. */\n  assets: z.string(),\n  options: z.optional(z.custom<import('@joystyk/contracts').GameOption[]>(isGameOptions)),\n  attribution: z.optional(\n    z.object({\n      text: z.string().check(z.minLength(1), z.maxLength(500)),\n      href: z.string().check(\n        z.refine((value) => {\n          try {\n            const url = new URL(value);\n            return url.protocol === 'https:' && url.username === '' && url.password === '';\n          } catch {\n            return false;\n          }\n        }, 'credit links must use HTTPS'),\n      ),\n    }),\n  ),\n});\n\n/** What a game page needs. */\nexport type GameDetail = z.infer<typeof GameDetailSchema>;\n\nexport const GameSummaryListSchema = z.array(GameSummarySchema);\n\nexport const CategoryInfoSchema = z.object({\n  id: z.string(),\n  name: z.string(),\n  /** Lowercase singular for prose and titles, e.g. \"dice game\". */\n  noun: z.string(),\n  description: z.string(),\n  games: count,\n});\n\n/** A category that has at least one game. Every page's seed carries the full list. */\nexport type CategoryInfo = z.infer<typeof CategoryInfoSchema>;\n"],"mappings":";;;AAOA,IAAa,QAAQ;CAAC;CAAQ;CAAM;CAAiB;CAAO;CAAU;AAAO;;AAG7E,IAAa,gBAAgB,CAAC,eAAe,WAAW;AAGxD,IAAM,QAAQ,EAAE,IAAI,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC;AACxC,IAAM,SAAS,EAAE,OAAO,CAAC,CAAC,MAAM,EAAE,OAAO,UAAU,0BAA0B,CAAC;AAE9E,IAAa,oBAAoB,EAAE,OAAO;CACxC,IAAI;CACJ,MAAM,EAAE,OAAO;CACf,SAAS,EAAE,OAAO;CAClB,UAAU,EAAE,OAAO;CACnB,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;CACxB,OAAO,EAAE,MAAM,EAAE,KAAK,KAAK,CAAC;;CAE5B,SAAS,EAAE,OAAO;EAAE,KAAK;EAAO,KAAK;EAAO,SAAS,EAAE,SAAS,KAAK;CAAE,CAAC;CACxE,QAAQ,EAAE,KAAK,aAAa;;CAE5B,aAAa,EAAE,QAAQ;CACvB,UAAU,EAAE,QAAQ;AACtB,CAAC;AAKD,IAAa,mBAAmB,EAAE,OAAO,mBAAmB;CAC1D,aAAa,EAAE,OAAO;;;;;CAKtB,WAAW,EAAE,SAAS,EAAE,OAAO,CAAC;;CAEhC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC;CACzB,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC;CAC5B,iBAAiB,EAAE,QAAQ;;CAE3B,WAAW,EAAE,QAAQ;;CAErB,QAAQ,EAAE,OAAO;CACjB,SAAS,EAAE,SAAS,EAAE,OAAkD,aAAa,CAAC;CACtF,aAAa,EAAE,SACb,EAAE,OAAO;EACP,MAAM,EAAE,OAAO,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,EAAE,UAAU,GAAG,CAAC;EACvD,MAAM,EAAE,OAAO,CAAC,CAAC,MACf,EAAE,QAAQ,UAAU;GAClB,IAAI;IACF,MAAM,MAAM,IAAI,IAAI,KAAK;IACzB,OAAO,IAAI,aAAa,YAAY,IAAI,aAAa,MAAM,IAAI,aAAa;GAC9E,QAAQ;IACN,OAAO;GACT;EACF,GAAG,6BAA6B,CAClC;CACF,CAAC,CACH;AACF,CAAC;AAKD,IAAa,wBAAwB,EAAE,MAAM,iBAAiB;AAE9D,IAAa,qBAAqB,EAAE,OAAO;CACzC,IAAI,EAAE,OAAO;CACb,MAAM,EAAE,OAAO;;CAEf,MAAM,EAAE,OAAO;CACf,aAAa,EAAE,OAAO;CACtB,OAAO;AACT,CAAC"}

package/package.json

@@ -1,20 +1,72 @@
 {
   "name": "@joystyk/catalog",
-  "version": "0.0.0",
-  "description": "Reserved for the first Joystyk library release.",
+  "version": "0.2.0",
+  "description": "The Joystyk catalog: manifest registry, slot registry, routes and the server-rendered index, category and game pages.",
+  "private": false,
+  "type": "module",
+  "sideEffects": [
+    "**/client.[jt]s",
+    "**/server.[jt]s",
+    "**/components/*.[jt]s",
+    "**/styles.css"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "default": "./dist/client.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "default": "./dist/server.js"
+    },
+    "./styles.css": "./dist/styles.css"
+  },
+  "dependencies": {
+    "@gyral/core": "0.3.1",
+    "@gyral/http": "0.3.1",
+    "@gyral/router": "0.3.1",
+    "@gyral/ssr": "0.3.1",
+    "zod": "4.6.5",
+    "@joystyk/contracts": "0.2.0",
+    "@joystyk/launcher": "0.2.0",
+    "@joystyk/ui": "0.2.0"
+  },
+  "devDependencies": {
+    "@gyral/testing": "0.3.1",
+    "parse5": "8.0.1",
+    "typescript": "5.9.3",
+    "vite": "8.3.3",
+    "vitest": "4.1.11"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "NOTICE",
+    "CHANGELOG.md"
+  ],
+  "engines": {
+    "node": ">=24.15.0"
+  },
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/joystyk-games/game-libraries.git",
     "directory": "packages/catalog"
   },
-  "homepage": "https://github.com/joystyk-games/game-libraries",
-  "files": [
-    "README.md",
-    "LICENSE",
-    "NOTICE"
-  ],
-  "publishConfig": {
-    "access": "public"
+  "homepage": "https://github.com/joystyk-games/game-libraries/tree/main/packages/catalog#readme",
+  "bugs": {
+    "url": "https://github.com/joystyk-games/game-libraries/issues"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "build": "node ../../scripts/build-package.ts"
   }
-}
+}