@golemui/schemas 1.2.1

package/editor-bundle-Jb3IVFC3.js

@@ -0,0 +1,219 @@
+const $ = "https://json-schema.org/draft/2020-12/schema", S = "src/lib/widget-manifest.ts", T = "npm run generate:schemas";
+function E(e) {
+  return {
+    manifestPath: e.manifestPath ?? S,
+    regenerateCommand: e.regenerateCommand ?? T
+  };
+}
+function g(e) {
+  const { manifestPath: t, regenerateCommand: n } = E(e);
+  return `GENERATED by ${e.generatorPath} from ${t}. DO NOT EDIT. Regenerate with \`${n}\`.`;
+}
+function y(e) {
+  return e.filter(
+    (t) => t.schemaFile !== void 0
+  );
+}
+function F(e) {
+  const t = y(e.manifest), n = e.includeSchemalessTypesInKnownWidgetTypes ? e.manifest : t;
+  return {
+    $schema: $,
+    $id: `${e.idBase}widgets.schema.json`,
+    $comment: g(e),
+    title: `Golem ${e.implementation} widgets`,
+    $defs: {
+      knownWidgetTypes: {
+        description: "Built-in widget `type` identifiers. Used to exclude built-ins from the custom-widget fallback so every widget matches exactly one schema. Types listed here without a component schema are not expressible in JSON and are rejected entirely instead of validating as custom widgets.",
+        enum: n.map((s) => s.type)
+      },
+      formWidget: {
+        description: "A form widget: one of the built-in component schemas, the custom-widget fallback, or a reference to an external chunk file.",
+        oneOf: [
+          ...t.map((s) => ({ $ref: `./components/${s.schemaFile}` })),
+          ...e.includeCustomWidgetFallback ? [{ $ref: "./components/custom.schema.json" }] : [],
+          { $ref: "./core/common.schema.json#/$defs/chunkRef" }
+        ]
+      }
+    }
+  };
+}
+function _(e) {
+  return {
+    $schema: $,
+    $id: `${e.idBase}form.schema.json`,
+    $comment: g(e),
+    title: e.formTitle,
+    type: "object",
+    properties: {
+      $schema: {
+        type: "string"
+      },
+      states: {
+        type: "object",
+        description: e.statesDescription,
+        additionalProperties: {
+          $ref: "./core/common.schema.json#/$defs/reactiveExpression"
+        }
+      },
+      form: {
+        type: "array",
+        description: "The ordered list of widgets that make up the form body",
+        items: {
+          $ref: "./widgets.schema.json#/$defs/formWidget"
+        }
+      },
+      autocomplete: {
+        type: "string",
+        description: "HTML `autocomplete` attribute applied to the `<form>` element (e.g. `on`, `off`)"
+      }
+    },
+    required: ["form"],
+    additionalProperties: !1
+  };
+}
+function I(e) {
+  const t = y(e.manifest).filter(
+    (n) => n.kind === "layout"
+  );
+  if (t.length === 0)
+    throw new Error(
+      `The ${e.implementation} manifest has no layout entries with a schema file, so layout-widget.schema.json cannot be generated: an empty oneOf is invalid JSON Schema.`
+    );
+  return {
+    $schema: $,
+    $id: `${e.idBase}layout-widget.schema.json`,
+    $comment: g(e),
+    title: "Golem Layout Widget",
+    oneOf: t.map((n) => ({ $ref: `./components/${n.schemaFile}` }))
+  };
+}
+const b = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
+function u(e) {
+  const o = `${e.replace(/\.schema\.json$/, "").split(/[^A-Za-z0-9_$]+/).filter((a) => a.length > 0).map((a, m) => m === 0 ? a : a.charAt(0).toUpperCase() + a.slice(1)).join("")}Schema`;
+  if (!b.test(o))
+    throw new Error(
+      `Cannot derive a TypeScript identifier from schema file name "${e}" (got "${o}").`
+    );
+  return o;
+}
+function j(e) {
+  return b.test(e) ? e : `'${e}'`;
+}
+function P(e) {
+  const t = y(e.manifest), n = [
+    { name: "commonSchema", path: "core/common.schema.json" },
+    ...e.libRootSchemaFiles.map((r) => ({
+      name: u(r),
+      path: r
+    })),
+    { name: "formSchema", path: "form.schema.json" },
+    { name: "layoutWidgetSchema", path: "layout-widget.schema.json" },
+    { name: "widgetsSchema", path: "widgets.schema.json" },
+    ...t.map((r) => ({
+      name: u(r.schemaFile),
+      path: `components/${r.schemaFile}`
+    })),
+    ...e.includeCustomWidgetFallback ? [{ name: "customSchema", path: "components/custom.schema.json" }] : []
+  ], s = /* @__PURE__ */ new Map();
+  for (const { name: r, path: i } of n) {
+    const c = s.get(r);
+    if (c !== void 0)
+      throw new Error(
+        `Duplicate export name "${r}", derived from both "${c}" and "${i}".`
+      );
+    s.set(r, i);
+  }
+  const o = t.map(
+    (r) => `  ${j(r.type)}: ${u(r.schemaFile)},`
+  ), { manifestPath: a, regenerateCommand: m } = E(e);
+  return [
+    `// GENERATED by ${e.generatorPath} from ${a}. DO NOT EDIT.`,
+    `// Regenerate with \`${m}\`.`,
+    ...n.map(({ name: r, path: i }) => `import ${r}Json from './lib/${i}';`),
+    "",
+    ...n.map(
+      ({ name: r }) => `export const ${r}: Record<string, unknown> = ${r}Json;`
+    ),
+    "",
+    "/** Component schemas keyed by widget `type`. Excludes the custom fallback and schema-less types. */",
+    "export const COMPONENT_SCHEMAS_BY_TYPE = {",
+    ...o,
+    "} as const;"
+  ].join(`
+`) + `
+`;
+}
+const A = "https://json-schema.org/draft/2020-12/schema", w = "form.schema.json", k = "form.editor.schema.json", D = /* @__PURE__ */ new Set([
+  "$defs",
+  "definitions",
+  "properties",
+  "patternProperties",
+  "dependentSchemas"
+]);
+function l(e) {
+  return e.split("/").pop().replace(/\.schema\.json$/, "");
+}
+function N(e, t) {
+  const n = e.split("/").slice(0, -1);
+  for (const s of t.split("/"))
+    s === "." || s === "" || (s === ".." ? n.pop() : n.push(s));
+  return n.join("/");
+}
+function O(e, t, n) {
+  if (e.startsWith("#"))
+    return `#/$defs/${l(t)}${e.slice(1)}`;
+  const s = e.indexOf("#"), o = s === -1 ? e : e.slice(0, s), a = s === -1 ? "" : e.slice(s + 1), m = N(t, o);
+  return n.push(m), `#/$defs/${l(m)}${a}`;
+}
+function d(e, t, n) {
+  if (Array.isArray(e))
+    return e.map((o) => d(o, t, n));
+  if (e === null || typeof e != "object")
+    return e;
+  const s = {};
+  for (const [o, a] of Object.entries(e))
+    o === "$ref" && typeof a == "string" ? s[o] = O(a, t, n) : D.has(o) && a !== null && typeof a == "object" ? s[o] = C(
+      a,
+      t,
+      n
+    ) : s[o] = d(a, t, n);
+  return s;
+}
+function C(e, t, n) {
+  const s = {};
+  for (const [o, a] of Object.entries(e))
+    s[o] = d(a, t, n);
+  return s;
+}
+function x(e, t) {
+  const { manifestPath: n, regenerateCommand: s } = E(e), o = {}, a = /* @__PURE__ */ new Map(), m = [w];
+  for (; m.length > 0; ) {
+    const i = m.shift(), c = l(i), f = a.get(c);
+    if (f === i)
+      continue;
+    if (f !== void 0)
+      throw new Error(
+        `Cannot bundle: "${f}" and "${i}" both use the $defs key "${c}". Rename one of them.`
+      );
+    a.set(c, i);
+    const h = { ...t(i) };
+    delete h.$schema, delete h.$id, delete h.$comment, o[c] = d(h, i, m);
+  }
+  const p = l(w), r = o[p];
+  return {
+    $schema: A,
+    $comment: `GENERATED by ${e.generatorPath} from ${n}. DO NOT EDIT. Regenerate with \`${s}\`. Self-contained copy of the schema tree for editors, which cannot resolve the published $ids offline.`,
+    title: `${r.title} (editor bundle)`,
+    $ref: `#/$defs/${p}`,
+    $defs: o
+  };
+}
+export {
+  k as E,
+  _ as a,
+  F as b,
+  I as c,
+  x as d,
+  P as e,
+  w as f
+};

