@storyshelf/app 0.6.1 → 0.7.0

package/dist/routes/page-routes.mjs

@@ -0,0 +1,104 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+//#region src/routes/page-routes.ts
+/** HTML and auth routes, keyed by `METHOD /hono-pattern`. */
+const PAGE_ROUTE_CLASSES = {
+	"GET /": "hosting",
+	"GET /projects": "hosting",
+	"GET /projects/new": "hosting",
+	"POST /projects/new": "hosting",
+	"GET /projects/:slug/labels": "hosting",
+	"GET /projects/:slug/labels/:key/*": "hosting",
+	"GET /projects/:slug/settings": "hosting",
+	"POST /projects/:slug/settings": "hosting",
+	"POST /projects/:slug/settings/review": "hosting",
+	"POST /projects/:slug/delete": "hosting",
+	"GET /projects/:slug/settings/labels": "hosting",
+	"POST /projects/:slug/settings/labels": "hosting",
+	"POST /projects/:slug/settings/labels/:key": "hosting",
+	"POST /projects/:slug/settings/labels/:key/delete": "hosting",
+	"GET /projects/:slug/settings/links": "hosting",
+	"POST /projects/:slug/settings/links": "hosting",
+	"POST /projects/:slug/settings/links/delete": "hosting",
+	"GET /projects/:slug/settings/design": "hosting",
+	"POST /projects/:slug/settings/design/files": "hosting",
+	"POST /projects/:slug/settings/design/files/:id/delete": "hosting",
+	"POST /projects/:slug/settings/design/components": "hosting",
+	"POST /projects/:slug/settings/design/components/:id/delete": "hosting",
+	"POST /projects/:slug/settings/design/:provider/token": "hosting",
+	"POST /projects/:slug/settings/design/:provider/token/delete": "hosting",
+	"GET /projects/:slug/settings/tokens": "hosting",
+	"POST /projects/:slug/settings/tokens": "hosting",
+	"POST /projects/:slug/settings/tokens/:tokenId/delete": "hosting",
+	"GET /projects/:slug/settings/webhooks": "hosting",
+	"POST /projects/:slug/settings/webhooks": "hosting",
+	"POST /projects/:slug/settings/webhooks/:webhookId/delete": "hosting",
+	"GET /projects/:slug/settings/notifications": "hosting",
+	"POST /projects/:slug/settings/notifications": "hosting",
+	"POST /projects/:slug/settings/notifications/:channelId/delete": "hosting",
+	"POST /projects/:slug/settings/notifications/me": "hosting",
+	"GET /projects/:slug/settings/members": "hosting",
+	"POST /projects/:slug/settings/members": "hosting",
+	"POST /projects/:slug/settings/members/:userId/remove": "hosting",
+	"POST /projects/:slug/settings/members/groups": "hosting",
+	"POST /projects/:slug/settings/members/groups/:mappingId/remove": "hosting",
+	"GET /admin": "hosting",
+	"POST /admin/credentials/reencrypt": "hosting",
+	"POST /admin/public-origin": "hosting",
+	"POST /admin/public-origin/report": "hosting",
+	"POST /admin/public-origin/clear": "hosting",
+	"GET /_": "hosting",
+	"GET /_/": "hosting",
+	"GET /_/:id": "hosting",
+	"GET /_/:id/*": "hosting",
+	"GET /projects/:slug/storybook": "hosting",
+	"GET /projects/:slug/storybook/:key/:value": "hosting",
+	"GET /projects/:slug/storybook/build/:buildId/*": "hosting",
+	"GET /_s/:token/*": "testing",
+	"GET /auth/login": "hosting",
+	"GET /auth/engine/login": "hosting",
+	"POST /auth/engine/login": "hosting",
+	"GET /auth/engine/:providerId": "hosting",
+	"GET /auth/invites/:inviteId": "hosting",
+	"POST /auth/invites/:inviteId": "hosting",
+	"POST /auth/logout": "hosting",
+	"GET /.well-known/openid-configuration": "hosting",
+	"GET /.well-known/change-password": "hosting",
+	"GET /profile": "hosting",
+	"POST /profile": "hosting",
+	"POST /profile/password": "hosting",
+	"POST /profile/sessions/revoke": "hosting",
+	"POST /profile/sessions/revoke-others": "hosting",
+	"POST /profile/passkeys/:passkeyId/delete": "hosting",
+	"POST /profile/notifications": "hosting",
+	"GET /connections/:service/start": "hosting",
+	"GET /connections/:service/callback": "hosting",
+	"POST /connections/:service/disconnect": "hosting",
+	"ALL /api/auth/*": "hosting",
+	"GET /projects/:slug/jobs": "testing",
+	"GET /projects/:slug/builds/:buildId/diff": "testing",
+	"GET /projects/:slug/settings/tests": "testing",
+	"POST /projects/:slug/settings/tests": "testing",
+	"GET /projects/:slug/settings/capture": "testing",
+	"POST /projects/:slug/settings/capture": "testing",
+	"GET /projects/:slug/settings/ai": "testing",
+	"POST /projects/:slug/settings/ai": "testing",
+	"GET /admin/ai": "testing",
+	"GET /projects/:slug/insights/health/panel": "testing",
+	"POST /projects/:slug/insights/health/generate": "testing",
+	"GET /projects/:slug/builds/:buildId/insights/panel": "testing",
+	"POST /projects/:slug/builds/:buildId/insights/generate": "testing",
+	"POST /projects/:slug/builds/:buildId/comments": "review",
+	"POST /projects/:slug/builds/:buildId/comments/:commentId/resolve": "review",
+	"POST /projects/:slug/builds/:buildId/reviews": "review",
+	"GET /projects/:slug": "both",
+	"GET /projects/:slug/builds": "both",
+	"GET /projects/:slug/builds/:buildId": "both",
+	"GET /projects/:slug/library": "both",
+	"GET /projects/:slug/components/*": "both"
+};
+//#endregion
+export { PAGE_ROUTE_CLASSES };
+
+//# sourceMappingURL=page-routes.mjs.map

package/dist/routes/page-routes.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-routes.mjs","names":[],"sources":["../../src/routes/page-routes.ts"],"sourcesContent":["/** Classes of the HTML pages, Storybook serving, auth flow and engine routes. */\nimport type { RouteClass } from \"./classification.ts\";\n\n/** HTML and auth routes, keyed by `METHOD /hono-pattern`. */\nexport const PAGE_ROUTE_CLASSES: Readonly<Record<string, RouteClass>> = {\n  // hosting\n  \"GET /\": \"hosting\",\n  \"GET /projects\": \"hosting\",\n  \"GET /projects/new\": \"hosting\",\n  \"POST /projects/new\": \"hosting\",\n  \"GET /projects/:slug/labels\": \"hosting\",\n  \"GET /projects/:slug/labels/:key/*\": \"hosting\",\n  \"GET /projects/:slug/settings\": \"hosting\",\n  \"POST /projects/:slug/settings\": \"hosting\",\n  \"POST /projects/:slug/settings/review\": \"hosting\",\n  \"POST /projects/:slug/delete\": \"hosting\",\n  \"GET /projects/:slug/settings/labels\": \"hosting\",\n  \"POST /projects/:slug/settings/labels\": \"hosting\",\n  \"POST /projects/:slug/settings/labels/:key\": \"hosting\",\n  \"POST /projects/:slug/settings/labels/:key/delete\": \"hosting\",\n  \"GET /projects/:slug/settings/links\": \"hosting\",\n  \"POST /projects/:slug/settings/links\": \"hosting\",\n  \"POST /projects/:slug/settings/links/delete\": \"hosting\",\n  \"GET /projects/:slug/settings/design\": \"hosting\",\n  \"POST /projects/:slug/settings/design/files\": \"hosting\",\n  \"POST /projects/:slug/settings/design/files/:id/delete\": \"hosting\",\n  \"POST /projects/:slug/settings/design/components\": \"hosting\",\n  \"POST /projects/:slug/settings/design/components/:id/delete\": \"hosting\",\n  \"POST /projects/:slug/settings/design/:provider/token\": \"hosting\",\n  \"POST /projects/:slug/settings/design/:provider/token/delete\": \"hosting\",\n  \"GET /projects/:slug/settings/tokens\": \"hosting\",\n  \"POST /projects/:slug/settings/tokens\": \"hosting\",\n  \"POST /projects/:slug/settings/tokens/:tokenId/delete\": \"hosting\",\n  \"GET /projects/:slug/settings/webhooks\": \"hosting\",\n  \"POST /projects/:slug/settings/webhooks\": \"hosting\",\n  \"POST /projects/:slug/settings/webhooks/:webhookId/delete\": \"hosting\",\n  \"GET /projects/:slug/settings/notifications\": \"hosting\",\n  \"POST /projects/:slug/settings/notifications\": \"hosting\",\n  \"POST /projects/:slug/settings/notifications/:channelId/delete\": \"hosting\",\n  \"POST /projects/:slug/settings/notifications/me\": \"hosting\",\n  \"GET /projects/:slug/settings/members\": \"hosting\",\n  \"POST /projects/:slug/settings/members\": \"hosting\",\n  \"POST /projects/:slug/settings/members/:userId/remove\": \"hosting\",\n  \"POST /projects/:slug/settings/members/groups\": \"hosting\",\n  \"POST /projects/:slug/settings/members/groups/:mappingId/remove\": \"hosting\",\n  \"GET /admin\": \"hosting\",\n  \"POST /admin/credentials/reencrypt\": \"hosting\",\n  \"POST /admin/public-origin\": \"hosting\",\n  \"POST /admin/public-origin/report\": \"hosting\",\n  \"POST /admin/public-origin/clear\": \"hosting\",\n  \"GET /_\": \"hosting\",\n  \"GET /_/\": \"hosting\",\n  \"GET /_/:id\": \"hosting\",\n  \"GET /_/:id/*\": \"hosting\",\n  \"GET /projects/:slug/storybook\": \"hosting\",\n  \"GET /projects/:slug/storybook/:key/:value\": \"hosting\",\n  \"GET /projects/:slug/storybook/build/:buildId/*\": \"hosting\",\n  \"GET /_s/:token/*\": \"testing\",\n  \"GET /auth/login\": \"hosting\",\n  \"GET /auth/engine/login\": \"hosting\",\n  \"POST /auth/engine/login\": \"hosting\",\n  \"GET /auth/engine/:providerId\": \"hosting\",\n  \"GET /auth/invites/:inviteId\": \"hosting\",\n  \"POST /auth/invites/:inviteId\": \"hosting\",\n  \"POST /auth/logout\": \"hosting\",\n  \"GET /.well-known/openid-configuration\": \"hosting\",\n  \"GET /.well-known/change-password\": \"hosting\",\n  \"GET /profile\": \"hosting\",\n  \"POST /profile\": \"hosting\",\n  \"POST /profile/password\": \"hosting\",\n  \"POST /profile/sessions/revoke\": \"hosting\",\n  \"POST /profile/sessions/revoke-others\": \"hosting\",\n  \"POST /profile/passkeys/:passkeyId/delete\": \"hosting\",\n  \"POST /profile/notifications\": \"hosting\",\n  \"GET /connections/:service/start\": \"hosting\",\n  \"GET /connections/:service/callback\": \"hosting\",\n  \"POST /connections/:service/disconnect\": \"hosting\",\n  \"ALL /api/auth/*\": \"hosting\",\n  // testing\n  \"GET /projects/:slug/jobs\": \"testing\",\n  \"GET /projects/:slug/builds/:buildId/diff\": \"testing\",\n  \"GET /projects/:slug/settings/tests\": \"testing\",\n  \"POST /projects/:slug/settings/tests\": \"testing\",\n  \"GET /projects/:slug/settings/capture\": \"testing\",\n  \"POST /projects/:slug/settings/capture\": \"testing\",\n  \"GET /projects/:slug/settings/ai\": \"testing\",\n  \"POST /projects/:slug/settings/ai\": \"testing\",\n  \"GET /admin/ai\": \"testing\",\n  \"GET /projects/:slug/insights/health/panel\": \"testing\",\n  \"POST /projects/:slug/insights/health/generate\": \"testing\",\n  \"GET /projects/:slug/builds/:buildId/insights/panel\": \"testing\",\n  \"POST /projects/:slug/builds/:buildId/insights/generate\": \"testing\",\n  // review\n  \"POST /projects/:slug/builds/:buildId/comments\": \"review\",\n  \"POST /projects/:slug/builds/:buildId/comments/:commentId/resolve\": \"review\",\n  \"POST /projects/:slug/builds/:buildId/reviews\": \"review\",\n  // both\n  \"GET /projects/:slug\": \"both\",\n  \"GET /projects/:slug/builds\": \"both\",\n  \"GET /projects/:slug/builds/:buildId\": \"both\",\n  \"GET /projects/:slug/library\": \"both\",\n  \"GET /projects/:slug/components/*\": \"both\",\n};\n"],"mappings":";;;;;AAIA,MAAa,qBAA2D;CAEtE,SAAS;CACT,iBAAiB;CACjB,qBAAqB;CACrB,sBAAsB;CACtB,8BAA8B;CAC9B,qCAAqC;CACrC,gCAAgC;CAChC,iCAAiC;CACjC,wCAAwC;CACxC,+BAA+B;CAC/B,uCAAuC;CACvC,wCAAwC;CACxC,6CAA6C;CAC7C,oDAAoD;CACpD,sCAAsC;CACtC,uCAAuC;CACvC,8CAA8C;CAC9C,uCAAuC;CACvC,8CAA8C;CAC9C,yDAAyD;CACzD,mDAAmD;CACnD,8DAA8D;CAC9D,wDAAwD;CACxD,+DAA+D;CAC/D,uCAAuC;CACvC,wCAAwC;CACxC,wDAAwD;CACxD,yCAAyC;CACzC,0CAA0C;CAC1C,4DAA4D;CAC5D,8CAA8C;CAC9C,+CAA+C;CAC/C,iEAAiE;CACjE,kDAAkD;CAClD,wCAAwC;CACxC,yCAAyC;CACzC,wDAAwD;CACxD,gDAAgD;CAChD,kEAAkE;CAClE,cAAc;CACd,qCAAqC;CACrC,6BAA6B;CAC7B,oCAAoC;CACpC,mCAAmC;CACnC,UAAU;CACV,WAAW;CACX,cAAc;CACd,gBAAgB;CAChB,iCAAiC;CACjC,6CAA6C;CAC7C,kDAAkD;CAClD,oBAAoB;CACpB,mBAAmB;CACnB,0BAA0B;CAC1B,2BAA2B;CAC3B,gCAAgC;CAChC,+BAA+B;CAC/B,gCAAgC;CAChC,qBAAqB;CACrB,yCAAyC;CACzC,oCAAoC;CACpC,gBAAgB;CAChB,iBAAiB;CACjB,0BAA0B;CAC1B,iCAAiC;CACjC,wCAAwC;CACxC,4CAA4C;CAC5C,+BAA+B;CAC/B,mCAAmC;CACnC,sCAAsC;CACtC,yCAAyC;CACzC,mBAAmB;CAEnB,4BAA4B;CAC5B,4CAA4C;CAC5C,sCAAsC;CACtC,uCAAuC;CACvC,wCAAwC;CACxC,yCAAyC;CACzC,mCAAmC;CACnC,oCAAoC;CACpC,iBAAiB;CACjB,6CAA6C;CAC7C,iDAAiD;CACjD,sDAAsD;CACtD,0DAA0D;CAE1D,iDAAiD;CACjD,oEAAoE;CACpE,gDAAgD;CAEhD,uBAAuB;CACvB,8BAA8B;CAC9B,uCAAuC;CACvC,+BAA+B;CAC/B,oCAAoC;AACtC"}

