@stonecrop/schema 0.25.0 → 0.27.0

package/README.md

@@ -305,6 +305,29 @@ stonecrop-schema generate -i introspection.json -o ./app/doctypes
 stonecrop-schema generate -s schema.graphql -o ./app/doctypes
 ```
 
+### What it writes
+
+Each table yields two peer doctypes — the entity, carrying every column and backing the record
+form, and its aggregate, the collection view — plus the `route` each one registers at:
+
+```jsonc
+// order.json
+{ "name": "Order", "slug": "order", "route": "/order/:id" }
+// orders.json
+{ "name": "Orders", "slug": "orders", "route": "/order" }
+```
+
+The pair shares one URL segment, taken from the entity, so no URL ever carries a plural.
+
+A doctype the schema shows as rows owned by another gets **no** `route`: it has no page, because
+its records are edited inside their parent. Ownership is read from `ON DELETE CASCADE`, the only
+place a database states it — a foreign key that cascades marks rows belonging to the parent, while
+one that does not marks a reference to something outliving it. A doctype that anything links to
+singly keeps its route regardless, so a link always has somewhere to navigate.
+
+Every key is yours once written. Regeneration verifies an authored file and never overwrites it, so
+a `route` you add, change or delete stays that way.
+
 ### Filtering types
 
 GraphQL schemas (especially PostGraphile) expose many internal types. Use `--include` to

package/dist/cli.js

@@ -1,31 +1,31 @@
 #!/usr/bin/env node
-import { readFileSync as c, existsSync as v, mkdirSync as O, writeFileSync as k } from "node:fs";
-import { resolve as d, join as C } from "node:path";
-import { parseArgs as P } from "node:util";
-import { getIntrospectionQuery as j } from "graphql";
-import { c as E, m as J, f as L, v as R } from "./validation-CQtfIFHQ.js";
-async function q(e, f) {
+import { readFileSync as i, existsSync as y, mkdirSync as E, writeFileSync as C } from "node:fs";
+import { resolve as u, join as A } from "node:path";
+import { parseArgs as J } from "node:util";
+import { getIntrospectionQuery as R } from "graphql";
+import { c as F, a as G, p as L, m as q, f as D, s as T, v as U } from "./validation-BjRDR6sh.js";
+async function Q(e, w) {
   const o = await fetch(e, {
     method: "POST",
     headers: {
       "Content-Type": "application/json",
-      ...f
+      ...w
     },
     body: JSON.stringify({
-      query: j()
+      query: R()
     })
   });
   if (!o.ok)
     throw new Error(`Failed to fetch introspection: ${o.status} ${o.statusText}`);
-  const p = await o.json();
-  if (p.errors?.length)
-    throw new Error(`GraphQL errors: ${p.errors.map((i) => i.message).join(", ")}`);
-  if (!p.data)
+  const l = await o.json();
+  if (l.errors?.length)
+    throw new Error(`GraphQL errors: ${l.errors.map((r) => r.message).join(", ")}`);
+  if (!l.data)
     throw new Error("No data in introspection response");
-  return p.data;
+  return l.data;
 }
-async function D() {
-  const { values: e, positionals: f } = P({
+async function W() {
+  const { values: e, positionals: w } = J({
     allowPositionals: !0,
     options: {
       endpoint: { type: "string", short: "e" },
@@ -37,72 +37,87 @@ async function D() {
       names: { type: "string" },
       "custom-scalars": { type: "string" },
       "include-unmapped": { type: "boolean", default: !1 },
+      "no-aggregates": { type: "boolean", default: !1 },
       check: { type: "boolean", default: !1 },
       help: { type: "boolean", short: "h" }
     }
-  }), o = f[0];
-  (e.help || !o) && (F(), process.exit(o ? 0 : 1)), o !== "generate" && (console.error(`Unknown command: ${o}`), console.error("Available commands: generate"), process.exit(1)), [e.endpoint, e.introspection, e.sdl].filter(Boolean).length !== 1 && (console.error("Exactly one of --endpoint, --introspection, or --sdl must be provided"), process.exit(1)), e.output || (console.error("--output <dir> is required"), process.exit(1));
-  const i = d(e.output), a = {
+  }), o = w[0];
+  (e.help || !o) && (I(), process.exit(o ? 0 : 1)), o !== "generate" && (console.error(`Unknown command: ${o}`), console.error("Available commands: generate"), process.exit(1)), [e.endpoint, e.introspection, e.sdl].filter(Boolean).length !== 1 && (console.error("Exactly one of --endpoint, --introspection, or --sdl must be provided"), process.exit(1)), e.output || (console.error("--output <dir> is required"), process.exit(1));
+  const r = u(e.output), c = {
     includeUnmappedMeta: e["include-unmapped"]
   };
-  if (e.include && (a.include = e.include.split(",").map((t) => t.trim())), e.exclude && (a.exclude = e.exclude.split(",").map((t) => t.trim())), e.names) {
-    const t = d(e.names);
-    a.doctypeNames = JSON.parse(c(t, "utf-8"));
+  if (e.include && (c.include = e.include.split(",").map((t) => t.trim())), e.exclude && (c.exclude = e.exclude.split(",").map((t) => t.trim())), e.names) {
+    const t = u(e.names);
+    c.doctypeNames = JSON.parse(i(t, "utf-8"));
   }
-  if (a.onWarning = (t) => console.warn(`  WARN: ${t}`), e["custom-scalars"]) {
-    const t = d(e["custom-scalars"]), r = c(t, "utf-8");
-    a.customScalars = JSON.parse(r);
+  if (c.onWarning = (t) => console.warn(`  WARN: ${t}`), e["custom-scalars"]) {
+    const t = u(e["custom-scalars"]), n = i(t, "utf-8");
+    c.customScalars = JSON.parse(n);
   }
   let h;
   if (e.endpoint)
-    console.log(`Fetching introspection from ${e.endpoint}...`), h = await q(e.endpoint);
+    console.log(`Fetching introspection from ${e.endpoint}...`), h = await Q(e.endpoint);
   else if (e.introspection) {
-    const t = d(e.introspection), r = c(t, "utf-8"), s = JSON.parse(r);
-    h = s.data ?? s;
+    const t = u(e.introspection), n = i(t, "utf-8"), a = JSON.parse(n);
+    h = a.data ?? a;
   } else {
-    const t = d(e.sdl);
-    h = c(t, "utf-8");
+    const t = u(e.sdl);
+    h = i(t, "utf-8");
   }
-  const g = E(h, a);
-  g.length === 0 && (console.warn("No entity types found in the schema. Check your include/exclude filters."), process.exit(0)), v(i) || O(i, { recursive: !0 });
-  let y = 0, m = 0, u = 0;
-  const w = [];
-  for (const t of g) {
-    const r = `${t.slug}.json`, s = C(i, r);
-    let S = t;
-    if (v(s)) {
-      const { doctype: n, drift: l } = J(
-        JSON.parse(c(s, "utf-8")),
-        t
-      );
-      S = n, w.push(...L(l));
+  const v = F(h, c);
+  v.length === 0 && (console.warn("No entity types found in the schema. Check your include/exclude filters."), process.exit(0));
+  const O = {};
+  for (const t of v) {
+    const n = A(r, `${t.slug}.json`);
+    if (!y(n)) continue;
+    const a = G(JSON.parse(i(n, "utf-8")));
+    a !== void 0 && (O[t.name] = a);
+  }
+  const k = L(v, {
+    noAggregates: e["no-aggregates"],
+    identity: O,
+    onWarning: (t) => console.warn(`  WARN: ${t}`)
+  });
+  y(r) || E(r, { recursive: !0 });
+  let S = 0, f = 0, m = 0;
+  const $ = [];
+  for (const { generated: t, basis: n, subset: a } of k) {
+    const x = `${t.slug}.json`, p = A(r, x);
+    let N = t;
+    if (y(p)) {
+      const { doctype: s, drift: d } = q(JSON.parse(i(p, "utf-8")), n, {
+        subset: a
+      });
+      N = s, $.push(...D(d));
     }
-    const x = JSON.stringify(S, null, "	") + `
-`, $ = v(s) && c(s, "utf-8") === x;
-    $ || u++, !e.check && !$ && k(s, x, "utf-8");
-    const N = R(S);
-    if (N.success) {
-      const n = t.fields.filter((l) => l._unmapped);
-      n.length > 0 && (y++, console.warn(
-        `  WARN: ${r} has ${n.length} unmapped field(s): ${n.map((l) => l.fieldname).join(", ")}`
+    const g = { ...N };
+    Array.isArray(g.fields) && (g.fields = g.fields.map(T));
+    const b = JSON.stringify(g, null, "	") + `
+`, j = y(p) && i(p, "utf-8") === b;
+    j || m++, !e.check && !j && C(p, b, "utf-8");
+    const P = U(N);
+    if (P.success) {
+      const s = t.fields.filter((d) => d._unmapped);
+      s.length > 0 && (S++, console.warn(
+        `  WARN: ${x} has ${s.length} unmapped field(s): ${s.map((d) => d.fieldname).join(", ")}`
       ));
     } else {
-      m++, console.error(`  ERROR: ${r} failed validation:`);
-      for (const n of N.errors)
-        console.error(`    ${n.path.join(".")}: ${n.message}`);
+      f++, console.error(`  ERROR: ${x} failed validation:`);
+      for (const s of P.errors)
+        console.error(`    ${s.path.join(".")}: ${s.message}`);
     }
   }
-  if (w.length > 0) {
+  if ($.length > 0) {
     console.log(`
 Drift between the authored doctypes and the schema (reported, not applied):`);
-    for (const t of w) console.log(t);
+    for (const t of $) console.log(t);
   }
   console.log(
     `
-${e.check ? "Checked" : "Generated"} ${g.length} doctype(s) in ${i}` + (u ? ` (${u} ${e.check ? "would change" : "written"})` : " (all up to date)") + (y ? ` (${y} with warnings)` : "") + (m ? ` (${m} with errors)` : "")
-  ), (m > 0 || e.check && u > 0) && process.exit(1);
+${e.check ? "Checked" : "Generated"} ${k.length} doctype(s) in ${r}` + (m ? ` (${m} ${e.check ? "would change" : "written"})` : " (all up to date)") + (S ? ` (${S} with warnings)` : "") + (f ? ` (${f} with errors)` : "")
+  ), (f > 0 || e.check && m > 0) && process.exit(1);
 }