package/editor-bundle-yoVhdYIT.cjs

@@ -0,0 +1,3 @@
+"use strict";const E="https://json-schema.org/draft/2020-12/schema",S="src/lib/widget-manifest.ts",T="npm run generate:schemas";function g(e){return{manifestPath:e.manifestPath??S,regenerateCommand:e.regenerateCommand??T}}function y(e){const{manifestPath:t,regenerateCommand:n}=g(e);return`GENERATED by ${e.generatorPath} from ${t}. DO NOT EDIT. Regenerate with \`${n}\`.`}function w(e){return e.filter(t=>t.schemaFile!==void 0)}function j(e){const t=w(e.manifest),n=e.includeSchemalessTypesInKnownWidgetTypes?e.manifest:t;return{$schema:E,$id:`${e.idBase}widgets.schema.json`,$comment:y(e),title:`Golem ${e.implementation} widgets`,$defs:{knownWidgetTypes:{description:"Built-in widget `type` identifiers. Used to exclude built-ins from the custom-widget fallback so every widget matches exactly one schema. Types listed here without a component schema are not expressible in JSON and are rejected entirely instead of validating as custom widgets.",enum:n.map(s=>s.type)},formWidget:{description:"A form widget: one of the built-in component schemas, the custom-widget fallback, or a reference to an external chunk file.",oneOf:[...t.map(s=>({$ref:`./components/${s.schemaFile}`})),...e.includeCustomWidgetFallback?[{$ref:"./components/custom.schema.json"}]:[],{$ref:"./core/common.schema.json#/$defs/chunkRef"}]}}}}function D(e){return{$schema:E,$id:`${e.idBase}form.schema.json`,$comment:y(e),title:e.formTitle,type:"object",properties:{$schema:{type:"string"},states:{type:"object",description:e.statesDescription,additionalProperties:{$ref:"./core/common.schema.json#/$defs/reactiveExpression"}},form:{type:"array",description:"The ordered list of widgets that make up the form body",items:{$ref:"./widgets.schema.json#/$defs/formWidget"}},autocomplete:{type:"string",description:"HTML `autocomplete` attribute applied to the `<form>` element (e.g. `on`, `off`)"}},required:["form"],additionalProperties:!1}}function _(e){const t=w(e.manifest).filter(n=>n.kind==="layout");if(t.length===0)throw new Error(`The ${e.implementation} manifest has no layout entries with a schema file, so layout-widget.schema.json cannot be generated: an empty oneOf is invalid JSON Schema.`);return{$schema:E,$id:`${e.idBase}layout-widget.schema.json`,$comment:y(e),title:"Golem Layout Widget",oneOf:t.map(n=>({$ref:`./components/${n.schemaFile}`}))}}const b=/^[A-Za-z_$][A-Za-z0-9_$]*$/;function f(e){const o=`${e.replace(/\.schema\.json$/,"").split(/[^A-Za-z0-9_$]+/).filter(a=>a.length>0).map((a,m)=>m===0?a:a.charAt(0).toUpperCase()+a.slice(1)).join("")}Schema`;if(!b.test(o))throw new Error(`Cannot derive a TypeScript identifier from schema file name "${e}" (got "${o}").`);return o}function N(e){return b.test(e)?e:`'${e}'`}function F(e){const t=w(e.manifest),n=[{name:"commonSchema",path:"core/common.schema.json"},...e.libRootSchemaFiles.map(r=>({name:f(r),path:r})),{name:"formSchema",path:"form.schema.json"},{name:"layoutWidgetSchema",path:"layout-widget.schema.json"},{name:"widgetsSchema",path:"widgets.schema.json"},...t.map(r=>({name:f(r.schemaFile),path:`components/${r.schemaFile}`})),...e.includeCustomWidgetFallback?[{name:"customSchema",path:"components/custom.schema.json"}]:[]],s=new Map;for(const{name:r,path:i}of n){const c=s.get(r);if(c!==void 0)throw new Error(`Duplicate export name "${r}", derived from both "${c}" and "${i}".`);s.set(r,i)}const o=t.map(r=>`  ${N(r.type)}: ${f(r.schemaFile)},`),{manifestPath:a,regenerateCommand:m}=g(e);return[`// GENERATED by ${e.generatorPath} from ${a}. DO NOT EDIT.`,`// Regenerate with \`${m}\`.`,...n.map(({name:r,path:i})=>`import ${r}Json from './lib/${i}';`),"",...n.map(({name:r})=>`export const ${r}: Record<string, unknown> = ${r}Json;`),"","/** Component schemas keyed by widget `type`. Excludes the custom fallback and schema-less types. */","export const COMPONENT_SCHEMAS_BY_TYPE = {",...o,"} as const;"].join(`
+`)+`
+`}const O="https://json-schema.org/draft/2020-12/schema",$="form.schema.json",A="form.editor.schema.json",C=new Set(["$defs","definitions","properties","patternProperties","dependentSchemas"]);function l(e){return e.split("/").pop().replace(/\.schema\.json$/,"")}function I(e,t){const n=e.split("/").slice(0,-1);for(const s of t.split("/"))s==="."||s===""||(s===".."?n.pop():n.push(s));return n.join("/")}function R(e,t,n){if(e.startsWith("#"))return`#/$defs/${l(t)}${e.slice(1)}`;const s=e.indexOf("#"),o=s===-1?e:e.slice(0,s),a=s===-1?"":e.slice(s+1),m=I(t,o);return n.push(m),`#/$defs/${l(m)}${a}`}function d(e,t,n){if(Array.isArray(e))return e.map(o=>d(o,t,n));if(e===null||typeof e!="object")return e;const s={};for(const[o,a]of Object.entries(e))o==="$ref"&&typeof a=="string"?s[o]=R(a,t,n):C.has(o)&&a!==null&&typeof a=="object"?s[o]=P(a,t,n):s[o]=d(a,t,n);return s}function P(e,t,n){const s={};for(const[o,a]of Object.entries(e))s[o]=d(a,t,n);return s}function k(e,t){const{manifestPath:n,regenerateCommand:s}=g(e),o={},a=new Map,m=[$];for(;m.length>0;){const i=m.shift(),c=l(i),p=a.get(c);if(p===i)continue;if(p!==void 0)throw new Error(`Cannot bundle: "${p}" and "${i}" both use the $defs key "${c}". Rename one of them.`);a.set(c,i);const h={...t(i)};delete h.$schema,delete h.$id,delete h.$comment,o[c]=d(h,i,m)}const u=l($),r=o[u];return{$schema:O,$comment:`GENERATED by ${e.generatorPath} from ${n}. DO NOT EDIT. Regenerate with \`${s}\`. Self-contained copy of the schema tree for editors, which cannot resolve the published $ids offline.`,title:`${r.title} (editor bundle)`,$ref:`#/$defs/${u}`,$defs:o}}exports.EDITOR_BUNDLE_ENTRY_FILE=$;exports.EDITOR_BUNDLE_FILE=A;exports.buildEditorBundle=k;exports.buildFormEnvelope=D;exports.buildLayoutWidgetSchema=_;exports.buildSchemasPackageIndex=F;exports.buildWidgetsSchema=j;