package/dist/runtime.mjs

@@ -2,11 +2,11 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { validateConfig, validateUiConfig } from "@storyshelf/core/config";
+import { createPublicOriginResolver } from "@storyshelf/core/models";
 import { createShelfLogger } from "@storyshelf/core/logger";
 //#region src/runtime.ts
 function addOptionalSnapshots(snap, options) {
-	if (options.captureRunner) snap["captureRunner"] = options.captureRunner.metadata;
-	if (options.captureQueue) snap["captureQueue"] = options.captureQueue.metadata;
+	if (options.testing?.runner) snap["captureRunner"] = options.testing.runner.metadata;
 }
 /**
 * Build a snapshot of adapter metadata for the `/api/v1/health` and docs.
@@ -14,7 +14,7 @@ function addOptionalSnapshots(snap, options) {
 * the running configuration at a glance.
 *
 * @param options - Router options containing the wired adapters
-* @returns Metadata map keyed by adapter category (e.g. `database`, `git:github`)
+* @returns Metadata map keyed by adapter category (e.g. `database`, `notify:github`)
 */
 function buildAdapterSnapshot(options) {
 	const snap = {
@@ -22,8 +22,8 @@ function buildAdapterSnapshot(options) {
 		storage: options.storage.metadata
 	};
 	addOptionalSnapshots(snap, options);
-	for (const p of options.gitHosts ?? []) snap[`git:${p.metadata.kind}`] = p.metadata;
-	for (const n of options.notifiers ?? []) snap[`notify:${n.metadata.kind}`] = n.metadata;
+	for (const p of options.design ?? []) snap[`design:${p.metadata.kind}`] = p.metadata;
+	for (const n of options.notifications?.notifiers ?? []) snap[`notify:${n.metadata.kind}`] = n.metadata;
 	return snap;
 }
 /** Validate config/ui and derive runtime singletons from options. */
@@ -32,18 +32,23 @@ function resolveRuntime(options) {
 	const ui = options.ui ? validateUiConfig(options.ui) : {};
 	const logger = options.logger ?? createShelfLogger();
 	const authEnabled = options.auth !== void 0;
-	const gitHosts = options.gitHosts ?? [];
-	const notifiers = options.notifiers ?? [];
+	const design = options.design ?? [];
+	const notifiers = options.notifications?.notifiers ?? [];
+	const config = rawConfig.adapters ? rawConfig : {
+		...rawConfig,
+		adapters: buildAdapterSnapshot(options)
+	};
 	return {
-		config: rawConfig.adapters ? rawConfig : {
-			...rawConfig,
-			adapters: buildAdapterSnapshot(options)
-		},
+		config,
 		ui,
 		logger,
 		authEnabled,
-		gitHosts,
-		notifiers
+		design,
+		notifiers,
+		publicOrigin: createPublicOriginResolver({
+			db: options.database,
+			config
+		})
 	};
 }
 //#endregion

package/dist/runtime.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.mjs","names":[],"sources":["../src/runtime.ts"],"sourcesContent":["import type { GitHostProvider } from \"@storyshelf/core/adapter/git-host\";\nimport type { AdapterMetadata, GitAdapterMetadata } from \"@storyshelf/core/adapter/metadata\";\nimport type { NotifierProvider } from \"@storyshelf/core/adapter/notifier\";\nimport type { ShelfConfig, ShelfOptions, UIConfig } from \"@storyshelf/core/config\";\nimport { validateConfig, validateUiConfig } from \"@storyshelf/core/config\";\nimport type { Logger } from \"@storyshelf/core/logger\";\nimport { createShelfLogger } from \"@storyshelf/core/logger\";\n\n/**\n * Resolved server runtime derived from {@link ShelfOptions}.\n * Holds the validated config, UI branding, structured logger, and\n * computed helpers like whether auth is enabled and which git hosts are wired.\n */\nexport interface ServerRuntime {\n  config: ShelfConfig;\n  ui: UIConfig;\n  logger: Logger;\n  authEnabled: boolean;\n  gitHosts: GitHostProvider[];\n  notifiers: NotifierProvider[];\n}\n\nfunction addOptionalSnapshots(\n  snap: Record<string, AdapterMetadata | GitAdapterMetadata>,\n  options: ShelfOptions,\n): void {\n  if (options.captureRunner) {\n    snap[\"captureRunner\"] = options.captureRunner.metadata;\n  }\n  if (options.captureQueue) {\n    snap[\"captureQueue\"] = options.captureQueue.metadata;\n  }\n}\n\n/**\n * Build a snapshot of adapter metadata for the `/api/v1/health` and docs.\n * Collects the name/version of every wired adapter so operators can verify\n * the running configuration at a glance.\n *\n * @param options - Router options containing the wired adapters\n * @returns Metadata map keyed by adapter category (e.g. `database`, `git:github`)\n */\nexport function buildAdapterSnapshot(\n  options: ShelfOptions,\n): Record<string, AdapterMetadata | GitAdapterMetadata> {\n  const snap: Record<string, AdapterMetadata | GitAdapterMetadata> = {\n    database: options.database.metadata,\n    storage: options.storage.metadata,\n  };\n  addOptionalSnapshots(snap, options);\n  for (const p of options.gitHosts ?? []) {\n    snap[`git:${p.metadata.kind}`] = p.metadata;\n  }\n  for (const n of options.notifiers ?? []) {\n    snap[`notify:${n.metadata.kind}`] = n.metadata;\n  }\n  return snap;\n}\n\n/** Validate config/ui and derive runtime singletons from options. */\nexport function resolveRuntime(options: ShelfOptions): ServerRuntime {\n  // eslint-disable-next-line typescript/no-unnecessary-type-assertion -- ShelfConfig lacks index signature\n  const rawConfig = options.config\n    ? validateConfig(options.config as unknown as Record<string, unknown>)\n    : {};\n  // eslint-disable-next-line typescript/no-unnecessary-type-assertion -- UIConfig lacks index signature\n  const ui = options.ui ? validateUiConfig(options.ui as unknown as Record<string, unknown>) : {};\n  const logger = options.logger ?? createShelfLogger();\n  const authEnabled = options.auth !== undefined;\n  const gitHosts = options.gitHosts ?? [];\n  const notifiers = options.notifiers ?? [];\n  // Adapter introspection — auto-populate config.adapters if not supplied\n  const config: ShelfConfig = rawConfig.adapters\n    ? rawConfig\n    : {\n        ...rawConfig,\n        adapters: buildAdapterSnapshot(options),\n      };\n  return { config, ui, logger, authEnabled, gitHosts, notifiers };\n}\n"],"mappings":";;;;;;AAsBA,SAAS,qBACP,MACA,SACM;CACN,IAAI,QAAQ,eACV,KAAK,mBAAmB,QAAQ,cAAc;CAEhD,IAAI,QAAQ,cACV,KAAK,kBAAkB,QAAQ,aAAa;AAEhD;;;;;;;;;AAUA,SAAgB,qBACd,SACsD;CACtD,MAAM,OAA6D;EACjE,UAAU,QAAQ,SAAS;EAC3B,SAAS,QAAQ,QAAQ;CAC3B;CACA,qBAAqB,MAAM,OAAO;CAClC,KAAK,MAAM,KAAK,QAAQ,YAAY,CAAC,GACnC,KAAK,OAAO,EAAE,SAAS,UAAU,EAAE;CAErC,KAAK,MAAM,KAAK,QAAQ,aAAa,CAAC,GACpC,KAAK,UAAU,EAAE,SAAS,UAAU,EAAE;CAExC,OAAO;AACT;;AAGA,SAAgB,eAAe,SAAsC;CAEnE,MAAM,YAAY,QAAQ,SACtB,eAAe,QAAQ,MAA4C,IACnE,CAAC;CAEL,MAAM,KAAK,QAAQ,KAAK,iBAAiB,QAAQ,EAAwC,IAAI,CAAC;CAC9F,MAAM,SAAS,QAAQ,UAAU,kBAAkB;CACnD,MAAM,cAAc,QAAQ,SAAS,KAAA;CACrC,MAAM,WAAW,QAAQ,YAAY,CAAC;CACtC,MAAM,YAAY,QAAQ,aAAa,CAAC;CAQxC,OAAO;EAAE,QANmB,UAAU,WAClC,YACA;GACE,GAAG;GACH,UAAU,qBAAqB,OAAO;EACxC;EACa;EAAI;EAAQ;EAAa;EAAU;CAAU;AAChE"}
+{"version":3,"file":"runtime.mjs","names":[],"sources":["../src/runtime.ts"],"sourcesContent":["import type { DesignProvider } from \"@storyshelf/core/adapter/design\";\nimport type { AdapterMetadata } from \"@storyshelf/core/adapter/metadata\";\nimport type { NotifierProvider } from \"@storyshelf/core/adapter/notifier\";\nimport type { ShelfConfig, ShelfOptions, UIConfig } from \"@storyshelf/core/config\";\nimport { validateConfig, validateUiConfig } from \"@storyshelf/core/config\";\nimport type { Logger } from \"@storyshelf/core/logger\";\nimport { createShelfLogger } from \"@storyshelf/core/logger\";\nimport { createPublicOriginResolver, type PublicOriginResolver } from \"@storyshelf/core/models\";\n\n/**\n * Resolved server runtime derived from {@link ShelfOptions}.\n * Holds the validated config, UI branding, structured logger, and\n * computed helpers like whether auth is enabled and which notifiers are wired.\n */\nexport interface ServerRuntime {\n  config: ShelfConfig;\n  ui: UIConfig;\n  logger: Logger;\n  authEnabled: boolean;\n  design: DesignProvider[];\n  notifiers: NotifierProvider[];\n  /** The public origin for links built in the background (ADR 0007, decision 6). */\n  publicOrigin: PublicOriginResolver;\n}\n\nfunction addOptionalSnapshots(snap: Record<string, AdapterMetadata>, options: ShelfOptions): void {\n  if (options.testing?.runner) {\n    snap[\"captureRunner\"] = options.testing.runner.metadata;\n  }\n}\n\n/**\n * Build a snapshot of adapter metadata for the `/api/v1/health` and docs.\n * Collects the name/version of every wired adapter so operators can verify\n * the running configuration at a glance.\n *\n * @param options - Router options containing the wired adapters\n * @returns Metadata map keyed by adapter category (e.g. `database`, `notify:github`)\n */\nexport function buildAdapterSnapshot(options: ShelfOptions): Record<string, AdapterMetadata> {\n  const snap: Record<string, AdapterMetadata> = {\n    database: options.database.metadata,\n    storage: options.storage.metadata,\n  };\n  addOptionalSnapshots(snap, options);\n  for (const p of options.design ?? []) {\n    snap[`design:${p.metadata.kind}`] = p.metadata;\n  }\n  for (const n of options.notifications?.notifiers ?? []) {\n    snap[`notify:${n.metadata.kind}`] = n.metadata;\n  }\n  return snap;\n}\n\n/** Validate config/ui and derive runtime singletons from options. */\nexport function resolveRuntime(options: ShelfOptions): ServerRuntime {\n  // eslint-disable-next-line typescript/no-unnecessary-type-assertion -- ShelfConfig lacks index signature\n  const rawConfig = options.config\n    ? validateConfig(options.config as unknown as Record<string, unknown>)\n    : {};\n  // eslint-disable-next-line typescript/no-unnecessary-type-assertion -- UIConfig lacks index signature\n  const ui = options.ui ? validateUiConfig(options.ui as unknown as Record<string, unknown>) : {};\n  const logger = options.logger ?? createShelfLogger();\n  const authEnabled = options.auth !== undefined;\n  const design = options.design ?? [];\n  const notifiers = options.notifications?.notifiers ?? [];\n  // Adapter introspection — auto-populate config.adapters if not supplied\n  const config: ShelfConfig = rawConfig.adapters\n    ? rawConfig\n    : {\n        ...rawConfig,\n        adapters: buildAdapterSnapshot(options),\n      };\n  const publicOrigin = createPublicOriginResolver({ db: options.database, config });\n  return { config, ui, logger, authEnabled, design, notifiers, publicOrigin };\n}\n"],"mappings":";;;;;;;AAyBA,SAAS,qBAAqB,MAAuC,SAA6B;CAChG,IAAI,QAAQ,SAAS,QACnB,KAAK,mBAAmB,QAAQ,QAAQ,OAAO;AAEnD;;;;;;;;;AAUA,SAAgB,qBAAqB,SAAwD;CAC3F,MAAM,OAAwC;EAC5C,UAAU,QAAQ,SAAS;EAC3B,SAAS,QAAQ,QAAQ;CAC3B;CACA,qBAAqB,MAAM,OAAO;CAClC,KAAK,MAAM,KAAK,QAAQ,UAAU,CAAC,GACjC,KAAK,UAAU,EAAE,SAAS,UAAU,EAAE;CAExC,KAAK,MAAM,KAAK,QAAQ,eAAe,aAAa,CAAC,GACnD,KAAK,UAAU,EAAE,SAAS,UAAU,EAAE;CAExC,OAAO;AACT;;AAGA,SAAgB,eAAe,SAAsC;CAEnE,MAAM,YAAY,QAAQ,SACtB,eAAe,QAAQ,MAA4C,IACnE,CAAC;CAEL,MAAM,KAAK,QAAQ,KAAK,iBAAiB,QAAQ,EAAwC,IAAI,CAAC;CAC9F,MAAM,SAAS,QAAQ,UAAU,kBAAkB;CACnD,MAAM,cAAc,QAAQ,SAAS,KAAA;CACrC,MAAM,SAAS,QAAQ,UAAU,CAAC;CAClC,MAAM,YAAY,QAAQ,eAAe,aAAa,CAAC;CAEvD,MAAM,SAAsB,UAAU,WAClC,YACA;EACE,GAAG;EACH,UAAU,qBAAqB,OAAO;CACxC;CAEJ,OAAO;EAAE;EAAQ;EAAI;EAAQ;EAAa;EAAQ;EAAW,cADxC,2BAA2B;GAAE,IAAI,QAAQ;GAAU;EAAO,CACP;CAAE;AAC5E"}

