@cratis/scene.components 3.5.0 → 3.7.0

package/dist/cjs/cratisComponentsPackage.js

@@ -42,6 +42,7 @@ var cratisComponents = require('./cratisComponents.js');
         'dataPage',
         'formElement',
         'singleResult',
+        'queryInputForm',
         'dataTable',
         'table',
         'observableDataTable',
@@ -91,7 +92,7 @@ var cratisComponents = require('./cratisComponents.js');
     // Shipping a theme here would be this library asserting a look it was specifically built not to have.
     themes: [],
     displayName: 'Cratis Components',
-    description: "Cratis' Arc-bound data, form and dialog composites, built on PrimeReact and Tailwind. dataTable and table accept optional object-valued queryArguments for collection queries. singleResult displays one read-only scalar own resultField of an optional model using an explicit query, object queryArguments and enabled: true.",
+    description: "Cratis' Arc-bound data, form and dialog composites, built on PrimeReact and Tailwind. dataTable and table accept optional object-valued queryArguments for collection queries. singleResult displays one read-only scalar own resultField of an optional model using an explicit query, object queryArguments and enabled: true. queryInputForm commits explicit string inputs on submit to the same optional-single runtime; drafts never execute a query.",
     module: '@cratis/scene.components',
     license: 'MIT',
     licenseUrl: 'https://github.com/Cratis/Scene/blob/main/LICENSE'

package/dist/cjs/cratisComponentsPackage.js.map