package/generate-implementation-schemas-D57DzM2J.cjs

@@ -0,0 +1,2 @@
+"use strict";var E=Object.create;var g=Object.defineProperty;var F=Object.getOwnPropertyDescriptor;var x=Object.getOwnPropertyNames;var v=Object.getPrototypeOf,I=Object.prototype.hasOwnProperty;var L=(e,t,n,s)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of x(t))!I.call(e,o)&&o!==n&&g(e,o,{get:()=>t[o],enumerable:!(s=F(t,o))||s.enumerable});return e};var N=(e,t,n)=>(n=e!=null?E(v(e)):{},L(t||!e||!e.__esModule?g(n,"default",{value:e,enumerable:!0}):n,e));const c=require("node:fs"),i=require("node:path"),O=require("node:url"),d=require("./editor-bundle-yoVhdYIT.cjs");var f=typeof document<"u"?document.currentScript:null;async function _(){try{return await import("prettier")}catch{return null}}async function b(e){const t=await _();if(t===null)return null;const n=await t.resolveConfig(e);return n===null?null:{prettier:t,options:n}}async function j(e,t){const n=await b(t);return n===null?JSON.stringify(e,null,2)+`
+`:n.prettier.format(JSON.stringify(e),{...n.options,filepath:t})}async function $(e,t){const n=await b(t);return n===null?e:n.prettier.format(e,{...n.options,filepath:t})}function m(e){return c.readdirSync(e).filter(t=>t.endsWith(".schema.json")).sort()}function B(e){let t=e;for(;;){if(c.existsSync(i.join(t,"package.json")))return t;const n=i.dirname(t);if(n===t)throw new Error(`No package.json above ${e}, cannot locate @golemui/schemas.`);t=n}}function C(){const e=B(i.dirname(O.fileURLToPath(typeof document>"u"?require("url").pathToFileURL(__filename).href:f&&f.tagName.toUpperCase()==="SCRIPT"&&f.src||new URL("generate-implementation-schemas-D57DzM2J.cjs",document.baseURI).href))),t=[i.join(e,"src","lib","core"),i.join(e,"schemas","core")],n=t.find(s=>c.existsSync(s)&&m(s).length>0);if(n===void 0)throw new Error(`Cannot find the @golemui/schemas core schemas. Looked in: ${t.join(", ")}.`);return n}function J(e,t,n){const s=/"\$id":\s*"[^"]*"/g,o=e.match(s);if(o?.length!==1)throw new Error(`Expected exactly one $id in ${n}, found ${o?.length??0}.`);return e.replace(s,()=>`"$id": "${t}"`)}async function P(e,t){const n=i.join(t,"src","lib"),s=C(),o=[],l=new Map;async function h(r,a){const u=i.join(n,r);l.set(r,a),o.push({path:u,content:await j(a,u)})}await h("widgets.schema.json",d.buildWidgetsSchema(e)),await h("form.schema.json",d.buildFormEnvelope(e)),await h("layout-widget.schema.json",d.buildLayoutWidgetSchema(e));const p=m(s);for(const r of p){const a=`core/${r}`,u=i.join(n,a),S=J(c.readFileSync(i.join(s,r),"utf-8"),`${e.idBase}core/${r}`,r);l.set(a,JSON.parse(S)),o.push({path:u,content:await $(S,u)})}if(e.emitEditorBundle===!0){const r=i.join(n,d.EDITOR_BUNDLE_FILE),a=d.buildEditorBundle(e,u=>U(n,u,l));o.push({path:r,content:await j(a,r)})}const w=i.join(t,"src","index.ts");o.push({path:w,content:await $(d.buildSchemasPackageIndex(e),w)}),c.mkdirSync(i.join(n,"core"),{recursive:!0});const y=m(i.join(n,"core")).filter(r=>!p.includes(r));if(y.length>0)throw new Error(`Vendored core files without a @golemui/schemas source: ${y.join(", ")}. Delete them from ${i.relative(t,i.join(n,"core"))}.`);for(const r of o)c.writeFileSync(r.path,r.content,"utf-8"),console.log(`Wrote ${i.relative(t,r.path)} (${r.content.length} bytes)`);console.log(`Generated ${o.length} files from ${e.manifest.length} manifest entries.`)}function U(e,t,n){const s=n.get(t);if(s!==void 0)return s;const o=i.join(e,t);if(!c.existsSync(o))throw new Error(`Cannot build the editor bundle: ${t} is referenced by the schema tree but does not exist. Expected it at ${o}.`);return JSON.parse(c.readFileSync(o,"utf-8"))}exports.generateImplementationSchemas=P;

