@flanksource/clicky-ui 0.2.21 → 0.3.2

package/dist/components/json-schema-form-template-menu.cjs

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const jsxRuntime = require("react/jsx-runtime");
+const react = require("react");
+const Icon = require("../data/Icon.cjs");
+const DropdownMenu = require("../overlay/DropdownMenu.cjs");
+const UiBraces = require("../icons/components/UiBraces.cjs");
+function normalizeToken(token) {
+  return typeof token === "string" ? { value: token, label: token } : { value: token.value, label: token.label ?? token.value };
+}
+function insertTemplateValue(field, trigger, value) {
+  var _a;
+  const input = (_a = trigger == null ? void 0 : trigger.closest("[data-jsf-control]")) == null ? void 0 : _a.querySelector("input[data-jsf-input]");
+  const current = typeof field.value === "string" ? field.value : "";
+  if (!input) {
+    field.onChange(value);
+    return;
+  }
+  const start = input.selectionStart ?? current.length;
+  const end = input.selectionEnd ?? current.length;
+  field.onChange(current.slice(0, start) + value + current.slice(end));
+  const caret = start + value.length;
+  requestAnimationFrame(() => {
+    input.focus();
+    input.setSelectionRange(caret, caret);
+  });
+}
+function TemplateVarMenu({
+  field,
+  tokens,
+  menuLabel,
+  header,
+  footer
+}) {
+  const triggerRef = react.useRef(null);
+  const [resolved, setResolved] = react.useState(
+    Array.isArray(tokens) ? tokens : null
+  );
+  const [loading, setLoading] = react.useState(false);
+  const loadOnOpen = (open) => {
+    if (!open || resolved !== null || typeof tokens !== "function") return;
+    const result = tokens();
+    if (result instanceof Promise) {
+      setLoading(true);
+      void result.then((values) => {
+        setResolved(values);
+        setLoading(false);
+      });
+    } else {
+      setResolved(result);
+    }
+  };
+  const items = loading ? [{ label: "Loading…", onSelect: () => {
+  }, disabled: true }] : (resolved ?? []).map((token) => {
+    const { value, label } = normalizeToken(token);
+    return { label, onSelect: () => insertTemplateValue(field, triggerRef.current, value) };
+  });
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    DropdownMenu.DropdownMenu,
+    {
+      align: "left",
+      menuLabel,
+      menuClassName: "font-mono text-xs",
+      items,
+      onOpenChange: loadOnOpen,
+      header,
+      footer,
+      trigger: /* @__PURE__ */ jsxRuntime.jsx(
+        "button",
+        {
+          ref: triggerRef,
+          type: "button",
+          "aria-label": menuLabel,
+          title: menuLabel,
+          className: "flex size-5 items-center justify-center rounded text-muted-foreground hover:bg-accent hover:text-foreground",
+          children: /* @__PURE__ */ jsxRuntime.jsx(Icon.Icon, { icon: UiBraces.UiBraces })
+        }
+      )
+    }
+  );
+}
+exports.TemplateVarMenu = TemplateVarMenu;
+//# sourceMappingURL=json-schema-form-template-menu.cjs.map

package/dist/components/json-schema-form-template-menu.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema-form-template-menu.cjs","sources":["../../src/components/json-schema-form-template-menu.tsx"],"sourcesContent":["import { useRef, useState, type ReactNode } from \"react\";\nimport { Icon } from \"../data/Icon\";\nimport { UiBraces } from \"../icons\";\nimport { DropdownMenu, type DropdownMenuItem } from \"../overlay/DropdownMenu\";\nimport type { FieldControl } from \"./json-schema-form-types\";\n\n// A plain string is both the inserted value and the label; the object form lets a\n// rich ReactNode label display while the plain `value` string is what gets inserted.\nexport type TemplateToken = string | { value: string; label?: ReactNode };\n\n// A static list, or a loader called the first time the menu opens — it may return\n// synchronously or as a Promise (e.g. values fetched from an API).\nexport type TemplateValuesLoader =\n  | readonly TemplateToken[]\n  | (() => readonly TemplateToken[] | Promise<readonly TemplateToken[]>);\n\nfunction normalizeToken(token: TemplateToken): { value: string; label: ReactNode } {\n  return typeof token === \"string\"\n    ? { value: token, label: token }\n    : { value: token.value, label: token.label ?? token.value };\n}\n\n// Splices `value` into the field's text input at the caret, located through the\n// data-jsf-control wrapper that hosts this prefix. Enum/combobox fields own their\n// text state and expose no input[data-jsf-input], so there the value replaces the\n// field value instead of inserting at a caret.\nfunction insertTemplateValue(field: FieldControl, trigger: HTMLElement | null, value: string) {\n  const input = trigger\n    ?.closest(\"[data-jsf-control]\")\n    ?.querySelector<HTMLInputElement>(\"input[data-jsf-input]\");\n  const current = typeof field.value === \"string\" ? field.value : \"\";\n  if (!input) {\n    field.onChange(value);\n    return;\n  }\n  const start = input.selectionStart ?? current.length;\n  const end = input.selectionEnd ?? current.length;\n  field.onChange(current.slice(0, start) + value + current.slice(end));\n  const caret = start + value.length;\n  requestAnimationFrame(() => {\n    input.focus();\n    input.setSelectionRange(caret, caret);\n  });\n}\n\n// A leading `{ }` glyph that opens a separate dropdown of template tokens; picking\n// one inserts its value into the field. Tokens resolve lazily on first open and are\n// cached, so an async loader shows a `Loading…` row until it settles.\nexport function TemplateVarMenu({\n  field,\n  tokens,\n  menuLabel,\n  header,\n  footer,\n}: {\n  field: FieldControl;\n  tokens: TemplateValuesLoader;\n  menuLabel: string;\n  header?: ReactNode;\n  footer?: ReactNode;\n}) {\n  const triggerRef = useRef<HTMLButtonElement>(null);\n  const [resolved, setResolved] = useState<readonly TemplateToken[] | null>(\n    Array.isArray(tokens) ? tokens : null,\n  );\n  const [loading, setLoading] = useState(false);\n\n  const loadOnOpen = (open: boolean) => {\n    if (!open || resolved !== null || typeof tokens !== \"function\") return;\n    const result = tokens();\n    if (result instanceof Promise) {\n      setLoading(true);\n      void result.then((values) => {\n        setResolved(values);\n        setLoading(false);\n      });\n    } else {\n      setResolved(result);\n    }\n  };\n\n  const items: DropdownMenuItem[] = loading\n    ? [{ label: \"Loading…\", onSelect: () => {}, disabled: true }]\n    : (resolved ?? []).map((token) => {\n        const { value, label } = normalizeToken(token);\n        return { label, onSelect: () => insertTemplateValue(field, triggerRef.current, value) };\n      });\n\n  return (\n    <DropdownMenu\n      align=\"left\"\n      menuLabel={menuLabel}\n      menuClassName=\"font-mono text-xs\"\n      items={items}\n      onOpenChange={loadOnOpen}\n      header={header}\n      footer={footer}\n      trigger={\n        <button\n          ref={triggerRef}\n          type=\"button\"\n          aria-label={menuLabel}\n          title={menuLabel}\n          className=\"flex size-5 items-center justify-center rounded text-muted-foreground hover:bg-accent hover:text-foreground\"\n        >\n          <Icon icon={UiBraces} />\n        </button>\n      }\n    />\n  );\n}\n"],"names":["useRef","useState","jsx","DropdownMenu","Icon","UiBraces"],"mappings":";;;;;;;AAgBA,SAAS,eAAe,OAA2D;AACjF,SAAO,OAAO,UAAU,WACpB,EAAE,OAAO,OAAO,OAAO,MAAA,IACvB,EAAE,OAAO,MAAM,OAAO,OAAO,MAAM,SAAS,MAAM,MAAA;AACxD;AAMA,SAAS,oBAAoB,OAAqB,SAA6B,OAAe;;AAC5F,QAAM,SAAQ,wCACV,QAAQ,0BADE,mBAEV,cAAgC;AACpC,QAAM,UAAU,OAAO,MAAM,UAAU,WAAW,MAAM,QAAQ;AAChE,MAAI,CAAC,OAAO;AACV,UAAM,SAAS,KAAK;AACpB;AAAA,EACF;AACA,QAAM,QAAQ,MAAM,kBAAkB,QAAQ;AAC9C,QAAM,MAAM,MAAM,gBAAgB,QAAQ;AAC1C,QAAM,SAAS,QAAQ,MAAM,GAAG,KAAK,IAAI,QAAQ,QAAQ,MAAM,GAAG,CAAC;AACnE,QAAM,QAAQ,QAAQ,MAAM;AAC5B,wBAAsB,MAAM;AAC1B,UAAM,MAAA;AACN,UAAM,kBAAkB,OAAO,KAAK;AAAA,EACtC,CAAC;AACH;AAKO,SAAS,gBAAgB;AAAA,EAC9B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAMG;AACD,QAAM,aAAaA,MAAAA,OAA0B,IAAI;AACjD,QAAM,CAAC,UAAU,WAAW,IAAIC,MAAAA;AAAAA,IAC9B,MAAM,QAAQ,MAAM,IAAI,SAAS;AAAA,EAAA;AAEnC,QAAM,CAAC,SAAS,UAAU,IAAIA,MAAAA,SAAS,KAAK;AAE5C,QAAM,aAAa,CAAC,SAAkB;AACpC,QAAI,CAAC,QAAQ,aAAa,QAAQ,OAAO,WAAW,WAAY;AAChE,UAAM,SAAS,OAAA;AACf,QAAI,kBAAkB,SAAS;AAC7B,iBAAW,IAAI;AACf,WAAK,OAAO,KAAK,CAAC,WAAW;AAC3B,oBAAY,MAAM;AAClB,mBAAW,KAAK;AAAA,MAClB,CAAC;AAAA,IACH,OAAO;AACL,kBAAY,MAAM;AAAA,IACpB;AAAA,EACF;AAEA,QAAM,QAA4B,UAC9B,CAAC,EAAE,OAAO,YAAY,UAAU,MAAM;AAAA,EAAC,GAAG,UAAU,MAAM,KACzD,YAAY,CAAA,GAAI,IAAI,CAAC,UAAU;AAC9B,UAAM,EAAE,OAAO,UAAU,eAAe,KAAK;AAC7C,WAAO,EAAE,OAAO,UAAU,MAAM,oBAAoB,OAAO,WAAW,SAAS,KAAK,EAAA;AAAA,EACtF,CAAC;AAEL,SACEC,2BAAAA;AAAAA,IAACC,aAAAA;AAAAA,IAAA;AAAA,MACC,OAAM;AAAA,MACN;AAAA,MACA,eAAc;AAAA,MACd;AAAA,MACA,cAAc;AAAA,MACd;AAAA,MACA;AAAA,MACA,SACED,2BAAAA;AAAAA,QAAC;AAAA,QAAA;AAAA,UACC,KAAK;AAAA,UACL,MAAK;AAAA,UACL,cAAY;AAAA,UACZ,OAAO;AAAA,UACP,WAAU;AAAA,UAEV,UAAAA,2BAAAA,IAACE,KAAAA,MAAA,EAAK,MAAMC,SAAAA,SAAA,CAAU;AAAA,QAAA;AAAA,MAAA;AAAA,IACxB;AAAA,EAAA;AAIR;;"}

