@cratis/scene.model 4.23.0 → 4.25.0

package/dist/cjs/editing/DiagnosticCode.js.map

@@ -1 +1 @@
-{"version":3,"file":"DiagnosticCode.js","sources":["../../../editing/DiagnosticCode.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 reasons inspection, editing, binding validation and configuration resolution report a problem. A host\n * switches on the code; the message is for a person.\n */\nexport enum DiagnosticCode {\n    // Addressing\n    UnknownNode = 'unknownNode',\n    DuplicateElementId = 'duplicateElementId',\n    UnknownScope = 'unknownScope',\n    InvalidEdit = 'invalidEdit',\n\n    // Properties\n    UnknownProperty = 'unknownProperty',\n    InvalidValue = 'invalidValue',\n    ReadOnlyProperty = 'readOnlyProperty',\n    NodeNotEditable = 'nodeNotEditable',\n    MissingComponentDescriptor = 'missingComponentDescriptor',\n\n    // Layout\n    NotALayoutNode = 'notALayoutNode',\n    LayoutTypeNotConvertible = 'layoutTypeNotConvertible',\n    LossyConversionNotAccepted = 'lossyConversionNotAccepted',\n    LossyConversion = 'lossyConversion',\n\n    // Structure\n    TargetDoesNotAcceptChildren = 'targetDoesNotAcceptChildren',\n    UnknownSlot = 'unknownSlot',\n    ContainmentCycle = 'containmentCycle',\n    IndexOutOfRange = 'indexOutOfRange',\n    ElementIdInUse = 'elementIdInUse',\n    MaximumChildrenExceeded = 'maximumChildrenExceeded',\n    NodeNotRemovable = 'nodeNotRemovable',\n\n    // Query binding\n    MissingQuery = 'missingQuery',\n    IncompatibleResultShape = 'incompatibleResultShape',\n    MissingRequiredParameter = 'missingRequiredParameter',\n    UnknownParameter = 'unknownParameter',\n    ArgumentTypeMismatch = 'argumentTypeMismatch',\n    UnresolvedArgumentSource = 'unresolvedArgumentSource',\n    UnknownResultField = 'unknownResultField',\n\n    // Exposure and instance configuration\n    ExposureTargetMissing = 'exposureTargetMissing',\n    ExposureWidensOwner = 'exposureWidensOwner',\n    ReExposureBroken = 'reExposureBroken',\n    ContributionNotExposed = 'contributionNotExposed',\n    ContributionTargetMissing = 'contributionTargetMissing',\n    ContributionTypeMismatch = 'contributionTypeMismatch',\n    ContributionOperationNotPermitted = 'contributionOperationNotPermitted',\n    UnknownCollectionField = 'unknownCollectionField',\n    CollectionItemNotFound = 'collectionItemNotFound',\n    DuplicateCollectionItem = 'duplicateCollectionItem',\n    UnknownInstance = 'unknownInstance',\n\n    // Icons\n    MissingIconLibrary = 'missingIconLibrary',\n    MissingIcon = 'missingIcon',\n    MissingIconVariant = 'missingIconVariant',\n    IncompatibleIconLibrary = 'incompatibleIconLibrary',\n    IconCatalogUnavailable = 'iconCatalogUnavailable',\n    IconNotVerified = 'iconNotVerified',\n}\n"],"names":["DiagnosticCode"],"mappings":";;AAAA;AACA;AAEA;;;IAIO,IAAKA,cAAAA,iBAAAA,SAAAA,cAAAA,EAAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAAA,IAAAA,OAAAA,cAAAA;AA0DX,CAAA,CAAA,EAAA;;"}
+{"version":3,"file":"DiagnosticCode.js","sources":["../../../editing/DiagnosticCode.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 reasons inspection, editing, binding validation and configuration resolution report a problem. A host\n * switches on the code; the message is for a person.\n */\nexport enum DiagnosticCode {\n    // Addressing\n    UnknownNode = 'unknownNode',\n    DuplicateElementId = 'duplicateElementId',\n    UnknownScope = 'unknownScope',\n    InvalidEdit = 'invalidEdit',\n\n    // Properties\n    UnknownProperty = 'unknownProperty',\n    InvalidValue = 'invalidValue',\n    ReadOnlyProperty = 'readOnlyProperty',\n    NodeNotEditable = 'nodeNotEditable',\n    MissingComponentDescriptor = 'missingComponentDescriptor',\n\n    // Layout\n    NotALayoutNode = 'notALayoutNode',\n    LayoutTypeNotConvertible = 'layoutTypeNotConvertible',\n    LossyConversionNotAccepted = 'lossyConversionNotAccepted',\n    LossyConversion = 'lossyConversion',\n\n    // Structure\n    TargetDoesNotAcceptChildren = 'targetDoesNotAcceptChildren',\n    UnknownSlot = 'unknownSlot',\n    ContainmentCycle = 'containmentCycle',\n    IndexOutOfRange = 'indexOutOfRange',\n    ElementIdInUse = 'elementIdInUse',\n    MaximumChildrenExceeded = 'maximumChildrenExceeded',\n    NodeNotRemovable = 'nodeNotRemovable',\n\n    // Query binding\n    MissingQuery = 'missingQuery',\n    IncompatibleResultShape = 'incompatibleResultShape',\n    MissingRequiredParameter = 'missingRequiredParameter',\n    UnknownParameter = 'unknownParameter',\n    ArgumentTypeMismatch = 'argumentTypeMismatch',\n    UnresolvedArgumentSource = 'unresolvedArgumentSource',\n    UnknownResultField = 'unknownResultField',\n\n    // Exposure and instance configuration\n    ExposureTargetMissing = 'exposureTargetMissing',\n    ExposureWidensOwner = 'exposureWidensOwner',\n    ReExposureBroken = 'reExposureBroken',\n    ContributionNotExposed = 'contributionNotExposed',\n    ContributionTargetMissing = 'contributionTargetMissing',\n    ContributionTypeMismatch = 'contributionTypeMismatch',\n    ContributionOperationNotPermitted = 'contributionOperationNotPermitted',\n    UnknownCollectionField = 'unknownCollectionField',\n    CollectionItemNotFound = 'collectionItemNotFound',\n    DuplicateCollectionItem = 'duplicateCollectionItem',\n    UnknownInstance = 'unknownInstance',\n\n    // Icons\n    MissingIconLibrary = 'missingIconLibrary',\n    MissingIcon = 'missingIcon',\n    MissingIconVariant = 'missingIconVariant',\n    IncompatibleIconLibrary = 'incompatibleIconLibrary',\n    IconCatalogUnavailable = 'iconCatalogUnavailable',\n    IconNotVerified = 'iconNotVerified',\n\n    // Component metadata\n    ComponentCategoryMissing = 'componentCategoryMissing',\n    ComponentCategoryUnknown = 'componentCategoryUnknown',\n    ComponentDesignModeInvalid = 'componentDesignModeInvalid',\n    PropertyEditorOptionsInvalid = 'propertyEditorOptionsInvalid',\n}\n"],"names":["DiagnosticCode"],"mappings":";;AAAA;AACA;AAEA;;;IAIO,IAAKA,cAAAA,iBAAAA,SAAAA,cAAAA,EAAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAAA,IAAAA,OAAAA,cAAAA;AAgEX,CAAA,CAAA,EAAA;;"}

package/dist/cjs/index.js

@@ -104,6 +104,7 @@ var DialogTemplate = require('./screens/DialogTemplate.js');
 var TemplateAttribution = require('./screens/TemplateAttribution.js');
 var TemplateCompatibility = require('./screens/TemplateCompatibility.js');
 var TemplateMetadata = require('./screens/TemplateMetadata.js');
+var TemplateReference = require('./screens/TemplateReference.js');
 var UiStarter = require('./starters/UiStarter.js');
 var QueryResultShape = require('./queries/QueryResultShape.js');
 var QueryOriginKind = require('./queries/QueryOriginKind.js');
@@ -116,6 +117,7 @@ var QueryResultBinding = require('./queries/QueryResultBinding.js');
 var QueryBinding = require('./queries/QueryBinding.js');
 var PropertyValueType = require('./descriptors/PropertyValueType.js');
 var PropertyEditorKind = require('./descriptors/PropertyEditorKind.js');
+var PropertyEditorOptions = require('./descriptors/PropertyEditorOptions.js');
 var PropertyChoice = require('./descriptors/PropertyChoice.js');
 var PropertyConstraints = require('./descriptors/PropertyConstraints.js');
 var CollectionItemDescriptor = require('./descriptors/CollectionItemDescriptor.js');
