@cratis/scene.model 4.7.0 → 4.9.0

package/common/BindingExpression.ts

@@ -1,12 +1,56 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
+import { BindingMode } from './BindingMode';
+import { BindingNullBehavior } from './BindingNullBehavior';
+import { BindingSourceKind } from './BindingSourceKind';
+import { PropertyValueType } from '../descriptors';
+
 /**
- * A reference to a value already resolved by whatever produced this model (Stage translating Screenplay,
- * or Studio's editor) — Scene never re-runs name resolution, it only carries the resolved path forward.
+ * A typed reference to a value resolved by the shared Scene runtime.
+ *
+ * Legacy authored content that only carries `path` is treated as a data-context binding. New content may
+ * name the source explicitly: the inherited data context, a query result, another component's output
+ * property, or a literal value. Invalid bindings are preserved and reported by validation; they are not
+ * rewritten by the resolver.
  */
 export interface BindingExpression {
+    /** Source kind; absent means `dataContext` for backward compatibility. */
+    kind?: BindingSourceKind;
+
+    /** The path inside the selected source. */
     path: string;
+
+    /** The named query binding when `kind` is `queryResult`. */
+    query?: string;
+
+    /** Stable component identity when `kind` is `componentProperty`. */
+    componentId?: string;
+
+    /** Property path on the source component when it differs from `path`. */
+    componentPropertyPath?: string;
+
+    /** Update mode requested by the author. */
+    mode?: BindingMode;
+
+    /** How null or undefined source values affect the target. */
+    nullBehavior?: BindingNullBehavior;
+
+    /** Optional expected target/source value type for validation. */
+    expectedValueType?: PropertyValueType;
+
+    /** Literal value when `kind` is `literal`. */
+    value?: unknown;
 }
 
-export const BindingExpressionPropertyNames: (keyof BindingExpression)[] = ['path'];
+export const BindingExpressionPropertyNames: (keyof BindingExpression)[] = [
+    'kind',
+    'path',
+    'query',
+    'componentId',
+    'componentPropertyPath',
+    'mode',
+    'nullBehavior',
+    'expectedValueType',
+    'value',
+];

package/common/BindingMode.ts

@@ -0,0 +1,13 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+/**
+ * How updates flow between a binding source and target.
+ */
+export enum BindingMode {
+    /** Source changes update the target; target changes are not written back. */
+    OneWay = 'oneWay',
+
+    /** Source and target changes flow both directions when both properties declare support. */
+    TwoWay = 'twoWay',
+}

package/common/BindingNullBehavior.ts

@@ -0,0 +1,16 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+/**
+ * What a binding target does when its source resolves to null or undefined.
+ */
+export enum BindingNullBehavior {
+    /** Propagate null to the target. */
+    Propagate = 'propagate',
+
+    /** Clear the target to its empty state. */
+    Clear = 'clear',
+
+    /** Leave the target's current value unchanged. */
+    Preserve = 'preserve',
+}

package/common/BindingSourceKind.ts

@@ -0,0 +1,19 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+/**
+ * The source a binding reads from.
+ */
+export enum BindingSourceKind {
+    /** The inherited effective data context for the element. */
+    DataContext = 'dataContext',
+
+    /** The latest result of a named query binding. */
+    QueryResult = 'queryResult',
+
+    /** An output property from another stable component identity. */
+    ComponentProperty = 'componentProperty',
+
+    /** A literal value carried by the binding. */
+    Literal = 'literal',
+}

package/common/DestinationKind.ts

@@ -0,0 +1,11 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+/**
+ * The navigational surface a destination opens.
+ */
+export enum DestinationKind {
+    Outlet = 'outlet',
+    Dialog = 'dialog',
+    External = 'external',
+}

package/common/DestinationReference.ts

@@ -3,16 +3,43 @@
 
 import { BindingExpression } from './BindingExpression';
 
+import { DestinationKind } from './DestinationKind';
+
 /**
- * Where activating something takes the user: a screen, named rather than addressed. Turning the name into a
- * URL, query string or native deep link is a renderer's job, the same as for a `NavigateAction`.
+ * Where activating something takes the user.
+ *
+ * Stable module/feature/slice identity is carried separately from labels and authored URLs. A renderer maps
+ * the destination to a URL, route state, native deep link, dialog or named outlet without guessing from text.
  */
 export interface DestinationReference {
-    /** The name of the screen to go to. */
-    screen: string;
+    /** The legacy or explicit screen name to go to. */
+    screen?: string;
+
+    /** Stable module identity. */
+    module?: string;
+
+    /** Stable feature identity inside the module. */
+    feature?: string;
+
+    /** Stable slice identity inside the feature. */
+    slice?: string;
+
+    /** The named outlet to replace; absent means the host's primary outlet. */
+    outlet?: string;
+
+    /** The authored URL/path override, when the default route should not be derived from identity. */
+    route?: string;
+
+    /** Whether this opens in an outlet, a dialog, or an external target. */
+    kind?: DestinationKind;
+
+    /** A dialog template or dialog identity when `kind` is `dialog`. */
+    dialog?: string;
 
-    /** The values for the screen's route parameters, keyed by parameter name. */
+    /** The values for route or screen parameters, keyed by parameter name. */
     routeParameterBindings?: Record<string, BindingExpression>;
 }
 
