@cratis/scene.react 4.23.0 → 4.25.0

package/core/coreComponentMetadata.ts

@@ -0,0 +1,27 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { ComponentCategory } from '@cratis/scene.model';
+import { ComponentMetadata, componentMetadata as m, navigationDesignMode, toolbarDesignMode } from '../packages';
+
+/** The category, icon, keywords and picker badge of every component of the package (CMP1), keyed by bare component name. */
+export const coreComponentMetadata: Record<string, ComponentMetadata> = {
+    text: m('Text', ComponentCategory.DataDisplay, 'type', ['label', 'paragraph', 'copy']),
+    button: m('Button', ComponentCategory.Actions, 'mouse-pointer-click', ['click', 'submit', 'action'], 'Bt'),
+    card: m('Card', ComponentCategory.Layout, 'square', ['panel', 'box', 'container']),
+    data: m('Data', ComponentCategory.DataDisplay, 'database', ['read model', 'query', 'source']),
+    action: m('Command action', ComponentCategory.Actions, 'zap', ['command', 'invoke', 'submit']),
+    section: m('Section', ComponentCategory.Layout, 'layout-panel-top', ['group', 'area', 'block']),
+    navigate: m('Navigate', ComponentCategory.Navigation, 'corner-down-right', ['link', 'go to', 'route']),
+    title: m('Title', ComponentCategory.DataDisplay, 'heading', ['heading', 'header', 'caption']),
+    table: m('Table', ComponentCategory.DataDisplay, 'table', ['grid', 'rows', 'list'], 'Tb'),
+    column: m('Table column', ComponentCategory.DataDisplay, 'columns-3', ['heading', 'field']),
+    summary: m('Summary', ComponentCategory.DataDisplay, 'list', ['details', 'overview', 'facts']),
+    field: m('Summary field', ComponentCategory.DataDisplay, 'tag', ['label', 'value', 'pair']),
+    code: m('Code', ComponentCategory.DataDisplay, 'code', ['snippet', 'source', 'monospace']),
+    file: m('File reference', ComponentCategory.DataDisplay, 'file', ['include', 'import', 'screen file']),
+    navigationBar: m('Navigation bar', ComponentCategory.Navigation, 'navigation', ['menu', 'nav', 'links'], undefined, navigationDesignMode({ itemsPath: 'items' })),
+    outlet: m('Outlet', ComponentCategory.Layout, 'panel-right', ['region', 'slot', 'side panel']),
+    toolbar: m('Toolbar', ComponentCategory.Actions, 'wrench', ['actions', 'buttons', 'command bar'], 'Tl', toolbarDesignMode()),
+    toolbarItem: m('Toolbar item', ComponentCategory.Actions, 'mouse-pointer-click', ['button', 'action']),
+};

package/core/coreDescriptors.ts

@@ -2,7 +2,8 @@
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
 import { ComponentDescriptor, PropertyValueType } from '@cratis/scene.model';
-import { componentRegistryKey } from '../packages';
+import { componentRegistryKey, describeComponents } from '../packages';
+import { coreComponentMetadata } from './coreComponentMetadata';
 
 const key = (name: string) => componentRegistryKey('core', name);
 
@@ -13,7 +14,7 @@ const key = (name: string) => componentRegistryKey('core', name);
  * argument mapping, a column's heading, and the navigation bar. The Screenplay structural components - `data`,
  * `section`, `summary` - have nothing to edit that is not already a node in the tree.
  */