@@ -1 +1 @@
-{"version":3,"file":"cratisComponentsPackage.js","sources":["../../cratisComponentsPackage.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 { PackageKind, ScenePackage } from '@cratis/scene.model';\nimport { ScenePackageBundle } from '@cratis/scene.react';\nimport { cratisComponents, cratisComponentsPackageName } from './cratisComponents';\n\n/**\n * The `Cratis.Components` package's declaration - what a profile gets when it lists this package.\n *\n * This is the concrete case the whole package-dependency mechanism exists for. `@cratis/components` is\n * not a self-contained library: every component in it is a wrapper over a PrimeReact widget, and its own\n * styling is a `--cratis-*` token layer (`@cratis/components/tokens`) plus the component stylesheets and\n * compiled Tailwind utilities in `@cratis/components/styles`. Activate it in a profile without PrimeReact\n * and nothing renders; activate it without Tailwind and everything renders unstyled. Both are stated as\n * dependencies so a package picker can say so while the profile is being configured, instead of leaving\n * it to be discovered when the page opens.\n *\n * The version ranges are the real ones the library carries. `>=11.0.0` for PrimeReact: version 3.0.0\n * declares `primereact@^11` as a peer dependency and is built against version 11's component set, so the\n * span across the major boundary that the previous `>=10.9.0` range described is over. The `--cratis-*`\n * tokens still resolve a version 10 theme variable as their last fallback, but that is an upgrade-window\n * courtesy for an application with a compiled version 10 stylesheet still on the page - not a version of\n * PrimeReact this package can be activated against. `^4.0.0` for Tailwind, because the utility sheet is\n * compiled against Tailwind 4.\n */\nexport const cratisComponentsPackageManifest: ScenePackage = {\n    name: cratisComponentsPackageName,\n    version: '3.0.0',\n    kind: PackageKind.ComponentLibrary,\n    dependencies: [\n        { name: 'PrimeReact', versionRange: '>=11.0.0' },\n        { name: 'Tailwind', versionRange: '^4.0.0' },\n    ],\n    components: [\n        'page',\n        'dataPage',\n        'formElement',\n        'singleResult',\n        'dataTable',\n        'table',\n        'observableDataTable',\n        'commandForm',\n        'inputTextField',\n        'numberField',\n        'checkboxField',\n        'textAreaField',\n        'dropdownField',\n        'sliderField',\n        'calendarField',\n        'colorPickerField',\n        'multiSelectField',\n        'chipsField',\n        'radioButtonField',\n        'radioGroupField',\n        'dialog',\n        'confirmationDialog',\n        'busyIndicatorDialog',\n        'commandDialog',\n        'stepperCommandDialog',\n        'icon',\n        'tooltip',\n        'dropdown',\n        'errorBoundary',\n        'objectContentEditor',\n        'objectNavigationalBar',\n        'schemaEditor',\n        'timeMachine',\n        'filterPanel',\n        'toolbar',\n        'toolbarButton',\n        'toolbarGroup',\n        'toolbarSeparator',\n    ],\n\n    // A component library ships components, and nothing else. Layouts, screen templates and dialog\n    // templates all belong to a Blueprint: they are decisions about what an application looks like as a\n    // whole, and this package deliberately makes none of them - it provides the Arc-bound composites a\n    // template is *built from*, so that a blueprint can place a `dataPage` in a slot and configure it,\n    // rather than shipping one opinionated data page nobody can rearrange.\n    layouts: [],\n    screenTemplates: [],\n    dialogTemplates: [],\n\n    // No themes either, for a different reason: `@cratis/components` has no palette of its own. It reads\n    // a `--cratis-*` variable layer that resolves whatever is in front of it - the `--p-*` properties a\n    // PrimeReact 11 preset emits at runtime, or a Scene theme through this package's token bridge.\n    // Shipping a theme here would be this library asserting a look it was specifically built not to have.\n    themes: [],\n\n    displayName: 'Cratis Components',\n    description: \"Cratis' Arc-bound data, form and dialog composites, built on PrimeReact and Tailwind. dataTable and table accept optional object-valued queryArguments for collection queries. singleResult displays one read-only scalar own resultField of an optional model using an explicit query, object queryArguments and enabled: true.\",\n    module: '@cratis/scene.components',\n    license: 'MIT',\n    licenseUrl: 'https://github.com/Cratis/Scene/blob/main/LICENSE',\n};\n\n/**\n * The `Cratis.Components` package as a loadable bundle - the manifest above, plus the React components\n * behind the names it declares.\n *\n * No `layouts`, `screenTemplates`, `dialogTemplates` or `themes` are provided, matching a manifest that\n * declares none of them; `validatePackageBundle` is what proves the two halves agree.\n */\nexport const cratisComponentsPackage: ScenePackageBundle = {\n    manifest: cratisComponentsPackageManifest,\n    components: cratisComponents,\n};\n"],"names":["cratisComponentsPackageManifest","name","cratisComponentsPackageName","version","kind","PackageKind","ComponentLibrary","dependencies","versionRange","components","layouts","screenTemplates","dialogTemplates","themes","displayName","description","module","license","licenseUrl","cratisComponentsPackage","manifest","cratisComponents"],"mappings":";;;;;AAAA;AACA;AAMA;;;;;;;;;;;;;;;;;;UAmBaA,+BAAAA,GAAgD;IACzDC,IAAAA,EAAMC,4CAAAA;IACNC,OAAAA,EAAS,OAAA;AACTC,IAAAA,IAAAA,EAAMC,wBAAYC,gBAAgB;IAClCC,YAAAA,EAAc;AACV,QAAA;YAAEN,IAAAA,EAAM,YAAA;YAAcO,YAAAA,EAAc;AAAW,SAAA;AAC/C,QAAA;YAAEP,IAAAA,EAAM,UAAA;YAAYO,YAAAA,EAAc;AAAS;AAC9C,KAAA;IACDC,UAAAA,EAAY;AACR,QAAA,MAAA;AACA,QAAA,UAAA;AACA,QAAA,aAAA;AACA,QAAA,cAAA;AACA,QAAA,WAAA;AACA,QAAA,OAAA;AACA,QAAA,qBAAA;AACA,QAAA,aAAA;AACA,QAAA,gBAAA;AACA,QAAA,aAAA;AACA,QAAA,eAAA;AACA,QAAA,eAAA;AACA,QAAA,eAAA;AACA,QAAA,aAAA;AACA,QAAA,eAAA;AACA,QAAA,kBAAA;AACA,QAAA,kBAAA;AACA,QAAA,YAAA;AACA,QAAA,kBAAA;AACA,QAAA,iBAAA;AACA,QAAA,QAAA;AACA,QAAA,oBAAA;AACA,QAAA,qBAAA;AACA,QAAA,eAAA;AACA,QAAA,sBAAA;AACA,QAAA,MAAA;AACA,QAAA,SAAA;AACA,QAAA,UAAA;AACA,QAAA,eAAA;AACA,QAAA,qBAAA;AACA,QAAA,uBAAA;AACA,QAAA,cAAA;AACA,QAAA,aAAA;AACA,QAAA,aAAA;AACA,QAAA,SAAA;AACA,QAAA,eAAA;AACA,QAAA,cAAA;AACA,QAAA;AACH,KAAA;;;;;;AAODC,IAAAA,OAAAA,EAAS,EAAE;AACXC,IAAAA,eAAAA,EAAiB,EAAE;AACnBC,IAAAA,eAAAA,EAAiB,EAAE;;;;;AAMnBC,IAAAA,MAAAA,EAAQ,EAAE;IAEVC,WAAAA,EAAa,mBAAA;IACbC,WAAAA,EAAa,kUAAA;IACbC,MAAAA,EAAQ,0BAAA;IACRC,OAAAA,EAAS,KAAA;IACTC,UAAAA,EAAY;AAChB;AAEA;;;;;;UAOaC,uBAAAA,GAA8C;IACvDC,QAAAA,EAAUpB,+BAAAA;IACVS,UAAAA,EAAYY;AAChB;;;"}
+{"version":3,"file":"cratisComponentsPackage.js","sources":["../../cratisComponentsPackage.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 { PackageKind, ScenePackage } from '@cratis/scene.model';\nimport { ScenePackageBundle } from '@cratis/scene.react';\nimport { cratisComponents, cratisComponentsPackageName } from './cratisComponents';\n\n/**\n * The `Cratis.Components` package's declaration - what a profile gets when it lists this package.\n *\n * This is the concrete case the whole package-dependency mechanism exists for. `@cratis/components` is\n * not a self-contained library: every component in it is a wrapper over a PrimeReact widget, and its own\n * styling is a `--cratis-*` token layer (`@cratis/components/tokens`) plus the component stylesheets and\n * compiled Tailwind utilities in `@cratis/components/styles`. Activate it in a profile without PrimeReact\n * and nothing renders; activate it without Tailwind and everything renders unstyled. Both are stated as\n * dependencies so a package picker can say so while the profile is being configured, instead of leaving\n * it to be discovered when the page opens.\n *\n * The version ranges are the real ones the library carries. `>=11.0.0` for PrimeReact: version 3.0.0\n * declares `primereact@^11` as a peer dependency and is built against version 11's component set, so the\n * span across the major boundary that the previous `>=10.9.0` range described is over. The `--cratis-*`\n * tokens still resolve a version 10 theme variable as their last fallback, but that is an upgrade-window\n * courtesy for an application with a compiled version 10 stylesheet still on the page - not a version of\n * PrimeReact this package can be activated against. `^4.0.0` for Tailwind, because the utility sheet is\n * compiled against Tailwind 4.\n */\nexport const cratisComponentsPackageManifest: ScenePackage = {\n    name: cratisComponentsPackageName,\n    version: '3.0.0',\n    kind: PackageKind.ComponentLibrary,\n    dependencies: [\n        { name: 'PrimeReact', versionRange: '>=11.0.0' },\n        { name: 'Tailwind', versionRange: '^4.0.0' },\n    ],\n    components: [\n        'page',\n        'dataPage',\n        'formElement',\n        'singleResult',\n        'queryInputForm',\n        'dataTable',\n        'table',\n        'observableDataTable',\n        'commandForm',\n        'inputTextField',\n        'numberField',\n        'checkboxField',\n        'textAreaField',\n        'dropdownField',\n        'sliderField',\n        'calendarField',\n        'colorPickerField',\n        'multiSelectField',\n        'chipsField',\n        'radioButtonField',\n        'radioGroupField',\n        'dialog',\n        'confirmationDialog',\n        'busyIndicatorDialog',\n        'commandDialog',\n        'stepperCommandDialog',\n        'icon',\n        'tooltip',\n        'dropdown',\n        'errorBoundary',\n        'objectContentEditor',\n        'objectNavigationalBar',\n        'schemaEditor',\n        'timeMachine',\n        'filterPanel',\n        'toolbar',\n        'toolbarButton',\n        'toolbarGroup',\n        'toolbarSeparator',\n    ],\n\n    // A component library ships components, and nothing else. Layouts, screen templates and dialog\n    // templates all belong to a Blueprint: they are decisions about what an application looks like as a\n    // whole, and this package deliberately makes none of them - it provides the Arc-bound composites a\n    // template is *built from*, so that a blueprint can place a `dataPage` in a slot and configure it,\n    // rather than shipping one opinionated data page nobody can rearrange.\n    layouts: [],\n    screenTemplates: [],\n    dialogTemplates: [],\n\n    // No themes either, for a different reason: `@cratis/components` has no palette of its own. It reads\n    // a `--cratis-*` variable layer that resolves whatever is in front of it - the `--p-*` properties a\n    // PrimeReact 11 preset emits at runtime, or a Scene theme through this package's token bridge.\n    // Shipping a theme here would be this library asserting a look it was specifically built not to have.\n    themes: [],\n\n    displayName: 'Cratis Components',\n    description: \"Cratis' Arc-bound data, form and dialog composites, built on PrimeReact and Tailwind. dataTable and table accept optional object-valued queryArguments for collection queries. singleResult displays one read-only scalar own resultField of an optional model using an explicit query, object queryArguments and enabled: true. queryInputForm commits explicit string inputs on submit to the same optional-single runtime; drafts never execute a query.\",\n    module: '@cratis/scene.components',\n    license: 'MIT',\n    licenseUrl: 'https://github.com/Cratis/Scene/blob/main/LICENSE',\n};\n\n/**\n * The `Cratis.Components` package as a loadable bundle - the manifest above, plus the React components\n * behind the names it declares.\n *\n * No `layouts`, `screenTemplates`, `dialogTemplates` or `themes` are provided, matching a manifest that\n * declares none of them; `validatePackageBundle` is what proves the two halves agree.\n */\nexport const cratisComponentsPackage: ScenePackageBundle = {\n    manifest: cratisComponentsPackageManifest,\n    components: cratisComponents,\n};\n"],"names":["cratisComponentsPackageManifest","name","cratisComponentsPackageName","version","kind","PackageKind","ComponentLibrary","dependencies","versionRange","components","layouts","screenTemplates","dialogTemplates","themes","displayName","description","module","license","licenseUrl","cratisComponentsPackage","manifest","cratisComponents"],"mappings":";;;;;AAAA;AACA;AAMA;;;;;;;;;;;;;;;;;;UAmBaA,+BAAAA,GAAgD;IACzDC,IAAAA,EAAMC,4CAAAA;IACNC,OAAAA,EAAS,OAAA;AACTC,IAAAA,IAAAA,EAAMC,wBAAYC,gBAAgB;IAClCC,YAAAA,EAAc;AACV,QAAA;YAAEN,IAAAA,EAAM,YAAA;YAAcO,YAAAA,EAAc;AAAW,SAAA;AAC/C,QAAA;YAAEP,IAAAA,EAAM,UAAA;YAAYO,YAAAA,EAAc;AAAS;AAC9C,KAAA;IACDC,UAAAA,EAAY;AACR,QAAA,MAAA;AACA,QAAA,UAAA;AACA,QAAA,aAAA;AACA,QAAA,cAAA;AACA,QAAA,gBAAA;AACA,QAAA,WAAA;AACA,QAAA,OAAA;AACA,QAAA,qBAAA;AACA,QAAA,aAAA;AACA,QAAA,gBAAA;AACA,QAAA,aAAA;AACA,QAAA,eAAA;AACA,QAAA,eAAA;AACA,QAAA,eAAA;AACA,QAAA,aAAA;AACA,QAAA,eAAA;AACA,QAAA,kBAAA;AACA,QAAA,kBAAA;AACA,QAAA,YAAA;AACA,QAAA,kBAAA;AACA,QAAA,iBAAA;AACA,QAAA,QAAA;AACA,QAAA,oBAAA;AACA,QAAA,qBAAA;AACA,QAAA,eAAA;AACA,QAAA,sBAAA;AACA,QAAA,MAAA;AACA,QAAA,SAAA;AACA,QAAA,UAAA;AACA,QAAA,eAAA;AACA,QAAA,qBAAA;AACA,QAAA,uBAAA;AACA,QAAA,cAAA;AACA,QAAA,aAAA;AACA,QAAA,aAAA;AACA,QAAA,SAAA;AACA,QAAA,eAAA;AACA,QAAA,cAAA;AACA,QAAA;AACH,KAAA;;;;;;AAODC,IAAAA,OAAAA,EAAS,EAAE;AACXC,IAAAA,eAAAA,EAAiB,EAAE;AACnBC,IAAAA,eAAAA,EAAiB,EAAE;;;;;AAMnBC,IAAAA,MAAAA,EAAQ,EAAE;IAEVC,WAAAA,EAAa,mBAAA;IACbC,WAAAA,EAAa,6bAAA;IACbC,MAAAA,EAAQ,0BAAA;IACRC,OAAAA,EAAS,KAAA;IACTC,UAAAA,EAAY;AAChB;AAEA;;;;;;UAOaC,uBAAAA,GAA8C;IACvDC,QAAAA,EAAUpB,+BAAAA;IACVS,UAAAA,EAAYY;AAChB;;;"}

