@modern-admin/ui 0.1.0

package/dist/components/form.jsx

@@ -0,0 +1,66 @@
+// shadcn-style Form: thin wrappers around react-hook-form's `Controller` that
+// pipe field state into accessible label/control/message slots. Apps render
+// `<Form>` (== FormProvider) at the top, then use `<FormField>` per input.
+import * as React from 'react';
+import { Slot } from '@radix-ui/react-slot';
+import { Controller, FormProvider, useFormContext, } from 'react-hook-form';
+import { cn } from '../lib/utils.js';
+import { Label } from './label.js';
+export const Form = FormProvider;
+const FormFieldContext = React.createContext(null);
+export const FormField = ({ ...props }) => (<FormFieldContext.Provider value={{ name: props.name }}>
+      <Controller {...props}/>
+    </FormFieldContext.Provider>);
+const FormItemContext = React.createContext(null);
+export const useFormField = () => {
+    const fieldContext = React.useContext(FormFieldContext);
+    const itemContext = React.useContext(FormItemContext);
+    const { getFieldState, formState } = useFormContext();
+    if (!fieldContext)
+        throw new Error('useFormField must be used within <FormField>');
+    if (!itemContext)
+        throw new Error('useFormField must be used within <FormItem>');
+    const fieldState = getFieldState(fieldContext.name, formState);
+    const { id } = itemContext;
+    return {
+        id,
+        name: fieldContext.name,
+        formItemId: `${id}-form-item`,
+        formDescriptionId: `${id}-form-item-description`,
+        formMessageId: `${id}-form-item-message`,
+        ...fieldState,
+    };
+};
+export const FormItem = React.forwardRef(({ className, ...props }, ref) => {
+    const id = React.useId();
+    return (<FormItemContext.Provider value={{ id }}>
+        <div ref={ref} className={cn('space-y-2', className)} {...props}/>
+      </FormItemContext.Provider>);
+});
+FormItem.displayName = 'FormItem';
+export const FormLabel = React.forwardRef(({ className, ...props }, ref) => {
+    const { error, formItemId } = useFormField();
+    return (<Label ref={ref} className={cn(error && 'text-destructive', className)} htmlFor={formItemId} {...props}/>);
+});
+FormLabel.displayName = 'FormLabel';
+export const FormControl = React.forwardRef(({ ...props }, ref) => {
+    const { error, formItemId, formDescriptionId, formMessageId } = useFormField();
+    return (<Slot ref={ref} id={formItemId} aria-describedby={!error ? `${formDescriptionId}` : `${formDescriptionId} ${formMessageId}`} aria-invalid={!!error} {...props}/>);
+});
+FormControl.displayName = 'FormControl';
+export const FormDescription = React.forwardRef(({ className, ...props }, ref) => {
+    const { formDescriptionId } = useFormField();
+    return (<p ref={ref} id={formDescriptionId} className={cn('text-sm text-muted-foreground', className)} {...props}/>);
+});
+FormDescription.displayName = 'FormDescription';
+export const FormMessage = React.forwardRef(({ className, children, ...props }, ref) => {
+    const { error, formMessageId } = useFormField();
+    const body = error ? String(error.message ?? '') : children;
+    if (!body)
+        return null;
+    return (<p ref={ref} id={formMessageId} className={cn('text-sm font-medium text-destructive', className)} {...props}>
+      {body}
+    </p>);
+});
+FormMessage.displayName = 'FormMessage';
+//# sourceMappingURL=form.jsx.map

package/dist/components/form.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"form.jsx","sourceRoot":"","sources":["../../src/components/form.tsx"],"names":[],"mappings":"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"}

package/dist/components/info-tooltip.d.ts

@@ -0,0 +1,11 @@
+import * as React from 'react';
+import { TooltipContent } from './tooltip.js';
+export interface InfoTooltipProps {
+    content: React.ReactNode;
+    ariaLabel?: string;
+    className?: string;
+    iconClassName?: string;
+    side?: React.ComponentProps<typeof TooltipContent>['side'];
+}
+export declare function InfoTooltip({ content, ariaLabel, className, iconClassName, side, }: InfoTooltipProps): React.ReactElement;
+//# sourceMappingURL=info-tooltip.d.ts.map

package/dist/components/info-tooltip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"info-tooltip.d.ts","sourceRoot":"","sources":["../../src/components/info-tooltip.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B,OAAO,EAAW,cAAc,EAAkB,MAAM,cAAc,CAAA;AAEtE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,KAAK,CAAC,SAAS,CAAA;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,IAAI,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAA;CAC3D;AAED,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,SAAS,EACT,SAAS,EACT,aAAa,EACb,IAAY,GACb,EAAE,gBAAgB,GAAG,KAAK,CAAC,YAAY,CAoBvC"}