@@ -123,6 +125,9 @@ var DesignTimeActionDescriptor = require('./descriptors/DesignTimeActionDescript
 var DesignTimeActionPlacement = require('./descriptors/DesignTimeActionPlacement.js');
 var PackageDesignTimeMetadata = require('./descriptors/PackageDesignTimeMetadata.js');
 var PropertyDescriptor = require('./descriptors/PropertyDescriptor.js');
+var ComponentCategory = require('./descriptors/ComponentCategory.js');
+var ComponentDesignModeDescriptor = require('./descriptors/ComponentDesignModeDescriptor.js');
+var componentIcon = require('./descriptors/componentIcon.js');
 var ComponentDescriptor = require('./descriptors/ComponentDescriptor.js');
 var CollectionOperation = require('./descriptors/CollectionOperation.js');
 var LayoutType = require('./descriptors/LayoutType.js');
@@ -282,6 +287,8 @@ exports.TemplateAttributionPropertyNames = TemplateAttribution.TemplateAttributi
 exports.TemplateCompatibilityPropertyNames = TemplateCompatibility.TemplateCompatibilityPropertyNames;
 exports.TemplateMetadataPropertyNames = TemplateMetadata.TemplateMetadataPropertyNames;
 exports.TemplateScope = TemplateMetadata.TemplateScope;
+exports.TemplateReferencePropertyNames = TemplateReference.TemplateReferencePropertyNames;
+exports.TemplateReferenceSource = TemplateReference.TemplateReferenceSource;
 exports.UiStarterPropertyNames = UiStarter.UiStarterPropertyNames;
 exports.QueryResultShape = QueryResultShape.QueryResultShape;
 exports.QueryOriginKind = QueryOriginKind.QueryOriginKind;
@@ -294,6 +301,8 @@ exports.QueryResultBindingPropertyNames = QueryResultBinding.QueryResultBindingP
 exports.QueryBindingPropertyNames = QueryBinding.QueryBindingPropertyNames;
 exports.PropertyValueType = PropertyValueType.PropertyValueType;
 exports.PropertyEditorKind = PropertyEditorKind.PropertyEditorKind;
+exports.PropertyEditorOptionsPropertyNames = PropertyEditorOptions.PropertyEditorOptionsPropertyNames;
+exports.ReferenceFilterDescriptorPropertyNames = PropertyEditorOptions.ReferenceFilterDescriptorPropertyNames;
 exports.PropertyChoicePropertyNames = PropertyChoice.PropertyChoicePropertyNames;
 exports.PropertyConstraintsPropertyNames = PropertyConstraints.PropertyConstraintsPropertyNames;
 exports.CollectionItemDescriptorPropertyNames = CollectionItemDescriptor.CollectionItemDescriptorPropertyNames;
@@ -301,6 +310,13 @@ exports.DesignTimeActionDescriptorPropertyNames = DesignTimeActionDescriptor.Des
 exports.DesignTimeActionPlacement = DesignTimeActionPlacement.DesignTimeActionPlacement;
 exports.PackageDesignTimeMetadataPropertyNames = PackageDesignTimeMetadata.PackageDesignTimeMetadataPropertyNames;
 exports.PropertyDescriptorPropertyNames = PropertyDescriptor.PropertyDescriptorPropertyNames;
+exports.ComponentCategory = ComponentCategory.ComponentCategory;
+exports.componentCategories = ComponentCategory.componentCategories;
+exports.ComponentDesignModeDescriptorPropertyNames = ComponentDesignModeDescriptor.ComponentDesignModeDescriptorPropertyNames;
+exports.DesignModeAddActionPropertyNames = ComponentDesignModeDescriptor.DesignModeAddActionPropertyNames;
+exports.DesignModeItemActionPropertyNames = ComponentDesignModeDescriptor.DesignModeItemActionPropertyNames;
+exports.componentIcon = componentIcon.componentIcon;
+exports.componentIconLibrary = componentIcon.componentIconLibrary;
 exports.ComponentDescriptorPropertyNames = ComponentDescriptor.ComponentDescriptorPropertyNames;
 exports.CollectionOperation = CollectionOperation.CollectionOperation;
 exports.LayoutType = LayoutType.LayoutType;

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/screens/TemplateMetadata.js

@@ -17,7 +17,8 @@ const TemplateMetadataPropertyNames = [
     'compatibility',
     'attribution',
     'license',
-    'licenseUrl'
+    'licenseUrl',
+    'sliceKinds'
 ];
 
 exports.TemplateMetadataPropertyNames = TemplateMetadataPropertyNames;

package/dist/cjs/screens/TemplateMetadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"TemplateMetadata.js","sources":["../../../screens/TemplateMetadata.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 { TemplateAttribution } from './TemplateAttribution';\nimport { TemplateCompatibility } from './TemplateCompatibility';\n\n/** The application hierarchy at which a reusable template is selected. */\nexport enum TemplateScope {\n    Application = 'Application',\n    Module = 'Module',\n    Feature = 'Feature',\n    Subfeature = 'Subfeature',\n    Slice = 'Slice',\n}\n\n/**\n * Optional semantic and browsing metadata. Type and category are open strings so packages can\n * introduce their own vocabulary without a Scene release. Category never determines applicability.\n */\nexport interface TemplateMetadata {\n    /** Semantic role; built-in roles are ApplicationShell, Workspace, List, Detail, Form and Dialog. */\n    type?: string;\n    /** A package-defined browse category, preserved even when the host does not recognize it. */\n    category?: string;\n    /** Explicit scope restriction. Absent uses the structural role; an empty list allows no scope. */\n    scopes?: TemplateScope[];\n    /** The Scene and package versions the template requires. Required for every shipped template. */\n    compatibility?: TemplateCompatibility;\n    /** Who authored the template. Required for every shipped template. */\n    attribution?: TemplateAttribution;\n    /** The SPDX license identifier the template is available under, such as `MIT`. Required for every shipped template. */\n    license?: string;\n    /** An absolute `https` URL to the license terms. */\n    licenseUrl?: string;\n}\n\nexport const TemplateMetadataPropertyNames: (keyof TemplateMetadata)[] = [\n    'type', 'category', 'scopes', 'compatibility', 'attribution', 'license', 'licenseUrl',\n];\n"],"names":["TemplateScope","TemplateMetadataPropertyNames"],"mappings":";;AAAA;AACA;AAKA,2EACO,IAAKA,aAAAA,iBAAAA,SAAAA,aAAAA,EAAAA;;;;;;AAAAA,IAAAA,OAAAA,aAAAA;AAMX,CAAA,CAAA,EAAA;MAuBYC,6BAAAA,GAA4D;AACrE,IAAA,MAAA;AAAQ,IAAA,UAAA;AAAY,IAAA,QAAA;AAAU,IAAA,eAAA;AAAiB,IAAA,aAAA;AAAe,IAAA,SAAA;AAAW,IAAA;;;;"}
+{"version":3,"file":"TemplateMetadata.js","sources":["../../../screens/TemplateMetadata.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 { TemplateAttribution } from './TemplateAttribution';\nimport { TemplateCompatibility } from './TemplateCompatibility';\nimport { SliceKind } from '../structure';\n\n/** The application hierarchy at which a reusable template is selected. */\nexport enum TemplateScope {\n    Application = 'Application',\n    Module = 'Module',\n    Feature = 'Feature',\n    Subfeature = 'Subfeature',\n    Slice = 'Slice',\n}\n\n/**\n * Semantic and browsing metadata. Category is required for blueprint templates and recommended for own templates. Type and category are open strings so packages can\n * introduce their own vocabulary without a Scene release. Category never determines applicability.\n */\nexport interface TemplateMetadata {\n    /** Semantic role; built-in roles are ApplicationShell, Workspace, List, Detail, Form and Dialog. */\n    type?: string;\n    /** A package-defined browse category, preserved even when the host does not recognize it. */\n    category?: string;\n    /** Explicit scope restriction. Absent uses the structural role; an empty list allows no scope. */\n    scopes?: TemplateScope[];\n    /** The Scene and package versions the template requires. Required for every shipped template. */\n    compatibility?: TemplateCompatibility;\n    /** Who authored the template. Required for every shipped template. */\n    attribution?: TemplateAttribution;\n    /** The SPDX license identifier the template is available under, such as `MIT`. Required for every shipped template. */\n    license?: string;\n    /** An absolute `https` URL to the license terms. */\n    licenseUrl?: string;\n    /**\n     * For a template that applies at {@link TemplateScope.Slice}, the slice kinds it applies to. Absent uses the\n     * structural default: a dialog template applies to state change slices, a screen template to every kind that\n     * presents something. Declaring slice kinds without scopes makes the default scope Slice.\n     */\n    sliceKinds?: SliceKind[];\n}\n\nexport const TemplateMetadataPropertyNames: (keyof TemplateMetadata)[] = [\n    'type', 'category', 'scopes', 'compatibility', 'attribution', 'license', 'licenseUrl', 'sliceKinds',\n];\n"],"names":["TemplateScope","TemplateMetadataPropertyNames"],"mappings":";;AAAA;AACA;AAMA,2EACO,IAAKA,aAAAA,iBAAAA,SAAAA,aAAAA,EAAAA;;;;;;AAAAA,IAAAA,OAAAA,aAAAA;AAMX,CAAA,CAAA,EAAA;MA6BYC,6BAAAA,GAA4D;AACrE,IAAA,MAAA;AAAQ,IAAA,UAAA;AAAY,IAAA,QAAA;AAAU,IAAA,eAAA;AAAiB,IAAA,aAAA;AAAe,IAAA,SAAA;AAAW,IAAA,YAAA;AAAc,IAAA;;;;"}