-export const DestinationReferencePropertyNames: (keyof DestinationReference)[] = ['screen', 'routeParameterBindings'];
+export const DestinationReferencePropertyNames: (keyof DestinationReference)[] = [
+    'screen', 'module', 'feature', 'slice', 'outlet', 'route', 'kind', 'dialog', 'routeParameterBindings',
+];

package/common/index.ts

@@ -8,8 +8,12 @@ export * from './HorizontalAlignment';
 export * from './VerticalAlignment';
 export * from './Visibility';
 export * from './BindingExpression';
+export * from './BindingSourceKind';
+export * from './BindingMode';
+export * from './BindingNullBehavior';
 export * from './Orientation';
 export * from './Dock';
 export * from './GridUnitType';
 export * from './GridLength';
 export * from './DestinationReference';
+export * from './DestinationKind';

package/contributionPoints/NavigationItem.ts

@@ -1,7 +1,7 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
-import { BindingExpression } from '../common';
+import { BindingExpression, DestinationReference } from '../common';
 
 /**
  * A contribution to the built-in `Navigation` contribution point. How `navigate to <Screen>` becomes a
@@ -9,13 +9,30 @@ import { BindingExpression } from '../common';
  * not this record — this only carries the declared shape.
  */
 export interface NavigationItem {
+    /** Stable identity for this contribution, independent of the label. */
+    id?: string;
+
     label: string;
+
+    /** Qualified icon reference (`library:name`) for toolbar/navigation chrome. */
+    icon?: string;
+
+    /** Whether chrome shows icon, text, or both. */
+    presentation?: string;
+
+    /** Legacy screen target; prefer `destination` for new content. */
     targetScreen: string;
+
+    /** Legacy parameter bindings; prefer `destination.routeParameterBindings` for new content. */
     routeParameterBindings: Record<string, BindingExpression>;
+
+    /** The typed destination this item activates. */
+    destination?: DestinationReference;
+
     order?: number;
     group?: string;
 }
 
 export const NavigationItemPropertyNames: (keyof NavigationItem)[] = [
-    'label', 'targetScreen', 'routeParameterBindings', 'order', 'group',
+    'id', 'label', 'icon', 'presentation', 'targetScreen', 'routeParameterBindings', 'destination', 'order', 'group',
 ];

package/descriptors/ComponentDescriptor.ts

@@ -1,6 +1,7 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
+import { DesignTimeActionDescriptor } from './DesignTimeActionDescriptor';
 import { PropertyDescriptor } from './PropertyDescriptor';
 
 /**
@@ -26,8 +27,17 @@ export interface ComponentDescriptor {
     editorKind?: string;
 
     properties: PropertyDescriptor[];
+
+    /** Package-provided design-time actions for this component. */
+    actions?: DesignTimeActionDescriptor[];
+
+    /** Names an optional package-provided preview renderer. */
+    previewKind?: string;
+
+    /** Names an optional package-provided property display renderer set. */
+    propertyDisplayKind?: string;
 }
 
 export const ComponentDescriptorPropertyNames: (keyof ComponentDescriptor)[] = [
-    'component', 'displayName', 'description', 'editorKind', 'properties',
+    'component', 'displayName', 'description', 'editorKind', 'properties', 'actions', 'previewKind', 'propertyDisplayKind',
 ];

package/descriptors/DesignTimeActionDescriptor.ts

@@ -0,0 +1,28 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { DesignTimeActionPlacement } from './DesignTimeActionPlacement';
+
+/**
+ * A package-provided design-time action that edits Scene model data through canonical edit batches.
+ */
+export interface DesignTimeActionDescriptor {
+    /** Stable package-owned action identity. */
+    id: string;
+
+    /** The label a designer shows. */
+    label: string;
+
+    /** Where a designer may show the action. */
+    placement?: DesignTimeActionPlacement;
+
+    /** Owner-controlled visible/enabled rule name interpreted by the package's design-time bundle. */
+    availability?: string;
+
+    /** Help text for the designer. */
+    description?: string;
+}
+
+export const DesignTimeActionDescriptorPropertyNames: (keyof DesignTimeActionDescriptor)[] = [
+    'id', 'label', 'placement', 'availability', 'description',
+];

