@cratis/scene.components 3.6.0 → 3.7.0

package/README.md

@@ -73,7 +73,7 @@ unbound table costs one dashed box, not the whole screen.
 
 `@cratis/arc`, `@cratis/arc.react` and `@cratis/fundamentals` are peer dependencies of `@cratis/components`
 that the *host* supplies. This package also declares Arc and Arc React as optional peers and pins
-22.16.1 as development dependencies for native integration tests. A design surface is not a host.
+22.19.1 as development dependencies for native integration tests. A design surface is not a host.
 
 Every adapter that reaches them does so through a dynamic `import()` inside `React.lazy`, wrapped in
 `ArcRuntimeBoundary` (`Suspense` + the library's own `ErrorBoundary`). A screen built only from the library's
@@ -88,6 +88,22 @@ This splits the library cleanly, and the split is the library's own:
 The Storybook build externalizes the Arc packages (`.storybook/main.ts`) so the lazy chunk can be emitted
 with its imports left bare. No story loads that chunk, because no story registers a binding.
 
+## Actionable command forms
+
+`commandForm` supplies a native submit button via `AutoCommandForm`'s optional `footer` ReactNode seam.
+`submitLabel` is an optional string, defaulting to `Submit`. A private lazy runtime keeps Arc out of unbound
+previews; its footer child reads the actual native form context for execution and authorization state.
+Validity does not disable submission: native validation must be able to show errors on untouched forms.
+Scene neither executes the command directly nor creates another form or command context.
+
+Optional explicit `inputs` use exact native proxy descriptor names and types (`string`/`guid`) in one
+Arc CommandForm; missing, ambiguous, uncovered required or unsupported declarations block the form. Auto
+mode is fields-only and only supports String/Number/Boolean/Date providers, so required Guid does not silently
+disappear. The content slot is not connected to either mode. A valid Guid draft becomes a typed Guid; Guid
+JSON canonicalizes textual case without changing identity. No ID is generated. The declared peers require
+published Components >=4.13.0 for the footer and Arc/Arc React >=22.19.1 for native custom-error gating.
+Arc peers remain optional so unbound previews stay Arc-free.
+
 ## Optional single-result view (read-only)
 
 `Cratis.Components:singleResult` is a narrow adapter for an optional **single model**, not a collection.

package/dist/cjs/forms/CommandFormRuntime.js

@@ -0,0 +1,81 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var jsxRuntime = require('react/jsx-runtime');
+var CommandForm = require('@cratis/components/CommandForm');
+var commands = require('@cratis/arc.react/commands');
+var fundamentals = require('@cratis/fundamentals');
+var CommandFormSubmit = require('./CommandFormSubmit.js');
+var ExplicitCommandField = require('./ExplicitCommandField.js');
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+// Runtime bindings erase the proxy's keys; the optional footer is a Components >=4.13 contract.
+const NativeAutoCommandForm = CommandForm.AutoCommandForm;
+/** Verify the whole command before mounting any native form: partial forms must never execute. */ function capability(command, inputs, exclude) {
+    let descriptors;
+    try {
+        descriptors = new command().propertyDescriptors;
+    } catch  {
+        return 'Unable to inspect command proxy';
+    }
+    if (!Array.isArray(descriptors)) return 'Command proxy has no property descriptors';
+    const byName = new Map();
+    for (const descriptor of descriptors){
+        if (!descriptor || typeof descriptor.name !== 'string' || !descriptor.name || typeof descriptor.isOptional !== 'boolean' || byName.has(descriptor.name)) return 'Ambiguous or invalid command property descriptors';
+        byName.set(descriptor.name, descriptor);
+    }
+    if (inputs) {
+        for (const input of inputs){
+            const descriptor = byName.get(input.property);
+            if (!descriptor) return `Unknown command property '${input.property}'`;
+            if (descriptor.type !== (input.type === 'guid' ? fundamentals.Guid : String)) return `Command property '${input.property}' type does not match '${input.type}'`;
+        }
+        for (const descriptor of byName.values()){
+            if (!descriptor.isOptional && !inputs.some((input)=>input.property === descriptor.name)) return `Required command property '${descriptor.name}' has no input`;
+        }
+    } else {
+        for (const descriptor of byName.values()){
+            if (!descriptor.isOptional && (exclude?.includes(descriptor.name) || ![
+                String,
+                Number,
+                Boolean,
+                Date
+            ].includes(descriptor.type))) {
+                return `Required command property '${descriptor.name}' has no supported automatic field; declare inputs`;
+            }
+        }
+    }
+    return undefined;
+}
+/** Private lazy entry point: importing the Scene registry must not import Arc. */ function CommandFormRuntime({ command, inputs, exclude, submitLabel }) {
+    const error = capability(command, inputs, exclude);
+    if (error) return /*#__PURE__*/ jsxRuntime.jsx("div", {
+        role: "alert",
+        children: error
+    });
+    // The registry's never-argument constructor is erased; Arc creates this checked proxy with no args.
+    if (inputs) return /*#__PURE__*/ jsxRuntime.jsxs(commands.CommandForm, {
+        command: command,
+        showTitles: false,
+        children: [
+            inputs.map((input)=>/*#__PURE__*/ jsxRuntime.jsx(ExplicitCommandField.ExplicitCommandField, {
+                    input: input
+                }, input.property)),
+            /*#__PURE__*/ jsxRuntime.jsx(CommandFormSubmit.CommandFormSubmit, {
+                label: submitLabel
+            })
+        ]
+    });
+    return /*#__PURE__*/ jsxRuntime.jsx(NativeAutoCommandForm, {
+        command: command,
+        exclude: exclude,
+        footer: /*#__PURE__*/ jsxRuntime.jsx(CommandFormSubmit.CommandFormSubmit, {
+            label: submitLabel
+        })
+    });
+}
+
+exports.default = CommandFormRuntime;
+//# sourceMappingURL=CommandFormRuntime.js.map

package/dist/cjs/forms/CommandFormRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandFormRuntime.js","sources":["../../../forms/CommandFormRuntime.tsx"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport type { ComponentType, ReactNode } from 'react';\nimport { AutoCommandForm } from '@cratis/components/CommandForm';\nimport { CommandForm } from '@cratis/arc.react/commands';\nimport { Guid } from '@cratis/fundamentals';\nimport type { BoundConstructor } from '../bindings';\nimport type { CommandInput } from './commandInputs';\nimport { CommandFormSubmit } from './CommandFormSubmit';\nimport { ExplicitCommandField } from './ExplicitCommandField';\n\ninterface CommandFormRuntimeProps {\n    command: BoundConstructor;\n    inputs?: CommandInput[];\n    exclude?: string[];\n    submitLabel: string;\n}\n\n// Runtime bindings erase the proxy's keys; the optional footer is a Components >=4.13 contract.\nconst NativeAutoCommandForm = AutoCommandForm as unknown as ComponentType<{\n    command: BoundConstructor;\n    exclude?: string[];\n    footer?: ReactNode;\n}>;\n\ntype Descriptor = { name: string; type: unknown; isOptional: boolean };\n\n/** Verify the whole command before mounting any native form: partial forms must never execute. */\nfunction capability(command: BoundConstructor, inputs?: CommandInput[], exclude?: string[]): string | undefined {\n    let descriptors: unknown;\n    try { descriptors = (new command() as { propertyDescriptors?: unknown }).propertyDescriptors; }\n    catch { return 'Unable to inspect command proxy'; }\n    if (!Array.isArray(descriptors)) return 'Command proxy has no property descriptors';\n    const byName = new Map<string, Descriptor>();\n    for (const descriptor of descriptors) {\n        if (!descriptor || typeof descriptor.name !== 'string' || !descriptor.name ||\n            typeof descriptor.isOptional !== 'boolean' || byName.has(descriptor.name)) return 'Ambiguous or invalid command property descriptors';\n        byName.set(descriptor.name, descriptor);\n    }\n    if (inputs) {\n        for (const input of inputs) {\n            const descriptor = byName.get(input.property);\n            if (!descriptor) return `Unknown command property '${input.property}'`;\n            if (descriptor.type !== (input.type === 'guid' ? Guid : String)) return `Command property '${input.property}' type does not match '${input.type}'`;\n        }\n        for (const descriptor of byName.values()) {\n            if (!descriptor.isOptional && !inputs.some(input => input.property === descriptor.name)) return `Required command property '${descriptor.name}' has no input`;\n        }\n    } else {\n        for (const descriptor of byName.values()) {\n            if (!descriptor.isOptional && (exclude?.includes(descriptor.name) ||\n                ![String, Number, Boolean, Date].includes(descriptor.type as typeof String))) {\n                return `Required command property '${descriptor.name}' has no supported automatic field; declare inputs`;\n            }\n        }\n    }\n    return undefined;\n}\n\n/** Private lazy entry point: importing the Scene registry must not import Arc. */\nexport default function CommandFormRuntime({ command, inputs, exclude, submitLabel }: CommandFormRuntimeProps) {\n    const error = capability(command, inputs, exclude);\n    if (error) return <div role='alert'>{error}</div>;\n    // The registry's never-argument constructor is erased; Arc creates this checked proxy with no args.\n    if (inputs) return <CommandForm command={command as unknown as new () => object} showTitles={false}>\n        {inputs.map(input => <ExplicitCommandField key={input.property} input={input} />)}\n        <CommandFormSubmit label={submitLabel} />\n    </CommandForm>;\n    return <NativeAutoCommandForm command={command} exclude={exclude} footer={<CommandFormSubmit label={submitLabel} />} />;\n}\n"],"names":["NativeAutoCommandForm","AutoCommandForm","capability","command","inputs","exclude","descriptors","propertyDescriptors","Array","isArray","byName","Map","descriptor","name","isOptional","has","set","input","get","property","type","Guid","String","values","some","includes","Number","Boolean","Date","undefined","CommandFormRuntime","submitLabel","error","_jsx","div","role","_jsxs","CommandForm","showTitles","map","ExplicitCommandField","CommandFormSubmit","label","footer"],"mappings":"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"}