package/dist/components/info-tooltip.jsx

@@ -0,0 +1,17 @@
+import * as React from 'react';
+import { Info } from 'lucide-react';
+import { cn } from '../lib/utils.js';
+import { Tooltip, TooltipContent, TooltipTrigger } from './tooltip.js';
+export function InfoTooltip({ content, ariaLabel, className, iconClassName, side = 'top', }) {
+    return (<Tooltip>
+      <TooltipTrigger asChild>
+        <button type="button" aria-label={ariaLabel} className={cn('inline-flex size-4 shrink-0 items-center justify-center rounded-sm text-muted-foreground transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2', className)}>
+          <Info className={cn('size-3.5', iconClassName)}/>
+        </button>
+      </TooltipTrigger>
+      <TooltipContent side={side} className="max-w-80 whitespace-pre-wrap text-left leading-relaxed">
+        {content}
+      </TooltipContent>
+    </Tooltip>);
+}
+//# sourceMappingURL=info-tooltip.jsx.map

package/dist/components/info-tooltip.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"info-tooltip.jsx","sourceRoot":"","sources":["../../src/components/info-tooltip.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AACnC,OAAO,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAA;AACpC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAUtE,MAAM,UAAU,WAAW,CAAC,EAC1B,OAAO,EACP,SAAS,EACT,SAAS,EACT,aAAa,EACb,IAAI,GAAG,KAAK,GACK;IACjB,OAAO,CACL,CAAC,OAAO,CACN;MAAA,CAAC,cAAc,CAAC,OAAO,CACrB;QAAA,CAAC,MAAM,CACL,IAAI,CAAC,QAAQ,CACb,UAAU,CAAC,CAAC,SAAS,CAAC,CACtB,SAAS,CAAC,CAAC,EAAE,CACX,sOAAsO,EACtO,SAAS,CACV,CAAC,CAEF;UAAA,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC,EACjD;QAAA,EAAE,MAAM,CACV;MAAA,EAAE,cAAc,CAChB;MAAA,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,wDAAwD,CAC5F;QAAA,CAAC,OAAO,CACV;MAAA,EAAE,cAAc,CAClB;IAAA,EAAE,OAAO,CAAC,CACX,CAAA;AACH,CAAC"}

package/dist/components/input.d.ts

@@ -0,0 +1,13 @@
+import * as React from 'react';
+export interface InputProps extends React.InputHTMLAttributes<HTMLInputElement> {
+    /**
+     * When provided, a clear button (×) is rendered on the right side of the
+     * input whenever it has a non-empty value. The button is hidden when the
+     * input is disabled or the value is empty.
+     */
+    onClear?: () => void;
+    /** aria-label for the clear button. Defaults to "Clear". */
+    clearLabel?: string;
+}
+export declare const Input: React.ForwardRefExoticComponent<InputProps & React.RefAttributes<HTMLInputElement>>;
+//# sourceMappingURL=input.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../src/components/input.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAI9B,MAAM,WAAW,UAAW,SAAQ,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC;IAC7E;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,eAAO,MAAM,KAAK,qFAsCjB,CAAA"}

package/dist/components/input.jsx

@@ -0,0 +1,19 @@
+import * as React from 'react';
+import { X } from 'lucide-react';
+import { cn } from '../lib/utils.js';
+export const Input = React.forwardRef(({ className, type, onClear, clearLabel, ...props }, ref) => {
+    const showClear = !!onClear && !!props.value && !props.disabled;
+    const input = (<input type={type ?? 'text'} ref={ref} className={cn('flex h-9 w-full rounded-md border border-input bg-background px-3 py-1 text-sm shadow-sm transition-colors file:border-0 file:bg-transparent file:text-sm file:font-medium placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:cursor-not-allowed disabled:opacity-50', 
+        // Hide native number-input spinner buttons (Firefox + WebKit/Blink).
+        '[appearance:textfield] [&::-webkit-outer-spin-button]:m-0 [&::-webkit-outer-spin-button]:appearance-none [&::-webkit-inner-spin-button]:m-0 [&::-webkit-inner-spin-button]:appearance-none', showClear && 'pr-8', className)} {...props}/>);
+    if (!onClear)
+        return input;
+    return (<div className="relative">
+        {input}
+        {showClear && (<button type="button" tabIndex={-1} aria-label={clearLabel ?? 'Clear'} onClick={onClear} className="absolute right-2 top-1/2 -translate-y-1/2 rounded-sm p-0.5 text-muted-foreground opacity-50 hover:opacity-100 focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring">
+            <X className="size-3.5"/>
+          </button>)}
+      </div>);
+});
+Input.displayName = 'Input';
+//# sourceMappingURL=input.jsx.map