package/dist/components/json-schema-form-template-menu.d.ts

@@ -0,0 +1,15 @@
+import { ReactNode } from 'react';
+import { FieldControl } from './json-schema-form-types';
+export type TemplateToken = string | {
+    value: string;
+    label?: ReactNode;
+};
+export type TemplateValuesLoader = readonly TemplateToken[] | (() => readonly TemplateToken[] | Promise<readonly TemplateToken[]>);
+export declare function TemplateVarMenu({ field, tokens, menuLabel, header, footer, }: {
+    field: FieldControl;
+    tokens: TemplateValuesLoader;
+    menuLabel: string;
+    header?: ReactNode;
+    footer?: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=json-schema-form-template-menu.d.ts.map

package/dist/components/json-schema-form-template-menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema-form-template-menu.d.ts","sourceRoot":"","sources":["../../src/components/json-schema-form-template-menu.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAIzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAI7D,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC;AAI1E,MAAM,MAAM,oBAAoB,GAC5B,SAAS,aAAa,EAAE,GACxB,CAAC,MAAM,SAAS,aAAa,EAAE,GAAG,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC,CAAC,CAAC;AAkCzE,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,MAAM,EACN,SAAS,EACT,MAAM,EACN,MAAM,GACP,EAAE;IACD,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB,2CAkDA"}

package/dist/components/json-schema-form-template-menu.js

@@ -0,0 +1,83 @@
+import { jsx } from "react/jsx-runtime";
+import { useRef, useState } from "react";
+import { Icon } from "../data/Icon.js";
+import { DropdownMenu } from "../overlay/DropdownMenu.js";
+import { UiBraces } from "../icons/components/UiBraces.js";
+function normalizeToken(token) {
+  return typeof token === "string" ? { value: token, label: token } : { value: token.value, label: token.label ?? token.value };
+}
+function insertTemplateValue(field, trigger, value) {
+  var _a;
+  const input = (_a = trigger == null ? void 0 : trigger.closest("[data-jsf-control]")) == null ? void 0 : _a.querySelector("input[data-jsf-input]");
+  const current = typeof field.value === "string" ? field.value : "";
+  if (!input) {
+    field.onChange(value);
+    return;
+  }
+  const start = input.selectionStart ?? current.length;
+  const end = input.selectionEnd ?? current.length;
+  field.onChange(current.slice(0, start) + value + current.slice(end));
+  const caret = start + value.length;
+  requestAnimationFrame(() => {
+    input.focus();
+    input.setSelectionRange(caret, caret);
+  });
+}
+function TemplateVarMenu({
+  field,
+  tokens,
+  menuLabel,
+  header,
+  footer
+}) {
+  const triggerRef = useRef(null);
+  const [resolved, setResolved] = useState(
+    Array.isArray(tokens) ? tokens : null
+  );
+  const [loading, setLoading] = useState(false);
+  const loadOnOpen = (open) => {
+    if (!open || resolved !== null || typeof tokens !== "function") return;
+    const result = tokens();
+    if (result instanceof Promise) {
+      setLoading(true);
+      void result.then((values) => {
+        setResolved(values);
+        setLoading(false);
+      });
+    } else {
+      setResolved(result);
+    }
+  };
+  const items = loading ? [{ label: "Loading…", onSelect: () => {
+  }, disabled: true }] : (resolved ?? []).map((token) => {
+    const { value, label } = normalizeToken(token);
+    return { label, onSelect: () => insertTemplateValue(field, triggerRef.current, value) };
+  });
+  return /* @__PURE__ */ jsx(
+    DropdownMenu,
+    {
+      align: "left",
+      menuLabel,
+      menuClassName: "font-mono text-xs",
+      items,
+      onOpenChange: loadOnOpen,
+      header,
+      footer,
+      trigger: /* @__PURE__ */ jsx(
+        "button",
+        {
+          ref: triggerRef,
+          type: "button",
+          "aria-label": menuLabel,
+          title: menuLabel,
+          className: "flex size-5 items-center justify-center rounded text-muted-foreground hover:bg-accent hover:text-foreground",
+          children: /* @__PURE__ */ jsx(Icon, { icon: UiBraces })
+        }
+      )
+    }
+  );
+}
+export {
+  TemplateVarMenu
+};
+//# sourceMappingURL=json-schema-form-template-menu.js.map

package/dist/components/json-schema-form-template-menu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema-form-template-menu.js","sources":["../../src/components/json-schema-form-template-menu.tsx"],"sourcesContent":["import { useRef, useState, type ReactNode } from \"react\";\nimport { Icon } from \"../data/Icon\";\nimport { UiBraces } from \"../icons\";\nimport { DropdownMenu, type DropdownMenuItem } from \"../overlay/DropdownMenu\";\nimport type { FieldControl } from \"./json-schema-form-types\";\n\n// A plain string is both the inserted value and the label; the object form lets a\n// rich ReactNode label display while the plain `value` string is what gets inserted.\nexport type TemplateToken = string | { value: string; label?: ReactNode };\n\n// A static list, or a loader called the first time the menu opens — it may return\n// synchronously or as a Promise (e.g. values fetched from an API).\nexport type TemplateValuesLoader =\n  | readonly TemplateToken[]\n  | (() => readonly TemplateToken[] | Promise<readonly TemplateToken[]>);\n\nfunction normalizeToken(token: TemplateToken): { value: string; label: ReactNode } {\n  return typeof token === \"string\"\n    ? { value: token, label: token }\n    : { value: token.value, label: token.label ?? token.value };\n}\n\n// Splices `value` into the field's text input at the caret, located through the\n// data-jsf-control wrapper that hosts this prefix. Enum/combobox fields own their\n// text state and expose no input[data-jsf-input], so there the value replaces the\n// field value instead of inserting at a caret.\nfunction insertTemplateValue(field: FieldControl, trigger: HTMLElement | null, value: string) {\n  const input = trigger\n    ?.closest(\"[data-jsf-control]\")\n    ?.querySelector<HTMLInputElement>(\"input[data-jsf-input]\");\n  const current = typeof field.value === \"string\" ? field.value : \"\";\n  if (!input) {\n    field.onChange(value);\n    return;\n  }\n  const start = input.selectionStart ?? current.length;\n  const end = input.selectionEnd ?? current.length;\n  field.onChange(current.slice(0, start) + value + current.slice(end));\n  const caret = start + value.length;\n  requestAnimationFrame(() => {\n    input.focus();\n    input.setSelectionRange(caret, caret);\n  });\n}\n\n// A leading `{ }` glyph that opens a separate dropdown of template tokens; picking\n// one inserts its value into the field. Tokens resolve lazily on first open and are\n// cached, so an async loader shows a `Loading…` row until it settles.\nexport function TemplateVarMenu({\n  field,\n  tokens,\n  menuLabel,\n  header,\n  footer,\n}: {\n  field: FieldControl;\n  tokens: TemplateValuesLoader;\n  menuLabel: string;\n  header?: ReactNode;\n  footer?: ReactNode;\n}) {\n  const triggerRef = useRef<HTMLButtonElement>(null);\n  const [resolved, setResolved] = useState<readonly TemplateToken[] | null>(\n    Array.isArray(tokens) ? tokens : null,\n  );\n  const [loading, setLoading] = useState(false);\n\n  const loadOnOpen = (open: boolean) => {\n    if (!open || resolved !== null || typeof tokens !== \"function\") return;\n    const result = tokens();\n    if (result instanceof Promise) {\n      setLoading(true);\n      void result.then((values) => {\n        setResolved(values);\n        setLoading(false);\n      });\n    } else {\n      setResolved(result);\n    }\n  };\n\n  const items: DropdownMenuItem[] = loading\n    ? [{ label: \"Loading…\", onSelect: () => {}, disabled: true }]\n    : (resolved ?? []).map((token) => {\n        const { value, label } = normalizeToken(token);\n        return { label, onSelect: () => insertTemplateValue(field, triggerRef.current, value) };\n      });\n\n  return (\n    <DropdownMenu\n      align=\"left\"\n      menuLabel={menuLabel}\n      menuClassName=\"font-mono text-xs\"\n      items={items}\n      onOpenChange={loadOnOpen}\n      header={header}\n      footer={footer}\n      trigger={\n        <button\n          ref={triggerRef}\n          type=\"button\"\n          aria-label={menuLabel}\n          title={menuLabel}\n          className=\"flex size-5 items-center justify-center rounded text-muted-foreground hover:bg-accent hover:text-foreground\"\n        >\n          <Icon icon={UiBraces} />\n        </button>\n      }\n    />\n  );\n}\n"],"names":[],"mappings":";;;;;AAgBA,SAAS,eAAe,OAA2D;AACjF,SAAO,OAAO,UAAU,WACpB,EAAE,OAAO,OAAO,OAAO,MAAA,IACvB,EAAE,OAAO,MAAM,OAAO,OAAO,MAAM,SAAS,MAAM,MAAA;AACxD;AAMA,SAAS,oBAAoB,OAAqB,SAA6B,OAAe;;AAC5F,QAAM,SAAQ,wCACV,QAAQ,0BADE,mBAEV,cAAgC;AACpC,QAAM,UAAU,OAAO,MAAM,UAAU,WAAW,MAAM,QAAQ;AAChE,MAAI,CAAC,OAAO;AACV,UAAM,SAAS,KAAK;AACpB;AAAA,EACF;AACA,QAAM,QAAQ,MAAM,kBAAkB,QAAQ;AAC9C,QAAM,MAAM,MAAM,gBAAgB,QAAQ;AAC1C,QAAM,SAAS,QAAQ,MAAM,GAAG,KAAK,IAAI,QAAQ,QAAQ,MAAM,GAAG,CAAC;AACnE,QAAM,QAAQ,QAAQ,MAAM;AAC5B,wBAAsB,MAAM;AAC1B,UAAM,MAAA;AACN,UAAM,kBAAkB,OAAO,KAAK;AAAA,EACtC,CAAC;AACH;AAKO,SAAS,gBAAgB;AAAA,EAC9B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAMG;AACD,QAAM,aAAa,OAA0B,IAAI;AACjD,QAAM,CAAC,UAAU,WAAW,IAAI;AAAA,IAC9B,MAAM,QAAQ,MAAM,IAAI,SAAS;AAAA,EAAA;AAEnC,QAAM,CAAC,SAAS,UAAU,IAAI,SAAS,KAAK;AAE5C,QAAM,aAAa,CAAC,SAAkB;AACpC,QAAI,CAAC,QAAQ,aAAa,QAAQ,OAAO,WAAW,WAAY;AAChE,UAAM,SAAS,OAAA;AACf,QAAI,kBAAkB,SAAS;AAC7B,iBAAW,IAAI;AACf,WAAK,OAAO,KAAK,CAAC,WAAW;AAC3B,oBAAY,MAAM;AAClB,mBAAW,KAAK;AAAA,MAClB,CAAC;AAAA,IACH,OAAO;AACL,kBAAY,MAAM;AAAA,IACpB;AAAA,EACF;AAEA,QAAM,QAA4B,UAC9B,CAAC,EAAE,OAAO,YAAY,UAAU,MAAM;AAAA,EAAC,GAAG,UAAU,MAAM,KACzD,YAAY,CAAA,GAAI,IAAI,CAAC,UAAU;AAC9B,UAAM,EAAE,OAAO,UAAU,eAAe,KAAK;AAC7C,WAAO,EAAE,OAAO,UAAU,MAAM,oBAAoB,OAAO,WAAW,SAAS,KAAK,EAAA;AAAA,EACtF,CAAC;AAEL,SACE;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,OAAM;AAAA,MACN;AAAA,MACA,eAAc;AAAA,MACd;AAAA,MACA,cAAc;AAAA,MACd;AAAA,MACA;AAAA,MACA,SACE;AAAA,QAAC;AAAA,QAAA;AAAA,UACC,KAAK;AAAA,UACL,MAAK;AAAA,UACL,cAAY;AAAA,UACZ,OAAO;AAAA,UACP,WAAU;AAAA,UAEV,UAAA,oBAAC,MAAA,EAAK,MAAM,SAAA,CAAU;AAAA,QAAA;AAAA,MAAA;AAAA,IACxB;AAAA,EAAA;AAIR;"}