package/dist/serverless.mjs

@@ -0,0 +1,5 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { isServerlessHost as isServerlessHost$1 } from "@storyshelf/core/config";
+export { isServerlessHost$1 as isServerlessHost };

package/dist/store.mjs

@@ -1,6 +1,7 @@
 import "node:path";
 import "node:url";
 import.meta.url;
+import { createCatalogLoader } from "@storyshelf/core/capture";
 import { AsyncLocalStorage } from "node:async_hooks";
 //#region src/store.ts
 const storage = new AsyncLocalStorage();
@@ -14,7 +15,24 @@ function getStore() {
 	if (!store) throw new Error("Store not available. Use runWithStore().");
 	return store;
 }
+/**
+* Whether this instance has `testing` (`options.testing` is set): it captures and compares builds,
+* so pages layer snapshot data (screenshots, statuses, design links) onto what the catalog gives
+* them. Without it the same pages render from the published Storybook alone, and the routes
+* classified `testing` answer 404 (`requireTesting`).
+*/
+function testingEnabled(store = getStore()) {
+	return store.testing;
+}
+/** The catalog loader pages read; hand-built stores without one get an uncached loader. */
+function catalogOf(store = getStore()) {
+	return store.publish?.catalog ?? createCatalogLoader({
+		db: store.db,
+		storage: store.storage,
+		logger: store.logger
+	});
+}
 //#endregion
-export { getStore, runWithStore };
+export { catalogOf, getStore, runWithStore, testingEnabled };
 
 //# sourceMappingURL=store.mjs.map

package/dist/store.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"store.mjs","names":[],"sources":["../src/store.ts"],"sourcesContent":["import type { CaptureQueue } from \"@storyshelf/core/adapter/capture-queue\";\nimport type { DatabaseAdapter } from \"@storyshelf/core/adapter/database\";\nimport type { GitHostProvider } from \"@storyshelf/core/adapter/git-host\";\nimport type { NotifierProvider } from \"@storyshelf/core/adapter/notifier\";\nimport type { StorageAdapter } from \"@storyshelf/core/adapter/storage\";\nimport type { ShelfConfig, UIConfig } from \"@storyshelf/core/config\";\nimport type { Logger } from \"@storyshelf/core/logger\";\nimport type { AuthUser } from \"@storyshelf/core/types\";\nimport { AsyncLocalStorage } from \"node:async_hooks\";\n\n/** Request-scoped dependencies and session state. */\nexport interface Store {\n  db: DatabaseAdapter;\n  storage: StorageAdapter;\n  config: ShelfConfig;\n  ui: UIConfig;\n  logger: Logger;\n  user: AuthUser | null;\n  authEnabled: boolean;\n  /** Raw session cookie value (\"default\" when anonymous); binds CSRF tokens. */\n  sessionId: string;\n  enqueueCapture?: (buildId: string, reqId?: string) => Promise<void>;\n  captureQueue?: CaptureQueue | null;\n  gitHosts: GitHostProvider[];\n  notifiers: NotifierProvider[];\n}\n\nconst storage = new AsyncLocalStorage<Store>();\n\n/** Run a function with the given request store in scope. */\nexport function runWithStore<T>(store: Store, fn: () => T): T {\n  return storage.run(store, fn);\n}\n\n/** Return the current request store, throwing outside a request scope. */\nexport function getStore(): Store {\n  const store = storage.getStore();\n  if (!store) {\n    throw new Error(\"Store not available. Use runWithStore().\");\n  }\n  return store;\n}\n"],"mappings":";;;;;AA2BA,MAAM,UAAU,IAAI,kBAAyB;;AAG7C,SAAgB,aAAgB,OAAc,IAAgB;CAC5D,OAAO,QAAQ,IAAI,OAAO,EAAE;AAC9B;;AAGA,SAAgB,WAAkB;CAChC,MAAM,QAAQ,QAAQ,SAAS;CAC/B,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,0CAA0C;CAE5D,OAAO;AACT"}
+{"version":3,"file":"store.mjs","names":[],"sources":["../src/store.ts"],"sourcesContent":["import type { CaptureQueue } from \"@storyshelf/core/adapter/capture-queue\";\nimport type { CaptureRunner } from \"@storyshelf/core/adapter/capture-runner\";\nimport type { DatabaseAdapter } from \"@storyshelf/core/adapter/database\";\nimport type { DesignProvider } from \"@storyshelf/core/adapter/design\";\nimport type { NotifierProvider } from \"@storyshelf/core/adapter/notifier\";\nimport type { StorageAdapter } from \"@storyshelf/core/adapter/storage\";\nimport type { Ai } from \"@storyshelf/core/ai\";\nimport {\n  createCatalogLoader,\n  type BuildStatePublisher,\n  type CatalogLoader,\n} from \"@storyshelf/core/capture\";\nimport type { NotificationsConfig, ShelfConfig, UIConfig } from \"@storyshelf/core/config\";\nimport type { Logger } from \"@storyshelf/core/logger\";\nimport type { PublicOriginResolver } from \"@storyshelf/core/models\";\nimport type { AuthUser } from \"@storyshelf/core/types\";\nimport { AsyncLocalStorage } from \"node:async_hooks\";\nimport type { PublishService } from \"./publish-setup.ts\";\n\n/** Request-scoped dependencies and session state. */\nexport interface Store {\n  db: DatabaseAdapter;\n  storage: StorageAdapter;\n  config: ShelfConfig;\n  ui: UIConfig;\n  logger: Logger;\n  user: AuthUser | null;\n  authEnabled: boolean;\n  /** Raw session cookie value (\"default\" when anonymous); binds CSRF tokens. */\n  sessionId: string;\n  /** `options.testing` is set: capture, compare and baselines run here (ADR 0006). */\n  testing: boolean;\n  enqueueCapture?: (buildId: string, reqId?: string) => Promise<void>;\n  captureQueue?: CaptureQueue | null;\n  /** This instance runs capture jobs itself, so retry and the compute-jobs controls apply. */\n  capturesHere?: boolean;\n  /** Publishing: completion and the `publish` job queue (absent in hand-built stores). */\n  publish?: PublishService;\n  /** Cancels the unfinished jobs of a build, of every kind (absent in hand-built stores). */\n  cancelBuildJobs?: (buildId: string) => Promise<boolean>;\n  /** Shows a build's state on its git channels (absent in hand-built stores: delivered inline). */\n  buildState?: BuildStatePublisher;\n  /** Explicit `testing.concurrency`; unset means sized from the hardware. */\n  captureConcurrency?: number;\n  /** The capture runner (`options.testing.runner`); its targets decide which browsers a project may pick. */\n  runner?: Pick<CaptureRunner, \"metadata\"> | undefined;\n  /** The public origin: configured, detected from the platform, or reported by an admin (ADR 0007). */\n  publicOrigin?: PublicOriginResolver | undefined;\n  /** Design providers (Figma, …); empty when none is wired. */\n  design: DesignProvider[];\n  notifiers: NotifierProvider[];\n  /** Brand/sender settings for outgoing notifications (`notifications.config`). */\n  notificationsConfig?: NotificationsConfig;\n  /** AI insights surface; absent ⇒ AI off site-wide. */\n  ai?: Ai;\n}\n\nconst storage = new AsyncLocalStorage<Store>();\n\n/** Run a function with the given request store in scope. */\nexport function runWithStore<T>(store: Store, fn: () => T): T {\n  return storage.run(store, fn);\n}\n\n/** Return the current request store, throwing outside a request scope. */\nexport function getStore(): Store {\n  const store = storage.getStore();\n  if (!store) {\n    throw new Error(\"Store not available. Use runWithStore().\");\n  }\n  return store;\n}\n\n/**\n * Whether this instance has `testing` (`options.testing` is set): it captures and compares builds,\n * so pages layer snapshot data (screenshots, statuses, design links) onto what the catalog gives\n * them. Without it the same pages render from the published Storybook alone, and the routes\n * classified `testing` answer 404 (`requireTesting`).\n */\nexport function testingEnabled(store: Store = getStore()): boolean {\n  return store.testing;\n}\n\n/** The catalog loader pages read; hand-built stores without one get an uncached loader. */\nexport function catalogOf(store: Store = getStore()): CatalogLoader {\n  return (\n    store.publish?.catalog ??\n    createCatalogLoader({ db: store.db, storage: store.storage, logger: store.logger })\n  );\n}\n"],"mappings":";;;;;;AAyDA,MAAM,UAAU,IAAI,kBAAyB;;AAG7C,SAAgB,aAAgB,OAAc,IAAgB;CAC5D,OAAO,QAAQ,IAAI,OAAO,EAAE;AAC9B;;AAGA,SAAgB,WAAkB;CAChC,MAAM,QAAQ,QAAQ,SAAS;CAC/B,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,0CAA0C;CAE5D,OAAO;AACT;;;;;;;AAQA,SAAgB,eAAe,QAAe,SAAS,GAAY;CACjE,OAAO,MAAM;AACf;;AAGA,SAAgB,UAAU,QAAe,SAAS,GAAkB;CAClE,OACE,MAAM,SAAS,WACf,oBAAoB;EAAE,IAAI,MAAM;EAAI,SAAS,MAAM;EAAS,QAAQ,MAAM;CAAO,CAAC;AAEtF"}