-function F() {
+function I() {
   console.log(`
 stonecrop-schema - Convert GraphQL schemas to Stonecrop doctypes
 
@@ -123,9 +138,20 @@ OPTIONS:
   --names <file>               JSON file mapping GraphQL type name to doctype name
   --custom-scalars <file>      JSON file mapping custom scalar names to field templates
   --include-unmapped           Include _graphqlType metadata on unmapped fields
+  --no-aggregates              Emit only the entity doctype, not its aggregate
   --check                      Report drift and exit non-zero if anything would change; write nothing
   --help, -h                   Show this help message
 
+Each table generates TWO doctypes: the entity (every column, backs the record form) and its
+aggregate (the collection view, identity column only by default), named as simple plurals —
+'task.json' and 'tasks.json'. Widen an aggregate by adding fields to it — curation survives
+regeneration. A doctype whose name is already plural gets no aggregate, because it would claim
+its own name and its own file; the run says so and still writes the entity.
+
+An aggregate needs an identity column. A table keyed on 'id' gives one up; for a natural key,
+declare 'primaryKey' on the field in the entity's own file and re-run — the aggregate is keyed
+on whatever that file declares.
+
 NOTE: an existing doctype file is the source of truth. Regeneration verifies it against the
 schema and adds 'source: introspected' markers; it reports disagreements rather than
 overwriting them, so hand-curation survives. Use --check in CI.
@@ -146,7 +172,7 @@ EXAMPLES:
     --include "User,Post,Comment"
 `);
 }
-D().catch((e) => {
+W().catch((e) => {
   console.error("Error:", e.message), process.exit(1);
 });
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n/* oxlint-disable no-console */\n\n/**\n * Stonecrop Schema CLI\n *\n * Converts GraphQL introspection results to Stonecrop doctype JSON schemas.\n *\n * Usage:\n *   stonecrop-schema generate --endpoint <url> --output <dir>\n *   stonecrop-schema generate --introspection <file.json> --output <dir>\n *   stonecrop-schema generate --sdl <file.graphql> --output <dir>\n *\n * @packageDocumentation\n */\n\nimport { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs'\nimport { resolve, join } from 'node:path'\nimport { parseArgs } from 'node:util'\nimport { getIntrospectionQuery, type IntrospectionQuery } from 'graphql'\n\nimport { convertGraphQLSchema, formatDoctypeDrift, mergeIntrospectedDoctype } from './converter/index'\nimport { validateDoctype } from './validation'\nimport type { GraphQLConversionOptions } from './converter/types'\n\n/**\n * Fetch an introspection result from a live GraphQL endpoint.\n *\n * @param endpoint - The GraphQL endpoint URL\n * @param headers - Optional HTTP headers\n * @returns The introspection query result\n */\nasync function fetchIntrospection(endpoint: string, headers?: Record<string, string>): Promise<IntrospectionQuery> {\n\tconst response = await fetch(endpoint, {\n\t\tmethod: 'POST',\n\t\theaders: {\n\t\t\t'Content-Type': 'application/json',\n\t\t\t...headers,\n\t\t},\n\t\tbody: JSON.stringify({\n\t\t\tquery: getIntrospectionQuery(),\n\t\t}),\n\t})\n\n\tif (!response.ok) {\n\t\tthrow new Error(`Failed to fetch introspection: ${response.status} ${response.statusText}`)\n\t}\n\n\tconst json: { data?: IntrospectionQuery; errors?: Array<{ message: string }> } = await response.json()\n\n\tif (json.errors?.length) {\n\t\tthrow new Error(`GraphQL errors: ${json.errors.map(e => e.message).join(', ')}`)\n\t}\n\n\tif (!json.data) {\n\t\tthrow new Error('No data in introspection response')\n\t}\n\n\treturn json.data\n}\n\nasync function main(): Promise<void> {\n\tconst { values, positionals } = parseArgs({\n\t\tallowPositionals: true,\n\t\toptions: {\n\t\t\tendpoint: { type: 'string', short: 'e' },\n\t\t\tintrospection: { type: 'string', short: 'i' },\n\t\t\tsdl: { type: 'string', short: 's' },\n\t\t\toutput: { type: 'string', short: 'o' },\n\t\t\tinclude: { type: 'string' },\n\t\t\texclude: { type: 'string' },\n\t\t\tnames: { type: 'string' },\n\t\t\t'custom-scalars': { type: 'string' },\n\t\t\t'include-unmapped': { type: 'boolean', default: false },\n\t\t\tcheck: { type: 'boolean', default: false },\n\t\t\thelp: { type: 'boolean', short: 'h' },\n\t\t},\n\t})\n\n\tconst command = positionals[0]\n\n\tif (values.help || !command) {\n\t\tprintHelp()\n\t\tprocess.exit(command ? 0 : 1)\n\t}\n\n\tif (command !== 'generate') {\n\t\tconsole.error(`Unknown command: ${command}`)\n\t\tconsole.error('Available commands: generate')\n\t\tprocess.exit(1)\n\t}\n\n\t// Determine source\n\tconst sourceCount = [values.endpoint, values.introspection, values.sdl].filter(Boolean).length\n\tif (sourceCount !== 1) {\n\t\tconsole.error('Exactly one of --endpoint, --introspection, or --sdl must be provided')\n\t\tprocess.exit(1)\n\t}\n\n\tif (!values.output) {\n\t\tconsole.error('--output <dir> is required')\n\t\tprocess.exit(1)\n\t}\n\n\tconst outputDir = resolve(values.output)\n\n\t// Build conversion options\n\tconst options: GraphQLConversionOptions = {\n\t\tincludeUnmappedMeta: values['include-unmapped'],\n\t}\n\n\tif (values.include) {\n\t\toptions.include = values.include.split(',').map(s => s.trim())\n\t}\n\n\tif (values.exclude) {\n\t\toptions.exclude = values.exclude.split(',').map(s => s.trim())\n\t}\n\n\tif (values.names) {\n\t\tconst namesPath = resolve(values.names)\n\t\toptions.doctypeNames = JSON.parse(readFileSync(namesPath, 'utf-8'))\n\t}\n\n\toptions.onWarning = message => console.warn(`  WARN: ${message}`)\n\n\tif (values['custom-scalars']) {\n\t\tconst scalarsPath = resolve(values['custom-scalars'])\n\t\tconst scalarsContent = readFileSync(scalarsPath, 'utf-8')\n\t\toptions.customScalars = JSON.parse(scalarsContent)\n\t}\n\n\t// Resolve source\n\tlet source: IntrospectionQuery | string\n\n\tif (values.endpoint) {\n\t\tconsole.log(`Fetching introspection from ${values.endpoint}...`)\n\t\tsource = await fetchIntrospection(values.endpoint)\n\t} else if (values.introspection) {\n\t\tconst filePath = resolve(values.introspection)\n\t\tconst content = readFileSync(filePath, 'utf-8')\n\t\tconst parsed = JSON.parse(content)\n\t\t// Handle both { data: { __schema: ... } } and { __schema: ... } formats\n\t\tsource = parsed.data ?? parsed\n\t} else {\n\t\tconst filePath = resolve(values.sdl!)\n\t\tsource = readFileSync(filePath, 'utf-8')\n\t}\n\n\t// Convert\n\tconst doctypes = convertGraphQLSchema(source, options)\n\n\tif (doctypes.length === 0) {\n\t\tconsole.warn('No entity types found in the schema. Check your include/exclude filters.')\n\t\tprocess.exit(0)\n\t}\n\n\t// Write output\n\tif (!existsSync(outputDir)) {\n\t\tmkdirSync(outputDir, { recursive: true })\n\t}\n\n\tlet warnings = 0\n\tlet errors = 0\n\tlet changed = 0\n\tconst driftLines: string[] = []\n\n\tfor (const generated of doctypes) {\n\t\tconst fileName = `${generated.slug}.json`\n\t\tconst filePath = join(outputDir, fileName)\n\n\t\t// When a doctype already exists it is the source of truth: generation confirms it and adds\n\t\t// provenance markers, and reports anything it disagrees with rather than applying it. A\n\t\t// doctype legitimately declares identity the schema cannot express — most often a natural\n\t\t// key that is a UNIQUE constraint, not the table's PRIMARY KEY — and overwriting that would\n\t\t// silently re-key the doctype on every run. A first generation has nothing to merge into,\n\t\t// so converter output is written verbatim.\n\t\tlet output: object = generated\n\t\tif (existsSync(filePath)) {\n\t\t\tconst { doctype: merged, drift } = mergeIntrospectedDoctype(\n\t\t\t\tJSON.parse(readFileSync(filePath, 'utf-8')),\n\t\t\t\tgenerated\n\t\t\t)\n\t\t\toutput = merged\n\t\t\tdriftLines.push(...formatDoctypeDrift(drift))\n\t\t}\n\n\t\t// Serialize the merged object directly. Never round-trip it through the Zod parser first:\n\t\t// that runs in strip mode and would silently drop every key this package does not model,\n\t\t// `handler` on an action being the one consumers actually rely on.\n\t\tconst json = JSON.stringify(output, null, '\\t') + '\\n'\n\t\tconst unchanged = existsSync(filePath) && readFileSync(filePath, 'utf-8') === json\n\t\tif (!unchanged) changed++\n\n\t\tif (!values.check && !unchanged) {\n\t\t\twriteFileSync(filePath, json, 'utf-8')\n\t\t}\n\n\t\t// Validate the output\n\t\tconst validation = validateDoctype(output)\n\t\tif (!validation.success) {\n\t\t\terrors++\n\t\t\tconsole.error(`  ERROR: ${fileName} failed validation:`)\n\t\t\tfor (const err of validation.errors) {\n\t\t\t\tconsole.error(`    ${err.path.join('.')}: ${err.message}`)\n\t\t\t}\n\t\t} else {\n\t\t\t// Check for unmapped fields\n\t\t\tconst unmappedFields = generated.fields.filter((f: any) => f._unmapped)\n\t\t\tif (unmappedFields.length > 0) {\n\t\t\t\twarnings++\n\t\t\t\tconsole.warn(\n\t\t\t\t\t`  WARN: ${fileName} has ${unmappedFields.length} unmapped field(s): ${unmappedFields\n\t\t\t\t\t\t.map((f: any) => f.fieldname)\n\t\t\t\t\t\t.join(', ')}`\n\t\t\t\t)\n\t\t\t}\n\t\t}\n\t}\n\n\tif (driftLines.length > 0) {\n\t\tconsole.log('\\nDrift between the authored doctypes and the schema (reported, not applied):')\n\t\tfor (const line of driftLines) console.log(line)\n\t}\n\n\tconsole.log(\n\t\t`\\n${values.check ? 'Checked' : 'Generated'} ${doctypes.length} doctype(s) in ${outputDir}` +\n\t\t\t(changed ? ` (${changed} ${values.check ? 'would change' : 'written'})` : ' (all up to date)') +\n\t\t\t(warnings ? ` (${warnings} with warnings)` : '') +\n\t\t\t(errors ? ` (${errors} with errors)` : '')\n\t)\n\n\tif (errors > 0 || (values.check && changed > 0)) {\n\t\tprocess.exit(1)\n\t}\n}\n\nfunction printHelp(): void {\n\tconsole.log(`\nstonecrop-schema - Convert GraphQL schemas to Stonecrop doctypes\n\nUSAGE:\n  stonecrop-schema generate [options]\n\nSOURCE (exactly one required):\n  --endpoint, -e <url>         Fetch introspection from a live GraphQL endpoint\n  --introspection, -i <file>   Read from a saved introspection JSON file\n  --sdl, -s <file>             Read from a GraphQL SDL (.graphql) file\n\nOUTPUT:\n  --output, -o <dir>           Directory to write doctype JSON files (required)\n\nOPTIONS:\n  --include <types>            Comma-separated list of type names to include\n  --exclude <types>            Comma-separated list of type names to exclude\n  --names <file>               JSON file mapping GraphQL type name to doctype name\n  --custom-scalars <file>      JSON file mapping custom scalar names to field templates\n  --include-unmapped           Include _graphqlType metadata on unmapped fields\n  --check                      Report drift and exit non-zero if anything would change; write nothing\n  --help, -h                   Show this help message\n\nNOTE: an existing doctype file is the source of truth. Regeneration verifies it against the\nschema and adds 'source: introspected' markers; it reports disagreements rather than\noverwriting them, so hand-curation survives. Use --check in CI.\n\nEXAMPLES:\n  # From a live PostGraphile server\n  stonecrop-schema generate -e http://localhost:5000/graphql -o ./schemas\n\n  # From a saved introspection result\n  stonecrop-schema generate -i introspection.json -o ./schemas\n\n  # From an SDL file with custom scalars\n  stonecrop-schema generate -s schema.graphql -o ./schemas \\\\\n    --custom-scalars custom-scalars.json\n\n  # Only convert specific types\n  stonecrop-schema generate -e http://localhost:5000/graphql -o ./schemas \\\\\n    --include \"User,Post,Comment\"\n`)\n}\n\nmain().catch(err => {\n\tconsole.error('Error:', err.message)\n\tprocess.exit(1)\n})\n"],"names":["fetchIntrospection","endpoint","headers","response","getIntrospectionQuery","json","e","main","values","positionals","parseArgs","command","printHelp","outputDir","resolve","options","s","namesPath","readFileSync","message","scalarsPath","scalarsContent","source","filePath","content","parsed","doctypes","convertGraphQLSchema","existsSync","mkdirSync","warnings","errors","changed","driftLines","generated","fileName","join","output","merged","drift","mergeIntrospectedDoctype","formatDoctypeDrift","unchanged","writeFileSync","validation","validateDoctype","unmappedFields","f","err","line"],"mappings":"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"}
+{"version":3,"file":"cli.js","sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n/* oxlint-disable no-console */\n\n/**\n * Stonecrop Schema CLI\n *\n * Converts GraphQL introspection results to Stonecrop doctype JSON schemas.\n *\n * Usage:\n *   stonecrop-schema generate --endpoint <url> --output <dir>\n *   stonecrop-schema generate --introspection <file.json> --output <dir>\n *   stonecrop-schema generate --sdl <file.graphql> --output <dir>\n *\n * @packageDocumentation\n */\n\nimport { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs'\nimport { resolve, join } from 'node:path'\nimport { parseArgs } from 'node:util'\nimport { getIntrospectionQuery, type IntrospectionQuery } from 'graphql'\n\nimport { authoredPrimaryKey } from './converter/authored'\nimport { convertGraphQLSchema, formatDoctypeDrift, mergeIntrospectedDoctype, planGeneration } from './converter/index'\nimport { stripFieldKind } from './field'\nimport { validateDoctype } from './validation'\nimport type { GraphQLConversionOptions } from './converter/types'\n\n/**\n * Fetch an introspection result from a live GraphQL endpoint.\n *\n * @param endpoint - The GraphQL endpoint URL\n * @param headers - Optional HTTP headers\n * @returns The introspection query result\n */\nasync function fetchIntrospection(endpoint: string, headers?: Record<string, string>): Promise<IntrospectionQuery> {\n\tconst response = await fetch(endpoint, {\n\t\tmethod: 'POST',\n\t\theaders: {\n\t\t\t'Content-Type': 'application/json',\n\t\t\t...headers,\n\t\t},\n\t\tbody: JSON.stringify({\n\t\t\tquery: getIntrospectionQuery(),\n\t\t}),\n\t})\n\n\tif (!response.ok) {\n\t\tthrow new Error(`Failed to fetch introspection: ${response.status} ${response.statusText}`)\n\t}\n\n\tconst json: { data?: IntrospectionQuery; errors?: Array<{ message: string }> } = await response.json()\n\n\tif (json.errors?.length) {\n\t\tthrow new Error(`GraphQL errors: ${json.errors.map(e => e.message).join(', ')}`)\n\t}\n\n\tif (!json.data) {\n\t\tthrow new Error('No data in introspection response')\n\t}\n\n\treturn json.data\n}\n\nasync function main(): Promise<void> {\n\tconst { values, positionals } = parseArgs({\n\t\tallowPositionals: true,\n\t\toptions: {\n\t\t\tendpoint: { type: 'string', short: 'e' },\n\t\t\tintrospection: { type: 'string', short: 'i' },\n\t\t\tsdl: { type: 'string', short: 's' },\n\t\t\toutput: { type: 'string', short: 'o' },\n\t\t\tinclude: { type: 'string' },\n\t\t\texclude: { type: 'string' },\n\t\t\tnames: { type: 'string' },\n\t\t\t'custom-scalars': { type: 'string' },\n\t\t\t'include-unmapped': { type: 'boolean', default: false },\n\t\t\t'no-aggregates': { type: 'boolean', default: false },\n\t\t\tcheck: { type: 'boolean', default: false },\n\t\t\thelp: { type: 'boolean', short: 'h' },\n\t\t},\n\t})\n\n\tconst command = positionals[0]\n\n\tif (values.help || !command) {\n\t\tprintHelp()\n\t\tprocess.exit(command ? 0 : 1)\n\t}\n\n\tif (command !== 'generate') {\n\t\tconsole.error(`Unknown command: ${command}`)\n\t\tconsole.error('Available commands: generate')\n\t\tprocess.exit(1)\n\t}\n\n\t// Determine source\n\tconst sourceCount = [values.endpoint, values.introspection, values.sdl].filter(Boolean).length\n\tif (sourceCount !== 1) {\n\t\tconsole.error('Exactly one of --endpoint, --introspection, or --sdl must be provided')\n\t\tprocess.exit(1)\n\t}\n\n\tif (!values.output) {\n\t\tconsole.error('--output <dir> is required')\n\t\tprocess.exit(1)\n\t}\n\n\tconst outputDir = resolve(values.output)\n\n\t// Build conversion options\n\tconst options: GraphQLConversionOptions = {\n\t\tincludeUnmappedMeta: values['include-unmapped'],\n\t}\n\n\tif (values.include) {\n\t\toptions.include = values.include.split(',').map(s => s.trim())\n\t}\n\n\tif (values.exclude) {\n\t\toptions.exclude = values.exclude.split(',').map(s => s.trim())\n\t}\n\n\tif (values.names) {\n\t\tconst namesPath = resolve(values.names)\n\t\toptions.doctypeNames = JSON.parse(readFileSync(namesPath, 'utf-8'))\n\t}\n\n\toptions.onWarning = message => console.warn(`  WARN: ${message}`)\n\n\tif (values['custom-scalars']) {\n\t\tconst scalarsPath = resolve(values['custom-scalars'])\n\t\tconst scalarsContent = readFileSync(scalarsPath, 'utf-8')\n\t\toptions.customScalars = JSON.parse(scalarsContent)\n\t}\n\n\t// Resolve source\n\tlet source: IntrospectionQuery | string\n\n\tif (values.endpoint) {\n\t\tconsole.log(`Fetching introspection from ${values.endpoint}...`)\n\t\tsource = await fetchIntrospection(values.endpoint)\n\t} else if (values.introspection) {\n\t\tconst filePath = resolve(values.introspection)\n\t\tconst content = readFileSync(filePath, 'utf-8')\n\t\tconst parsed = JSON.parse(content)\n\t\t// Handle both { data: { __schema: ... } } and { __schema: ... } formats\n\t\tsource = parsed.data ?? parsed\n\t} else {\n\t\tconst filePath = resolve(values.sdl!)\n\t\tsource = readFileSync(filePath, 'utf-8')\n\t}\n\n\t// Convert\n\tconst entities = convertGraphQLSchema(source, options)\n\n\tif (entities.length === 0) {\n\t\tconsole.warn('No entity types found in the schema. Check your include/exclude filters.')\n\t\tprocess.exit(0)\n\t}\n\n\t// Read the identity each authored doctype declares, before planning rather than during the write\n\t// loop below. SDL cannot express which UNIQUE column is a table's key, so for a natural-key\n\t// doctype the declaration in the file is the only answer that exists — and planning is what\n\t// decides whether the aggregate can be built at all. Reading it 20 lines later, as the loop\n\t// does, made the \"declare a primaryKey and re-run\" warning a dead end: re-running after\n\t// declaring one changed nothing.\n\tconst identity: Record<string, string> = {}\n\tfor (const entity of entities) {\n\t\tconst entityPath = join(outputDir, `${entity.slug}.json`)\n\t\tif (!existsSync(entityPath)) continue\n\t\tconst declared = authoredPrimaryKey(JSON.parse(readFileSync(entityPath, 'utf-8')))\n\t\tif (declared !== undefined) identity[entity.name] = declared\n\t}\n\n\t// Each table yields two doctypes — the entity and its aggregate — written as peers, one file\n\t// each, along with what each is verified against. See `planGeneration`.\n\tconst doctypes = planGeneration(entities, {\n\t\tnoAggregates: values['no-aggregates'],\n\t\tidentity,\n\t\tonWarning: message => console.warn(`  WARN: ${message}`),\n\t})\n\n\t// Write output\n\tif (!existsSync(outputDir)) {\n\t\tmkdirSync(outputDir, { recursive: true })\n\t}\n\n\tlet warnings = 0\n\tlet errors = 0\n\tlet changed = 0\n\tconst driftLines: string[] = []\n\n\tfor (const { generated, basis, subset } of doctypes) {\n\t\tconst fileName = `${generated.slug}.json`\n\t\tconst filePath = join(outputDir, fileName)\n\n\t\t// When a doctype already exists it is the source of truth: generation confirms it and adds\n\t\t// provenance markers, and reports anything it disagrees with rather than applying it. A\n\t\t// doctype legitimately declares identity the schema cannot express — most often a natural\n\t\t// key that is a UNIQUE constraint, not the table's PRIMARY KEY — and overwriting that would\n\t\t// silently re-key the doctype on every run. A first generation has nothing to merge into,\n\t\t// so converter output is written verbatim.\n\t\tlet output: object = generated\n\t\tif (existsSync(filePath)) {\n\t\t\tconst { doctype: merged, drift } = mergeIntrospectedDoctype(JSON.parse(readFileSync(filePath, 'utf-8')), basis, {\n\t\t\t\tsubset,\n\t\t\t})\n\t\t\toutput = merged\n\t\t\tdriftLines.push(...formatDoctypeDrift(drift))\n\t\t}\n\n\t\t// Serialize the merged object directly. Never round-trip it through the Zod parser first:\n\t\t// that runs in strip mode and would silently drop every key this package does not model,\n\t\t// `handler` on an action being the one consumers actually rely on.\n\t\t//\n\t\t// `kind` is dropped on the way out because it is the discriminated-union tag the parser\n\t\t// synthesizes, not authored data — `injectKind` puts it back on every read. Writing it made\n\t\t// the generator and the docbuilder disagree with hand-authored files about what a doctype\n\t\t// looks like, and re-added the key on every regeneration.\n\t\tconst serializable: Record<string, unknown> = { ...output }\n\t\tif (Array.isArray(serializable.fields)) {\n\t\t\tserializable.fields = serializable.fields.map(stripFieldKind)\n\t\t}\n\t\tconst json = JSON.stringify(serializable, null, '\\t') + '\\n'\n\t\tconst unchanged = existsSync(filePath) && readFileSync(filePath, 'utf-8') === json\n\t\tif (!unchanged) changed++\n\n\t\tif (!values.check && !unchanged) {\n\t\t\twriteFileSync(filePath, json, 'utf-8')\n\t\t}\n\n\t\t// Validate the output\n\t\tconst validation = validateDoctype(output)\n\t\tif (!validation.success) {\n\t\t\terrors++\n\t\t\tconsole.error(`  ERROR: ${fileName} failed validation:`)\n\t\t\tfor (const err of validation.errors) {\n\t\t\t\tconsole.error(`    ${err.path.join('.')}: ${err.message}`)\n\t\t\t}\n\t\t} else {\n\t\t\t// Check for unmapped fields\n\t\t\tconst unmappedFields = generated.fields.filter((f: any) => f._unmapped)\n\t\t\tif (unmappedFields.length > 0) {\n\t\t\t\twarnings++\n\t\t\t\tconsole.warn(\n\t\t\t\t\t`  WARN: ${fileName} has ${unmappedFields.length} unmapped field(s): ${unmappedFields\n\t\t\t\t\t\t.map((f: any) => f.fieldname)\n\t\t\t\t\t\t.join(', ')}`\n\t\t\t\t)\n\t\t\t}\n\t\t}\n\t}\n\n\tif (driftLines.length > 0) {\n\t\tconsole.log('\\nDrift between the authored doctypes and the schema (reported, not applied):')\n\t\tfor (const line of driftLines) console.log(line)\n\t}\n\n\tconsole.log(\n\t\t`\\n${values.check ? 'Checked' : 'Generated'} ${doctypes.length} doctype(s) in ${outputDir}` +\n\t\t\t(changed ? ` (${changed} ${values.check ? 'would change' : 'written'})` : ' (all up to date)') +\n\t\t\t(warnings ? ` (${warnings} with warnings)` : '') +\n\t\t\t(errors ? ` (${errors} with errors)` : '')\n\t)\n\n\tif (errors > 0 || (values.check && changed > 0)) {\n\t\tprocess.exit(1)\n\t}\n}\n\nfunction printHelp(): void {\n\tconsole.log(`\nstonecrop-schema - Convert GraphQL schemas to Stonecrop doctypes\n\nUSAGE:\n  stonecrop-schema generate [options]\n\nSOURCE (exactly one required):\n  --endpoint, -e <url>         Fetch introspection from a live GraphQL endpoint\n  --introspection, -i <file>   Read from a saved introspection JSON file\n  --sdl, -s <file>             Read from a GraphQL SDL (.graphql) file\n\nOUTPUT:\n  --output, -o <dir>           Directory to write doctype JSON files (required)\n\nOPTIONS:\n  --include <types>            Comma-separated list of type names to include\n  --exclude <types>            Comma-separated list of type names to exclude\n  --names <file>               JSON file mapping GraphQL type name to doctype name\n  --custom-scalars <file>      JSON file mapping custom scalar names to field templates\n  --include-unmapped           Include _graphqlType metadata on unmapped fields\n  --no-aggregates              Emit only the entity doctype, not its aggregate\n  --check                      Report drift and exit non-zero if anything would change; write nothing\n  --help, -h                   Show this help message\n\nEach table generates TWO doctypes: the entity (every column, backs the record form) and its\naggregate (the collection view, identity column only by default), named as simple plurals —\n'task.json' and 'tasks.json'. Widen an aggregate by adding fields to it — curation survives\nregeneration. A doctype whose name is already plural gets no aggregate, because it would claim\nits own name and its own file; the run says so and still writes the entity.\n\nAn aggregate needs an identity column. A table keyed on 'id' gives one up; for a natural key,\ndeclare 'primaryKey' on the field in the entity's own file and re-run — the aggregate is keyed\non whatever that file declares.\n\nNOTE: an existing doctype file is the source of truth. Regeneration verifies it against the\nschema and adds 'source: introspected' markers; it reports disagreements rather than\noverwriting them, so hand-curation survives. Use --check in CI.\n\nEXAMPLES:\n  # From a live PostGraphile server\n  stonecrop-schema generate -e http://localhost:5000/graphql -o ./schemas\n\n  # From a saved introspection result\n  stonecrop-schema generate -i introspection.json -o ./schemas\n\n  # From an SDL file with custom scalars\n  stonecrop-schema generate -s schema.graphql -o ./schemas \\\\\n    --custom-scalars custom-scalars.json\n\n  # Only convert specific types\n  stonecrop-schema generate -e http://localhost:5000/graphql -o ./schemas \\\\\n    --include \"User,Post,Comment\"\n`)\n}\n\nmain().catch(err => {\n\tconsole.error('Error:', err.message)\n\tprocess.exit(1)\n})\n"],"names":["fetchIntrospection","endpoint","headers","response","getIntrospectionQuery","json","e","main","values","positionals","parseArgs","command","printHelp","outputDir","resolve","options","s","namesPath","readFileSync","message","scalarsPath","scalarsContent","source","filePath","content","parsed","entities","convertGraphQLSchema","identity","entity","entityPath","join","existsSync","declared","authoredPrimaryKey","doctypes","planGeneration","mkdirSync","warnings","errors","changed","driftLines","generated","basis","subset","fileName","output","merged","drift","mergeIntrospectedDoctype","formatDoctypeDrift","serializable","stripFieldKind","unchanged","writeFileSync","validation","validateDoctype","unmappedFields","f","err","line"],"mappings":"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"}

package/dist/index.js

@@ -1,4 +1,4 @@
-import { A as E, D as N, F as h, G as _, I as p, a as j, L as x, T as P, b as R, d as B, V as w, W as M, e as k, g as G, h as K, i as V, j as W, k as Y, c as z, l as Q, n as q, o as J, f as X, p as H, q as U, r as Z, s as $, t as ee, u as re, m as ae, w as te, x as ne, y as ie, z as se, B as oe, C as le, E as ce, H as ue, v as de, J as fe } from "./validation-CQtfIFHQ.js";
+import { A as L, D as p, F as E, G as h, I as _, b as P, L as R, T as j, d as x, e as B, V as M, W as w, g as k, h as K, i as G, j as V, k as W, l as Q, n as Y, o as z, c as q, q as J, r as X, t as H, f as U, u as Z, w as $, x as ee, y as re, z as ae, B as te, C as ne, E as ie, m as se, H as oe, J as le, K as ce, M as de, p as ue, N as fe, O as Ae, s as ye, P as ge, Q as be, v as Se, R as ve } from "./validation-BjRDR6sh.js";
 const l = {
   ATextInput: "text",
   ATextboxInput: "text",
@@ -11,13 +11,14 @@ const l = {
   ADuration: "text",
   ADateRange: "date",
   ADropdown: "select",
+  ASegmentedControl: "select",
   ACodeEditor: "code",
   AFormLink: "link",
   AFileAttach: "attach",
   AQuantityInput: "quantity",
   ACurrencyInput: "currency"
 };
-function g(e) {
+function S(e) {
   return e ? l[e] : void 0;
 }
 const c = {
@@ -40,7 +41,7 @@ function t(e) {
 function i(e) {
   return typeof e == "string" && A.has(e);
 }
-function u(e) {
+function d(e) {
   if (e === null || typeof e != "object" || Array.isArray(e)) return !1;
   for (const a of Object.keys(e))
     if (!y.has(a)) return !1;
@@ -48,12 +49,12 @@ function u(e) {
   return !(r.variant !== void 0 && !i(r.variant) || r.color !== void 0 && typeof r.color != "string" || r.label !== void 0 && typeof r.label != "string");
 }
 function o(e) {
-  return i(e) || u(e);
+  return i(e) || d(e);
 }
 function n(e) {
   return Array.isArray(e.choices);
 }
-function T(e) {
+function m(e) {
   if (e === null || typeof e != "object" || Array.isArray(e)) return !1;
   const r = e;
   return !(typeof r.label != "string" || r.variant !== void 0 && !i(r.variant) || r.color !== void 0 && typeof r.color != "string");
@@ -67,90 +68,96 @@ function s(e) {
   const r = Object.entries(e);
   return r.length === 0 ? !1 : r.every(([, a]) => o(a));
 }
-function m(e) {
+function D(e) {
   return e === void 0 || Array.isArray(e) || !t(e) ? !1 : n(e);
 }
-function D(e) {
+function F(e) {
   return e === void 0 ? [] : Array.isArray(e) ? e : t(e) ? n(e) ? e.choices : s(e) ? Object.keys(e) : [] : [];
 }
-function d(e, r) {
-  return i(e) ? { label: r, variant: e } : u(e) ? {
+function u(e, r) {
+  return i(e) ? { label: r, variant: e } : d(e) ? {
     label: e.label ?? r,
     variant: e.variant,
     color: e.color
   } : { label: r };
 }
-function b(e, r) {
+function g(e, r) {
   if (!(r === void 0 || r === "") && r in e)
-    return d(e[r], r);
+    return u(e[r], r);
 }
-function S(e, r) {
+function b(e, r) {
   if (r === void 0 || r === "") return;
   const a = e.badges;
   if (!(!a || !(r in a)))
-    return d(a[r], r);
+    return u(a[r], r);
 }
-function F(e, r) {
+function T(e, r) {
   if (!(e === void 0 || r === void 0 || r === "") && !Array.isArray(e) && t(e)) {
-    if (n(e)) return S(e, r);
-    if (s(e)) return b(e, r);
+    if (n(e)) return b(e, r);
+    if (s(e)) return g(e, r);
   }
 }
-function I(e) {
+function C(e) {
   return e === void 0 || Array.isArray(e) || !t(e) ? !1 : n(e) ? e.badges !== void 0 && Object.keys(e.badges).length > 0 : s(e);
 }
 export {
-  E as ActionDefinition,
+  L as ActionDefinition,
   O as CANONICAL_COMPONENTS,
   l as COMPONENT_CATEGORY,
   c as COMPONENT_LINK_EXPANSION,
-  N as DoctypeFieldSchema,
-  h as FieldsetFieldSchema,
-  _ as GQL_SCALAR_MAP,
-  p as INTERNAL_SCALARS,
-  j as INTROSPECTED_IDENTITY_PROPS,
-  x as LINK_DISPLAY_SUFFIX,
-  P as TableFieldSchema,
-  R as TableViewConfig,
+  p as DoctypeFieldSchema,
+  E as FieldsetFieldSchema,
+  h as GQL_SCALAR_MAP,
+  _ as INTERNAL_SCALARS,
+  P as INTROSPECTED_IDENTITY_PROPS,
+  R as LINK_DISPLAY_SUFFIX,
+  j as TableFieldSchema,
+  x as TableViewConfig,
   B as TriggerDefinition,
-  w as ValueFieldSchema,
-  M as WELL_KNOWN_SCALARS,
+  M as ValueFieldSchema,
+  w as WELL_KNOWN_SCALARS,
   k as WorkflowLayout,
-  G as WorkflowMeta,
-  K as buildScalarMap,
-  V as camelToLabel,
-  W as camelToSnake,
-  Y as classifyFieldType,
-  g as componentCategory,
+  K as WorkflowMeta,
+  G as aggregateDoctypeName,
+  V as buildAggregateDoctype,
+  W as buildScalarMap,
+  Q as camelToLabel,
+  Y as camelToSnake,
+  z as classifyFieldType,
+  S as componentCategory,
   f as componentLinkExpansion,
-  z as convertGraphQLSchema,
-  Q as defaultIsEntityField,
-  q as defaultIsEntityType,
-  J as flattenFields,
-  X as formatDoctypeDrift,
-  H as getDisplayField,
-  U as getPrimaryKeyField,
-  Z as getRecordIdField,
-  $ as getRecordIdentity,
-  I as hasBadgeOptions,
-  ee as isActionAllowedInState,
-  T as isBadgeDescriptor,
+  q as convertGraphQLSchema,
+  J as defaultIsEntityField,
+  X as defaultIsEntityType,
+  H as flattenFields,
+  U as formatDoctypeDrift,
+  Z as getDisplayField,
+  $ as getDoctypeSlug,
+  ee as getPrimaryKeyField,
+  re as getRecordIdField,
+  ae as getRecordIdentity,
+  C as hasBadgeOptions,
+  te as inferFieldKind,
+  ne as isActionAllowedInState,
+  m as isBadgeDescriptor,
   s as isSelectChoiceMap,
-  m as isSelectOptions,
-  re as linkDisplayFieldname,
-  F as lookupBadge,
-  ae as mergeIntrospectedDoctype,
-  te as normalizeFieldKind,
-  ne as parseDoctype,
-  ie as parseField,
-  se as pascalToSnake,
+  D as isSelectOptions,
+  ie as linkDisplayFieldname,
+  T as lookupBadge,
+  se as mergeIntrospectedDoctype,
+  oe as normalizeFieldKind,
+  le as parseDoctype,
+  ce as parseField,
+  de as pascalToSnake,
+  ue as planGeneration,
   v as resolveLinkRenderMode,
-  D as selectChoices,
-  oe as snakeToCamel,
-  le as snakeToLabel,
-  ce as toPascalCase,
-  ue as toSlug,
-  de as validateDoctype,
-  fe as validateField
+  F as selectChoices,
+  fe as snakeToCamel,
+  Ae as snakeToLabel,
+  ye as stripFieldKind,
+  ge as toPascalCase,
+  be as toSlug,
+  Se as validateDoctype,
+  ve as validateField
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/component-meta.ts","../src/badge.ts"],"sourcesContent":["/**\n * Semantic category for a rendering component.\n *\n * `component` is the primary field axis, so the runtime consumers that need to know what a field\n * *means* (atable cell formatting / filter widgets, record-default init) derive it from here. This\n * is the single source of \"what kind of value does this component render\", keyed by the canonical\n * registered component names — each consumer maps the category to its own concern (filter widget,\n * default value, …).\n *\n * @public\n */\nexport type ComponentCategory =\n\t'text' | 'number' | 'boolean' | 'date' | 'datetime' | 'select' | 'code' | 'link' | 'attach' | 'quantity' | 'currency'\n\n/**\n * Canonical component → semantic category. Only the components Stonecrop ships with appear here;\n * custom/unknown component names have no category and consumers fall back to their default.\n * @public\n */\nexport const COMPONENT_CATEGORY: Record<string, ComponentCategory> = {\n\tATextInput: 'text',\n\tATextboxInput: 'text',\n\tANumericInput: 'number',\n\tACheckbox: 'boolean',\n\tADate: 'date',\n\tADatePicker: 'date',\n\tADateSelection: 'date',\n\tADateTime: 'datetime',\n\tADuration: 'text',\n\tADateRange: 'date',\n\tADropdown: 'select',\n\tACodeEditor: 'code',\n\tAFormLink: 'link',\n\tAFileAttach: 'attach',\n\tAQuantityInput: 'quantity',\n\tACurrencyInput: 'currency',\n}\n\n/**\n * Resolve a component's semantic category, or `undefined` for an unknown (custom) component —\n * callers treat that as \"no opinion\" and use their own default.\n * @public\n */\nexport function componentCategory(component?: string): ComponentCategory | undefined {\n\treturn component ? COMPONENT_CATEGORY[component] : undefined\n}\n\n/**\n * Whether a link component expands its target doctype, or renders the link inline.\n *\n * This is the *only* axis the component decides. It deliberately does not choose between an\n * embedded record and an embedded table: `cardinality` states whether the value is a scalar or\n * an array, which is a fact about the data rather than a rendering preference, so a component\n * must not be able to override it (an `AForm` over a `noneOrMany` link would be handed an array\n * it cannot render). Component names encode both axes — `AFormLink`/`ATableLink` are the inline\n * pair, `AForm`/`ATable` the expanding pair — but only the inline/expand half is authoritative.\n *\n * @public\n */\nexport type LinkExpansion = 'inline' | 'expand'\n\n/**\n * Canonical link component → expansion. Only components Stonecrop ships with appear here; an\n * unmapped (custom) component has none, and callers treat that as `expand` — the behaviour that\n * predates this map, so a custom component can never silently collapse a link to a picker.\n * @public\n */\nexport const COMPONENT_LINK_EXPANSION: Record<string, LinkExpansion> = {\n\tAFormLink: 'inline',\n\tAForm: 'expand',\n\tATable: 'expand',\n}\n\n/**\n * Resolve a component's link expansion, or `undefined` for an absent/unmapped component.\n * @public\n */\nexport function componentLinkExpansion(component?: string): LinkExpansion | undefined {\n\treturn component ? COMPONENT_LINK_EXPANSION[component] : undefined\n}\n\n/**\n * How a link field renders.\n *\n * - `inline` — a scalar id-picker; the target is *not* expanded (the field keeps its own value\n *   and carries a `doctype` prop for async display-text resolution and navigation).\n * - `record` — the target doctype is resolved and embedded as a nested form.\n * - `table` — the target doctype is resolved and embedded as a child table.\n *\n * @public\n */\nexport type LinkRenderMode = 'inline' | 'record' | 'table'\n\n/**\n * Decide how a *declared* link (one with a `LinkDeclaration`) renders.\n *\n * Two independent axes: the **component** picks inline vs expand, and when expanding the\n * **cardinality** picks record vs table (many → table). The declaration's component wins over the\n * field's, matching the precedence the resolver already uses for the rendered component.\n *\n * This is the single definition of \"does this link expand\" — it is consumed by both the client\n * resolver (which builds the nested schema) and the server column builder (which must still\n * SELECT an `inline` link's FK column). Call it; never re-derive the rule at the call site, or\n * the two will drift and the client will render a table for a column the server never selected.\n *\n * @param link - the link declaration (only `component` and `cardinality` are consulted)\n * @param fieldComponent - the linked field's own `component`, used when the declaration names none\n * @public\n */\nexport function resolveLinkRenderMode(\n\tlink: { component?: string; cardinality?: string },\n\tfieldComponent?: string\n): LinkRenderMode {\n\tif (componentLinkExpansion(link.component ?? fieldComponent) === 'inline') return 'inline'\n\treturn link.cardinality === 'noneOrMany' || link.cardinality === 'atLeastOne' ? 'table' : 'record'\n}\n\n/**\n * Every component Stonecrop ships with that can render a value field, sorted by name.\n *\n * The union of the two maps above is the definition, not a copy of it: a shipped component either\n * categorises a value ({@link COMPONENT_CATEGORY}) or is one of the link containers that has no\n * value of its own ({@link COMPONENT_LINK_EXPANSION}'s `AForm`/`ATable`). `AFieldset` is absent by\n * the same rule — it is a `kind: 'fieldset'` container, so it is never a value field's component.\n *\n * `component` is an **open** axis: any string is valid, and naming a custom component is how an app\n * renders a field Stonecrop ships no widget for. This list is therefore the set to *suggest* to an\n * author, and to check first-party data against — never a set to validate arbitrary input against.\n *\n * @public\n */\nexport const CANONICAL_COMPONENTS: readonly string[] = [\n\t...new Set([...Object.keys(COMPONENT_CATEGORY), ...Object.keys(COMPONENT_LINK_EXPANSION)]),\n].toSorted()\n","import type { FieldOptions } from './field'\n\n/**\n * Semantic badge variant. Maps to theme tokens `--sc-badge-{variant}-*`.\n * @public\n */\nexport type BadgeVariant = 'neutral' | 'success' | 'warning' | 'danger' | 'brand'\n\n/**\n * Where ABadge paints the same descriptor.\n * @public\n */\nexport type BadgePresentation = 'cell-fill' | 'input-accent'\n\n/**\n * Per-choice badge configuration in a Select options map.\n * @public\n */\nexport interface BadgeSpecObject {\n\tvariant?: BadgeVariant\n\tcolor?: string\n\tlabel?: string\n}\n\n/**\n * Value in a choice→badge map: shorthand variant or object form.\n * @public\n */\nexport type BadgeSpec = BadgeVariant | BadgeSpecObject\n\n/**\n * Select field options when choices carry badge colors.\n * @public\n */\nexport interface SelectOptions extends Record<string, unknown> {\n\tchoices: string[]\n\tbadges?: Record<string, BadgeSpec>\n}\n\n/**\n * Resolved badge for rendering. Returned by `format` or built from an options map.\n * @public\n */\nexport interface BadgeDescriptor {\n\tlabel: string\n\tvariant?: BadgeVariant\n\tcolor?: string\n}\n\nconst BADGE_VARIANTS = new Set<string>(['neutral', 'success', 'warning', 'danger', 'brand'])\n\nconst BADGE_SPEC_OBJECT_KEYS = new Set(['variant', 'color', 'label'])\n\nfunction isOptionsRecord(options: FieldOptions): options is Record<string, unknown> {\n\treturn !Array.isArray(options)\n}\n\nfunction isBadgeVariant(value: unknown): value is BadgeVariant {\n\treturn typeof value === 'string' && BADGE_VARIANTS.has(value)\n}\n\nfunction isBadgeSpecObject(value: unknown): value is BadgeSpecObject {\n\tif (value === null || typeof value !== 'object' || Array.isArray(value)) return false\n\tfor (const key of Object.keys(value)) {\n\t\tif (!BADGE_SPEC_OBJECT_KEYS.has(key)) return false\n\t}\n\tconst obj = value as BadgeSpecObject\n\tif (obj.variant !== undefined && !isBadgeVariant(obj.variant)) return false\n\tif (obj.color !== undefined && typeof obj.color !== 'string') return false\n\tif (obj.label !== undefined && typeof obj.label !== 'string') return false\n\treturn true\n}\n\nfunction isBadgeSpec(value: unknown): value is BadgeSpec {\n\treturn isBadgeVariant(value) || isBadgeSpecObject(value)\n}\n\n/**\n * Narrows an options record to the structured `{ choices, badges }` form. A type predicate rather\n * than a cast: `SelectOptions` requires `choices`, so asserting into it trips `no-unsafe-type-assertion`.\n */\nfunction isStructuredSelectOptions(options: Record<string, unknown>): options is SelectOptions {\n\treturn Array.isArray(options.choices)\n}\n\n/**\n * True when `value` is a resolved badge descriptor for ACell / ADropdown.\n * @public\n */\nexport function isBadgeDescriptor(value: unknown): value is BadgeDescriptor {\n\tif (value === null || typeof value !== 'object' || Array.isArray(value)) return false\n\t// Partial<> keeps this a widening assertion; asserting into BadgeDescriptor itself (required\n\t// `label`) narrows, which `no-unsafe-type-assertion` rejects.\n\tconst obj = value as Partial<BadgeDescriptor>\n\tif (typeof obj.label !== 'string') return false\n\tif (obj.variant !== undefined && !isBadgeVariant(obj.variant)) return false\n\tif (obj.color !== undefined && typeof obj.color !== 'string') return false\n\treturn true\n}\n\n/**\n * True when `options` is a Select choice map (`{ Open: \"warning\", ... }` or\n * `{ choices: [...], badges: {...} }`), not a quantity/currency/code config bag.\n * @public\n */\nexport function isSelectChoiceMap(options: FieldOptions | undefined): options is Record<string, BadgeSpec> {\n\tif (options === undefined || Array.isArray(options) || !isOptionsRecord(options)) return false\n\tif (isStructuredSelectOptions(options)) {\n\t\tconst badges = options.badges\n\t\tif (badges === undefined) return false\n\t\treturn Object.values(badges).every(isBadgeSpec)\n\t}\n\tconst entries = Object.entries(options)\n\tif (entries.length === 0) return false\n\treturn entries.every(([, value]) => isBadgeSpec(value))\n}\n\n/**\n * True when `options` uses the structured SelectOptions shape.\n * @public\n */\nexport function isSelectOptions(options: FieldOptions | undefined): options is SelectOptions {\n\tif (options === undefined || Array.isArray(options) || !isOptionsRecord(options)) return false\n\treturn isStructuredSelectOptions(options)\n}\n\n/**\n * Dropdown / filter choice strings.\n * @public\n */\nexport function selectChoices(options: FieldOptions | undefined): string[] {\n\tif (options === undefined) return []\n\tif (Array.isArray(options)) return options\n\tif (!isOptionsRecord(options)) return []\n\tif (isStructuredSelectOptions(options)) return options.choices\n\tif (isSelectChoiceMap(options)) return Object.keys(options)\n\treturn []\n}\n\nfunction normalizeBadgeSpec(spec: unknown, key: string): BadgeDescriptor {\n\tif (isBadgeVariant(spec)) {\n\t\treturn { label: key, variant: spec }\n\t}\n\t// A malformed spec still names a real choice, so keep the label and drop only the styling.\n\t// Reading `.variant`/`.color` off an unvalidated value is what let a misspelt variant reach the\n\t// DOM as an unmatched class, and threw outright on null.\n\tif (!isBadgeSpecObject(spec)) {\n\t\treturn { label: key }\n\t}\n\treturn {\n\t\tlabel: spec.label ?? key,\n\t\tvariant: spec.variant,\n\t\tcolor: spec.color,\n\t}\n}\n\nfunction lookupFromBareMap(map: Record<string, BadgeSpec>, key: string | undefined): BadgeDescriptor | undefined {\n\tif (key === undefined || key === '') return undefined\n\tif (!(key in map)) return undefined\n\treturn normalizeBadgeSpec(map[key], key)\n}\n\nfunction lookupFromStructured(options: SelectOptions, key: string | undefined): BadgeDescriptor | undefined {\n\tif (key === undefined || key === '') return undefined\n\tconst badges = options.badges\n\tif (!badges || !(key in badges)) return undefined\n\treturn normalizeBadgeSpec(badges[key], key)\n}\n\n/**\n * Resolve a stored choice value to a badge descriptor using field options.\n * @public\n */\nexport function lookupBadge(options: FieldOptions | undefined, key: string | undefined): BadgeDescriptor | undefined {\n\tif (options === undefined || key === undefined || key === '') return undefined\n\tif (Array.isArray(options)) return undefined\n\tif (!isOptionsRecord(options)) return undefined\n\tif (isStructuredSelectOptions(options)) return lookupFromStructured(options, key)\n\tif (isSelectChoiceMap(options)) return lookupFromBareMap(options, key)\n\treturn undefined\n}\n\n/**\n * Whether field options carry any badge mapping.\n * @public\n */\nexport function hasBadgeOptions(options: FieldOptions | undefined): boolean {\n\tif (options === undefined || Array.isArray(options)) return false\n\tif (!isOptionsRecord(options)) return false\n\tif (isStructuredSelectOptions(options)) return options.badges !== undefined && Object.keys(options.badges).length > 0\n\treturn isSelectChoiceMap(options)\n}\n"],"names":["COMPONENT_CATEGORY","componentCategory","component","COMPONENT_LINK_EXPANSION","componentLinkExpansion","resolveLinkRenderMode","link","fieldComponent","CANONICAL_COMPONENTS","BADGE_VARIANTS","BADGE_SPEC_OBJECT_KEYS","isOptionsRecord","options","isBadgeVariant","value","isBadgeSpecObject","key","obj","isBadgeSpec","isStructuredSelectOptions","isBadgeDescriptor","isSelectChoiceMap","badges","entries","isSelectOptions","selectChoices","normalizeBadgeSpec","spec","lookupFromBareMap","map","lookupFromStructured","lookupBadge","hasBadgeOptions"],"mappings":";AAmBO,MAAMA,IAAwD;AAAA,EACpE,YAAY;AAAA,EACZ,eAAe;AAAA,EACf,eAAe;AAAA,EACf,WAAW;AAAA,EACX,OAAO;AAAA,EACP,aAAa;AAAA,EACb,gBAAgB;AAAA,EAChB,WAAW;AAAA,EACX,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,WAAW;AAAA,EACX,aAAa;AAAA,EACb,WAAW;AAAA,EACX,aAAa;AAAA,EACb,gBAAgB;AAAA,EAChB,gBAAgB;AACjB;AAOO,SAASC,EAAkBC,GAAmD;AACpF,SAAOA,IAAYF,EAAmBE,CAAS,IAAI;AACpD;AAsBO,MAAMC,IAA0D;AAAA,EACtE,WAAW;AAAA,EACX,OAAO;AAAA,EACP,QAAQ;AACT;AAMO,SAASC,EAAuBF,GAA+C;AACrF,SAAOA,IAAYC,EAAyBD,CAAS,IAAI;AAC1D;AA8BO,SAASG,EACfC,GACAC,GACiB;AACjB,SAAIH,EAAuBE,EAAK,aAAaC,CAAc,MAAM,WAAiB,WAC3ED,EAAK,gBAAgB,gBAAgBA,EAAK,gBAAgB,eAAe,UAAU;AAC3F;AAgBO,MAAME,IAA0C;AAAA,EACtD,GAAG,oBAAI,IAAI,CAAC,GAAG,OAAO,KAAKR,CAAkB,GAAG,GAAG,OAAO,KAAKG,CAAwB,CAAC,CAAC;AAC1F,EAAE,SAAA,GCpFIM,wBAAqB,IAAY,CAAC,WAAW,WAAW,WAAW,UAAU,OAAO,CAAC,GAErFC,IAAyB,oBAAI,IAAI,CAAC,WAAW,SAAS,OAAO,CAAC;AAEpE,SAASC,EAAgBC,GAA2D;AACnF,SAAO,CAAC,MAAM,QAAQA,CAAO;AAC9B;AAEA,SAASC,EAAeC,GAAuC;AAC9D,SAAO,OAAOA,KAAU,YAAYL,EAAe,IAAIK,CAAK;AAC7D;AAEA,SAASC,EAAkBD,GAA0C;AACpE,MAAIA,MAAU,QAAQ,OAAOA,KAAU,YAAY,MAAM,QAAQA,CAAK,EAAG,QAAO;AAChF,aAAWE,KAAO,OAAO,KAAKF,CAAK;AAClC,QAAI,CAACJ,EAAuB,IAAIM,CAAG,EAAG,QAAO;AAE9C,QAAMC,IAAMH;AAGZ,SAFI,EAAAG,EAAI,YAAY,UAAa,CAACJ,EAAeI,EAAI,OAAO,KACxDA,EAAI,UAAU,UAAa,OAAOA,EAAI,SAAU,YAChDA,EAAI,UAAU,UAAa,OAAOA,EAAI,SAAU;AAErD;AAEA,SAASC,EAAYJ,GAAoC;AACxD,SAAOD,EAAeC,CAAK,KAAKC,EAAkBD,CAAK;AACxD;AAMA,SAASK,EAA0BP,GAA4D;AAC9F,SAAO,MAAM,QAAQA,EAAQ,OAAO;AACrC;AAMO,SAASQ,EAAkBN,GAA0C;AAC3E,MAAIA,MAAU,QAAQ,OAAOA,KAAU,YAAY,MAAM,QAAQA,CAAK,EAAG,QAAO;AAGhF,QAAMG,IAAMH;AAGZ,SAFI,SAAOG,EAAI,SAAU,YACrBA,EAAI,YAAY,UAAa,CAACJ,EAAeI,EAAI,OAAO,KACxDA,EAAI,UAAU,UAAa,OAAOA,EAAI,SAAU;AAErD;AAOO,SAASI,EAAkBT,GAAyE;AAC1G,MAAIA,MAAY,UAAa,MAAM,QAAQA,CAAO,KAAK,CAACD,EAAgBC,CAAO,EAAG,QAAO;AACzF,MAAIO,EAA0BP,CAAO,GAAG;AACvC,UAAMU,IAASV,EAAQ;AACvB,WAAIU,MAAW,SAAkB,KAC1B,OAAO,OAAOA,CAAM,EAAE,MAAMJ,CAAW;AAAA,EAC/C;AACA,QAAMK,IAAU,OAAO,QAAQX,CAAO;AACtC,SAAIW,EAAQ,WAAW,IAAU,KAC1BA,EAAQ,MAAM,CAAC,CAAA,EAAGT,CAAK,MAAMI,EAAYJ,CAAK,CAAC;AACvD;AAMO,SAASU,EAAgBZ,GAA6D;AAC5F,SAAIA,MAAY,UAAa,MAAM,QAAQA,CAAO,KAAK,CAACD,EAAgBC,CAAO,IAAU,KAClFO,EAA0BP,CAAO;AACzC;AAMO,SAASa,EAAcb,GAA6C;AAC1E,SAAIA,MAAY,SAAkB,CAAA,IAC9B,MAAM,QAAQA,CAAO,IAAUA,IAC9BD,EAAgBC,CAAO,IACxBO,EAA0BP,CAAO,IAAUA,EAAQ,UACnDS,EAAkBT,CAAO,IAAU,OAAO,KAAKA,CAAO,IACnD,CAAA,IAH+B,CAAA;AAIvC;AAEA,SAASc,EAAmBC,GAAeX,GAA8B;AACxE,SAAIH,EAAec,CAAI,IACf,EAAE,OAAOX,GAAK,SAASW,EAAA,IAK1BZ,EAAkBY,CAAI,IAGpB;AAAA,IACN,OAAOA,EAAK,SAASX;AAAA,IACrB,SAASW,EAAK;AAAA,IACd,OAAOA,EAAK;AAAA,EAAA,IALL,EAAE,OAAOX,EAAA;AAOlB;AAEA,SAASY,EAAkBC,GAAgCb,GAAsD;AAChH,MAAI,EAAAA,MAAQ,UAAaA,MAAQ,OAC3BA,KAAOa;AACb,WAAOH,EAAmBG,EAAIb,CAAG,GAAGA,CAAG;AACxC;AAEA,SAASc,EAAqBlB,GAAwBI,GAAsD;AAC3G,MAAIA,MAAQ,UAAaA,MAAQ,GAAI;AACrC,QAAMM,IAASV,EAAQ;AACvB,MAAI,GAACU,KAAU,EAAEN,KAAOM;AACxB,WAAOI,EAAmBJ,EAAON,CAAG,GAAGA,CAAG;AAC3C;AAMO,SAASe,EAAYnB,GAAmCI,GAAsD;AACpH,MAAI,EAAAJ,MAAY,UAAaI,MAAQ,UAAaA,MAAQ,OACtD,OAAM,QAAQJ,CAAO,KACpBD,EAAgBC,CAAO,GAC5B;AAAA,QAAIO,EAA0BP,CAAO,EAAG,QAAOkB,EAAqBlB,GAASI,CAAG;AAChF,QAAIK,EAAkBT,CAAO,EAAG,QAAOgB,EAAkBhB,GAASI,CAAG;AAAA;AAEtE;AAMO,SAASgB,EAAgBpB,GAA4C;AAE3E,SADIA,MAAY,UAAa,MAAM,QAAQA,CAAO,KAC9C,CAACD,EAAgBC,CAAO,IAAU,KAClCO,EAA0BP,CAAO,IAAUA,EAAQ,WAAW,UAAa,OAAO,KAAKA,EAAQ,MAAM,EAAE,SAAS,IAC7GS,EAAkBT,CAAO;AACjC;"}
+{"version":3,"file":"index.js","sources":["../src/component-meta.ts","../src/badge.ts"],"sourcesContent":["/**\n * Semantic category for a rendering component.\n *\n * `component` is the primary field axis, so the runtime consumers that need to know what a field\n * *means* (atable cell formatting / filter widgets, record-default init) derive it from here. This\n * is the single source of \"what kind of value does this component render\", keyed by the canonical\n * registered component names — each consumer maps the category to its own concern (filter widget,\n * default value, …).\n *\n * @public\n */\nexport type ComponentCategory =\n\t'text' | 'number' | 'boolean' | 'date' | 'datetime' | 'select' | 'code' | 'link' | 'attach' | 'quantity' | 'currency'\n\n/**\n * Canonical component → semantic category. Only the components Stonecrop ships with appear here;\n * custom/unknown component names have no category and consumers fall back to their default.\n * @public\n */\nexport const COMPONENT_CATEGORY: Record<string, ComponentCategory> = {\n\tATextInput: 'text',\n\tATextboxInput: 'text',\n\tANumericInput: 'number',\n\tACheckbox: 'boolean',\n\tADate: 'date',\n\tADatePicker: 'date',\n\tADateSelection: 'date',\n\tADateTime: 'datetime',\n\tADuration: 'text',\n\tADateRange: 'date',\n\tADropdown: 'select',\n\tASegmentedControl: 'select',\n\tACodeEditor: 'code',\n\tAFormLink: 'link',\n\tAFileAttach: 'attach',\n\tAQuantityInput: 'quantity',\n\tACurrencyInput: 'currency',\n}\n\n/**\n * Resolve a component's semantic category, or `undefined` for an unknown (custom) component —\n * callers treat that as \"no opinion\" and use their own default.\n * @public\n */\nexport function componentCategory(component?: string): ComponentCategory | undefined {\n\treturn component ? COMPONENT_CATEGORY[component] : undefined\n}\n\n/**\n * Whether a link component expands its target doctype, or renders the link inline.\n *\n * This is the *only* axis the component decides. It deliberately does not choose between an\n * embedded record and an embedded table: `cardinality` states whether the value is a scalar or\n * an array, which is a fact about the data rather than a rendering preference, so a component\n * must not be able to override it (an `AForm` over a `noneOrMany` link would be handed an array\n * it cannot render). Component names encode both axes — `AFormLink`/`ATableLink` are the inline\n * pair, `AForm`/`ATable` the expanding pair — but only the inline/expand half is authoritative.\n *\n * @public\n */\nexport type LinkExpansion = 'inline' | 'expand'\n\n/**\n * Canonical link component → expansion. Only components Stonecrop ships with appear here; an\n * unmapped (custom) component has none, and callers treat that as `expand` — the behaviour that\n * predates this map, so a custom component can never silently collapse a link to a picker.\n * @public\n */\nexport const COMPONENT_LINK_EXPANSION: Record<string, LinkExpansion> = {\n\tAFormLink: 'inline',\n\tAForm: 'expand',\n\tATable: 'expand',\n}\n\n/**\n * Resolve a component's link expansion, or `undefined` for an absent/unmapped component.\n * @public\n */\nexport function componentLinkExpansion(component?: string): LinkExpansion | undefined {\n\treturn component ? COMPONENT_LINK_EXPANSION[component] : undefined\n}\n\n/**\n * How a link field renders.\n *\n * - `inline` — a scalar id-picker; the target is *not* expanded (the field keeps its own value\n *   and carries a `doctype` prop for async display-text resolution and navigation).\n * - `record` — the target doctype is resolved and embedded as a nested form.\n * - `table` — the target doctype is resolved and embedded as a child table.\n *\n * @public\n */\nexport type LinkRenderMode = 'inline' | 'record' | 'table'\n\n/**\n * Decide how a *declared* link (one with a `LinkDeclaration`) renders.\n *\n * Two independent axes: the **component** picks inline vs expand, and when expanding the\n * **cardinality** picks record vs table (many → table). The declaration's component wins over the\n * field's, matching the precedence the resolver already uses for the rendered component.\n *\n * This is the single definition of \"does this link expand\" — it is consumed by both the client\n * resolver (which builds the nested schema) and the server column builder (which must still\n * SELECT an `inline` link's FK column). Call it; never re-derive the rule at the call site, or\n * the two will drift and the client will render a table for a column the server never selected.\n *\n * @param link - the link declaration (only `component` and `cardinality` are consulted)\n * @param fieldComponent - the linked field's own `component`, used when the declaration names none\n * @public\n */\nexport function resolveLinkRenderMode(\n\tlink: { component?: string; cardinality?: string },\n\tfieldComponent?: string\n): LinkRenderMode {\n\tif (componentLinkExpansion(link.component ?? fieldComponent) === 'inline') return 'inline'\n\treturn link.cardinality === 'noneOrMany' || link.cardinality === 'atLeastOne' ? 'table' : 'record'\n}\n\n/**\n * Every component Stonecrop ships with that can render a value field, sorted by name.\n *\n * The union of the two maps above is the definition, not a copy of it: a shipped component either\n * categorises a value ({@link COMPONENT_CATEGORY}) or is one of the link containers that has no\n * value of its own ({@link COMPONENT_LINK_EXPANSION}'s `AForm`/`ATable`). `AFieldset` is absent by\n * the same rule — it is a `kind: 'fieldset'` container, so it is never a value field's component.\n *\n * `component` is an **open** axis: any string is valid, and naming a custom component is how an app\n * renders a field Stonecrop ships no widget for. This list is therefore the set to *suggest* to an\n * author, and to check first-party data against — never a set to validate arbitrary input against.\n *\n * @public\n */\nexport const CANONICAL_COMPONENTS: readonly string[] = [\n\t...new Set([...Object.keys(COMPONENT_CATEGORY), ...Object.keys(COMPONENT_LINK_EXPANSION)]),\n].toSorted()\n","import type { FieldOptions } from './field'\n\n/**\n * Semantic badge variant. Maps to theme tokens `--sc-badge-{variant}-*`.\n * @public\n */\nexport type BadgeVariant = 'neutral' | 'success' | 'warning' | 'danger' | 'brand'\n\n/**\n * Where ABadge paints the same descriptor.\n * @public\n */\nexport type BadgePresentation = 'cell-fill' | 'input-accent'\n\n/**\n * Per-choice badge configuration in a Select options map.\n * @public\n */\nexport interface BadgeSpecObject {\n\tvariant?: BadgeVariant\n\tcolor?: string\n\tlabel?: string\n}\n\n/**\n * Value in a choice→badge map: shorthand variant or object form.\n * @public\n */\nexport type BadgeSpec = BadgeVariant | BadgeSpecObject\n\n/**\n * Select field options when choices carry badge colors.\n * @public\n */\nexport interface SelectOptions extends Record<string, unknown> {\n\tchoices: string[]\n\tbadges?: Record<string, BadgeSpec>\n}\n\n/**\n * Resolved badge for rendering. Returned by `format` or built from an options map.\n * @public\n */\nexport interface BadgeDescriptor {\n\tlabel: string\n\tvariant?: BadgeVariant\n\tcolor?: string\n}\n\nconst BADGE_VARIANTS = new Set<string>(['neutral', 'success', 'warning', 'danger', 'brand'])\n\nconst BADGE_SPEC_OBJECT_KEYS = new Set(['variant', 'color', 'label'])\n\nfunction isOptionsRecord(options: FieldOptions): options is Record<string, unknown> {\n\treturn !Array.isArray(options)\n}\n\nfunction isBadgeVariant(value: unknown): value is BadgeVariant {\n\treturn typeof value === 'string' && BADGE_VARIANTS.has(value)\n}\n\nfunction isBadgeSpecObject(value: unknown): value is BadgeSpecObject {\n\tif (value === null || typeof value !== 'object' || Array.isArray(value)) return false\n\tfor (const key of Object.keys(value)) {\n\t\tif (!BADGE_SPEC_OBJECT_KEYS.has(key)) return false\n\t}\n\tconst obj = value as BadgeSpecObject\n\tif (obj.variant !== undefined && !isBadgeVariant(obj.variant)) return false\n\tif (obj.color !== undefined && typeof obj.color !== 'string') return false\n\tif (obj.label !== undefined && typeof obj.label !== 'string') return false\n\treturn true\n}\n\nfunction isBadgeSpec(value: unknown): value is BadgeSpec {\n\treturn isBadgeVariant(value) || isBadgeSpecObject(value)\n}\n\n/**\n * Narrows an options record to the structured `{ choices, badges }` form. A type predicate rather\n * than a cast: `SelectOptions` requires `choices`, so asserting into it trips `no-unsafe-type-assertion`.\n */\nfunction isStructuredSelectOptions(options: Record<string, unknown>): options is SelectOptions {\n\treturn Array.isArray(options.choices)\n}\n\n/**\n * True when `value` is a resolved badge descriptor for ACell / ADropdown.\n * @public\n */\nexport function isBadgeDescriptor(value: unknown): value is BadgeDescriptor {\n\tif (value === null || typeof value !== 'object' || Array.isArray(value)) return false\n\t// Partial<> keeps this a widening assertion; asserting into BadgeDescriptor itself (required\n\t// `label`) narrows, which `no-unsafe-type-assertion` rejects.\n\tconst obj = value as Partial<BadgeDescriptor>\n\tif (typeof obj.label !== 'string') return false\n\tif (obj.variant !== undefined && !isBadgeVariant(obj.variant)) return false\n\tif (obj.color !== undefined && typeof obj.color !== 'string') return false\n\treturn true\n}\n\n/**\n * True when `options` is a Select choice map (`{ Open: \"warning\", ... }` or\n * `{ choices: [...], badges: {...} }`), not a quantity/currency/code config bag.\n * @public\n */\nexport function isSelectChoiceMap(options: FieldOptions | undefined): options is Record<string, BadgeSpec> {\n\tif (options === undefined || Array.isArray(options) || !isOptionsRecord(options)) return false\n\tif (isStructuredSelectOptions(options)) {\n\t\tconst badges = options.badges\n\t\tif (badges === undefined) return false\n\t\treturn Object.values(badges).every(isBadgeSpec)\n\t}\n\tconst entries = Object.entries(options)\n\tif (entries.length === 0) return false\n\treturn entries.every(([, value]) => isBadgeSpec(value))\n}\n\n/**\n * True when `options` uses the structured SelectOptions shape.\n * @public\n */\nexport function isSelectOptions(options: FieldOptions | undefined): options is SelectOptions {\n\tif (options === undefined || Array.isArray(options) || !isOptionsRecord(options)) return false\n\treturn isStructuredSelectOptions(options)\n}\n\n/**\n * Dropdown / filter choice strings.\n * @public\n */\nexport function selectChoices(options: FieldOptions | undefined): string[] {\n\tif (options === undefined) return []\n\tif (Array.isArray(options)) return options\n\tif (!isOptionsRecord(options)) return []\n\tif (isStructuredSelectOptions(options)) return options.choices\n\tif (isSelectChoiceMap(options)) return Object.keys(options)\n\treturn []\n}\n\nfunction normalizeBadgeSpec(spec: unknown, key: string): BadgeDescriptor {\n\tif (isBadgeVariant(spec)) {\n\t\treturn { label: key, variant: spec }\n\t}\n\t// A malformed spec still names a real choice, so keep the label and drop only the styling.\n\t// Reading `.variant`/`.color` off an unvalidated value is what let a misspelt variant reach the\n\t// DOM as an unmatched class, and threw outright on null.\n\tif (!isBadgeSpecObject(spec)) {\n\t\treturn { label: key }\n\t}\n\treturn {\n\t\tlabel: spec.label ?? key,\n\t\tvariant: spec.variant,\n\t\tcolor: spec.color,\n\t}\n}\n\nfunction lookupFromBareMap(map: Record<string, BadgeSpec>, key: string | undefined): BadgeDescriptor | undefined {\n\tif (key === undefined || key === '') return undefined\n\tif (!(key in map)) return undefined\n\treturn normalizeBadgeSpec(map[key], key)\n}\n\nfunction lookupFromStructured(options: SelectOptions, key: string | undefined): BadgeDescriptor | undefined {\n\tif (key === undefined || key === '') return undefined\n\tconst badges = options.badges\n\tif (!badges || !(key in badges)) return undefined\n\treturn normalizeBadgeSpec(badges[key], key)\n}\n\n/**\n * Resolve a stored choice value to a badge descriptor using field options.\n * @public\n */\nexport function lookupBadge(options: FieldOptions | undefined, key: string | undefined): BadgeDescriptor | undefined {\n\tif (options === undefined || key === undefined || key === '') return undefined\n\tif (Array.isArray(options)) return undefined\n\tif (!isOptionsRecord(options)) return undefined\n\tif (isStructuredSelectOptions(options)) return lookupFromStructured(options, key)\n\tif (isSelectChoiceMap(options)) return lookupFromBareMap(options, key)\n\treturn undefined\n}\n\n/**\n * Whether field options carry any badge mapping.\n * @public\n */\nexport function hasBadgeOptions(options: FieldOptions | undefined): boolean {\n\tif (options === undefined || Array.isArray(options)) return false\n\tif (!isOptionsRecord(options)) return false\n\tif (isStructuredSelectOptions(options)) return options.badges !== undefined && Object.keys(options.badges).length > 0\n\treturn isSelectChoiceMap(options)\n}\n"],"names":["COMPONENT_CATEGORY","componentCategory","component","COMPONENT_LINK_EXPANSION","componentLinkExpansion","resolveLinkRenderMode","link","fieldComponent","CANONICAL_COMPONENTS","BADGE_VARIANTS","BADGE_SPEC_OBJECT_KEYS","isOptionsRecord","options","isBadgeVariant","value","isBadgeSpecObject","key","obj","isBadgeSpec","isStructuredSelectOptions","isBadgeDescriptor","isSelectChoiceMap","badges","entries","isSelectOptions","selectChoices","normalizeBadgeSpec","spec","lookupFromBareMap","map","lookupFromStructured","lookupBadge","hasBadgeOptions"],"mappings":"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"}