package/dist/cjs/forms/CommandFormSubmit.js

@@ -0,0 +1,19 @@
+'use strict';
+
+var jsxRuntime = require('react/jsx-runtime');
+var commands = require('@cratis/arc.react/commands');
+
+/** Internal footer child; only rendered under the native form's context. */ function CommandFormSubmit({ label }) {
+    const { isExecuting, isAuthorized } = commands.useCommandFormContext();
+    // Do not gate on isValid: submitting untouched invalid fields must reveal native validation.
+    // No click handler: the containing Arc form owns submission, validation and execution.
+    return /*#__PURE__*/ jsxRuntime.jsx("button", {
+        type: "submit",
+        disabled: isExecuting || !isAuthorized,
+        "aria-busy": isExecuting,
+        children: label
+    });
+}
+
+exports.CommandFormSubmit = CommandFormSubmit;
+//# sourceMappingURL=CommandFormSubmit.js.map

package/dist/cjs/forms/CommandFormSubmit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandFormSubmit.js","sources":["../../../forms/CommandFormSubmit.tsx"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { useCommandFormContext } from '@cratis/arc.react/commands';\n\ninterface CommandFormSubmitProps {\n    label: string;\n}\n\n/** Internal footer child; only rendered under the native form's context. */\nexport function CommandFormSubmit({ label }: CommandFormSubmitProps) {\n    const { isExecuting, isAuthorized } = useCommandFormContext();\n    // Do not gate on isValid: submitting untouched invalid fields must reveal native validation.\n    // No click handler: the containing Arc form owns submission, validation and execution.\n    return <button type='submit' disabled={isExecuting || !isAuthorized} aria-busy={isExecuting}>{label}</button>;\n}\n"],"names":["CommandFormSubmit","label","isExecuting","isAuthorized","useCommandFormContext","_jsx","button","type","disabled","aria-busy"],"mappings":";;;;;AASA,6EACO,SAASA,iBAAAA,CAAkB,EAAEC,KAAK,EAA0B,EAAA;AAC/D,IAAA,MAAM,EAAEC,WAAW,EAAEC,YAAY,EAAE,GAAGC,8BAAAA,EAAAA;;;AAGtC,IAAA,qBAAOC,cAAA,CAACC,QAAAA,EAAAA;QAAOC,IAAAA,EAAK,QAAA;AAASC,QAAAA,QAAAA,EAAUN,eAAe,CAACC,YAAAA;QAAcM,WAAAA,EAAWP,WAAAA;AAAcD,QAAAA,QAAAA,EAAAA;;AAClG;;"}

package/dist/cjs/forms/ExplicitCommandField.js