package/generate-implementation-schemas-DxCUi0Jr.js

@@ -0,0 +1,116 @@
+import { readFileSync as b, mkdirSync as x, writeFileSync as F, existsSync as f, readdirSync as j } from "node:fs";
+import { join as i, relative as y, dirname as S } from "node:path";
+import { fileURLToPath as O } from "node:url";
+import { b as v, a as N, c as B, E as J, d as L, e as D } from "./editor-bundle-Jb3IVFC3.js";
+async function I() {
+  try {
+    return await import("prettier");
+  } catch {
+    return null;
+  }
+}
+async function E(e) {
+  const t = await I();
+  if (t === null)
+    return null;
+  const n = await t.resolveConfig(e);
+  return n === null ? null : { prettier: t, options: n };
+}
+async function g(e, t) {
+  const n = await E(t);
+  return n === null ? JSON.stringify(e, null, 2) + `
+` : n.prettier.format(JSON.stringify(e), {
+    ...n.options,
+    filepath: t
+  });
+}
+async function $(e, t) {
+  const n = await E(t);
+  return n === null ? e : n.prettier.format(e, { ...n.options, filepath: t });
+}
+function d(e) {
+  return j(e).filter((t) => t.endsWith(".schema.json")).sort();
+}
+function P(e) {
+  let t = e;
+  for (; ; ) {
+    if (f(i(t, "package.json")))
+      return t;
+    const n = S(t);
+    if (n === t)
+      throw new Error(`No package.json above ${e}, cannot locate @golemui/schemas.`);
+    t = n;
+  }
+}
+function k() {
+  const e = P(S(O(import.meta.url))), t = [
+    i(e, "src", "lib", "core"),
+    i(e, "schemas", "core")
+  ], n = t.find(
+    (s) => f(s) && d(s).length > 0
+  );
+  if (n === void 0)
+    throw new Error(
+      `Cannot find the @golemui/schemas core schemas. Looked in: ${t.join(", ")}.`
+    );
+  return n;
+}
+function C(e, t, n) {
+  const s = /"\$id":\s*"[^"]*"/g, r = e.match(s);
+  if (r?.length !== 1)
+    throw new Error(`Expected exactly one $id in ${n}, found ${r?.length ?? 0}.`);
+  return e.replace(s, () => `"$id": "${t}"`);
+}
+async function G(e, t) {
+  const n = i(t, "src", "lib"), s = k(), r = [], u = /* @__PURE__ */ new Map();
+  async function l(o, a) {
+    const c = i(n, o);
+    u.set(o, a), r.push({ path: c, content: await g(a, c) });
+  }
+  await l("widgets.schema.json", v(e)), await l("form.schema.json", N(e)), await l("layout-widget.schema.json", B(e));
+  const h = d(s);
+  for (const o of h) {
+    const a = `core/${o}`, c = i(n, a), w = C(
+      b(i(s, o), "utf-8"),
+      `${e.idBase}core/${o}`,
+      o
+    );
+    u.set(a, JSON.parse(w)), r.push({ path: c, content: await $(w, c) });
+  }
+  if (e.emitEditorBundle === !0) {
+    const o = i(n, J), a = L(
+      e,
+      (c) => W(n, c, u)
+    );
+    r.push({ path: o, content: await g(a, o) });
+  }
+  const m = i(t, "src", "index.ts");
+  r.push({
+    path: m,
+    content: await $(D(e), m)
+  }), x(i(n, "core"), { recursive: !0 });
+  const p = d(i(n, "core")).filter(
+    (o) => !h.includes(o)
+  );
+  if (p.length > 0)
+    throw new Error(
+      `Vendored core files without a @golemui/schemas source: ${p.join(", ")}. Delete them from ${y(t, i(n, "core"))}.`
+    );
+  for (const o of r)
+    F(o.path, o.content, "utf-8"), console.log(`Wrote ${y(t, o.path)} (${o.content.length} bytes)`);
+  console.log(`Generated ${r.length} files from ${e.manifest.length} manifest entries.`);
+}
+function W(e, t, n) {
+  const s = n.get(t);
+  if (s !== void 0)
+    return s;
+  const r = i(e, t);
+  if (!f(r))
+    throw new Error(
+      `Cannot build the editor bundle: ${t} is referenced by the schema tree but does not exist. Expected it at ${r}.`
+    );
+  return JSON.parse(b(r, "utf-8"));
+}
+export {
+  G as g
+};

