@flanksource/clicky-ui 0.2.13 → 0.2.15

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

@@ -15,7 +15,15 @@ function schemaHasType(prop, type) {
   return prop.type === type;
 }
 function enumOptions(prop) {
-  return (prop.enum ?? []).map((v) => ({ value: String(v), label: String(v) }));
+  const labels = prop["x-enum-labels"];
+  return (prop.enum ?? []).map((v) => {
+    const value = String(v);
+    const desc = labels == null ? void 0 : labels[value];
+    return {
+      value,
+      label: typeof desc === "string" && desc && desc !== value ? `${desc} (${value})` : value
+    };
+  });
 }
 function enumBranch(prop) {
   for (const branch of [...prop.anyOf ?? [], ...prop.oneOf ?? []]) {

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

@@ -1 +1 @@
-{"version":3,"file":"json-schema-form-resolve.js","sources":["../../src/components/json-schema-form-resolve.ts"],"sourcesContent":["import type {\n  FieldControl,\n  FieldOption,\n  JsonSchemaObject,\n  JsonSchemaProperty,\n} from \"./json-schema-form-types\";\n\n// isOpenStringMap reports whether a property is an object whose entries are\n// described by a sub-schema in `additionalProperties` (a typed key/value map) or\n// by `patternProperties` (a per-key-pattern value map). Either makes it an\n// editable key/value control rather than a fixed-property sub-form.\nexport function isOpenStringMap(prop: JsonSchemaProperty): boolean {\n  if (!schemaHasType(prop, \"object\")) return false;\n  if (typeof prop.additionalProperties === \"object\" && prop.additionalProperties !== null) {\n    return true;\n  }\n  return !!prop.patternProperties && Object.keys(prop.patternProperties).length > 0;\n}\n\n// patternSchemasOf compiles a schema's `patternProperties` into the ordered\n// {pattern, schema} list the string-map control matches keys against.\nfunction patternSchemasOf(prop: JsonSchemaProperty): { pattern: string; schema: JsonSchemaProperty }[] | undefined {\n  const pp = prop.patternProperties;\n  if (!pp || Object.keys(pp).length === 0) return undefined;\n  return Object.entries(pp).map(([pattern, schema]) => ({ pattern, schema }));\n}\n\nfunction schemaHasType(prop: JsonSchemaProperty, type: string): boolean {\n  if (Array.isArray(prop.type)) return prop.type.includes(type as never);\n  return prop.type === type;\n}\n\nfunction enumOptions(prop: JsonSchemaProperty): FieldOption[] {\n  return (prop.enum ?? []).map((v) => ({ value: String(v), label: String(v) }));\n}\n\n// enumBranch returns the first anyOf/oneOf member carrying a non-empty `enum`,\n// for a union of \"an enum value OR a free-form string\" (e.g. a value-or-token\n// field). It lets such a union render as a dropdown. Returns undefined when no\n// branch enumerates values.\nexport function enumBranch(prop: JsonSchemaProperty): JsonSchemaProperty | undefined {\n  for (const branch of [...(prop.anyOf ?? []), ...(prop.oneOf ?? [])]) {\n    if (Array.isArray(branch.enum) && branch.enum.length > 0) return branch;\n  }\n  return undefined;\n}\n\nexport interface ResolveControlArgs {\n  key: string;\n  prop: JsonSchemaProperty;\n  required: boolean;\n  value: unknown;\n  onChange: (next: unknown) => void;\n}\n\n// resolveControl infers a base, render-ready FieldControl from a property\n// schema. It keys off schema keywords only — never the field name: ascode/token\n// heuristics are layered on by consumer pre-extensions. The one exception is the\n// standard `format: date`/`date-time` keyword, which is a schema-declared signal\n// (not a name guess) and so drives a date control directly. First match wins.\nexport function resolveControl(args: ResolveControlArgs): FieldControl {\n  const { key, prop, required, value, onChange } = args;\n  const labelIcon = prop[\"x-icon\"];\n  const xLayout = prop[\"x-layout\"];\n  const layout =\n    xLayout === \"inline\" || xLayout === \"stack\" || xLayout === \"table\" ? xLayout : undefined;\n  const keyOptions = keyOptionsFor(prop);\n  const base: FieldControl = {\n    key,\n    kind: \"string\",\n    label: typeof prop.title === \"string\" && prop.title ? prop.title : key,\n    required,\n    schema: prop,\n    value,\n    onChange,\n    ...(prop.readOnly === true ? { readOnly: true } : {}),\n    ...(typeof prop.description === \"string\" ? { description: prop.description } : {}),\n    ...(labelIcon != null && labelIcon !== \"\" ? { labelIcon: labelIcon as FieldControl[\"labelIcon\"] } : {}),\n  };\n\n  if (Array.isArray(prop.enum) && prop.enum.length > 0) {\n    return { ...base, kind: \"enum\", options: enumOptions(prop) };\n  }\n  // A value-or-template union: the enum lives in an anyOf/oneOf branch alongside\n  // free-form branches. Render it as a dropdown using that branch's enum; the\n  // free-form branches are honoured via a consumer's allowCustomValue pre-ext.\n  const branch = enumBranch(prop);\n  if (branch) {\n    return { ...base, kind: \"enum\", options: enumOptions(branch) };\n  }\n  // A schema-declared date/date-time string renders as a date control.\n  if (prop.format === \"date\" || prop.format === \"date-time\") {\n    return { ...base, kind: \"date\", dateFormat: prop.format };\n  }\n  if (schemaHasType(prop, \"boolean\")) {\n    return { ...base, kind: \"boolean\" };\n  }\n  if (schemaHasType(prop, \"integer\") || schemaHasType(prop, \"number\")) {\n    return {\n      ...base,\n      kind: \"number\",\n      coerceNumber: true,\n      ...(typeof prop.minimum === \"number\" ? { minimum: prop.minimum } : {}),\n    };\n  }\n  if (schemaHasType(prop, \"array\")) {\n    return {\n      ...base,\n      kind: \"array\",\n      ...(prop.items ? { itemSchema: prop.items } : {}),\n      ...(layout ? { layout } : {}),\n    };\n  }\n  // An open map: object whose entries are described by an additionalProperties\n  // sub-schema and/or per-key patternProperties. Renders as editable key/value\n  // rows (+ any known properties), with the value form resolved per key.\n  if (isOpenStringMap(prop)) {\n    const addl =\n      typeof prop.additionalProperties === \"object\" && prop.additionalProperties !== null\n        ? (prop.additionalProperties as JsonSchemaProperty)\n        : undefined;\n    const patterns = patternSchemasOf(prop);\n    // A constrained picker (propertyNames enum) or patternProperties still lets\n    // the author ADD keys — the additions are limited to the allowed set, not\n    // free-form — so `additionalProperties: false` doesn't disable \"Add field\"\n    // in that case. It only closes a plain open map with no key constraints.\n    const allowExtraKeys = keyOptions || patterns ? true : prop.additionalProperties !== false;\n    return {\n      ...base,\n      kind: \"string-map\",\n      ...(addl ? { valueSchema: addl } : {}),\n      ...(patterns ? { valuePatternSchemas: patterns } : {}),\n      ...(prop.properties ? { knownProperties: prop.properties } : {}),\n      allowExtraKeys,\n      ...(keyOptions ? { keyOptions } : {}),\n      ...(layout ? { layout } : {}),\n    };\n  }\n  // A structured object: fixed `properties`, not an open map. Renders as a\n  // nested sub-form (labels, required, if/then) — recursed into by the renderer.\n  if (schemaHasType(prop, \"object\") && prop.properties) {\n    return {\n      ...base,\n      kind: \"object\",\n      objectProperties: prop.properties,\n      ...(prop.required ? { objectRequired: prop.required } : {}),\n      ...(layout ? { layout } : {}),\n    };\n  }\n  // A bare object with neither properties nor an additionalProperties schema:\n  // treat as an open string map unless explicitly closed.\n  if (schemaHasType(prop, \"object\")) {\n    return {\n      ...base,\n      kind: \"string-map\",\n      allowExtraKeys: prop.additionalProperties !== false,\n      ...(keyOptions ? { keyOptions } : {}),\n      ...(layout ? { layout } : {}),\n    };\n  }\n  return base;\n}\n\n// keyOptionsFor resolves the strict map-key picker options from a map schema's\n// `propertyNames.enum` (e.g. an AsCode-constrained key set). Returns undefined\n// when the keys are unconstrained, so the key stays free-text.\nfunction keyOptionsFor(prop: JsonSchemaProperty): FieldOption[] | undefined {\n  const pn = prop.propertyNames as JsonSchemaProperty | undefined;\n  if (!pn || !Array.isArray(pn.enum) || pn.enum.length === 0) return undefined;\n  return enumOptions(pn);\n}\n\n// isScalarStringItems reports whether an array's item schema is a plain string\n// with no richer shape — the case the array control renders as compact tags.\n// Anything with an enum/const/properties/items/additionalProperties/allOf needs\n// a real per-item control instead.\nexport function isScalarStringItems(items: JsonSchemaProperty | undefined): boolean {\n  if (!items) return true; // untyped items default to string tags\n  if (items.type !== undefined && !schemaHasType(items, \"string\")) return false;\n  return (\n    items.enum === undefined &&\n    items.const === undefined &&\n    items.properties === undefined &&\n    items.items === undefined &&\n    items.additionalProperties === undefined &&\n    items.allOf === undefined\n  );\n}\n\n// matchesIf reports whether the `if` sub-schema holds for the current value:\n// every `if.required` key is present AND every `if.properties[k].const` equals\n// value[k].\nexport function matchesIf(\n  ifSchema: JsonSchemaProperty | undefined,\n  value: Record<string, unknown>,\n): boolean {\n  if (!ifSchema) return false;\n  for (const k of ifSchema.required ?? []) {\n    if (!(k in value)) return false;\n  }\n  for (const [k, sub] of Object.entries(ifSchema.properties ?? {})) {\n    if (\"const\" in sub && value[k] !== sub.const) return false;\n  }\n  return true;\n}\n\nexport interface EffectiveProperties {\n  properties: Record<string, JsonSchemaProperty>;\n  required: string[];\n}\n\n// effectiveProperties merges the schema's base `properties` with each `allOf`\n// member's contribution. An `if`/`then` member contributes `then.properties`\n// only when its `if` matches the current value; an unconditional member (e.g.\n// an inlined `$ref` composition, which carries its own `properties` and no\n// `if`) always contributes. Later members win on key collision; required is the\n// union. Pure and idempotent.\nexport function effectiveProperties(\n  schema: JsonSchemaObject,\n  value: Record<string, unknown>,\n): EffectiveProperties {\n  const properties: Record<string, JsonSchemaProperty> = { ...(schema.properties ?? {}) };\n  const required = new Set(schema.required ?? []);\n  for (const clause of schema.allOf ?? []) {\n    // Unconditional composition member: merge its own properties/required.\n    if (clause.if === undefined && clause.then === undefined) {\n      for (const [k, sub] of Object.entries(clause.properties ?? {})) {\n        properties[k] = sub;\n      }\n      for (const k of clause.required ?? []) required.add(k);\n      continue;\n    }\n    if (!matchesIf(clause.if, value)) continue;\n    const then = clause.then ?? {};\n    for (const [k, sub] of Object.entries(then.properties ?? {})) {\n      properties[k] = sub;\n    }\n    for (const k of then.required ?? []) required.add(k);\n  }\n  return { properties, required: [...required] };\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"json-schema-form-resolve.js","sources":["../../src/components/json-schema-form-resolve.ts"],"sourcesContent":["import type {\n  FieldControl,\n  FieldOption,\n  JsonSchemaObject,\n  JsonSchemaProperty,\n} from \"./json-schema-form-types\";\n\n// isOpenStringMap reports whether a property is an object whose entries are\n// described by a sub-schema in `additionalProperties` (a typed key/value map) or\n// by `patternProperties` (a per-key-pattern value map). Either makes it an\n// editable key/value control rather than a fixed-property sub-form.\nexport function isOpenStringMap(prop: JsonSchemaProperty): boolean {\n  if (!schemaHasType(prop, \"object\")) return false;\n  if (typeof prop.additionalProperties === \"object\" && prop.additionalProperties !== null) {\n    return true;\n  }\n  return !!prop.patternProperties && Object.keys(prop.patternProperties).length > 0;\n}\n\n// patternSchemasOf compiles a schema's `patternProperties` into the ordered\n// {pattern, schema} list the string-map control matches keys against.\nfunction patternSchemasOf(prop: JsonSchemaProperty): { pattern: string; schema: JsonSchemaProperty }[] | undefined {\n  const pp = prop.patternProperties;\n  if (!pp || Object.keys(pp).length === 0) return undefined;\n  return Object.entries(pp).map(([pattern, schema]) => ({ pattern, schema }));\n}\n\nfunction schemaHasType(prop: JsonSchemaProperty, type: string): boolean {\n  if (Array.isArray(prop.type)) return prop.type.includes(type as never);\n  return prop.type === type;\n}\n\nfunction enumOptions(prop: JsonSchemaProperty): FieldOption[] {\n  const labels = prop[\"x-enum-labels\"];\n  return (prop.enum ?? []).map((v) => {\n    const value = String(v);\n    const desc = labels?.[value];\n    return {\n      value,\n      label: typeof desc === \"string\" && desc && desc !== value ? `${desc} (${value})` : value,\n    };\n  });\n}\n\n// enumBranch returns the first anyOf/oneOf member carrying a non-empty `enum`,\n// for a union of \"an enum value OR a free-form string\" (e.g. a value-or-token\n// field). It lets such a union render as a dropdown. Returns undefined when no\n// branch enumerates values.\nexport function enumBranch(prop: JsonSchemaProperty): JsonSchemaProperty | undefined {\n  for (const branch of [...(prop.anyOf ?? []), ...(prop.oneOf ?? [])]) {\n    if (Array.isArray(branch.enum) && branch.enum.length > 0) return branch;\n  }\n  return undefined;\n}\n\nexport interface ResolveControlArgs {\n  key: string;\n  prop: JsonSchemaProperty;\n  required: boolean;\n  value: unknown;\n  onChange: (next: unknown) => void;\n}\n\n// resolveControl infers a base, render-ready FieldControl from a property\n// schema. It keys off schema keywords only — never the field name: ascode/token\n// heuristics are layered on by consumer pre-extensions. The one exception is the\n// standard `format: date`/`date-time` keyword, which is a schema-declared signal\n// (not a name guess) and so drives a date control directly. First match wins.\nexport function resolveControl(args: ResolveControlArgs): FieldControl {\n  const { key, prop, required, value, onChange } = args;\n  const labelIcon = prop[\"x-icon\"];\n  const xLayout = prop[\"x-layout\"];\n  const layout =\n    xLayout === \"inline\" || xLayout === \"stack\" || xLayout === \"table\" ? xLayout : undefined;\n  const keyOptions = keyOptionsFor(prop);\n  const base: FieldControl = {\n    key,\n    kind: \"string\",\n    label: typeof prop.title === \"string\" && prop.title ? prop.title : key,\n    required,\n    schema: prop,\n    value,\n    onChange,\n    ...(prop.readOnly === true ? { readOnly: true } : {}),\n    ...(typeof prop.description === \"string\" ? { description: prop.description } : {}),\n    ...(labelIcon != null && labelIcon !== \"\" ? { labelIcon: labelIcon as FieldControl[\"labelIcon\"] } : {}),\n  };\n\n  if (Array.isArray(prop.enum) && prop.enum.length > 0) {\n    return { ...base, kind: \"enum\", options: enumOptions(prop) };\n  }\n  // A value-or-template union: the enum lives in an anyOf/oneOf branch alongside\n  // free-form branches. Render it as a dropdown using that branch's enum; the\n  // free-form branches are honoured via a consumer's allowCustomValue pre-ext.\n  const branch = enumBranch(prop);\n  if (branch) {\n    return { ...base, kind: \"enum\", options: enumOptions(branch) };\n  }\n  // A schema-declared date/date-time string renders as a date control.\n  if (prop.format === \"date\" || prop.format === \"date-time\") {\n    return { ...base, kind: \"date\", dateFormat: prop.format };\n  }\n  if (schemaHasType(prop, \"boolean\")) {\n    return { ...base, kind: \"boolean\" };\n  }\n  if (schemaHasType(prop, \"integer\") || schemaHasType(prop, \"number\")) {\n    return {\n      ...base,\n      kind: \"number\",\n      coerceNumber: true,\n      ...(typeof prop.minimum === \"number\" ? { minimum: prop.minimum } : {}),\n    };\n  }\n  if (schemaHasType(prop, \"array\")) {\n    return {\n      ...base,\n      kind: \"array\",\n      ...(prop.items ? { itemSchema: prop.items } : {}),\n      ...(layout ? { layout } : {}),\n    };\n  }\n  // An open map: object whose entries are described by an additionalProperties\n  // sub-schema and/or per-key patternProperties. Renders as editable key/value\n  // rows (+ any known properties), with the value form resolved per key.\n  if (isOpenStringMap(prop)) {\n    const addl =\n      typeof prop.additionalProperties === \"object\" && prop.additionalProperties !== null\n        ? (prop.additionalProperties as JsonSchemaProperty)\n        : undefined;\n    const patterns = patternSchemasOf(prop);\n    // A constrained picker (propertyNames enum) or patternProperties still lets\n    // the author ADD keys — the additions are limited to the allowed set, not\n    // free-form — so `additionalProperties: false` doesn't disable \"Add field\"\n    // in that case. It only closes a plain open map with no key constraints.\n    const allowExtraKeys = keyOptions || patterns ? true : prop.additionalProperties !== false;\n    return {\n      ...base,\n      kind: \"string-map\",\n      ...(addl ? { valueSchema: addl } : {}),\n      ...(patterns ? { valuePatternSchemas: patterns } : {}),\n      ...(prop.properties ? { knownProperties: prop.properties } : {}),\n      allowExtraKeys,\n      ...(keyOptions ? { keyOptions } : {}),\n      ...(layout ? { layout } : {}),\n    };\n  }\n  // A structured object: fixed `properties`, not an open map. Renders as a\n  // nested sub-form (labels, required, if/then) — recursed into by the renderer.\n  if (schemaHasType(prop, \"object\") && prop.properties) {\n    return {\n      ...base,\n      kind: \"object\",\n      objectProperties: prop.properties,\n      ...(prop.required ? { objectRequired: prop.required } : {}),\n      ...(layout ? { layout } : {}),\n    };\n  }\n  // A bare object with neither properties nor an additionalProperties schema:\n  // treat as an open string map unless explicitly closed.\n  if (schemaHasType(prop, \"object\")) {\n    return {\n      ...base,\n      kind: \"string-map\",\n      allowExtraKeys: prop.additionalProperties !== false,\n      ...(keyOptions ? { keyOptions } : {}),\n      ...(layout ? { layout } : {}),\n    };\n  }\n  return base;\n}\n\n// keyOptionsFor resolves the strict map-key picker options from a map schema's\n// `propertyNames.enum` (e.g. an AsCode-constrained key set). Returns undefined\n// when the keys are unconstrained, so the key stays free-text.\nfunction keyOptionsFor(prop: JsonSchemaProperty): FieldOption[] | undefined {\n  const pn = prop.propertyNames as JsonSchemaProperty | undefined;\n  if (!pn || !Array.isArray(pn.enum) || pn.enum.length === 0) return undefined;\n  return enumOptions(pn);\n}\n\n// isScalarStringItems reports whether an array's item schema is a plain string\n// with no richer shape — the case the array control renders as compact tags.\n// Anything with an enum/const/properties/items/additionalProperties/allOf needs\n// a real per-item control instead.\nexport function isScalarStringItems(items: JsonSchemaProperty | undefined): boolean {\n  if (!items) return true; // untyped items default to string tags\n  if (items.type !== undefined && !schemaHasType(items, \"string\")) return false;\n  return (\n    items.enum === undefined &&\n    items.const === undefined &&\n    items.properties === undefined &&\n    items.items === undefined &&\n    items.additionalProperties === undefined &&\n    items.allOf === undefined\n  );\n}\n\n// matchesIf reports whether the `if` sub-schema holds for the current value:\n// every `if.required` key is present AND every `if.properties[k].const` equals\n// value[k].\nexport function matchesIf(\n  ifSchema: JsonSchemaProperty | undefined,\n  value: Record<string, unknown>,\n): boolean {\n  if (!ifSchema) return false;\n  for (const k of ifSchema.required ?? []) {\n    if (!(k in value)) return false;\n  }\n  for (const [k, sub] of Object.entries(ifSchema.properties ?? {})) {\n    if (\"const\" in sub && value[k] !== sub.const) return false;\n  }\n  return true;\n}\n\nexport interface EffectiveProperties {\n  properties: Record<string, JsonSchemaProperty>;\n  required: string[];\n}\n\n// effectiveProperties merges the schema's base `properties` with each `allOf`\n// member's contribution. An `if`/`then` member contributes `then.properties`\n// only when its `if` matches the current value; an unconditional member (e.g.\n// an inlined `$ref` composition, which carries its own `properties` and no\n// `if`) always contributes. Later members win on key collision; required is the\n// union. Pure and idempotent.\nexport function effectiveProperties(\n  schema: JsonSchemaObject,\n  value: Record<string, unknown>,\n): EffectiveProperties {\n  const properties: Record<string, JsonSchemaProperty> = { ...(schema.properties ?? {}) };\n  const required = new Set(schema.required ?? []);\n  for (const clause of schema.allOf ?? []) {\n    // Unconditional composition member: merge its own properties/required.\n    if (clause.if === undefined && clause.then === undefined) {\n      for (const [k, sub] of Object.entries(clause.properties ?? {})) {\n        properties[k] = sub;\n      }\n      for (const k of clause.required ?? []) required.add(k);\n      continue;\n    }\n    if (!matchesIf(clause.if, value)) continue;\n    const then = clause.then ?? {};\n    for (const [k, sub] of Object.entries(then.properties ?? {})) {\n      properties[k] = sub;\n    }\n    for (const k of then.required ?? []) required.add(k);\n  }\n  return { properties, required: [...required] };\n}\n"],"names":[],"mappings":"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"}

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

@@ -23,6 +23,8 @@ export interface JsonSchemaProperty {
     if?: JsonSchemaProperty;
     then?: JsonSchemaProperty;
     else?: JsonSchemaProperty;
+    "x-order"?: string[];
+    "x-enum-labels"?: Record<string, string>;
     [key: string]: unknown;
 }
 export type JsonSchemaType = "object" | "array" | "string" | "integer" | "number" | "boolean" | "null";
@@ -57,6 +59,7 @@ export interface FieldControl {
     display?: EnumDisplay;
     badge?: string;
     helper?: string;
+    suffix?: ReactNode;
     minimum?: number;
     coerceNumber?: boolean;
     dateFormat?: "date" | "date-time";
@@ -89,6 +92,37 @@ export type PostExtension = (field: FieldControl, nodes: {
     label: ReactNode;
     value: ReactNode;
 };
+export interface FieldArgs {
+    key: string;
+    prop: JsonSchemaProperty;
+    required: boolean;
+    value: unknown;
+    onChange: (next: unknown) => void;
+}
+export interface RenderApi {
+    renderFieldNodes(args: FieldArgs, ctx: RenderContext): {
+        label: ReactNode;
+        value: ReactNode;
+    } | null;
+    renderFieldRow(args: FieldArgs, ctx: RenderContext, opts?: {
+        labelOverride?: string;
+    }): ReactNode | null;
+    renderObjectFields(schema: JsonSchemaObject, value: Record<string, unknown>, onChange: (next: Record<string, unknown>) => void, ctx: RenderContext, opts?: {
+        hiddenKeys?: string[];
+    }): ReactNode[];
+}
+export interface RenderContext {
+    readOnly: boolean;
+    hideReadOnlyFields: boolean;
+    layout: FormLayout;
+    size: FormSize;
+    idPrefix?: string;
+    requiredFirst: boolean;
+    pre: PreExtension[];
+    post: PostExtension[];
+    depth: number;
+    render: RenderApi;
+}
 export interface FormLayout {
     /** "inline" = 2-column label/value; "stacked" = label above value. */
     mode: "inline" | "stacked";
@@ -97,7 +131,11 @@ export interface FormLayout {
      * at this width, truncating longer labels with an ellipsis. Default "40ch".
      */
     labelMaxWidth?: string;
-    /** Inline only: max width of the value column (CSS length). Default "600px". */
+    /**
+     * Max width of the value column (inline) or the whole label+value stack
+     * (stacked), as a CSS length. Default "600px". Keeps controls readable on
+     * wide viewports instead of stretching edge to edge.
+     */
     valueMaxWidth?: string;
 }
 export interface JsonSchemaFormProps {
@@ -143,5 +181,24 @@ export interface JsonSchemaFormProps {
     title?: string;
     pre?: PreExtension[];
     post?: PostExtension[];
+    /**
+     * Show the top-right three-dot display-options menu (size + layout mode).
+     * Defaults to true. The menu controls only this form's appearance — never
+     * global page density or field values. When false the form renders exactly as
+     * before and performs no preference reads/writes.
+     */
+    showPreferencesMenu?: boolean;
+    /**
+     * Persist menu selections to localStorage so they survive remounts. Defaults
+     * to true. When false the menu still adjusts the current instance, but nothing
+     * is read from or written to localStorage.
+     */
+    persistPreferences?: boolean;
+    /**
+     * localStorage key the display preferences are stored under. Defaults to a
+     * shared key, so by default every form shares one set of preferences; pass a
+     * distinct key to isolate a screen or form.
+     */
+    preferencesStorageKey?: string;
 }
 //# sourceMappingURL=json-schema-form-types.d.ts.map

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":"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"}
+{"version":3,"file":"json-schema-form-types.d.ts","sourceRoot":"","sources":["../../src/components/json-schema-form-types.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const utils = require("../lib/utils.cjs");
+const jsonSchemaFormSize = require("./json-schema-form-size.cjs");
+const INPUT_BASE = "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";
+function inputClass(size) {
+  return utils.cn(INPUT_BASE, jsonSchemaFormSize.inputSizeClass[size]);
+}
+function fieldInputId(key, prefix) {
+  const safe = key.replace(/[^a-zA-Z0-9_-]/g, "_");
+  return prefix ? `jsf-${prefix}-${safe}` : `jsf-${safe}`;
+}
+function defaultPlaceholder(schema) {
+  if (schema.default != null && typeof schema.default !== "object") return String(schema.default);
+  return "";
+}
+function toText(value) {
+  if (value === void 0 || value === null) return "";
+  if (typeof value === "object") return "";
+  return String(value);
+}
+function isPlainObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function withSyntheticValue(options, value) {
+  if (!value || options.some((o) => o.value === value)) return options;
+  return [{ value, label: value }, ...options];
+}
+function keyPickerOptions(options, usedKeys, currentKey) {
+  const taken = new Set(usedKeys.filter((k) => k !== currentKey));
+  return options.filter((o) => !taken.has(o.value));
+}
+function orderByXOrder(entries, order) {
+  if (!Array.isArray(order) || order.length === 0) return entries;
+  const rank = new Map(
+    order.filter((k) => typeof k === "string").map((k, i) => [k, i])
+  );
+  const listed = entries.filter(([key]) => rank.has(key)).sort((a, b) => rank.get(a[0]) - rank.get(b[0]));
+  const rest = entries.filter(([key]) => !rank.has(key));
+  return [...listed, ...rest];
+}
+function orderRequiredFirst(entries, required) {
+  const isRequired = new Set(required);
+  const head = entries.filter(([key]) => isRequired.has(key));
+  const tail = entries.filter(([key]) => !isRequired.has(key));
+  return [...head, ...tail];
+}
+function softError(field) {
+  const v = field.value;
+  const isEmpty = v === void 0 || v === null || v === "";
+  if (field.required && isEmpty) return "Required";
+  if (field.kind === "number" && typeof field.minimum === "number" && typeof v === "number") {
+    if (v < field.minimum) return `Must be ≥ ${field.minimum}`;
+  }
+  if (field.kind === "enum" && !field.allowCustomValue && !isEmpty) {
+    const known = (field.options ?? []).some((o) => o.value === String(v));
+    if (!known) return "Unknown value (allowed)";
+  }
+  return void 0;
+}
+function setIndex(arr, i, v) {
+  return arr.map((x, idx) => idx === i ? v : x);
+}
+function removeIndex(arr, i) {
+  return arr.filter((_, idx) => idx !== i);
+}
+function moveItem(arr, from, to) {
+  if (to < 0 || to >= arr.length) return arr;
+  const next = [...arr];
+  const [moved] = next.splice(from, 1);
+  next.splice(to, 0, moved);
+  return next;
+}
+function seedFromSchema(schema) {
+  if (schema.default !== void 0) return schema.default;
+  const type = Array.isArray(schema.type) ? schema.type[0] : schema.type;
+  if (type === "array") return [];
+  if (type === "object") return {};
+  if (type === "boolean") return false;
+  return "";
+}
+exports.defaultPlaceholder = defaultPlaceholder;
+exports.fieldInputId = fieldInputId;
+exports.inputClass = inputClass;
+exports.isPlainObject = isPlainObject;
+exports.keyPickerOptions = keyPickerOptions;
+exports.moveItem = moveItem;
+exports.orderByXOrder = orderByXOrder;
+exports.orderRequiredFirst = orderRequiredFirst;
+exports.removeIndex = removeIndex;
+exports.seedFromSchema = seedFromSchema;
+exports.setIndex = setIndex;
+exports.softError = softError;
+exports.toText = toText;
+exports.withSyntheticValue = withSyntheticValue;
+//# sourceMappingURL=json-schema-form-utils.cjs.map

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

@@ -0,0 +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// 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

@@ -0,0 +1,17 @@
+import { FormSize } from './json-schema-form-size';
+import { FieldControl, FieldOption, JsonSchemaProperty } from './json-schema-form-types';
+export declare function inputClass(size: FormSize): string;
+export declare function fieldInputId(key: string, prefix?: string): string;
+export declare function defaultPlaceholder(schema: JsonSchemaProperty): string;
+export declare function toText(value: unknown): string;
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+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 orderRequiredFirst<T>(entries: [string, T][], required: string[]): [string, T][];
+export declare function softError(field: FieldControl): string | undefined;
+export declare function setIndex<T>(arr: T[], i: number, v: T): T[];
+export declare function removeIndex<T>(arr: T[], i: number): T[];
+export declare function moveItem<T>(arr: T[], from: number, to: number): T[];
+export declare function seedFromSchema(schema: JsonSchemaProperty): unknown;
+//# sourceMappingURL=json-schema-form-utils.d.ts.map

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

@@ -0,0 +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;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

@@ -0,0 +1,96 @@
+import { cn } from "../lib/utils.js";
+import { inputSizeClass } from "./json-schema-form-size.js";
+const INPUT_BASE = "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";
+function inputClass(size) {
+  return cn(INPUT_BASE, inputSizeClass[size]);
+}
+function fieldInputId(key, prefix) {
+  const safe = key.replace(/[^a-zA-Z0-9_-]/g, "_");
+  return prefix ? `jsf-${prefix}-${safe}` : `jsf-${safe}`;
+}
+function defaultPlaceholder(schema) {
+  if (schema.default != null && typeof schema.default !== "object") return String(schema.default);
+  return "";
+}
+function toText(value) {
+  if (value === void 0 || value === null) return "";
+  if (typeof value === "object") return "";
+  return String(value);
+}
+function isPlainObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function withSyntheticValue(options, value) {
+  if (!value || options.some((o) => o.value === value)) return options;
+  return [{ value, label: value }, ...options];
+}
+function keyPickerOptions(options, usedKeys, currentKey) {
+  const taken = new Set(usedKeys.filter((k) => k !== currentKey));
+  return options.filter((o) => !taken.has(o.value));
+}
+function orderByXOrder(entries, order) {
+  if (!Array.isArray(order) || order.length === 0) return entries;
+  const rank = new Map(
+    order.filter((k) => typeof k === "string").map((k, i) => [k, i])
+  );
+  const listed = entries.filter(([key]) => rank.has(key)).sort((a, b) => rank.get(a[0]) - rank.get(b[0]));
+  const rest = entries.filter(([key]) => !rank.has(key));
+  return [...listed, ...rest];
+}
+function orderRequiredFirst(entries, required) {
+  const isRequired = new Set(required);
+  const head = entries.filter(([key]) => isRequired.has(key));
+  const tail = entries.filter(([key]) => !isRequired.has(key));
+  return [...head, ...tail];
+}
+function softError(field) {
+  const v = field.value;
+  const isEmpty = v === void 0 || v === null || v === "";
+  if (field.required && isEmpty) return "Required";
+  if (field.kind === "number" && typeof field.minimum === "number" && typeof v === "number") {
+    if (v < field.minimum) return `Must be ≥ ${field.minimum}`;
+  }
+  if (field.kind === "enum" && !field.allowCustomValue && !isEmpty) {
+    const known = (field.options ?? []).some((o) => o.value === String(v));
+    if (!known) return "Unknown value (allowed)";
+  }
+  return void 0;
+}
+function setIndex(arr, i, v) {
+  return arr.map((x, idx) => idx === i ? v : x);
+}
+function removeIndex(arr, i) {
+  return arr.filter((_, idx) => idx !== i);
+}
+function moveItem(arr, from, to) {
+  if (to < 0 || to >= arr.length) return arr;
+  const next = [...arr];
+  const [moved] = next.splice(from, 1);
+  next.splice(to, 0, moved);
+  return next;
+}
+function seedFromSchema(schema) {
+  if (schema.default !== void 0) return schema.default;
+  const type = Array.isArray(schema.type) ? schema.type[0] : schema.type;
+  if (type === "array") return [];
+  if (type === "object") return {};
+  if (type === "boolean") return false;
+  return "";
+}
+export {
+  defaultPlaceholder,
+  fieldInputId,
+  inputClass,
+  isPlainObject,
+  keyPickerOptions,
+  moveItem,
+  orderByXOrder,
+  orderRequiredFirst,
+  removeIndex,
+  seedFromSchema,
+  setIndex,
+  softError,
+  toText,
+  withSyntheticValue
+};
+//# sourceMappingURL=json-schema-form-utils.js.map

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

@@ -0,0 +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// 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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"}

package/dist/components/loading.cjs

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const jsxRuntime = require("react/jsx-runtime");
+const react = require("react");
+const utils = require("../lib/utils.cjs");
+const FIXED_DOT_SIZE = {
+  sm: "size-4",
+  md: "size-6",
+  lg: "size-10"
+};
+const RESPONSIVE_DOT_SIZE = "size-[clamp(1.5rem,12cqi,4.5rem)]";
+const RESPONSIVE_LABEL_SIZE = "text-[clamp(0.7rem,4cqi,0.95rem)]";
+const LoadingDots = react.forwardRef(
+  ({ className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsxs(
+    "svg",
+    {
+      ref,
+      xmlns: "http://www.w3.org/2000/svg",
+      viewBox: "0 0 24 24",
+      fill: "currentColor",
+      "aria-hidden": "true",
+      className: utils.cn("shrink-0", className),
+      ...props,
+      children: [
+        /* @__PURE__ */ jsxRuntime.jsx("circle", { cx: "4", cy: "12", r: "3", children: /* @__PURE__ */ jsxRuntime.jsx(
+          "animate",
+          {
+            id: "clickyLoadDotA",
+            fill: "freeze",
+            attributeName: "opacity",
+            begin: "0;clickyLoadDotC.end-0.25s",
+            dur: "0.75s",
+            values: "1;0.2"
+          }
+        ) }),
+        /* @__PURE__ */ jsxRuntime.jsx("circle", { cx: "12", cy: "12", r: "3", opacity: "0.4", children: /* @__PURE__ */ jsxRuntime.jsx(
+          "animate",
+          {
+            fill: "freeze",
+            attributeName: "opacity",
+            begin: "clickyLoadDotA.begin+0.15s",
+            dur: "0.75s",
+            values: "1;0.2"
+          }
+        ) }),
+        /* @__PURE__ */ jsxRuntime.jsx("circle", { cx: "20", cy: "12", r: "3", opacity: "0.3", children: /* @__PURE__ */ jsxRuntime.jsx(
+          "animate",
+          {
+            id: "clickyLoadDotC",
+            fill: "freeze",
+            attributeName: "opacity",
+            begin: "clickyLoadDotA.begin+0.3s",
+            dur: "0.75s",
+            values: "1;0.2"
+          }
+        ) })
+      ]
+    }
+  )
+);
+LoadingDots.displayName = "LoadingDots";
+const Loading = react.forwardRef(
+  ({ size = "responsive", variant = "inline", label, className, ...props }, ref) => {
+    const effectiveSize = variant === "inline" && size === "responsive" ? "sm" : size;
+    const isResponsive = effectiveSize === "responsive";
+    const dotClass = isResponsive ? RESPONSIVE_DOT_SIZE : FIXED_DOT_SIZE[effectiveSize];
+    if (variant === "centered") {
+      return /* @__PURE__ */ jsxRuntime.jsxs(
+        "div",
+        {
+          ref,
+          role: "status",
+          "aria-label": "Loading",
+          className: utils.cn(
+            "flex min-h-32 w-full flex-col items-center justify-center gap-3 text-muted-foreground",
+            "[container-type:inline-size]",
+            className
+          ),
+          ...props,
+          children: [
+            /* @__PURE__ */ jsxRuntime.jsx(LoadingDots, { className: dotClass }),
+            label != null && /* @__PURE__ */ jsxRuntime.jsx("span", { className: utils.cn(isResponsive ? RESPONSIVE_LABEL_SIZE : "text-sm"), children: label })
+          ]
+        }
+      );
+    }
+    return /* @__PURE__ */ jsxRuntime.jsxs(
+      "div",
+      {
+        ref,
+        role: "status",
+        "aria-label": "Loading",
+        className: utils.cn(
+          "inline-flex items-center gap-2 text-muted-foreground",
+          className
+        ),
+        ...props,
+        children: [
+          /* @__PURE__ */ jsxRuntime.jsx(LoadingDots, { className: dotClass }),
+          label != null && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-sm", children: label })
+        ]
+      }
+    );
+  }
+);
+Loading.displayName = "Loading";
+exports.Loading = Loading;
+exports.LoadingDots = LoadingDots;
+//# sourceMappingURL=loading.cjs.map

package/dist/components/loading.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"loading.cjs","sources":["../../src/components/loading.tsx"],"sourcesContent":["import {\n  forwardRef,\n  type HTMLAttributes,\n  type ReactNode,\n  type SVGProps,\n} from \"react\";\nimport { cn } from \"../lib/utils\";\n\nexport type LoadingSize = \"sm\" | \"md\" | \"lg\" | \"responsive\";\nexport type LoadingVariant = \"inline\" | \"centered\";\n\nexport interface LoadingProps extends HTMLAttributes<HTMLDivElement> {\n  /** Fixed size, or `responsive` (default) to scale with the container. */\n  size?: LoadingSize;\n  /** `inline` for a small in-flow loader, `centered` for a section/page loader. */\n  variant?: LoadingVariant;\n  /** Optional caption rendered beside (inline) or beneath (centered) the dots. */\n  label?: ReactNode;\n}\n\nconst FIXED_DOT_SIZE: Record<Exclude<LoadingSize, \"responsive\">, string> = {\n  sm: \"size-4\",\n  md: \"size-6\",\n  lg: \"size-10\",\n};\n\n// Scales with the nearest `container-type` ancestor's inline size: floors at\n// 1.5rem (24px) in tight panels, climbs to 4.5rem (72px) on full-page loads,\n// interpolating smoothly between. Pure CSS — no ResizeObserver, SSR-safe.\nconst RESPONSIVE_DOT_SIZE = \"size-[clamp(1.5rem,12cqi,4.5rem)]\";\nconst RESPONSIVE_LABEL_SIZE = \"text-[clamp(0.7rem,4cqi,0.95rem)]\";\n\n/**\n * Three bouncing dots. `fill=\"currentColor\"` so the dots inherit the surrounding\n * theme text color (works in light and dark). Size is driven entirely by the\n * className (width + height); the viewBox keeps the 1:1 aspect.\n */\nexport const LoadingDots = forwardRef<SVGSVGElement, SVGProps<SVGSVGElement>>(\n  ({ className, ...props }, ref) => (\n    <svg\n      ref={ref}\n      xmlns=\"http://www.w3.org/2000/svg\"\n      viewBox=\"0 0 24 24\"\n      fill=\"currentColor\"\n      aria-hidden=\"true\"\n      className={cn(\"shrink-0\", className)}\n      {...props}\n    >\n      <circle cx=\"4\" cy=\"12\" r=\"3\">\n        <animate\n          id=\"clickyLoadDotA\"\n          fill=\"freeze\"\n          attributeName=\"opacity\"\n          begin=\"0;clickyLoadDotC.end-0.25s\"\n          dur=\"0.75s\"\n          values=\"1;0.2\"\n        />\n      </circle>\n      <circle cx=\"12\" cy=\"12\" r=\"3\" opacity=\"0.4\">\n        <animate\n          fill=\"freeze\"\n          attributeName=\"opacity\"\n          begin=\"clickyLoadDotA.begin+0.15s\"\n          dur=\"0.75s\"\n          values=\"1;0.2\"\n        />\n      </circle>\n      <circle cx=\"20\" cy=\"12\" r=\"3\" opacity=\"0.3\">\n        <animate\n          id=\"clickyLoadDotC\"\n          fill=\"freeze\"\n          attributeName=\"opacity\"\n          begin=\"clickyLoadDotA.begin+0.3s\"\n          dur=\"0.75s\"\n          values=\"1;0.2\"\n        />\n      </circle>\n    </svg>\n  ),\n);\nLoadingDots.displayName = \"LoadingDots\";\n\n/**\n * Loading indicator built on the shared 3-dot animation.\n *\n * `centered` establishes a size container (`container-type: inline-size`) so the\n * default `responsive` size scales the dots to the space the loader is given —\n * small inside a narrow panel, large on a full-page route shell. The `inline`\n * variant is not a container, so a `responsive` request there renders at `sm`.\n */\nexport const Loading = forwardRef<HTMLDivElement, LoadingProps>(\n  ({ size = \"responsive\", variant = \"inline\", label, className, ...props }, ref) => {\n    const effectiveSize =\n      variant === \"inline\" && size === \"responsive\" ? \"sm\" : size;\n    const isResponsive = effectiveSize === \"responsive\";\n    const dotClass = isResponsive\n      ? RESPONSIVE_DOT_SIZE\n      : FIXED_DOT_SIZE[effectiveSize];\n\n    if (variant === \"centered\") {\n      return (\n        <div\n          ref={ref}\n          role=\"status\"\n          aria-label=\"Loading\"\n          className={cn(\n            \"flex min-h-32 w-full flex-col items-center justify-center gap-3 text-muted-foreground\",\n            \"[container-type:inline-size]\",\n            className,\n          )}\n          {...props}\n        >\n          <LoadingDots className={dotClass} />\n          {label != null && (\n            <span className={cn(isResponsive ? RESPONSIVE_LABEL_SIZE : \"text-sm\")}>\n              {label}\n            </span>\n          )}\n        </div>\n      );\n    }\n\n    return (\n      <div\n        ref={ref}\n        role=\"status\"\n        aria-label=\"Loading\"\n        className={cn(\n          \"inline-flex items-center gap-2 text-muted-foreground\",\n          className,\n        )}\n        {...props}\n      >\n        <LoadingDots className={dotClass} />\n        {label != null && <span className=\"text-sm\">{label}</span>}\n      </div>\n    );\n  },\n);\nLoading.displayName = \"Loading\";\n"],"names":["forwardRef","jsxs","cn","jsx"],"mappings":";;;;;AAoBA,MAAM,iBAAqE;AAAA,EACzE,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AACN;AAKA,MAAM,sBAAsB;AAC5B,MAAM,wBAAwB;AAOvB,MAAM,cAAcA,MAAAA;AAAAA,EACzB,CAAC,EAAE,WAAW,GAAG,MAAA,GAAS,QACxBC,2BAAAA;AAAAA,IAAC;AAAA,IAAA;AAAA,MACC;AAAA,MACA,OAAM;AAAA,MACN,SAAQ;AAAA,MACR,MAAK;AAAA,MACL,eAAY;AAAA,MACZ,WAAWC,MAAAA,GAAG,YAAY,SAAS;AAAA,MAClC,GAAG;AAAA,MAEJ,UAAA;AAAA,QAAAC,+BAAC,YAAO,IAAG,KAAI,IAAG,MAAK,GAAE,KACvB,UAAAA,2BAAAA;AAAAA,UAAC;AAAA,UAAA;AAAA,YACC,IAAG;AAAA,YACH,MAAK;AAAA,YACL,eAAc;AAAA,YACd,OAAM;AAAA,YACN,KAAI;AAAA,YACJ,QAAO;AAAA,UAAA;AAAA,QAAA,GAEX;AAAA,QACAA,2BAAAA,IAAC,YAAO,IAAG,MAAK,IAAG,MAAK,GAAE,KAAI,SAAQ,OACpC,UAAAA,2BAAAA;AAAAA,UAAC;AAAA,UAAA;AAAA,YACC,MAAK;AAAA,YACL,eAAc;AAAA,YACd,OAAM;AAAA,YACN,KAAI;AAAA,YACJ,QAAO;AAAA,UAAA;AAAA,QAAA,GAEX;AAAA,QACAA,2BAAAA,IAAC,YAAO,IAAG,MAAK,IAAG,MAAK,GAAE,KAAI,SAAQ,OACpC,UAAAA,2BAAAA;AAAAA,UAAC;AAAA,UAAA;AAAA,YACC,IAAG;AAAA,YACH,MAAK;AAAA,YACL,eAAc;AAAA,YACd,OAAM;AAAA,YACN,KAAI;AAAA,YACJ,QAAO;AAAA,UAAA;AAAA,QAAA,EACT,CACF;AAAA,MAAA;AAAA,IAAA;AAAA,EAAA;AAGN;AACA,YAAY,cAAc;AAUnB,MAAM,UAAUH,MAAAA;AAAAA,EACrB,CAAC,EAAE,OAAO,cAAc,UAAU,UAAU,OAAO,WAAW,GAAG,MAAA,GAAS,QAAQ;AAChF,UAAM,gBACJ,YAAY,YAAY,SAAS,eAAe,OAAO;AACzD,UAAM,eAAe,kBAAkB;AACvC,UAAM,WAAW,eACb,sBACA,eAAe,aAAa;AAEhC,QAAI,YAAY,YAAY;AAC1B,aACEC,2BAAAA;AAAAA,QAAC;AAAA,QAAA;AAAA,UACC;AAAA,UACA,MAAK;AAAA,UACL,cAAW;AAAA,UACX,WAAWC,MAAAA;AAAAA,YACT;AAAA,YACA;AAAA,YACA;AAAA,UAAA;AAAA,UAED,GAAG;AAAA,UAEJ,UAAA;AAAA,YAAAC,2BAAAA,IAAC,aAAA,EAAY,WAAW,SAAA,CAAU;AAAA,YACjC,SAAS,QACRA,+BAAC,QAAA,EAAK,WAAWD,SAAG,eAAe,wBAAwB,SAAS,GACjE,UAAA,MAAA,CACH;AAAA,UAAA;AAAA,QAAA;AAAA,MAAA;AAAA,IAIR;AAEA,WACED,2BAAAA;AAAAA,MAAC;AAAA,MAAA;AAAA,QACC;AAAA,QACA,MAAK;AAAA,QACL,cAAW;AAAA,QACX,WAAWC,MAAAA;AAAAA,UACT;AAAA,UACA;AAAA,QAAA;AAAA,QAED,GAAG;AAAA,QAEJ,UAAA;AAAA,UAAAC,2BAAAA,IAAC,aAAA,EAAY,WAAW,SAAA,CAAU;AAAA,UACjC,SAAS,QAAQA,2BAAAA,IAAC,QAAA,EAAK,WAAU,WAAW,UAAA,MAAA,CAAM;AAAA,QAAA;AAAA,MAAA;AAAA,IAAA;AAAA,EAGzD;AACF;AACA,QAAQ,cAAc;;;"}

package/dist/components/loading.d.ts

@@ -0,0 +1,27 @@
+import { HTMLAttributes, ReactNode, SVGProps } from 'react';
+export type LoadingSize = "sm" | "md" | "lg" | "responsive";
+export type LoadingVariant = "inline" | "centered";
+export interface LoadingProps extends HTMLAttributes<HTMLDivElement> {
+    /** Fixed size, or `responsive` (default) to scale with the container. */
+    size?: LoadingSize;
+    /** `inline` for a small in-flow loader, `centered` for a section/page loader. */
+    variant?: LoadingVariant;
+    /** Optional caption rendered beside (inline) or beneath (centered) the dots. */
+    label?: ReactNode;
+}
+/**
+ * Three bouncing dots. `fill="currentColor"` so the dots inherit the surrounding
+ * theme text color (works in light and dark). Size is driven entirely by the
+ * className (width + height); the viewBox keeps the 1:1 aspect.
+ */
+export declare const LoadingDots: import('react').ForwardRefExoticComponent<Omit<SVGProps<SVGSVGElement>, "ref"> & import('react').RefAttributes<SVGSVGElement>>;
+/**
+ * Loading indicator built on the shared 3-dot animation.
+ *
+ * `centered` establishes a size container (`container-type: inline-size`) so the
+ * default `responsive` size scales the dots to the space the loader is given —
+ * small inside a narrow panel, large on a full-page route shell. The `inline`
+ * variant is not a container, so a `responsive` request there renders at `sm`.
+ */
+export declare const Loading: import('react').ForwardRefExoticComponent<LoadingProps & import('react').RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=loading.d.ts.map

package/dist/components/loading.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loading.d.ts","sourceRoot":"","sources":["../../src/components/loading.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,QAAQ,EACd,MAAM,OAAO,CAAC;AAGf,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,YAAY,CAAC;AAC5D,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEnD,MAAM,WAAW,YAAa,SAAQ,cAAc,CAAC,cAAc,CAAC;IAClE,yEAAyE;IACzE,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,iFAAiF;IACjF,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,gFAAgF;IAChF,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAcD;;;;GAIG;AACH,eAAO,MAAM,WAAW,gIA0CvB,CAAC;AAGF;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO,yGAgDnB,CAAC"}