package/dist/components/input.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.jsx","sourceRoot":"","sources":["../../src/components/input.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,CAAC,EAAE,MAAM,cAAc,CAAA;AAChC,OAAO,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAA;AAapC,MAAM,CAAC,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CACnC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE;IAC1D,MAAM,SAAS,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAA;IAE/D,MAAM,KAAK,GAAG,CACZ,CAAC,KAAK,CACJ,IAAI,CAAC,CAAC,IAAI,IAAI,MAAM,CAAC,CACrB,GAAG,CAAC,CAAC,GAAG,CAAC,CACT,SAAS,CAAC,CAAC,EAAE,CACX,sUAAsU;QACtU,qEAAqE;QACrE,4LAA4L,EAC5L,SAAS,IAAI,MAAM,EACnB,SAAS,CACV,CAAC,CACF,IAAI,KAAK,CAAC,EACV,CACH,CAAA;IAED,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAA;IAE1B,OAAO,CACL,CAAC,GAAG,CAAC,SAAS,CAAC,UAAU,CACvB;QAAA,CAAC,KAAK,CACN;QAAA,CAAC,SAAS,IAAI,CACZ,CAAC,MAAM,CACL,IAAI,CAAC,QAAQ,CACb,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CACb,UAAU,CAAC,CAAC,UAAU,IAAI,OAAO,CAAC,CAClC,OAAO,CAAC,CAAC,OAAO,CAAC,CACjB,SAAS,CAAC,uLAAuL,CAEjM;YAAA,CAAC,CAAC,CAAC,SAAS,CAAC,UAAU,EACzB;UAAA,EAAE,MAAM,CAAC,CACV,CACH;MAAA,EAAE,GAAG,CAAC,CACP,CAAA;AACH,CAAC,CACF,CAAA;AACD,KAAK,CAAC,WAAW,GAAG,OAAO,CAAA"}

package/dist/components/json-editor.d.ts

@@ -0,0 +1,23 @@
+import * as React from 'react';
+export interface JsonEditorProps {
+    value: unknown;
+    onChange(next: unknown): void;
+    onBlur?(): void;
+    disabled?: boolean;
+    placeholder?: string;
+    rows?: number;
+    className?: string;
+    /** Translated label for the inline "Format" button. */
+    formatLabel?: string;
+    /** Translated prefix for parse-error messages. */
+    invalidLabel?: string;
+}
+export declare function JsonEditor({ value, onChange, onBlur, disabled, placeholder, rows, className, formatLabel, invalidLabel, }: JsonEditorProps): React.ReactElement;
+export interface JsonViewProps {
+    value: unknown;
+    className?: string;
+    /** Render a single-line collapsed `<code>` instead of a pretty `<pre>`. */
+    inline?: boolean;
+}
+export declare function JsonView({ value, className, inline }: JsonViewProps): React.ReactElement;
+//# sourceMappingURL=json-editor.d.ts.map

package/dist/components/json-editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-editor.d.ts","sourceRoot":"","sources":["../../src/components/json-editor.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAwB9B,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,OAAO,CAAA;IACd,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAA;IAC7B,MAAM,CAAC,IAAI,IAAI,CAAA;IACf,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAwBD,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,WAAkB,EAClB,IAAQ,EACR,SAAS,EACT,WAAsB,EACtB,YAA6B,GAC9B,EAAE,eAAe,GAAG,KAAK,CAAC,YAAY,CA+FtC;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,wBAAgB,QAAQ,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,aAAa,GAAG,KAAK,CAAC,YAAY,CA0BxF"}

package/dist/components/json-editor.jsx