package/generator.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./generate-implementation-schemas-D57DzM2J.cjs");exports.generateImplementationSchemas=e.generateImplementationSchemas;

package/generator.d.ts

@@ -0,0 +1 @@
+export { generateImplementationSchemas } from './lib/generator/generate-implementation-schemas.js';

package/generator.js

@@ -0,0 +1,4 @@
+import { g as m } from "./generate-implementation-schemas-DxCUi0Jr.js";
+export {
+  m as generateImplementationSchemas
+};

package/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./editor-bundle-yoVhdYIT.cjs"),t="https://json-schema.org/draft/2020-12/schema",i="https://golemui.com/schemas/core/common.schema.json",s="Owned by @golemui/schemas (libs/schemas/src/lib/core/). Implementation trees contain a generated vendored copy, identical apart from an `$id` rebased onto the implementation's own tree. Edit the source file, then run `npm run generate:schemas`.",n="Golem Common Definitions",a={reactiveExpression:{type:"string",description:"A reactive expression string. Use `$form` to access form data e.g. `$form.termsAccepted === true`"},dotPath:{type:"string",description:"A dot-separated path to a property in the form data"},uid:{type:"string",description:"Unique identifier for the widget"},chunkRef:{type:"object",description:"A reference to an external chunk file whose widget array will be inlined at this position in the form",properties:{$ref:{type:"string",description:"Relative path to a JSON chunk file"}},required:["$ref"],additionalProperties:!1},localizable:{description:"A value that can be a plain string or an i18n key object. Use a plain string for static text, or `{key, default, params}` to reference a translation key.",oneOf:[{type:"string"},{type:"object",properties:{key:{type:"string",description:"The i18n translation key"},default:{type:"string",description:"Fallback text shown when the translation key is not found"},params:{type:"object",description:"Interpolation parameters passed to the translation function"}},required:["key"],additionalProperties:!1}]},include:{description:"Show this widget only in certain form states (`{in: [stateNames]}`) or when a reactive expression is true (`{when: expr}`). If omitted the widget is always shown.",oneOf:[{type:"object",properties:{in:{type:"array",items:{type:"string"},description:"List of state names (defined in the form `states` map) in which this widget should be visible"}},required:["in"],additionalProperties:!1},{type:"object",properties:{when:{$ref:"#/$defs/reactiveExpression"}},required:["when"],additionalProperties:!1}]},exclude:{description:"Hide this widget in certain form states (`{from: [stateNames]}`) or when a reactive expression is true (`{when: expr}`). If omitted the widget is never hidden.",oneOf:[{type:"object",properties:{from:{type:"array",items:{type:"string"},description:"List of state names (defined in the form `states` map) in which this widget should be hidden"}},required:["from"],additionalProperties:!1},{type:"object",properties:{when:{$ref:"#/$defs/reactiveExpression"}},required:["when"],additionalProperties:!1}]},boolOrWhen:{description:"A static boolean or a conditional `{when: reactiveExpression}` object evaluated at runtime. Use `{when: '$form.someField === true'}` for dynamic behavior.",oneOf:[{type:"boolean"},{type:"object",properties:{when:{$ref:"#/$defs/reactiveExpression"}},required:["when"],additionalProperties:!1}]},on:{type:"object",description:'Event handlers for this widget. Values are action names dispatched to the form\'s event bus. Each key also accepts a state-suffixed variant (`"click.<stateName>"`) that overrides the base handler when the named state is active.',properties:{load:{type:"string",description:"Action dispatched when the widget is first mounted"},click:{type:"string",description:"Action dispatched when the user clicks the widget"},change:{type:"string",description:"Action dispatched when the widget value changes"},filter:{type:"string",description:"Action dispatched on search/filter input, typically used with async data sources"},blur:{type:"string",description:"Action dispatched when the widget loses focus"}},patternProperties:{"^load\\.[^.]+$":{type:"string",description:'State-suffixed load handler: used instead of `load` when the named state is active (e.g. `"load.myState"`)'},"^click\\.[^.]+$":{type:"string",description:'State-suffixed click handler: used instead of `click` when the named state is active (e.g. `"click.myState"`)'},"^change\\.[^.]+$":{type:"string",description:'State-suffixed change handler: used instead of `change` when the named state is active (e.g. `"change.myState"`)'},"^filter\\.[^.]+$":{type:"string",description:'State-suffixed filter handler: used instead of `filter` when the named state is active (e.g. `"filter.myState"`)'},"^blur\\.[^.]+$":{type:"string",description:'State-suffixed blur handler: used instead of `blur` when the named state is active (e.g. `"blur.myState"`)'}},additionalProperties:!1},baseWidget:{type:"object",description:'Base properties shared by all widgets. Root-level props that support state-suffixing (e.g. `"label.myState"`) are: `label`, `disabled`, `readonly`, `validator`, `size`. Any key inside `props` can also be suffixed. State names must be declared in the form `states` map.',properties:{$schema:{type:"string"},uid:{$ref:"#/$defs/uid"},type:{type:"string"},size:{type:"number",description:"Column span in the form grid (1-12). Defaults to full width when omitted.",minimum:1,maximum:12},include:{$ref:"#/$defs/include"},exclude:{$ref:"#/$defs/exclude"}},required:["type"]}},r={$schema:t,$id:i,$comment:s,title:n,$defs:a},o=r;exports.EDITOR_BUNDLE_ENTRY_FILE=e.EDITOR_BUNDLE_ENTRY_FILE;exports.EDITOR_BUNDLE_FILE=e.EDITOR_BUNDLE_FILE;exports.buildEditorBundle=e.buildEditorBundle;exports.buildFormEnvelope=e.buildFormEnvelope;exports.buildLayoutWidgetSchema=e.buildLayoutWidgetSchema;exports.buildSchemasPackageIndex=e.buildSchemasPackageIndex;exports.buildWidgetsSchema=e.buildWidgetsSchema;exports.commonSchema=o;

