@golemui/schemas 1.2.1

package/README.md

@@ -0,0 +1,135 @@
+# @golemui/schemas
+
+Base JSON schema resources shared by every GolemUI widget set implementation, plus the pure
+builder functions that generate an implementation's aggregate schema files from its widget
+manifest.
+
+## Install
+
+```bash
+npm install @golemui/schemas
+```
+
+## Contents
+
+```text
+schemas/
+  core/common.schema.json        shared structural $defs (baseWidget, localizable, chunkRef, ...)
+index.js / index.cjs             the JavaScript entry point
+generator.js / generator.cjs     the file-writing generator, `@golemui/schemas/generator`
+cli.js                           the `golemui-schemas` command
+index.d.ts, lib/*.d.ts           type declarations
+```
+
+Core publishes exactly one `$defs` resource: `common.schema.json`. Validation vocabulary is
+implementation-owned, not core contract. Each implementation publishes its own validators
+schema exposing a `#/$defs/validator` entry pointer (the gui set lives at
+`schemas/gui/validators.schema.json` in the published tree).
+
+## Entry point
+
+The entry point exports the core schema as an object, the builder functions
+(`buildWidgetsSchema`, `buildFormEnvelope`, `buildLayoutWidgetSchema`,
+`buildSchemasPackageIndex`, `buildEditorBundle`), and their types
+(`ImplementationSchemaConfig`, `WidgetManifestEntry`, `WidgetKind`, `SchemaObject`). The raw
+file is also reachable as `@golemui/schemas/schemas/core/common.schema.json`.
+
+```ts
+import Ajv2020 from 'ajv/dist/2020';
+import { buildWidgetsSchema, commonSchema } from '@golemui/schemas';
+
+const ajv = new Ajv2020();
+ajv.addSchema(commonSchema);
+
+const widgets = buildWidgetsSchema({
+  implementation: 'gui',
+  idBase: 'https://golemui.com/schemas/gui/',
+  generatorPath: 'libs/gui/schemas/tools/generate-schemas.ts',
+  formTitle: 'Golem Form DSL',
+  statesDescription: 'Named boolean conditions keyed by state name.',
+  manifest: [{ type: 'textinput', schemaFile: 'textinput.schema.json', kind: 'input' }],
+  libRootSchemaFiles: ['validators.schema.json'],
+  includeSchemalessTypesInKnownWidgetTypes: true,
+  includeCustomWidgetFallback: true,
+});
+```
+
+## The published site tree
+
+The site tree at `https://golemui.com/schemas/` is meant to layer this core resource with one
+directory per implementation:
+
+```text
+schemas/
+  core/                          from this package
+  form.schema.json               legacy alias, from this repository (not from npm)
+  gui/                           from @golemui/gui-schemas (generated aggregates, gui-owned
+                                 validators and ranges defs, vendored core/)
+```
+
+That tree is not published yet. Only the original `/schemas/form.schema.json` monolith is
+live today, and no job in this repository assembles or deploys the rest, so the `$id` values
+in these packages are identifiers rather than URLs that resolve.
+
+## The legacy alias
+
+`site/form.schema.json` is a three-line schema whose only content is
+`"$ref": "./gui/form.schema.json"`. It keeps the original schema URL
+`https://golemui.com/schemas/form.schema.json` working once the site tree exists, where the
+`gui/` directory sits next to it.
+
+It is a website build input and is deliberately not shipped to npm: inside a package the ref
+resolves to nothing, so every way of loading it throws `MissingRefError`. That is also why it
+lives outside `src/`, and why the entry point does not export it.
+
+Publishing it is one atomic step with the `gui/` tree. Serving the alias while
+`/schemas/gui/form.schema.json` is still missing breaks the one schema URL that works today,
+which the MCP writes into the `$schema` line of every form definition it generates. A
+post-deploy check should fetch `/schemas/form.schema.json`, follow its `$ref`, and assert that
+both respond with `application/json`.
+
+## Generating an implementation tree
+
+An implementation declares a widget manifest (`WidgetManifestEntry[]`) and an
+`ImplementationSchemaConfig`, then calls `generateImplementationSchemas` from
+`@golemui/schemas/generator` to produce its `widgets.schema.json` (widget union plus
+`knownWidgetTypes` enum), its `form.schema.json` envelope, its `layout-widget.schema.json`,
+its vendored copy of `schemas/core/`, and its package index source. Set
+`emitEditorBundle: true` to also get `form.editor.schema.json` (see below). The gui
+implementation's entry point is `libs/gui/schemas/tools/generate-schemas.ts`, run with
+`npm run generate:schemas`.
+
+Generated files are prettier-formatted when prettier and a prettier config are both
+resolvable, and plainly indented otherwise. Prettier is an optional peer dependency.
+
+## Scaffolding a new implementation
+
+The `golemui-schemas` command scaffolds and regenerates a schema tree, so an implementation
+needs no generator script of its own:
+
+```bash
+npx @golemui/schemas init --name kendo --id-base https://example.com/schemas/kendo/
+npx @golemui/schemas generate
+```
+
+`init` writes `schemas.config.mjs` (the manifest and config), a starter validators schema, a
+starter `flex` and example input component schema, an example form and a test skeleton, then
+runs `generate`. Run it with no flags for prompts.
+
+`schemas.config.mjs` and the component schemas are the implementer's to edit. Everything
+else, including the vendored core, is rewritten by `generate` from the installed
+`@golemui/schemas`, so updating core means bumping the dependency and rerunning it. A CI step
+that runs `generate` and then `git diff --exit-code` catches a stale tree.
+
+## Two entry points: Ajv and editors
+
+Ajv registers the per-file tree by `$id`, and resolution works because every file is added up
+front. An editor instead resolves each relative `$ref` against the file's absolute `$id`,
+computes a URL and tries to download it, which fails offline, in untrusted workspaces and
+wherever the `idBase` is not hosted. `form.editor.schema.json` is the same tree inlined into
+one self-contained document with no `$id`s: point a form file's `$schema` at it.
+
+Editing workflow for the core file: change it here, then run `npm run generate:schemas`
+so every vendored copy is regenerated. A vendored copy is identical to its source apart from
+an `$id` rebased onto the implementation's own tree, which is what lets that tree be loaded by
+`$id` alone. A drift test enforces this, and CI fails when generated files are stale.

package/cli.cjs