package/dist/targets.mjs

@@ -0,0 +1,46 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { getStore } from "./store.mjs";
+import { MAX_BROWSERS, assertSupportedBrowsers, offeredTargets } from "@storyshelf/core/capture";
+import { HTTPException } from "hono/http-exception";
+import { isCaptureTarget, parseTarget } from "@storyshelf/core/adapter/capture-runner";
+//#region src/targets.ts
+/** Which capture targets this instance offers right now, and the checks a settings save runs (ADR 0007). */
+/**
+* The targets the runner offers, with the ones that need a URL marked `unavailable` while there is
+* no `secret` or public origin. `undefined` when there is no runner or it publishes no list: any
+* target is accepted, as before.
+*/
+async function runnerTargets(store = getStore()) {
+	if (store.runner === void 0) return;
+	return offeredTargets(store.runner, {
+		publicOrigin: await store.publicOrigin?.url(),
+		hasSecret: store.config.secret !== void 0
+	});
+}
+/** Engine label for a target (`Chromium`), plus the remote's name (`Chromium on grid`). */
+function targetLabel(target) {
+	const { engine, name } = parseTarget(target);
+	const label = engine === "webkit" ? "WebKit" : `${engine[0]?.toUpperCase()}${engine.slice(1)}`;
+	return name === void 0 ? label : `${label} on ${name}`;
+}
+/**
+* Refuse, with 400 and the reason, a target list the runner cannot render (not offered, or
+* unavailable), or one that is malformed or too long. Runs when a setting is saved, so a build
+* never fails one by one with an unexplained error.
+*/
+async function assertTargetsSelectable(targets, current = []) {
+	const bad = targets.find((target) => !isCaptureTarget(target));
+	if (bad !== void 0) throw new HTTPException(400, { message: `Invalid capture target "${bad}"` });
+	if (targets.length > MAX_BROWSERS) throw new HTTPException(400, { message: `Choose at most ${MAX_BROWSERS} browsers` });
+	try {
+		assertSupportedBrowsers(targets.filter((target) => !current.includes(target)), await runnerTargets());
+	} catch (error) {
+		throw new HTTPException(400, { message: error instanceof Error ? error.message : "Refused" });
+	}
+}
+//#endregion
+export { assertTargetsSelectable, runnerTargets, targetLabel };
+
+//# sourceMappingURL=targets.mjs.map

package/dist/targets.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.mjs","names":[],"sources":["../src/targets.ts"],"sourcesContent":["/** Which capture targets this instance offers right now, and the checks a settings save runs (ADR 0007). */\nimport {\n  isCaptureTarget,\n  parseTarget,\n  type CaptureTarget,\n  type RunnerTarget,\n} from \"@storyshelf/core/adapter/capture-runner\";\nimport { MAX_BROWSERS, assertSupportedBrowsers, offeredTargets } from \"@storyshelf/core/capture\";\nimport { HTTPException } from \"hono/http-exception\";\nimport { getStore, type Store } from \"./store.ts\";\n\n/**\n * The targets the runner offers, with the ones that need a URL marked `unavailable` while there is\n * no `secret` or public origin. `undefined` when there is no runner or it publishes no list: any\n * target is accepted, as before.\n */\nexport async function runnerTargets(\n  store: Store = getStore(),\n): Promise<readonly RunnerTarget[] | undefined> {\n  if (store.runner === undefined) {\n    return undefined;\n  }\n  return offeredTargets(store.runner, {\n    publicOrigin: await store.publicOrigin?.url(),\n    hasSecret: store.config.secret !== undefined,\n  });\n}\n\n/** Engine label for a target (`Chromium`), plus the remote's name (`Chromium on grid`). */\nexport function targetLabel(target: CaptureTarget): string {\n  const { engine, name } = parseTarget(target);\n  const label = engine === \"webkit\" ? \"WebKit\" : `${engine[0]?.toUpperCase()}${engine.slice(1)}`;\n  return name === undefined ? label : `${label} on ${name}`;\n}\n\n/**\n * Refuse, with 400 and the reason, a target list the runner cannot render (not offered, or\n * unavailable), or one that is malformed or too long. Runs when a setting is saved, so a build\n * never fails one by one with an unexplained error.\n */\nexport async function assertTargetsSelectable(\n  targets: readonly string[],\n  /** Targets the project already has: saving them again is not a new choice, so they are not refused. */\n  current: readonly string[] = [],\n): Promise<void> {\n  const bad = targets.find((target) => !isCaptureTarget(target));\n  if (bad !== undefined) {\n    throw new HTTPException(400, { message: `Invalid capture target \"${bad}\"` });\n  }\n  if (targets.length > MAX_BROWSERS) {\n    throw new HTTPException(400, { message: `Choose at most ${MAX_BROWSERS} browsers` });\n  }\n  try {\n    assertSupportedBrowsers(\n      (targets as CaptureTarget[]).filter((target) => !current.includes(target)),\n      await runnerTargets(),\n    );\n  } catch (error) {\n    throw new HTTPException(400, { message: error instanceof Error ? error.message : \"Refused\" });\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;AAgBA,eAAsB,cACpB,QAAe,SAAS,GACsB;CAC9C,IAAI,MAAM,WAAW,KAAA,GACnB;CAEF,OAAO,eAAe,MAAM,QAAQ;EAClC,cAAc,MAAM,MAAM,cAAc,IAAI;EAC5C,WAAW,MAAM,OAAO,WAAW,KAAA;CACrC,CAAC;AACH;;AAGA,SAAgB,YAAY,QAA+B;CACzD,MAAM,EAAE,QAAQ,SAAS,YAAY,MAAM;CAC3C,MAAM,QAAQ,WAAW,WAAW,WAAW,GAAG,OAAO,EAAE,EAAE,YAAY,IAAI,OAAO,MAAM,CAAC;CAC3F,OAAO,SAAS,KAAA,IAAY,QAAQ,GAAG,MAAM,MAAM;AACrD;;;;;;AAOA,eAAsB,wBACpB,SAEA,UAA6B,CAAC,GACf;CACf,MAAM,MAAM,QAAQ,MAAM,WAAW,CAAC,gBAAgB,MAAM,CAAC;CAC7D,IAAI,QAAQ,KAAA,GACV,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,2BAA2B,IAAI,GAAG,CAAC;CAE7E,IAAI,QAAQ,SAAS,cACnB,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,kBAAkB,aAAa,WAAW,CAAC;CAErF,IAAI;EACF,wBACG,QAA4B,QAAQ,WAAW,CAAC,QAAQ,SAAS,MAAM,CAAC,GACzE,MAAM,cAAc,CACtB;CACF,SAAS,OAAO;EACd,MAAM,IAAI,cAAc,KAAK,EAAE,SAAS,iBAAiB,QAAQ,MAAM,UAAU,UAAU,CAAC;CAC9F;AACF"}

package/dist/ui/buttons.mjs

@@ -149,7 +149,7 @@ const btnClasses = {
 		sm: btnDangerSm
 	}
 };
-css`
+const tabsNav = css`
   /* tabs */
   display: flex;
   gap: 0.25rem;
@@ -171,7 +171,7 @@ const tabsLink = css`
     text-decoration: none;
   }
 `;
-css`
+const tabsLinkActive = css`
   /* tabs-link-active */
   ${tabsLink}
   color: var(--text-primary);
@@ -199,7 +199,20 @@ const Button = ({ variant = "primary", size = "md", type = "button", href, disab
 		children: content
 	});
 };
+/** Tab navigation bar for section switching. */
+const Tabs = ({ tabs, label = "Sections" }) => {
+	return /* @__PURE__ */ jsx("nav", {
+		class: tabsNav,
+		"aria-label": label,
+		children: tabs.map((tab) => /* @__PURE__ */ jsx("a", {
+			class: tab.active ? tabsLinkActive : tabsLink,
+			href: tab.href,
+			"aria-current": tab.active ? "page" : void 0,
+			children: tab.label
+		}))
+	});
+};
 //#endregion
-export { Button };
+export { Button, Tabs };
 
 //# sourceMappingURL=buttons.mjs.map