package/index.d.ts

@@ -0,0 +1,6 @@
+/** The shared core `$defs` resource, published as `schemas/core/common.schema.json`. */
+export declare const commonSchema: Record<string, unknown>;
+export type { ImplementationSchemaConfig, WidgetKind, WidgetManifestEntry, } from './lib/manifest.types.js';
+export { buildFormEnvelope, buildLayoutWidgetSchema, buildSchemasPackageIndex, buildWidgetsSchema, } from './lib/generator/builders.js';
+export type { SchemaObject } from './lib/generator/builders.js';
+export { buildEditorBundle, EDITOR_BUNDLE_ENTRY_FILE, EDITOR_BUNDLE_FILE, } from './lib/generator/editor-bundle.js';

package/index.js

@@ -0,0 +1,18 @@
+import { f as c, E as p, d as l, a as h, c as f, e as m, b as u } from "./editor-bundle-Jb3IVFC3.js";
+const e = "https://json-schema.org/draft/2020-12/schema", t = "https://golemui.com/schemas/core/common.schema.json", i = "Owned by @golemui/schemas (libs/schemas/src/lib/core/). Implementation trees contain a generated vendored copy, identical apart from an `$id` rebased onto the implementation's own tree. Edit the source file, then run `npm run generate:schemas`.", s = "Golem Common Definitions", a = { reactiveExpression: { type: "string", description: "A reactive expression string. Use `$form` to access form data e.g. `$form.termsAccepted === true`" }, dotPath: { type: "string", description: "A dot-separated path to a property in the form data" }, uid: { type: "string", description: "Unique identifier for the widget" }, chunkRef: { type: "object", description: "A reference to an external chunk file whose widget array will be inlined at this position in the form", properties: { $ref: { type: "string", description: "Relative path to a JSON chunk file" } }, required: ["$ref"], additionalProperties: !1 }, localizable: { description: "A value that can be a plain string or an i18n key object. Use a plain string for static text, or `{key, default, params}` to reference a translation key.", oneOf: [{ type: "string" }, { type: "object", properties: { key: { type: "string", description: "The i18n translation key" }, default: { type: "string", description: "Fallback text shown when the translation key is not found" }, params: { type: "object", description: "Interpolation parameters passed to the translation function" } }, required: ["key"], additionalProperties: !1 }] }, include: { description: "Show this widget only in certain form states (`{in: [stateNames]}`) or when a reactive expression is true (`{when: expr}`). If omitted the widget is always shown.", oneOf: [{ type: "object", properties: { in: { type: "array", items: { type: "string" }, description: "List of state names (defined in the form `states` map) in which this widget should be visible" } }, required: ["in"], additionalProperties: !1 }, { type: "object", properties: { when: { $ref: "#/$defs/reactiveExpression" } }, required: ["when"], additionalProperties: !1 }] }, exclude: { description: "Hide this widget in certain form states (`{from: [stateNames]}`) or when a reactive expression is true (`{when: expr}`). If omitted the widget is never hidden.", oneOf: [{ type: "object", properties: { from: { type: "array", items: { type: "string" }, description: "List of state names (defined in the form `states` map) in which this widget should be hidden" } }, required: ["from"], additionalProperties: !1 }, { type: "object", properties: { when: { $ref: "#/$defs/reactiveExpression" } }, required: ["when"], additionalProperties: !1 }] }, boolOrWhen: { description: "A static boolean or a conditional `{when: reactiveExpression}` object evaluated at runtime. Use `{when: '$form.someField === true'}` for dynamic behavior.", oneOf: [{ type: "boolean" }, { type: "object", properties: { when: { $ref: "#/$defs/reactiveExpression" } }, required: ["when"], additionalProperties: !1 }] }, on: { type: "object", description: 'Event handlers for this widget. Values are action names dispatched to the form\'s event bus. Each key also accepts a state-suffixed variant (`"click.<stateName>"`) that overrides the base handler when the named state is active.', properties: { load: { type: "string", description: "Action dispatched when the widget is first mounted" }, click: { type: "string", description: "Action dispatched when the user clicks the widget" }, change: { type: "string", description: "Action dispatched when the widget value changes" }, filter: { type: "string", description: "Action dispatched on search/filter input, typically used with async data sources" }, blur: { type: "string", description: "Action dispatched when the widget loses focus" } }, patternProperties: { "^load\\.[^.]+$": { type: "string", description: 'State-suffixed load handler: used instead of `load` when the named state is active (e.g. `"load.myState"`)' }, "^click\\.[^.]+$": { type: "string", description: 'State-suffixed click handler: used instead of `click` when the named state is active (e.g. `"click.myState"`)' }, "^change\\.[^.]+$": { type: "string", description: 'State-suffixed change handler: used instead of `change` when the named state is active (e.g. `"change.myState"`)' }, "^filter\\.[^.]+$": { type: "string", description: 'State-suffixed filter handler: used instead of `filter` when the named state is active (e.g. `"filter.myState"`)' }, "^blur\\.[^.]+$": { type: "string", description: 'State-suffixed blur handler: used instead of `blur` when the named state is active (e.g. `"blur.myState"`)' } }, additionalProperties: !1 }, baseWidget: { type: "object", description: 'Base properties shared by all widgets. Root-level props that support state-suffixing (e.g. `"label.myState"`) are: `label`, `disabled`, `readonly`, `validator`, `size`. Any key inside `props` can also be suffixed. State names must be declared in the form `states` map.', properties: { $schema: { type: "string" }, uid: { $ref: "#/$defs/uid" }, type: { type: "string" }, size: { type: "number", description: "Column span in the form grid (1-12). Defaults to full width when omitted.", minimum: 1, maximum: 12 }, include: { $ref: "#/$defs/include" }, exclude: { $ref: "#/$defs/exclude" } }, required: ["type"] } }, n = {
+  $schema: e,
+  $id: t,
+  $comment: i,
+  title: s,
+  $defs: a
+}, r = n;
+export {
+  c as EDITOR_BUNDLE_ENTRY_FILE,
+  p as EDITOR_BUNDLE_FILE,
+  l as buildEditorBundle,
+  h as buildFormEnvelope,
+  f as buildLayoutWidgetSchema,
+  m as buildSchemasPackageIndex,
+  u as buildWidgetsSchema,
+  r as commonSchema
+};

