cursedbelt 0.0.0 → 2.3.0

package/dist/react/schema-fields/SchemaFields.js

@@ -0,0 +1,200 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { parseLoose } from 'cwip/json';
+import { ArrowDown, ArrowUp, Plus, X } from 'lucide-react';
+import { useEffect, useRef, useState } from 'react';
+import { Button } from '../components/Button';
+import { Collapsible } from '../components/Collapsible';
+import { FieldInput } from '../components/FieldInput';
+import { FieldLabel } from '../components/FieldLabel';
+import { IconButton } from '../components/IconButton';
+import { JsonEditor } from '../components/JsonEditor';
+import { Slider } from '../components/Slider';
+import { cn } from '../lib/cn';
+/**
+ * The schema-driven object editor: renders one widget per {@link FieldDescriptor}
+ * via the shared field-type registry ({@link FieldInput}) and composes the
+ * structural kinds itself — `fieldset` (nested object), `list` (array rows with
+ * add / remove / reorder), and `json` (validated free-form fallback that never
+ * commits invalid input). Values round-trip TYPED: numbers stay numbers, arrays
+ * stay arrays — a text widget is never silently substituted for a structured
+ * value. Fields hinted `advanced` collapse under an "Advanced" section.
+ */
+export function SchemaFields({ fields, value, onChange, validate, messages, idPrefix = 'schema-field', className, }) {
+    const basic = fields.filter((f) => !f.advanced);
+    const advanced = fields.filter((f) => f.advanced);
+    const setField = (field, next) => {
+        const merged = { ...value };
+        if (next === undefined)
+            delete merged[field.name];
+        else
+            merged[field.name] = next;
+        onChange(merged);
+    };
+    const rows = (list) => list.map((field) => (_jsx(FieldRow, { field: field, value: value[field.name], onChange: (next) => setField(field, next), validate: validate, messages: messages?.[field.path], id: `${idPrefix}-${field.path.replace(/[^\w-]+/g, '-')}` }, field.path)));
+    return (_jsxs("div", { className: cn('flex flex-col gap-3', className), children: [rows(basic), advanced.length > 0 && (_jsx(Collapsible, { trigger: _jsx("span", { className: 'text-sm font-medium', children: "Advanced" }), children: _jsx("div", { className: 'flex flex-col gap-3 pt-2', children: rows(advanced) }) }))] }));
+}
+/** A sensible starter value for a new list row (or a cleared field) of this shape. */
+export function emptyValueFor(field) {
+    if (field.defaultValue !== undefined) {
+        // JSON clone so rows never share a mutable default.
+        return JSON.parse(JSON.stringify(field.defaultValue));
+    }
+    switch (field.type) {
+        case 'boolean':
+            return false;
+        case 'number':
+            return field.constraints?.min ?? 0;
+        case 'enum':
+        case 'literal':
+            return field.options?.[0]?.value ?? '';
+        case 'string':
+        case 'date':
+            return '';
+        case 'array':
+            return [];
+        case 'object':
+            return Object.fromEntries((field.fields ?? [])
+                .filter((f) => !f.optional)
+                .map((f) => [f.name, emptyValueFor(f)]));
+        case 'record':
+            return {};
+        default:
+            return null;
+    }
+}
+const MESSAGE_TONE = {
+    error: 'text-destructive',
+    warning: 'text-warning',
+    info: 'text-muted-foreground',
+};
+/** Ambient messages under a control, most severe first. */
+function FieldMessages({ messages }) {
+    const rank = { error: 0, warning: 1, info: 2 };
+    return (_jsx(_Fragment, { children: [...messages]
+            .sort((a, b) => rank[a.severity] - rank[b.severity])
+            .map((message) => (_jsx("p", { className: cn('text-xs', MESSAGE_TONE[message.severity]), children: message.text }, `${message.severity}:${message.text}`))) }));
+}
+/** Label + description + inline error around one field's control. */
+function FieldRow({ field, value, onChange, validate, messages, id, }) {
+    const [error, setError] = useState(null);
+    const commit = (next) => {
+        const result = validate?.(field.path, next);
+        setError(result && !result.ok ? result.message : null);
+        onChange(next);
+    };
+    const ambient = messages && messages.length > 0 ? _jsx(FieldMessages, { messages: messages }) : null;
+    const control = (_jsx(ValueControl, { field: field, 
+        // Unset values display the schema/default value (editing materializes it).
+        value: value ?? field.defaultValue, onChange: commit, validate: validate, id: id }));
+    if (field.kind === 'boolean') {
+        return (_jsxs("div", { className: 'flex flex-col gap-1', "data-cc-field": field.path, children: [_jsxs("div", { className: 'flex items-center justify-between gap-3', children: [_jsx(FieldLabel, { hint: field.description, className: 'text-sm', children: field.label }), control] }), error && _jsx("p", { className: 'text-xs text-destructive', children: error }), ambient] }));
+    }
+    return (_jsxs("div", { className: 'flex flex-col gap-1', "data-cc-field": field.path, children: [_jsx(FieldLabel, { hint: field.description, className: 'text-sm', children: field.label }), control, error && _jsx("p", { className: 'text-xs text-destructive', children: error }), ambient] }));
+}
+/** Dispatch a single value of any kind to its editor (used for object properties
+ *  AND array rows, which is what makes the recursion uniform). */
+function ValueControl({ field, value, onChange, validate, id }) {
+    switch (field.kind) {
+        case 'fieldset':
+            return (_jsx("div", { className: 'rounded-md border border-border p-3', children: _jsx(SchemaFields, { fields: field.fields ?? [], value: value ?? {}, onChange: onChange, validate: validate, idPrefix: id }) }));
+        case 'list':
+            return (_jsx(ListEditor, { field: field, value: value, onChange: onChange, validate: validate, id: id }));
+        case 'json':
+            return (_jsx(JsonValueEditor, { field: field, value: value, onChange: onChange, validate: validate, id: id }));
+        case 'slider': {
+            const c = field.constraints ?? {};
+            const current = typeof value === 'number' ? value : (field.defaultValue ?? c.min ?? 0);
+            return (_jsxs("div", { className: 'flex items-center gap-3', children: [_jsx(Slider, { value: current, min: c.min ?? 0, max: c.max ?? 100, step: c.step ?? 1, onChange: onChange, "aria-label": field.label, className: 'flex-1' }), _jsx("span", { className: 'w-10 shrink-0 text-right font-mono text-xs text-muted-foreground', children: current })] }));
+        }
+        default:
+            return _jsx(LeafControl, { field: field, value: value, onChange: onChange, id: id });
+    }
+}
+/** Registry-dispatched leaf widget, with commits coerced back to the field's type. */
+function LeafControl({ field, value, onChange, id }) {
+    const spec = {
+        key: field.path,
+        type: field.kind,
+        label: field.label,
+        placeholder: field.placeholder,
+        options: field.options,
+        min: field.constraints?.min,
+        max: field.constraints?.max,
+        step: field.constraints?.step,
+        meta: field.rows != null ? { rows: field.rows } : undefined,
+    };
+    const commit = (raw) => {
+        if (field.type === 'number') {
+            const text = typeof raw === 'string' ? raw.trim() : raw;
+            if (text === '')
+                return onChange(field.optional ? undefined : undefined);
+            const n = typeof text === 'number' ? text : Number(text);
+            if (!Number.isNaN(n))
+                onChange(n);
+            return;
+        }
+        onChange(raw);
+    };
+    return (_jsx(FieldInput, { fieldSpec: spec, id: id, value: value ?? field.defaultValue, onChange: commit }));
+}
+function ListEditor({ field, value, onChange, validate, id }) {
+    const items = Array.isArray(value) ? value : [];
+    const item = field.item;
+    if (!item) {
+        return (_jsx(JsonValueEditor, { field: field, value: value, onChange: onChange, validate: validate, id: id }));
+    }
+    const noun = field.itemLabel ?? 'Item';
+    const replace = (index, next) => onChange(items.map((v, i) => (i === index ? next : v)));
+    const remove = (index) => onChange(items.filter((_, i) => i !== index));
+    const move = (index, delta) => {
+        const target = index + delta;
+        if (target < 0 || target >= items.length)
+            return;
+        const next = [...items];
+        const [row] = next.splice(index, 1);
+        next.splice(target, 0, row);
+        onChange(next);
+    };
+    return (_jsxs("div", { className: 'flex flex-col gap-2', children: [items.map((row, index) => (_jsxs("div", { className: 'flex items-start gap-1 rounded-md border border-border p-2', children: [_jsx("div", { className: 'min-w-0 flex-1', children: _jsx(ValueControl, { field: { ...item, path: `${field.path}.${index}` }, value: row, onChange: (next) => replace(index, next), validate: validate, id: `${id}-${index}` }) }), _jsxs("div", { className: 'flex shrink-0 flex-col', children: [_jsx(IconButton, { label: `Move ${noun.toLowerCase()} up`, disabled: index === 0, onClick: () => move(index, -1), children: _jsx(ArrowUp, {}) }), _jsx(IconButton, { label: `Move ${noun.toLowerCase()} down`, disabled: index === items.length - 1, onClick: () => move(index, 1), children: _jsx(ArrowDown, {}) }), _jsx(IconButton, { label: `Remove ${noun.toLowerCase()}`, onClick: () => remove(index), children: _jsx(X, {}) })] })] }, index))), _jsxs(Button, { variant: 'secondary', size: 'sm', leftIcon: _jsx(Plus, {}), onClick: () => onChange([...items, emptyValueFor(item)]), tooltip: `Add ${noun.toLowerCase()}`, children: ["Add ", noun.toLowerCase()] })] }));
+}
+const stringifyJsonValue = (value) => value === undefined ? '' : JSON.stringify(value, null, 2);
+/** Free-form fallback: a JSON editor whose commits are gated on a clean parse AND
+ *  the domain validator — invalid text NEVER reaches `onChange`, so a structured
+ *  value can't be destroyed by a half-typed edit. */
+function JsonValueEditor({ field, value, onChange, validate, id }) {
+    const [text, setText] = useState(() => stringifyJsonValue(value ?? field.defaultValue));
+    const [error, setError] = useState(null);
+    const lastCommitted = useRef(value);
+    useEffect(() => {
+        if (value !== lastCommitted.current) {
+            lastCommitted.current = value;
+            setText(stringifyJsonValue(value));
+            setError(null);
+        }
+    }, [value]);
+    return (_jsxs("div", { className: 'flex flex-col gap-1', children: [_jsx(JsonEditor, { id: id, value: text, rows: 4, formatLabel: null, onChange: (nextText) => {
+                    setText(nextText);
+                    if (nextText.trim() === '') {
+                        setError(null);
+                        if (field.optional) {
+                            lastCommitted.current = undefined;
+                            onChange(undefined);
+                        }
+                        return;
+                    }
+                    const parsed = parseLoose(nextText);
+                    if (!parsed.ok) {
+                        setError(null); // JsonEditor's own status line already reports parse errors.
+                        return;
+                    }
+                    const result = validate?.(field.path, parsed.value);
+                    if (result && !result.ok) {
+                        setError(result.message);
+                        return;
+                    }
+                    setError(null);
+                    lastCommitted.current = parsed.value;
+                    onChange(parsed.value);
+                } }), error && _jsx("p", { className: 'text-xs text-destructive', children: error })] }));
+}
+//# sourceMappingURL=SchemaFields.js.map