package/dist/ui/buttons.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"buttons.mjs","names":[],"sources":["../../src/ui/buttons.tsx"],"sourcesContent":["import type { FC } from \"hono/jsx\";\nimport { css } from \"./css.ts\";\nimport { Icon } from \"./icons/icon.tsx\";\nimport type { IconName } from \"./icons/paths.ts\";\n\n/* eslint-disable promise-function-async -- Hono JSX components return HtmlEscapedString | Promise<HtmlEscapedString> */\n\ntype ButtonVariant = \"primary\" | \"secondary\" | \"ghost\" | \"danger\" | \"outline\";\ntype ButtonSize = \"md\" | \"sm\";\n\nconst btnBase = css`\n  /* btn */\n  appearance: none;\n  border: 1px solid transparent;\n  border-radius: var(--radius);\n  padding: 0.55rem 0.9rem;\n  font-weight: 600;\n  font-size: var(--text-base);\n  cursor: pointer;\n  text-decoration: none;\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  gap: 0.4rem;\n  line-height: 1.2;\n  /* Top-aligned so a button in a <form> (a block with a line box) is exactly\n     as tall as the button instead of picking up a baseline strut. */\n  vertical-align: top;\n  min-height: 40px;\n  transition:\n    background var(--dur-fast) var(--ease),\n    border-color var(--dur-fast) var(--ease),\n    filter var(--dur-fast) var(--ease),\n    transform var(--dur-fast) var(--ease);\n  &:active:not(:disabled) {\n    transform: translateY(1px);\n  }\n  &:disabled {\n    opacity: 0.55;\n    cursor: not-allowed;\n  }\n`;\n\nconst btnPrimary = css`\n  /* btn-primary */\n  ${btnBase}\n  background: var(--accent);\n  color: var(--accent-contrast);\n  border-color: var(--accent);\n  box-shadow: var(--shadow);\n  &:hover {\n    filter: brightness(1.06);\n    text-decoration: none;\n  }\n`;\n\nconst btnPrimarySm = css`\n  /* btn-primary-sm */\n  ${btnPrimary}\n  padding: 0.35rem 0.6rem;\n  font-size: 0.8rem;\n  min-height: 32px;\n`;\n\nconst btnSecondary = css`\n  /* btn-secondary */\n  ${btnBase}\n  background: var(--surface-card);\n  color: var(--text-primary);\n  border-color: var(--border);\n  box-shadow: var(--shadow);\n  &:hover {\n    background: var(--surface-subtle);\n    text-decoration: none;\n  }\n`;\n\nconst btnSecondarySm = css`\n  /* btn-secondary-sm */\n  ${btnSecondary}\n  padding: 0.35rem 0.6rem;\n  font-size: 0.8rem;\n  min-height: 32px;\n`;\n\nconst btnOutline = css`\n  /* btn-outline */\n  ${btnSecondary}\n  &:hover {\n    background: var(--surface-subtle);\n    text-decoration: none;\n  }\n`;\n\nconst btnOutlineSm = css`\n  /* btn-outline-sm */\n  ${btnOutline}\n  padding: 0.35rem 0.6rem;\n  font-size: 0.8rem;\n  min-height: 32px;\n`;\n\nconst btnGhost = css`\n  /* btn-ghost */\n  ${btnBase}\n  background: transparent;\n  color: var(--text-secondary);\n  border-color: transparent;\n  &:hover {\n    background: var(--surface-muted);\n    color: var(--text-primary);\n    text-decoration: none;\n  }\n`;\n\nconst btnGhostSm = css`\n  /* btn-ghost-sm */\n  ${btnGhost}\n  padding: 0.35rem 0.6rem;\n  font-size: 0.8rem;\n  min-height: 32px;\n`;\n\nconst btnDanger = css`\n  /* btn-danger */\n  ${btnBase}\n  background: color-mix(in srgb, var(--status-rejected) 82%, #000);\n  color: #fff;\n  border-color: color-mix(in srgb, var(--status-rejected) 82%, #000);\n  &:hover {\n    filter: brightness(1.06);\n    text-decoration: none;\n  }\n`;\n\nconst btnDangerSm = css`\n  /* btn-danger-sm */\n  ${btnDanger}\n  padding: 0.35rem 0.6rem;\n  font-size: 0.8rem;\n  min-height: 32px;\n`;\n\nconst btnClasses: Record<ButtonVariant, Record<ButtonSize, Promise<string>>> = {\n  primary: { md: btnPrimary, sm: btnPrimarySm },\n  secondary: { md: btnSecondary, sm: btnSecondarySm },\n  outline: { md: btnOutline, sm: btnOutlineSm },\n  ghost: { md: btnGhost, sm: btnGhostSm },\n  danger: { md: btnDanger, sm: btnDangerSm },\n};\n\nconst tabsNav = css`\n  /* tabs */\n  display: flex;\n  gap: 0.25rem;\n  border-bottom: 1px solid var(--border);\n  margin-bottom: 1rem;\n  overflow-x: auto;\n`;\n\nconst tabsLink = css`\n  /* tabs-link */\n  padding: 0.55rem 0.75rem;\n  border-bottom: 2px solid transparent;\n  color: var(--text-secondary);\n  font-size: 0.875rem;\n  text-decoration: none;\n  white-space: nowrap;\n  font-weight: 600;\n  &:hover {\n    color: var(--text-primary);\n    text-decoration: none;\n  }\n`;\n\nconst tabsLinkActive = css`\n  /* tabs-link-active */\n  ${tabsLink}\n  color: var(--text-primary);\n  border-bottom-color: var(--accent);\n`;\n\n/** Button or link styled as a button (renders an anchor when `href` is set). */\nexport const Button: FC<{\n  variant?: ButtonVariant;\n  size?: ButtonSize;\n  type?: \"button\" | \"submit\" | \"reset\";\n  href?: string;\n  disabled?: boolean;\n  /** Leading icon from the sprite. */\n  icon?: IconName;\n  children?: unknown;\n  [key: string]: unknown;\n}> = ({\n  variant = \"primary\",\n  size = \"md\",\n  type = \"button\",\n  href,\n  disabled,\n  icon,\n  children,\n  ...rest\n}) => {\n  const cls = btnClasses[variant][size];\n  const content = (\n    <>\n      {icon ? <Icon name={icon} size={size === \"sm\" ? \"sm\" : \"md\"} /> : null}\n      {children}\n    </>\n  );\n  if (href) {\n    return (\n      <a class={cls} href={href} aria-disabled={disabled ? \"true\" : undefined} {...rest}>\n        {content}\n      </a>\n    );\n  }\n  return (\n    <button class={cls} type={type} disabled={disabled} {...rest}>\n      {content}\n    </button>\n  );\n};\n\n/** Tab navigation bar for section switching. */\n// eslint-disable-next-line promise-function-async -- JSX component return type\nexport const Tabs: FC<{\n  tabs: { label: string; href: string; active?: boolean }[];\n  label?: string;\n}> = ({ tabs, label = \"Sections\" }) => {\n  return (\n    <nav class={tabsNav} aria-label={label}>\n      {tabs.map((tab) => (\n        <a\n          class={tab.active ? tabsLinkActive : tabsLink}\n          href={tab.href}\n          aria-current={tab.active ? \"page\" : undefined}\n        >\n          {tab.label}\n        </a>\n      ))}\n    </nav>\n  );\n};\n"],"mappings":";;;;;;;AAUA,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCnB,MAAM,aAAa,GAAG;;IAElB,QAAQ;;;;;;;;;;AAWZ,MAAM,eAAe,GAAG;;IAEpB,WAAW;;;;;AAMf,MAAM,eAAe,GAAG;;IAEpB,QAAQ;;;;;;;;;;AAWZ,MAAM,iBAAiB,GAAG;;IAEtB,aAAa;;;;;AAMjB,MAAM,aAAa,GAAG;;IAElB,aAAa;;;;;;AAOjB,MAAM,eAAe,GAAG;;IAEpB,WAAW;;;;;AAMf,MAAM,WAAW,GAAG;;IAEhB,QAAQ;;;;;;;;;;AAWZ,MAAM,aAAa,GAAG;;IAElB,SAAS;;;;;AAMb,MAAM,YAAY,GAAG;;IAEjB,QAAQ;;;;;;;;;AAUZ,MAAM,cAAc,GAAG;;IAEnB,UAAU;;;;;AAMd,MAAM,aAAyE;CAC7E,SAAS;EAAE,IAAI;EAAY,IAAI;CAAa;CAC5C,WAAW;EAAE,IAAI;EAAc,IAAI;CAAe;CAClD,SAAS;EAAE,IAAI;EAAY,IAAI;CAAa;CAC5C,OAAO;EAAE,IAAI;EAAU,IAAI;CAAW;CACtC,QAAQ;EAAE,IAAI;EAAW,IAAI;CAAY;AAC3C;AAEgB,GAAG;;;;;;;;AASnB,MAAM,WAAW,GAAG;;;;;;;;;;;;;;AAeG,GAAG;;IAEtB,SAAS;;;;;AAMb,MAAa,UAUP,EACJ,UAAU,WACV,OAAO,MACP,OAAO,UACP,MACA,UACA,MACA,UACA,GAAG,WACC;CACJ,MAAM,MAAM,WAAW,QAAQ,CAAC;CAChC,MAAM,UACJ,qBAAA,UAAA,EAAA,UAAA,CACG,OAAO,oBAAC,MAAD;EAAM,MAAM;EAAM,MAAM,SAAS,OAAO,OAAO;CAAO,CAAA,IAAI,MACjE,QACD,EAAA,CAAA;CAEJ,IAAI,MACF,OACE,oBAAC,KAAD;EAAG,OAAO;EAAW;EAAM,iBAAe,WAAW,SAAS,KAAA;EAAW,GAAI;EAC1E,UAAA;CACA,CAAA;CAGP,OACE,oBAAC,UAAD;EAAQ,OAAO;EAAW;EAAgB;EAAU,GAAI;EACrD,UAAA;CACK,CAAA;AAEZ"}
+{"version":3,"file":"buttons.mjs","names":[],"sources":["../../src/ui/buttons.tsx"],"sourcesContent":["import type { FC } from \"hono/jsx\";\nimport { css } from \"./css.ts\";\nimport { Icon } from \"./icons/icon.tsx\";\nimport type { IconName } from \"./icons/paths.ts\";\n\n/* eslint-disable promise-function-async -- Hono JSX components return HtmlEscapedString | Promise<HtmlEscapedString> */\n\ntype ButtonVariant = \"primary\" | \"secondary\" | \"ghost\" | \"danger\" | \"outline\";\ntype ButtonSize = \"md\" | \"sm\";\n\nconst btnBase = css`\n  /* btn */\n  appearance: none;\n  border: 1px solid transparent;\n  border-radius: var(--radius);\n  padding: 0.55rem 0.9rem;\n  font-weight: 600;\n  font-size: var(--text-base);\n  cursor: pointer;\n  text-decoration: none;\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  gap: 0.4rem;\n  line-height: 1.2;\n  /* Top-aligned so a button in a <form> (a block with a line box) is exactly\n     as tall as the button instead of picking up a baseline strut. */\n  vertical-align: top;\n  min-height: 40px;\n  transition:\n    background var(--dur-fast) var(--ease),\n    border-color var(--dur-fast) var(--ease),\n    filter var(--dur-fast) var(--ease),\n    transform var(--dur-fast) var(--ease);\n  &:active:not(:disabled) {\n    transform: translateY(1px);\n  }\n  &:disabled {\n    opacity: 0.55;\n    cursor: not-allowed;\n  }\n`;\n\nconst btnPrimary = css`\n  /* btn-primary */\n  ${btnBase}\n  background: var(--accent);\n  color: var(--accent-contrast);\n  border-color: var(--accent);\n  box-shadow: var(--shadow);\n  &:hover {\n    filter: brightness(1.06);\n    text-decoration: none;\n  }\n`;\n\nconst btnPrimarySm = css`\n  /* btn-primary-sm */\n  ${btnPrimary}\n  padding: 0.35rem 0.6rem;\n  font-size: 0.8rem;\n  min-height: 32px;\n`;\n\nconst btnSecondary = css`\n  /* btn-secondary */\n  ${btnBase}\n  background: var(--surface-card);\n  color: var(--text-primary);\n  border-color: var(--border);\n  box-shadow: var(--shadow);\n  &:hover {\n    background: var(--surface-subtle);\n    text-decoration: none;\n  }\n`;\n\nconst btnSecondarySm = css`\n  /* btn-secondary-sm */\n  ${btnSecondary}\n  padding: 0.35rem 0.6rem;\n  font-size: 0.8rem;\n  min-height: 32px;\n`;\n\nconst btnOutline = css`\n  /* btn-outline */\n  ${btnSecondary}\n  &:hover {\n    background: var(--surface-subtle);\n    text-decoration: none;\n  }\n`;\n\nconst btnOutlineSm = css`\n  /* btn-outline-sm */\n  ${btnOutline}\n  padding: 0.35rem 0.6rem;\n  font-size: 0.8rem;\n  min-height: 32px;\n`;\n\nconst btnGhost = css`\n  /* btn-ghost */\n  ${btnBase}\n  background: transparent;\n  color: var(--text-secondary);\n  border-color: transparent;\n  &:hover {\n    background: var(--surface-muted);\n    color: var(--text-primary);\n    text-decoration: none;\n  }\n`;\n\nconst btnGhostSm = css`\n  /* btn-ghost-sm */\n  ${btnGhost}\n  padding: 0.35rem 0.6rem;\n  font-size: 0.8rem;\n  min-height: 32px;\n`;\n\nconst btnDanger = css`\n  /* btn-danger */\n  ${btnBase}\n  background: color-mix(in srgb, var(--status-rejected) 82%, #000);\n  color: #fff;\n  border-color: color-mix(in srgb, var(--status-rejected) 82%, #000);\n  &:hover {\n    filter: brightness(1.06);\n    text-decoration: none;\n  }\n`;\n\nconst btnDangerSm = css`\n  /* btn-danger-sm */\n  ${btnDanger}\n  padding: 0.35rem 0.6rem;\n  font-size: 0.8rem;\n  min-height: 32px;\n`;\n\nconst btnClasses: Record<ButtonVariant, Record<ButtonSize, Promise<string>>> = {\n  primary: { md: btnPrimary, sm: btnPrimarySm },\n  secondary: { md: btnSecondary, sm: btnSecondarySm },\n  outline: { md: btnOutline, sm: btnOutlineSm },\n  ghost: { md: btnGhost, sm: btnGhostSm },\n  danger: { md: btnDanger, sm: btnDangerSm },\n};\n\nconst tabsNav = css`\n  /* tabs */\n  display: flex;\n  gap: 0.25rem;\n  border-bottom: 1px solid var(--border);\n  margin-bottom: 1rem;\n  overflow-x: auto;\n`;\n\nconst tabsLink = css`\n  /* tabs-link */\n  padding: 0.55rem 0.75rem;\n  border-bottom: 2px solid transparent;\n  color: var(--text-secondary);\n  font-size: 0.875rem;\n  text-decoration: none;\n  white-space: nowrap;\n  font-weight: 600;\n  &:hover {\n    color: var(--text-primary);\n    text-decoration: none;\n  }\n`;\n\nconst tabsLinkActive = css`\n  /* tabs-link-active */\n  ${tabsLink}\n  color: var(--text-primary);\n  border-bottom-color: var(--accent);\n`;\n\n/** Button or link styled as a button (renders an anchor when `href` is set). */\nexport const Button: FC<{\n  variant?: ButtonVariant;\n  size?: ButtonSize;\n  type?: \"button\" | \"submit\" | \"reset\";\n  href?: string;\n  disabled?: boolean;\n  /** Leading icon from the sprite. */\n  icon?: IconName;\n  children?: unknown;\n  [key: string]: unknown;\n}> = ({\n  variant = \"primary\",\n  size = \"md\",\n  type = \"button\",\n  href,\n  disabled,\n  icon,\n  children,\n  ...rest\n}) => {\n  const cls = btnClasses[variant][size];\n  const content = (\n    <>\n      {icon ? <Icon name={icon} size={size === \"sm\" ? \"sm\" : \"md\"} /> : null}\n      {children}\n    </>\n  );\n  if (href) {\n    return (\n      <a class={cls} href={href} aria-disabled={disabled ? \"true\" : undefined} {...rest}>\n        {content}\n      </a>\n    );\n  }\n  return (\n    <button class={cls} type={type} disabled={disabled} {...rest}>\n      {content}\n    </button>\n  );\n};\n\n/** Tab navigation bar for section switching. */\n// eslint-disable-next-line promise-function-async -- JSX component return type\nexport const Tabs: FC<{\n  tabs: { label: string; href: string; active?: boolean }[];\n  label?: string;\n}> = ({ tabs, label = \"Sections\" }) => {\n  return (\n    <nav class={tabsNav} aria-label={label}>\n      {tabs.map((tab) => (\n        <a\n          class={tab.active ? tabsLinkActive : tabsLink}\n          href={tab.href}\n          aria-current={tab.active ? \"page\" : undefined}\n        >\n          {tab.label}\n        </a>\n      ))}\n    </nav>\n  );\n};\n"],"mappings":";;;;;;;AAUA,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCnB,MAAM,aAAa,GAAG;;IAElB,QAAQ;;;;;;;;;;AAWZ,MAAM,eAAe,GAAG;;IAEpB,WAAW;;;;;AAMf,MAAM,eAAe,GAAG;;IAEpB,QAAQ;;;;;;;;;;AAWZ,MAAM,iBAAiB,GAAG;;IAEtB,aAAa;;;;;AAMjB,MAAM,aAAa,GAAG;;IAElB,aAAa;;;;;;AAOjB,MAAM,eAAe,GAAG;;IAEpB,WAAW;;;;;AAMf,MAAM,WAAW,GAAG;;IAEhB,QAAQ;;;;;;;;;;AAWZ,MAAM,aAAa,GAAG;;IAElB,SAAS;;;;;AAMb,MAAM,YAAY,GAAG;;IAEjB,QAAQ;;;;;;;;;AAUZ,MAAM,cAAc,GAAG;;IAEnB,UAAU;;;;;AAMd,MAAM,aAAyE;CAC7E,SAAS;EAAE,IAAI;EAAY,IAAI;CAAa;CAC5C,WAAW;EAAE,IAAI;EAAc,IAAI;CAAe;CAClD,SAAS;EAAE,IAAI;EAAY,IAAI;CAAa;CAC5C,OAAO;EAAE,IAAI;EAAU,IAAI;CAAW;CACtC,QAAQ;EAAE,IAAI;EAAW,IAAI;CAAY;AAC3C;AAEA,MAAM,UAAU,GAAG;;;;;;;;AASnB,MAAM,WAAW,GAAG;;;;;;;;;;;;;;AAepB,MAAM,iBAAiB,GAAG;;IAEtB,SAAS;;;;;AAMb,MAAa,UAUP,EACJ,UAAU,WACV,OAAO,MACP,OAAO,UACP,MACA,UACA,MACA,UACA,GAAG,WACC;CACJ,MAAM,MAAM,WAAW,QAAQ,CAAC;CAChC,MAAM,UACJ,qBAAA,UAAA,EAAA,UAAA,CACG,OAAO,oBAAC,MAAD;EAAM,MAAM;EAAM,MAAM,SAAS,OAAO,OAAO;CAAO,CAAA,IAAI,MACjE,QACD,EAAA,CAAA;CAEJ,IAAI,MACF,OACE,oBAAC,KAAD;EAAG,OAAO;EAAW;EAAM,iBAAe,WAAW,SAAS,KAAA;EAAW,GAAI;EAC1E,UAAA;CACA,CAAA;CAGP,OACE,oBAAC,UAAD;EAAQ,OAAO;EAAW;EAAgB;EAAU,GAAI;EACrD,UAAA;CACK,CAAA;AAEZ;;AAIA,MAAa,QAGP,EAAE,MAAM,QAAQ,iBAAiB;CACrC,OACE,oBAAC,OAAD;EAAK,OAAO;EAAS,cAAY;EAC9B,UAAA,KAAK,KAAK,QACT,oBAAC,KAAD;GACE,OAAO,IAAI,SAAS,iBAAiB;GACrC,MAAM,IAAI;GACV,gBAAc,IAAI,SAAS,SAAS,KAAA;GAEnC,UAAA,IAAI;EACJ,CAAA,CACJ;CACE,CAAA;AAET"}