package/lib/generator/builders.d.ts

@@ -0,0 +1,41 @@
+import { ImplementationSchemaConfig } from '../manifest.types.js';
+/** A plain JSON schema object as produced by the builders. */
+export type SchemaObject = Record<string, unknown>;
+/** Where the marker says the manifest lives, and how to rerun the generator. */
+export declare function generatedFileOrigin(config: ImplementationSchemaConfig): {
+    manifestPath: string;
+    regenerateCommand: string;
+};
+/**
+ * Builds the implementation's `widgets.schema.json`: the `formWidget` union and
+ * the `knownWidgetTypes` enum, derived from one manifest so they cannot disagree.
+ * @param config - The implementation's schema configuration.
+ * @returns The schema object, ready to be serialized.
+ */
+export declare function buildWidgetsSchema(config: ImplementationSchemaConfig): SchemaObject;
+/**
+ * Builds the implementation's `form.schema.json` envelope: the document root a
+ * form definition file validates against.
+ * @param config - The implementation's schema configuration.
+ * @returns The schema object, ready to be serialized.
+ */
+export declare function buildFormEnvelope(config: ImplementationSchemaConfig): SchemaObject;
+/**
+ * Builds the implementation's `layout-widget.schema.json`: the union of the
+ * layout-kind manifest entries, used by chunk files and repeater templates.
+ * @param config - The implementation's schema configuration.
+ * @returns The schema object, ready to be serialized.
+ */
+export declare function buildLayoutWidgetSchema(config: ImplementationSchemaConfig): SchemaObject;
+/**
+ * Builds the source of the implementation schema package's `src/index.ts`:
+ * schema imports, re-exports, and the `COMPONENT_SCHEMAS_BY_TYPE` map.
+ *
+ * Every schema is imported as `<name>Json` and re-exported as an annotated
+ * `<name>` constant. The annotation keeps `.json` imports out of the emitted
+ * `index.d.ts`, so a consumer of the published package needs neither
+ * `resolveJsonModule` nor a `type: "json"` import attribute.
+ * @param config - The implementation's schema configuration.
+ * @returns The TypeScript source text (unformatted, run it through prettier).
+ */
+export declare function buildSchemasPackageIndex(config: ImplementationSchemaConfig): string;

package/lib/generator/editor-bundle.d.ts

@@ -0,0 +1,18 @@
+import { ImplementationSchemaConfig } from '../manifest.types.js';
+import { SchemaObject } from './builders.js';
+/** The file the walk starts from, relative to the implementation's `src/lib`. */
+export declare const EDITOR_BUNDLE_ENTRY_FILE = "form.schema.json";
+/** Output file name, relative to the implementation's `src/lib`. */
+export declare const EDITOR_BUNDLE_FILE = "form.editor.schema.json";
+/**
+ * Builds the self-contained editor schema by walking the `$ref` graph from the form
+ * envelope. Every reachable file is inlined, so the result loads with no network access.
+ * @param config - The implementation's schema configuration.
+ * @param readSchema - Returns the parsed schema at a lib-relative path, e.g. `components/flex.schema.json`.
+ * @returns The bundle, ready to be serialized.
+ * @example
+ * const bundle = buildEditorBundle(config, (path) =>
+ *   JSON.parse(readFileSync(join(libDir, path), 'utf-8')),
+ * );
+ */
+export declare function buildEditorBundle(config: ImplementationSchemaConfig, readSchema: (libRelativePath: string) => SchemaObject): SchemaObject;