@@ -0,0 +1,109 @@
+'use strict';
+
+var jsxRuntime = require('react/jsx-runtime');
+var react = require('react');
+var commands = require('@cratis/arc.react/commands');
+var fundamentals = require('@cratis/fundamentals');
+
+function TextControl({ value, onChange, onBlur, invalid, required, errors, label, property, guid }) {
+    const id = react.useId();
+    const context = commands.useCommandFormContext();
+    const { setCustomFieldError } = context;
+    // Keep the latest native getter: the context snapshot can be stale when another field sets an
+    // error and this field unmounts in the same event.
+    const contextRef = react.useRef(context);
+    contextRef.current = context;
+    // The draft is intentionally independent of the typed proxy value: malformed text must never
+    // reappear as a stale previously valid Guid in the command's serialized payload.
+    const [draft, setDraft] = react.useState(()=>value instanceof fundamentals.Guid && !value.equals(fundamentals.Guid.empty) ? value.toString() : '');
+    const draftRef = react.useRef(draft);
+    const ownedError = react.useRef(undefined);
+    const updateError = (error)=>{
+        const current = contextRef.current.getFieldError(property);
+        // Do not replace or erase another producer's error for this field.
+        if (ownedError.current !== undefined && current !== ownedError.current) {
+            ownedError.current = undefined;
+            return;
+        }
+        if (ownedError.current === undefined && Object.hasOwn(contextRef.current.customFieldErrors, property)) return;
+        if (error === undefined && ownedError.current === undefined) return;
+        ownedError.current = error;
+        setCustomFieldError(property, error);
+    };
+    // A label/required change must recalculate the message without disposing the field's error.
+    // Only a different field/type or an actual unmount relinquishes ownership.
+    react.useLayoutEffect(()=>()=>{
+            if (ownedError.current !== undefined && contextRef.current.getFieldError(property) === ownedError.current) {
+                contextRef.current.setCustomFieldError(property, undefined);
+            }
+            ownedError.current = undefined;
+        }, [
+        property,
+        guid
+    ]);
+    react.useLayoutEffect(()=>{
+        if (guid) {
+            const current = draftRef.current || (value instanceof fundamentals.Guid && !value.equals(fundamentals.Guid.empty) ? value.toString() : '');
+            updateError(!current ? required ? `${label} is required` : undefined : !fundamentals.Guid.isGuid(current) ? `${label} must be a valid GUID` : undefined);
+        }
+    }, [
+        guid,
+        required,
+        property,
+        label,
+        setCustomFieldError
+    ]);
+    const text = guid ? draft : typeof value === 'string' ? value : '';
+    return /*#__PURE__*/ jsxRuntime.jsxs("div", {
+        children: [
+            /*#__PURE__*/ jsxRuntime.jsx("label", {
+                htmlFor: id,
+                children: label
+            }),
+            /*#__PURE__*/ jsxRuntime.jsx("input", {
+                id: id,
+                name: property,
+                type: "text",
+                required: required,
+                value: text,
+                "aria-invalid": invalid,
+                "aria-describedby": errors.length ? `${id}-error` : undefined,
+                onBlur: onBlur,
+                onChange: (event)=>{
+                    const next = event.currentTarget.value;
+                    if (!guid) {
+                        onChange(next);
+                        return;
+                    }
+                    draftRef.current = next;
+                    setDraft(next);
+                    const error = !next ? required ? `${label} is required` : undefined : !fundamentals.Guid.isGuid(next) ? `${label} must be a valid GUID` : undefined;
+                    // A malformed draft clears the previously typed value, not just its display.
+                    onChange(error || !next ? undefined : fundamentals.Guid.parse(next));
+                    updateError(error);
+                }
+            }),
+            errors.length > 0 && /*#__PURE__*/ jsxRuntime.jsx("div", {
+                id: `${id}-error`,
+                role: "alert",
+                children: errors[0]
+            })
+        ]
+    });
+}
+const NativeTextField = commands.asCommandFormField(TextControl, {
+    defaultValue: ''
+});
+/** Opaque child is self-bound by Arc's native runtime binding, with an exact fieldName. */ function ExplicitCommandField({ input }) {
+    return /*#__PURE__*/ jsxRuntime.jsx(NativeTextField, {
+        fieldName: input.property,
+        value: (command)=>command[input.property],
+        property: input.property,
+        guid: input.type === 'guid',
+        label: input.label,
+        title: input.label
+    });
+}
+
+exports.ExplicitCommandField = ExplicitCommandField;
+//# sourceMappingURL=ExplicitCommandField.js.map

package/dist/cjs/forms/ExplicitCommandField.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExplicitCommandField.js","sources":["../../../forms/ExplicitCommandField.tsx"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { useId, useLayoutEffect, useRef, useState } from 'react';\nimport { asCommandFormField, useCommandFormContext } from '@cratis/arc.react/commands';\nimport { Guid } from '@cratis/fundamentals';\nimport type { CommandInput } from './commandInputs';\n\ninterface TextProps {\n    value: unknown;\n    onChange: (value: unknown) => void;\n    onBlur?: () => void;\n    invalid: boolean;\n    required: boolean;\n    errors: string[];\n    label: string;\n    property: string;\n    guid: boolean;\n}\n\nfunction TextControl({ value, onChange, onBlur, invalid, required, errors, label, property, guid }: TextProps) {\n    const id = useId();\n    const context = useCommandFormContext();\n    const { setCustomFieldError } = context;\n    // Keep the latest native getter: the context snapshot can be stale when another field sets an\n    // error and this field unmounts in the same event.\n    const contextRef = useRef(context);\n    contextRef.current = context;\n    // The draft is intentionally independent of the typed proxy value: malformed text must never\n    // reappear as a stale previously valid Guid in the command's serialized payload.\n    const [draft, setDraft] = useState(() => value instanceof Guid && !value.equals(Guid.empty) ? value.toString() : '');\n    const draftRef = useRef(draft);\n    const ownedError = useRef<string | undefined>(undefined);\n    const updateError = (error: string | undefined) => {\n        const current = contextRef.current.getFieldError(property);\n        // Do not replace or erase another producer's error for this field.\n        if (ownedError.current !== undefined && current !== ownedError.current) {\n            ownedError.current = undefined;\n            return;\n        }\n        if (ownedError.current === undefined && Object.hasOwn(contextRef.current.customFieldErrors, property)) return;\n        if (error === undefined && ownedError.current === undefined) return;\n        ownedError.current = error;\n        setCustomFieldError(property, error);\n    };\n    // A label/required change must recalculate the message without disposing the field's error.\n    // Only a different field/type or an actual unmount relinquishes ownership.\n    useLayoutEffect(() => () => {\n        if (ownedError.current !== undefined && contextRef.current.getFieldError(property) === ownedError.current) {\n            contextRef.current.setCustomFieldError(property, undefined);\n        }\n        ownedError.current = undefined;\n    }, [property, guid]);\n    useLayoutEffect(() => {\n        if (guid) {\n            const current = draftRef.current || (value instanceof Guid && !value.equals(Guid.empty) ? value.toString() : '');\n            updateError(!current ? required ? `${label} is required` : undefined :\n                !Guid.isGuid(current) ? `${label} must be a valid GUID` : undefined);\n        }\n    }, [guid, required, property, label, setCustomFieldError]);\n    const text = guid ? draft : typeof value === 'string' ? value : '';\n    return <div>\n        <label htmlFor={id}>{label}</label>\n        <input id={id} name={property} type='text' required={required} value={text}\n            aria-invalid={invalid} aria-describedby={errors.length ? `${id}-error` : undefined}\n            onBlur={onBlur} onChange={event => {\n                const next = event.currentTarget.value;\n                if (!guid) { onChange(next); return; }\n                draftRef.current = next;\n                setDraft(next);\n                const error = !next ? required ? `${label} is required` : undefined : !Guid.isGuid(next) ? `${label} must be a valid GUID` : undefined;\n                // A malformed draft clears the previously typed value, not just its display.\n                onChange(error || !next ? undefined : Guid.parse(next));\n                updateError(error);\n            }} />\n        {errors.length > 0 && <div id={`${id}-error`} role='alert'>{errors[0]}</div>}\n    </div>;\n}\n\nconst NativeTextField = asCommandFormField<TextProps>(TextControl, { defaultValue: '' });\n\n/** Opaque child is self-bound by Arc's native runtime binding, with an exact fieldName. */\nexport function ExplicitCommandField({ input }: { input: CommandInput }) {\n    return <NativeTextField fieldName={input.property} value={(command: Record<string, unknown>) => command[input.property]}\n        property={input.property} guid={input.type === 'guid'} label={input.label} title={input.label} />;\n}\n"],"names":["TextControl","value","onChange","onBlur","invalid","required","errors","label","property","guid","id","useId","context","useCommandFormContext","setCustomFieldError","contextRef","useRef","current","draft","setDraft","useState","Guid","equals","empty","toString","draftRef","ownedError","undefined","updateError","error","getFieldError","Object","hasOwn","customFieldErrors","useLayoutEffect","isGuid","text","_jsxs","div","_jsx","htmlFor","input","name","type","aria-invalid","aria-describedby","length","event","next","currentTarget","parse","role","NativeTextField","asCommandFormField","defaultValue","ExplicitCommandField","fieldName","command","title"],"mappings":"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"}