package/dist/ui/design-reference.mjs

@@ -0,0 +1,97 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { css } from "./css.mjs";
+import { Icon } from "./icons/icon.mjs";
+import { Fragment, jsx, jsxs } from "hono/jsx/jsx-runtime";
+//#region src/ui/design-reference.tsx
+const referenceRoot = css`
+  /* design-reference */
+  display: grid;
+  background: var(--surface-card);
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  overflow: hidden;
+  .reference__label {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    gap: var(--space-3);
+    padding: 0.35rem 0.6rem;
+    background: var(--surface-subtle);
+    border-bottom: 1px solid var(--border);
+    color: var(--text-secondary);
+    font-size: var(--text-xs);
+    font-weight: 600;
+    letter-spacing: 0.06em;
+    text-transform: uppercase;
+  }
+  .reference__img {
+    display: block;
+    max-width: 100%;
+    max-height: 60vh;
+    margin: 0 auto;
+    object-fit: contain;
+  }
+`;
+const previewImg = css`
+  /* design-preview */
+  display: block;
+  width: 16rem;
+  max-width: 100%;
+  max-height: 14rem;
+  margin: 0.25rem auto;
+  object-fit: contain;
+  border-radius: var(--radius-sm);
+  background: repeating-conic-gradient(var(--surface-muted) 0% 25%, var(--surface-subtle) 0% 50%) 0
+    0 / 16px 16px;
+`;
+const previewCaption = css`
+  /* design-preview-caption */
+  padding: 0 0.6rem 0.25rem;
+  color: var(--text-secondary);
+  font-size: var(--text-xs);
+`;
+/** Cached design render shown as a reference pane under the diff stage. */
+const DesignReference = ({ src, name, href, providerName }) => /* @__PURE__ */ jsxs("figure", {
+	class: referenceRoot,
+	children: [/* @__PURE__ */ jsxs("figcaption", {
+		class: "reference__label",
+		children: [/* @__PURE__ */ jsxs("span", { children: [
+			providerName,
+			" reference",
+			name ? ` · ${name}` : ""
+		] }), /* @__PURE__ */ jsxs("a", {
+			href,
+			target: "_blank",
+			rel: "noopener noreferrer",
+			children: [
+				/* @__PURE__ */ jsx(Icon, {
+					name: "external-link",
+					size: "sm"
+				}),
+				" Open in ",
+				providerName
+			]
+		})]
+	}), /* @__PURE__ */ jsx("img", {
+		class: "reference__img",
+		src,
+		alt: name ? `${providerName} design: ${name}` : `${providerName} design`,
+		loading: "lazy"
+	})]
+});
+/** Small cached render for popovers, with an optional caption (the design name). */
+const DesignPreview = ({ src, name, providerName }) => /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx("img", {
+	class: previewImg,
+	src,
+	alt: name ? `${providerName} design: ${name}` : `${providerName} design`,
+	loading: "lazy"
+}), name ? /* @__PURE__ */ jsx("div", {
+	class: previewCaption,
+	children: name
+}) : null] });
+//#endregion
+export { DesignPreview, DesignReference };
+
+//# sourceMappingURL=design-reference.mjs.map