@@ -0,0 +1,134 @@
+#!/usr/bin/env node
+"use strict";const p=require("node:fs"),i=require("node:path"),g=require("node:readline/promises"),b=require("node:url"),v=require("./generate-implementation-schemas-D57DzM2J.cjs"),w="../src/lib/form.editor.schema.json",x=[{kind:"layout",type:"flex",uid:"#root",props:{direction:"column",gap:16},children:[{kind:"input",type:"__IMPLEMENTATION__-input",uid:"email",path:"email",label:"Email address",validator:{type:"string",required:!0,format:"email"},props:{placeholder:"you@example.com"}}]}],j={$schema:w,form:x},S="https://json-schema.org/draft/2020-12/schema",P="__ID_BASE__components/example-input.schema.json",T="STARTER TEMPLATE, owned by you. One component schema per widget type. Copy this file for each widget, then list it in schemas.config.mjs. The pattern to keep: allOf the baseWidget, `kind` and `type` consts, one `$defs` entry per prop, a `.state` suffixed pattern for every suffixable key, `additionalProperties: false` inside `props`, and `unevaluatedProperties: false` at the root.",E="__IMPLEMENTATION__ example input widget",_="object",I={labelDef:{$ref:"../core/common.schema.json#/$defs/localizable"},disabledDef:{$ref:"../core/common.schema.json#/$defs/boolOrWhen"},readonlyDef:{$ref:"../core/common.schema.json#/$defs/boolOrWhen"},hintProp:{type:"string"},placeholderProp:{type:"string"},maxlengthProp:{type:"number"}},q=[{$ref:"../core/common.schema.json#/$defs/baseWidget"}],A={kind:{const:"input"},type:{const:"__IMPLEMENTATION__-input"},path:{$ref:"../core/common.schema.json#/$defs/dotPath"},label:{$ref:"#/$defs/labelDef"},disabled:{$ref:"#/$defs/disabledDef"},readonly:{$ref:"#/$defs/readonlyDef"},on:{$ref:"../core/common.schema.json#/$defs/on"},validator:{$ref:"../validators.schema.json#/$defs/validator"},defaultValue:{type:"string"},props:{type:"object",properties:{hint:{$ref:"#/$defs/hintProp"},placeholder:{$ref:"#/$defs/placeholderProp"},maxlength:{$ref:"#/$defs/maxlengthProp"}},patternProperties:{"^hint\\.[^.]+$":{$ref:"#/$defs/hintProp"},"^placeholder\\.[^.]+$":{$ref:"#/$defs/placeholderProp"},"^maxlength\\.[^.]+$":{$ref:"#/$defs/maxlengthProp"}},additionalProperties:!1}},O={"^label\\.[^.]+$":{$ref:"#/$defs/labelDef"},"^disabled\\.[^.]+$":{$ref:"#/$defs/disabledDef"},"^readonly\\.[^.]+$":{$ref:"#/$defs/readonlyDef"},"^validator\\.[^.]+$":{$ref:"../validators.schema.json#/$defs/validator"}},M=["kind","type","path"],L=!1,N={$schema:S,$id:P,$comment:T,title:E,type:_,$defs:I,allOf:q,properties:A,patternProperties:O,required:M,unevaluatedProperties:L},k="https://json-schema.org/draft/2020-12/schema",z="__ID_BASE__components/flex.schema.json",R="STARTER TEMPLATE, owned by you. `flex` is a reserved widget type: keep the name and the `children` array, change the props to match your layout widget.",C="__IMPLEMENTATION__ flex widget",D="object",W={directionProp:{enum:["row","row-reverse","column","column-reverse"]},justifyProp:{enum:["start","center","end","stretch","space-between","space-around"]},alignProp:{enum:["start","center","end","stretch","baseline"]},wrapProp:{type:"boolean"},gapProp:{type:"number"},paddingProp:{type:"number"}},F=[{$ref:"../core/common.schema.json#/$defs/baseWidget"}],B={kind:{const:"layout"},type:{const:"flex"},children:{type:"array",minItems:1,items:{$ref:"../widgets.schema.json#/$defs/formWidget"}},props:{type:"object",properties:{direction:{$ref:"#/$defs/directionProp"},justify:{$ref:"#/$defs/justifyProp"},align:{$ref:"#/$defs/alignProp"},wrap:{$ref:"#/$defs/wrapProp"},gap:{$ref:"#/$defs/gapProp"},padding:{$ref:"#/$defs/paddingProp"}},patternProperties:{"^direction\\.[^.]+$":{$ref:"#/$defs/directionProp"},"^justify\\.[^.]+$":{$ref:"#/$defs/justifyProp"},"^align\\.[^.]+$":{$ref:"#/$defs/alignProp"},"^wrap\\.[^.]+$":{$ref:"#/$defs/wrapProp"},"^gap\\.[^.]+$":{$ref:"#/$defs/gapProp"},"^padding\\.[^.]+$":{$ref:"#/$defs/paddingProp"}},additionalProperties:!1}},V=["kind","type","children"],U=!1,J={$schema:k,$id:z,$comment:R,title:C,type:D,$defs:W,allOf:F,properties:B,required:V,unevaluatedProperties:U},Y="https://json-schema.org/draft/2020-12/schema",G="__ID_BASE__validators.schema.json",H="STARTER TEMPLATE, owned by you. Edit it freely. The only contract is that it exposes #/$defs/validator, which every component schema references. Copied from the golemui gui validators when the tree was scaffolded, it does not track them afterwards.",K="__IMPLEMENTATION__ validator definitions",Z={localizable:{$ref:"./core/common.schema.json#/$defs/localizable"},stringValidator:{type:"object",properties:{type:{const:"string"},required:{type:"boolean",description:"Makes the field mandatory - validation fails if the value is empty or absent"},minLength:{type:"number",description:"Minimum number of characters the string must contain"},maxLength:{type:"number",description:"Maximum number of characters the string may contain"},pattern:{type:"string",description:"A regular expression pattern the value must match"},format:{type:"string",description:"A named format the string must conform to (e.g. `email`, `url`, `date`, `uuid`)",enum:["email","hostname","ipv4","ipv6","url","uuid","date","time","date-time","duration"]},const:{description:"The string must equal exactly this value"},enum:{type:"array",description:"The string must be one of these allowed values"},messages:{type:"object",description:"Custom error messages that override the default text for each constraint violation",properties:{invalid:{$ref:"#/$defs/localizable",description:"Shown when the value fails general type validation"},required:{$ref:"#/$defs/localizable",description:"Shown when a required field is empty"},minLength:{$ref:"#/$defs/localizable",description:"Shown when the value is shorter than `minLength`"},maxLength:{$ref:"#/$defs/localizable",description:"Shown when the value is longer than `maxLength`"},pattern:{$ref:"#/$defs/localizable",description:"Shown when the value does not match the `pattern` regex"},format:{$ref:"#/$defs/localizable",description:"Shown when the value does not conform to the specified `format`"},enum:{$ref:"#/$defs/localizable",description:"Shown when the value is not in the `enum` list"},const:{$ref:"#/$defs/localizable",description:"Shown when the value does not equal `const`"}},additionalProperties:!1}},required:["type"],additionalProperties:!1},numberValidator:{type:"object",properties:{type:{type:"string",enum:["number","integer"]},required:{type:"boolean",description:"Makes the field mandatory - validation fails if the value is absent"},minimum:{type:"number",description:"The value must be greater than or equal to this number (inclusive)"},maximum:{type:"number",description:"The value must be less than or equal to this number (inclusive)"},exclusiveMinimum:{type:"number",description:"The value must be strictly greater than this number (exclusive)"},exclusiveMaximum:{type:"number",description:"The value must be strictly less than this number (exclusive)"},multipleOf:{type:"number",description:"The value must be a multiple of this number"},const:{description:"The value must equal exactly this number"},enum:{type:"array",description:"The value must be one of these allowed numbers"},messages:{type:"object",description:"Custom error messages that override the default text for each constraint violation",properties:{invalid:{$ref:"#/$defs/localizable",description:"Shown when the value fails general type validation"},minimum:{$ref:"#/$defs/localizable",description:"Shown when the value is below `minimum`"},maximum:{$ref:"#/$defs/localizable",description:"Shown when the value exceeds `maximum`"},exclusiveMinimum:{$ref:"#/$defs/localizable",description:"Shown when the value is not strictly above `exclusiveMinimum`"},exclusiveMaximum:{$ref:"#/$defs/localizable",description:"Shown when the value is not strictly below `exclusiveMaximum`"},multipleOf:{$ref:"#/$defs/localizable",description:"Shown when the value is not a multiple of `multipleOf`"},enum:{$ref:"#/$defs/localizable",description:"Shown when the value is not in the `enum` list"},const:{$ref:"#/$defs/localizable",description:"Shown when the value does not equal `const`"}},additionalProperties:!1}},required:["type"],additionalProperties:!1},booleanValidator:{type:"object",properties:{type:{const:"boolean"},required:{type:"boolean",description:"Makes the field mandatory - validation fails if the value is absent or false (e.g. an unchecked required checkbox)"},const:{description:"The value must equal exactly this boolean (e.g. `true` to require acceptance)"},messages:{type:"object",description:"Custom error messages that override the default text for each constraint violation",properties:{invalid:{$ref:"#/$defs/localizable",description:"Shown when the value fails general type validation"},const:{$ref:"#/$defs/localizable",description:"Shown when the value does not equal `const`"}},additionalProperties:!1}},required:["type"],additionalProperties:!1},arrayValidator:{type:"object",properties:{type:{const:"array"},required:{type:"boolean",description:"Makes the field mandatory - validation fails if the array is empty or absent"},minItems:{type:"number",description:"The array must contain at least this many items"},maxItems:{type:"number",description:"The array must contain no more than this many items"},uniqueItems:{type:"boolean",description:"When true, all items in the array must be distinct values"},messages:{type:"object",description:"Custom error messages that override the default text for each constraint violation",properties:{invalid:{$ref:"#/$defs/localizable",description:"Shown when the value fails general type validation"},required:{$ref:"#/$defs/localizable",description:"Shown when a required array is empty or absent"},minItems:{$ref:"#/$defs/localizable",description:"Shown when the array has fewer items than `minItems`"},maxItems:{$ref:"#/$defs/localizable",description:"Shown when the array has more items than `maxItems`"}},additionalProperties:!1}},required:["type"],additionalProperties:!1},customValidator:{type:"object",description:"A custom validator that delegates validation to application code. The registered validator function receives these constraint keys and must return a Standard Schema V1-compliant schema object (https://standardschema.dev). Add arbitrary constraint keys alongside `type` - they are passed as-is to the registered validator function.",properties:{type:{const:"custom"},required:{type:"boolean",description:"Makes the field mandatory - evaluation is still delegated to the custom validator"}},required:["type"],additionalProperties:!0},validator:{description:"Validation rules for this field. The `type` discriminant selects the validator: `string`, `number`, `integer`, `boolean`, `array`, or `custom`.",oneOf:[{$ref:"#/$defs/stringValidator"},{$ref:"#/$defs/numberValidator"},{$ref:"#/$defs/booleanValidator"},{$ref:"#/$defs/arrayValidator"},{$ref:"#/$defs/customValidator"}]}},Q={$schema:Y,$id:G,$comment:H,title:K,$defs:Z};function X(e){return`${e}-input`}function ee(e,t){const r=e.replace(/__IMPLEMENTATION__/g,t.implementation).replace(/__ID_BASE__/g,t.idBase),o=r.match(/__[A-Z_]+__/);if(o!==null)throw new Error(`Unsubstituted placeholder ${o[0]} in a starter template.`);return r}function c(e,t){return ee(JSON.stringify(e,null,2),t)+`
+`}function te(e){return{"schemas.config.mjs":re(e),"src/lib/validators.schema.json":c(Q,e),"src/lib/components/flex.schema.json":c(J,e),"src/lib/components/example-input.schema.json":c(N,e),"examples/example.form.json":c(j,e),"test/schemas.spec.ts":oe(e)}}function re(e){return`// The manifest and configuration for this implementation's JSON schema tree.
+// You own this file. Every file marked GENERATED is rebuilt from it by
+// \`npx @golemui/schemas generate\`, so add a widget by writing its component schema
+// under src/lib/components/ and listing it in \`manifest\` below.
+
+/** @type {import('@golemui/schemas').ImplementationSchemaConfig} */
+export default {
+  implementation: '${e.implementation}',
+  // Where the tree is published. It only has to be a URL you control: the $ids must be
+  // unique and stable, and nothing downloads them (editors read form.editor.schema.json).
+  idBase: '${e.idBase}',
+  generatorPath: '@golemui/schemas generate',
+  manifestPath: 'schemas.config.mjs',
+  regenerateCommand: 'npx @golemui/schemas generate',
+  formTitle: '${e.implementation} form DSL',
+  statesDescription:
+    'Named boolean conditions keyed by state name, each mapping to a reactive expression. ' +
+    'Root-level widget props such as \`label\`, \`disabled\`, \`readonly\` and \`validator\` accept ' +
+    'a \`.stateName\` suffix, as does any key inside \`props\`.',
+  // One entry per widget type. \`flex\` and \`repeater\` are reserved names: use them for
+  // your layout and repeat widgets, and do not give another widget those types.
+  manifest: [
+    { type: 'flex', schemaFile: 'flex.schema.json', kind: 'layout' },
+    {
+      type: '${X(e.implementation)}',
+      schemaFile: 'example-input.schema.json',
+      kind: 'input',
+    },
+  ],
+  // Handwritten schemas at the src/lib root, re-exported from the generated index.
+  libRootSchemaFiles: ['validators.schema.json'],
+  includeSchemalessTypesInKnownWidgetTypes: false,
+  includeCustomWidgetFallback: false,
+  emitEditorBundle: true,
+};
+`}function oe(e){return`// Registers the whole schema tree into one Ajv 2020 instance and validates the
+// example form against it. Run it after every \`npx @golemui/schemas generate\`.
+//
+// Needs \`ajv\` and a test runner. This file is written for vitest, the assertions are
+// the only part to change for another runner.
+
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import Ajv2020 from 'ajv/dist/2020';
+import { describe, expect, it } from 'vitest';
+import {
+  COMPONENT_SCHEMAS_BY_TYPE,
+  commonSchema,
+  formSchema,
+  layoutWidgetSchema,
+  validatorsSchema,
+  widgetsSchema,
+} from '../src/index';
+
+const ajv = new Ajv2020({ allErrors: false, strict: false });
+
+// Leaves before aggregates, the form envelope last. Dedupe through \`ajv.schemas\`:
+// \`ajv.getSchema\` compiles on lookup and fails while ref targets are unregistered.
+const registrationOrder = [
+  commonSchema,
+  validatorsSchema,
+  widgetsSchema,
+  layoutWidgetSchema,
+  ...Object.values(COMPONENT_SCHEMAS_BY_TYPE),
+  formSchema,
+];
+for (const schema of registrationOrder) {
+  const id = schema['$id'] as string;
+  if (!ajv.schemas[id]) {
+    ajv.addSchema(schema);
+  }
+}
+
+const validate = ajv.getSchema('${e.idBase}form.schema.json');
+if (!validate) {
+  throw new Error('The form envelope schema did not register.');
+}
+
+function loadExampleForm(): { form: Array<Record<string, unknown>> } {
+  const path = fileURLToPath(new URL('../examples/example.form.json', import.meta.url));
+  return JSON.parse(readFileSync(path, 'utf8'));
+}
+
+describe('${e.implementation} schema tree', () => {
+  it('validates the example form', () => {
+    const valid = validate(loadExampleForm());
+    expect(valid, JSON.stringify(validate.errors, null, 2)).toBe(true);
+  });
+
+  it('rejects an unknown widget type', () => {
+    const form = loadExampleForm();
+    const firstChild = (form.form[0]['children'] as Array<Record<string, unknown>>)[0];
+    firstChild['type'] = 'not-a-widget';
+    expect(validate(form)).toBe(false);
+  });
+
+  it('rejects an unknown validator key', () => {
+    const form = loadExampleForm();
+    const firstChild = (form.form[0]['children'] as Array<Record<string, unknown>>)[0];
+    firstChild['validator'] = { type: 'string', required: true, notAKey: 1 };
+    expect(validate(form)).toBe(false);
+  });
+});
+`}const l="schemas.config.mjs",u=`golemui-schemas - JSON schema trees for GolemUI implementations
+
+Usage:
+  npx @golemui/schemas init [options]       scaffold a schema tree
+  npx @golemui/schemas generate [options]   rebuild the generated files
+
+Options for init:
+  --name <name>       implementation name, lowercase, e.g. kendo
+  --id-base <url>     absolute base URL of the published tree, e.g. https://example.com/schemas/kendo/
+  --dir <path>        directory to scaffold into (default: schemas)
+  --force             overwrite existing starter files
+
+Options for generate:
+  --dir <path>        directory holding ${l} (default: the current directory)
+
+Both commands accept --help.`;function ae(e){const t=new Map;let r;for(let o=0;o<e.length;o+=1){const a=e[o];if(!a.startsWith("--")){r??=a;continue}const s=a.slice(2),n=s.indexOf("=");if(n!==-1){t.set(s.slice(0,n),s.slice(n+1));continue}const d=e[o+1];d===void 0||d.startsWith("--")?t.set(s,!0):(t.set(s,d),o+=1)}return{command:r,flags:t}}function m(e,t){const r=e.get(t);return typeof r=="string"?r:void 0}async function f(e,t,r){if(process.stdin.isTTY!==!0)throw new Error(`Missing --${t}. There is no terminal to ask on.`);const o=g.createInterface({input:process.stdin,output:process.stdout});try{const a=(await o.question(`${e} [${r}] `)).trim();return a===""?r:a}finally{o.close()}}function se(e){if(!/^[a-z][a-z0-9-]*$/.test(e))throw new Error(`Invalid implementation name "${e}". Use lowercase letters, digits and hyphens, starting with a letter.`)}function ie(e){let t;try{t=new URL(e)}catch{throw new Error(`Invalid --id-base "${e}". It must be an absolute URL.`)}if(t.protocol!=="http:"&&t.protocol!=="https:")throw new Error(`Invalid --id-base "${e}". It must be an http or https URL.`);return e.endsWith("/")?e:`${e}/`}function ne(e,t,r){const o=i.join(e,t);p.mkdirSync(i.dirname(o),{recursive:!0}),p.writeFileSync(o,r,"utf-8"),console.log(`Wrote ${t}`)}async function le(e){const t=m(e,"name")??await f("Implementation name?","name","my-widgets");se(t);const r=ie(m(e,"id-base")??await f("Base URL of the published tree?","id-base",`https://example.com/schemas/${t}/`)),o=m(e,"dir")??await f("Directory?","dir","schemas"),a=i.resolve(process.cwd(),o),s=te({implementation:t,idBase:r}),n=Object.keys(s).filter(h=>p.existsSync(i.join(a,h)));if(n.length>0&&e.get("force")!==!0)throw new Error(`Refusing to overwrite starter files you may have edited: ${n.join(", ")}. Pass --force to replace them.`);for(const[h,y]of Object.entries(s))ne(a,h,y);await $(a);const d=i.relative(process.cwd(),a)||".";console.log(`
+Scaffolded the ${t} schema tree in ${d}.
+
+Next:
+  1. Add @golemui/schemas to the project's dependencies.
+  2. Write one component schema per widget under src/lib/components/, and list each one
+     in ${l}. src/lib/components/example-input.schema.json is the pattern to copy.
+  3. Rerun \`npx @golemui/schemas generate\` after every edit to a component schema, to
+     ${l} or to validators.schema.json. A CI step that regenerates and then runs
+     \`git diff --exit-code\` catches a forgotten rerun.
+  4. Point a form file's "$schema" at src/lib/form.editor.schema.json, as
+     examples/example.form.json does. Editors need that bundle, Ajv uses the per-file tree.`)}function de(e,t){if(e===null||typeof e!="object")throw new Error(`${t} must export a configuration object as its default export.`);const r=e,a=["implementation","idBase","generatorPath","formTitle"].filter(s=>typeof r[s]!="string");if(a.length>0)throw new Error(`${t} is missing required string fields: ${a.join(", ")}.`);if(!Array.isArray(r.manifest)||r.manifest.length===0)throw new Error(`${t} must declare a non-empty \`manifest\` array.`);if(!r.idBase.endsWith("/"))throw new Error(`${t}: \`idBase\` must end with a slash.`);return e}async function $(e){const t=i.join(e,l);if(!p.existsSync(t))throw new Error(`No ${l} in ${e}. Run this from the directory holding it, pass --dir, or scaffold a new tree with \`npx @golemui/schemas init\`.`);const r=await import(b.pathToFileURL(t).href),o=de(r.default,l);await v.generateImplementationSchemas(o,e)}async function ce(e){const{command:t,flags:r}=ae(e);if(r.get("help")===!0||t==="help"||t===void 0)return console.log(u),t===void 0&&r.get("help")!==!0?1:0;try{switch(t){case"init":return await le(r),0;case"generate":return await $(i.resolve(process.cwd(),m(r,"dir")??".")),0;default:return console.error(`Unknown command "${t}".
+
+${u}`),1}}catch(o){return console.error(o instanceof Error?o.message:o),1}}ce(process.argv.slice(2)).then(e=>{process.exitCode=e});