package/dist/components/json-schema-form-template.cjs

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const jsxRuntime = require("react/jsx-runtime");
+const jsonSchemaFormTemplateMenu = require("./json-schema-form-template-menu.cjs");
+function templateValuePre(options) {
+  const { tokens, keys, menuLabel = "Insert template value", header, footer } = options;
+  return (field) => {
+    if (field.kind !== "string" && field.kind !== "enum") return field;
+    if (keys && !keys.includes(field.key)) return field;
+    const prefixed = {
+      ...field,
+      prefix: /* @__PURE__ */ jsxRuntime.jsx(jsonSchemaFormTemplateMenu.TemplateVarMenu, { field, tokens, menuLabel, header, footer })
+    };
+    return field.kind === "enum" ? { ...prefixed, allowCustomValue: true } : prefixed;
+  };
+}
+exports.templateValuePre = templateValuePre;
+//# sourceMappingURL=json-schema-form-template.cjs.map

package/dist/components/json-schema-form-template.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema-form-template.cjs","sources":["../../src/components/json-schema-form-template.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport type { FieldControl, PreExtension } from \"./json-schema-form-types\";\nimport { TemplateVarMenu, type TemplateValuesLoader } from \"./json-schema-form-template-menu\";\n\nexport type { TemplateToken, TemplateValuesLoader } from \"./json-schema-form-template-menu\";\n\nexport interface TemplateValueOptions {\n  tokens: TemplateValuesLoader;\n  // Restrict the prefix to these field keys; default = every string/enum field.\n  keys?: string[];\n  // Trigger aria-label and menu label; default \"Insert template value\".\n  menuLabel?: string;\n  // Optional nodes rendered above / below the token list inside the menu (e.g. a\n  // \"Show more…\" link as the footer). The library only positions them.\n  header?: ReactNode;\n  footer?: ReactNode;\n}\n\n// Builds a JsonSchemaForm `pre` extension that hangs the {x} template-value menu off\n// every string/enum field (or only `keys`). Enum fields also opt into\n// allowCustomValue so an inserted token survives outside the option set.\nexport function templateValuePre(options: TemplateValueOptions): PreExtension {\n  const { tokens, keys, menuLabel = \"Insert template value\", header, footer } = options;\n  return (field) => {\n    if (field.kind !== \"string\" && field.kind !== \"enum\") return field;\n    if (keys && !keys.includes(field.key)) return field;\n    const prefixed: FieldControl = {\n      ...field,\n      prefix: (\n        <TemplateVarMenu field={field} tokens={tokens} menuLabel={menuLabel} header={header} footer={footer} />\n      ),\n    };\n    return field.kind === \"enum\" ? { ...prefixed, allowCustomValue: true } : prefixed;\n  };\n}\n"],"names":["jsx","TemplateVarMenu"],"mappings":";;;;AAqBO,SAAS,iBAAiB,SAA6C;AAC5E,QAAM,EAAE,QAAQ,MAAM,YAAY,yBAAyB,QAAQ,WAAW;AAC9E,SAAO,CAAC,UAAU;AAChB,QAAI,MAAM,SAAS,YAAY,MAAM,SAAS,OAAQ,QAAO;AAC7D,QAAI,QAAQ,CAAC,KAAK,SAAS,MAAM,GAAG,EAAG,QAAO;AAC9C,UAAM,WAAyB;AAAA,MAC7B,GAAG;AAAA,MACH,QACEA,2BAAAA,IAACC,2BAAAA,iBAAA,EAAgB,OAAc,QAAgB,WAAsB,QAAgB,OAAA,CAAgB;AAAA,IAAA;AAGzG,WAAO,MAAM,SAAS,SAAS,EAAE,GAAG,UAAU,kBAAkB,SAAS;AAAA,EAC3E;AACF;;"}

package/dist/components/json-schema-form-template.d.ts

@@ -0,0 +1,13 @@
+import { ReactNode } from 'react';
+import { PreExtension } from './json-schema-form-types';
+import { TemplateValuesLoader } from './json-schema-form-template-menu';
+export type { TemplateToken, TemplateValuesLoader } from './json-schema-form-template-menu';
+export interface TemplateValueOptions {
+    tokens: TemplateValuesLoader;
+    keys?: string[];
+    menuLabel?: string;
+    header?: ReactNode;
+    footer?: ReactNode;
+}
+export declare function templateValuePre(options: TemplateValueOptions): PreExtension;
+//# sourceMappingURL=json-schema-form-template.d.ts.map

package/dist/components/json-schema-form-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema-form-template.d.ts","sourceRoot":"","sources":["../../src/components/json-schema-form-template.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAgB,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAmB,KAAK,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAE9F,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAE5F,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,oBAAoB,CAAC;IAE7B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAKD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,oBAAoB,GAAG,YAAY,CAa5E"}

package/dist/components/json-schema-form-template.js

@@ -0,0 +1,18 @@
+import { jsx } from "react/jsx-runtime";
+import { TemplateVarMenu } from "./json-schema-form-template-menu.js";
+function templateValuePre(options) {
+  const { tokens, keys, menuLabel = "Insert template value", header, footer } = options;
+  return (field) => {
+    if (field.kind !== "string" && field.kind !== "enum") return field;
+    if (keys && !keys.includes(field.key)) return field;
+    const prefixed = {
+      ...field,
+      prefix: /* @__PURE__ */ jsx(TemplateVarMenu, { field, tokens, menuLabel, header, footer })
+    };
+    return field.kind === "enum" ? { ...prefixed, allowCustomValue: true } : prefixed;
+  };
+}
+export {
+  templateValuePre
+};
+//# sourceMappingURL=json-schema-form-template.js.map