package/dist/cjs/data/SingleResultRuntime.js

@@ -5,12 +5,13 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var jsxRuntime = require('react/jsx-runtime');
 var react = require('react');
 var arc_react = require('@cratis/arc.react');
+var fundamentals = require('@cratis/fundamentals');
 var SingleResultStatus = require('./SingleResultStatus.js');
 
 /**
  * Private execution owner. Arc owns validation, routing, HTTP and deserialization; this component
  * owns only request lifetime and presentation. No shared cache can hand B the result belonging to A.
- */ function SingleResultRuntime({ query, queryArguments, resultField }) {
+ */ function SingleResultRuntime({ query, queryArguments, resultField, stringInputs = false }) {
     const arc = react.useContext(arc_react.ArcContext);
     const { microservice, apiBasePath, origin, httpHeadersCallback, queryVersion } = arc;
     // Identity is deliberate: hosts replace immutable committed arguments rather than mutating them.
@@ -18,6 +19,7 @@ var SingleResultStatus = require('./SingleResultStatus.js');
             query,
             queryArguments,
             resultField,
+            stringInputs,
             microservice,
             apiBasePath,
             origin,
@@ -27,6 +29,7 @@ var SingleResultStatus = require('./SingleResultStatus.js');
         query,
         queryArguments,
         resultField,
+        stringInputs,
         microservice,
         apiBasePath,
         origin,
@@ -54,6 +57,18 @@ var SingleResultStatus = require('./SingleResultStatus.js');
                     });
                     return;
                 }