package/cli.js

@@ -0,0 +1,322 @@
+#!/usr/bin/env node
+import { existsSync as u, mkdirSync as b, writeFileSync as v } from "node:fs";
+import { resolve as $, join as h, relative as w, dirname as x } from "node:path";
+import { createInterface as j } from "node:readline/promises";
+import { pathToFileURL as S } from "node:url";
+import { g as P } from "./generate-implementation-schemas-DxCUi0Jr.js";
+const T = "../src/lib/form.editor.schema.json", E = [{ kind: "layout", type: "flex", uid: "#root", props: { direction: "column", gap: 16 }, children: [{ kind: "input", type: "__IMPLEMENTATION__-input", uid: "email", path: "email", label: "Email address", validator: { type: "string", required: !0, format: "email" }, props: { placeholder: "you@example.com" } }] }], _ = {
+  $schema: T,
+  form: E
+}, I = "https://json-schema.org/draft/2020-12/schema", A = "__ID_BASE__components/example-input.schema.json", q = "STARTER TEMPLATE, owned by you. One component schema per widget type. Copy this file for each widget, then list it in schemas.config.mjs. The pattern to keep: allOf the baseWidget, `kind` and `type` consts, one `$defs` entry per prop, a `.state` suffixed pattern for every suffixable key, `additionalProperties: false` inside `props`, and `unevaluatedProperties: false` at the root.", O = "__IMPLEMENTATION__ example input widget", M = "object", L = { labelDef: { $ref: "../core/common.schema.json#/$defs/localizable" }, disabledDef: { $ref: "../core/common.schema.json#/$defs/boolOrWhen" }, readonlyDef: { $ref: "../core/common.schema.json#/$defs/boolOrWhen" }, hintProp: { type: "string" }, placeholderProp: { type: "string" }, maxlengthProp: { type: "number" } }, N = [{ $ref: "../core/common.schema.json#/$defs/baseWidget" }], k = { kind: { const: "input" }, type: { const: "__IMPLEMENTATION__-input" }, path: { $ref: "../core/common.schema.json#/$defs/dotPath" }, label: { $ref: "#/$defs/labelDef" }, disabled: { $ref: "#/$defs/disabledDef" }, readonly: { $ref: "#/$defs/readonlyDef" }, on: { $ref: "../core/common.schema.json#/$defs/on" }, validator: { $ref: "../validators.schema.json#/$defs/validator" }, defaultValue: { type: "string" }, props: { type: "object", properties: { hint: { $ref: "#/$defs/hintProp" }, placeholder: { $ref: "#/$defs/placeholderProp" }, maxlength: { $ref: "#/$defs/maxlengthProp" } }, patternProperties: { "^hint\\.[^.]+$": { $ref: "#/$defs/hintProp" }, "^placeholder\\.[^.]+$": { $ref: "#/$defs/placeholderProp" }, "^maxlength\\.[^.]+$": { $ref: "#/$defs/maxlengthProp" } }, additionalProperties: !1 } }, z = { "^label\\.[^.]+$": { $ref: "#/$defs/labelDef" }, "^disabled\\.[^.]+$": { $ref: "#/$defs/disabledDef" }, "^readonly\\.[^.]+$": { $ref: "#/$defs/readonlyDef" }, "^validator\\.[^.]+$": { $ref: "../validators.schema.json#/$defs/validator" } }, R = ["kind", "type", "path"], C = !1, D = {
+  $schema: I,
+  $id: A,
+  $comment: q,
+  title: O,
+  type: M,
+  $defs: L,
+  allOf: N,
+  properties: k,
+  patternProperties: z,
+  required: R,
+  unevaluatedProperties: C
+}, W = "https://json-schema.org/draft/2020-12/schema", F = "__ID_BASE__components/flex.schema.json", B = "STARTER TEMPLATE, owned by you. `flex` is a reserved widget type: keep the name and the `children` array, change the props to match your layout widget.", V = "__IMPLEMENTATION__ flex widget", U = "object", J = { directionProp: { enum: ["row", "row-reverse", "column", "column-reverse"] }, justifyProp: { enum: ["start", "center", "end", "stretch", "space-between", "space-around"] }, alignProp: { enum: ["start", "center", "end", "stretch", "baseline"] }, wrapProp: { type: "boolean" }, gapProp: { type: "number" }, paddingProp: { type: "number" } }, Y = [{ $ref: "../core/common.schema.json#/$defs/baseWidget" }], G = { kind: { const: "layout" }, type: { const: "flex" }, children: { type: "array", minItems: 1, items: { $ref: "../widgets.schema.json#/$defs/formWidget" } }, props: { type: "object", properties: { direction: { $ref: "#/$defs/directionProp" }, justify: { $ref: "#/$defs/justifyProp" }, align: { $ref: "#/$defs/alignProp" }, wrap: { $ref: "#/$defs/wrapProp" }, gap: { $ref: "#/$defs/gapProp" }, padding: { $ref: "#/$defs/paddingProp" } }, patternProperties: { "^direction\\.[^.]+$": { $ref: "#/$defs/directionProp" }, "^justify\\.[^.]+$": { $ref: "#/$defs/justifyProp" }, "^align\\.[^.]+$": { $ref: "#/$defs/alignProp" }, "^wrap\\.[^.]+$": { $ref: "#/$defs/wrapProp" }, "^gap\\.[^.]+$": { $ref: "#/$defs/gapProp" }, "^padding\\.[^.]+$": { $ref: "#/$defs/paddingProp" } }, additionalProperties: !1 } }, H = ["kind", "type", "children"], K = !1, Z = {
+  $schema: W,
+  $id: F,
+  $comment: B,
+  title: V,
+  type: U,
+  $defs: J,
+  allOf: Y,
+  properties: G,
+  required: H,
+  unevaluatedProperties: K
+}, Q = "https://json-schema.org/draft/2020-12/schema", X = "__ID_BASE__validators.schema.json", ee = "STARTER TEMPLATE, owned by you. Edit it freely. The only contract is that it exposes #/$defs/validator, which every component schema references. Copied from the golemui gui validators when the tree was scaffolded, it does not track them afterwards.", te = "__IMPLEMENTATION__ validator definitions", re = { localizable: { $ref: "./core/common.schema.json#/$defs/localizable" }, stringValidator: { type: "object", properties: { type: { const: "string" }, required: { type: "boolean", description: "Makes the field mandatory - validation fails if the value is empty or absent" }, minLength: { type: "number", description: "Minimum number of characters the string must contain" }, maxLength: { type: "number", description: "Maximum number of characters the string may contain" }, pattern: { type: "string", description: "A regular expression pattern the value must match" }, format: { type: "string", description: "A named format the string must conform to (e.g. `email`, `url`, `date`, `uuid`)", enum: ["email", "hostname", "ipv4", "ipv6", "url", "uuid", "date", "time", "date-time", "duration"] }, const: { description: "The string must equal exactly this value" }, enum: { type: "array", description: "The string must be one of these allowed values" }, messages: { type: "object", description: "Custom error messages that override the default text for each constraint violation", properties: { invalid: { $ref: "#/$defs/localizable", description: "Shown when the value fails general type validation" }, required: { $ref: "#/$defs/localizable", description: "Shown when a required field is empty" }, minLength: { $ref: "#/$defs/localizable", description: "Shown when the value is shorter than `minLength`" }, maxLength: { $ref: "#/$defs/localizable", description: "Shown when the value is longer than `maxLength`" }, pattern: { $ref: "#/$defs/localizable", description: "Shown when the value does not match the `pattern` regex" }, format: { $ref: "#/$defs/localizable", description: "Shown when the value does not conform to the specified `format`" }, enum: { $ref: "#/$defs/localizable", description: "Shown when the value is not in the `enum` list" }, const: { $ref: "#/$defs/localizable", description: "Shown when the value does not equal `const`" } }, additionalProperties: !1 } }, required: ["type"], additionalProperties: !1 }, numberValidator: { type: "object", properties: { type: { type: "string", enum: ["number", "integer"] }, required: { type: "boolean", description: "Makes the field mandatory - validation fails if the value is absent" }, minimum: { type: "number", description: "The value must be greater than or equal to this number (inclusive)" }, maximum: { type: "number", description: "The value must be less than or equal to this number (inclusive)" }, exclusiveMinimum: { type: "number", description: "The value must be strictly greater than this number (exclusive)" }, exclusiveMaximum: { type: "number", description: "The value must be strictly less than this number (exclusive)" }, multipleOf: { type: "number", description: "The value must be a multiple of this number" }, const: { description: "The value must equal exactly this number" }, enum: { type: "array", description: "The value must be one of these allowed numbers" }, messages: { type: "object", description: "Custom error messages that override the default text for each constraint violation", properties: { invalid: { $ref: "#/$defs/localizable", description: "Shown when the value fails general type validation" }, minimum: { $ref: "#/$defs/localizable", description: "Shown when the value is below `minimum`" }, maximum: { $ref: "#/$defs/localizable", description: "Shown when the value exceeds `maximum`" }, exclusiveMinimum: { $ref: "#/$defs/localizable", description: "Shown when the value is not strictly above `exclusiveMinimum`" }, exclusiveMaximum: { $ref: "#/$defs/localizable", description: "Shown when the value is not strictly below `exclusiveMaximum`" }, multipleOf: { $ref: "#/$defs/localizable", description: "Shown when the value is not a multiple of `multipleOf`" }, enum: { $ref: "#/$defs/localizable", description: "Shown when the value is not in the `enum` list" }, const: { $ref: "#/$defs/localizable", description: "Shown when the value does not equal `const`" } }, additionalProperties: !1 } }, required: ["type"], additionalProperties: !1 }, booleanValidator: { type: "object", properties: { type: { const: "boolean" }, required: { type: "boolean", description: "Makes the field mandatory - validation fails if the value is absent or false (e.g. an unchecked required checkbox)" }, const: { description: "The value must equal exactly this boolean (e.g. `true` to require acceptance)" }, messages: { type: "object", description: "Custom error messages that override the default text for each constraint violation", properties: { invalid: { $ref: "#/$defs/localizable", description: "Shown when the value fails general type validation" }, const: { $ref: "#/$defs/localizable", description: "Shown when the value does not equal `const`" } }, additionalProperties: !1 } }, required: ["type"], additionalProperties: !1 }, arrayValidator: { type: "object", properties: { type: { const: "array" }, required: { type: "boolean", description: "Makes the field mandatory - validation fails if the array is empty or absent" }, minItems: { type: "number", description: "The array must contain at least this many items" }, maxItems: { type: "number", description: "The array must contain no more than this many items" }, uniqueItems: { type: "boolean", description: "When true, all items in the array must be distinct values" }, messages: { type: "object", description: "Custom error messages that override the default text for each constraint violation", properties: { invalid: { $ref: "#/$defs/localizable", description: "Shown when the value fails general type validation" }, required: { $ref: "#/$defs/localizable", description: "Shown when a required array is empty or absent" }, minItems: { $ref: "#/$defs/localizable", description: "Shown when the array has fewer items than `minItems`" }, maxItems: { $ref: "#/$defs/localizable", description: "Shown when the array has more items than `maxItems`" } }, additionalProperties: !1 } }, required: ["type"], additionalProperties: !1 }, customValidator: { type: "object", description: "A custom validator that delegates validation to application code. The registered validator function receives these constraint keys and must return a Standard Schema V1-compliant schema object (https://standardschema.dev). Add arbitrary constraint keys alongside `type` - they are passed as-is to the registered validator function.", properties: { type: { const: "custom" }, required: { type: "boolean", description: "Makes the field mandatory - evaluation is still delegated to the custom validator" } }, required: ["type"], additionalProperties: !0 }, validator: { description: "Validation rules for this field. The `type` discriminant selects the validator: `string`, `number`, `integer`, `boolean`, `array`, or `custom`.", oneOf: [{ $ref: "#/$defs/stringValidator" }, { $ref: "#/$defs/numberValidator" }, { $ref: "#/$defs/booleanValidator" }, { $ref: "#/$defs/arrayValidator" }, { $ref: "#/$defs/customValidator" }] } }, oe = {
+  $schema: Q,
+  $id: X,
+  $comment: ee,
+  title: te,
+  $defs: re
+};
+function ae(e) {
+  return `${e}-input`;
+}
+function ie(e, t) {
+  const r = e.replace(/__IMPLEMENTATION__/g, t.implementation).replace(/__ID_BASE__/g, t.idBase), o = r.match(/__[A-Z_]+__/);
+  if (o !== null)
+    throw new Error(`Unsubstituted placeholder ${o[0]} in a starter template.`);
+  return r;
+}
+function d(e, t) {
+  return ie(JSON.stringify(e, null, 2), t) + `
+`;
+}
+function se(e) {
+  return {
+    "schemas.config.mjs": ne(e),
+    "src/lib/validators.schema.json": d(oe, e),
+    "src/lib/components/flex.schema.json": d(Z, e),
+    "src/lib/components/example-input.schema.json": d(
+      D,
+      e
+    ),
+    "examples/example.form.json": d(_, e),
+    "test/schemas.spec.ts": le(e)
+  };
+}
+function ne(e) {
+  return `// The manifest and configuration for this implementation's JSON schema tree.
+// You own this file. Every file marked GENERATED is rebuilt from it by
+// \`npx @golemui/schemas generate\`, so add a widget by writing its component schema
+// under src/lib/components/ and listing it in \`manifest\` below.
+
+/** @type {import('@golemui/schemas').ImplementationSchemaConfig} */
+export default {
+  implementation: '${e.implementation}',
+  // Where the tree is published. It only has to be a URL you control: the $ids must be
+  // unique and stable, and nothing downloads them (editors read form.editor.schema.json).
+  idBase: '${e.idBase}',
+  generatorPath: '@golemui/schemas generate',
+  manifestPath: 'schemas.config.mjs',
+  regenerateCommand: 'npx @golemui/schemas generate',
+  formTitle: '${e.implementation} form DSL',
+  statesDescription:
+    'Named boolean conditions keyed by state name, each mapping to a reactive expression. ' +
+    'Root-level widget props such as \`label\`, \`disabled\`, \`readonly\` and \`validator\` accept ' +
+    'a \`.stateName\` suffix, as does any key inside \`props\`.',
+  // One entry per widget type. \`flex\` and \`repeater\` are reserved names: use them for
+  // your layout and repeat widgets, and do not give another widget those types.
+  manifest: [
+    { type: 'flex', schemaFile: 'flex.schema.json', kind: 'layout' },
+    {
+      type: '${ae(e.implementation)}',
+      schemaFile: 'example-input.schema.json',
+      kind: 'input',
+    },
+  ],
+  // Handwritten schemas at the src/lib root, re-exported from the generated index.
+  libRootSchemaFiles: ['validators.schema.json'],
+  includeSchemalessTypesInKnownWidgetTypes: false,
+  includeCustomWidgetFallback: false,
+  emitEditorBundle: true,
+};
+`;
+}
+function le(e) {
+  return `// Registers the whole schema tree into one Ajv 2020 instance and validates the
+// example form against it. Run it after every \`npx @golemui/schemas generate\`.
+//
+// Needs \`ajv\` and a test runner. This file is written for vitest, the assertions are
+// the only part to change for another runner.
+
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import Ajv2020 from 'ajv/dist/2020';
+import { describe, expect, it } from 'vitest';
+import {
+  COMPONENT_SCHEMAS_BY_TYPE,
+  commonSchema,
+  formSchema,
+  layoutWidgetSchema,
+  validatorsSchema,
+  widgetsSchema,
+} from '../src/index';
+
+const ajv = new Ajv2020({ allErrors: false, strict: false });
+
+// Leaves before aggregates, the form envelope last. Dedupe through \`ajv.schemas\`:
+// \`ajv.getSchema\` compiles on lookup and fails while ref targets are unregistered.
+const registrationOrder = [
+  commonSchema,
+  validatorsSchema,
+  widgetsSchema,
+  layoutWidgetSchema,
+  ...Object.values(COMPONENT_SCHEMAS_BY_TYPE),
+  formSchema,
+];
+for (const schema of registrationOrder) {
+  const id = schema['$id'] as string;
+  if (!ajv.schemas[id]) {
+    ajv.addSchema(schema);
+  }
+}
+
+const validate = ajv.getSchema('${e.idBase}form.schema.json');
+if (!validate) {
+  throw new Error('The form envelope schema did not register.');
+}
+
+function loadExampleForm(): { form: Array<Record<string, unknown>> } {
+  const path = fileURLToPath(new URL('../examples/example.form.json', import.meta.url));
+  return JSON.parse(readFileSync(path, 'utf8'));
+}
+
+describe('${e.implementation} schema tree', () => {
+  it('validates the example form', () => {
+    const valid = validate(loadExampleForm());
+    expect(valid, JSON.stringify(validate.errors, null, 2)).toBe(true);
+  });
+
+  it('rejects an unknown widget type', () => {
+    const form = loadExampleForm();
+    const firstChild = (form.form[0]['children'] as Array<Record<string, unknown>>)[0];
+    firstChild['type'] = 'not-a-widget';
+    expect(validate(form)).toBe(false);
+  });
+
+  it('rejects an unknown validator key', () => {
+    const form = loadExampleForm();
+    const firstChild = (form.form[0]['children'] as Array<Record<string, unknown>>)[0];
+    firstChild['validator'] = { type: 'string', required: true, notAKey: 1 };
+    expect(validate(form)).toBe(false);
+  });
+});
+`;
+}
+const n = "schemas.config.mjs", f = `golemui-schemas - JSON schema trees for GolemUI implementations
+
+Usage:
+  npx @golemui/schemas init [options]       scaffold a schema tree
+  npx @golemui/schemas generate [options]   rebuild the generated files
+
+Options for init:
+  --name <name>       implementation name, lowercase, e.g. kendo
+  --id-base <url>     absolute base URL of the published tree, e.g. https://example.com/schemas/kendo/
+  --dir <path>        directory to scaffold into (default: schemas)
+  --force             overwrite existing starter files
+
+Options for generate:
+  --dir <path>        directory holding ${n} (default: the current directory)
+
+Both commands accept --help.`;
+function de(e) {
+  const t = /* @__PURE__ */ new Map();
+  let r;
+  for (let o = 0; o < e.length; o += 1) {
+    const a = e[o];
+    if (!a.startsWith("--")) {
+      r ??= a;
+      continue;
+    }
+    const i = a.slice(2), s = i.indexOf("=");
+    if (s !== -1) {
+      t.set(i.slice(0, s), i.slice(s + 1));
+      continue;
+    }
+    const l = e[o + 1];
+    l === void 0 || l.startsWith("--") ? t.set(i, !0) : (t.set(i, l), o += 1);
+  }
+  return { command: r, flags: t };
+}
+function c(e, t) {
+  const r = e.get(t);
+  return typeof r == "string" ? r : void 0;
+}
+async function p(e, t, r) {
+  if (process.stdin.isTTY !== !0)
+    throw new Error(`Missing --${t}. There is no terminal to ask on.`);
+  const o = j({ input: process.stdin, output: process.stdout });
+  try {
+    const a = (await o.question(`${e} [${r}] `)).trim();
+    return a === "" ? r : a;
+  } finally {
+    o.close();
+  }
+}
+function ce(e) {
+  if (!/^[a-z][a-z0-9-]*$/.test(e))
+    throw new Error(
+      `Invalid implementation name "${e}". Use lowercase letters, digits and hyphens, starting with a letter.`
+    );
+}
+function me(e) {
+  let t;
+  try {
+    t = new URL(e);
+  } catch {
+    throw new Error(`Invalid --id-base "${e}". It must be an absolute URL.`);
+  }
+  if (t.protocol !== "http:" && t.protocol !== "https:")
+    throw new Error(`Invalid --id-base "${e}". It must be an http or https URL.`);
+  return e.endsWith("/") ? e : `${e}/`;
+}
+function pe(e, t, r) {
+  const o = h(e, t);
+  b(x(o), { recursive: !0 }), v(o, r, "utf-8"), console.log(`Wrote ${t}`);
+}
+async function he(e) {
+  const t = c(e, "name") ?? await p("Implementation name?", "name", "my-widgets");
+  ce(t);
+  const r = me(
+    c(e, "id-base") ?? await p(
+      "Base URL of the published tree?",
+      "id-base",
+      `https://example.com/schemas/${t}/`
+    )
+  ), o = c(e, "dir") ?? await p("Directory?", "dir", "schemas"), a = $(process.cwd(), o), i = se({ implementation: t, idBase: r }), s = Object.keys(i).filter((m) => u(h(a, m)));
+  if (s.length > 0 && e.get("force") !== !0)
+    throw new Error(
+      `Refusing to overwrite starter files you may have edited: ${s.join(", ")}. Pass --force to replace them.`
+    );
+  for (const [m, g] of Object.entries(i))
+    pe(a, m, g);
+  await y(a);
+  const l = w(process.cwd(), a) || ".";
+  console.log(`
+Scaffolded the ${t} schema tree in ${l}.
+
+Next:
+  1. Add @golemui/schemas to the project's dependencies.
+  2. Write one component schema per widget under src/lib/components/, and list each one
+     in ${n}. src/lib/components/example-input.schema.json is the pattern to copy.
+  3. Rerun \`npx @golemui/schemas generate\` after every edit to a component schema, to
+     ${n} or to validators.schema.json. A CI step that regenerates and then runs
+     \`git diff --exit-code\` catches a forgotten rerun.
+  4. Point a form file's "$schema" at src/lib/form.editor.schema.json, as
+     examples/example.form.json does. Editors need that bundle, Ajv uses the per-file tree.`);
+}
+function fe(e, t) {
+  if (e === null || typeof e != "object")
+    throw new Error(`${t} must export a configuration object as its default export.`);
+  const r = e, a = ["implementation", "idBase", "generatorPath", "formTitle"].filter((i) => typeof r[i] != "string");
+  if (a.length > 0)
+    throw new Error(`${t} is missing required string fields: ${a.join(", ")}.`);
+  if (!Array.isArray(r.manifest) || r.manifest.length === 0)
+    throw new Error(`${t} must declare a non-empty \`manifest\` array.`);
+  if (!r.idBase.endsWith("/"))
+    throw new Error(`${t}: \`idBase\` must end with a slash.`);
+  return e;
+}
+async function y(e) {
+  const t = h(e, n);
+  if (!u(t))
+    throw new Error(
+      `No ${n} in ${e}. Run this from the directory holding it, pass --dir, or scaffold a new tree with \`npx @golemui/schemas init\`.`
+    );
+  const r = await import(
+    /* @vite-ignore */
+    S(t).href
+  ), o = fe(r.default, n);
+  await P(o, e);
+}
+async function ue(e) {
+  const { command: t, flags: r } = de(e);
+  if (r.get("help") === !0 || t === "help" || t === void 0)
+    return console.log(f), t === void 0 && r.get("help") !== !0 ? 1 : 0;
+  try {
+    switch (t) {
+      case "init":
+        return await he(r), 0;
+      case "generate":
+        return await y($(process.cwd(), c(r, "dir") ?? ".")), 0;
+      default:
+        return console.error(`Unknown command "${t}".
+
+${f}`), 1;
+    }
+  } catch (o) {
+    return console.error(o instanceof Error ? o.message : o), 1;
+  }
+}
+ue(process.argv.slice(2)).then((e) => {
+  process.exitCode = e;
+});