package/dist/components/json-schema-form-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema-form-template.js","sources":["../../src/components/json-schema-form-template.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport type { FieldControl, PreExtension } from \"./json-schema-form-types\";\nimport { TemplateVarMenu, type TemplateValuesLoader } from \"./json-schema-form-template-menu\";\n\nexport type { TemplateToken, TemplateValuesLoader } from \"./json-schema-form-template-menu\";\n\nexport interface TemplateValueOptions {\n  tokens: TemplateValuesLoader;\n  // Restrict the prefix to these field keys; default = every string/enum field.\n  keys?: string[];\n  // Trigger aria-label and menu label; default \"Insert template value\".\n  menuLabel?: string;\n  // Optional nodes rendered above / below the token list inside the menu (e.g. a\n  // \"Show more…\" link as the footer). The library only positions them.\n  header?: ReactNode;\n  footer?: ReactNode;\n}\n\n// Builds a JsonSchemaForm `pre` extension that hangs the {x} template-value menu off\n// every string/enum field (or only `keys`). Enum fields also opt into\n// allowCustomValue so an inserted token survives outside the option set.\nexport function templateValuePre(options: TemplateValueOptions): PreExtension {\n  const { tokens, keys, menuLabel = \"Insert template value\", header, footer } = options;\n  return (field) => {\n    if (field.kind !== \"string\" && field.kind !== \"enum\") return field;\n    if (keys && !keys.includes(field.key)) return field;\n    const prefixed: FieldControl = {\n      ...field,\n      prefix: (\n        <TemplateVarMenu field={field} tokens={tokens} menuLabel={menuLabel} header={header} footer={footer} />\n      ),\n    };\n    return field.kind === \"enum\" ? { ...prefixed, allowCustomValue: true } : prefixed;\n  };\n}\n"],"names":[],"mappings":";;AAqBO,SAAS,iBAAiB,SAA6C;AAC5E,QAAM,EAAE,QAAQ,MAAM,YAAY,yBAAyB,QAAQ,WAAW;AAC9E,SAAO,CAAC,UAAU;AAChB,QAAI,MAAM,SAAS,YAAY,MAAM,SAAS,OAAQ,QAAO;AAC7D,QAAI,QAAQ,CAAC,KAAK,SAAS,MAAM,GAAG,EAAG,QAAO;AAC9C,UAAM,WAAyB;AAAA,MAC7B,GAAG;AAAA,MACH,QACE,oBAAC,iBAAA,EAAgB,OAAc,QAAgB,WAAsB,QAAgB,OAAA,CAAgB;AAAA,IAAA;AAGzG,WAAO,MAAM,SAAS,SAAS,EAAE,GAAG,UAAU,kBAAkB,SAAS;AAAA,EAC3E;AACF;"}

package/dist/components/json-schema-form-types.d.ts

@@ -26,6 +26,9 @@ export interface JsonSchemaProperty {
     else?: JsonSchemaProperty;
     "x-order"?: string[];
     "x-enum-labels"?: Record<string, string>;
+    "x-enum-icons"?: Record<string, string>;
+    "x-enum-display"?: EnumDisplay;
+    "x-clicky-order"?: number;
     [key: string]: unknown;
 }
 export type JsonSchemaType = "object" | "array" | "string" | "integer" | "number" | "boolean" | "null";
@@ -43,9 +46,11 @@ export interface JsonSchemaObject extends JsonSchemaProperty {
     required?: string[];
     additionalProperties?: boolean | JsonSchemaProperty;
     allOf?: JsonSchemaConditional[];
+    "x-discriminator"?: string;
 }