package/dist/cjs/screens/TemplateReference.js

@@ -0,0 +1,19 @@
+'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 referenced template comes from. */ var TemplateReferenceSource = /*#__PURE__*/ function(TemplateReferenceSource) {
+    /** A template the user created in the workspace. */ TemplateReferenceSource["Own"] = "Own";
+    /** A template shipped by a blueprint package, referenced by blueprint name, template name and version range. */ TemplateReferenceSource["Blueprint"] = "Blueprint";
+    return TemplateReferenceSource;
+}({});
+const TemplateReferencePropertyNames = [
+    'source',
+    'id',
+    'blueprint',
+    'version'
+];
+
+exports.TemplateReferencePropertyNames = TemplateReferencePropertyNames;
+exports.TemplateReferenceSource = TemplateReferenceSource;
+//# sourceMappingURL=TemplateReference.js.map

package/dist/cjs/screens/TemplateReference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TemplateReference.js","sources":["../../../screens/TemplateReference.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/** Where a referenced template comes from. */\nexport enum TemplateReferenceSource {\n    /** A template the user created in the workspace. */\n    Own = 'Own',\n    /** A template shipped by a blueprint package, referenced by blueprint name, template name and version range. */\n    Blueprint = 'Blueprint',\n}\n\n/**\n * How a module, feature or slice refers to the template it uses: an own template by name, or a blueprint\n * template by blueprint, name and the version range of the blueprint it was chosen from.\n */\nexport interface TemplateReference {\n    /** Whether the template is the user's own or comes from a blueprint. */\n    source: TemplateReferenceSource;\n    /** The template's name - within the workspace for an own template, within the blueprint for a blueprint template. */\n    id: string;\n    /** The blueprint package name. Present exactly when `source` is {@link TemplateReferenceSource.Blueprint}. */\n    blueprint?: string;\n    /**\n     * The semver range of the blueprint the reference accepts, such as `^1.2.0`. Defaults to the caret range of the\n     * installed blueprint version when a reference is created; absent means any version. Only meaningful for a blueprint reference.\n     */\n    version?: string;\n}\n\nexport const TemplateReferencePropertyNames: (keyof TemplateReference)[] = ['source', 'id', 'blueprint', 'version'];\n"],"names":["TemplateReferenceSource","TemplateReferencePropertyNames"],"mappings":";;AAAA;AACA;AAEA,+CACO,IAAKA,uBAAAA,iBAAAA,SAAAA,uBAAAA,EAAAA;yDAC0C,uBAAA,CAAA,KAAA,CAAA,GAAA,KAAA;qHAE4D,uBAAA,CAAA,WAAA,CAAA,GAAA,WAAA;AAHtGA,IAAAA,OAAAA,uBAAAA;AAKX,CAAA,CAAA,EAAA;MAoBYC,8BAAAA,GAA8D;AAAC,IAAA,QAAA;AAAU,IAAA,IAAA;AAAM,IAAA,WAAA;AAAa,IAAA;;;;"}

package/dist/esm/descriptors/ComponentCategory.d.ts

@@ -0,0 +1,13 @@
+export declare const ComponentCategory: {
+    readonly Navigation: 'Navigation';
+    readonly DataDisplay: 'Data display';
+    readonly Input: 'Input';
+    readonly Actions: 'Actions';
+    readonly Layout: 'Layout';
+    readonly Feedback: 'Feedback';
+    readonly Overlay: 'Overlay';
+    readonly Forms: 'Forms';
+};
+export type ComponentCategory = (typeof ComponentCategory)[keyof typeof ComponentCategory];
+export declare const componentCategories: readonly string[];
+//# sourceMappingURL=ComponentCategory.d.ts.map

package/dist/esm/descriptors/ComponentCategory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentCategory.d.ts","sourceRoot":"","sources":["../../../descriptors/ComponentCategory.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,iBAAiB;aAE1B,UAAU,EAAE,YAAY;aAGxB,WAAW,EAAE,cAAc;aAG3B,KAAK,EAAE,OAAO;aAGd,OAAO,EAAE,SAAS;aAGlB,MAAM,EAAE,QAAQ;aAGhB,QAAQ,EAAE,UAAU;aAGpB,OAAO,EAAE,SAAS;aAGlB,KAAK,EAAE,OAAO;CACR,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC;AAG3F,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAAqC,CAAC"}

package/dist/esm/descriptors/ComponentCategory.js

@@ -0,0 +1,22 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * The categories a component picker groups components under. Every component declares exactly one (rule CMP1).
+ *
+ * The set is open: a package may declare a category of its own, which a validation reports as a warning
+ * ({@link DiagnosticCode.ComponentCategoryUnknown}) rather than refusing, so a picker shows it as a group of its own.
+ * Matching is by the exact words below.
+ */ const ComponentCategory = {
+    /** Moves the user between places: topbar, sidebar, tabs, breadcrumbs, stepper. */ Navigation: 'Navigation',
+    /** Shows data: data table, list, card grid, board, timeline, stat card, chart. */ DataDisplay: 'Data display',
+    /** Takes a value from the user: text field, select, date picker, tag input, lookup. */ Input: 'Input',
+    /** Starts something: button, toolbar, menu, command bar. */ Actions: 'Actions',
+    /** Arranges other components: stack, grid, split pane, card, section. */ Layout: 'Layout',
+    /** Tells the user what happened or is happening: alert, toast, empty state, progress. */ Feedback: 'Feedback',
+    /** Appears over the page: dialog, side sheet, popover. */ Overlay: 'Overlay',
+    /** Collects a command's input: form, wizard, field group. */ Forms: 'Forms'
+};
+/** Every category this model defines, in the order a picker lists them. */ const componentCategories = Object.values(ComponentCategory);
+
+export { ComponentCategory, componentCategories };
+//# sourceMappingURL=ComponentCategory.js.map

package/dist/esm/descriptors/ComponentCategory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentCategory.js","sources":["../../../descriptors/ComponentCategory.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 categories a component picker groups components under. Every component declares exactly one (rule CMP1).\n *\n * The set is open: a package may declare a category of its own, which a validation reports as a warning\n * ({@link DiagnosticCode.ComponentCategoryUnknown}) rather than refusing, so a picker shows it as a group of its own.\n * Matching is by the exact words below.\n */\nexport const ComponentCategory = {\n    /** Moves the user between places: topbar, sidebar, tabs, breadcrumbs, stepper. */\n    Navigation: 'Navigation',\n\n    /** Shows data: data table, list, card grid, board, timeline, stat card, chart. */\n    DataDisplay: 'Data display',\n\n    /** Takes a value from the user: text field, select, date picker, tag input, lookup. */\n    Input: 'Input',\n\n    /** Starts something: button, toolbar, menu, command bar. */\n    Actions: 'Actions',\n\n    /** Arranges other components: stack, grid, split pane, card, section. */\n    Layout: 'Layout',\n\n    /** Tells the user what happened or is happening: alert, toast, empty state, progress. */\n    Feedback: 'Feedback',\n\n    /** Appears over the page: dialog, side sheet, popover. */\n    Overlay: 'Overlay',\n\n    /** Collects a command's input: form, wizard, field group. */\n    Forms: 'Forms',\n} as const;\n\nexport type ComponentCategory = (typeof ComponentCategory)[keyof typeof ComponentCategory];\n\n/** Every category this model defines, in the order a picker lists them. */\nexport const componentCategories: readonly string[] = Object.values(ComponentCategory);\n"],"names":["ComponentCategory","Navigation","DataDisplay","Input","Actions","Layout","Feedback","Overlay","Forms","componentCategories","Object","values"],"mappings":"AAAA;AACA;AAEA;;;;;;UAOaA,iBAAAA,GAAoB;AAC7B,uFACAC,UAAAA,EAAY,YAAA;AAEZ,uFACAC,WAAAA,EAAa,cAAA;AAEb,4FACAC,KAAAA,EAAO,OAAA;AAEP,iEACAC,OAAAA,EAAS,SAAA;AAET,8EACAC,MAAAA,EAAQ,QAAA;AAER,8FACAC,QAAAA,EAAU,UAAA;AAEV,+DACAC,OAAAA,EAAS,SAAA;AAET,kEACAC,KAAAA,EAAO;AACX;AAIA,4EACO,MAAMC,sBAAyCC,MAAAA,CAAOC,MAAM,CAACX,iBAAAA;;"}

package/dist/esm/descriptors/ComponentDescriptor.d.ts