package/dist/react/schema-fields/SchemaFields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaFields.js","sourceRoot":"","sources":["../../../src/react/schema-fields/SchemaFields.tsx"],"names":[],"mappings":"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"}

package/dist/react/schema-fields/describeSchema.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Zod schema → {@link FieldDescriptor}[] — the ONE reflection walker.
+ *
+ * This lived in cursedshell (`core-engine/reflection.ts` + `field-meta.ts`) and
+ * moved down here for a structural reason, not a tidiness one: the descriptor
+ * types, the `SchemaFields` renderer that consumes them, and now the engine
+ * studio's inspector (which reflects `FeaturesByEngine` — a cursedbelt schema)
+ * all live at THIS layer. A walker one layer up meant the only way to drive a
+ * form from a cursedbelt schema was to write a second walker, and a second
+ * walker is how "the inspector shows a checkbox for a field the schema made a
+ * number" happens. cursedshell re-exports these symbols, so its public API and
+ * every plugin's `field(...)` call are unchanged.
+ *
+ * Despite the `src/react/` path this module imports no React (see the note on
+ * `types.ts`'s re-export in the root index) — it is pure over zod objects and is
+ * consumed by React-free callers (`cursedshell/contract`, the catalog scanner).
+ *
+ * Schemas are walked via `_zod.def.type` STRING tags, never `instanceof`, so a
+ * schema constructed by another package's bundled copy of zod reflects
+ * identically to one built here. That is load-bearing in this monorepo: plugins,
+ * cursedbelt and the generator do not share a single zod instance.
+ */
+import type { z } from 'zod';
+import { type FieldDescriptor, type FieldUiHints } from './types';
+/**
+ * UI hints ride on zod's own `.meta()` registry under this key, co-located with
+ * the schema they describe. That reaches everywhere a sibling map can't —
+ * nested object properties, array items — and survives cross-package zod copies
+ * because reads go through the schema's own `.meta()` method.
+ *
+ * The literal is `cursedshell:ui` and MUST stay that way. It is written into
+ * schema metadata by every plugin that has ever called `field(...)`; renaming it
+ * on the move down here would silently drop the hints off every one of them
+ * (an unhinted field still renders, just with the wrong widget — the worst kind
+ * of regression, because nothing fails).
+ */
+export declare const UI_META_KEY = "cursedshell:ui";
+/**
+ * Attach UI field hints to a schema — the widget-mapping half of the metadata
+ * contract. Wrap any field of a `configSchema` / `propsSchema`:
+ *
+ *   z.object({
+ *     accent: field(z.string(), { kind: 'color', description: 'Accent color' }),
+ *     damping: field(z.number().min(0).max(100), { kind: 'slider' }),
+ *   })
+ *
+ * `describeSchema` resolves these into each field's descriptor; unhinted fields
+ * still get a widget derived from their type.
+ */
+export declare function field<S extends z.ZodType>(schema: S, hints: FieldUiHints): S;
+/**
+ * Read the UI hints attached to a schema, unwrapping Optional / Nullable /
+ * Default / Readonly wrappers (the outermost hints win — wrapping an annotated
+ * schema in `.optional()` keeps its hints reachable).
+ */
+export declare function uiHintsOf(schema: z.ZodType): FieldUiHints | undefined;
+/**
+ * Reflect an object schema (a plugin `configSchema`, a component `propsSchema`,
+ * an engine's `FeaturesByEngine` entry) into serializable field descriptors.
+ * `defaults` overrides schema-level `.default()`s at the TOP level only.
+ *
+ * Typed loosely on purpose: callers pass zod objects built by their OWN copy of
+ * zod, whose nominal types do not unify with this package's.
+ */
+export declare function describeSchema(schema: {
+    shape?: unknown;
+} | z.ZodType, defaults?: Record<string, unknown>): FieldDescriptor[];
+//# sourceMappingURL=describeSchema.d.ts.map

package/dist/react/schema-fields/describeSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describeSchema.d.ts","sourceRoot":"","sources":["../../../src/react/schema-fields/describeSchema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAGL,KAAK,eAAe,EAEpB,KAAK,YAAY,EAElB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,WAAW,mBAAmB,CAAC;AAE5C;;;;;;;;;;;GAWG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,YAAY,GAAG,CAAC,CAE5E;AAyDD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,GAAG,YAAY,GAAG,SAAS,CAErE;AAkJD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,CAAC,CAAC,OAAO,EACvC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,eAAe,EAAE,CAEnB"}

package/dist/react/schema-fields/describeSchema.js

@@ -0,0 +1,210 @@
+import { defaultKindFor, humanizeFieldName, } from './types';
+/**
+ * UI hints ride on zod's own `.meta()` registry under this key, co-located with
+ * the schema they describe. That reaches everywhere a sibling map can't —
+ * nested object properties, array items — and survives cross-package zod copies
+ * because reads go through the schema's own `.meta()` method.
+ *
+ * The literal is `cursedshell:ui` and MUST stay that way. It is written into
+ * schema metadata by every plugin that has ever called `field(...)`; renaming it
+ * on the move down here would silently drop the hints off every one of them
+ * (an unhinted field still renders, just with the wrong widget — the worst kind
+ * of regression, because nothing fails).
+ */
+export const UI_META_KEY = 'cursedshell:ui';
+/**
+ * Attach UI field hints to a schema — the widget-mapping half of the metadata
+ * contract. Wrap any field of a `configSchema` / `propsSchema`:
+ *
+ *   z.object({
+ *     accent: field(z.string(), { kind: 'color', description: 'Accent color' }),
+ *     damping: field(z.number().min(0).max(100), { kind: 'slider' }),
+ *   })
+ *
+ * `describeSchema` resolves these into each field's descriptor; unhinted fields
+ * still get a widget derived from their type.
+ */
+export function field(schema, hints) {
+    return schema.meta({ [UI_META_KEY]: hints });
+}
+const defOf = (schema) => schema._zod?.def ?? {};
+const WRAPPERS = new Set(['optional', 'nullable', 'default', 'readonly']);
+/** Peel Optional/Nullable/Default/Readonly wrappers, collecting the outermost
+ *  hints/description/default seen on the way down. */
+function unwrap(schema) {
+    let inner = schema;
+    let optional = false;
+    let defaultValue;
+    let hints;
+    let description;
+    for (let depth = 0; depth < 10; depth++) {
+        const meta = inner.meta?.();
+        hints ??= meta?.[UI_META_KEY];
+        description ??= typeof meta?.description === 'string' ? meta.description : undefined;
+        const def = defOf(inner);
+        if (!def.type || !WRAPPERS.has(def.type) || !def.innerType)
+            break;
+        if (def.type === 'optional' || def.type === 'nullable')
+            optional = true;
+        if (def.type === 'default' && defaultValue === undefined) {
+            defaultValue = typeof def.defaultValue === 'function' ? def.defaultValue() : def.defaultValue;
+            // A defaulted field never blocks submission — treat as optional input.
+            optional = true;
+        }
+        inner = def.innerType;
+    }
+    return { inner, optional, defaultValue, hints, description };
+}
+/**
+ * Read the UI hints attached to a schema, unwrapping Optional / Nullable /
+ * Default / Readonly wrappers (the outermost hints win — wrapping an annotated
+ * schema in `.optional()` keeps its hints reachable).
+ */
+export function uiHintsOf(schema) {
+    return unwrap(schema).hints;
+}
+function fieldTypeOf(def) {
+    switch (def.type) {
+        case 'string':
+            return 'string';
+        case 'number':
+        case 'int':
+            return 'number';
+        case 'boolean':
+            return 'boolean';
+        case 'enum':
+            return 'enum';
+        case 'literal':
+            return 'literal';
+        case 'array':
+        case 'tuple':
+            return 'array';
+        case 'object':
+            return 'object';
+        case 'record':
+        case 'map':
+            return 'record';
+        case 'union':
+        case 'intersection':
+            return 'union';
+        case 'date':
+            return 'date';
+        default:
+            return 'unknown';
+    }
+}
+function constraintsOf(def) {
+    const checks = def.checks ?? [];
+    if (checks.length === 0)
+        return undefined;
+    const out = {};
+    for (const check of checks) {
+        const c = check._zod?.def ?? {};
+        switch (c.check) {
+            case 'min_length':
+                out.minLength = c.minimum;
+                break;
+            case 'max_length':
+                out.maxLength = c.maximum;
+                break;
+            case 'greater_than':
+                out.min = c.value;
+                break;
+            case 'less_than':
+                out.max = c.value;
+                break;
+            case 'multiple_of':
+                out.step = c.value;
+                break;
+            case 'number_format':
+                if (c.format === 'safeint' || c.format === 'int32')
+                    out.int = true;
+                break;
+            case 'string_format':
+                if (c.format === 'regex' && c.pattern != null)
+                    out.pattern = String(c.pattern);
+                break;
+        }
+    }
+    return Object.keys(out).length > 0 ? out : undefined;
+}
+function describeType(schema, path, name, callerDefault) {
+    const { inner, optional, defaultValue, hints, description } = unwrap(schema);
+    const def = defOf(inner);
+    const type = fieldTypeOf(def);
+    const constraints = {
+        ...constraintsOf(def),
+        ...(hints?.min !== undefined && { min: hints.min }),
+        ...(hints?.max !== undefined && { max: hints.max }),
+        ...(hints?.step !== undefined && { step: hints.step }),
+    };
+    const hasConstraints = Object.keys(constraints).length > 0;
+    const kind = hints?.kind ??
+        (type === 'number' && constraints.min !== undefined && constraints.max !== undefined
+            ? 'slider'
+            : defaultKindFor(type));
+    const descriptor = {
+        path,
+        name,
+        label: hints?.label ?? (name ? humanizeFieldName(name) : 'Item'),
+        type,
+        kind,
+        optional,
+        ...(hints?.description ?? description ? { description: hints?.description ?? description } : {}),
+        ...(callerDefault !== undefined || defaultValue !== undefined
+            ? { defaultValue: callerDefault ?? defaultValue }
+            : {}),
+        ...(hasConstraints ? { constraints } : {}),
+        ...(hints?.placeholder ? { placeholder: hints.placeholder } : {}),
+        ...(hints?.rows !== undefined ? { rows: hints.rows } : {}),
+        ...(hints?.itemLabel ? { itemLabel: hints.itemLabel } : {}),
+        ...(hints?.advanced ? { advanced: true } : {}),
+    };
+    if (type === 'enum' && def.entries) {
+        descriptor.options = Object.values(def.entries).map((value) => ({ value: String(value) }));
+    }
+    else if (type === 'literal' && def.values) {
+        descriptor.options = def.values.map((value) => ({ value: String(value) }));
+    }
+    else if (type === 'array' && def.element) {
+        descriptor.item = describeType(def.element, `${path}[]`, '');
+    }
+    else if (type === 'object') {
+        descriptor.fields = describeShape(inner, path);
+    }
+    return descriptor;
+}
+function orderOf(shape, name) {
+    const child = shape[name];
+    if (!child)
+        return Number.MAX_SAFE_INTEGER;
+    const { hints } = unwrap(child);
+    return hints?.order ?? Number.MAX_SAFE_INTEGER;
+}
+function describeShape(schema, parentPath, defaults) {
+    const shape = schema.shape ?? defOf(schema).shape ?? {};
+    const fields = Object.entries(shape).map(([name, child]) => describeType(child, parentPath ? `${parentPath}.${name}` : name, name, defaults?.[name]));
+    // Hinted orders win; unhinted fields keep declaration order after them.
+    return fields
+        .map((field_, index) => ({ field: field_, index }))
+        .sort((a, b) => {
+        const ao = orderOf(shape, a.field.name);
+        const bo = orderOf(shape, b.field.name);
+        if (ao !== bo)
+            return ao - bo;
+        return a.index - b.index;
+    })
+        .map(({ field: field_ }) => field_);
+}
+/**
+ * Reflect an object schema (a plugin `configSchema`, a component `propsSchema`,
+ * an engine's `FeaturesByEngine` entry) into serializable field descriptors.
+ * `defaults` overrides schema-level `.default()`s at the TOP level only.
+ *
+ * Typed loosely on purpose: callers pass zod objects built by their OWN copy of
+ * zod, whose nominal types do not unify with this package's.
+ */
+export function describeSchema(schema, defaults) {
+    return describeShape(schema, '', defaults);
+}
+//# sourceMappingURL=describeSchema.js.map

package/dist/react/schema-fields/describeSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describeSchema.js","sourceRoot":"","sources":["../../../src/react/schema-fields/describeSchema.ts"],"names":[],"mappings":"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"}

package/dist/react/schema-fields/types.d.ts

@@ -0,0 +1,86 @@
+import type { FieldOption } from '../components/FieldInput';
+/**
+ * The widget a field renders with. Leaf kinds are field-registry type keys
+ * (see {@link FieldInput}'s base registry — `text`, `number`, `boolean`,
+ * `select`, `color`, … plus app-registered types), so any registered control is
+ * addressable from a schema. Three structural kinds are handled by
+ * {@link SchemaFields} itself rather than the registry:
+ *
+ * - `fieldset` — a nested object rendered as a collapsible group of fields.
+ * - `list` — an array rendered as add/remove/reorderable rows.
+ * - `json` — the safe fallback for shapes with no structured editor (unions,
+ *   records, unknowns): a validated JSON editor that never commits bad input.
+ */
+export type FieldKind = 'text' | 'longtext' | 'number' | 'slider' | 'boolean' | 'select' | 'multiselect' | 'tags' | 'color' | 'url' | 'date' | 'datetime' | 'rating' | 'emoji' | 'password' | 'code' | 'combobox' | 'fieldset' | 'list' | 'json' | (string & {});
+/**
+ * Authoring-time hints a schema owner attaches to a field (e.g. via cursedshell's
+ * `field(schema, hints)`) to override what type-derivation alone would pick —
+ * `kind: 'color'` on a hex string, `slider` bounds on a number, a human label.
+ * Everything here is optional; a descriptor is complete without hints.
+ */
+export interface FieldUiHints {
+    /** Override the derived widget (e.g. `'color'` for a hex string prop). */
+    kind?: FieldKind;
+    label?: string;
+    description?: string;
+    placeholder?: string;
+    /** Numeric bounds/step for `number`/`slider` (also derivable from schema checks). */
+    min?: number;
+    max?: number;
+    step?: number;
+    /** Rows for `longtext` textareas. */
+    rows?: number;
+    /** The noun for one row of a `list` field ("Crumb", "Column"). */
+    itemLabel?: string;
+    /** Sort weight within the parent (lower first; unhinted fields keep declaration order). */
+    order?: number;
+    /** Tuck the field under a collapsed "Advanced" group. */
+    advanced?: boolean;
+}
+/** The structural type of a field's value, independent of the widget rendering it. */
+export type FieldType = 'string' | 'number' | 'boolean' | 'enum' | 'literal' | 'array' | 'object' | 'record' | 'union' | 'date' | 'unknown';
+/** Validation facts extracted from a schema, used for widget config and doc pages. */
+export interface FieldConstraints {
+    min?: number;
+    max?: number;
+    step?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    int?: boolean;
+}
+/**
+ * One fully-resolved, JSON-serializable field description — the shared contract
+ * between schema reflection (cursedshell's `describeSchema`) and rendering
+ * ({@link SchemaFields}) / documentation. `kind` is always resolved: a hint wins,
+ * otherwise it is derived from `type`.
+ */
+export interface FieldDescriptor {
+    /** Dot path from the value root; an array's item descriptor appends `[]`. */
+    path: string;
+    /** Property key under the parent (`''` for an array item descriptor). */
+    name: string;
+    /** Display label: hint label, else the humanized name. */
+    label: string;
+    type: FieldType;
+    kind: FieldKind;
+    description?: string;
+    optional: boolean;
+    defaultValue?: unknown;
+    /** Choices for `enum`-typed fields (feeds select/multiselect controls). */
+    options?: FieldOption[];
+    constraints?: FieldConstraints;
+    placeholder?: string;
+    rows?: number;
+    itemLabel?: string;
+    advanced?: boolean;
+    /** Element descriptor when `type === 'array'`. */
+    item?: FieldDescriptor;
+    /** Property descriptors when `type === 'object'`. */
+    fields?: FieldDescriptor[];
+}
+/** "primaryColor" / "primary_color" → "Primary Color". */
+export declare function humanizeFieldName(name: string): string;
+/** The widget a structural type gets when no hint overrides it. */
+export declare function defaultKindFor(type: FieldType): FieldKind;
+//# sourceMappingURL=types.d.ts.map

package/dist/react/schema-fields/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/react/schema-fields/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,aAAa,GACb,MAAM,GACN,OAAO,GACP,KAAK,GACL,MAAM,GACN,UAAU,GACV,QAAQ,GACR,OAAO,GACP,UAAU,GACV,MAAM,GACN,UAAU,GACV,UAAU,GACV,MAAM,GACN,MAAM,GACN,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAElB;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,0EAA0E;IAC1E,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qFAAqF;IACrF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2FAA2F;IAC3F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,sFAAsF;AACtF,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,MAAM,GACN,SAAS,GACT,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,MAAM,GACN,SAAS,CAAC;AAEd,sFAAsF;AACtF,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kDAAkD;IAClD,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,qDAAqD;IACrD,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED,0DAA0D;AAC1D,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMtD;AAED,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAoBzD"}

package/dist/react/schema-fields/types.js

@@ -0,0 +1,31 @@
+/** "primaryColor" / "primary_color" → "Primary Color". */
+export function humanizeFieldName(name) {
+    const words = name
+        .replace(/[_-]+/g, ' ')
+        .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+        .trim();
+    return words.replace(/\b\w/g, (c) => c.toUpperCase());
+}
+/** The widget a structural type gets when no hint overrides it. */
+export function defaultKindFor(type) {
+    switch (type) {
+        case 'string':
+            return 'text';
+        case 'number':
+            return 'number';
+        case 'boolean':
+            return 'boolean';
+        case 'enum':
+        case 'literal':
+            return 'select';
+        case 'array':
+            return 'list';
+        case 'object':
+            return 'fieldset';
+        case 'date':
+            return 'date';
+        default:
+            return 'json';
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/react/schema-fields/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/react/schema-fields/types.ts"],"names":[],"mappings":"AAuHA,0DAA0D;AAC1D,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,KAAK,GAAG,IAAI;SACf,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACtC,IAAI,EAAE,CAAC;IACV,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AACxD,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,cAAc,CAAC,IAAe;IAC5C,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC;QAChB,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,MAAM,CAAC;QACZ,KAAK,SAAS;YACZ,OAAO,QAAQ,CAAC;QAClB,KAAK,OAAO;YACV,OAAO,MAAM,CAAC;QAChB,KAAK,QAAQ;YACX,OAAO,UAAU,CAAC;QACpB,KAAK,MAAM;YACT,OAAO,MAAM,CAAC;QAChB;YACE,OAAO,MAAM,CAAC;IAClB,CAAC;AACH,CAAC"}