package/dist/ui/design-reference.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-reference.mjs","names":[],"sources":["../../src/ui/design-reference.tsx"],"sourcesContent":["import type { FC } from \"hono/jsx\";\nimport { css } from \"./css.ts\";\nimport { Icon } from \"./icons/icon.tsx\";\n\n/* eslint-disable promise-function-async -- Hono JSX components return HtmlEscapedString | Promise<HtmlEscapedString> */\n\nconst referenceRoot = css`\n  /* design-reference */\n  display: grid;\n  background: var(--surface-card);\n  border: 1px solid var(--border);\n  border-radius: var(--radius);\n  overflow: hidden;\n  .reference__label {\n    display: flex;\n    align-items: center;\n    justify-content: space-between;\n    gap: var(--space-3);\n    padding: 0.35rem 0.6rem;\n    background: var(--surface-subtle);\n    border-bottom: 1px solid var(--border);\n    color: var(--text-secondary);\n    font-size: var(--text-xs);\n    font-weight: 600;\n    letter-spacing: 0.06em;\n    text-transform: uppercase;\n  }\n  .reference__img {\n    display: block;\n    max-width: 100%;\n    max-height: 60vh;\n    margin: 0 auto;\n    object-fit: contain;\n  }\n`;\n\nconst previewImg = css`\n  /* design-preview */\n  display: block;\n  width: 16rem;\n  max-width: 100%;\n  max-height: 14rem;\n  margin: 0.25rem auto;\n  object-fit: contain;\n  border-radius: var(--radius-sm);\n  background: repeating-conic-gradient(var(--surface-muted) 0% 25%, var(--surface-subtle) 0% 50%) 0\n    0 / 16px 16px;\n`;\n\nconst previewCaption = css`\n  /* design-preview-caption */\n  padding: 0 0.6rem 0.25rem;\n  color: var(--text-secondary);\n  font-size: var(--text-xs);\n`;\n\n/** Cached design render shown as a reference pane under the diff stage. */\nexport const DesignReference: FC<{\n  src: string;\n  name?: string | null;\n  href: string;\n  providerName: string;\n}> = ({ src, name, href, providerName }) => (\n  <figure class={referenceRoot}>\n    <figcaption class=\"reference__label\">\n      <span>\n        {providerName} reference{name ? ` · ${name}` : \"\"}\n      </span>\n      <a href={href} target=\"_blank\" rel=\"noopener noreferrer\">\n        <Icon name=\"external-link\" size=\"sm\" /> Open in {providerName}\n      </a>\n    </figcaption>\n    <img\n      class=\"reference__img\"\n      src={src}\n      alt={name ? `${providerName} design: ${name}` : `${providerName} design`}\n      loading=\"lazy\"\n    />\n  </figure>\n);\n\n/** Small cached render for popovers, with an optional caption (the design name). */\nexport const DesignPreview: FC<{ src: string; name?: string | null; providerName: string }> = ({\n  src,\n  name,\n  providerName,\n}) => (\n  <>\n    <img\n      class={previewImg}\n      src={src}\n      alt={name ? `${providerName} design: ${name}` : `${providerName} design`}\n      loading=\"lazy\"\n    />\n    {name ? <div class={previewCaption}>{name}</div> : null}\n  </>\n);\n"],"mappings":";;;;;;;AAMA,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BzB,MAAM,aAAa,GAAG;;;;;;;;;;;;AAatB,MAAM,iBAAiB,GAAG;;;;;;;AAQ1B,MAAa,mBAKP,EAAE,KAAK,MAAM,MAAM,mBACvB,qBAAC,UAAD;CAAQ,OAAO;CAAf,UAAA,CACE,qBAAC,cAAD;EAAY,OAAM;EAAlB,UAAA,CACE,qBAAC,QAAD,EAAA,UAAA;GACG;GAAa;GAAW,OAAO,MAAM,SAAS;EAC3C,EAAA,CAAA,GACN,qBAAC,KAAD;GAAS;GAAM,QAAO;GAAS,KAAI;GAAnC,UAAA;IACE,oBAAC,MAAD;KAAM,MAAK;KAAgB,MAAK;IAAM,CAAA;IAAC;IAAU;GAChD;EACO,CAAA,CAAA;CACZ,CAAA,GAAA,oBAAC,OAAD;EACE,OAAM;EACD;EACL,KAAK,OAAO,GAAG,aAAa,WAAW,SAAS,GAAG,aAAa;EAChE,SAAQ;CACT,CAAA,CACK;;;AAIV,MAAa,iBAAkF,EAC7F,KACA,MACA,mBAEA,qBAAA,UAAA,EAAA,UAAA,CACE,oBAAC,OAAD;CACE,OAAO;CACF;CACL,KAAK,OAAO,GAAG,aAAa,WAAW,SAAS,GAAG,aAAa;CAChE,SAAQ;AACT,CAAA,GACA,OAAO,oBAAC,OAAD;CAAK,OAAO;CAAiB,UAAA;AAAU,CAAA,IAAI,IACnD,EAAA,CAAA"}

package/dist/ui/document.mjs

@@ -7,7 +7,6 @@ import { Style, css } from "./css.mjs";
 import { assetManifest } from "../asset-manifest.mjs";
 import { BareShell } from "./shell/bare.mjs";
 import { bootScript } from "./shell/boot-script.mjs";
-import { clientScript } from "./shell/client-script.mjs";
 import { Sidebar } from "./shell/sidebar.mjs";
 import { ToastRegion, TopBar } from "./shell/topbar.mjs";
 import { baseStyle } from "./styles.mjs";
@@ -120,7 +119,7 @@ const DocumentLayout = ({ title, nav, layout = "default", children }) => {
 			})] }),
 			/* @__PURE__ */ jsx(ToastRegion, {}),
 			/* @__PURE__ */ jsx("script", { src: assetManifest.htmx.href }),
-			/* @__PURE__ */ jsx("script", { dangerouslySetInnerHTML: { __html: clientScript() } })
+			/* @__PURE__ */ jsx("script", { src: assetManifest.client.href })
 		] })]
 	})] });
 };