@@ -0,0 +1,143 @@
+// JsonEditor + JsonView — editing/displaying JSON-typed property values.
+//
+// Editor: a monospace Textarea with live parse, an inline "Format" button
+// and an error band for parse failures. Calls onChange with the parsed
+// value (object/array/primitive) — never with the raw string — so the form
+// layer stores structured data.
+//
+// View: pretty-printed <pre> for show, single-line collapsed code for list.
+import * as React from 'react';
+import { AlertCircle, Wand2 } from 'lucide-react';
+import { cn } from '../lib/utils.js';
+import { Button } from './button.js';
+import { Textarea } from './textarea.js';
+const stringify = (value) => {
+    if (value == null)
+        return '';
+    if (typeof value === 'string') {
+        // Strings that are themselves JSON come back from some adapters.
+        // Normalize to pretty form; otherwise leave the raw string alone.
+        try {
+            return JSON.stringify(JSON.parse(value), null, 2);
+        }
+        catch {
+            return value;
+        }
+    }
+    try {
+        return JSON.stringify(value, null, 2);
+    }
+    catch {
+        return String(value);
+    }
+};
+// Canonical (key-stable, no whitespace) JSON serialization used to decide
+// whether an externally arriving `value` is structurally identical to what
+// the user is currently typing. Reference comparison would always fail
+// because the parent typically returns a fresh object on every re-render.
+const canonical = (value) => {
+    if (value == null)
+        return '';
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return '';
+    }
+};
+const tryParse = (text) => {
+    if (text.trim() === '')
+        return { ok: true, value: null };
+    try {
+        return { ok: true, value: JSON.parse(text) };
+    }
+    catch {
+        return { ok: false };
+    }
+};
+export function JsonEditor({ value, onChange, onBlur, disabled, placeholder = '{}', rows = 8, className, formatLabel = 'Format', invalidLabel = 'Invalid JSON', }) {
+    const [draft, setDraft] = React.useState(() => stringify(value));
+    const [error, setError] = React.useState(null);
+    // Resync the textarea only when the *external* value differs structurally
+    // from what the user is currently typing. Without the canonical-form check,
+    // every keystroke that produces valid JSON would trigger
+    //   onChange(parsed) → parent re-render → useEffect → setDraft(stringify(value))
+    // and the user's in-progress text would get auto-pretty-printed on every
+    // keystroke. By comparing canonical JSON, our own emissions become no-ops
+    // here, while genuine external resets (record reload, form.reset()) still
+    // refresh the draft.
+    React.useEffect(() => {
+        const parsed = tryParse(draft);
+        const draftCanonical = parsed.ok ? canonical(parsed.value) : '__invalid__';
+        if (draftCanonical === canonical(value))
+            return;
+        setDraft(stringify(value));
+        setError(null);
+        // Intentionally depend only on `value`. `draft` is read via closure: we
+        // only want this to fire on external changes, not when the user types.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [value]);
+    const handleChange = (next) => {
+        setDraft(next);
+        if (next.trim() === '') {
+            setError(null);
+            onChange(null);
+            return;
+        }
+        const parsed = tryParse(next);
+        if (parsed.ok) {
+            setError(null);
+            onChange(parsed.value);
+        }
+        else {
+            try {
+                JSON.parse(next);
+            }
+            catch (e) {
+                setError(e instanceof Error ? e.message : invalidLabel);
+            }
+        }
+    };
+    const format = () => {
+        if (draft.trim() === '')
+            return;
+        try {
+            const parsed = JSON.parse(draft);
+            const pretty = JSON.stringify(parsed, null, 2);
+            setDraft(pretty);
+            setError(null);
+            onChange(parsed);
+        }
+        catch (e) {
+            setError(e instanceof Error ? e.message : invalidLabel);
+        }
+    };
+    return (<div className={cn('space-y-2', className)}>
+      <div className="relative">
+        <Textarea value={draft} onChange={(e) => handleChange(e.target.value)} onBlur={onBlur} disabled={disabled} rows={rows} spellCheck={false} placeholder={placeholder} className={cn('pr-20 font-mono text-xs leading-relaxed', error && 'border-destructive focus-visible:ring-destructive/40')}/>
+        <Button type="button" variant="ghost" size="sm" onClick={format} disabled={disabled || draft.trim() === ''} className="absolute right-1 top-1 h-7 px-2 text-xs" title={formatLabel}>
+          <Wand2 className="size-3.5"/>
+          <span className="hidden sm:inline">{formatLabel}</span>
+        </Button>
+      </div>
+      {error ? (<p className="flex items-start gap-1.5 text-xs text-destructive">
+          <AlertCircle className="mt-0.5 size-3.5 shrink-0"/>
+          <span className="break-all">
+            {invalidLabel}: {error}
+          </span>
+        </p>) : null}
+    </div>);
+}
+export function JsonView({ value, className, inline }) {
+    const text = React.useMemo(() => stringify(value), [value]);
+    if (inline) {
+        const compact = text.replace(/\s+/g, ' ').trim();
+        return (<code className={cn('line-clamp-1 max-w-[24rem] truncate font-mono text-xs text-muted-foreground', className)} title={text || undefined}>
+        {compact || '—'}
+      </code>);
+    }
+    return (<pre className={cn('max-h-96 overflow-auto rounded-md border border-border bg-muted/40 p-3 font-mono text-xs leading-relaxed text-foreground', className)}>
+      <code>{text || '—'}</code>
+    </pre>);
+}
+//# sourceMappingURL=json-editor.jsx.map

package/dist/components/json-editor.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-editor.jsx","sourceRoot":"","sources":["../../src/components/json-editor.tsx"],"names":[],"mappings":"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"}

package/dist/components/kbd.d.ts

@@ -0,0 +1,15 @@
+import * as React from 'react';
+/**
+ * Single keyboard key glyph. Renders a `<kbd>` styled like a typical
+ * key cap. Compose multiple `<Kbd>` siblings to spell out a chord:
+ * `<Kbd>Ctrl</Kbd>+<Kbd>S</Kbd>`. The cap uses `bg-muted` /
+ * `text-foreground/80` so it reads well on any neutral surface
+ * (cards, popovers, tooltips).
+ */
+export declare const Kbd: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & React.RefAttributes<HTMLElement>>;
+/**
+ * Resolve the platform-appropriate label for the primary modifier
+ * key. Renders `⌘` on macOS / iOS, `Ctrl` everywhere else.
+ */
+export declare function getModKeyLabel(): string;
+//# sourceMappingURL=kbd.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kbd.d.ts","sourceRoot":"","sources":["../../src/components/kbd.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B;;;;;;GAMG;AACH,eAAO,MAAM,GAAG,uGAYd,CAAA;AAGF;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAKvC"}

package/dist/components/kbd.jsx

@@ -0,0 +1,23 @@
+import * as React from 'react';
+import { cn } from '../lib/utils.js';
+/**
+ * Single keyboard key glyph. Renders a `<kbd>` styled like a typical
+ * key cap. Compose multiple `<Kbd>` siblings to spell out a chord:
+ * `<Kbd>Ctrl</Kbd>+<Kbd>S</Kbd>`. The cap uses `bg-muted` /
+ * `text-foreground/80` so it reads well on any neutral surface
+ * (cards, popovers, tooltips).
+ */
+export const Kbd = React.forwardRef(({ className, ...props }, ref) => (<kbd ref={ref} className={cn('inline-flex h-5 min-w-[1.25rem] items-center justify-center rounded border border-border bg-muted px-1.5 font-mono text-[10px] font-medium text-foreground/80 shadow-[0_1px_0_0_var(--border)]', className)} {...props}/>));
+Kbd.displayName = 'Kbd';
+/**
+ * Resolve the platform-appropriate label for the primary modifier
+ * key. Renders `⌘` on macOS / iOS, `Ctrl` everywhere else.
+ */
+export function getModKeyLabel() {
+    if (typeof navigator === 'undefined')
+        return 'Ctrl';
+    const platform = navigator.platform || '';
+    const ua = navigator.userAgent || '';
+    return /Mac|iPhone|iPad|iPod/i.test(platform) || /Mac/i.test(ua) ? '⌘' : 'Ctrl';
+}
+//# sourceMappingURL=kbd.jsx.map

package/dist/components/kbd.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"kbd.jsx","sourceRoot":"","sources":["../../src/components/kbd.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAA;AAEpC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,CAGjC,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,CAClC,CAAC,GAAG,CACF,GAAG,CAAC,CAAC,GAAG,CAAC,CACT,SAAS,CAAC,CAAC,EAAE,CACX,gMAAgM,EAChM,SAAS,CACV,CAAC,CACF,IAAI,KAAK,CAAC,EACV,CACH,CAAC,CAAA;AACF,GAAG,CAAC,WAAW,GAAG,KAAK,CAAA;AAEvB;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,IAAI,OAAO,SAAS,KAAK,WAAW;QAAE,OAAO,MAAM,CAAA;IACnD,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,IAAI,EAAE,CAAA;IACzC,MAAM,EAAE,GAAG,SAAS,CAAC,SAAS,IAAI,EAAE,CAAA;IACpC,OAAO,uBAAuB,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAA;AACjF,CAAC"}

package/dist/components/key-value-editor.d.ts

@@ -0,0 +1,92 @@
+import * as React from 'react';
+import { type ComboboxLabels, type ComboboxSuggestion } from './combobox.js';
+/** Built-in editor types. Resource code may pass a string; unknown values
+ * fall back to a plain string input. */
+export type KeyValueFieldType = 'string' | 'number' | 'boolean' | 'textarea' | 'select' | 'autocomplete';
+/** One declared key inside the JSON object. */
+export interface KeyValueFieldSpec {
+    /** JSON key on the underlying object. */
+    key: string;
+    /** Visible label. Defaults to the key. */
+    label?: string;
+    /** Editor kind. Default: `'string'`. */
+    type?: KeyValueFieldType;
+    /** Helper text shown under the input. */
+    description?: string;
+    /** Placeholder for text/number inputs. */
+    placeholder?: string;
+    /** Visual `*` marker; required-ness is enforced by the form layer. */
+    isRequired?: boolean;
+    /**
+     * Enum source for `type: 'select'` and static suggestions for
+     * `type: 'autocomplete'`. Either a list of strings (used both as value
+     * and label) or `{ value, label }` objects.
+     */
+    availableValues?: ReadonlyArray<string | {
+        value: string;
+        label: string;
+    }>;
+    /**
+     * For `type: 'autocomplete'`: pull dynamic suggestions from the named
+     * field of records of another resource (e.g. `users.email`). Resolved
+     * by the `packages/react` layer before render — KeyValueEditor itself
+     * never fetches, the loaded values arrive via `suggestionsByKey`.
+     */
+    suggestionsResource?: string;
+    /** Path of the field on `suggestionsResource` to project. */
+    suggestionsField?: string;
+}
+/** English-default labels surfaced through `labels` for i18n. */
+export interface KeyValueEditorLabels {
+    /** Placeholder shown in the empty `select` slot. Default: '—'. */
+    emptyOption?: string;
+    /** Visually-hidden / fallback label suffix when a row has no `label`. */
+    fieldLabelFallback?: (key: string) => string;
+    /** Forwarded to the inner `Combobox` for autocomplete fields. */
+    combobox?: ComboboxLabels;
+}
+export interface KeyValueEditorProps {
+    /** Declared key set. Order is preserved on screen. */
+    fields: ReadonlyArray<KeyValueFieldSpec>;
+    /** Current value. Anything that is not a plain object is treated as `{}`. */
+    value: unknown;
+    /** Emits a fresh JSON object on every change. */
+    onChange(next: Record<string, unknown>): void;
+    onBlur?(): void;
+    disabled?: boolean;
+    className?: string;
+    labels?: KeyValueEditorLabels;
+    /**
+     * Pre-loaded suggestions per autocomplete field, keyed by `field.key`.
+     * The editor stays i18n-/network-unaware: callers (e.g. the React
+     * property renderer) load values from the database and feed them in.
+     */
+    suggestionsByKey?: Readonly<Record<string, ReadonlyArray<ComboboxSuggestion>>>;
+    /** Per-key loading flags to render a spinner while suggestions stream in. */
+    suggestionsLoadingByKey?: Readonly<Record<string, boolean>>;
+}
+export declare function KeyValueEditor({ fields, value, onChange, onBlur, disabled, className, labels, suggestionsByKey, suggestionsLoadingByKey, }: KeyValueEditorProps): React.ReactElement;
+export interface KeyValueViewLabels {
+    /** Placeholder for missing values. Default: '—'. */
+    emptyValue?: string;
+    /** Field label fallback when a spec entry has no `label`. */
+    fieldLabelFallback?: (key: string) => string;
+    /** Boolean true label. Default: 'Yes'. */
+    trueLabel?: string;
+    /** Boolean false label. Default: 'No'. */
+    falseLabel?: string;
+}
+export interface KeyValueViewProps {
+    fields: ReadonlyArray<KeyValueFieldSpec>;
+    value: unknown;
+    className?: string;
+    /**
+     * `'inline'` collapses all fields into a single comma-separated row used
+     * by the list view. `'block'` (default) renders a vertical key/value
+     * table for the show view.
+     */
+    variant?: 'inline' | 'block';
+    labels?: KeyValueViewLabels;
+}
+export declare function KeyValueView({ fields, value, className, variant, labels, }: KeyValueViewProps): React.ReactElement;
+//# sourceMappingURL=key-value-editor.d.ts.map

package/dist/components/key-value-editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-value-editor.d.ts","sourceRoot":"","sources":["../../src/components/key-value-editor.tsx"],"names":[],"mappings":"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"}