package/dist/cjs/forms/SceneCommandForm.js

@@ -7,26 +7,24 @@ var resolveElementBinding = require('../bindings/resolveElementBinding.js');
 var MissingBinding = require('../bindings/MissingBinding.js');
 var ArcRuntimeBoundary = require('../bindings/ArcRuntimeBoundary.js');
 var properties = require('../properties.js');
+var commandInputs = require('./commandInputs.js');
 
+const CommandFormRuntime = /*#__PURE__*/ react.lazy(()=>Promise.resolve().then(function () { return require('./CommandFormRuntime.js'); }));
+// Arc's useCommand constructs the proxy only on mount. Key by the actual registered class,
+// not its Scene name (which may be re-registered with a different route or roles).
+const commandKeys = new WeakMap();
+let nextCommandKey = 0;
+function commandKey(command) {
+    let key = commandKeys.get(command);
+    if (key === undefined) {
+        key = ++nextCommandKey;
+        commandKeys.set(command, key);
+    }
+    return key;
+}
 /**
- * `AutoCommandForm` types `exclude` as `(keyof TCommand)[]`, which collapses to `never[]` when the
- * command type is only known at runtime - as it always is here, since the class arrives from the binding
- * registry rather than from a type annotation. The conversion states the shape this adapter actually
- * passes; the underlying component reads `exclude` as property names either way.
- */ const AutoCommandForm = /*#__PURE__*/ react.lazy(async ()=>({
-        default: (await import('@cratis/components/CommandForm')).AutoCommandForm
-    }));
-/**
- * The `Cratis.Components:commandForm` component - `AutoCommandForm` from `@cratis/components/CommandForm`.
- *
- * `AutoCommandForm` rather than `CommandForm`, because a screen that had to list every field by hand
- * would go stale the moment a property is added to the command on the backend. `AutoCommandForm` reads
- * the command's own property descriptors and picks a field component per property type, so the form
- * follows the command - which is the same guarantee Arc's generated proxies give the rest of the stack.
- *
- * A screen that does want to place fields itself puts the field components from this package in the
- * `content` slot and names them individually; `exclude` keeps `AutoCommandForm` from generating a second
- * copy of anything placed that way.
+ * Auto mode follows supported native proxy descriptors; opt-in inputs bind exactly named fields
+ * inside a single native Arc form. Neither mode consumes the content slot.
  */ function SceneCommandForm({ element }) {
     const { name, target } = resolveElementBinding.resolveElementBinding(element, BindingKind.BindingKind.Command);
     if (!target) return /*#__PURE__*/ jsxRuntime.jsx(MissingBinding.MissingBinding, {
@@ -34,11 +32,18 @@ var properties = require('../properties.js');
         kind: BindingKind.BindingKind.Command,
         name: name
     });
+    const inputs = Object.hasOwn(element.properties, 'inputs') ? commandInputs.commandInputs(element.properties) : undefined;
+    if (Object.hasOwn(element.properties, 'inputs') && !inputs) return /*#__PURE__*/ jsxRuntime.jsx("div", {
+        role: "alert",
+        children: "Invalid command form inputs declaration"
+    });
     return /*#__PURE__*/ jsxRuntime.jsx(ArcRuntimeBoundary.ArcRuntimeBoundary, {
-        children: /*#__PURE__*/ jsxRuntime.jsx(AutoCommandForm, {
+        children: /*#__PURE__*/ jsxRuntime.jsx(CommandFormRuntime, {
             command: target,
-            exclude: properties.stringArrayProperty(element.properties, 'exclude')
-        })
+            inputs: inputs,
+            exclude: properties.stringArrayProperty(element.properties, 'exclude'),
+            submitLabel: properties.stringProperty(element.properties, 'submitLabel') ?? 'Submit'
+        }, commandKey(target))
     });
 }
 

package/dist/cjs/forms/SceneCommandForm.js.map

