@cratis/scene.components 4.15.0 → 4.17.0

package/forms/generateCommandFieldsAction.ts

@@ -13,16 +13,20 @@ export const generateCommandFieldsAction: DesignTimeAction = {
         description: 'Creates a deterministic editable field layout from the selected command metadata.',
     },
     isVisible: context => context.element.componentName.endsWith(':commandForm'),
-    isEnabled: context => Array.isArray(context.commandMetadata?.properties) && !Array.isArray(context.element.properties.inputs),
+    isEnabled: context => Array.isArray(context.commandMetadata?.properties) && context.element.properties.inputs === undefined,
     execute: context => generateCommandFields(context),
 };
 
 function generateCommandFields(context: DesignTimeActionContext): DesignTimeActionResult {
     const properties = context.commandMetadata?.properties ?? [];
     if (!properties.length) return { edits: [], diagnostics: ['No command metadata was supplied.'] };
+    // Authored fields, or a binding that supplies them, are never overwritten.
     if (Array.isArray(context.element.properties.inputs)) {
         return { edits: [], diagnostics: ['The form already has authored fields; Generate fields will not overwrite them.'] };
     }
+    if (context.element.properties.inputs !== undefined) {
+        return { edits: [], diagnostics: ['The form\'s fields come from a binding; Generate fields will not overwrite it.'] };
+    }
 
     return {
         diagnostics: [],

package/index.ts

@@ -13,3 +13,5 @@ export * from './toolbar';
 export * from './cratisComponents';
 export * from './cratisComponentsDescriptors';
 export * from './cratisComponentsPackage';
+export * from './cratisComponentsRuntimePackage';
+export * from './designTime/cratisComponentsDesignTime';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@cratis/scene.components",
-    "version": "4.15.0",
+    "version": "4.17.0",
     "description": "The Cratis Components package: exposes @cratis/components' Arc-bound data, form and dialog composites as Scene components. Built on PrimeReact and Tailwind, and declares both as dependencies.",
     "keywords": [
         "cratis",
@@ -39,6 +39,11 @@
             "require": "./dist/cjs/index.js",
             "import": "./dist/esm/index.js"
         },
+        "./runtime": {
+            "types": "./dist/esm/runtime.d.ts",
+            "require": "./dist/cjs/runtime.js",
+            "import": "./dist/esm/runtime.js"
+        },
         "./styles": "./theme/sceneTokenBridge.css"
     },
     "scripts": {
@@ -54,17 +59,17 @@
         "build-storybook": "storybook build"
     },
     "dependencies": {
-        "@cratis/scene.engine": "4.15.0",
-        "@cratis/scene.model": "4.15.0",
-        "@cratis/scene.react": "4.15.0"
+        "@cratis/scene.engine": "4.17.0",
+        "@cratis/scene.model": "4.17.0",
+        "@cratis/scene.react": "4.17.0"
     },
     "devDependencies": {
         "@cratis/arc": "22.50.5",
         "@cratis/arc.react": "22.50.5",
         "@cratis/components": "4.25.0",
-        "@cratis/scene.engine": "4.15.0",
-        "@cratis/scene.model": "4.15.0",
-        "@cratis/scene.react": "4.15.0",
+        "@cratis/scene.engine": "4.17.0",
+        "@cratis/scene.model": "4.17.0",
+        "@cratis/scene.react": "4.17.0",
         "@storybook/addon-links": "^10.6.1",
         "@storybook/react": "^10.6.1",
         "@storybook/react-vite": "^10.6.1",

package/runtime.ts

@@ -0,0 +1,9 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+// The runtime entry point, published as `@cratis/scene.components/runtime`. Nothing reachable from here is
+// design-time code; the bundle content specification walks the built output to prove it.
+export * from './cratisComponents';
+export * from './cratisComponentsDescriptors';
+export * from './cratisComponentsPackageManifest';
+export * from './cratisComponentsRuntimePackage';

package/toolbar/SceneToolbarButton.tsx

@@ -1,8 +1,10 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
+import { useContext } from 'react';
 import { ToolbarButton } from '@cratis/components/Toolbar';
-import { RegisteredComponentProps } from '@cratis/scene.react';
+import { DestinationReference } from '@cratis/scene.model';
+import { RegisteredComponentProps, SceneNavigationContextInternal } from '@cratis/scene.react';
 import { booleanProperty, stringProperty, unionProperty } from '../properties';
 
 /** Which side of the button its tooltip appears on. */
@@ -16,8 +18,21 @@ const tooltipPositions = ['top', 'right', 'bottom', 'left'] as const;
  * icons. It defaults to the `text` property rather than to an empty string, so a button that has a
  * visible label is never left nameless.
  */
-export function SceneToolbarButton({ element }: RegisteredComponentProps) {
+/**
+ * A toolbar button. Its authored `destination` - a screen in an outlet, or a dialog - is executed by the
+ * enclosing navigation host; outside one it is announced with the host-neutral `cratis.scene.navigate` event.
+ * Interactions attached by the document run first.
+ */
+export function SceneToolbarButton({ element, interactions }: RegisteredComponentProps) {
     const text = stringProperty(element.properties, 'text');
+    const navigation = useContext(SceneNavigationContextInternal);
+    const destination = isDestination(element.properties.destination) ? element.properties.destination : undefined;
+    const onClick = () => {
+        interactions?.onClick?.({ stopPropagation: () => undefined });
+        if (!destination) return;
+        if (navigation) navigation.navigate(destination);
+        else globalThis.dispatchEvent(new CustomEvent('cratis.scene.navigate', { detail: { destination, element } }));
+    };
 
     return (
         <ToolbarButton
@@ -26,6 +41,13 @@ export function SceneToolbarButton({ element }: RegisteredComponentProps) {
             title={stringProperty(element.properties, 'title') ?? text ?? ''}
             active={booleanProperty(element.properties, 'active')}
             tooltipPosition={unionProperty(element.properties, 'tooltipPosition', tooltipPositions)}
+            onClick={onClick}
         />
     );
 }
+
+function isDestination(value: unknown): value is DestinationReference {
+    if (value === null || typeof value !== 'object' || Array.isArray(value)) return false;
+    const candidate = value as Record<string, unknown>;
+    return ['screen', 'module', 'route', 'dialog'].some(key => typeof candidate[key] === 'string');
+}