-export type FieldControlKind = "string" | "number" | "boolean" | "enum" | "date" | "string-map" | "array" | "object";
-export type EnumDisplay = "combobox" | "radio";
+export type FieldControlKind = "string" | "number" | "boolean" | "enum" | "lookup" | "date" | "string-map" | "array" | "object" | "textarea" | "display" | "link";
+export type DisplayVariant = "heading" | "text" | "divider" | "spacer";
+export type EnumDisplay = "combobox" | "radio" | "grid";
 export interface FieldControl {
     key: string;
     kind: FieldControlKind;
@@ -59,6 +64,8 @@ export interface FieldControl {
     labelIcon?: LabelIconSpec;
     options?: FieldOption[];
     allowCustomValue?: boolean;
+    lookup?: LookupDescriptor;
+    loading?: boolean;
     display?: EnumDisplay;
     badge?: string;
     helper?: string;
@@ -66,6 +73,9 @@ export interface FieldControl {
     prefix?: ReactNode;
     minimum?: number;
     coerceNumber?: boolean;
+    unit?: string;
+    displayVariant?: DisplayVariant;
+    href?: string;
     dateFormat?: "date" | "date-time";
     valueSchema?: JsonSchemaProperty;
     valuePatternSchemas?: {
@@ -83,15 +93,37 @@ export interface FieldControl {
 export interface FieldOption {
     value: string;
     label: string;
+    icon?: LabelIconSpec;
 }
+export interface LookupDescriptor {
+    url: string;
+    filter: string;
+    searchParam?: string;
+    multi?: boolean;
+    scope?: LookupScope;
+}
+export interface LookupScope {
+    param: string;
+    from: string;
+    map?: Record<string, string[]>;
+    join?: string;
+}
+export type LookupFetcher = (args: {
+    descriptor: LookupDescriptor;
+    query: string;
+    rootValue?: Record<string, unknown>;
+}) => Promise<FieldOption[]>;
 export type PreExtension = (field: FieldControl, ctx: {
     key: string;
     prop: JsonSchemaProperty;
     value: unknown;
+    rootValue?: Record<string, unknown>;
 }) => FieldControl | null;
 export type PostExtension = (field: FieldControl, nodes: {
     label: ReactNode;
     value: ReactNode;
+}, ctx?: {
+    rootValue?: Record<string, unknown>;
 }) => {
     label: ReactNode;
     value: ReactNode;
@@ -124,6 +156,7 @@ export interface RenderContext {
     sortMode: SortMode;
     pre: PreExtension[];
     post: PostExtension[];
+    rootValue?: Record<string, unknown>;
     depth: number;
     render: RenderApi;
 }
@@ -185,6 +218,12 @@ export interface JsonSchemaFormProps {
     title?: string;
     pre?: PreExtension[];
     post?: PostExtension[];
+    /**
+     * Resolves options for `x-clicky-lookup` fields (async entity-reference
+     * pickers). When set, the form provides it to its lookup controls via context.
+     * Hosts typically build it from the operations api client's lookup endpoint.
+     */
+    lookupFetcher?: LookupFetcher;
     /**
      * Show the top-right three-dot display-options menu (size, layout, and sort).
      * Defaults to true. The menu controls only this form's appearance — never

package/dist/components/json-schema-form-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"json-schema-form-types.d.ts","sourceRoot":"","sources":["../../src/components/json-schema-form-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAK/D,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,cAAc,GAAG,cAAc,EAAE,CAAC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAChD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB,oBAAoB,CAAC,EAAE,OAAO,GAAG,kBAAkB,CAAC;IAKpD,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACvD,KAAK,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAKhC,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC7B,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC7B,EAAE,CAAC,EAAE,kBAAkB,CAAC;IACxB,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAI1B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAGrB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEzC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,SAAS,GACT,MAAM,CAAC;AAQX,MAAM,WAAW,qBAAqB;IACpC,EAAE,CAAC,EAAE,kBAAkB,CAAC;IACxB,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAChD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,GAAG,kBAAkB,CAAC;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAKD,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;IAC1D,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAChD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,GAAG,kBAAkB,CAAC;IACpD,KAAK,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACjC;AAED,MAAM,MAAM,gBAAgB,GACxB,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,MAAM,GACN,MAAM,GACN,YAAY,GACZ,OAAO,GACP,QAAQ,CAAC;AAIb,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC;AAM/C,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAMlC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAGnB,SAAS,CAAC,EAAE,aAAa,CAAC;IAG1B,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IAGxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAG3B,OAAO,CAAC,EAAE,WAAW,CAAC;IAGtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAOhB,MAAM,CAAC,EAAE,SAAS,CAAC;IAOnB,MAAM,CAAC,EAAE,SAAS,CAAC;IAGnB,OAAO,CAAC,EAAE,MAAM,CAAC;IAIjB,YAAY,CAAC,EAAE,OAAO,CAAC;IAIvB,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAGlC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IAIjC,mBAAmB,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,kBAAkB,CAAA;KAAE,EAAE,CAAC;IACxE,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACrD,cAAc,CAAC,EAAE,OAAO,CAAC;IAIzB,UAAU,CAAC,EAAE,WAAW,EAAE,CAAC;IAM3B,MAAM,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;IAGtC,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAGhC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACtD,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAID,MAAM,MAAM,YAAY,GAAG,CACzB,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,kBAAkB,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,KAC3D,YAAY,GAAG,IAAI,CAAC;AAIzB,MAAM,MAAM,aAAa,GAAG,CAC1B,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,KAC1C;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC;AAI5C,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,kBAAkB,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACnC;AAOD,MAAM,WAAW,SAAS;IACxB,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,GAAG;QAAE,KAAK,EAAE,SAAS,CAAC;QAAC,KAAK,EAAE,SAAS,CAAA;KAAE,GAAG,IAAI,CAAC;IACrG,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,GAAG,IAAI,CAAC;IACzG,kBAAkB,CAChB,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,EACjD,GAAG,EAAE,aAAa,EAClB,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAC/B,SAAS,EAAE,CAAC;CAChB;AAMD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAGlB,kBAAkB,EAAE,OAAO,CAAC;IAE5B,MAAM,EAAE,UAAU,CAAC;IAEnB,IAAI,EAAE,QAAQ,CAAC;IAGf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAIlB,QAAQ,EAAE,QAAQ,CAAC;IACnB,GAAG,EAAE,YAAY,EAAE,CAAC;IACpB,IAAI,EAAE,aAAa,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IAEd,MAAM,EAAE,SAAS,CAAC;CACnB;AAKD,MAAM,WAAW,UAAU;IACzB,sEAAsE;IACtE,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC3B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAClD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB;;;OAGG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,YAAY,EAAE,CAAC;IACrB,IAAI,CAAC,EAAE,aAAa,EAAE,CAAC;IACvB;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC"}
+{"version":3,"file":"json-schema-form-types.d.ts","sourceRoot":"","sources":["../../src/components/json-schema-form-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAK/D,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,cAAc,GAAG,cAAc,EAAE,CAAC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAChD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB,oBAAoB,CAAC,EAAE,OAAO,GAAG,kBAAkB,CAAC;IAKpD,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACvD,KAAK,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAKhC,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC7B,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC7B,EAAE,CAAC,EAAE,kBAAkB,CAAC;IACxB,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAI1B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAGrB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAIzC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAExC,gBAAgB,CAAC,EAAE,WAAW,CAAC;IAK/B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,SAAS,GACT,MAAM,CAAC;AAQX,MAAM,WAAW,qBAAqB;IACpC,EAAE,CAAC,EAAE,kBAAkB,CAAC;IACxB,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAChD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,GAAG,kBAAkB,CAAC;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAKD,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;IAC1D,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAChD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,GAAG,kBAAkB,CAAC;IACpD,KAAK,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAKhC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,MAAM,gBAAgB,GACxB,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,MAAM,GAGN,QAAQ,GACR,MAAM,GACN,YAAY,GACZ,OAAO,GACP,QAAQ,GAGR,UAAU,GAIV,SAAS,GAET,MAAM,CAAC;AAKX,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;AAKvE,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;AAMxD,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAMlC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAGnB,SAAS,CAAC,EAAE,aAAa,CAAC;IAG1B,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IAGxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAK3B,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAE1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAGlB,OAAO,CAAC,EAAE,WAAW,CAAC;IAGtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAOhB,MAAM,CAAC,EAAE,SAAS,CAAC;IAOnB,MAAM,CAAC,EAAE,SAAS,CAAC;IAGnB,OAAO,CAAC,EAAE,MAAM,CAAC;IAIjB,YAAY,CAAC,EAAE,OAAO,CAAC;IAIvB,IAAI,CAAC,EAAE,MAAM,CAAC;IAGd,cAAc,CAAC,EAAE,cAAc,CAAC;IAIhC,IAAI,CAAC,EAAE,MAAM,CAAC;IAId,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAGlC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IAIjC,mBAAmB,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,kBAAkB,CAAA;KAAE,EAAE,CAAC;IACxE,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACrD,cAAc,CAAC,EAAE,OAAO,CAAC;IAIzB,UAAU,CAAC,EAAE,WAAW,EAAE,CAAC;IAM3B,MAAM,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;IAGtC,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAGhC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACtD,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IAGd,IAAI,CAAC,EAAE,aAAa,CAAC;CACtB;AAMD,MAAM,WAAW,gBAAgB;IAE/B,GAAG,EAAE,MAAM,CAAC;IAGZ,MAAM,EAAE,MAAM,CAAC;IAGf,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAGhB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAID,MAAM,WAAW,WAAW;IAE1B,KAAK,EAAE,MAAM,CAAC;IAEd,IAAI,EAAE,MAAM,CAAC;IAGb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAE/B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAMD,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE;IACjC,UAAU,EAAE,gBAAgB,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;AAM7B,MAAM,MAAM,YAAY,GAAG,CACzB,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE;IACH,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,kBAAkB,CAAC;IACzB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC,KACE,YAAY,GAAG,IAAI,CAAC;AAMzB,MAAM,MAAM,aAAa,GAAG,CAC1B,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,EAC7C,GAAG,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,KAC1C;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC;AAI5C,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,kBAAkB,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACnC;AAOD,MAAM,WAAW,SAAS;IACxB,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,GAAG;QAAE,KAAK,EAAE,SAAS,CAAC;QAAC,KAAK,EAAE,SAAS,CAAA;KAAE,GAAG,IAAI,CAAC;IACrG,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,GAAG,IAAI,CAAC;IACzG,kBAAkB,CAChB,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,EACjD,GAAG,EAAE,aAAa,EAClB,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAC/B,SAAS,EAAE,CAAC;CAChB;AAMD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAGlB,kBAAkB,EAAE,OAAO,CAAC;IAE5B,MAAM,EAAE,UAAU,CAAC;IAEnB,IAAI,EAAE,QAAQ,CAAC;IAGf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAIlB,QAAQ,EAAE,QAAQ,CAAC;IACnB,GAAG,EAAE,YAAY,EAAE,CAAC;IACpB,IAAI,EAAE,aAAa,EAAE,CAAC;IAGtB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC;IAEd,MAAM,EAAE,SAAS,CAAC;CACnB;AAKD,MAAM,WAAW,UAAU;IACzB,sEAAsE;IACtE,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC3B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAClD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB;;;OAGG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,YAAY,EAAE,CAAC;IACrB,IAAI,CAAC,EAAE,aAAa,EAAE,CAAC;IACvB;;;;OAIG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC"}

package/dist/components/json-schema-form-utils.cjs

@@ -39,6 +39,13 @@ function orderByXOrder(entries, order) {
   const rest = entries.filter(([key]) => !rank.has(key));
   return [...listed, ...rest];
 }
+function orderByClickyOrder(entries) {
+  const rank = (prop) => {
+    const o = prop["x-clicky-order"];
+    return typeof o === "number" ? o : Number.POSITIVE_INFINITY;
+  };
+  return entries.map((entry, index) => ({ entry, index, rank: rank(entry[1]) })).sort((a, b) => a.rank - b.rank || a.index - b.index).map((ranked) => ranked.entry);
+}
 function orderRequiredFirst(entries, required) {
   const isRequired = new Set(required);
   const head = entries.filter(([key]) => isRequired.has(key));
@@ -97,6 +104,7 @@ exports.isEmptyValue = isEmptyValue;
 exports.isPlainObject = isPlainObject;
 exports.keyPickerOptions = keyPickerOptions;
 exports.moveItem = moveItem;
+exports.orderByClickyOrder = orderByClickyOrder;
 exports.orderByPriority = orderByPriority;
 exports.orderByXOrder = orderByXOrder;
 exports.orderRequiredFirst = orderRequiredFirst;

package/dist/components/json-schema-form-utils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"json-schema-form-utils.cjs","sources":["../../src/components/json-schema-form-utils.ts"],"sourcesContent":["import { cn } from \"../lib/utils\";\nimport { inputSizeClass, type FormSize } from \"./json-schema-form-size\";\nimport type { FieldControl, FieldOption, JsonSchemaProperty } from \"./json-schema-form-types\";\n\n// Non-size styling shared by every text-like input box; the size token supplies\n// height, horizontal padding, and text size (see inputSizeClass).\nconst INPUT_BASE =\n  \"w-full min-w-0 rounded-md border border-input bg-background text-foreground outline-none placeholder:text-muted-foreground disabled:cursor-not-allowed disabled:bg-muted/40 focus-visible:ring-2 focus-visible:ring-ring\";\n\nexport function inputClass(size: FormSize): string {\n  return cn(INPUT_BASE, inputSizeClass[size]);\n}\n\nexport function fieldInputId(key: string, prefix?: string): string {\n  const safe = key.replace(/[^a-zA-Z0-9_-]/g, \"_\");\n  return prefix ? `jsf-${prefix}-${safe}` : `jsf-${safe}`;\n}\n\nexport function defaultPlaceholder(schema: JsonSchemaProperty): string {\n  if (schema.default != null && typeof schema.default !== \"object\") return String(schema.default);\n  return \"\";\n}\n\nexport function toText(value: unknown): string {\n  if (value === undefined || value === null) return \"\";\n  if (typeof value === \"object\") return \"\";\n  return String(value);\n}\n\nexport function isPlainObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n// withSyntheticValue prepends the current value as an option when it is not in\n// the enum, so an out-of-enum value (e.g. a template token) still displays.\nexport function withSyntheticValue(options: FieldOption[], value: string): FieldOption[] {\n  if (!value || options.some((o) => o.value === value)) return options;\n  return [{ value, label: value }, ...options];\n}\n\n// keyPickerOptions narrows the map-key enum to keys not already used by another\n// entry, while always keeping this row's current key so it stays selectable.\nexport function keyPickerOptions(\n  options: FieldOption[],\n  usedKeys: string[],\n  currentKey: string,\n): FieldOption[] {\n  const taken = new Set(usedKeys.filter((k) => k !== currentKey));\n  return options.filter((o) => !taken.has(o.value));\n}\n\n// orderByXOrder reorders property entries by the schema's `x-order` hint: keys\n// named there render first (in that order), the rest keep document order. A\n// missing/empty hint is a no-op, so document order remains the default.\nexport function orderByXOrder<T>(entries: [string, T][], order: unknown): [string, T][] {\n  if (!Array.isArray(order) || order.length === 0) return entries;\n  const rank = new Map(\n    order.filter((k): k is string => typeof k === \"string\").map((k, i) => [k, i]),\n  );\n  const listed = entries\n    .filter(([key]) => rank.has(key))\n    .sort((a, b) => rank.get(a[0])! - rank.get(b[0])!);\n  const rest = entries.filter(([key]) => !rank.has(key));\n  return [...listed, ...rest];\n}\n\n// orderRequiredFirst stably partitions property entries so the keys named in\n// `required` come first (in their original order), then the rest (in theirs).\n// A stable two-pass partition, so it never reshuffles within either group.\nexport function orderRequiredFirst<T>(\n  entries: [string, T][],\n  required: string[],\n): [string, T][] {\n  const isRequired = new Set(required);\n  const head = entries.filter(([key]) => isRequired.has(key));\n  const tail = entries.filter(([key]) => !isRequired.has(key));\n  return [...head, ...tail];\n}\n\n// isEmptyValue reports whether a field's value carries no data, so priority\n// sorting can sink unfilled fields. Empty = undefined/null/\"\" plus empty arrays\n// and empty plain objects; `false` and `0` count as filled (they are choices).\nexport function isEmptyValue(value: unknown): boolean {\n  if (value === undefined || value === null || value === \"\") return true;\n  if (Array.isArray(value)) return value.length === 0;\n  if (typeof value === \"object\") return Object.keys(value).length === 0;\n  return false;\n}\n\n// orderByPriority sorts property entries so the fields that matter most surface\n// first, ranking each by a score: +2 if required, +1 if its value is non-empty.\n// Required-and-filled lead, then required-and-empty, then optional-and-filled,\n// then optional-and-empty. Ties keep their incoming order (explicit index\n// tie-break, so it does not depend on the engine's sort stability).\nexport function orderByPriority<T>(\n  entries: [string, T][],\n  required: string[],\n  values: Record<string, unknown>,\n): [string, T][] {\n  const isRequired = new Set(required);\n  const score = (key: string): number =>\n    (isRequired.has(key) ? 2 : 0) + (isEmptyValue(values[key]) ? 0 : 1);\n  return entries\n    .map((entry, index) => ({ entry, index, score: score(entry[0]) }))\n    .sort((a, b) => b.score - a.score || a.index - b.index)\n    .map((ranked) => ranked.entry);\n}\n\n// softError computes a display-only validation hint. It never blocks onChange.\n// Consumers suppress the unknown-enum hint by setting allowCustomValue.\nexport function softError(field: FieldControl): string | undefined {\n  const v = field.value;\n  const isEmpty = v === undefined || v === null || v === \"\";\n  if (field.required && isEmpty) return \"Required\";\n\n  if (field.kind === \"number\" && typeof field.minimum === \"number\" && typeof v === \"number\") {\n    if (v < field.minimum) return `Must be ≥ ${field.minimum}`;\n  }\n\n  if (field.kind === \"enum\" && !field.allowCustomValue && !isEmpty) {\n    const known = (field.options ?? []).some((o) => o.value === String(v));\n    if (!known) return \"Unknown value (allowed)\";\n  }\n  return undefined;\n}\n\n// Immutable array helpers used by the array control.\nexport function setIndex<T>(arr: T[], i: number, v: T): T[] {\n  return arr.map((x, idx) => (idx === i ? v : x));\n}\n\nexport function removeIndex<T>(arr: T[], i: number): T[] {\n  return arr.filter((_, idx) => idx !== i);\n}\n\nexport function moveItem<T>(arr: T[], from: number, to: number): T[] {\n  if (to < 0 || to >= arr.length) return arr;\n  const next = [...arr];\n  const [moved] = next.splice(from, 1);\n  next.splice(to, 0, moved as T);\n  return next;\n}\n\n// seedFromSchema produces the initial value for a freshly-added array item or\n// object field, honouring an explicit default.\nexport function seedFromSchema(schema: JsonSchemaProperty): unknown {\n  if (schema.default !== undefined) return schema.default;\n  const type = Array.isArray(schema.type) ? schema.type[0] : schema.type;\n  if (type === \"array\") return [];\n  if (type === \"object\") return {};\n  if (type === \"boolean\") return false;\n  // Numbers seed as \"\" so the soft Required hint can show without coercion\n  // surprises; the number control coerces on first real input.\n  return \"\";\n}\n"],"names":["cn","inputSizeClass"],"mappings":"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"}
+{"version":3,"file":"json-schema-form-utils.cjs","sources":["../../src/components/json-schema-form-utils.ts"],"sourcesContent":["import { cn } from \"../lib/utils\";\nimport { inputSizeClass, type FormSize } from \"./json-schema-form-size\";\nimport type { FieldControl, FieldOption, JsonSchemaProperty } from \"./json-schema-form-types\";\n\n// Non-size styling shared by every text-like input box; the size token supplies\n// height, horizontal padding, and text size (see inputSizeClass).\nconst INPUT_BASE =\n  \"w-full min-w-0 rounded-md border border-input bg-background text-foreground outline-none placeholder:text-muted-foreground disabled:cursor-not-allowed disabled:bg-muted/40 focus-visible:ring-2 focus-visible:ring-ring\";\n\nexport function inputClass(size: FormSize): string {\n  return cn(INPUT_BASE, inputSizeClass[size]);\n}\n\nexport function fieldInputId(key: string, prefix?: string): string {\n  const safe = key.replace(/[^a-zA-Z0-9_-]/g, \"_\");\n  return prefix ? `jsf-${prefix}-${safe}` : `jsf-${safe}`;\n}\n\nexport function defaultPlaceholder(schema: JsonSchemaProperty): string {\n  if (schema.default != null && typeof schema.default !== \"object\") return String(schema.default);\n  return \"\";\n}\n\nexport function toText(value: unknown): string {\n  if (value === undefined || value === null) return \"\";\n  if (typeof value === \"object\") return \"\";\n  return String(value);\n}\n\nexport function isPlainObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n// withSyntheticValue prepends the current value as an option when it is not in\n// the enum, so an out-of-enum value (e.g. a template token) still displays.\nexport function withSyntheticValue(options: FieldOption[], value: string): FieldOption[] {\n  if (!value || options.some((o) => o.value === value)) return options;\n  return [{ value, label: value }, ...options];\n}\n\n// keyPickerOptions narrows the map-key enum to keys not already used by another\n// entry, while always keeping this row's current key so it stays selectable.\nexport function keyPickerOptions(\n  options: FieldOption[],\n  usedKeys: string[],\n  currentKey: string,\n): FieldOption[] {\n  const taken = new Set(usedKeys.filter((k) => k !== currentKey));\n  return options.filter((o) => !taken.has(o.value));\n}\n\n// orderByXOrder reorders property entries by the schema's `x-order` hint: keys\n// named there render first (in that order), the rest keep document order. A\n// missing/empty hint is a no-op, so document order remains the default.\nexport function orderByXOrder<T>(entries: [string, T][], order: unknown): [string, T][] {\n  if (!Array.isArray(order) || order.length === 0) return entries;\n  const rank = new Map(\n    order.filter((k): k is string => typeof k === \"string\").map((k, i) => [k, i]),\n  );\n  const listed = entries\n    .filter(([key]) => rank.has(key))\n    .sort((a, b) => rank.get(a[0])! - rank.get(b[0])!);\n  const rest = entries.filter(([key]) => !rank.has(key));\n  return [...listed, ...rest];\n}\n\n// orderByClickyOrder stably sorts property entries by each property's numeric\n// `x-clicky-order` (lower first); entries without it keep their incoming order\n// after the ordered ones. An explicit index tie-break keeps it stable regardless\n// of the engine's sort stability. Unlike the object-level `x-order` array, this\n// composes across merged if/then branches because each property carries its own\n// order — the right tool when fields come from different (embedded) sources.\nexport function orderByClickyOrder(\n  entries: [string, JsonSchemaProperty][],\n): [string, JsonSchemaProperty][] {\n  const rank = (prop: JsonSchemaProperty): number => {\n    const o = prop[\"x-clicky-order\"];\n    return typeof o === \"number\" ? o : Number.POSITIVE_INFINITY;\n  };\n  return entries\n    .map((entry, index) => ({ entry, index, rank: rank(entry[1]) }))\n    .sort((a, b) => a.rank - b.rank || a.index - b.index)\n    .map((ranked) => ranked.entry);\n}\n\n// orderRequiredFirst stably partitions property entries so the keys named in\n// `required` come first (in their original order), then the rest (in theirs).\n// A stable two-pass partition, so it never reshuffles within either group.\nexport function orderRequiredFirst<T>(\n  entries: [string, T][],\n  required: string[],\n): [string, T][] {\n  const isRequired = new Set(required);\n  const head = entries.filter(([key]) => isRequired.has(key));\n  const tail = entries.filter(([key]) => !isRequired.has(key));\n  return [...head, ...tail];\n}\n\n// isEmptyValue reports whether a field's value carries no data, so priority\n// sorting can sink unfilled fields. Empty = undefined/null/\"\" plus empty arrays\n// and empty plain objects; `false` and `0` count as filled (they are choices).\nexport function isEmptyValue(value: unknown): boolean {\n  if (value === undefined || value === null || value === \"\") return true;\n  if (Array.isArray(value)) return value.length === 0;\n  if (typeof value === \"object\") return Object.keys(value).length === 0;\n  return false;\n}\n\n// orderByPriority sorts property entries so the fields that matter most surface\n// first, ranking each by a score: +2 if required, +1 if its value is non-empty.\n// Required-and-filled lead, then required-and-empty, then optional-and-filled,\n// then optional-and-empty. Ties keep their incoming order (explicit index\n// tie-break, so it does not depend on the engine's sort stability).\nexport function orderByPriority<T>(\n  entries: [string, T][],\n  required: string[],\n  values: Record<string, unknown>,\n): [string, T][] {\n  const isRequired = new Set(required);\n  const score = (key: string): number =>\n    (isRequired.has(key) ? 2 : 0) + (isEmptyValue(values[key]) ? 0 : 1);\n  return entries\n    .map((entry, index) => ({ entry, index, score: score(entry[0]) }))\n    .sort((a, b) => b.score - a.score || a.index - b.index)\n    .map((ranked) => ranked.entry);\n}\n\n// softError computes a display-only validation hint. It never blocks onChange.\n// Consumers suppress the unknown-enum hint by setting allowCustomValue.\nexport function softError(field: FieldControl): string | undefined {\n  const v = field.value;\n  const isEmpty = v === undefined || v === null || v === \"\";\n  if (field.required && isEmpty) return \"Required\";\n\n  if (field.kind === \"number\" && typeof field.minimum === \"number\" && typeof v === \"number\") {\n    if (v < field.minimum) return `Must be ≥ ${field.minimum}`;\n  }\n\n  if (field.kind === \"enum\" && !field.allowCustomValue && !isEmpty) {\n    const known = (field.options ?? []).some((o) => o.value === String(v));\n    if (!known) return \"Unknown value (allowed)\";\n  }\n  return undefined;\n}\n\n// Immutable array helpers used by the array control.\nexport function setIndex<T>(arr: T[], i: number, v: T): T[] {\n  return arr.map((x, idx) => (idx === i ? v : x));\n}\n\nexport function removeIndex<T>(arr: T[], i: number): T[] {\n  return arr.filter((_, idx) => idx !== i);\n}\n\nexport function moveItem<T>(arr: T[], from: number, to: number): T[] {\n  if (to < 0 || to >= arr.length) return arr;\n  const next = [...arr];\n  const [moved] = next.splice(from, 1);\n  next.splice(to, 0, moved as T);\n  return next;\n}\n\n// seedFromSchema produces the initial value for a freshly-added array item or\n// object field, honouring an explicit default.\nexport function seedFromSchema(schema: JsonSchemaProperty): unknown {\n  if (schema.default !== undefined) return schema.default;\n  const type = Array.isArray(schema.type) ? schema.type[0] : schema.type;\n  if (type === \"array\") return [];\n  if (type === \"object\") return {};\n  if (type === \"boolean\") return false;\n  // Numbers seed as \"\" so the soft Required hint can show without coercion\n  // surprises; the number control coerces on first real input.\n  return \"\";\n}\n"],"names":["cn","inputSizeClass"],"mappings":"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"}

package/dist/components/json-schema-form-utils.d.ts

@@ -8,6 +8,7 @@ export declare function isPlainObject(value: unknown): value is Record<string, u
 export declare function withSyntheticValue(options: FieldOption[], value: string): FieldOption[];
 export declare function keyPickerOptions(options: FieldOption[], usedKeys: string[], currentKey: string): FieldOption[];
 export declare function orderByXOrder<T>(entries: [string, T][], order: unknown): [string, T][];
+export declare function orderByClickyOrder(entries: [string, JsonSchemaProperty][]): [string, JsonSchemaProperty][];
 export declare function orderRequiredFirst<T>(entries: [string, T][], required: string[]): [string, T][];
 export declare function isEmptyValue(value: unknown): boolean;
 export declare function orderByPriority<T>(entries: [string, T][], required: string[], values: Record<string, unknown>): [string, T][];

package/dist/components/json-schema-form-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"json-schema-form-utils.d.ts","sourceRoot":"","sources":["../../src/components/json-schema-form-utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAO9F,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAEjD;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAGjE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAGrE;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAI7C;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE9E;AAID,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE,CAGvF;AAID,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,WAAW,EAAE,EACtB,QAAQ,EAAE,MAAM,EAAE,EAClB,UAAU,EAAE,MAAM,GACjB,WAAW,EAAE,CAGf;AAKD,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAUtF;AAKD,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EACtB,QAAQ,EAAE,MAAM,EAAE,GACjB,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAKf;AAKD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKpD;AAOD,wBAAgB,eAAe,CAAC,CAAC,EAC/B,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EACtB,QAAQ,EAAE,MAAM,EAAE,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAQf;AAID,wBAAgB,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAcjE;AAGD,wBAAgB,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAE1D;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE,CAEvD;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,EAAE,CAMnE;AAID,wBAAgB,cAAc,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CASlE"}
+{"version":3,"file":"json-schema-form-utils.d.ts","sourceRoot":"","sources":["../../src/components/json-schema-form-utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAO9F,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAEjD;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAGjE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAGrE;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAI7C;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE9E;AAID,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE,CAGvF;AAID,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,WAAW,EAAE,EACtB,QAAQ,EAAE,MAAM,EAAE,EAClB,UAAU,EAAE,MAAM,GACjB,WAAW,EAAE,CAGf;AAKD,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAUtF;AAQD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,CAAC,MAAM,EAAE,kBAAkB,CAAC,EAAE,GACtC,CAAC,MAAM,EAAE,kBAAkB,CAAC,EAAE,CAShC;AAKD,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EACtB,QAAQ,EAAE,MAAM,EAAE,GACjB,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAKf;AAKD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKpD;AAOD,wBAAgB,eAAe,CAAC,CAAC,EAC/B,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EACtB,QAAQ,EAAE,MAAM,EAAE,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAQf;AAID,wBAAgB,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAcjE;AAGD,wBAAgB,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAE1D;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE,CAEvD;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,EAAE,CAMnE;AAID,wBAAgB,cAAc,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CASlE"}

package/dist/components/json-schema-form-utils.js

@@ -37,6 +37,13 @@ function orderByXOrder(entries, order) {
   const rest = entries.filter(([key]) => !rank.has(key));
   return [...listed, ...rest];
 }
+function orderByClickyOrder(entries) {
+  const rank = (prop) => {
+    const o = prop["x-clicky-order"];
+    return typeof o === "number" ? o : Number.POSITIVE_INFINITY;
+  };
+  return entries.map((entry, index) => ({ entry, index, rank: rank(entry[1]) })).sort((a, b) => a.rank - b.rank || a.index - b.index).map((ranked) => ranked.entry);
+}
 function orderRequiredFirst(entries, required) {
   const isRequired = new Set(required);
   const head = entries.filter(([key]) => isRequired.has(key));
@@ -96,6 +103,7 @@ export {
   isPlainObject,
   keyPickerOptions,
   moveItem,
+  orderByClickyOrder,
   orderByPriority,
   orderByXOrder,
   orderRequiredFirst,

package/dist/components/json-schema-form-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"json-schema-form-utils.js","sources":["../../src/components/json-schema-form-utils.ts"],"sourcesContent":["import { cn } from \"../lib/utils\";\nimport { inputSizeClass, type FormSize } from \"./json-schema-form-size\";\nimport type { FieldControl, FieldOption, JsonSchemaProperty } from \"./json-schema-form-types\";\n\n// Non-size styling shared by every text-like input box; the size token supplies\n// height, horizontal padding, and text size (see inputSizeClass).\nconst INPUT_BASE =\n  \"w-full min-w-0 rounded-md border border-input bg-background text-foreground outline-none placeholder:text-muted-foreground disabled:cursor-not-allowed disabled:bg-muted/40 focus-visible:ring-2 focus-visible:ring-ring\";\n\nexport function inputClass(size: FormSize): string {\n  return cn(INPUT_BASE, inputSizeClass[size]);\n}\n\nexport function fieldInputId(key: string, prefix?: string): string {\n  const safe = key.replace(/[^a-zA-Z0-9_-]/g, \"_\");\n  return prefix ? `jsf-${prefix}-${safe}` : `jsf-${safe}`;\n}\n\nexport function defaultPlaceholder(schema: JsonSchemaProperty): string {\n  if (schema.default != null && typeof schema.default !== \"object\") return String(schema.default);\n  return \"\";\n}\n\nexport function toText(value: unknown): string {\n  if (value === undefined || value === null) return \"\";\n  if (typeof value === \"object\") return \"\";\n  return String(value);\n}\n\nexport function isPlainObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n// withSyntheticValue prepends the current value as an option when it is not in\n// the enum, so an out-of-enum value (e.g. a template token) still displays.\nexport function withSyntheticValue(options: FieldOption[], value: string): FieldOption[] {\n  if (!value || options.some((o) => o.value === value)) return options;\n  return [{ value, label: value }, ...options];\n}\n\n// keyPickerOptions narrows the map-key enum to keys not already used by another\n// entry, while always keeping this row's current key so it stays selectable.\nexport function keyPickerOptions(\n  options: FieldOption[],\n  usedKeys: string[],\n  currentKey: string,\n): FieldOption[] {\n  const taken = new Set(usedKeys.filter((k) => k !== currentKey));\n  return options.filter((o) => !taken.has(o.value));\n}\n\n// orderByXOrder reorders property entries by the schema's `x-order` hint: keys\n// named there render first (in that order), the rest keep document order. A\n// missing/empty hint is a no-op, so document order remains the default.\nexport function orderByXOrder<T>(entries: [string, T][], order: unknown): [string, T][] {\n  if (!Array.isArray(order) || order.length === 0) return entries;\n  const rank = new Map(\n    order.filter((k): k is string => typeof k === \"string\").map((k, i) => [k, i]),\n  );\n  const listed = entries\n    .filter(([key]) => rank.has(key))\n    .sort((a, b) => rank.get(a[0])! - rank.get(b[0])!);\n  const rest = entries.filter(([key]) => !rank.has(key));\n  return [...listed, ...rest];\n}\n\n// orderRequiredFirst stably partitions property entries so the keys named in\n// `required` come first (in their original order), then the rest (in theirs).\n// A stable two-pass partition, so it never reshuffles within either group.\nexport function orderRequiredFirst<T>(\n  entries: [string, T][],\n  required: string[],\n): [string, T][] {\n  const isRequired = new Set(required);\n  const head = entries.filter(([key]) => isRequired.has(key));\n  const tail = entries.filter(([key]) => !isRequired.has(key));\n  return [...head, ...tail];\n}\n\n// isEmptyValue reports whether a field's value carries no data, so priority\n// sorting can sink unfilled fields. Empty = undefined/null/\"\" plus empty arrays\n// and empty plain objects; `false` and `0` count as filled (they are choices).\nexport function isEmptyValue(value: unknown): boolean {\n  if (value === undefined || value === null || value === \"\") return true;\n  if (Array.isArray(value)) return value.length === 0;\n  if (typeof value === \"object\") return Object.keys(value).length === 0;\n  return false;\n}\n\n// orderByPriority sorts property entries so the fields that matter most surface\n// first, ranking each by a score: +2 if required, +1 if its value is non-empty.\n// Required-and-filled lead, then required-and-empty, then optional-and-filled,\n// then optional-and-empty. Ties keep their incoming order (explicit index\n// tie-break, so it does not depend on the engine's sort stability).\nexport function orderByPriority<T>(\n  entries: [string, T][],\n  required: string[],\n  values: Record<string, unknown>,\n): [string, T][] {\n  const isRequired = new Set(required);\n  const score = (key: string): number =>\n    (isRequired.has(key) ? 2 : 0) + (isEmptyValue(values[key]) ? 0 : 1);\n  return entries\n    .map((entry, index) => ({ entry, index, score: score(entry[0]) }))\n    .sort((a, b) => b.score - a.score || a.index - b.index)\n    .map((ranked) => ranked.entry);\n}\n\n// softError computes a display-only validation hint. It never blocks onChange.\n// Consumers suppress the unknown-enum hint by setting allowCustomValue.\nexport function softError(field: FieldControl): string | undefined {\n  const v = field.value;\n  const isEmpty = v === undefined || v === null || v === \"\";\n  if (field.required && isEmpty) return \"Required\";\n\n  if (field.kind === \"number\" && typeof field.minimum === \"number\" && typeof v === \"number\") {\n    if (v < field.minimum) return `Must be ≥ ${field.minimum}`;\n  }\n\n  if (field.kind === \"enum\" && !field.allowCustomValue && !isEmpty) {\n    const known = (field.options ?? []).some((o) => o.value === String(v));\n    if (!known) return \"Unknown value (allowed)\";\n  }\n  return undefined;\n}\n\n// Immutable array helpers used by the array control.\nexport function setIndex<T>(arr: T[], i: number, v: T): T[] {\n  return arr.map((x, idx) => (idx === i ? v : x));\n}\n\nexport function removeIndex<T>(arr: T[], i: number): T[] {\n  return arr.filter((_, idx) => idx !== i);\n}\n\nexport function moveItem<T>(arr: T[], from: number, to: number): T[] {\n  if (to < 0 || to >= arr.length) return arr;\n  const next = [...arr];\n  const [moved] = next.splice(from, 1);\n  next.splice(to, 0, moved as T);\n  return next;\n}\n\n// seedFromSchema produces the initial value for a freshly-added array item or\n// object field, honouring an explicit default.\nexport function seedFromSchema(schema: JsonSchemaProperty): unknown {\n  if (schema.default !== undefined) return schema.default;\n  const type = Array.isArray(schema.type) ? schema.type[0] : schema.type;\n  if (type === \"array\") return [];\n  if (type === \"object\") return {};\n  if (type === \"boolean\") return false;\n  // Numbers seed as \"\" so the soft Required hint can show without coercion\n  // surprises; the number control coerces on first real input.\n  return \"\";\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"json-schema-form-utils.js","sources":["../../src/components/json-schema-form-utils.ts"],"sourcesContent":["import { cn } from \"../lib/utils\";\nimport { inputSizeClass, type FormSize } from \"./json-schema-form-size\";\nimport type { FieldControl, FieldOption, JsonSchemaProperty } from \"./json-schema-form-types\";\n\n// Non-size styling shared by every text-like input box; the size token supplies\n// height, horizontal padding, and text size (see inputSizeClass).\nconst INPUT_BASE =\n  \"w-full min-w-0 rounded-md border border-input bg-background text-foreground outline-none placeholder:text-muted-foreground disabled:cursor-not-allowed disabled:bg-muted/40 focus-visible:ring-2 focus-visible:ring-ring\";\n\nexport function inputClass(size: FormSize): string {\n  return cn(INPUT_BASE, inputSizeClass[size]);\n}\n\nexport function fieldInputId(key: string, prefix?: string): string {\n  const safe = key.replace(/[^a-zA-Z0-9_-]/g, \"_\");\n  return prefix ? `jsf-${prefix}-${safe}` : `jsf-${safe}`;\n}\n\nexport function defaultPlaceholder(schema: JsonSchemaProperty): string {\n  if (schema.default != null && typeof schema.default !== \"object\") return String(schema.default);\n  return \"\";\n}\n\nexport function toText(value: unknown): string {\n  if (value === undefined || value === null) return \"\";\n  if (typeof value === \"object\") return \"\";\n  return String(value);\n}\n\nexport function isPlainObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n// withSyntheticValue prepends the current value as an option when it is not in\n// the enum, so an out-of-enum value (e.g. a template token) still displays.\nexport function withSyntheticValue(options: FieldOption[], value: string): FieldOption[] {\n  if (!value || options.some((o) => o.value === value)) return options;\n  return [{ value, label: value }, ...options];\n}\n\n// keyPickerOptions narrows the map-key enum to keys not already used by another\n// entry, while always keeping this row's current key so it stays selectable.\nexport function keyPickerOptions(\n  options: FieldOption[],\n  usedKeys: string[],\n  currentKey: string,\n): FieldOption[] {\n  const taken = new Set(usedKeys.filter((k) => k !== currentKey));\n  return options.filter((o) => !taken.has(o.value));\n}\n\n// orderByXOrder reorders property entries by the schema's `x-order` hint: keys\n// named there render first (in that order), the rest keep document order. A\n// missing/empty hint is a no-op, so document order remains the default.\nexport function orderByXOrder<T>(entries: [string, T][], order: unknown): [string, T][] {\n  if (!Array.isArray(order) || order.length === 0) return entries;\n  const rank = new Map(\n    order.filter((k): k is string => typeof k === \"string\").map((k, i) => [k, i]),\n  );\n  const listed = entries\n    .filter(([key]) => rank.has(key))\n    .sort((a, b) => rank.get(a[0])! - rank.get(b[0])!);\n  const rest = entries.filter(([key]) => !rank.has(key));\n  return [...listed, ...rest];\n}\n\n// orderByClickyOrder stably sorts property entries by each property's numeric\n// `x-clicky-order` (lower first); entries without it keep their incoming order\n// after the ordered ones. An explicit index tie-break keeps it stable regardless\n// of the engine's sort stability. Unlike the object-level `x-order` array, this\n// composes across merged if/then branches because each property carries its own\n// order — the right tool when fields come from different (embedded) sources.\nexport function orderByClickyOrder(\n  entries: [string, JsonSchemaProperty][],\n): [string, JsonSchemaProperty][] {\n  const rank = (prop: JsonSchemaProperty): number => {\n    const o = prop[\"x-clicky-order\"];\n    return typeof o === \"number\" ? o : Number.POSITIVE_INFINITY;\n  };\n  return entries\n    .map((entry, index) => ({ entry, index, rank: rank(entry[1]) }))\n    .sort((a, b) => a.rank - b.rank || a.index - b.index)\n    .map((ranked) => ranked.entry);\n}\n\n// orderRequiredFirst stably partitions property entries so the keys named in\n// `required` come first (in their original order), then the rest (in theirs).\n// A stable two-pass partition, so it never reshuffles within either group.\nexport function orderRequiredFirst<T>(\n  entries: [string, T][],\n  required: string[],\n): [string, T][] {\n  const isRequired = new Set(required);\n  const head = entries.filter(([key]) => isRequired.has(key));\n  const tail = entries.filter(([key]) => !isRequired.has(key));\n  return [...head, ...tail];\n}\n\n// isEmptyValue reports whether a field's value carries no data, so priority\n// sorting can sink unfilled fields. Empty = undefined/null/\"\" plus empty arrays\n// and empty plain objects; `false` and `0` count as filled (they are choices).\nexport function isEmptyValue(value: unknown): boolean {\n  if (value === undefined || value === null || value === \"\") return true;\n  if (Array.isArray(value)) return value.length === 0;\n  if (typeof value === \"object\") return Object.keys(value).length === 0;\n  return false;\n}\n\n// orderByPriority sorts property entries so the fields that matter most surface\n// first, ranking each by a score: +2 if required, +1 if its value is non-empty.\n// Required-and-filled lead, then required-and-empty, then optional-and-filled,\n// then optional-and-empty. Ties keep their incoming order (explicit index\n// tie-break, so it does not depend on the engine's sort stability).\nexport function orderByPriority<T>(\n  entries: [string, T][],\n  required: string[],\n  values: Record<string, unknown>,\n): [string, T][] {\n  const isRequired = new Set(required);\n  const score = (key: string): number =>\n    (isRequired.has(key) ? 2 : 0) + (isEmptyValue(values[key]) ? 0 : 1);\n  return entries\n    .map((entry, index) => ({ entry, index, score: score(entry[0]) }))\n    .sort((a, b) => b.score - a.score || a.index - b.index)\n    .map((ranked) => ranked.entry);\n}\n\n// softError computes a display-only validation hint. It never blocks onChange.\n// Consumers suppress the unknown-enum hint by setting allowCustomValue.\nexport function softError(field: FieldControl): string | undefined {\n  const v = field.value;\n  const isEmpty = v === undefined || v === null || v === \"\";\n  if (field.required && isEmpty) return \"Required\";\n\n  if (field.kind === \"number\" && typeof field.minimum === \"number\" && typeof v === \"number\") {\n    if (v < field.minimum) return `Must be ≥ ${field.minimum}`;\n  }\n\n  if (field.kind === \"enum\" && !field.allowCustomValue && !isEmpty) {\n    const known = (field.options ?? []).some((o) => o.value === String(v));\n    if (!known) return \"Unknown value (allowed)\";\n  }\n  return undefined;\n}\n\n// Immutable array helpers used by the array control.\nexport function setIndex<T>(arr: T[], i: number, v: T): T[] {\n  return arr.map((x, idx) => (idx === i ? v : x));\n}\n\nexport function removeIndex<T>(arr: T[], i: number): T[] {\n  return arr.filter((_, idx) => idx !== i);\n}\n\nexport function moveItem<T>(arr: T[], from: number, to: number): T[] {\n  if (to < 0 || to >= arr.length) return arr;\n  const next = [...arr];\n  const [moved] = next.splice(from, 1);\n  next.splice(to, 0, moved as T);\n  return next;\n}\n\n// seedFromSchema produces the initial value for a freshly-added array item or\n// object field, honouring an explicit default.\nexport function seedFromSchema(schema: JsonSchemaProperty): unknown {\n  if (schema.default !== undefined) return schema.default;\n  const type = Array.isArray(schema.type) ? schema.type[0] : schema.type;\n  if (type === \"array\") return [];\n  if (type === \"object\") return {};\n  if (type === \"boolean\") return false;\n  // Numbers seed as \"\" so the soft Required hint can show without coercion\n  // surprises; the number control coerces on first real input.\n  return \"\";\n}\n"],"names":[],"mappings":"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"}