package/dist/ui/document.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"document.mjs","names":[],"sources":["../../src/ui/document.tsx"],"sourcesContent":["import { raw } from \"hono/html\";\nimport type { FC } from \"hono/jsx\";\nimport { assetManifest } from \"../asset-manifest.ts\";\nimport { getCsrfToken } from \"../middleware/csrf.ts\";\nimport { getStore } from \"../store.ts\";\nimport { Style, css } from \"./css.ts\";\nimport { BareShell } from \"./shell/bare.tsx\";\nimport { bootScript } from \"./shell/boot-script.ts\";\nimport { clientScript } from \"./shell/client-script.ts\";\nimport type { NavConfig } from \"./shell/nav.ts\";\nimport { Sidebar } from \"./shell/sidebar.tsx\";\nimport { ToastRegion, TopBar } from \"./shell/topbar.tsx\";\nimport { baseStyle } from \"./styles.ts\";\nimport { DARK_THEME, LIGHT_THEME } from \"./theme.ts\";\n\n/* eslint-disable promise-function-async -- Hono JSX components return HtmlEscapedString | Promise<HtmlEscapedString> */\n\n/** Active section, project, and breadcrumb trail passed to the shell. */\nexport type { NavConfig };\n\n/** Rendered HTML content returned by page components. */\nexport type RenderedContent = string | Promise<string>;\n\n/**\n * Page frame: `default` is a readable column, `wide` uses the full viewport,\n * `bare` drops the app chrome (sign-in, invites).\n */\ntype PageLayout = \"default\" | \"wide\" | \"bare\";\n\nconst shellRoot = css`\n  /* shell */\n  display: grid;\n  grid-template-columns: var(--sidebar-width) minmax(0, 1fr);\n  min-height: 100vh;\n  @media (max-width: 880px) {\n    & {\n      grid-template-columns: minmax(0, 1fr);\n    }\n  }\n`;\n\nconst shellContent = css`\n  /* shell-content */\n  width: 100%;\n  max-width: 1200px;\n  margin: 0 auto;\n  padding: var(--space-6) var(--space-6) var(--space-8);\n  min-width: 0;\n  @media (max-width: 880px) {\n    & {\n      padding: var(--space-4);\n    }\n  }\n`;\n\nconst shellContentWide = css`\n  /* shell-content-wide */\n  ${shellContent}\n  max-width: none;\n`;\n\nconst shellBackdrop = css`\n  /* shell-backdrop */\n  position: fixed;\n  inset: 0;\n  z-index: 55;\n  background: rgb(0 0 0 / 0.4);\n  &[hidden] {\n    display: none;\n  }\n`;\n\n// Hono's JSX.Element is typed as `HtmlEscapedString | Promise<...>`, so JSX-returning\n// Functions can legitimately return a promise; the rule is a false positive here.\n/** Full HTML document shell with sidebar, top bar, theme, toasts, and HTMX. */\nexport const DocumentLayout: FC<{\n  title: string;\n  nav?: NavConfig;\n  layout?: PageLayout;\n  children?: unknown;\n}> = ({ title, nav, layout = \"default\", children }) => {\n  const { ui, config, sessionId } = getStore();\n  const name = ui.name ?? \"StoryShelf\";\n  const logo = ui.logo ?? assetManifest.mark.href;\n  const light = ui.lightTheme ?? LIGHT_THEME;\n  const dark = ui.darkTheme ?? DARK_THEME;\n\n  return (\n    <>\n      {/* Without a doctype browsers use quirks mode (form margins, line-box struts, …). */}\n      {raw(\"<!DOCTYPE html>\")}\n      <html lang=\"en\" data-theme=\"system\">\n        <head>\n          <meta charset=\"utf-8\" />\n          <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" />\n          <meta name=\"color-scheme\" content=\"light dark\" />\n          <meta name=\"csrf-token\" content={getCsrfToken(config.secret, sessionId)} />\n          {/* Favicon is the product's own mark, not brandable: it identifies\n              StoryShelf in the tab strip. `ui.logo` stays overridable. */}\n          <link rel=\"icon\" type=\"image/svg+xml\" href={assetManifest.mark.href} />\n          <title>\n            {title} · {name}\n          </title>\n          <style dangerouslySetInnerHTML={{ __html: baseStyle(light, dark) }} />\n          <Style />\n          <script dangerouslySetInnerHTML={{ __html: bootScript() }} />\n        </head>\n        <body>\n          <a class=\"skip-link\" href=\"#main-content\">\n            Skip to content\n          </a>\n          {layout === \"bare\" ? (\n            <BareShell name={name} logo={logo}>\n              {children}\n            </BareShell>\n          ) : (\n            <>\n              <div class={shellRoot}>\n                <Sidebar nav={nav} name={name} logo={logo} />\n                <div>\n                  <TopBar nav={nav} />\n                  <main\n                    id=\"main-content\"\n                    class={layout === \"wide\" ? shellContentWide : shellContent}\n                    tabindex={-1}\n                  >\n                    {children}\n                  </main>\n                </div>\n              </div>\n              <div class={shellBackdrop} data-sidebar-backdrop hidden />\n            </>\n          )}\n          <ToastRegion />\n          <script src={assetManifest.htmx.href} />\n          <script dangerouslySetInnerHTML={{ __html: clientScript() }} />\n        </body>\n      </html>\n    </>\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;AA6BA,MAAM,YAAY,GAAG;;;;;;;;;;;AAYrB,MAAM,eAAe,GAAG;;;;;;;;;;;;;AAcxB,MAAM,mBAAmB,GAAG;;IAExB,aAAa;;;AAIjB,MAAM,gBAAgB,GAAG;;;;;;;;;;;AAczB,MAAa,kBAKP,EAAE,OAAO,KAAK,SAAS,WAAW,eAAe;CACrD,MAAM,EAAE,IAAI,QAAQ,cAAc,SAAS;CAC3C,MAAM,OAAO,GAAG,QAAQ;CACxB,MAAM,OAAO,GAAG,QAAQ,cAAc,KAAK;CAC3C,MAAM,QAAQ,GAAG,cAAc;CAC/B,MAAM,OAAO,GAAG,aAAa;CAE7B,OACE,qBAAA,UAAA,EAAA,UAAA,CAEG,IAAI,iBAAiB,GACtB,qBAAC,QAAD;EAAM,MAAK;EAAK,cAAW;EAA3B,UAAA,CACE,qBAAC,QAAD,EAAA,UAAA;GACE,oBAAC,QAAD,EAAM,SAAQ,QAAS,CAAA;GACvB,oBAAC,QAAD;IAAM,MAAK;IAAW,SAAQ;GAAuC,CAAA;GACrE,oBAAC,QAAD;IAAM,MAAK;IAAe,SAAQ;GAAc,CAAA;GAChD,oBAAC,QAAD;IAAM,MAAK;IAAa,SAAS,aAAa,OAAO,QAAQ,SAAS;GAAI,CAAA;GAG1E,oBAAC,QAAD;IAAM,KAAI;IAAO,MAAK;IAAgB,MAAM,cAAc,KAAK;GAAO,CAAA;GACtE,qBAAC,SAAD,EAAA,UAAA;IACG;IAAM;IAAI;GACN,EAAA,CAAA;GACP,oBAAC,SAAD,EAAO,yBAAyB,EAAE,QAAQ,UAAU,OAAO,IAAI,EAAE,EAAI,CAAA;GACrE,oBAAC,OAAD,CAAQ,CAAA;GACR,oBAAC,UAAD,EAAQ,yBAAyB,EAAE,QAAQ,WAAW,EAAE,EAAI,CAAA;EACxD,EAAA,CAAA,GACN,qBAAC,QAAD,EAAA,UAAA;GACE,oBAAC,KAAD;IAAG,OAAM;IAAY,MAAK;IAAgB,UAAA;GAEvC,CAAA;GACF,WAAW,SACV,oBAAC,WAAD;IAAiB;IAAY;IAC1B;GACQ,CAAA,IAEX,qBAAA,UAAA,EAAA,UAAA,CACE,qBAAC,OAAD;IAAK,OAAO;IAAZ,UAAA,CACE,oBAAC,SAAD;KAAc;KAAW;KAAY;IAAO,CAAA,GAC5C,qBAAC,OAAD,EAAA,UAAA,CACE,oBAAC,QAAD,EAAa,IAAM,CAAA,GACnB,oBAAC,QAAD;KACE,IAAG;KACH,OAAO,WAAW,SAAS,mBAAmB;KAC9C,UAAU;KAET;IACG,CAAA,CACH,EAAA,CAAA,CACF;GACL,CAAA,GAAA,oBAAC,OAAD;IAAK,OAAO;IAAe,yBAAA;IAAsB,QAAA;GAAQ,CAAA,CACzD,EAAA,CAAA;GAEJ,oBAAC,aAAD,CAAc,CAAA;GACd,oBAAC,UAAD,EAAQ,KAAK,cAAc,KAAK,KAAO,CAAA;GACvC,oBAAC,UAAD,EAAQ,yBAAyB,EAAE,QAAQ,aAAa,EAAE,EAAI,CAAA;EAC1D,EAAA,CAAA,CACF;CACN,CAAA,CAAA,EAAA,CAAA;AAEN"}
+{"version":3,"file":"document.mjs","names":[],"sources":["../../src/ui/document.tsx"],"sourcesContent":["import { raw } from \"hono/html\";\nimport type { FC } from \"hono/jsx\";\nimport { assetManifest } from \"../asset-manifest.ts\";\nimport { getCsrfToken } from \"../middleware/csrf.ts\";\nimport { getStore } from \"../store.ts\";\nimport { Style, css } from \"./css.ts\";\nimport { BareShell } from \"./shell/bare.tsx\";\nimport { bootScript } from \"./shell/boot-script.ts\";\nimport type { NavConfig } from \"./shell/nav.ts\";\nimport { Sidebar } from \"./shell/sidebar.tsx\";\nimport { ToastRegion, TopBar } from \"./shell/topbar.tsx\";\nimport { baseStyle } from \"./styles.ts\";\nimport { DARK_THEME, LIGHT_THEME } from \"./theme.ts\";\n\n/* eslint-disable promise-function-async -- Hono JSX components return HtmlEscapedString | Promise<HtmlEscapedString> */\n\n/** Active section, project, and breadcrumb trail passed to the shell. */\nexport type { NavConfig };\n\n/** Rendered HTML content returned by page components. */\nexport type RenderedContent = string | Promise<string>;\n\n/**\n * Page frame: `default` is a readable column, `wide` uses the full viewport,\n * `bare` drops the app chrome (sign-in, invites).\n */\ntype PageLayout = \"default\" | \"wide\" | \"bare\";\n\nconst shellRoot = css`\n  /* shell */\n  display: grid;\n  grid-template-columns: var(--sidebar-width) minmax(0, 1fr);\n  min-height: 100vh;\n  @media (max-width: 880px) {\n    & {\n      grid-template-columns: minmax(0, 1fr);\n    }\n  }\n`;\n\nconst shellContent = css`\n  /* shell-content */\n  width: 100%;\n  max-width: 1200px;\n  margin: 0 auto;\n  padding: var(--space-6) var(--space-6) var(--space-8);\n  min-width: 0;\n  @media (max-width: 880px) {\n    & {\n      padding: var(--space-4);\n    }\n  }\n`;\n\nconst shellContentWide = css`\n  /* shell-content-wide */\n  ${shellContent}\n  max-width: none;\n`;\n\nconst shellBackdrop = css`\n  /* shell-backdrop */\n  position: fixed;\n  inset: 0;\n  z-index: 55;\n  background: rgb(0 0 0 / 0.4);\n  &[hidden] {\n    display: none;\n  }\n`;\n\n// Hono's JSX.Element is typed as `HtmlEscapedString | Promise<...>`, so JSX-returning\n// Functions can legitimately return a promise; the rule is a false positive here.\n/** Full HTML document shell with sidebar, top bar, theme, toasts, and HTMX. */\nexport const DocumentLayout: FC<{\n  title: string;\n  nav?: NavConfig;\n  layout?: PageLayout;\n  children?: unknown;\n}> = ({ title, nav, layout = \"default\", children }) => {\n  const { ui, config, sessionId } = getStore();\n  const name = ui.name ?? \"StoryShelf\";\n  const logo = ui.logo ?? assetManifest.mark.href;\n  const light = ui.lightTheme ?? LIGHT_THEME;\n  const dark = ui.darkTheme ?? DARK_THEME;\n\n  return (\n    <>\n      {/* Without a doctype browsers use quirks mode (form margins, line-box struts, …). */}\n      {raw(\"<!DOCTYPE html>\")}\n      <html lang=\"en\" data-theme=\"system\">\n        <head>\n          <meta charset=\"utf-8\" />\n          <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" />\n          <meta name=\"color-scheme\" content=\"light dark\" />\n          <meta name=\"csrf-token\" content={getCsrfToken(config.secret, sessionId)} />\n          {/* Favicon is the product's own mark, not brandable: it identifies\n              StoryShelf in the tab strip. `ui.logo` stays overridable. */}\n          <link rel=\"icon\" type=\"image/svg+xml\" href={assetManifest.mark.href} />\n          <title>\n            {title} · {name}\n          </title>\n          <style dangerouslySetInnerHTML={{ __html: baseStyle(light, dark) }} />\n          <Style />\n          <script dangerouslySetInnerHTML={{ __html: bootScript() }} />\n        </head>\n        <body>\n          <a class=\"skip-link\" href=\"#main-content\">\n            Skip to content\n          </a>\n          {layout === \"bare\" ? (\n            <BareShell name={name} logo={logo}>\n              {children}\n            </BareShell>\n          ) : (\n            <>\n              <div class={shellRoot}>\n                <Sidebar nav={nav} name={name} logo={logo} />\n                <div>\n                  <TopBar nav={nav} />\n                  <main\n                    id=\"main-content\"\n                    class={layout === \"wide\" ? shellContentWide : shellContent}\n                    tabindex={-1}\n                  >\n                    {children}\n                  </main>\n                </div>\n              </div>\n              <div class={shellBackdrop} data-sidebar-backdrop hidden />\n            </>\n          )}\n          <ToastRegion />\n          <script src={assetManifest.htmx.href} />\n          <script src={assetManifest.client.href} />\n        </body>\n      </html>\n    </>\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;AA4BA,MAAM,YAAY,GAAG;;;;;;;;;;;AAYrB,MAAM,eAAe,GAAG;;;;;;;;;;;;;AAcxB,MAAM,mBAAmB,GAAG;;IAExB,aAAa;;;AAIjB,MAAM,gBAAgB,GAAG;;;;;;;;;;;AAczB,MAAa,kBAKP,EAAE,OAAO,KAAK,SAAS,WAAW,eAAe;CACrD,MAAM,EAAE,IAAI,QAAQ,cAAc,SAAS;CAC3C,MAAM,OAAO,GAAG,QAAQ;CACxB,MAAM,OAAO,GAAG,QAAQ,cAAc,KAAK;CAC3C,MAAM,QAAQ,GAAG,cAAc;CAC/B,MAAM,OAAO,GAAG,aAAa;CAE7B,OACE,qBAAA,UAAA,EAAA,UAAA,CAEG,IAAI,iBAAiB,GACtB,qBAAC,QAAD;EAAM,MAAK;EAAK,cAAW;EAA3B,UAAA,CACE,qBAAC,QAAD,EAAA,UAAA;GACE,oBAAC,QAAD,EAAM,SAAQ,QAAS,CAAA;GACvB,oBAAC,QAAD;IAAM,MAAK;IAAW,SAAQ;GAAuC,CAAA;GACrE,oBAAC,QAAD;IAAM,MAAK;IAAe,SAAQ;GAAc,CAAA;GAChD,oBAAC,QAAD;IAAM,MAAK;IAAa,SAAS,aAAa,OAAO,QAAQ,SAAS;GAAI,CAAA;GAG1E,oBAAC,QAAD;IAAM,KAAI;IAAO,MAAK;IAAgB,MAAM,cAAc,KAAK;GAAO,CAAA;GACtE,qBAAC,SAAD,EAAA,UAAA;IACG;IAAM;IAAI;GACN,EAAA,CAAA;GACP,oBAAC,SAAD,EAAO,yBAAyB,EAAE,QAAQ,UAAU,OAAO,IAAI,EAAE,EAAI,CAAA;GACrE,oBAAC,OAAD,CAAQ,CAAA;GACR,oBAAC,UAAD,EAAQ,yBAAyB,EAAE,QAAQ,WAAW,EAAE,EAAI,CAAA;EACxD,EAAA,CAAA,GACN,qBAAC,QAAD,EAAA,UAAA;GACE,oBAAC,KAAD;IAAG,OAAM;IAAY,MAAK;IAAgB,UAAA;GAEvC,CAAA;GACF,WAAW,SACV,oBAAC,WAAD;IAAiB;IAAY;IAC1B;GACQ,CAAA,IAEX,qBAAA,UAAA,EAAA,UAAA,CACE,qBAAC,OAAD;IAAK,OAAO;IAAZ,UAAA,CACE,oBAAC,SAAD;KAAc;KAAW;KAAY;IAAO,CAAA,GAC5C,qBAAC,OAAD,EAAA,UAAA,CACE,oBAAC,QAAD,EAAa,IAAM,CAAA,GACnB,oBAAC,QAAD;KACE,IAAG;KACH,OAAO,WAAW,SAAS,mBAAmB;KAC9C,UAAU;KAET;IACG,CAAA,CACH,EAAA,CAAA,CACF;GACL,CAAA,GAAA,oBAAC,OAAD;IAAK,OAAO;IAAe,yBAAA;IAAsB,QAAA;GAAQ,CAAA,CACzD,EAAA,CAAA;GAEJ,oBAAC,aAAD,CAAc,CAAA;GACd,oBAAC,UAAD,EAAQ,KAAK,cAAc,KAAK,KAAO,CAAA;GACvC,oBAAC,UAAD,EAAQ,KAAK,cAAc,OAAO,KAAO,CAAA;EACrC,EAAA,CAAA,CACF;CACN,CAAA,CAAA,EAAA,CAAA;AAEN"}

package/dist/ui/forms.mjs

@@ -226,28 +226,29 @@ const CheckField = ({ label, name, value, checked, disabled, hint }) => {
 	});
 };
 /** Labeled textarea with error and hint states. */
-const TextareaField = ({ label, name, value, placeholder, rows = 3, required, hint, error }) => {
+const TextareaField = ({ label, name, id, value, placeholder, rows = 3, required, hint, error }) => {
+	const domId = id ?? name;
 	return /* @__PURE__ */ jsxs("div", {
 		class: fieldWrap,
 		children: [
 			/* @__PURE__ */ jsx("label", {
 				class: fieldLabel,
-				for: name,
+				for: domId,
 				children: label
 			}),
 			/* @__PURE__ */ jsx("textarea", {
 				class: error ? fieldTextareaError : fieldTextarea,
-				id: name,
+				id: domId,
 				name,
 				placeholder,
 				rows,
 				required,
 				"aria-invalid": error ? "true" : void 0,
-				"aria-describedby": fieldDescribedBy(name, error, hint),
+				"aria-describedby": fieldDescribedBy(domId, error, hint),
 				children: value
 			}),
 			/* @__PURE__ */ jsx(FieldAssistant, {
-				name,
+				name: domId,
 				error,
 				hint
 			})