package/descriptors/DesignTimeActionPlacement.ts

@@ -0,0 +1,11 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+/**
+ * Where a design-time action is presented.
+ */
+export enum DesignTimeActionPlacement {
+    Toolbar = 'toolbar',
+    ContextMenu = 'contextMenu',
+    Inspector = 'inspector',
+}

package/descriptors/PackageDesignTimeMetadata.ts

@@ -0,0 +1,26 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+/**
+ * Platform-neutral names of optional design-time extension points a package provides.
+ */
+export interface PackageDesignTimeMetadata {
+    /** Named component preview renderers available in the package's design-time bundle. */
+    previews: string[];
+
+    /** Named full-component designers available in the package's design-time bundle. */
+    designers: string[];
+
+    /** Named property editors available in the package's design-time bundle. */
+    propertyEditors: string[];
+
+    /** Named property display renderers available in the package's design-time bundle. */
+    propertyDisplays: string[];
+
+    /** Named design-time action handlers available in the package's design-time bundle. */
+    actions: string[];
+}
+
+export const PackageDesignTimeMetadataPropertyNames: (keyof PackageDesignTimeMetadata)[] = [
+    'previews', 'designers', 'propertyEditors', 'propertyDisplays', 'actions',
+];

package/descriptors/PropertyDescriptor.ts

@@ -1,6 +1,7 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
+import { BindingMode, BindingSourceKind } from '../common';
 import { CollectionItemDescriptor } from './CollectionItemDescriptor';
 import { PropertyChoice } from './PropertyChoice';
 import { PropertyConstraints } from './PropertyConstraints';
@@ -48,8 +49,18 @@ export interface PropertyDescriptor {
 
     /** The value is shown but never edited. */
     readOnly?: boolean;
+
+    /** This property is emitted by the component and may be bound by other elements. */
+    output?: boolean;
+
+    /** Which binding source kinds may be assigned to this property. */
+    acceptedBindingKinds?: BindingSourceKind[];
+
+    /** The strongest binding mode the property supports. */
+    bindingMode?: BindingMode;
 }
 
 export const PropertyDescriptorPropertyNames: (keyof PropertyDescriptor)[] = [
     'path', 'label', 'group', 'valueType', 'choices', 'default', 'constraints', 'editorKind', 'description', 'item', 'readOnly',
+    'output', 'acceptedBindingKinds', 'bindingMode',
 ];

package/descriptors/index.ts

@@ -5,6 +5,9 @@ export * from './PropertyValueType';
 export * from './PropertyChoice';
 export * from './PropertyConstraints';
 export * from './CollectionItemDescriptor';
+export * from './DesignTimeActionDescriptor';
+export * from './DesignTimeActionPlacement';
+export * from './PackageDesignTimeMetadata';
 export * from './PropertyDescriptor';
 export * from './ComponentDescriptor';
 export * from './CollectionOperation';

package/dist/cjs/common/BindingExpression.js