+                // Arc perform does not validate argument-to-descriptor types. The form supports only
+                // scalar String/Guid inputs, matched by exact name and constructor, never by naming
+                // convention. This check is lazy and form-only; singleResult's host contract is intact.
+                if (request.stringInputs && !Object.entries(request.queryArguments).every(([name, value])=>{
+                    const descriptors = instance.parameterDescriptors.filter((descriptor)=>descriptor.name === name);
+                    return typeof value === 'string' && descriptors.length === 1 && !descriptors[0].isEnumerable && (descriptors[0].type === String || descriptors[0].type === fundamentals.Guid);
+                })) {
+                    publish({
+                        state: 'failure'
+                    });
+                    return;
+                }
                 instance.setMicroservice(request.microservice);
                 instance.setApiBasePath(request.apiBasePath ?? '');
                 instance.setOrigin(request.origin ?? '');

package/dist/cjs/data/SingleResultRuntime.js.map

@@ -1 +1 @@
-{"version":3,"file":"SingleResultRuntime.js","sources":["../../../data/SingleResultRuntime.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 { useContext, useEffect, useMemo, useState } from 'react';\nimport { ArcContext } from '@cratis/arc.react';\nimport type { QueryFor } from '@cratis/arc/queries';\nimport type { BoundConstructor } from '../bindings/BoundConstructor';\nimport { SingleResultStatus } from './SingleResultStatus';\n\ninterface Props {\n    query: BoundConstructor;\n    queryArguments: Record<string, unknown>;\n    resultField: string;\n}\n\ntype Outcome = { state: 'failure' | 'notFound' } | { state: 'success'; value: string };\n\n/**\n * Private execution owner. Arc owns validation, routing, HTTP and deserialization; this component\n * owns only request lifetime and presentation. No shared cache can hand B the result belonging to A.\n */\nexport default function SingleResultRuntime({ query, queryArguments, resultField }: Props) {\n    const arc = useContext(ArcContext);\n    const { microservice, apiBasePath, origin, httpHeadersCallback, queryVersion } = arc;\n    // Identity is deliberate: hosts replace immutable committed arguments rather than mutating them.\n    const request = useMemo(() => ({ query, queryArguments, resultField, microservice, apiBasePath, origin, httpHeadersCallback, queryVersion }),\n        [query, queryArguments, resultField, microservice, apiBasePath, origin, httpHeadersCallback, queryVersion]);\n    const [settled, setSettled] = useState<{ request: typeof request; outcome: Outcome }>();\n\n    useEffect(() => {\n        // Each effect setup is a generation, including StrictMode's setup/cleanup/setup replay.\n        let current = true;\n        let instance: QueryFor<unknown, Record<string, unknown>> | undefined;\n        const publish = (outcome: Outcome) => {\n            if (current) setSettled({ request, outcome });\n        };\n        const execute = async () => {\n            try {\n                // The registry intentionally stores constructors without an eager Arc dependency.\n                instance = new request.query() as QueryFor<unknown, Record<string, unknown>>;\n                if (instance.enumerable !== false) {\n                    publish({ state: 'failure' });\n                    return;\n                }\n                instance.setMicroservice(request.microservice);\n                instance.setApiBasePath(request.apiBasePath ?? '');\n                instance.setOrigin(request.origin ?? '');\n                instance.setHttpHeadersCallback(request.httpHeadersCallback ?? (() => ({})));\n                // Native perform validates required arguments and proxy rules before HTTP. No copying,\n                // defaults, business validation, route construction or array wrapping happens here.\n                const result = await instance.perform(request.queryArguments);\n                if (!current) return;\n                if (result.isSuccess !== true || result.isAuthorized !== true || result.isValid !== true || result.hasExceptions !== false || result.isReady === false) {\n                    publish({ state: 'failure' });\n                    return;\n                }\n                if (result.data === null || result.data === undefined) {\n                    publish({ state: 'notFound' });\n                    return;\n                }\n                if (typeof result.data !== 'object' || Array.isArray(result.data)) {\n                    publish({ state: 'failure' });\n                    return;\n                }\n                // Only one own data field, never a path, inherited member, getter or expression.\n                const descriptor = Object.getOwnPropertyDescriptor(result.data, request.resultField);\n                const value: unknown = descriptor && 'value' in descriptor ? descriptor.value : undefined;\n                if (typeof value === 'string' || typeof value === 'boolean' || (typeof value === 'number' && Number.isFinite(value))) {\n                    publish({ state: 'success', value: String(value) });\n                } else {\n                    publish({ state: 'failure' });\n                }\n            } catch {\n                // Includes native AbortError rejections. Disposed generations cannot publish or leak\n                // an unhandled promise, even when the HTTP boundary ignores cancellation.\n                publish({ state: 'failure' });\n            }\n        };\n        void execute();\n        return () => {\n            current = false;\n            instance?.abortController?.abort();\n        };\n    }, [request]);\n\n    // Mask old data during the render that changes inputs, before effect cleanup/setup runs.\n    if (settled?.request !== request) return <SingleResultStatus state='loading' />;\n    return <SingleResultStatus {...settled.outcome} />;\n}\n"],"names":["SingleResultRuntime","query","queryArguments","resultField","arc","useContext","ArcContext","microservice","apiBasePath","origin","httpHeadersCallback","queryVersion","request","useMemo","settled","setSettled","useState","useEffect","current","instance","publish","outcome","execute","enumerable","state","setMicroservice","setApiBasePath","setOrigin","setHttpHeadersCallback","result","perform","isSuccess","isAuthorized","isValid","hasExceptions","isReady","data","undefined","Array","isArray","descriptor","Object","getOwnPropertyDescriptor","value","Number","isFinite","String","abortController","abort","_jsx","SingleResultStatus"],"mappings":";;;;;;;;;AAiBA;;;IAIe,SAASA,mBAAAA,CAAoB,EAAEC,KAAK,EAAEC,cAAc,EAAEC,WAAW,EAAS,EAAA;AACrF,IAAA,MAAMC,MAAMC,gBAAAA,CAAWC,oBAAAA,CAAAA;IACvB,MAAM,EAAEC,YAAY,EAAEC,WAAW,EAAEC,MAAM,EAAEC,mBAAmB,EAAEC,YAAY,EAAE,GAAGP,GAAAA;;IAEjF,MAAMQ,OAAAA,GAAUC,aAAAA,CAAQ,KAAO;AAAEZ,YAAAA,KAAAA;AAAOC,YAAAA,cAAAA;AAAgBC,YAAAA,WAAAA;AAAaI,YAAAA,YAAAA;AAAcC,YAAAA,WAAAA;AAAaC,YAAAA,MAAAA;AAAQC,YAAAA,mBAAAA;AAAqBC,YAAAA;AAAa,SAAA,CAAA,EACtI;AAACV,QAAAA,KAAAA;AAAOC,QAAAA,cAAAA;AAAgBC,QAAAA,WAAAA;AAAaI,QAAAA,YAAAA;AAAcC,QAAAA,WAAAA;AAAaC,QAAAA,MAAAA;AAAQC,QAAAA,mBAAAA;AAAqBC,QAAAA;AAAa,KAAA,CAAA;IAC9G,MAAM,CAACG,OAAAA,EAASC,UAAAA,CAAW,GAAGC,cAAAA,EAAAA;IAE9BC,eAAAA,CAAU,IAAA;;AAEN,QAAA,IAAIC,OAAAA,GAAU,IAAA;QACd,IAAIC,QAAAA;AACJ,QAAA,MAAMC,UAAU,CAACC,OAAAA,GAAAA;AACb,YAAA,IAAIH,SAASH,UAAAA,CAAW;AAAEH,gBAAAA,OAAAA;AAASS,gBAAAA;AAAQ,aAAA,CAAA;AAC/C,QAAA,CAAA;AACA,QAAA,MAAMC,OAAAA,GAAU,UAAA;YACZ,IAAI;;gBAEAH,QAAAA,GAAW,IAAIP,QAAQX,KAAK,EAAA;gBAC5B,IAAIkB,QAAAA,CAASI,UAAU,KAAK,KAAA,EAAO;oBAC/BH,OAAAA,CAAQ;wBAAEI,KAAAA,EAAO;AAAU,qBAAA,CAAA;AAC3B,oBAAA;AACJ,gBAAA;gBACAL,QAAAA,CAASM,eAAe,CAACb,OAAAA,CAAQL,YAAY,CAAA;AAC7CY,gBAAAA,QAAAA,CAASO,cAAc,CAACd,OAAAA,CAAQJ,WAAW,IAAI,EAAA,CAAA;AAC/CW,gBAAAA,QAAAA,CAASQ,SAAS,CAACf,OAAAA,CAAQH,MAAM,IAAI,EAAA,CAAA;gBACrCU,QAAAA,CAASS,sBAAsB,CAAChB,OAAAA,CAAQF,mBAAmB,KAAK,KAAO,EAAC,CAAC,CAAA,CAAA;;;AAGzE,gBAAA,MAAMmB,SAAS,MAAMV,QAAAA,CAASW,OAAO,CAAClB,QAAQV,cAAc,CAAA;AAC5D,gBAAA,IAAI,CAACgB,OAAAA,EAAS;AACd,gBAAA,IAAIW,OAAOE,SAAS,KAAK,QAAQF,MAAAA,CAAOG,YAAY,KAAK,IAAA,IAAQH,MAAAA,CAAOI,OAAO,KAAK,IAAA,IAAQJ,OAAOK,aAAa,KAAK,SAASL,MAAAA,CAAOM,OAAO,KAAK,KAAA,EAAO;oBACpJf,OAAAA,CAAQ;wBAAEI,KAAAA,EAAO;AAAU,qBAAA,CAAA;AAC3B,oBAAA;AACJ,gBAAA;AACA,gBAAA,IAAIK,OAAOO,IAAI,KAAK,QAAQP,MAAAA,CAAOO,IAAI,KAAKC,SAAAA,EAAW;oBACnDjB,OAAAA,CAAQ;wBAAEI,KAAAA,EAAO;AAAW,qBAAA,CAAA;AAC5B,oBAAA;AACJ,gBAAA;gBACA,IAAI,OAAOK,MAAAA,CAAOO,IAAI,KAAK,QAAA,IAAYE,MAAMC,OAAO,CAACV,MAAAA,CAAOO,IAAI,CAAA,EAAG;oBAC/DhB,OAAAA,CAAQ;wBAAEI,KAAAA,EAAO;AAAU,qBAAA,CAAA;AAC3B,oBAAA;AACJ,gBAAA;;gBAEA,MAAMgB,UAAAA,GAAaC,OAAOC,wBAAwB,CAACb,OAAOO,IAAI,EAAExB,QAAQT,WAAW,CAAA;AACnF,gBAAA,MAAMwC,QAAiBH,UAAAA,IAAc,OAAA,IAAWA,UAAAA,GAAaA,UAAAA,CAAWG,KAAK,GAAGN,SAAAA;AAChF,gBAAA,IAAI,OAAOM,KAAAA,KAAU,QAAA,IAAY,OAAOA,KAAAA,KAAU,SAAA,IAAc,OAAOA,KAAAA,KAAU,QAAA,IAAYC,MAAAA,CAAOC,QAAQ,CAACF,KAAAA,CAAAA,EAAS;oBAClHvB,OAAAA,CAAQ;wBAAEI,KAAAA,EAAO,SAAA;AAAWmB,wBAAAA,KAAAA,EAAOG,MAAAA,CAAOH,KAAAA;AAAO,qBAAA,CAAA;gBACrD,CAAA,MAAO;oBACHvB,OAAAA,CAAQ;wBAAEI,KAAAA,EAAO;AAAU,qBAAA,CAAA;AAC/B,gBAAA;AACJ,YAAA,CAAA,CAAE,OAAM;;;gBAGJJ,OAAAA,CAAQ;oBAAEI,KAAAA,EAAO;AAAU,iBAAA,CAAA;AAC/B,YAAA;AACJ,QAAA,CAAA;QACA,KAAKF,OAAAA,EAAAA;QACL,OAAO,IAAA;YACHJ,OAAAA,GAAU,KAAA;AACVC,YAAAA,QAAAA,EAAU4B,eAAAA,EAAiBC,KAAAA,EAAAA;AAC/B,QAAA,CAAA;IACJ,CAAA,EAAG;AAACpC,QAAAA;AAAQ,KAAA,CAAA;;AAGZ,IAAA,IAAIE,OAAAA,EAASF,OAAAA,KAAYA,OAAAA,EAAS,qBAAOqC,cAAA,CAACC,qCAAAA,EAAAA;QAAmB1B,KAAAA,EAAM;;AACnE,IAAA,qBAAOyB,cAAA,CAACC,qCAAAA,EAAAA;AAAoB,QAAA,GAAGpC,QAAQO;;AAC3C;;"}
+{"version":3,"file":"SingleResultRuntime.js","sources":["../../../data/SingleResultRuntime.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 { useContext, useEffect, useMemo, useState } from 'react';\nimport { ArcContext } from '@cratis/arc.react';\nimport type { QueryFor } from '@cratis/arc/queries';\nimport { Guid } from '@cratis/fundamentals';\nimport type { BoundConstructor } from '../bindings/BoundConstructor';\nimport { SingleResultStatus } from './SingleResultStatus';\n\ninterface Props {\n    query: BoundConstructor;\n    queryArguments: Record<string, unknown>;\n    resultField: string;\n    /** queryInputForm alone opts into scalar String/Guid descriptor mapping; no value conversion. */\n    stringInputs?: boolean;\n}\n\ntype Outcome = { state: 'failure' | 'notFound' } | { state: 'success'; value: string };\n\n/**\n * Private execution owner. Arc owns validation, routing, HTTP and deserialization; this component\n * owns only request lifetime and presentation. No shared cache can hand B the result belonging to A.\n */\nexport default function SingleResultRuntime({ query, queryArguments, resultField, stringInputs = false }: Props) {\n    const arc = useContext(ArcContext);\n    const { microservice, apiBasePath, origin, httpHeadersCallback, queryVersion } = arc;\n    // Identity is deliberate: hosts replace immutable committed arguments rather than mutating them.\n    const request = useMemo(() => ({ query, queryArguments, resultField, stringInputs, microservice, apiBasePath, origin, httpHeadersCallback, queryVersion }),\n        [query, queryArguments, resultField, stringInputs, microservice, apiBasePath, origin, httpHeadersCallback, queryVersion]);\n    const [settled, setSettled] = useState<{ request: typeof request; outcome: Outcome }>();\n\n    useEffect(() => {\n        // Each effect setup is a generation, including StrictMode's setup/cleanup/setup replay.\n        let current = true;\n        let instance: QueryFor<unknown, Record<string, unknown>> | undefined;\n        const publish = (outcome: Outcome) => {\n            if (current) setSettled({ request, outcome });\n        };\n        const execute = async () => {\n            try {\n                // The registry intentionally stores constructors without an eager Arc dependency.\n                instance = new request.query() as QueryFor<unknown, Record<string, unknown>>;\n                if (instance.enumerable !== false) {\n                    publish({ state: 'failure' });\n                    return;\n                }\n                // Arc perform does not validate argument-to-descriptor types. The form supports only\n                // scalar String/Guid inputs, matched by exact name and constructor, never by naming\n                // convention. This check is lazy and form-only; singleResult's host contract is intact.\n                if (request.stringInputs && !Object.entries(request.queryArguments).every(([name, value]) => {\n                    const descriptors = instance!.parameterDescriptors.filter(descriptor => descriptor.name === name);\n                    return typeof value === 'string' && descriptors.length === 1 && !descriptors[0].isEnumerable\n                        && (descriptors[0].type === String || descriptors[0].type === Guid);\n                })) {\n                    publish({ state: 'failure' });\n                    return;\n                }\n                instance.setMicroservice(request.microservice);\n                instance.setApiBasePath(request.apiBasePath ?? '');\n                instance.setOrigin(request.origin ?? '');\n                instance.setHttpHeadersCallback(request.httpHeadersCallback ?? (() => ({})));\n                // Native perform validates required arguments and proxy rules before HTTP. No copying,\n                // defaults, business validation, route construction or array wrapping happens here.\n                const result = await instance.perform(request.queryArguments);\n                if (!current) return;\n                if (result.isSuccess !== true || result.isAuthorized !== true || result.isValid !== true || result.hasExceptions !== false || result.isReady === false) {\n                    publish({ state: 'failure' });\n                    return;\n                }\n                if (result.data === null || result.data === undefined) {\n                    publish({ state: 'notFound' });\n                    return;\n                }\n                if (typeof result.data !== 'object' || Array.isArray(result.data)) {\n                    publish({ state: 'failure' });\n                    return;\n                }\n                // Only one own data field, never a path, inherited member, getter or expression.\n                const descriptor = Object.getOwnPropertyDescriptor(result.data, request.resultField);\n                const value: unknown = descriptor && 'value' in descriptor ? descriptor.value : undefined;\n                if (typeof value === 'string' || typeof value === 'boolean' || (typeof value === 'number' && Number.isFinite(value))) {\n                    publish({ state: 'success', value: String(value) });\n                } else {\n                    publish({ state: 'failure' });\n                }\n            } catch {\n                // Includes native AbortError rejections. Disposed generations cannot publish or leak\n                // an unhandled promise, even when the HTTP boundary ignores cancellation.\n                publish({ state: 'failure' });\n            }\n        };\n        void execute();\n        return () => {\n            current = false;\n            instance?.abortController?.abort();\n        };\n    }, [request]);\n\n    // Mask old data during the render that changes inputs, before effect cleanup/setup runs.\n    if (settled?.request !== request) return <SingleResultStatus state='loading' />;\n    return <SingleResultStatus {...settled.outcome} />;\n}\n"],"names":["SingleResultRuntime","query","queryArguments","resultField","stringInputs","arc","useContext","ArcContext","microservice","apiBasePath","origin","httpHeadersCallback","queryVersion","request","useMemo","settled","setSettled","useState","useEffect","current","instance","publish","outcome","execute","enumerable","state","Object","entries","every","name","value","descriptors","parameterDescriptors","filter","descriptor","length","isEnumerable","type","String","Guid","setMicroservice","setApiBasePath","setOrigin","setHttpHeadersCallback","result","perform","isSuccess","isAuthorized","isValid","hasExceptions","isReady","data","undefined","Array","isArray","getOwnPropertyDescriptor","Number","isFinite","abortController","abort","_jsx","SingleResultStatus"],"mappings":"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"}

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;;"}