@@ -1 +1 @@
-{"version":3,"file":"SceneCommandForm.js","sources":["../../../forms/SceneCommandForm.tsx"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { ComponentType, lazy } from 'react';\nimport { RegisteredComponentProps } from '@cratis/scene.react';\nimport { ArcRuntimeBoundary, BindingKind, BoundConstructor, MissingBinding, resolveElementBinding } from '../bindings';\nimport { stringArrayProperty } from '../properties';\n\ninterface AutoCommandFormElementProps {\n    command: BoundConstructor;\n    exclude?: string[];\n}\n\n/**\n * `AutoCommandForm` types `exclude` as `(keyof TCommand)[]`, which collapses to `never[]` when the\n * command type is only known at runtime - as it always is here, since the class arrives from the binding\n * registry rather than from a type annotation. The conversion states the shape this adapter actually\n * passes; the underlying component reads `exclude` as property names either way.\n */\nconst AutoCommandForm = lazy(async () => ({\n    default: (await import('@cratis/components/CommandForm')).AutoCommandForm as unknown as ComponentType<AutoCommandFormElementProps>,\n}));\n\n/**\n * The `Cratis.Components:commandForm` component - `AutoCommandForm` from `@cratis/components/CommandForm`.\n *\n * `AutoCommandForm` rather than `CommandForm`, because a screen that had to list every field by hand\n * would go stale the moment a property is added to the command on the backend. `AutoCommandForm` reads\n * the command's own property descriptors and picks a field component per property type, so the form\n * follows the command - which is the same guarantee Arc's generated proxies give the rest of the stack.\n *\n * A screen that does want to place fields itself puts the field components from this package in the\n * `content` slot and names them individually; `exclude` keeps `AutoCommandForm` from generating a second\n * copy of anything placed that way.\n */\nexport function SceneCommandForm({ element }: RegisteredComponentProps) {\n    const { name, target } = resolveElementBinding(element, BindingKind.Command);\n    if (!target) return <MissingBinding element={element} kind={BindingKind.Command} name={name} />;\n\n    return (\n        <ArcRuntimeBoundary>\n            <AutoCommandForm command={target} exclude={stringArrayProperty(element.properties, 'exclude')} />\n        </ArcRuntimeBoundary>\n    );\n}\n"],"names":["AutoCommandForm","lazy","default","SceneCommandForm","element","name","target","resolveElementBinding","BindingKind","Command","_jsx","MissingBinding","kind","ArcRuntimeBoundary","command","exclude","stringArrayProperty","properties"],"mappings":";;;;;;;;;;AAaA;;;;;AAKC,IACD,MAAMA,eAAAA,iBAAkBC,UAAAA,CAAK,WAAa;AACtCC,QAAAA,OAAAA,EAAS,CAAC,MAAM,OAAO,gCAAA,CAAgC,EAAGF;KAC9D,CAAA,CAAA;AAEA;;;;;;;;;;;AAWC,IACM,SAASG,gBAAAA,CAAiB,EAAEC,OAAO,EAA4B,EAAA;IAClE,MAAM,EAAEC,IAAI,EAAEC,MAAM,EAAE,GAAGC,2CAAAA,CAAsBH,OAAAA,EAASI,uBAAAA,CAAYC,OAAO,CAAA;IAC3E,IAAI,CAACH,MAAAA,EAAQ,qBAAOI,cAAA,CAACC,6BAAAA,EAAAA;QAAeP,OAAAA,EAASA,OAAAA;AAASQ,QAAAA,IAAAA,EAAMJ,wBAAYC,OAAO;QAAEJ,IAAAA,EAAMA;;AAEvF,IAAA,qBACIK,cAAA,CAACG,qCAAAA,EAAAA;AACG,QAAA,QAAA,gBAAAH,cAAA,CAACV,eAAAA,EAAAA;YAAgBc,OAAAA,EAASR,MAAAA;YAAQS,OAAAA,EAASC,8BAAAA,CAAoBZ,OAAAA,CAAQa,UAAU,EAAE,SAAA;;;AAG/F;;"}
+{"version":3,"file":"SceneCommandForm.js","sources":["../../../forms/SceneCommandForm.tsx"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { lazy } from 'react';\nimport { RegisteredComponentProps } from '@cratis/scene.react';\nimport { ArcRuntimeBoundary, BindingKind, MissingBinding, resolveElementBinding } from '../bindings';\nimport type { BoundConstructor } from '../bindings';\nimport { stringArrayProperty, stringProperty } from '../properties';\nimport { commandInputs } from './commandInputs';\n\nconst CommandFormRuntime = lazy(() => import('./CommandFormRuntime'));\n\n// Arc's useCommand constructs the proxy only on mount. Key by the actual registered class,\n// not its Scene name (which may be re-registered with a different route or roles).\nconst commandKeys = new WeakMap<BoundConstructor, number>();\nlet nextCommandKey = 0;\nfunction commandKey(command: BoundConstructor): number {\n    let key = commandKeys.get(command);\n    if (key === undefined) {\n        key = ++nextCommandKey;\n        commandKeys.set(command, key);\n    }\n    return key;\n}\n\n/**\n * Auto mode follows supported native proxy descriptors; opt-in inputs bind exactly named fields\n * inside a single native Arc form. Neither mode consumes the content slot.\n */\nexport function SceneCommandForm({ element }: RegisteredComponentProps) {\n    const { name, target } = resolveElementBinding(element, BindingKind.Command);\n    if (!target) return <MissingBinding element={element} kind={BindingKind.Command} name={name} />;\n\n    const inputs = Object.hasOwn(element.properties, 'inputs') ? commandInputs(element.properties) : undefined;\n    if (Object.hasOwn(element.properties, 'inputs') && !inputs) return <div role='alert'>Invalid command form inputs declaration</div>;\n\n    return (\n        <ArcRuntimeBoundary>\n            <CommandFormRuntime\n                key={commandKey(target)}\n                command={target}\n                inputs={inputs}\n                exclude={stringArrayProperty(element.properties, 'exclude')}\n                submitLabel={stringProperty(element.properties, 'submitLabel') ?? 'Submit'}\n            />\n        </ArcRuntimeBoundary>\n    );\n}\n"],"names":["CommandFormRuntime","lazy","commandKeys","WeakMap","nextCommandKey","commandKey","command","key","get","undefined","set","SceneCommandForm","element","name","target","resolveElementBinding","BindingKind","Command","_jsx","MissingBinding","kind","inputs","Object","hasOwn","properties","commandInputs","div","role","ArcRuntimeBoundary","exclude","stringArrayProperty","submitLabel","stringProperty"],"mappings":";;;;;;;;;;;AAUA,MAAMA,kBAAAA,iBAAqBC,UAAAA,CAAK,IAAM,oDAAO,yBAAA,KAAA,CAAA;AAE7C;AACA;AACA,MAAMC,cAAc,IAAIC,OAAAA,EAAAA;AACxB,IAAIC,cAAAA,GAAiB,CAAA;AACrB,SAASC,WAAWC,OAAyB,EAAA;IACzC,IAAIC,GAAAA,GAAML,WAAAA,CAAYM,GAAG,CAACF,OAAAA,CAAAA;AAC1B,IAAA,IAAIC,QAAQE,SAAAA,EAAW;AACnBF,QAAAA,GAAAA,GAAM,EAAEH,cAAAA;QACRF,WAAAA,CAAYQ,GAAG,CAACJ,OAAAA,EAASC,GAAAA,CAAAA;AAC7B,IAAA;IACA,OAAOA,GAAAA;AACX;AAEA;;;AAGC,IACM,SAASI,gBAAAA,CAAiB,EAAEC,OAAO,EAA4B,EAAA;IAClE,MAAM,EAAEC,IAAI,EAAEC,MAAM,EAAE,GAAGC,2CAAAA,CAAsBH,OAAAA,EAASI,uBAAAA,CAAYC,OAAO,CAAA;IAC3E,IAAI,CAACH,MAAAA,EAAQ,qBAAOI,cAAA,CAACC,6BAAAA,EAAAA;QAAeP,OAAAA,EAASA,OAAAA;AAASQ,QAAAA,IAAAA,EAAMJ,wBAAYC,OAAO;QAAEJ,IAAAA,EAAMA;;IAEvF,MAAMQ,MAAAA,GAASC,MAAAA,CAAOC,MAAM,CAACX,OAAAA,CAAQY,UAAU,EAAE,QAAA,CAAA,GAAYC,2BAAAA,CAAcb,OAAAA,CAAQY,UAAU,CAAA,GAAIf,SAAAA;IACjG,IAAIa,MAAAA,CAAOC,MAAM,CAACX,OAAAA,CAAQY,UAAU,EAAE,QAAA,CAAA,IAAa,CAACH,MAAAA,EAAQ,qBAAOH,cAAA,CAACQ,KAAAA,EAAAA;QAAIC,IAAAA,EAAK,OAAA;AAAQ,QAAA,QAAA,EAAA;;AAErF,IAAA,qBACIT,cAAA,CAACU,qCAAAA,EAAAA;AACG,QAAA,QAAA,gBAAAV,cAAA,CAAClB,kBAAAA,EAAAA;YAEGM,OAAAA,EAASQ,MAAAA;YACTO,MAAAA,EAAQA,MAAAA;YACRQ,OAAAA,EAASC,8BAAAA,CAAoBlB,OAAAA,CAAQY,UAAU,EAAE,SAAA,CAAA;AACjDO,YAAAA,WAAAA,EAAaC,yBAAAA,CAAepB,OAAAA,CAAQY,UAAU,EAAE,aAAA,CAAA,IAAkB;WAJ7DnB,UAAAA,CAAWS,MAAAA,CAAAA;;AAQhC;;"}

package/dist/cjs/forms/commandInputs.js

@@ -0,0 +1,35 @@
+'use strict';
+
+var properties = require('../properties.js');
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/** An absent declaration selects legacy auto mode; a present but invalid declaration never does. */ function commandInputs(properties$1) {
+    const values = properties.arrayProperty(properties$1, 'inputs');
+    if (!values?.length) return undefined;
+    const inputs = [];
+    const seen = new Set();
+    for (const value of values){
+        const input = properties.objectProperty({
+            value
+        }, 'value');
+        if (!input || Object.keys(input).some((key)=>![
+                'property',
+                'type',
+                'label'
+            ].includes(key))) return undefined;
+        const property = properties.stringProperty(input, 'property');
+        const label = properties.stringProperty(input, 'label');
+        if (!property?.trim() || !label?.trim() || input.type !== 'string' && input.type !== 'guid' || seen.has(property)) return undefined;
+        seen.add(property);
+        inputs.push({
+            property,
+            type: input.type,
+            label
+        });
+    }
+    return inputs;
+}
+
+exports.commandInputs = commandInputs;
+//# sourceMappingURL=commandInputs.js.map

package/dist/cjs/forms/commandInputs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandInputs.js","sources":["../../../forms/commandInputs.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { arrayProperty, objectProperty, stringProperty } from '../properties';\n\n/** Exact, case-sensitive names from a generated command's propertyDescriptors. */\nexport interface CommandInput {\n    property: string;\n    type: 'string' | 'guid';\n    label: string;\n}\n\n/** An absent declaration selects legacy auto mode; a present but invalid declaration never does. */\nexport function commandInputs(properties: Record<string, unknown>): CommandInput[] | undefined {\n    const values = arrayProperty(properties, 'inputs');\n    if (!values?.length) return undefined;\n    const inputs: CommandInput[] = [];\n    const seen = new Set<string>();\n    for (const value of values) {\n        const input = objectProperty({ value }, 'value');\n        if (!input || Object.keys(input).some(key => !['property', 'type', 'label'].includes(key))) return undefined;\n        const property = stringProperty(input, 'property');\n        const label = stringProperty(input, 'label');\n        if (!property?.trim() || !label?.trim() || (input.type !== 'string' && input.type !== 'guid') || seen.has(property)) return undefined;\n        seen.add(property);\n        inputs.push({ property, type: input.type, label });\n    }\n    return inputs;\n}\n"],"names":["commandInputs","properties","values","arrayProperty","length","undefined","inputs","seen","Set","value","input","objectProperty","Object","keys","some","key","includes","property","stringProperty","label","trim","type","has","add","push"],"mappings":";;;;AAAA;AACA;AAWA,qGACO,SAASA,aAAAA,CAAcC,YAAmC,EAAA;IAC7D,MAAMC,MAAAA,GAASC,yBAAcF,YAAAA,EAAY,QAAA,CAAA;IACzC,IAAI,CAACC,MAAAA,EAAQE,MAAAA,EAAQ,OAAOC,SAAAA;AAC5B,IAAA,MAAMC,SAAyB,EAAE;AACjC,IAAA,MAAMC,OAAO,IAAIC,GAAAA,EAAAA;IACjB,KAAK,MAAMC,SAASP,MAAAA,CAAQ;AACxB,QAAA,MAAMQ,QAAQC,yBAAAA,CAAe;AAAEF,YAAAA;SAAM,EAAG,OAAA,CAAA;QACxC,IAAI,CAACC,KAAAA,IAASE,MAAAA,CAAOC,IAAI,CAACH,OAAOI,IAAI,CAACC,CAAAA,GAAAA,GAAO,CAAC;AAAC,gBAAA,UAAA;AAAY,gBAAA,MAAA;AAAQ,gBAAA;aAAQ,CAACC,QAAQ,CAACD,GAAAA,CAAAA,CAAAA,EAAO,OAAOV,SAAAA;QACnG,MAAMY,QAAAA,GAAWC,0BAAeR,KAAAA,EAAO,UAAA,CAAA;QACvC,MAAMS,KAAAA,GAAQD,0BAAeR,KAAAA,EAAO,OAAA,CAAA;AACpC,QAAA,IAAI,CAACO,QAAAA,EAAUG,IAAAA,EAAAA,IAAU,CAACD,KAAAA,EAAOC,IAAAA,EAAAA,IAAWV,MAAMW,IAAI,KAAK,QAAA,IAAYX,KAAAA,CAAMW,IAAI,KAAK,MAAA,IAAWd,KAAKe,GAAG,CAACL,WAAW,OAAOZ,SAAAA;AAC5HE,QAAAA,IAAAA,CAAKgB,GAAG,CAACN,QAAAA,CAAAA;AACTX,QAAAA,MAAAA,CAAOkB,IAAI,CAAC;AAAEP,YAAAA,QAAAA;AAAUI,YAAAA,IAAAA,EAAMX,MAAMW,IAAI;AAAEF,YAAAA;AAAM,SAAA,CAAA;AACpD,IAAA;IACA,OAAOb,MAAAA;AACX;;"}

package/dist/esm/for_cratisComponentsPackage/when_declaring_command_form_peers.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=when_declaring_command_form_peers.d.ts.map

package/dist/esm/for_cratisComponentsPackage/when_declaring_command_form_peers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"when_declaring_command_form_peers.d.ts","sourceRoot":"","sources":["../../../for_cratisComponentsPackage/when_declaring_command_form_peers.ts"],"names":[],"mappings":""}

package/dist/esm/for_cratisComponentsPackage/when_declaring_command_form_peers.js

@@ -0,0 +1,16 @@
+import { readFileSync } from 'node:fs';
+import { expect } from 'vitest';
+const packageJson = JSON.parse(readFileSync('package.json', 'utf8'));
+describe('when declaring native command form peers', () => {
+    it('requires the published footer and native custom-error execution contracts', () => {
+        expect(packageJson.name).toBe('@cratis/scene.components');
+        expect(packageJson.peerDependencies['@cratis/components']).toBe('^4.13.0');
+        expect(packageJson.peerDependencies['@cratis/arc']).toBe('^22.19.1');
+        expect(packageJson.peerDependencies['@cratis/arc.react']).toBe('^22.19.1');
+    });
+    it('keeps Arc optional for an unbound design-time preview', () => {
+        expect(packageJson.peerDependenciesMeta['@cratis/arc'].optional).toBe(true);
+        expect(packageJson.peerDependenciesMeta['@cratis/arc.react'].optional).toBe(true);
+    });
+});
+//# sourceMappingURL=when_declaring_command_form_peers.js.map

package/dist/esm/for_cratisComponentsPackage/when_declaring_command_form_peers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"when_declaring_command_form_peers.js","sourceRoot":"","sources":["../../../for_cratisComponentsPackage/when_declaring_command_form_peers.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,cAAc,EAAE,MAAM,CAAC,CAIlE,CAAC;AAEF,QAAQ,CAAC,0CAA0C,EAAE,GAAG,EAAE;IACtD,EAAE,CAAC,2EAA2E,EAAE,GAAG,EAAE;QACjF,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QAC1D,MAAM,CAAC,WAAW,CAAC,gBAAgB,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3E,MAAM,CAAC,WAAW,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACrE,MAAM,CAAC,WAAW,CAAC,gBAAgB,CAAC,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC7D,MAAM,CAAC,WAAW,CAAC,oBAAoB,CAAC,aAAa,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5E,MAAM,CAAC,WAAW,CAAC,oBAAoB,CAAC,mBAAmB,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/esm/forms/CommandFormRuntime.d.ts

@@ -0,0 +1,11 @@
+import type { BoundConstructor } from '../bindings';
+import type { CommandInput } from './commandInputs';
+interface CommandFormRuntimeProps {
+    command: BoundConstructor;
+    inputs?: CommandInput[];
+    exclude?: string[];
+    submitLabel: string;
+}
+export default function CommandFormRuntime({ command, inputs, exclude, submitLabel }: CommandFormRuntimeProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=CommandFormRuntime.d.ts.map

package/dist/esm/forms/CommandFormRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandFormRuntime.d.ts","sourceRoot":"","sources":["../../../forms/CommandFormRuntime.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAIpD,UAAU,uBAAuB;IAC7B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACvB;AA4CD,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,uBAAuB,+BAS5G"}

package/dist/esm/forms/CommandFormRuntime.js

@@ -0,0 +1,77 @@
+import { jsx, jsxs } from 'react/jsx-runtime';
+import { AutoCommandForm } from '@cratis/components/CommandForm';
+import { CommandForm } from '@cratis/arc.react/commands';
+import { Guid } from '@cratis/fundamentals';
+import { CommandFormSubmit } from './CommandFormSubmit.js';
+import { ExplicitCommandField } from './ExplicitCommandField.js';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+// Runtime bindings erase the proxy's keys; the optional footer is a Components >=4.13 contract.
+const NativeAutoCommandForm = AutoCommandForm;
+/** Verify the whole command before mounting any native form: partial forms must never execute. */ function capability(command, inputs, exclude) {
+    let descriptors;
+    try {
+        descriptors = new command().propertyDescriptors;
+    } catch  {
+        return 'Unable to inspect command proxy';
+    }
+    if (!Array.isArray(descriptors)) return 'Command proxy has no property descriptors';
+    const byName = new Map();
+    for (const descriptor of descriptors){
+        if (!descriptor || typeof descriptor.name !== 'string' || !descriptor.name || typeof descriptor.isOptional !== 'boolean' || byName.has(descriptor.name)) return 'Ambiguous or invalid command property descriptors';
+        byName.set(descriptor.name, descriptor);
+    }
+    if (inputs) {
+        for (const input of inputs){
+            const descriptor = byName.get(input.property);
+            if (!descriptor) return `Unknown command property '${input.property}'`;
+            if (descriptor.type !== (input.type === 'guid' ? Guid : String)) return `Command property '${input.property}' type does not match '${input.type}'`;
+        }
+        for (const descriptor of byName.values()){
+            if (!descriptor.isOptional && !inputs.some((input)=>input.property === descriptor.name)) return `Required command property '${descriptor.name}' has no input`;
+        }
+    } else {
+        for (const descriptor of byName.values()){
+            if (!descriptor.isOptional && (exclude?.includes(descriptor.name) || ![
+                String,
+                Number,
+                Boolean,
+                Date
+            ].includes(descriptor.type))) {
+                return `Required command property '${descriptor.name}' has no supported automatic field; declare inputs`;
+            }
+        }
+    }
+    return undefined;
+}
+/** Private lazy entry point: importing the Scene registry must not import Arc. */ function CommandFormRuntime({ command, inputs, exclude, submitLabel }) {
+    const error = capability(command, inputs, exclude);
+    if (error) return /*#__PURE__*/ jsx("div", {
+        role: "alert",
+        children: error
+    });
+    // The registry's never-argument constructor is erased; Arc creates this checked proxy with no args.
+    if (inputs) return /*#__PURE__*/ jsxs(CommandForm, {
+        command: command,
+        showTitles: false,
+        children: [
+            inputs.map((input)=>/*#__PURE__*/ jsx(ExplicitCommandField, {
+                    input: input
+                }, input.property)),
+            /*#__PURE__*/ jsx(CommandFormSubmit, {
+                label: submitLabel
+            })
+        ]
+    });
+    return /*#__PURE__*/ jsx(NativeAutoCommandForm, {
+        command: command,
+        exclude: exclude,
+        footer: /*#__PURE__*/ jsx(CommandFormSubmit, {
+            label: submitLabel
+        })
+    });
+}
+
+export { CommandFormRuntime as default };
+//# sourceMappingURL=CommandFormRuntime.js.map

package/dist/esm/forms/CommandFormRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandFormRuntime.js","sources":["../../../forms/CommandFormRuntime.tsx"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport type { ComponentType, ReactNode } from 'react';\nimport { AutoCommandForm } from '@cratis/components/CommandForm';\nimport { CommandForm } from '@cratis/arc.react/commands';\nimport { Guid } from '@cratis/fundamentals';\nimport type { BoundConstructor } from '../bindings';\nimport type { CommandInput } from './commandInputs';\nimport { CommandFormSubmit } from './CommandFormSubmit';\nimport { ExplicitCommandField } from './ExplicitCommandField';\n\ninterface CommandFormRuntimeProps {\n    command: BoundConstructor;\n    inputs?: CommandInput[];\n    exclude?: string[];\n    submitLabel: string;\n}\n\n// Runtime bindings erase the proxy's keys; the optional footer is a Components >=4.13 contract.\nconst NativeAutoCommandForm = AutoCommandForm as unknown as ComponentType<{\n    command: BoundConstructor;\n    exclude?: string[];\n    footer?: ReactNode;\n}>;\n\ntype Descriptor = { name: string; type: unknown; isOptional: boolean };\n\n/** Verify the whole command before mounting any native form: partial forms must never execute. */\nfunction capability(command: BoundConstructor, inputs?: CommandInput[], exclude?: string[]): string | undefined {\n    let descriptors: unknown;\n    try { descriptors = (new command() as { propertyDescriptors?: unknown }).propertyDescriptors; }\n    catch { return 'Unable to inspect command proxy'; }\n    if (!Array.isArray(descriptors)) return 'Command proxy has no property descriptors';\n    const byName = new Map<string, Descriptor>();\n    for (const descriptor of descriptors) {\n        if (!descriptor || typeof descriptor.name !== 'string' || !descriptor.name ||\n            typeof descriptor.isOptional !== 'boolean' || byName.has(descriptor.name)) return 'Ambiguous or invalid command property descriptors';\n        byName.set(descriptor.name, descriptor);\n    }\n    if (inputs) {\n        for (const input of inputs) {\n            const descriptor = byName.get(input.property);\n            if (!descriptor) return `Unknown command property '${input.property}'`;\n            if (descriptor.type !== (input.type === 'guid' ? Guid : String)) return `Command property '${input.property}' type does not match '${input.type}'`;\n        }\n        for (const descriptor of byName.values()) {\n            if (!descriptor.isOptional && !inputs.some(input => input.property === descriptor.name)) return `Required command property '${descriptor.name}' has no input`;\n        }\n    } else {\n        for (const descriptor of byName.values()) {\n            if (!descriptor.isOptional && (exclude?.includes(descriptor.name) ||\n                ![String, Number, Boolean, Date].includes(descriptor.type as typeof String))) {\n                return `Required command property '${descriptor.name}' has no supported automatic field; declare inputs`;\n            }\n        }\n    }\n    return undefined;\n}\n\n/** Private lazy entry point: importing the Scene registry must not import Arc. */\nexport default function CommandFormRuntime({ command, inputs, exclude, submitLabel }: CommandFormRuntimeProps) {\n    const error = capability(command, inputs, exclude);\n    if (error) return <div role='alert'>{error}</div>;\n    // The registry's never-argument constructor is erased; Arc creates this checked proxy with no args.\n    if (inputs) return <CommandForm command={command as unknown as new () => object} showTitles={false}>\n        {inputs.map(input => <ExplicitCommandField key={input.property} input={input} />)}\n        <CommandFormSubmit label={submitLabel} />\n    </CommandForm>;\n    return <NativeAutoCommandForm command={command} exclude={exclude} footer={<CommandFormSubmit label={submitLabel} />} />;\n}\n"],"names":["NativeAutoCommandForm","AutoCommandForm","capability","command","inputs","exclude","descriptors","propertyDescriptors","Array","isArray","byName","Map","descriptor","name","isOptional","has","set","input","get","property","type","Guid","String","values","some","includes","Number","Boolean","Date","undefined","CommandFormRuntime","submitLabel","error","_jsx","div","role","_jsxs","CommandForm","showTitles","map","ExplicitCommandField","CommandFormSubmit","label","footer"],"mappings":"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"}

package/dist/esm/forms/CommandFormSubmit.d.ts

@@ -0,0 +1,6 @@
+interface CommandFormSubmitProps {
+    label: string;
+}
+export declare function CommandFormSubmit({ label }: CommandFormSubmitProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=CommandFormSubmit.d.ts.map

package/dist/esm/forms/CommandFormSubmit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandFormSubmit.d.ts","sourceRoot":"","sources":["../../../forms/CommandFormSubmit.tsx"],"names":[],"mappings":"AAKA,UAAU,sBAAsB;IAC5B,KAAK,EAAE,MAAM,CAAC;CACjB;AAGD,wBAAgB,iBAAiB,CAAC,EAAE,KAAK,EAAE,EAAE,sBAAsB,+BAKlE"}

package/dist/esm/forms/CommandFormSubmit.js

@@ -0,0 +1,17 @@
+import { jsx } from 'react/jsx-runtime';
+import { useCommandFormContext } from '@cratis/arc.react/commands';
+
+/** Internal footer child; only rendered under the native form's context. */ function CommandFormSubmit({ label }) {
+    const { isExecuting, isAuthorized } = useCommandFormContext();
+    // Do not gate on isValid: submitting untouched invalid fields must reveal native validation.
+    // No click handler: the containing Arc form owns submission, validation and execution.
+    return /*#__PURE__*/ jsx("button", {
+        type: "submit",
+        disabled: isExecuting || !isAuthorized,
+        "aria-busy": isExecuting,
+        children: label
+    });
+}
+
+export { CommandFormSubmit };
+//# sourceMappingURL=CommandFormSubmit.js.map

package/dist/esm/forms/CommandFormSubmit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandFormSubmit.js","sources":["../../../forms/CommandFormSubmit.tsx"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { useCommandFormContext } from '@cratis/arc.react/commands';\n\ninterface CommandFormSubmitProps {\n    label: string;\n}\n\n/** Internal footer child; only rendered under the native form's context. */\nexport function CommandFormSubmit({ label }: CommandFormSubmitProps) {\n    const { isExecuting, isAuthorized } = useCommandFormContext();\n    // Do not gate on isValid: submitting untouched invalid fields must reveal native validation.\n    // No click handler: the containing Arc form owns submission, validation and execution.\n    return <button type='submit' disabled={isExecuting || !isAuthorized} aria-busy={isExecuting}>{label}</button>;\n}\n"],"names":["CommandFormSubmit","label","isExecuting","isAuthorized","useCommandFormContext","_jsx","button","type","disabled","aria-busy"],"mappings":";;;AASA,6EACO,SAASA,iBAAAA,CAAkB,EAAEC,KAAK,EAA0B,EAAA;AAC/D,IAAA,MAAM,EAAEC,WAAW,EAAEC,YAAY,EAAE,GAAGC,qBAAAA,EAAAA;;;AAGtC,IAAA,qBAAOC,GAAA,CAACC,QAAAA,EAAAA;QAAOC,IAAAA,EAAK,QAAA;AAASC,QAAAA,QAAAA,EAAUN,eAAe,CAACC,YAAAA;QAAcM,WAAAA,EAAWP,WAAAA;AAAcD,QAAAA,QAAAA,EAAAA;;AAClG;;"}

package/dist/esm/forms/ExplicitCommandField.d.ts

@@ -0,0 +1,5 @@
+import type { CommandInput } from './commandInputs';
+export declare function ExplicitCommandField({ input }: {
+    input: CommandInput;
+}): import("react").JSX.Element;
+//# sourceMappingURL=ExplicitCommandField.d.ts.map

package/dist/esm/forms/ExplicitCommandField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExplicitCommandField.d.ts","sourceRoot":"","sources":["../../../forms/ExplicitCommandField.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AA4EpD,wBAAgB,oBAAoB,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,YAAY,CAAA;CAAE,+BAGtE"}