@@ -2,11 +2,16 @@
 
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
-/**
- * A reference to a value already resolved by whatever produced this model (Stage translating Screenplay,
- * or Studio's editor) — Scene never re-runs name resolution, it only carries the resolved path forward.
- */ const BindingExpressionPropertyNames = [
-    'path'
+const BindingExpressionPropertyNames = [
+    'kind',
+    'path',
+    'query',
+    'componentId',
+    'componentPropertyPath',
+    'mode',
+    'nullBehavior',
+    'expectedValueType',
+    'value'
 ];
 
 exports.BindingExpressionPropertyNames = BindingExpressionPropertyNames;

package/dist/cjs/common/BindingExpression.js.map

@@ -1 +1 @@
-{"version":3,"file":"BindingExpression.js","sources":["../../../common/BindingExpression.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\n/**\n * A reference to a value already resolved by whatever produced this model (Stage translating Screenplay,\n * or Studio's editor) — Scene never re-runs name resolution, it only carries the resolved path forward.\n */\nexport interface BindingExpression {\n    path: string;\n}\n\nexport const BindingExpressionPropertyNames: (keyof BindingExpression)[] = ['path'];\n"],"names":["BindingExpressionPropertyNames"],"mappings":";;AAAA;AACA;AAEA;;;UAQaA,8BAAAA,GAA8D;AAAC,IAAA;;;"}
+{"version":3,"file":"BindingExpression.js","sources":["../../../common/BindingExpression.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 { BindingMode } from './BindingMode';\nimport { BindingNullBehavior } from './BindingNullBehavior';\nimport { BindingSourceKind } from './BindingSourceKind';\nimport { PropertyValueType } from '../descriptors';\n\n/**\n * A typed reference to a value resolved by the shared Scene runtime.\n *\n * Legacy authored content that only carries `path` is treated as a data-context binding. New content may\n * name the source explicitly: the inherited data context, a query result, another component's output\n * property, or a literal value. Invalid bindings are preserved and reported by validation; they are not\n * rewritten by the resolver.\n */\nexport interface BindingExpression {\n    /** Source kind; absent means `dataContext` for backward compatibility. */\n    kind?: BindingSourceKind;\n\n    /** The path inside the selected source. */\n    path: string;\n\n    /** The named query binding when `kind` is `queryResult`. */\n    query?: string;\n\n    /** Stable component identity when `kind` is `componentProperty`. */\n    componentId?: string;\n\n    /** Property path on the source component when it differs from `path`. */\n    componentPropertyPath?: string;\n\n    /** Update mode requested by the author. */\n    mode?: BindingMode;\n\n    /** How null or undefined source values affect the target. */\n    nullBehavior?: BindingNullBehavior;\n\n    /** Optional expected target/source value type for validation. */\n    expectedValueType?: PropertyValueType;\n\n    /** Literal value when `kind` is `literal`. */\n    value?: unknown;\n}\n\nexport const BindingExpressionPropertyNames: (keyof BindingExpression)[] = [\n    'kind',\n    'path',\n    'query',\n    'componentId',\n    'componentPropertyPath',\n    'mode',\n    'nullBehavior',\n    'expectedValueType',\n    'value',\n];\n"],"names":["BindingExpressionPropertyNames"],"mappings":";;AAAA;AACA;MA4CaA,8BAAAA,GAA8D;AACvE,IAAA,MAAA;AACA,IAAA,MAAA;AACA,IAAA,OAAA;AACA,IAAA,aAAA;AACA,IAAA,uBAAA;AACA,IAAA,MAAA;AACA,IAAA,cAAA;AACA,IAAA,mBAAA;AACA,IAAA;;;"}

package/dist/cjs/common/BindingMode.js

@@ -0,0 +1,14 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * How updates flow between a binding source and target.
+ */ var BindingMode = /*#__PURE__*/ function(BindingMode) {
+    /** Source changes update the target; target changes are not written back. */ BindingMode["OneWay"] = "oneWay";
+    /** Source and target changes flow both directions when both properties declare support. */ BindingMode["TwoWay"] = "twoWay";
+    return BindingMode;
+}({});
+
+exports.BindingMode = BindingMode;
+//# sourceMappingURL=BindingMode.js.map

package/dist/cjs/common/BindingMode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BindingMode.js","sources":["../../../common/BindingMode.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\n/**\n * How updates flow between a binding source and target.\n */\nexport enum BindingMode {\n    /** Source changes update the target; target changes are not written back. */\n    OneWay = 'oneWay',\n\n    /** Source and target changes flow both directions when both properties declare support. */\n    TwoWay = 'twoWay',\n}\n"],"names":["BindingMode"],"mappings":";;AAAA;AACA;AAEA;;IAGO,IAAKA,WAAAA,iBAAAA,SAAAA,WAAAA,EAAAA;kFACmE,WAAA,CAAA,QAAA,CAAA,GAAA,QAAA;gGAGc,WAAA,CAAA,QAAA,CAAA,GAAA,QAAA;AAJjFA,IAAAA,OAAAA,WAAAA;AAMX,CAAA,CAAA,EAAA;;"}

package/dist/cjs/common/BindingNullBehavior.js

@@ -0,0 +1,15 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * What a binding target does when its source resolves to null or undefined.
+ */ var BindingNullBehavior = /*#__PURE__*/ function(BindingNullBehavior) {
+    /** Propagate null to the target. */ BindingNullBehavior["Propagate"] = "propagate";
+    /** Clear the target to its empty state. */ BindingNullBehavior["Clear"] = "clear";
+    /** Leave the target's current value unchanged. */ BindingNullBehavior["Preserve"] = "preserve";
+    return BindingNullBehavior;
+}({});
+
+exports.BindingNullBehavior = BindingNullBehavior;
+//# sourceMappingURL=BindingNullBehavior.js.map

package/dist/cjs/common/BindingNullBehavior.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BindingNullBehavior.js","sources":["../../../common/BindingNullBehavior.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\n/**\n * What a binding target does when its source resolves to null or undefined.\n */\nexport enum BindingNullBehavior {\n    /** Propagate null to the target. */\n    Propagate = 'propagate',\n\n    /** Clear the target to its empty state. */\n    Clear = 'clear',\n\n    /** Leave the target's current value unchanged. */\n    Preserve = 'preserve',\n}\n"],"names":["BindingNullBehavior"],"mappings":";;AAAA;AACA;AAEA;;IAGO,IAAKA,mBAAAA,iBAAAA,SAAAA,mBAAAA,EAAAA;yCAC0B,mBAAA,CAAA,WAAA,CAAA,GAAA,WAAA;gDAGO,mBAAA,CAAA,OAAA,CAAA,GAAA,OAAA;uDAGO,mBAAA,CAAA,UAAA,CAAA,GAAA,UAAA;AAPxCA,IAAAA,OAAAA,mBAAAA;AASX,CAAA,CAAA,EAAA;;"}

package/dist/cjs/common/BindingSourceKind.js

@@ -0,0 +1,16 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * The source a binding reads from.
+ */ var BindingSourceKind = /*#__PURE__*/ function(BindingSourceKind) {
+    /** The inherited effective data context for the element. */ BindingSourceKind["DataContext"] = "dataContext";
+    /** The latest result of a named query binding. */ BindingSourceKind["QueryResult"] = "queryResult";
+    /** An output property from another stable component identity. */ BindingSourceKind["ComponentProperty"] = "componentProperty";
+    /** A literal value carried by the binding. */ BindingSourceKind["Literal"] = "literal";
+    return BindingSourceKind;
+}({});
+
+exports.BindingSourceKind = BindingSourceKind;
+//# sourceMappingURL=BindingSourceKind.js.map

package/dist/cjs/common/BindingSourceKind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BindingSourceKind.js","sources":["../../../common/BindingSourceKind.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\n/**\n * The source a binding reads from.\n */\nexport enum BindingSourceKind {\n    /** The inherited effective data context for the element. */\n    DataContext = 'dataContext',\n\n    /** The latest result of a named query binding. */\n    QueryResult = 'queryResult',\n\n    /** An output property from another stable component identity. */\n    ComponentProperty = 'componentProperty',\n\n    /** A literal value carried by the binding. */\n    Literal = 'literal',\n}\n"],"names":["BindingSourceKind"],"mappings":";;AAAA;AACA;AAEA;;IAGO,IAAKA,iBAAAA,iBAAAA,SAAAA,iBAAAA,EAAAA;iEACkD,iBAAA,CAAA,aAAA,CAAA,GAAA,aAAA;uDAGV,iBAAA,CAAA,aAAA,CAAA,GAAA,aAAA;sEAGe,iBAAA,CAAA,mBAAA,CAAA,GAAA,mBAAA;mDAGnB,iBAAA,CAAA,SAAA,CAAA,GAAA,SAAA;AAVpCA,IAAAA,OAAAA,iBAAAA;AAYX,CAAA,CAAA,EAAA;;"}

package/dist/cjs/common/DestinationKind.js

@@ -0,0 +1,15 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * The navigational surface a destination opens.
+ */ var DestinationKind = /*#__PURE__*/ function(DestinationKind) {
+    DestinationKind["Outlet"] = "outlet";
+    DestinationKind["Dialog"] = "dialog";
+    DestinationKind["External"] = "external";
+    return DestinationKind;
+}({});
+
+exports.DestinationKind = DestinationKind;
+//# sourceMappingURL=DestinationKind.js.map

package/dist/cjs/common/DestinationKind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DestinationKind.js","sources":["../../../common/DestinationKind.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\n/**\n * The navigational surface a destination opens.\n */\nexport enum DestinationKind {\n    Outlet = 'outlet',\n    Dialog = 'dialog',\n    External = 'external',\n}\n"],"names":["DestinationKind"],"mappings":";;AAAA;AACA;AAEA;;IAGO,IAAKA,eAAAA,iBAAAA,SAAAA,eAAAA,EAAAA;;;;AAAAA,IAAAA,OAAAA,eAAAA;AAIX,CAAA,CAAA,EAAA;;"}

package/dist/cjs/common/DestinationReference.js

@@ -4,6 +4,13 @@
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 const DestinationReferencePropertyNames = [
     'screen',
+    'module',
+    'feature',
+    'slice',
+    'outlet',
+    'route',
+    'kind',
+    'dialog',
     'routeParameterBindings'
 ];
 

package/dist/cjs/common/DestinationReference.js.map

@@ -1 +1 @@
-{"version":3,"file":"DestinationReference.js","sources":["../../../common/DestinationReference.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 { BindingExpression } from './BindingExpression';\n\n/**\n * Where activating something takes the user: a screen, named rather than addressed. Turning the name into a\n * URL, query string or native deep link is a renderer's job, the same as for a `NavigateAction`.\n */\nexport interface DestinationReference {\n    /** The name of the screen to go to. */\n    screen: string;\n\n    /** The values for the screen's route parameters, keyed by parameter name. */\n    routeParameterBindings?: Record<string, BindingExpression>;\n}\n\nexport const DestinationReferencePropertyNames: (keyof DestinationReference)[] = ['screen', 'routeParameterBindings'];\n"],"names":["DestinationReferencePropertyNames"],"mappings":";;AAAA;AACA;MAgBaA,iCAAAA,GAAoE;AAAC,IAAA,QAAA;AAAU,IAAA;;;"}
+{"version":3,"file":"DestinationReference.js","sources":["../../../common/DestinationReference.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 { BindingExpression } from './BindingExpression';\n\nimport { DestinationKind } from './DestinationKind';\n\n/**\n * Where activating something takes the user.\n *\n * Stable module/feature/slice identity is carried separately from labels and authored URLs. A renderer maps\n * the destination to a URL, route state, native deep link, dialog or named outlet without guessing from text.\n */\nexport interface DestinationReference {\n    /** The legacy or explicit screen name to go to. */\n    screen?: string;\n\n    /** Stable module identity. */\n    module?: string;\n\n    /** Stable feature identity inside the module. */\n    feature?: string;\n\n    /** Stable slice identity inside the feature. */\n    slice?: string;\n\n    /** The named outlet to replace; absent means the host's primary outlet. */\n    outlet?: string;\n\n    /** The authored URL/path override, when the default route should not be derived from identity. */\n    route?: string;\n\n    /** Whether this opens in an outlet, a dialog, or an external target. */\n    kind?: DestinationKind;\n\n    /** A dialog template or dialog identity when `kind` is `dialog`. */\n    dialog?: string;\n\n    /** The values for route or screen parameters, keyed by parameter name. */\n    routeParameterBindings?: Record<string, BindingExpression>;\n}\n\nexport const DestinationReferencePropertyNames: (keyof DestinationReference)[] = [\n    'screen', 'module', 'feature', 'slice', 'outlet', 'route', 'kind', 'dialog', 'routeParameterBindings',\n];\n"],"names":["DestinationReferencePropertyNames"],"mappings":";;AAAA;AACA;MAyCaA,iCAAAA,GAAoE;AAC7E,IAAA,QAAA;AAAU,IAAA,QAAA;AAAU,IAAA,SAAA;AAAW,IAAA,OAAA;AAAS,IAAA,QAAA;AAAU,IAAA,OAAA;AAAS,IAAA,MAAA;AAAQ,IAAA,QAAA;AAAU,IAAA;;;"}

package/dist/cjs/contributionPoints/NavigationItem.js

@@ -3,9 +3,13 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 const NavigationItemPropertyNames = [
+    'id',
     'label',
+    'icon',
+    'presentation',
     'targetScreen',
     'routeParameterBindings',
+    'destination',
     'order',
     'group'
 ];

package/dist/cjs/contributionPoints/NavigationItem.js.map

@@ -1 +1 @@
-{"version":3,"file":"NavigationItem.js","sources":["../../../contributionPoints/NavigationItem.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 { BindingExpression } from '../common';\n\n/**\n * A contribution to the built-in `Navigation` contribution point. How `navigate to <Screen>` becomes a\n * concrete route (URL path, query string, or native deep link) is owned by the renderer's NavBar widget,\n * not this record — this only carries the declared shape.\n */\nexport interface NavigationItem {\n    label: string;\n    targetScreen: string;\n    routeParameterBindings: Record<string, BindingExpression>;\n    order?: number;\n    group?: string;\n}\n\nexport const NavigationItemPropertyNames: (keyof NavigationItem)[] = [\n    'label', 'targetScreen', 'routeParameterBindings', 'order', 'group',\n];\n"],"names":["NavigationItemPropertyNames"],"mappings":";;AAAA;AACA;MAiBaA,2BAAAA,GAAwD;AACjE,IAAA,OAAA;AAAS,IAAA,cAAA;AAAgB,IAAA,wBAAA;AAA0B,IAAA,OAAA;AAAS,IAAA;;;"}
+{"version":3,"file":"NavigationItem.js","sources":["../../../contributionPoints/NavigationItem.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 { BindingExpression, DestinationReference } from '../common';\n\n/**\n * A contribution to the built-in `Navigation` contribution point. How `navigate to <Screen>` becomes a\n * concrete route (URL path, query string, or native deep link) is owned by the renderer's NavBar widget,\n * not this record — this only carries the declared shape.\n */\nexport interface NavigationItem {\n    /** Stable identity for this contribution, independent of the label. */\n    id?: string;\n\n    label: string;\n\n    /** Qualified icon reference (`library:name`) for toolbar/navigation chrome. */\n    icon?: string;\n\n    /** Whether chrome shows icon, text, or both. */\n    presentation?: string;\n\n    /** Legacy screen target; prefer `destination` for new content. */\n    targetScreen: string;\n\n    /** Legacy parameter bindings; prefer `destination.routeParameterBindings` for new content. */\n    routeParameterBindings: Record<string, BindingExpression>;\n\n    /** The typed destination this item activates. */\n    destination?: DestinationReference;\n\n    order?: number;\n    group?: string;\n}\n\nexport const NavigationItemPropertyNames: (keyof NavigationItem)[] = [\n    'id', 'label', 'icon', 'presentation', 'targetScreen', 'routeParameterBindings', 'destination', 'order', 'group',\n];\n"],"names":["NavigationItemPropertyNames"],"mappings":";;AAAA;AACA;MAkCaA,2BAAAA,GAAwD;AACjE,IAAA,IAAA;AAAM,IAAA,OAAA;AAAS,IAAA,MAAA;AAAQ,IAAA,cAAA;AAAgB,IAAA,cAAA;AAAgB,IAAA,wBAAA;AAA0B,IAAA,aAAA;AAAe,IAAA,OAAA;AAAS,IAAA;;;"}

package/dist/cjs/descriptors/ComponentDescriptor.js

@@ -7,7 +7,10 @@ const ComponentDescriptorPropertyNames = [
     'displayName',
     'description',
     'editorKind',
-    'properties'
+    'properties',
+    'actions',
+    'previewKind',
+    'propertyDisplayKind'
 ];
 
 exports.ComponentDescriptorPropertyNames = ComponentDescriptorPropertyNames;

package/dist/cjs/descriptors/ComponentDescriptor.js.map

@@ -1 +1 @@
-{"version":3,"file":"ComponentDescriptor.js","sources":["../../../descriptors/ComponentDescriptor.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 { PropertyDescriptor } from './PropertyDescriptor';\n\n/**\n * What can be edited on one component a package provides.\n *\n * Packages contribute these alongside the components themselves (a bundle's `descriptors`), through the same\n * package mechanism that already carries components, layouts and themes - there is no second registry to keep in\n * step.\n */\nexport interface ComponentDescriptor {\n    /**\n     * The component this describes, as the package names it: `<package>:<bare name>`, the same key a bundle\n     * registers the component under (for example `Cratis.Components:dataTable`).\n     */\n    component: string;\n\n    /** A human-readable name for a palette or an inspector title. */\n    displayName?: string;\n\n    description?: string;\n\n    /** Names a specialised editor for the component as a whole, when its properties are not edited one by one. */\n    editorKind?: string;\n\n    properties: PropertyDescriptor[];\n}\n\nexport const ComponentDescriptorPropertyNames: (keyof ComponentDescriptor)[] = [\n    'component', 'displayName', 'description', 'editorKind', 'properties',\n];\n"],"names":["ComponentDescriptorPropertyNames"],"mappings":";;AAAA;AACA;MA6BaA,gCAAAA,GAAkE;AAC3E,IAAA,WAAA;AAAa,IAAA,aAAA;AAAe,IAAA,aAAA;AAAe,IAAA,YAAA;AAAc,IAAA;;;"}
+{"version":3,"file":"ComponentDescriptor.js","sources":["../../../descriptors/ComponentDescriptor.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 { DesignTimeActionDescriptor } from './DesignTimeActionDescriptor';\nimport { PropertyDescriptor } from './PropertyDescriptor';\n\n/**\n * What can be edited on one component a package provides.\n *\n * Packages contribute these alongside the components themselves (a bundle's `descriptors`), through the same\n * package mechanism that already carries components, layouts and themes - there is no second registry to keep in\n * step.\n */\nexport interface ComponentDescriptor {\n    /**\n     * The component this describes, as the package names it: `<package>:<bare name>`, the same key a bundle\n     * registers the component under (for example `Cratis.Components:dataTable`).\n     */\n    component: string;\n\n    /** A human-readable name for a palette or an inspector title. */\n    displayName?: string;\n\n    description?: string;\n\n    /** Names a specialised editor for the component as a whole, when its properties are not edited one by one. */\n    editorKind?: string;\n\n    properties: PropertyDescriptor[];\n\n    /** Package-provided design-time actions for this component. */\n    actions?: DesignTimeActionDescriptor[];\n\n    /** Names an optional package-provided preview renderer. */\n    previewKind?: string;\n\n    /** Names an optional package-provided property display renderer set. */\n    propertyDisplayKind?: string;\n}\n\nexport const ComponentDescriptorPropertyNames: (keyof ComponentDescriptor)[] = [\n    'component', 'displayName', 'description', 'editorKind', 'properties', 'actions', 'previewKind', 'propertyDisplayKind',\n];\n"],"names":["ComponentDescriptorPropertyNames"],"mappings":";;AAAA;AACA;MAuCaA,gCAAAA,GAAkE;AAC3E,IAAA,WAAA;AAAa,IAAA,aAAA;AAAe,IAAA,aAAA;AAAe,IAAA,YAAA;AAAc,IAAA,YAAA;AAAc,IAAA,SAAA;AAAW,IAAA,aAAA;AAAe,IAAA;;;"}

package/dist/cjs/descriptors/DesignTimeActionDescriptor.js

@@ -0,0 +1,14 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+const DesignTimeActionDescriptorPropertyNames = [
+    'id',
+    'label',
+    'placement',
+    'availability',
+    'description'
+];
+
+exports.DesignTimeActionDescriptorPropertyNames = DesignTimeActionDescriptorPropertyNames;
+//# sourceMappingURL=DesignTimeActionDescriptor.js.map

package/dist/cjs/descriptors/DesignTimeActionDescriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DesignTimeActionDescriptor.js","sources":["../../../descriptors/DesignTimeActionDescriptor.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 { DesignTimeActionPlacement } from './DesignTimeActionPlacement';\n\n/**\n * A package-provided design-time action that edits Scene model data through canonical edit batches.\n */\nexport interface DesignTimeActionDescriptor {\n    /** Stable package-owned action identity. */\n    id: string;\n\n    /** The label a designer shows. */\n    label: string;\n\n    /** Where a designer may show the action. */\n    placement?: DesignTimeActionPlacement;\n\n    /** Owner-controlled visible/enabled rule name interpreted by the package's design-time bundle. */\n    availability?: string;\n\n    /** Help text for the designer. */\n    description?: string;\n}\n\nexport const DesignTimeActionDescriptorPropertyNames: (keyof DesignTimeActionDescriptor)[] = [\n    'id', 'label', 'placement', 'availability', 'description',\n];\n"],"names":["DesignTimeActionDescriptorPropertyNames"],"mappings":";;AAAA;AACA;MAwBaA,uCAAAA,GAAgF;AACzF,IAAA,IAAA;AAAM,IAAA,OAAA;AAAS,IAAA,WAAA;AAAa,IAAA,cAAA;AAAgB,IAAA;;;"}

package/dist/cjs/descriptors/DesignTimeActionPlacement.js

@@ -0,0 +1,15 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Where a design-time action is presented.
+ */ var DesignTimeActionPlacement = /*#__PURE__*/ function(DesignTimeActionPlacement) {
+    DesignTimeActionPlacement["Toolbar"] = "toolbar";
+    DesignTimeActionPlacement["ContextMenu"] = "contextMenu";
+    DesignTimeActionPlacement["Inspector"] = "inspector";
+    return DesignTimeActionPlacement;
+}({});
+
+exports.DesignTimeActionPlacement = DesignTimeActionPlacement;
+//# sourceMappingURL=DesignTimeActionPlacement.js.map

package/dist/cjs/descriptors/DesignTimeActionPlacement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DesignTimeActionPlacement.js","sources":["../../../descriptors/DesignTimeActionPlacement.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\n/**\n * Where a design-time action is presented.\n */\nexport enum DesignTimeActionPlacement {\n    Toolbar = 'toolbar',\n    ContextMenu = 'contextMenu',\n    Inspector = 'inspector',\n}\n"],"names":["DesignTimeActionPlacement"],"mappings":";;AAAA;AACA;AAEA;;IAGO,IAAKA,yBAAAA,iBAAAA,SAAAA,yBAAAA,EAAAA;;;;AAAAA,IAAAA,OAAAA,yBAAAA;AAIX,CAAA,CAAA,EAAA;;"}

package/dist/cjs/descriptors/PackageDesignTimeMetadata.js

@@ -0,0 +1,16 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Platform-neutral names of optional design-time extension points a package provides.
+ */ const PackageDesignTimeMetadataPropertyNames = [
+    'previews',
+    'designers',
+    'propertyEditors',
+    'propertyDisplays',
+    'actions'
+];
+
+exports.PackageDesignTimeMetadataPropertyNames = PackageDesignTimeMetadataPropertyNames;
+//# sourceMappingURL=PackageDesignTimeMetadata.js.map