package/lib/generator/generate-implementation-schemas.d.ts

@@ -0,0 +1,14 @@
+import { ImplementationSchemaConfig } from '../manifest.types.js';
+/**
+ * Generates one implementation's schema tree into its package directory.
+ * @param config - The implementation's schema configuration.
+ * @param packageRoot - Absolute path of the implementation package, the directory holding its `src/`.
+ * @returns Resolves when every output file is written. Callers own error handling.
+ * @example
+ * // The implementation package's generator entry point:
+ * generateImplementationSchemas(kendoSchemaConfig, join(__dirname, '..')).catch((error) => {
+ *   console.error(error);
+ *   process.exitCode = 1;
+ * });
+ */
+export declare function generateImplementationSchemas(config: ImplementationSchemaConfig, packageRoot: string): Promise<void>;

package/lib/manifest.types.d.ts

@@ -0,0 +1,86 @@
+/** The widget categories shared by every implementation, matching the runtime widget `kind` field. */
+export type WidgetKind = 'input' | 'layout' | 'display' | 'action';
+/**
+ * One widget type in an implementation's manifest, the single source of truth
+ * for the generated aggregate schema files.
+ * @example
+ * const entry: WidgetManifestEntry = {
+ *   type: 'dateTimeCalendar',
+ *   schemaFile: 'datetimecalendar.schema.json',
+ *   kind: 'input',
+ * };
+ */
+export interface WidgetManifestEntry {
+    /** The widget `type` const used in JSON form definitions, e.g. `dateTimeCalendar`. */
+    readonly type: string;
+    /**
+     * Component schema file name inside the implementation's `components/` directory.
+     * Absent for widget types that JSON cannot express (e.g. props holding a function).
+     */
+    readonly schemaFile?: string;
+    /** The widget category. Entries with kind `layout` form the layout-widget union. */
+    readonly kind: WidgetKind;
+}
+/**
+ * Everything the schema builders need to generate one implementation's
+ * aggregate schema files.
+ * @example
+ * const config: ImplementationSchemaConfig = {
+ *   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: guiWidgetManifest,
+ *   libRootSchemaFiles: ['ranges.schema.json', 'validators.schema.json'],
+ *   includeSchemalessTypesInKnownWidgetTypes: true,
+ *   includeCustomWidgetFallback: true,
+ * };
+ */
+export interface ImplementationSchemaConfig {
+    /** Implementation name, e.g. `gui`. Used in generated titles. */
+    readonly implementation: string;
+    /** Absolute base URL of the implementation's published schema tree, with a trailing slash. */
+    readonly idBase: string;
+    /** Repo-relative path of the implementation's generator entry point, used in the generated-file markers. */
+    readonly generatorPath: string;
+    /**
+     * Path of the file holding the manifest, named in the generated-file markers.
+     * Defaults to `src/lib/widget-manifest.ts`, where the in-repo implementations keep it.
+     */
+    readonly manifestPath?: string;
+    /**
+     * Command that regenerates the tree, named in the generated-file markers.
+     * Defaults to `npm run generate:schemas`.
+     */
+    readonly regenerateCommand?: string;
+    /** `title` of the generated form envelope. */
+    readonly formTitle: string;
+    /** Description of the form envelope's `states` property, naming the implementation's suffixable root props. */
+    readonly statesDescription: string;
+    /** The implementation's widget manifest. */
+    readonly manifest: readonly WidgetManifestEntry[];
+    /**
+     * Handwritten schema files at the implementation package's `src/lib/` root,
+     * e.g. `validators.schema.json`. Each is re-exported from the generated index
+     * under its derived name (`validators.schema.json` exports `validatorsSchema`).
+     */
+    readonly libRootSchemaFiles: readonly string[];
+    /**
+     * When true, schema-less widget types are still listed in `knownWidgetTypes`,
+     * so their `type` fails validation instead of matching the custom fallback.
+     */
+    readonly includeSchemalessTypesInKnownWidgetTypes: boolean;
+    /**
+     * When true, the `formWidget` union includes `components/custom.schema.json`
+     * and the generated index exports it as `customSchema`. Turn off for an
+     * implementation without a custom-widget fallback.
+     */
+    readonly includeCustomWidgetFallback: boolean;
+    /**
+     * When true, also emit `src/lib/form.editor.schema.json`, a self-contained copy of
+     * the tree for editors, which cannot resolve the published `$id`s offline. Point a
+     * form file's `$schema` at it. Off by default.
+     */
+    readonly emitEditorBundle?: boolean;
+}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@golemui/schemas",
+  "version": "1.2.1",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "bin": {
+    "golemui-schemas": "./cli.js"
+  },
+  "main": "./index.cjs",
+  "module": "./index.js",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js",
+      "require": "./index.cjs"
+    },
+    "./generator": {
+      "types": "./generator.d.ts",
+      "import": "./generator.js",
+      "require": "./generator.cjs"
+    },
+    "./schemas/*.schema.json": "./schemas/*.schema.json",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "schemas",
+    "*.js",
+    "*.cjs",
+    "*.d.ts",
+    "*.md"
+  ],
+  "dependencies": {},
+  "peerDependencies": {
+    "prettier": "^3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "prettier": {
+      "optional": true
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/golemui/golemui.git",
+    "directory": "libs/schemas"
+  }
+}