@@ -1,9 +1,16 @@
+import { IconReference } from '../icons';
+import { ComponentDesignModeDescriptor } from './ComponentDesignModeDescriptor';
 import { DesignTimeActionDescriptor } from './DesignTimeActionDescriptor';
 import { PropertyDescriptor } from './PropertyDescriptor';
 export interface ComponentDescriptor {
     component: string;
     displayName?: string;
     description?: string;
+    category?: string;
+    icon?: IconReference;
+    badge?: string;
+    keywords?: string[];
+    designMode?: ComponentDesignModeDescriptor;
     editorKind?: string;
     properties: PropertyDescriptor[];
     actions?: DesignTimeActionDescriptor[];

package/dist/esm/descriptors/ComponentDescriptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ComponentDescriptor.d.ts","sourceRoot":"","sources":["../../../descriptors/ComponentDescriptor.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAS1D,MAAM,WAAW,mBAAmB;IAKhC,SAAS,EAAE,MAAM,CAAC;IAGlB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,UAAU,EAAE,kBAAkB,EAAE,CAAC;IAGjC,OAAO,CAAC,EAAE,0BAA0B,EAAE,CAAC;IAGvC,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,eAAO,MAAM,gCAAgC,EAAE,CAAC,MAAM,mBAAmB,CAAC,EAEzE,CAAC"}
+{"version":3,"file":"ComponentDescriptor.d.ts","sourceRoot":"","sources":["../../../descriptors/ComponentDescriptor.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAS1D,MAAM,WAAW,mBAAmB;IAKhC,SAAS,EAAE,MAAM,CAAC;IAGlB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,WAAW,CAAC,EAAE,MAAM,CAAC;IAOrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,IAAI,CAAC,EAAE,aAAa,CAAC;IAGrB,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAGpB,UAAU,CAAC,EAAE,6BAA6B,CAAC;IAG3C,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,UAAU,EAAE,kBAAkB,EAAE,CAAC;IAGjC,OAAO,CAAC,EAAE,0BAA0B,EAAE,CAAC;IAGvC,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,eAAO,MAAM,gCAAgC,EAAE,CAAC,MAAM,mBAAmB,CAAC,EAEzE,CAAC"}

package/dist/esm/descriptors/ComponentDescriptor.js

@@ -4,6 +4,11 @@ const ComponentDescriptorPropertyNames = [
     'component',
     'displayName',
     'description',
+    'category',
+    'icon',
+    'badge',
+    'keywords',
+    'designMode',
     'editorKind',
     'properties',
     'actions',

package/dist/esm/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 { 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;;;"}
+{"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 { IconReference } from '../icons';\nimport { ComponentDesignModeDescriptor } from './ComponentDesignModeDescriptor';\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    /**\n     * The group a component picker lists the component under (rule CMP1: every component declares one). One of\n     * {@link ComponentCategory}, or a category the package adds. Optional in the type so a descriptor can be built up in steps;\n     * `validateComponentDescriptors` reports a component that ends without one.\n     */\n    category?: string;\n\n    /** The icon a picker shows for the component. */\n    icon?: IconReference;\n\n    /** Two letters a picker shows when it has no icon to draw. Absent means derive them from `displayName` (`componentBadge`). */\n    badge?: string;\n\n    /** Words a picker's filter matches besides the name and the category - \"grid\" for a data table. */\n    keywords?: string[];\n\n    /** How the component is edited directly on the design surface, as data. */\n    designMode?: ComponentDesignModeDescriptor;\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', 'category', 'icon', 'badge', 'keywords', 'designMode', 'editorKind', 'properties', 'actions', 'previewKind', 'propertyDisplayKind',\n];\n"],"names":["ComponentDescriptorPropertyNames"],"mappings":"AAAA;AACA;MA4DaA,gCAAAA,GAAkE;AAC3E,IAAA,WAAA;AAAa,IAAA,aAAA;AAAe,IAAA,aAAA;AAAe,IAAA,UAAA;AAAY,IAAA,MAAA;AAAQ,IAAA,OAAA;AAAS,IAAA,UAAA;AAAY,IAAA,YAAA;AAAc,IAAA,YAAA;AAAc,IAAA,YAAA;AAAc,IAAA,SAAA;AAAW,IAAA,aAAA;AAAe,IAAA;;;"}

package/dist/esm/descriptors/ComponentDesignModeDescriptor.d.ts

@@ -0,0 +1,24 @@
+import { IconReference } from '../icons';
+export interface DesignModeAddAction {
+    id: string;
+    label: string;
+    icon?: IconReference;
+    collectionPath?: string;
+}
+export interface DesignModeItemAction {
+    id: string;
+    icon: IconReference;
+    title: string;
+    compact?: boolean;
+    availability?: string;
+    readOnlyReason?: string;
+}
+export interface ComponentDesignModeDescriptor {
+    itemsPath?: string;
+    addActions: DesignModeAddAction[];
+    itemToolbar: DesignModeItemAction[];
+}
+export declare const DesignModeAddActionPropertyNames: (keyof DesignModeAddAction)[];
+export declare const DesignModeItemActionPropertyNames: (keyof DesignModeItemAction)[];
+export declare const ComponentDesignModeDescriptorPropertyNames: (keyof ComponentDesignModeDescriptor)[];
+//# sourceMappingURL=ComponentDesignModeDescriptor.d.ts.map

package/dist/esm/descriptors/ComponentDesignModeDescriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentDesignModeDescriptor.d.ts","sourceRoot":"","sources":["../../../descriptors/ComponentDesignModeDescriptor.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAMzC,MAAM,WAAW,mBAAmB;IAEhC,EAAE,EAAE,MAAM,CAAC;IAGX,KAAK,EAAE,MAAM,CAAC;IAGd,IAAI,CAAC,EAAE,aAAa,CAAC;IAOrB,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAQD,MAAM,WAAW,oBAAoB;IAEjC,EAAE,EAAE,MAAM,CAAC;IAGX,IAAI,EAAE,aAAa,CAAC;IAGpB,KAAK,EAAE,MAAM,CAAC;IAGd,OAAO,CAAC,EAAE,OAAO,CAAC;IAGlB,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAQD,MAAM,WAAW,6BAA6B;IAK1C,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,UAAU,EAAE,mBAAmB,EAAE,CAAC;IAGlC,WAAW,EAAE,oBAAoB,EAAE,CAAC;CACvC;AAED,eAAO,MAAM,gCAAgC,EAAE,CAAC,MAAM,mBAAmB,CAAC,EAA8C,CAAC;AACzH,eAAO,MAAM,iCAAiC,EAAE,CAAC,MAAM,oBAAoB,CAAC,EAAyE,CAAC;AACtJ,eAAO,MAAM,0CAA0C,EAAE,CAAC,MAAM,6BAA6B,CAAC,EAA+C,CAAC"}

package/dist/esm/descriptors/ComponentDesignModeDescriptor.js

@@ -0,0 +1,24 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+const DesignModeAddActionPropertyNames = [
+    'id',
+    'label',
+    'icon',
+    'collectionPath'
+];
+const DesignModeItemActionPropertyNames = [
+    'id',
+    'icon',
+    'title',
+    'compact',
+    'availability',
+    'readOnlyReason'
+];
+const ComponentDesignModeDescriptorPropertyNames = [
+    'itemsPath',
+    'addActions',
+    'itemToolbar'
+];
+
+export { ComponentDesignModeDescriptorPropertyNames, DesignModeAddActionPropertyNames, DesignModeItemActionPropertyNames };
+//# sourceMappingURL=ComponentDesignModeDescriptor.js.map

package/dist/esm/descriptors/ComponentDesignModeDescriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentDesignModeDescriptor.js","sources":["../../../descriptors/ComponentDesignModeDescriptor.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 { IconReference } from '../icons';\n\n/**\n * An affordance a designer shows on the design surface to add an item to a component (the \"+ Add tab\" button of a tab strip,\n * the \"Add item\" of a toolbar).\n */\nexport interface DesignModeAddAction {\n    /** Stable identity, unique within the component. */\n    id: string;\n\n    /** The label the designer shows. */\n    label: string;\n\n    /** The icon the designer shows next to it. */\n    icon?: IconReference;\n\n    /**\n     * The `Collection` property of the component the new item is added to - the add is the ordinary `AddCollectionItem` edit. Absent,\n     * the item is added to the component's own items, which the host resolves (the navigation region of a topbar, the children of a\n     * toolbar).\n     */\n    collectionPath?: string;\n}\n\n/**\n * One button of the toolbar a designer shows over a selected item of a component.\n *\n * `availability` and `readOnlyReason` are rule *names*, interpreted by the package's design-time bundle exactly like\n * {@link DesignTimeActionDescriptor.availability}. The model carries no functions.\n */\nexport interface DesignModeItemAction {\n    /** Stable identity, unique within the component. */\n    id: string;\n\n    /** The icon of the button. */\n    icon: IconReference;\n\n    /** The tooltip and accessible name of the button. */\n    title: string;\n\n    /** The button is shown without its title, in a tight row. */\n    compact?: boolean;\n\n    /** Names the rule that decides whether the button is shown and enabled for an item. Absent means always. */\n    availability?: string;\n\n    /** Names the rule that says why a read-only (inherited) item hides or disables the button. */\n    readOnlyReason?: string;\n}\n\n/**\n * How a component is edited directly on the design surface: where its items are and which affordances the designer offers for\n * them. Plain data - a Visual Studio-style designer reads it without loading the component. Every edit it causes is a normal model edit\n * (`AddCollectionItem`, `RemoveCollectionItem`, `ReorderCollectionItems`, `EditCollectionItem`), so undo, redo and the dirty state\n * need nothing of their own.\n */\nexport interface ComponentDesignModeDescriptor {\n    /**\n     * The `Collection` property whose rows are the component's items. Absent when the items are not a property of the\n     * component but something the host resolves - the navigation items of a topbar, the children of a toolbar.\n     */\n    itemsPath?: string;\n\n    /** The \"add\" affordances. */\n    addActions: DesignModeAddAction[];\n\n    /** The buttons over a selected item. */\n    itemToolbar: DesignModeItemAction[];\n}\n\nexport const DesignModeAddActionPropertyNames: (keyof DesignModeAddAction)[] = ['id', 'label', 'icon', 'collectionPath'];\nexport const DesignModeItemActionPropertyNames: (keyof DesignModeItemAction)[] = ['id', 'icon', 'title', 'compact', 'availability', 'readOnlyReason'];\nexport const ComponentDesignModeDescriptorPropertyNames: (keyof ComponentDesignModeDescriptor)[] = ['itemsPath', 'addActions', 'itemToolbar'];\n"],"names":["DesignModeAddActionPropertyNames","DesignModeItemActionPropertyNames","ComponentDesignModeDescriptorPropertyNames"],"mappings":"AAAA;AACA;MAwEaA,gCAAAA,GAAkE;AAAC,IAAA,IAAA;AAAM,IAAA,OAAA;AAAS,IAAA,MAAA;AAAQ,IAAA;;MAC1FC,iCAAAA,GAAoE;AAAC,IAAA,IAAA;AAAM,IAAA,MAAA;AAAQ,IAAA,OAAA;AAAS,IAAA,SAAA;AAAW,IAAA,cAAA;AAAgB,IAAA;;MACvHC,0CAAAA,GAAsF;AAAC,IAAA,WAAA;AAAa,IAAA,YAAA;AAAc,IAAA;;;"}

package/dist/esm/descriptors/PropertyDescriptor.d.ts

@@ -2,6 +2,7 @@ import { BindingMode, BindingSourceKind } from '../common';
 import { CollectionItemDescriptor } from './CollectionItemDescriptor';
 import { PropertyChoice } from './PropertyChoice';
 import { PropertyConstraints } from './PropertyConstraints';
+import { PropertyEditorOptions } from './PropertyEditorOptions';
 import { PropertyValueType } from './PropertyValueType';
 export interface PropertyDescriptor {
     path: string;
@@ -12,6 +13,7 @@ export interface PropertyDescriptor {
     default?: unknown;
     constraints?: PropertyConstraints;
     editorKind?: string;
+    editorOptions?: PropertyEditorOptions;
     description?: string;
     item?: CollectionItemDescriptor;
     properties?: PropertyDescriptor[];

package/dist/esm/descriptors/PropertyDescriptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PropertyDescriptor.d.ts","sourceRoot":"","sources":["../../../descriptors/PropertyDescriptor.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAOxD,MAAM,WAAW,kBAAkB;IAK/B,IAAI,EAAE,MAAM,CAAC;IAGb,KAAK,EAAE,MAAM,CAAC;IAGd,KAAK,EAAE,MAAM,CAAC;IAEd,SAAS,EAAE,iBAAiB,CAAC;IAG7B,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAG3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAMlC,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,IAAI,CAAC,EAAE,wBAAwB,CAAC;IAOhC,UAAU,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAOlC,IAAI,CAAC,EAAE,OAAO,CAAC;IAGf,QAAQ,CAAC,EAAE,OAAO,CAAC;IAGnB,MAAM,CAAC,EAAE,OAAO,CAAC;IAGjB,oBAAoB,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAG3C,WAAW,CAAC,EAAE,WAAW,CAAC;CAC7B;AAED,eAAO,MAAM,+BAA+B,EAAE,CAAC,MAAM,kBAAkB,CAAC,EAGvE,CAAC"}
+{"version":3,"file":"PropertyDescriptor.d.ts","sourceRoot":"","sources":["../../../descriptors/PropertyDescriptor.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAOxD,MAAM,WAAW,kBAAkB;IAK/B,IAAI,EAAE,MAAM,CAAC;IAGb,KAAK,EAAE,MAAM,CAAC;IAGd,KAAK,EAAE,MAAM,CAAC;IAEd,SAAS,EAAE,iBAAiB,CAAC;IAG7B,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAG3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAMlC,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,aAAa,CAAC,EAAE,qBAAqB,CAAC;IAGtC,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,IAAI,CAAC,EAAE,wBAAwB,CAAC;IAOhC,UAAU,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAOlC,IAAI,CAAC,EAAE,OAAO,CAAC;IAGf,QAAQ,CAAC,EAAE,OAAO,CAAC;IAGnB,MAAM,CAAC,EAAE,OAAO,CAAC;IAGjB,oBAAoB,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAG3C,WAAW,CAAC,EAAE,WAAW,CAAC;CAC7B;AAED,eAAO,MAAM,+BAA+B,EAAE,CAAC,MAAM,kBAAkB,CAAC,EAGvE,CAAC"}

package/dist/esm/descriptors/PropertyDescriptor.js

@@ -9,6 +9,7 @@ const PropertyDescriptorPropertyNames = [
     'default',
     'constraints',
     'editorKind',
+    'editorOptions',
     'description',
     'item',
     'properties',

package/dist/esm/descriptors/PropertyDescriptor.js.map

@@ -1 +1 @@
-{"version":3,"file":"PropertyDescriptor.js","sources":["../../../descriptors/PropertyDescriptor.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, BindingSourceKind } from '../common';\nimport { CollectionItemDescriptor } from './CollectionItemDescriptor';\nimport { PropertyChoice } from './PropertyChoice';\nimport { PropertyConstraints } from './PropertyConstraints';\nimport { PropertyValueType } from './PropertyValueType';\n\n/**\n * Describes one editable property of a node: where it lives, what it is called, what it may hold and how a host\n * should edit it. A descriptor is plain data, so packages ship them and Studio reads them without loading a\n * component.\n */\nexport interface PropertyDescriptor {\n    /**\n     * Where the value lives. For an `ExternalComponent` it is a key (or dotted key path) in the element's\n     * `properties` bag; for a model-native node such as a flow container it is the node's own property name.\n     */\n    path: string;\n\n    /** The label an editor shows. */\n    label: string;\n\n    /** The editor section the property belongs to. */\n    group: string;\n\n    valueType: PropertyValueType;\n\n    /** The allowed values of an `Enum` property. */\n    choices?: PropertyChoice[];\n\n    /** The value in effect when none is set. */\n    default?: unknown;\n\n    constraints?: PropertyConstraints;\n\n    /**\n     * Names a specialised editor. A host maps the name to its own editor - an icon picker, a query binder - and\n     * falls back to the default editor for `valueType` when it does not know the name.\n     */\n    editorKind?: string;\n\n    /** A sentence of help for the editor. */\n    description?: string;\n\n    /** Describes the items of a `Collection` property. Required when `valueType` is `Collection`. */\n    item?: CollectionItemDescriptor;\n\n    /**\n     * Describes the fields of an `Object` property. A field's `path` is a single name relative to the object, and\n     * a field may itself be an `Object` or a `Collection`, so a structured value of any depth can be described.\n     * Without it an `Object` value is only editable through a specialised `editorKind`.\n     */\n    properties?: PropertyDescriptor[];\n\n    /**\n     * An `Object` property's value may carry fields `properties` does not describe. They are kept as they are and never\n     * edited. Without it a field the descriptor does not describe is refused. Use it when `properties` lists the fields an\n     * editor offers but the stored value may legitimately have more - a chart dataset, a record read from a sample.\n     */\n    open?: boolean;\n\n    /** The value is shown but never edited. */\n    readOnly?: boolean;\n\n    /** This property is emitted by the component and may be bound by other elements. */\n    output?: boolean;\n\n    /** Which binding source kinds may be assigned to this property. */\n    acceptedBindingKinds?: BindingSourceKind[];\n\n    /** The strongest binding mode the property supports. */\n    bindingMode?: BindingMode;\n}\n\nexport const PropertyDescriptorPropertyNames: (keyof PropertyDescriptor)[] = [\n    'path', 'label', 'group', 'valueType', 'choices', 'default', 'constraints', 'editorKind', 'description', 'item', 'properties', 'open', 'readOnly',\n    'output', 'acceptedBindingKinds', 'bindingMode',\n];\n"],"names":["PropertyDescriptorPropertyNames"],"mappings":"AAAA;AACA;MA2EaA,+BAAAA,GAAgE;AACzE,IAAA,MAAA;AAAQ,IAAA,OAAA;AAAS,IAAA,OAAA;AAAS,IAAA,WAAA;AAAa,IAAA,SAAA;AAAW,IAAA,SAAA;AAAW,IAAA,aAAA;AAAe,IAAA,YAAA;AAAc,IAAA,aAAA;AAAe,IAAA,MAAA;AAAQ,IAAA,YAAA;AAAc,IAAA,MAAA;AAAQ,IAAA,UAAA;AACvI,IAAA,QAAA;AAAU,IAAA,sBAAA;AAAwB,IAAA;;;"}
+{"version":3,"file":"PropertyDescriptor.js","sources":["../../../descriptors/PropertyDescriptor.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, BindingSourceKind } from '../common';\nimport { CollectionItemDescriptor } from './CollectionItemDescriptor';\nimport { PropertyChoice } from './PropertyChoice';\nimport { PropertyConstraints } from './PropertyConstraints';\nimport { PropertyEditorOptions } from './PropertyEditorOptions';\nimport { PropertyValueType } from './PropertyValueType';\n\n/**\n * Describes one editable property of a node: where it lives, what it is called, what it may hold and how a host\n * should edit it. A descriptor is plain data, so packages ship them and Studio reads them without loading a\n * component.\n */\nexport interface PropertyDescriptor {\n    /**\n     * Where the value lives. For an `ExternalComponent` it is a key (or dotted key path) in the element's\n     * `properties` bag; for a model-native node such as a flow container it is the node's own property name.\n     */\n    path: string;\n\n    /** The label an editor shows. */\n    label: string;\n\n    /** The editor section the property belongs to. */\n    group: string;\n\n    valueType: PropertyValueType;\n\n    /** The allowed values of an `Enum` property. */\n    choices?: PropertyChoice[];\n\n    /** The value in effect when none is set. */\n    default?: unknown;\n\n    constraints?: PropertyConstraints;\n\n    /**\n     * Names a specialised editor. A host maps the name to its own editor - an icon picker, a query binder - and\n     * falls back to the default editor for `valueType` when it does not know the name.\n     */\n    editorKind?: string;\n\n    /** The parameters of the named editor - multi-line, placeholder, unit, step, slice kinds, the reference filter. */\n    editorOptions?: PropertyEditorOptions;\n\n    /** A sentence of help for the editor. */\n    description?: string;\n\n    /** Describes the items of a `Collection` property. Required when `valueType` is `Collection`. */\n    item?: CollectionItemDescriptor;\n\n    /**\n     * Describes the fields of an `Object` property. A field's `path` is a single name relative to the object, and\n     * a field may itself be an `Object` or a `Collection`, so a structured value of any depth can be described.\n     * Without it an `Object` value is only editable through a specialised `editorKind`.\n     */\n    properties?: PropertyDescriptor[];\n\n    /**\n     * An `Object` property's value may carry fields `properties` does not describe. They are kept as they are and never\n     * edited. Without it a field the descriptor does not describe is refused. Use it when `properties` lists the fields an\n     * editor offers but the stored value may legitimately have more - a chart dataset, a record read from a sample.\n     */\n    open?: boolean;\n\n    /** The value is shown but never edited. */\n    readOnly?: boolean;\n\n    /** This property is emitted by the component and may be bound by other elements. */\n    output?: boolean;\n\n    /** Which binding source kinds may be assigned to this property. */\n    acceptedBindingKinds?: BindingSourceKind[];\n\n    /** The strongest binding mode the property supports. */\n    bindingMode?: BindingMode;\n}\n\nexport const PropertyDescriptorPropertyNames: (keyof PropertyDescriptor)[] = [\n    'path', 'label', 'group', 'valueType', 'choices', 'default', 'constraints', 'editorKind', 'editorOptions', 'description', 'item', 'properties', 'open', 'readOnly',\n    'output', 'acceptedBindingKinds', 'bindingMode',\n];\n"],"names":["PropertyDescriptorPropertyNames"],"mappings":"AAAA;AACA;MA+EaA,+BAAAA,GAAgE;AACzE,IAAA,MAAA;AAAQ,IAAA,OAAA;AAAS,IAAA,OAAA;AAAS,IAAA,WAAA;AAAa,IAAA,SAAA;AAAW,IAAA,SAAA;AAAW,IAAA,aAAA;AAAe,IAAA,YAAA;AAAc,IAAA,eAAA;AAAiB,IAAA,aAAA;AAAe,IAAA,MAAA;AAAQ,IAAA,YAAA;AAAc,IAAA,MAAA;AAAQ,IAAA,UAAA;AACxJ,IAAA,QAAA;AAAU,IAAA,sBAAA;AAAwB,IAAA;;;"}

package/dist/esm/descriptors/PropertyEditorKind.d.ts

@@ -4,6 +4,23 @@ export declare const PropertyEditorKind: {
     readonly StringOrList: 'stringOrList';
     readonly Scalar: 'scalar';
     readonly StringMap: 'stringMap';
+    readonly Text: 'text';
+    readonly Number: 'number';
+    readonly Boolean: 'boolean';
+    readonly Enum: 'enum';
+    readonly Select: 'select';
+    readonly Color: 'color';
+    readonly Icon: 'icon';
+    readonly List: 'list';
+    readonly Reference: 'reference';
+    readonly NavigationTarget: 'navigationTarget';
+    readonly RenderingSlot: 'renderingSlot';
+    readonly Slice: 'slice';
+    readonly InheritanceMode: 'inheritanceMode';
+    readonly Template: 'template';
+    readonly SampleData: 'sampleData';
+    readonly Field: 'field';
+    readonly ColumnList: 'columnList';
 };
 export type PropertyEditorKind = (typeof PropertyEditorKind)[keyof typeof PropertyEditorKind];
 //# sourceMappingURL=PropertyEditorKind.d.ts.map

package/dist/esm/descriptors/PropertyEditorKind.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PropertyEditorKind.d.ts","sourceRoot":"","sources":["../../../descriptors/PropertyEditorKind.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,kBAAkB;aAE3B,UAAU,EAAE,YAAY;aAGxB,UAAU,EAAE,YAAY;aAGxB,YAAY,EAAE,cAAc;aAG5B,MAAM,EAAE,QAAQ;aAGhB,SAAS,EAAE,WAAW;CAChB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC"}
+{"version":3,"file":"PropertyEditorKind.d.ts","sourceRoot":"","sources":["../../../descriptors/PropertyEditorKind.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,kBAAkB;aAE3B,UAAU,EAAE,YAAY;aAGxB,UAAU,EAAE,YAAY;aAGxB,YAAY,EAAE,cAAc;aAG5B,MAAM,EAAE,QAAQ;aAGhB,SAAS,EAAE,WAAW;aAGtB,IAAI,EAAE,MAAM;aAGZ,MAAM,EAAE,QAAQ;aAGhB,OAAO,EAAE,SAAS;aAGlB,IAAI,EAAE,MAAM;aAGZ,MAAM,EAAE,QAAQ;aAGhB,KAAK,EAAE,OAAO;aAGd,IAAI,EAAE,MAAM;aAGZ,IAAI,EAAE,MAAM;aAGZ,SAAS,EAAE,WAAW;aAGtB,gBAAgB,EAAE,kBAAkB;aAGpC,aAAa,EAAE,eAAe;aAG9B,KAAK,EAAE,OAAO;aAGd,eAAe,EAAE,iBAAiB;aAGlC,QAAQ,EAAE,UAAU;aAGpB,UAAU,EAAE,YAAY;aAGxB,KAAK,EAAE,OAAO;aAGd,UAAU,EAAE,YAAY;CAClB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/esm/descriptors/PropertyEditorKind.js

@@ -1,7 +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 editor kinds for values that have no fields to describe, so a host can edit them without asking for JSON text.
+ * The editor ids Studio's property-editor registry resolves (spec section 8). A property names one in `editorKind`; a host that
+ * does not know the id falls back to the default editor for `valueType`, and a package may name ids of its own (they are strings).
+ * This vocabulary defines only the ids and, in {@link PropertyEditorOptions}, their parameters - the editors themselves belong to the host.
+ *
+ * It starts with the editors for values that have no fields to describe, so a host can edit them without asking for JSON text.
  *
  * A list of plain values is a `json` property - Scene keeps the array exactly as authored - whose `editorKind` says what
  * its entries are. A record whose keys are the author's own (a row of data, keyed by column) is an `object` property
@@ -11,7 +15,24 @@
     /** An ordered list of numbers. */ NumberList: 'numberList',
     /** One word, or an ordered list of words: a chart colour is one colour for the series or one for each point. */ StringOrList: 'stringOrList',
     /** One word, number or flag - a value whose type the author chooses, such as the selected value of a control whose options carry any of them. */ Scalar: 'scalar',
-    /** A record of words, numbers and flags under names the author chooses. */ StringMap: 'stringMap'
+    /** A record of words, numbers and flags under names the author chooses. */ StringMap: 'stringMap',
+    /** A single line of text; `editorOptions.multiline` makes it a box, `editorOptions.placeholder` hints it. */ Text: 'text',
+    /** A number; `constraints.minimum`/`maximum` and `editorOptions.step`/`unit` shape it. */ Number: 'number',
+    /** A switch with a label. */ Boolean: 'boolean',
+    /** Up to four choices as segmented chips. */ Enum: 'enum',
+    /** Any number of choices as a dropdown with a filter. */ Select: 'select',
+    /** A theme token first, a custom colour second. */ Color: 'color',
+    /** An icon from a searchable grid. */ Icon: 'icon',
+    /** A list of simple items: add, remove, reorder rows. */ List: 'list',
+    /** The id of another model element, from a searchable dropdown restricted by `editorOptions.reference`. */ Reference: 'reference',
+    /** The target of a navigation item: a Module > Feature tree, shown as a breadcrumb when closed. */ NavigationTarget: 'navigationTarget',
+    /** One of the slots of the effective template, with a mini diagram of its position. */ RenderingSlot: 'renderingSlot',
+    /** A slice from the slice tree; `editorOptions.kinds` (for example `['StateChange']`) filters, the rest are listed disabled with a reason. */ Slice: 'slice',
+    /** How a region relates to what it inherits: `inherit`, `extend` or `override`, as a three-way control. */ InheritanceMode: 'inheritanceMode',
+    /** A reference to a template, chosen through the template picker. */ Template: 'template',
+    /** A reference to a sample data pack. */ SampleData: 'sampleData',
+    /** A field of the shape a component is bound to, typed by `editorOptions.fieldKinds`. */ Field: 'field',
+    /** The columns of a table: rows of `{ field, header, width, align, format }`. */ ColumnList: 'columnList'
 };
 
 export { PropertyEditorKind };

package/dist/esm/descriptors/PropertyEditorKind.js.map

@@ -1 +1 @@
-{"version":3,"file":"PropertyEditorKind.js","sources":["../../../descriptors/PropertyEditorKind.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 editor kinds for values that have no fields to describe, so a host can edit them without asking for JSON text.\n *\n * A list of plain values is a `json` property - Scene keeps the array exactly as authored - whose `editorKind` says what\n * its entries are. A record whose keys are the author's own (a row of data, keyed by column) is an `object` property\n * with no `properties` and the `stringMap` kind. A host that does not know a kind falls back to its default editor.\n */\nexport const PropertyEditorKind = {\n    /** An ordered list of words. */\n    StringList: 'stringList',\n\n    /** An ordered list of numbers. */\n    NumberList: 'numberList',\n\n    /** One word, or an ordered list of words: a chart colour is one colour for the series or one for each point. */\n    StringOrList: 'stringOrList',\n\n    /** One word, number or flag - a value whose type the author chooses, such as the selected value of a control whose options carry any of them. */\n    Scalar: 'scalar',\n\n    /** A record of words, numbers and flags under names the author chooses. */\n    StringMap: 'stringMap',\n} as const;\n\nexport type PropertyEditorKind = (typeof PropertyEditorKind)[keyof typeof PropertyEditorKind];\n"],"names":["PropertyEditorKind","StringList","NumberList","StringOrList","Scalar","StringMap"],"mappings":"AAAA;AACA;AAEA;;;;;;UAOaA,kBAAAA,GAAqB;AAC9B,qCACAC,UAAAA,EAAY,YAAA;AAEZ,uCACAC,UAAAA,EAAY,YAAA;AAEZ,qHACAC,YAAAA,EAAc,cAAA;AAEd,sJACAC,MAAAA,EAAQ,QAAA;AAER,gFACAC,SAAAA,EAAW;AACf;;"}
+{"version":3,"file":"PropertyEditorKind.js","sources":["../../../descriptors/PropertyEditorKind.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 editor ids Studio's property-editor registry resolves (spec section 8). A property names one in `editorKind`; a host that\n * does not know the id falls back to the default editor for `valueType`, and a package may name ids of its own (they are strings).\n * This vocabulary defines only the ids and, in {@link PropertyEditorOptions}, their parameters - the editors themselves belong to the host.\n *\n * It starts with the editors for values that have no fields to describe, so a host can edit them without asking for JSON text.\n *\n * A list of plain values is a `json` property - Scene keeps the array exactly as authored - whose `editorKind` says what\n * its entries are. A record whose keys are the author's own (a row of data, keyed by column) is an `object` property\n * with no `properties` and the `stringMap` kind. A host that does not know a kind falls back to its default editor.\n */\nexport const PropertyEditorKind = {\n    /** An ordered list of words. */\n    StringList: 'stringList',\n\n    /** An ordered list of numbers. */\n    NumberList: 'numberList',\n\n    /** One word, or an ordered list of words: a chart colour is one colour for the series or one for each point. */\n    StringOrList: 'stringOrList',\n\n    /** One word, number or flag - a value whose type the author chooses, such as the selected value of a control whose options carry any of them. */\n    Scalar: 'scalar',\n\n    /** A record of words, numbers and flags under names the author chooses. */\n    StringMap: 'stringMap',\n\n    /** A single line of text; `editorOptions.multiline` makes it a box, `editorOptions.placeholder` hints it. */\n    Text: 'text',\n\n    /** A number; `constraints.minimum`/`maximum` and `editorOptions.step`/`unit` shape it. */\n    Number: 'number',\n\n    /** A switch with a label. */\n    Boolean: 'boolean',\n\n    /** Up to four choices as segmented chips. */\n    Enum: 'enum',\n\n    /** Any number of choices as a dropdown with a filter. */\n    Select: 'select',\n\n    /** A theme token first, a custom colour second. */\n    Color: 'color',\n\n    /** An icon from a searchable grid. */\n    Icon: 'icon',\n\n    /** A list of simple items: add, remove, reorder rows. */\n    List: 'list',\n\n    /** The id of another model element, from a searchable dropdown restricted by `editorOptions.reference`. */\n    Reference: 'reference',\n\n    /** The target of a navigation item: a Module > Feature tree, shown as a breadcrumb when closed. */\n    NavigationTarget: 'navigationTarget',\n\n    /** One of the slots of the effective template, with a mini diagram of its position. */\n    RenderingSlot: 'renderingSlot',\n\n    /** A slice from the slice tree; `editorOptions.kinds` (for example `['StateChange']`) filters, the rest are listed disabled with a reason. */\n    Slice: 'slice',\n\n    /** How a region relates to what it inherits: `inherit`, `extend` or `override`, as a three-way control. */\n    InheritanceMode: 'inheritanceMode',\n\n    /** A reference to a template, chosen through the template picker. */\n    Template: 'template',\n\n    /** A reference to a sample data pack. */\n    SampleData: 'sampleData',\n\n    /** A field of the shape a component is bound to, typed by `editorOptions.fieldKinds`. */\n    Field: 'field',\n\n    /** The columns of a table: rows of `{ field, header, width, align, format }`. */\n    ColumnList: 'columnList',\n} as const;\n\nexport type PropertyEditorKind = (typeof PropertyEditorKind)[keyof typeof PropertyEditorKind];\n"],"names":["PropertyEditorKind","StringList","NumberList","StringOrList","Scalar","StringMap","Text","Number","Boolean","Enum","Select","Color","Icon","List","Reference","NavigationTarget","RenderingSlot","Slice","InheritanceMode","Template","SampleData","Field","ColumnList"],"mappings":"AAAA;AACA;AAEA;;;;;;;;;;UAWaA,kBAAAA,GAAqB;AAC9B,qCACAC,UAAAA,EAAY,YAAA;AAEZ,uCACAC,UAAAA,EAAY,YAAA;AAEZ,qHACAC,YAAAA,EAAc,cAAA;AAEd,sJACAC,MAAAA,EAAQ,QAAA;AAER,gFACAC,SAAAA,EAAW,WAAA;AAEX,kHACAC,IAAAA,EAAM,MAAA;AAEN,+FACAC,MAAAA,EAAQ,QAAA;AAER,kCACAC,OAAAA,EAAS,SAAA;AAET,kDACAC,IAAAA,EAAM,MAAA;AAEN,8DACAC,MAAAA,EAAQ,QAAA;AAER,wDACAC,KAAAA,EAAO,OAAA;AAEP,2CACAC,IAAAA,EAAM,MAAA;AAEN,8DACAC,IAAAA,EAAM,MAAA;AAEN,gHACAC,SAAAA,EAAW,WAAA;AAEX,wGACAC,gBAAAA,EAAkB,kBAAA;AAElB,4FACAC,aAAAA,EAAe,eAAA;AAEf,mJACAC,KAAAA,EAAO,OAAA;AAEP,gHACAC,eAAAA,EAAiB,iBAAA;AAEjB,0EACAC,QAAAA,EAAU,UAAA;AAEV,8CACAC,UAAAA,EAAY,YAAA;AAEZ,8FACAC,KAAAA,EAAO,OAAA;AAEP,sFACAC,UAAAA,EAAY;AAChB;;"}

package/dist/esm/descriptors/PropertyEditorOptions.d.ts

@@ -0,0 +1,18 @@
+export interface ReferenceFilterDescriptor {
+    target: string;
+    kinds?: string[];
+    predicate?: string;
+}
+export interface PropertyEditorOptions {
+    multiline?: boolean;
+    placeholder?: string;
+    unit?: string;
+    step?: number;
+    kinds?: string[];
+    reference?: ReferenceFilterDescriptor;
+    fieldKinds?: string[];
+    tokensOnly?: boolean;
+}
+export declare const ReferenceFilterDescriptorPropertyNames: (keyof ReferenceFilterDescriptor)[];
+export declare const PropertyEditorOptionsPropertyNames: (keyof PropertyEditorOptions)[];
+//# sourceMappingURL=PropertyEditorOptions.d.ts.map

package/dist/esm/descriptors/PropertyEditorOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PropertyEditorOptions.d.ts","sourceRoot":"","sources":["../../../descriptors/PropertyEditorOptions.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,yBAAyB;IAEtC,MAAM,EAAE,MAAM,CAAC;IAGf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAGjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD,MAAM,WAAW,qBAAqB;IAElC,SAAS,CAAC,EAAE,OAAO,CAAC;IAGpB,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,IAAI,CAAC,EAAE,MAAM,CAAC;IAGd,IAAI,CAAC,EAAE,MAAM,CAAC;IAGd,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAGjB,SAAS,CAAC,EAAE,yBAAyB,CAAC;IAGtC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAGtB,UAAU,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,eAAO,MAAM,sCAAsC,EAAE,CAAC,MAAM,yBAAyB,CAAC,EAAqC,CAAC;AAC5H,eAAO,MAAM,kCAAkC,EAAE,CAAC,MAAM,qBAAqB,CAAC,EAE7E,CAAC"}

package/dist/esm/descriptors/PropertyEditorOptions.js

@@ -0,0 +1,22 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * What a `reference` editor offers: the model elements of one kind, narrowed by a named rule.
+ */ const ReferenceFilterDescriptorPropertyNames = [
+    'target',
+    'kinds',
+    'predicate'
+];
+const PropertyEditorOptionsPropertyNames = [
+    'multiline',
+    'placeholder',
+    'unit',
+    'step',
+    'kinds',
+    'reference',
+    'fieldKinds',
+    'tokensOnly'
+];
+
+export { PropertyEditorOptionsPropertyNames, ReferenceFilterDescriptorPropertyNames };
+//# sourceMappingURL=PropertyEditorOptions.js.map

package/dist/esm/descriptors/PropertyEditorOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PropertyEditorOptions.js","sources":["../../../descriptors/PropertyEditorOptions.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 `reference` editor offers: the model elements of one kind, narrowed by a named rule.\n */\nexport interface ReferenceFilterDescriptor {\n    /** The kind of model element referenced: `screen`, `slice`, `template`, `shape`, `field` ... A host maps it to what it can list. */\n    target: string;\n\n    /** Narrows the target to these kinds (a slice is a `StateChange`, a `ReadModel` ...). Absent means every kind. */\n    kinds?: string[];\n\n    /** Names the rule that decides which candidates are offered, interpreted by the host - like `availability` of a design-time action. */\n    predicate?: string;\n}\n\n/**\n * The parameters of a named editor, alongside `PropertyDescriptor.editorKind`: the bits a generic editor needs that are not a value\n * constraint. Every field is optional and only the ones an editor documents are read.\n */\nexport interface PropertyEditorOptions {\n    /** `text`: a multi-line box instead of a single line. */\n    multiline?: boolean;\n\n    /** `text`: the hint shown while empty. */\n    placeholder?: string;\n\n    /** `number`: the unit shown after the value (`px`, `%`, `ms`). */\n    unit?: string;\n\n    /** `number`: the increment of a stepper. The range is `constraints.minimum` and `constraints.maximum`. */\n    step?: number;\n\n    /** `slice`: the slice kinds that can be chosen (`['StateChange']`); others are listed disabled with a reason. */\n    kinds?: string[];\n\n    /** `reference`: what can be referenced. Required by the `reference` editor. */\n    reference?: ReferenceFilterDescriptor;\n\n    /** `field`: the kinds of field offered (`string`, `number`, `boolean` ...). Absent means any. */\n    fieldKinds?: string[];\n\n    /** `color`: only theme tokens, no custom colour. */\n    tokensOnly?: boolean;\n}\n\nexport const ReferenceFilterDescriptorPropertyNames: (keyof ReferenceFilterDescriptor)[] = ['target', 'kinds', 'predicate'];\nexport const PropertyEditorOptionsPropertyNames: (keyof PropertyEditorOptions)[] = [\n    'multiline', 'placeholder', 'unit', 'step', 'kinds', 'reference', 'fieldKinds', 'tokensOnly',\n];\n"],"names":["ReferenceFilterDescriptorPropertyNames","PropertyEditorOptionsPropertyNames"],"mappings":"AAAA;AACA;AAEA;;UA4CaA,sCAAAA,GAA8E;AAAC,IAAA,QAAA;AAAU,IAAA,OAAA;AAAS,IAAA;;MAClGC,kCAAAA,GAAsE;AAC/E,IAAA,WAAA;AAAa,IAAA,aAAA;AAAe,IAAA,MAAA;AAAQ,IAAA,MAAA;AAAQ,IAAA,OAAA;AAAS,IAAA,WAAA;AAAa,IAAA,YAAA;AAAc,IAAA;;;"}

package/dist/esm/descriptors/componentIcon.d.ts

@@ -0,0 +1,4 @@
+import { IconReference } from '../icons';
+export declare const componentIconLibrary = "Cratis.Icons.Lucide";
+export declare function componentIcon(key: string): IconReference;
+//# sourceMappingURL=componentIcon.d.ts.map

package/dist/esm/descriptors/componentIcon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"componentIcon.d.ts","sourceRoot":"","sources":["../../../descriptors/componentIcon.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAOzC,eAAO,MAAM,oBAAoB,wBAAwB,CAAC;AAG1D,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAExD"}

package/dist/esm/descriptors/componentIcon.js

@@ -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.
+/**
+ * The icon library the built-in components' icons come from: the Lucide library package a Cratis host ships. A component's icon is an
+ * ordinary {@link IconReference}, so a host without that library shows the component's badge instead (see the component picker) and
+ * the icon diagnostics report it like any other icon.
+ */ const componentIconLibrary = 'Cratis.Icons.Lucide';
+/** The icon with this key in {@link componentIconLibrary}. */ function componentIcon(key) {
+    return {
+        library: componentIconLibrary,
+        key
+    };
+}
+
+export { componentIcon, componentIconLibrary };
+//# sourceMappingURL=componentIcon.js.map

package/dist/esm/descriptors/componentIcon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"componentIcon.js","sources":["../../../descriptors/componentIcon.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 { IconReference } from '../icons';\n\n/**\n * The icon library the built-in components' icons come from: the Lucide library package a Cratis host ships. A component's icon is an\n * ordinary {@link IconReference}, so a host without that library shows the component's badge instead (see the component picker) and\n * the icon diagnostics report it like any other icon.\n */\nexport const componentIconLibrary = 'Cratis.Icons.Lucide';\n\n/** The icon with this key in {@link componentIconLibrary}. */\nexport function componentIcon(key: string): IconReference {\n    return { library: componentIconLibrary, key };\n}\n"],"names":["componentIconLibrary","componentIcon","key","library"],"mappings":"AAAA;AACA;AAIA;;;;IAKO,MAAMA,oBAAAA,GAAuB;AAEpC,+DACO,SAASC,aAAAA,CAAcC,GAAW,EAAA;IACrC,OAAO;QAAEC,OAAAA,EAASH,oBAAAA;AAAsBE,QAAAA;AAAI,KAAA;AAChD;;"}

package/dist/esm/descriptors/index.d.ts

@@ -1,5 +1,6 @@
 export * from './PropertyValueType';
 export * from './PropertyEditorKind';
+export * from './PropertyEditorOptions';
 export * from './PropertyChoice';
 export * from './PropertyConstraints';
 export * from './CollectionItemDescriptor';
@@ -7,6 +8,9 @@ export * from './DesignTimeActionDescriptor';
 export * from './DesignTimeActionPlacement';
 export * from './PackageDesignTimeMetadata';
 export * from './PropertyDescriptor';
+export * from './ComponentCategory';
+export * from './ComponentDesignModeDescriptor';
+export * from './componentIcon';
 export * from './ComponentDescriptor';
 export * from './CollectionOperation';
 export * from './LayoutType';

package/dist/esm/descriptors/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../descriptors/index.ts"],"names":[],"mappings":"AAGA,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../descriptors/index.ts"],"names":[],"mappings":"AAGA,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iCAAiC,CAAC;AAChD,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC"}

package/dist/esm/descriptors/index.js

@@ -1,5 +1,6 @@
 export * from './PropertyValueType';
 export * from './PropertyEditorKind';
+export * from './PropertyEditorOptions';
 export * from './PropertyChoice';
 export * from './PropertyConstraints';
 export * from './CollectionItemDescriptor';
@@ -7,6 +8,9 @@ export * from './DesignTimeActionDescriptor';
 export * from './DesignTimeActionPlacement';
 export * from './PackageDesignTimeMetadata';
 export * from './PropertyDescriptor';
+export * from './ComponentCategory';
+export * from './ComponentDesignModeDescriptor';
+export * from './componentIcon';
 export * from './ComponentDescriptor';
 export * from './CollectionOperation';
 export * from './LayoutType';

package/dist/esm/descriptors/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../descriptors/index.ts"],"names":[],"mappings":"AAGA,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../descriptors/index.ts"],"names":[],"mappings":"AAGA,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iCAAiC,CAAC;AAChD,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC"}