-export const coreDescriptors: ComponentDescriptor[] = [
+const describedCore: ComponentDescriptor[] = [
     {
         component: key('button'),
         displayName: 'Button',
@@ -79,3 +80,6 @@ export const coreDescriptors: ComponentDescriptor[] = [
         ],
     },
 ];
+
+/** The `core` package's descriptors: the hand-written ones above with every component's category, icon, keywords and design mode (CMP1). */
+export const coreDescriptors: ComponentDescriptor[] = describeComponents('core', describedCore, coreComponentMetadata);

package/dist/cjs/core/coreComponentMetadata.js

@@ -0,0 +1,109 @@
+'use strict';
+
+var scene_model = require('@cratis/scene.model');
+require('react/jsx-runtime');
+require('react');
+require('@cratis/scene.engine');
+require('../interactions/useInteractions.js');
+require('../interactions/NotificationHost.js');
+require('../packages/runDesignTimeAction.js');
+var describeComponents = require('../packages/describeComponents.js');
+var designModes = require('../packages/designModes.js');
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/** The category, icon, keywords and picker badge of every component of the package (CMP1), keyed by bare component name. */ const coreComponentMetadata = {
+    text: describeComponents.componentMetadata('Text', scene_model.ComponentCategory.DataDisplay, 'type', [
+        'label',
+        'paragraph',
+        'copy'
+    ]),
+    button: describeComponents.componentMetadata('Button', scene_model.ComponentCategory.Actions, 'mouse-pointer-click', [
+        'click',
+        'submit',
+        'action'
+    ], 'Bt'),
+    card: describeComponents.componentMetadata('Card', scene_model.ComponentCategory.Layout, 'square', [
+        'panel',
+        'box',
+        'container'
+    ]),
+    data: describeComponents.componentMetadata('Data', scene_model.ComponentCategory.DataDisplay, 'database', [
+        'read model',
+        'query',
+        'source'
+    ]),
+    action: describeComponents.componentMetadata('Command action', scene_model.ComponentCategory.Actions, 'zap', [
+        'command',
+        'invoke',
+        'submit'
+    ]),
+    section: describeComponents.componentMetadata('Section', scene_model.ComponentCategory.Layout, 'layout-panel-top', [
+        'group',
+        'area',
+        'block'
+    ]),
+    navigate: describeComponents.componentMetadata('Navigate', scene_model.ComponentCategory.Navigation, 'corner-down-right', [
+        'link',
+        'go to',
+        'route'
+    ]),
+    title: describeComponents.componentMetadata('Title', scene_model.ComponentCategory.DataDisplay, 'heading', [
+        'heading',
+        'header',
+        'caption'
+    ]),
+    table: describeComponents.componentMetadata('Table', scene_model.ComponentCategory.DataDisplay, 'table', [
+        'grid',
+        'rows',
+        'list'
+    ], 'Tb'),
+    column: describeComponents.componentMetadata('Table column', scene_model.ComponentCategory.DataDisplay, 'columns-3', [
+        'heading',
+        'field'
+    ]),
+    summary: describeComponents.componentMetadata('Summary', scene_model.ComponentCategory.DataDisplay, 'list', [
+        'details',
+        'overview',
+        'facts'
+    ]),
+    field: describeComponents.componentMetadata('Summary field', scene_model.ComponentCategory.DataDisplay, 'tag', [
+        'label',
+        'value',
+        'pair'
+    ]),
+    code: describeComponents.componentMetadata('Code', scene_model.ComponentCategory.DataDisplay, 'code', [
+        'snippet',
+        'source',
+        'monospace'
+    ]),
+    file: describeComponents.componentMetadata('File reference', scene_model.ComponentCategory.DataDisplay, 'file', [
+        'include',
+        'import',
+        'screen file'
+    ]),
+    navigationBar: describeComponents.componentMetadata('Navigation bar', scene_model.ComponentCategory.Navigation, 'navigation', [
+        'menu',
+        'nav',
+        'links'
+    ], undefined, designModes.navigationDesignMode({
+        itemsPath: 'items'
+    })),
+    outlet: describeComponents.componentMetadata('Outlet', scene_model.ComponentCategory.Layout, 'panel-right', [
+        'region',
+        'slot',
+        'side panel'
+    ]),
+    toolbar: describeComponents.componentMetadata('Toolbar', scene_model.ComponentCategory.Actions, 'wrench', [
+        'actions',
+        'buttons',
+        'command bar'
+    ], 'Tl', designModes.toolbarDesignMode()),
+    toolbarItem: describeComponents.componentMetadata('Toolbar item', scene_model.ComponentCategory.Actions, 'mouse-pointer-click', [
+        'button',
+        'action'
+    ])
+};
+
+exports.coreComponentMetadata = coreComponentMetadata;
+//# sourceMappingURL=coreComponentMetadata.js.map

package/dist/cjs/core/coreComponentMetadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coreComponentMetadata.js","sources":["../../../core/coreComponentMetadata.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 { ComponentCategory } from '@cratis/scene.model';\nimport { ComponentMetadata, componentMetadata as m, navigationDesignMode, toolbarDesignMode } from '../packages';\n\n/** The category, icon, keywords and picker badge of every component of the package (CMP1), keyed by bare component name. */\nexport const coreComponentMetadata: Record<string, ComponentMetadata> = {\n    text: m('Text', ComponentCategory.DataDisplay, 'type', ['label', 'paragraph', 'copy']),\n    button: m('Button', ComponentCategory.Actions, 'mouse-pointer-click', ['click', 'submit', 'action'], 'Bt'),\n    card: m('Card', ComponentCategory.Layout, 'square', ['panel', 'box', 'container']),\n    data: m('Data', ComponentCategory.DataDisplay, 'database', ['read model', 'query', 'source']),\n    action: m('Command action', ComponentCategory.Actions, 'zap', ['command', 'invoke', 'submit']),\n    section: m('Section', ComponentCategory.Layout, 'layout-panel-top', ['group', 'area', 'block']),\n    navigate: m('Navigate', ComponentCategory.Navigation, 'corner-down-right', ['link', 'go to', 'route']),\n    title: m('Title', ComponentCategory.DataDisplay, 'heading', ['heading', 'header', 'caption']),\n    table: m('Table', ComponentCategory.DataDisplay, 'table', ['grid', 'rows', 'list'], 'Tb'),\n    column: m('Table column', ComponentCategory.DataDisplay, 'columns-3', ['heading', 'field']),\n    summary: m('Summary', ComponentCategory.DataDisplay, 'list', ['details', 'overview', 'facts']),\n    field: m('Summary field', ComponentCategory.DataDisplay, 'tag', ['label', 'value', 'pair']),\n    code: m('Code', ComponentCategory.DataDisplay, 'code', ['snippet', 'source', 'monospace']),\n    file: m('File reference', ComponentCategory.DataDisplay, 'file', ['include', 'import', 'screen file']),\n    navigationBar: m('Navigation bar', ComponentCategory.Navigation, 'navigation', ['menu', 'nav', 'links'], undefined, navigationDesignMode({ itemsPath: 'items' })),\n    outlet: m('Outlet', ComponentCategory.Layout, 'panel-right', ['region', 'slot', 'side panel']),\n    toolbar: m('Toolbar', ComponentCategory.Actions, 'wrench', ['actions', 'buttons', 'command bar'], 'Tl', toolbarDesignMode()),\n    toolbarItem: m('Toolbar item', ComponentCategory.Actions, 'mouse-pointer-click', ['button', 'action']),\n};\n"],"names":["coreComponentMetadata","text","m","ComponentCategory","DataDisplay","button","Actions","card","Layout","data","action","section","navigate","Navigation","title","table","column","summary","field","code","file","navigationBar","undefined","navigationDesignMode","itemsPath","outlet","toolbar","toolbarDesignMode","toolbarItem"],"mappings":"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"}

package/dist/cjs/core/coreDescriptors.js

@@ -8,6 +8,8 @@ require('../interactions/useInteractions.js');
 require('../interactions/NotificationHost.js');
 var ScenePackageBundle = require('../packages/ScenePackageBundle.js');
 require('../packages/runDesignTimeAction.js');
+var describeComponents = require('../packages/describeComponents.js');
+var coreComponentMetadata = require('./coreComponentMetadata.js');
 
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
@@ -18,7 +20,7 @@ const key = (name)=>ScenePackageBundle.componentRegistryKey('core', name);
  * Only the components an author configures by hand are described: a button's label, an action's command and its
  * argument mapping, a column's heading, and the navigation bar. The Screenplay structural components - `data`,
  * `section`, `summary` - have nothing to edit that is not already a node in the tree.
- */ const coreDescriptors = [
+ */ const describedCore = [
     {
         component: key('button'),
         displayName: 'Button',
@@ -179,6 +181,7 @@ const key = (name)=>ScenePackageBundle.componentRegistryKey('core', name);
         ]
     }
 ];
+/** The `core` package's descriptors: the hand-written ones above with every component's category, icon, keywords and design mode (CMP1). */ const coreDescriptors = describeComponents.describeComponents('core', describedCore, coreComponentMetadata.coreComponentMetadata);
 
 exports.coreDescriptors = coreDescriptors;
 //# sourceMappingURL=coreDescriptors.js.map

package/dist/cjs/core/coreDescriptors.js.map

@@ -1 +1 @@
-{"version":3,"file":"coreDescriptors.js","sources":["../../../core/coreDescriptors.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 { ComponentDescriptor, PropertyValueType } from '@cratis/scene.model';\nimport { componentRegistryKey } from '../packages';\n\nconst key = (name: string) => componentRegistryKey('core', name);\n\n/**\n * What can be edited on the `core` package's components.\n *\n * Only the components an author configures by hand are described: a button's label, an action's command and its\n * argument mapping, a column's heading, and the navigation bar. The Screenplay structural components - `data`,\n * `section`, `summary` - have nothing to edit that is not already a node in the tree.\n */\nexport const coreDescriptors: ComponentDescriptor[] = [\n    {\n        component: key('button'),\n        displayName: 'Button',\n        properties: [\n            { path: 'label', label: 'Label', group: 'Content', valueType: PropertyValueType.String, default: '' },\n        ],\n    },\n    {\n        component: key('action'),\n        displayName: 'Command action',\n        description: 'Invokes a modeled command. The command and its argument mapping are stored on the element; the host that handles the command event reads them.',\n        properties: [\n            { path: 'label', label: 'Label', group: 'Content', valueType: PropertyValueType.String },\n            {\n                path: 'command', label: 'Command', group: 'Behavior', valueType: PropertyValueType.String,\n                editorKind: 'stateChangeReference', constraints: { required: true },\n                description: 'The state change this action submits.',\n            },\n            {\n                path: 'arguments', label: 'Argument mapping', group: 'Behavior', valueType: PropertyValueType.Collection,\n                description: 'Where each command argument comes from.',\n                item: {\n                    label: 'Argument',\n                    properties: [\n                        { path: 'name', label: 'Argument', group: 'Behavior', valueType: PropertyValueType.String, constraints: { required: true } },\n                        { path: 'source', label: 'Source', group: 'Behavior', valueType: PropertyValueType.String, editorKind: 'bindingPath', constraints: { required: true } },\n                    ],\n                },\n            },\n        ],\n    },\n    {\n        component: key('column'),\n        displayName: 'Table column',\n        properties: [\n            { path: 'property', label: 'Result field', group: 'Data', valueType: PropertyValueType.String, editorKind: 'resultField', constraints: { required: true } },\n            { path: 'label', label: 'Heading', group: 'Content', valueType: PropertyValueType.String },\n        ],\n    },\n    {\n        component: key('outlet'),\n        displayName: 'Outlet',\n        description: 'A named region another screen opens into. Placing a screen here keeps this screen on the page, and the placed screen may declare outlets of its own.',\n        properties: [{ path: 'name', label: 'Name', group: 'Navigation', valueType: PropertyValueType.String, constraints: { required: true } }],\n    },\n    {\n        component: key('navigationBar'),\n        displayName: 'Navigation bar',\n        description: 'A list of navigation items. A template author fixes the first item (Home) and can expose the list so that screens add their own.',\n        properties: [\n            { path: 'title', label: 'Title', group: 'Content', valueType: PropertyValueType.String, default: 'Navigation' },\n            {\n                path: 'items', label: 'Items', group: 'Content', valueType: PropertyValueType.Collection, default: [],\n                item: {\n                    label: 'Navigation item',\n                    properties: [\n                        { path: 'label', label: 'Label', group: 'Content', valueType: PropertyValueType.String, constraints: { required: true, minimumLength: 1 } },\n                        { path: 'icon', label: 'Icon', group: 'Content', valueType: PropertyValueType.Icon, editorKind: 'iconPicker' },\n                        { path: 'destination', label: 'Destination', group: 'Content', valueType: PropertyValueType.Destination, editorKind: 'screenPicker', constraints: { required: true } },\n                    ],\n                },\n            },\n        ],\n    },\n];\n"],"names":["key","name","componentRegistryKey","coreDescriptors","component","displayName","properties","path","label","group","valueType","PropertyValueType","String","default","description","editorKind","constraints","required","Collection","item","minimumLength","Icon","Destination"],"mappings":"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"}
+{"version":3,"file":"coreDescriptors.js","sources":["../../../core/coreDescriptors.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 { ComponentDescriptor, PropertyValueType } from '@cratis/scene.model';\nimport { componentRegistryKey, describeComponents } from '../packages';\nimport { coreComponentMetadata } from './coreComponentMetadata';\n\nconst key = (name: string) => componentRegistryKey('core', name);\n\n/**\n * What can be edited on the `core` package's components.\n *\n * Only the components an author configures by hand are described: a button's label, an action's command and its\n * argument mapping, a column's heading, and the navigation bar. The Screenplay structural components - `data`,\n * `section`, `summary` - have nothing to edit that is not already a node in the tree.\n */\nconst describedCore: ComponentDescriptor[] = [\n    {\n        component: key('button'),\n        displayName: 'Button',\n        properties: [\n            { path: 'label', label: 'Label', group: 'Content', valueType: PropertyValueType.String, default: '' },\n        ],\n    },\n    {\n        component: key('action'),\n        displayName: 'Command action',\n        description: 'Invokes a modeled command. The command and its argument mapping are stored on the element; the host that handles the command event reads them.',\n        properties: [\n            { path: 'label', label: 'Label', group: 'Content', valueType: PropertyValueType.String },\n            {\n                path: 'command', label: 'Command', group: 'Behavior', valueType: PropertyValueType.String,\n                editorKind: 'stateChangeReference', constraints: { required: true },\n                description: 'The state change this action submits.',\n            },\n            {\n                path: 'arguments', label: 'Argument mapping', group: 'Behavior', valueType: PropertyValueType.Collection,\n                description: 'Where each command argument comes from.',\n                item: {\n                    label: 'Argument',\n                    properties: [\n                        { path: 'name', label: 'Argument', group: 'Behavior', valueType: PropertyValueType.String, constraints: { required: true } },\n                        { path: 'source', label: 'Source', group: 'Behavior', valueType: PropertyValueType.String, editorKind: 'bindingPath', constraints: { required: true } },\n                    ],\n                },\n            },\n        ],\n    },\n    {\n        component: key('column'),\n        displayName: 'Table column',\n        properties: [\n            { path: 'property', label: 'Result field', group: 'Data', valueType: PropertyValueType.String, editorKind: 'resultField', constraints: { required: true } },\n            { path: 'label', label: 'Heading', group: 'Content', valueType: PropertyValueType.String },\n        ],\n    },\n    {\n        component: key('outlet'),\n        displayName: 'Outlet',\n        description: 'A named region another screen opens into. Placing a screen here keeps this screen on the page, and the placed screen may declare outlets of its own.',\n        properties: [{ path: 'name', label: 'Name', group: 'Navigation', valueType: PropertyValueType.String, constraints: { required: true } }],\n    },\n    {\n        component: key('navigationBar'),\n        displayName: 'Navigation bar',\n        description: 'A list of navigation items. A template author fixes the first item (Home) and can expose the list so that screens add their own.',\n        properties: [\n            { path: 'title', label: 'Title', group: 'Content', valueType: PropertyValueType.String, default: 'Navigation' },\n            {\n                path: 'items', label: 'Items', group: 'Content', valueType: PropertyValueType.Collection, default: [],\n                item: {\n                    label: 'Navigation item',\n                    properties: [\n                        { path: 'label', label: 'Label', group: 'Content', valueType: PropertyValueType.String, constraints: { required: true, minimumLength: 1 } },\n                        { path: 'icon', label: 'Icon', group: 'Content', valueType: PropertyValueType.Icon, editorKind: 'iconPicker' },\n                        { path: 'destination', label: 'Destination', group: 'Content', valueType: PropertyValueType.Destination, editorKind: 'screenPicker', constraints: { required: true } },\n                    ],\n                },\n            },\n        ],\n    },\n];\n\n/** The `core` package's descriptors: the hand-written ones above with every component's category, icon, keywords and design mode (CMP1). */\nexport const coreDescriptors: ComponentDescriptor[] = describeComponents('core', describedCore, coreComponentMetadata);"],"names":["key","name","componentRegistryKey","describedCore","component","displayName","properties","path","label","group","valueType","PropertyValueType","String","default","description","editorKind","constraints","required","Collection","item","minimumLength","Icon","Destination","coreDescriptors","describeComponents","coreComponentMetadata"],"mappings":"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"}

package/dist/cjs/index.js

@@ -56,6 +56,9 @@ var PackageHostView = require('./packages/PackageHostView.js');
 var resolveDesignTimeHost = require('./packages/resolveDesignTimeHost.js');
 var runDesignTimeAction = require('./packages/runDesignTimeAction.js');
 var ScenePackageBundle = require('./packages/ScenePackageBundle.js');
+var describeComponents = require('./packages/describeComponents.js');
+var designModes = require('./packages/designModes.js');
+var validateComponentMetadata = require('./packages/validateComponentMetadata.js');
 var StandalonePackageHost = require('./packages/StandalonePackageHost.js');
 var WebViewPackageHost = require('./packages/WebViewPackageHost.js');
 var ComponentsUiLibraryContract = require('./packages/ComponentsUiLibraryContract.js');
@@ -158,6 +161,13 @@ exports.componentRegistryKey = ScenePackageBundle.componentRegistryKey;
 exports.mergeIconAdapters = ScenePackageBundle.mergeIconAdapters;
 exports.mergePackageRegistries = ScenePackageBundle.mergePackageRegistries;
 exports.validatePackageBundle = ScenePackageBundle.validatePackageBundle;
+exports.componentMetadata = describeComponents.componentMetadata;
+exports.describeComponents = describeComponents.describeComponents;
+exports.itemEditableRule = designModes.itemEditableRule;
+exports.itemInheritedReason = designModes.itemInheritedReason;
+exports.navigationDesignMode = designModes.navigationDesignMode;
+exports.toolbarDesignMode = designModes.toolbarDesignMode;
+exports.validateComponentMetadata = validateComponentMetadata.validateComponentMetadata;
 exports.StandalonePackageHost = StandalonePackageHost.StandalonePackageHost;
 exports.WebViewPackageHost = WebViewPackageHost.WebViewPackageHost;
 exports.validateComponentsUiLibraryContract = ComponentsUiLibraryContract.validateComponentsUiLibraryContract;

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/cjs/packages/ScenePackageBundle.js

@@ -1,5 +1,6 @@
 'use strict';
 
+var scene_engine = require('@cratis/scene.engine');
 var scene_model = require('@cratis/scene.model');
 var IconAdapterRegistry = require('../icons/IconAdapterRegistry.js');
 var ComponentsUiLibraryContract = require('./ComponentsUiLibraryContract.js');
@@ -141,6 +142,13 @@ function validateDescriptors(bundle) {
         described.add(descriptor.component);
         validateProperties(descriptor.component, descriptor.properties, '', problems);
     }
+    // The category rule (CMP1) is not checked here - it gates a designer, not a host loading a package (see validateComponentMetadata) -
+    // but a design-mode descriptor or editor parameter that cannot work is as much a mistake as an enum without choices.
+    const structural = [
+        scene_model.DiagnosticCode.ComponentDesignModeInvalid,
+        scene_model.DiagnosticCode.PropertyEditorOptionsInvalid
+    ];
+    problems.push(...scene_engine.validateComponentDescriptors(bundle.descriptors ?? []).filter((diagnostic)=>structural.includes(diagnostic.code)).map((diagnostic)=>diagnostic.message));
     return problems;
 }
 /**

package/dist/cjs/packages/ScenePackageBundle.js.map

@@ -1 +1 @@
-{"version":3,"file":"ScenePackageBundle.js","sources":["../../../packages/ScenePackageBundle.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 { ComponentDescriptor, DialogTemplate, Layout, PackageKind, PropertyDescriptor, PropertyValueType, ScenePackage, Screen, ScreenTemplate, Theme } from '@cratis/scene.model';\nimport { IconAdapterRegistry, createIconAdapterRegistry } from '../icons/IconAdapterRegistry';\nimport { IconLibraryBundle } from '../icons/IconLibraryBundle';\nimport { ComponentRegistry } from '../renderer';\nimport { ComponentsUiLibraryContract, validateComponentsUiLibraryContract } from './ComponentsUiLibraryContract';\nimport { DesignTimeBundle, validateDesignTimeBundle } from './DesignTimeBundle';\n\n/**\n * What a package actually ships to a React renderer, as opposed to what it *declares*.\n *\n * `ScenePackage` is the declaration — a name, a kind, dependencies, and the names of what it\n * contributes. It is deliberately platform-agnostic and lives in `Scene.Model`, because Stage's build and\n * Studio's design-time queries both read it without ever loading a component. A bundle is the other half:\n * the real React components, layouts, screens and themes behind those names, which only a renderer needs.\n *\n * A package publishes exactly one bundle, as a named export following its own name —\n * `primeReactPackage`, `cratisComponentsPackage`, `corePackage`. A host loads it from the module the\n * declaration's `ScenePackage.module` names.\n */\nexport interface ScenePackageBundle {\n    /**\n     * The package's own declaration. Its `components`, `layouts` and `themes` name lists must agree with\n     * what this bundle actually provides — {@link validatePackageBundle} is what proves they do.\n     */\n    manifest: ScenePackage;\n\n    /**\n     * The components this package provides, keyed by {@link componentRegistryKey}.\n     */\n    components: ComponentRegistry;\n\n    /**\n     * The application shells this package provides, if any. Only a blueprint has these.\n     */\n    layouts?: Layout[];\n\n    /**\n     * The screen templates this package provides — the shapes that go inside a layout, each declaring\n     * which of its parent's slots it fills.\n     */\n    screenTemplates?: ScreenTemplate[];\n\n    /**\n     * The dialog templates this package provides.\n     */\n    dialogTemplates?: DialogTemplate[];\n\n    /**\n     * Sample screens this package ships — a layout package's gallery, so a preview has real content to\n     * put through the real engine rather than a mockup.\n     */\n    screens?: Screen[];\n\n    /**\n     * What can be edited on this package's components - one {@link ComponentDescriptor} per component that is\n     * editable at design time. They are data, so Studio reads them without rendering anything, and they travel with\n     * the components they describe rather than in a registry of their own. {@link validatePackageBundle} checks\n     * that every descriptor names a component the manifest declares.\n     */\n    descriptors?: ComponentDescriptor[];\n\n    /**\n     * The themes this package ships, if any.\n     */\n    themes?: Theme[];\n\n    /**\n     * The icon catalog and renderer adapter of an icon-library package. Present exactly when the\n     * manifest declares an icon library.\n     */\n    iconLibrary?: IconLibraryBundle;\n\n    /**\n     * Optional web-renderer mapping to a Components UiLibrary. Scene's catalog remains independently\n     * authored; hosts check the loaded export with validateComponentsUiLibraryMapping before rendering.\n     */\n    componentsUiLibrary?: ComponentsUiLibraryContract;\n\n    /** Optional React-only design-time tooling. Runtime hosts can omit it entirely. */\n    designTime?: DesignTimeBundle;\n}\n\n/**\n * The key a component is registered and looked up under: the package that provides it, then the bare name\n * a screen refers to it by.\n *\n * A screen writes a bare name (`button`) or a package-qualified one (`PrimeReact.button`);\n * `resolveComponentName` turns either into a `{ name, package }` pair, and this turns that pair into the\n * registry key. Nothing should build this string by hand — the separator is an implementation detail of\n * the registry, deliberately not the `.` used for qualification in a screen, so a package name containing\n * dots stays unambiguous.\n */\nexport function componentRegistryKey(packageName: string, componentName: string): string {\n    return `${packageName}:${componentName}`;\n}\n\n/**\n * Checks that a bundle provides everything its manifest declares, and declares everything it provides, and that\n * every descriptor it ships is for a component it declares and is well formed.\n *\n * A manifest that promises a component the bundle does not register renders as `UnresolvedComponent` at\n * runtime — a blank box, far from where the mistake was made. A component registered but not declared is\n * invisible to `resolveComponentName`, so a screen can never name it. Both are silent failures, which is\n * why every package's specs run this.\n */\nexport function validatePackageBundle(bundle: ScenePackageBundle): string[] {\n    const problems: string[] = [];\n    const { manifest } = bundle;\n\n    for (const name of manifest.components) {\n        if (!(componentRegistryKey(manifest.name, name) in bundle.components)) {\n            problems.push(`declares the component '${name}' but registers no implementation for it`);\n        }\n    }\n\n    const declared = new Set(manifest.components.map((name) => componentRegistryKey(manifest.name, name)));\n    for (const key of Object.keys(bundle.components)) {\n        if (!declared.has(key)) {\n            problems.push(`registers '${key}', which the manifest does not declare`);\n        }\n    }\n\n    const providedLayouts = new Set((bundle.layouts ?? []).map((layout) => layout.name));\n    for (const name of manifest.layouts) {\n        if (!providedLayouts.has(name)) {\n            problems.push(`declares the layout '${name}' but provides no definition for it`);\n        }\n    }\n\n    const providedScreenTemplates = new Set((bundle.screenTemplates ?? []).map((template) => template.name));\n    for (const name of manifest.screenTemplates) {\n        if (!providedScreenTemplates.has(name)) {\n            problems.push(`declares the screen template '${name}' but provides no definition for it`);\n        }\n    }\n\n    const providedDialogTemplates = new Set((bundle.dialogTemplates ?? []).map((template) => template.name));\n    for (const name of manifest.dialogTemplates) {\n        if (!providedDialogTemplates.has(name)) {\n            problems.push(`declares the dialog template '${name}' but provides no definition for it`);\n        }\n    }\n\n    const providedThemes = new Set((bundle.themes ?? []).map((theme) => theme.name));\n    for (const name of manifest.themes) {\n        if (!providedThemes.has(name)) {\n            problems.push(`declares the theme '${name}' but provides no definition for it`);\n        }\n    }\n\n    if (bundle.componentsUiLibrary) {\n        if (manifest.kind !== PackageKind.ComponentLibrary) {\n            problems.push('declares a Components UI library mapping but is not of kind ComponentLibrary');\n        }\n        problems.push(...validateComponentsUiLibraryContract(bundle.componentsUiLibrary));\n    }\n\n    problems.push(...validateIconLibrary(bundle));\n    problems.push(...validateDescriptors(bundle));\n    problems.push(...validateDesignTimeBundle(bundle.designTime));\n\n    return problems;\n}\n\nfunction validateIconLibrary(bundle: ScenePackageBundle): string[] {\n    const problems: string[] = [];\n    const { manifest, iconLibrary } = bundle;\n    const declaresIconLibrary = manifest.kind === PackageKind.IconLibrary || manifest.iconLibrary !== undefined;\n\n    if (manifest.kind === PackageKind.IconLibrary && !manifest.iconLibrary) {\n        problems.push('is an icon library but declares no iconLibrary metadata');\n    }\n\n    if (manifest.kind !== PackageKind.IconLibrary && manifest.iconLibrary) {\n        problems.push('declares iconLibrary metadata but is not of kind IconLibrary');\n    }\n\n    if (declaresIconLibrary && !iconLibrary) {\n        problems.push('declares an icon library but the bundle provides no catalog or adapter for it');\n    }\n\n    if (!declaresIconLibrary && iconLibrary) {\n        problems.push('provides an icon catalog and adapter, which the manifest does not declare');\n    }\n\n    if (iconLibrary) {\n        if (iconLibrary.catalog.library !== manifest.name) {\n            problems.push(`provides an icon catalog for '${iconLibrary.catalog.library}' instead of '${manifest.name}'`);\n        }\n\n        if (iconLibrary.adapter.library !== manifest.name) {\n            problems.push(`provides an icon adapter for '${iconLibrary.adapter.library}' instead of '${manifest.name}'`);\n        }\n\n        if (manifest.iconLibrary && !manifest.iconLibrary.renderers.includes('react')) {\n            problems.push(\"provides a React icon adapter but does not list 'react' among its icon renderers\");\n        }\n    }\n\n    return problems;\n}\n\nfunction validateProperties(component: string, properties: PropertyDescriptor[], parent: string, problems: string[]): void {\n    const paths = new Set<string>();\n    for (const property of properties) {\n        const path = `${parent}${property.path}`;\n        if (paths.has(property.path)) {\n            problems.push(`'${component}' describes the property '${path}' more than once`);\n        }\n\n        paths.add(property.path);\n\n        if (property.valueType === PropertyValueType.Collection && property.item === undefined) {\n            problems.push(`'${component}' describes the collection '${path}' without describing its items`);\n        }\n\n        if (property.valueType === PropertyValueType.Collection && property.item !== undefined) {\n            validateProperties(component, property.item.properties, `${path}[].`, problems);\n        }\n\n        if (property.valueType === PropertyValueType.Object && property.properties !== undefined) {\n            validateProperties(component, property.properties, `${path}.`, problems);\n        }\n\n        if (property.valueType === PropertyValueType.Enum && (property.choices ?? []).length === 0) {\n            problems.push(`'${component}' describes the enum '${path}' without choices`);\n        }\n    }\n}\n\nfunction validateDescriptors(bundle: ScenePackageBundle): string[] {\n    const problems: string[] = [];\n    const declared = new Set(bundle.manifest.components.map((name) => componentRegistryKey(bundle.manifest.name, name)));\n    const described = new Set<string>();\n\n    for (const descriptor of bundle.descriptors ?? []) {\n        if (!declared.has(descriptor.component)) {\n            problems.push(`describes '${descriptor.component}', which the manifest does not declare as a component`);\n        }\n\n        if (described.has(descriptor.component)) {\n            problems.push(`describes '${descriptor.component}' more than once`);\n        }\n\n        described.add(descriptor.component);\n\n        validateProperties(descriptor.component, descriptor.properties, '', problems);\n    }\n\n    return problems;\n}\n\n/**\n * Merges the component registries of several bundles into the single registry a renderer consumes.\n *\n * Keys carry their package name, so nothing collides and merge order does not matter — which package wins\n * a *bare* name is decided earlier, by `resolveComponentName` walking the profile's priority order.\n */\nexport function mergePackageRegistries(bundles: ScenePackageBundle[]): ComponentRegistry {\n    return Object.assign({}, ...bundles.map((bundle) => bundle.components)) as ComponentRegistry;\n}\n\n/**\n * Collects the icon adapters of several bundles into the registry `SceneIcon` renders through.\n *\n * @throws Error when two bundles provide an adapter for the same library.\n */\nexport function mergeIconAdapters(bundles: ScenePackageBundle[]): IconAdapterRegistry {\n    return createIconAdapterRegistry(bundles.flatMap((bundle) => (bundle.iconLibrary ? [bundle.iconLibrary.adapter] : [])));\n}\n"],"names":["componentRegistryKey","packageName","componentName","validatePackageBundle","bundle","problems","manifest","name","components","push","declared","Set","map","key","Object","keys","has","providedLayouts","layouts","layout","providedScreenTemplates","screenTemplates","template","providedDialogTemplates","dialogTemplates","providedThemes","themes","theme","componentsUiLibrary","kind","PackageKind","ComponentLibrary","validateComponentsUiLibraryContract","validateIconLibrary","validateDescriptors","validateDesignTimeBundle","designTime","iconLibrary","declaresIconLibrary","IconLibrary","undefined","catalog","library","adapter","renderers","includes","validateProperties","component","properties","parent","paths","property","path","add","valueType","PropertyValueType","Collection","item","Enum","choices","length","described","descriptor","descriptors","mergePackageRegistries","bundles","assign","mergeIconAdapters","createIconAdapterRegistry","flatMap"],"mappings":"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"}
+{"version":3,"file":"ScenePackageBundle.js","sources":["../../../packages/ScenePackageBundle.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 { validateComponentDescriptors } from '@cratis/scene.engine';\nimport { ComponentDescriptor, DiagnosticCode, DialogTemplate, Layout, PackageKind, PropertyDescriptor, PropertyValueType, ScenePackage, Screen, ScreenTemplate, Theme } from '@cratis/scene.model';\nimport { IconAdapterRegistry, createIconAdapterRegistry } from '../icons/IconAdapterRegistry';\nimport { IconLibraryBundle } from '../icons/IconLibraryBundle';\nimport { ComponentRegistry } from '../renderer';\nimport { ComponentsUiLibraryContract, validateComponentsUiLibraryContract } from './ComponentsUiLibraryContract';\nimport { DesignTimeBundle, validateDesignTimeBundle } from './DesignTimeBundle';\n\n/**\n * What a package actually ships to a React renderer, as opposed to what it *declares*.\n *\n * `ScenePackage` is the declaration — a name, a kind, dependencies, and the names of what it\n * contributes. It is deliberately platform-agnostic and lives in `Scene.Model`, because Stage's build and\n * Studio's design-time queries both read it without ever loading a component. A bundle is the other half:\n * the real React components, layouts, screens and themes behind those names, which only a renderer needs.\n *\n * A package publishes exactly one bundle, as a named export following its own name —\n * `primeReactPackage`, `cratisComponentsPackage`, `corePackage`. A host loads it from the module the\n * declaration's `ScenePackage.module` names.\n */\nexport interface ScenePackageBundle {\n    /**\n     * The package's own declaration. Its `components`, `layouts` and `themes` name lists must agree with\n     * what this bundle actually provides — {@link validatePackageBundle} is what proves they do.\n     */\n    manifest: ScenePackage;\n\n    /**\n     * The components this package provides, keyed by {@link componentRegistryKey}.\n     */\n    components: ComponentRegistry;\n\n    /**\n     * The application shells this package provides, if any. Only a blueprint has these.\n     */\n    layouts?: Layout[];\n\n    /**\n     * The screen templates this package provides — the shapes that go inside a layout, each declaring\n     * which of its parent's slots it fills.\n     */\n    screenTemplates?: ScreenTemplate[];\n\n    /**\n     * The dialog templates this package provides.\n     */\n    dialogTemplates?: DialogTemplate[];\n\n    /**\n     * Sample screens this package ships — a layout package's gallery, so a preview has real content to\n     * put through the real engine rather than a mockup.\n     */\n    screens?: Screen[];\n\n    /**\n     * What can be edited on this package's components - one {@link ComponentDescriptor} per component that is\n     * editable at design time. They are data, so Studio reads them without rendering anything, and they travel with\n     * the components they describe rather than in a registry of their own. {@link validatePackageBundle} checks\n     * that every descriptor names a component the manifest declares.\n     */\n    descriptors?: ComponentDescriptor[];\n\n    /**\n     * The themes this package ships, if any.\n     */\n    themes?: Theme[];\n\n    /**\n     * The icon catalog and renderer adapter of an icon-library package. Present exactly when the\n     * manifest declares an icon library.\n     */\n    iconLibrary?: IconLibraryBundle;\n\n    /**\n     * Optional web-renderer mapping to a Components UiLibrary. Scene's catalog remains independently\n     * authored; hosts check the loaded export with validateComponentsUiLibraryMapping before rendering.\n     */\n    componentsUiLibrary?: ComponentsUiLibraryContract;\n\n    /** Optional React-only design-time tooling. Runtime hosts can omit it entirely. */\n    designTime?: DesignTimeBundle;\n}\n\n/**\n * The key a component is registered and looked up under: the package that provides it, then the bare name\n * a screen refers to it by.\n *\n * A screen writes a bare name (`button`) or a package-qualified one (`PrimeReact.button`);\n * `resolveComponentName` turns either into a `{ name, package }` pair, and this turns that pair into the\n * registry key. Nothing should build this string by hand — the separator is an implementation detail of\n * the registry, deliberately not the `.` used for qualification in a screen, so a package name containing\n * dots stays unambiguous.\n */\nexport function componentRegistryKey(packageName: string, componentName: string): string {\n    return `${packageName}:${componentName}`;\n}\n\n/**\n * Checks that a bundle provides everything its manifest declares, and declares everything it provides, and that\n * every descriptor it ships is for a component it declares and is well formed.\n *\n * A manifest that promises a component the bundle does not register renders as `UnresolvedComponent` at\n * runtime — a blank box, far from where the mistake was made. A component registered but not declared is\n * invisible to `resolveComponentName`, so a screen can never name it. Both are silent failures, which is\n * why every package's specs run this.\n */\nexport function validatePackageBundle(bundle: ScenePackageBundle): string[] {\n    const problems: string[] = [];\n    const { manifest } = bundle;\n\n    for (const name of manifest.components) {\n        if (!(componentRegistryKey(manifest.name, name) in bundle.components)) {\n            problems.push(`declares the component '${name}' but registers no implementation for it`);\n        }\n    }\n\n    const declared = new Set(manifest.components.map((name) => componentRegistryKey(manifest.name, name)));\n    for (const key of Object.keys(bundle.components)) {\n        if (!declared.has(key)) {\n            problems.push(`registers '${key}', which the manifest does not declare`);\n        }\n    }\n\n    const providedLayouts = new Set((bundle.layouts ?? []).map((layout) => layout.name));\n    for (const name of manifest.layouts) {\n        if (!providedLayouts.has(name)) {\n            problems.push(`declares the layout '${name}' but provides no definition for it`);\n        }\n    }\n\n    const providedScreenTemplates = new Set((bundle.screenTemplates ?? []).map((template) => template.name));\n    for (const name of manifest.screenTemplates) {\n        if (!providedScreenTemplates.has(name)) {\n            problems.push(`declares the screen template '${name}' but provides no definition for it`);\n        }\n    }\n\n    const providedDialogTemplates = new Set((bundle.dialogTemplates ?? []).map((template) => template.name));\n    for (const name of manifest.dialogTemplates) {\n        if (!providedDialogTemplates.has(name)) {\n            problems.push(`declares the dialog template '${name}' but provides no definition for it`);\n        }\n    }\n\n    const providedThemes = new Set((bundle.themes ?? []).map((theme) => theme.name));\n    for (const name of manifest.themes) {\n        if (!providedThemes.has(name)) {\n            problems.push(`declares the theme '${name}' but provides no definition for it`);\n        }\n    }\n\n    if (bundle.componentsUiLibrary) {\n        if (manifest.kind !== PackageKind.ComponentLibrary) {\n            problems.push('declares a Components UI library mapping but is not of kind ComponentLibrary');\n        }\n        problems.push(...validateComponentsUiLibraryContract(bundle.componentsUiLibrary));\n    }\n\n    problems.push(...validateIconLibrary(bundle));\n    problems.push(...validateDescriptors(bundle));\n    problems.push(...validateDesignTimeBundle(bundle.designTime));\n\n    return problems;\n}\n\nfunction validateIconLibrary(bundle: ScenePackageBundle): string[] {\n    const problems: string[] = [];\n    const { manifest, iconLibrary } = bundle;\n    const declaresIconLibrary = manifest.kind === PackageKind.IconLibrary || manifest.iconLibrary !== undefined;\n\n    if (manifest.kind === PackageKind.IconLibrary && !manifest.iconLibrary) {\n        problems.push('is an icon library but declares no iconLibrary metadata');\n    }\n\n    if (manifest.kind !== PackageKind.IconLibrary && manifest.iconLibrary) {\n        problems.push('declares iconLibrary metadata but is not of kind IconLibrary');\n    }\n\n    if (declaresIconLibrary && !iconLibrary) {\n        problems.push('declares an icon library but the bundle provides no catalog or adapter for it');\n    }\n\n    if (!declaresIconLibrary && iconLibrary) {\n        problems.push('provides an icon catalog and adapter, which the manifest does not declare');\n    }\n\n    if (iconLibrary) {\n        if (iconLibrary.catalog.library !== manifest.name) {\n            problems.push(`provides an icon catalog for '${iconLibrary.catalog.library}' instead of '${manifest.name}'`);\n        }\n\n        if (iconLibrary.adapter.library !== manifest.name) {\n            problems.push(`provides an icon adapter for '${iconLibrary.adapter.library}' instead of '${manifest.name}'`);\n        }\n\n        if (manifest.iconLibrary && !manifest.iconLibrary.renderers.includes('react')) {\n            problems.push(\"provides a React icon adapter but does not list 'react' among its icon renderers\");\n        }\n    }\n\n    return problems;\n}\n\nfunction validateProperties(component: string, properties: PropertyDescriptor[], parent: string, problems: string[]): void {\n    const paths = new Set<string>();\n    for (const property of properties) {\n        const path = `${parent}${property.path}`;\n        if (paths.has(property.path)) {\n            problems.push(`'${component}' describes the property '${path}' more than once`);\n        }\n\n        paths.add(property.path);\n\n        if (property.valueType === PropertyValueType.Collection && property.item === undefined) {\n            problems.push(`'${component}' describes the collection '${path}' without describing its items`);\n        }\n\n        if (property.valueType === PropertyValueType.Collection && property.item !== undefined) {\n            validateProperties(component, property.item.properties, `${path}[].`, problems);\n        }\n\n        if (property.valueType === PropertyValueType.Object && property.properties !== undefined) {\n            validateProperties(component, property.properties, `${path}.`, problems);\n        }\n\n        if (property.valueType === PropertyValueType.Enum && (property.choices ?? []).length === 0) {\n            problems.push(`'${component}' describes the enum '${path}' without choices`);\n        }\n    }\n}\n\nfunction validateDescriptors(bundle: ScenePackageBundle): string[] {\n    const problems: string[] = [];\n    const declared = new Set(bundle.manifest.components.map((name) => componentRegistryKey(bundle.manifest.name, name)));\n    const described = new Set<string>();\n\n    for (const descriptor of bundle.descriptors ?? []) {\n        if (!declared.has(descriptor.component)) {\n            problems.push(`describes '${descriptor.component}', which the manifest does not declare as a component`);\n        }\n\n        if (described.has(descriptor.component)) {\n            problems.push(`describes '${descriptor.component}' more than once`);\n        }\n\n        described.add(descriptor.component);\n\n        validateProperties(descriptor.component, descriptor.properties, '', problems);\n    }\n\n    // The category rule (CMP1) is not checked here - it gates a designer, not a host loading a package (see validateComponentMetadata) -\n    // but a design-mode descriptor or editor parameter that cannot work is as much a mistake as an enum without choices.\n    const structural: string[] = [DiagnosticCode.ComponentDesignModeInvalid, DiagnosticCode.PropertyEditorOptionsInvalid];\n    problems.push(...validateComponentDescriptors(bundle.descriptors ?? []).filter(diagnostic => structural.includes(diagnostic.code)).map(diagnostic => diagnostic.message));\n\n    return problems;\n}\n\n/**\n * Merges the component registries of several bundles into the single registry a renderer consumes.\n *\n * Keys carry their package name, so nothing collides and merge order does not matter — which package wins\n * a *bare* name is decided earlier, by `resolveComponentName` walking the profile's priority order.\n */\nexport function mergePackageRegistries(bundles: ScenePackageBundle[]): ComponentRegistry {\n    return Object.assign({}, ...bundles.map((bundle) => bundle.components)) as ComponentRegistry;\n}\n\n/**\n * Collects the icon adapters of several bundles into the registry `SceneIcon` renders through.\n *\n * @throws Error when two bundles provide an adapter for the same library.\n */\nexport function mergeIconAdapters(bundles: ScenePackageBundle[]): IconAdapterRegistry {\n    return createIconAdapterRegistry(bundles.flatMap((bundle) => (bundle.iconLibrary ? [bundle.iconLibrary.adapter] : [])));\n}\n"],"names":["componentRegistryKey","packageName","componentName","validatePackageBundle","bundle","problems","manifest","name","components","push","declared","Set","map","key","Object","keys","has","providedLayouts","layouts","layout","providedScreenTemplates","screenTemplates","template","providedDialogTemplates","dialogTemplates","providedThemes","themes","theme","componentsUiLibrary","kind","PackageKind","ComponentLibrary","validateComponentsUiLibraryContract","validateIconLibrary","validateDescriptors","validateDesignTimeBundle","designTime","iconLibrary","declaresIconLibrary","IconLibrary","undefined","catalog","library","adapter","renderers","includes","validateProperties","component","properties","parent","paths","property","path","add","valueType","PropertyValueType","Collection","item","Enum","choices","length","described","descriptor","descriptors","structural","DiagnosticCode","ComponentDesignModeInvalid","PropertyEditorOptionsInvalid","validateComponentDescriptors","filter","diagnostic","code","message","mergePackageRegistries","bundles","assign","mergeIconAdapters","createIconAdapterRegistry","flatMap"],"mappings":"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"}

package/dist/cjs/packages/describeComponents.js

@@ -0,0 +1,64 @@
+'use strict';
+
+var scene_model = require('@cratis/scene.model');
+var ScenePackageBundle = require('./ScenePackageBundle.js');
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/** A `ComponentMetadata` entry in one line: what a package's metadata table is made of. */ function componentMetadata(displayName, category, icon, keywords = [], badge, designMode) {
+    return {
+        displayName,
+        category,
+        icon,
+        keywords,
+        ...badge === undefined ? {} : {
+            badge
+        },
+        ...designMode === undefined ? {} : {
+            designMode
+        }
+    };
+}
+/**
+ * Builds the descriptors a bundle ships: the ones written by hand with the package's component metadata merged in, plus a descriptor with
+ * no editable properties for every component the metadata names that nobody described - such a component still has a name, a
+ * category and a place in a picker. A hand-written descriptor keeps everything it already says; metadata only fills in what it
+ * leaves out.
+ *
+ * The component list is the metadata table's own, so a component the table forgets has no descriptor and `validateComponentMetadata`
+ * reports it (CMP1); one the table names but the manifest does not declare is reported by `validatePackageBundle`.
+ */ function describeComponents(packageName, described, metadata) {
+    const describedKeys = new Set(described.map((descriptor)=>descriptor.component));
+    const bare = Object.keys(metadata).map((name)=>ScenePackageBundle.componentRegistryKey(packageName, name)).filter((key)=>!describedKeys.has(key)).map((key)=>({
+            component: key,
+            properties: []
+        }));
+    return [
+        ...described,
+        ...bare
+    ].map((descriptor)=>withMetadata(descriptor, metadata[descriptor.component.slice(packageName.length + 1)]));
+}
+function withMetadata(descriptor, metadata) {
+    if (!metadata) return descriptor;
+    return {
+        ...descriptor,
+        displayName: descriptor.displayName ?? metadata.displayName ?? descriptor.component.slice(descriptor.component.indexOf(':') + 1),
+        category: descriptor.category ?? metadata.category,
+        ...descriptor.icon === undefined && metadata.icon !== undefined ? {
+            icon: scene_model.componentIcon(metadata.icon)
+        } : {},
+        ...descriptor.keywords === undefined && metadata.keywords !== undefined ? {
+            keywords: metadata.keywords
+        } : {},
+        ...descriptor.badge === undefined && metadata.badge !== undefined ? {
+            badge: metadata.badge
+        } : {},
+        ...descriptor.designMode === undefined && metadata.designMode !== undefined ? {
+            designMode: metadata.designMode
+        } : {}
+    };
+}
+
+exports.componentMetadata = componentMetadata;
+exports.describeComponents = describeComponents;
+//# sourceMappingURL=describeComponents.js.map

package/dist/cjs/packages/describeComponents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describeComponents.js","sources":["../../../packages/describeComponents.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 { ComponentDescriptor, ComponentDesignModeDescriptor, componentIcon } from '@cratis/scene.model';\nimport { componentRegistryKey } from './ScenePackageBundle';\n\n/**\n * What a package says about one of its components for a picker, besides what can be edited: the data of CMP1 and the picker's\n * rows. Written once per package as a table keyed by the bare component name.\n */\nexport interface ComponentMetadata {\n    /** The name a picker shows. Absent keeps the one the component's descriptor has, or the bare name. */\n    displayName?: string;\n\n    /** One of `ComponentCategory`, or a category of the package's own. */\n    category: string;\n\n    /** The key of the icon in the built-in icon library (`componentIcon`). */\n    icon?: string;\n\n    /** Words the picker's filter matches besides the name. */\n    keywords?: string[];\n\n    /** An explicit two-letter badge; absent means derived from the name. */\n    badge?: string;\n\n    /** How the component is edited directly on the design surface. */\n    designMode?: ComponentDesignModeDescriptor;\n}\n\n/** A `ComponentMetadata` entry in one line: what a package's metadata table is made of. */\nexport function componentMetadata(\n    displayName: string,\n    category: string,\n    icon: string,\n    keywords: string[] = [],\n    badge?: string,\n    designMode?: ComponentDesignModeDescriptor\n): ComponentMetadata {\n    return { displayName, category, icon, keywords, ...(badge === undefined ? {} : { badge }), ...(designMode === undefined ? {} : { designMode }) };\n}\n\n/**\n * Builds the descriptors a bundle ships: the ones written by hand with the package's component metadata merged in, plus a descriptor with\n * no editable properties for every component the metadata names that nobody described - such a component still has a name, a\n * category and a place in a picker. A hand-written descriptor keeps everything it already says; metadata only fills in what it\n * leaves out.\n *\n * The component list is the metadata table's own, so a component the table forgets has no descriptor and `validateComponentMetadata`\n * reports it (CMP1); one the table names but the manifest does not declare is reported by `validatePackageBundle`.\n */\nexport function describeComponents(\n    packageName: string,\n    described: readonly ComponentDescriptor[],\n    metadata: Readonly<Record<string, ComponentMetadata>>\n): ComponentDescriptor[] {\n    const describedKeys = new Set(described.map(descriptor => descriptor.component));\n    const bare = Object.keys(metadata)\n        .map(name => componentRegistryKey(packageName, name))\n        .filter(key => !describedKeys.has(key))\n        .map((key): ComponentDescriptor => ({ component: key, properties: [] }));\n\n    return [...described, ...bare].map(descriptor => withMetadata(descriptor, metadata[descriptor.component.slice(packageName.length + 1)]));\n}\n\nfunction withMetadata(descriptor: ComponentDescriptor, metadata: ComponentMetadata | undefined): ComponentDescriptor {\n    if (!metadata) return descriptor;\n\n    return {\n        ...descriptor,\n        displayName: descriptor.displayName ?? metadata.displayName ?? descriptor.component.slice(descriptor.component.indexOf(':') + 1),\n        category: descriptor.category ?? metadata.category,\n        ...(descriptor.icon === undefined && metadata.icon !== undefined ? { icon: componentIcon(metadata.icon) } : {}),\n        ...(descriptor.keywords === undefined && metadata.keywords !== undefined ? { keywords: metadata.keywords } : {}),\n        ...(descriptor.badge === undefined && metadata.badge !== undefined ? { badge: metadata.badge } : {}),\n        ...(descriptor.designMode === undefined && metadata.designMode !== undefined ? { designMode: metadata.designMode } : {}),\n    };\n}\n"],"names":["componentMetadata","displayName","category","icon","keywords","badge","designMode","undefined","describeComponents","packageName","described","metadata","describedKeys","Set","map","descriptor","component","bare","Object","keys","name","componentRegistryKey","filter","key","has","properties","withMetadata","slice","length","indexOf","componentIcon"],"mappings":";;;;;AAAA;AACA;AA6BA,4FACO,SAASA,iBAAAA,CACZC,WAAmB,EACnBC,QAAgB,EAChBC,IAAY,EACZC,QAAAA,GAAqB,EAAE,EACvBC,KAAc,EACdC,UAA0C,EAAA;IAE1C,OAAO;AAAEL,QAAAA,WAAAA;AAAaC,QAAAA,QAAAA;AAAUC,QAAAA,IAAAA;AAAMC,QAAAA,QAAAA;QAAU,GAAIC,KAAAA,KAAUE,SAAAA,GAAY,EAAC,GAAI;AAAEF,YAAAA;SAAO;QAAG,GAAIC,UAAAA,KAAeC,SAAAA,GAAY,EAAC,GAAI;AAAED,YAAAA;;AAAc,KAAA;AACnJ;AAEA;;;;;;;;AAQC,IACM,SAASE,kBAAAA,CACZC,WAAmB,EACnBC,SAAyC,EACzCC,QAAqD,EAAA;IAErD,MAAMC,aAAAA,GAAgB,IAAIC,GAAAA,CAAIH,SAAAA,CAAUI,GAAG,CAACC,CAAAA,UAAAA,GAAcA,UAAAA,CAAWC,SAAS,CAAA,CAAA;IAC9E,MAAMC,IAAAA,GAAOC,MAAAA,CAAOC,IAAI,CAACR,QAAAA,CAAAA,CACpBG,GAAG,CAACM,CAAAA,IAAAA,GAAQC,uCAAAA,CAAqBZ,WAAAA,EAAaW,IAAAA,CAAAA,CAAAA,CAC9CE,MAAM,CAACC,CAAAA,GAAAA,GAAO,CAACX,aAAAA,CAAcY,GAAG,CAACD,GAAAA,CAAAA,CAAAA,CACjCT,GAAG,CAAC,CAACS,GAAAA,IAA8B;YAAEP,SAAAA,EAAWO,GAAAA;AAAKE,YAAAA,UAAAA,EAAY;SAAG,CAAA,CAAA;IAEzE,OAAO;AAAIf,QAAAA,GAAAA,SAAAA;AAAcO,QAAAA,GAAAA;AAAK,KAAA,CAACH,GAAG,CAACC,CAAAA,UAAAA,GAAcW,YAAAA,CAAaX,YAAYJ,QAAQ,CAACI,UAAAA,CAAWC,SAAS,CAACW,KAAK,CAAClB,WAAAA,CAAYmB,MAAM,GAAG,CAAA,CAAA,CAAG,CAAA,CAAA;AAC1I;AAEA,SAASF,YAAAA,CAAaX,UAA+B,EAAEJ,QAAuC,EAAA;IAC1F,IAAI,CAACA,UAAU,OAAOI,UAAAA;IAEtB,OAAO;AACH,QAAA,GAAGA,UAAU;AACbd,QAAAA,WAAAA,EAAac,WAAWd,WAAW,IAAIU,QAAAA,CAASV,WAAW,IAAIc,UAAAA,CAAWC,SAAS,CAACW,KAAK,CAACZ,UAAAA,CAAWC,SAAS,CAACa,OAAO,CAAC,GAAA,CAAA,GAAO,CAAA,CAAA;AAC9H3B,QAAAA,QAAAA,EAAUa,UAAAA,CAAWb,QAAQ,IAAIS,QAAAA,CAAST,QAAQ;AAClD,QAAA,GAAIa,WAAWZ,IAAI,KAAKI,aAAaI,QAAAA,CAASR,IAAI,KAAKI,SAAAA,GAAY;YAAEJ,IAAAA,EAAM2B,yBAAAA,CAAcnB,SAASR,IAAI;AAAE,SAAA,GAAI,EAAE;AAC9G,QAAA,GAAIY,WAAWX,QAAQ,KAAKG,aAAaI,QAAAA,CAASP,QAAQ,KAAKG,SAAAA,GAAY;AAAEH,YAAAA,QAAAA,EAAUO,SAASP;AAAS,SAAA,GAAI,EAAE;AAC/G,QAAA,GAAIW,WAAWV,KAAK,KAAKE,aAAaI,QAAAA,CAASN,KAAK,KAAKE,SAAAA,GAAY;AAAEF,YAAAA,KAAAA,EAAOM,SAASN;AAAM,SAAA,GAAI,EAAE;AACnG,QAAA,GAAIU,WAAWT,UAAU,KAAKC,aAAaI,QAAAA,CAASL,UAAU,KAAKC,SAAAA,GAAY;AAAED,YAAAA,UAAAA,EAAYK,SAASL;AAAW,SAAA,GAAI;AACzH,KAAA;AACJ;;;"}