@cratis/scene.model 4.2.1 → 4.3.0

package/common/DestinationReference.ts

@@ -0,0 +1,18 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { BindingExpression } from './BindingExpression';
+
+/**
+ * Where activating something takes the user: a screen, named rather than addressed. Turning the name into a
+ * URL, query string or native deep link is a renderer's job, the same as for a `NavigateAction`.
+ */
+export interface DestinationReference {
+    /** The name of the screen to go to. */
+    screen: string;
+
+    /** The values for the screen's route parameters, keyed by parameter name. */
+    routeParameterBindings?: Record<string, BindingExpression>;
+}
+
+export const DestinationReferencePropertyNames: (keyof DestinationReference)[] = ['screen', 'routeParameterBindings'];

package/common/IconReference.ts

@@ -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.
+
+/**
+ * A qualified reference to one icon: the library it comes from, its key within that library and an optional
+ * style variant. This is the renderer-neutral, persisted form of an icon choice.
+ *
+ * Identity is all three fields. A label, a display name, a CSS class, an SVG or a position in a catalog is
+ * never identity - none of them survive a library upgrade, and a persisted choice has to.
+ */
+export interface IconReference {
+    /** The stable identity of the icon library package the icon belongs to. */
+    library: string;
+
+    /** The stable key of the icon within `library`. */
+    key: string;
+
+    /** The style variant (outlined, filled, ...), when the library has them. */
+    variant?: string;
+}
+
+export const IconReferencePropertyNames: (keyof IconReference)[] = ['library', 'key', 'variant'];

package/common/index.ts

@@ -12,3 +12,5 @@ export * from './Orientation';
 export * from './Dock';
 export * from './GridUnitType';
 export * from './GridLength';
+export * from './IconReference';
+export * from './DestinationReference';

package/descriptors/CollectionItemDescriptor.ts

@@ -0,0 +1,20 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import type { PropertyDescriptor } from './PropertyDescriptor';
+
+/**
+ * Describes the items of a `Collection` property.
+ *
+ * An item is a record with a stable `id` (assigned by whoever creates it, never an array index) plus the fields
+ * `properties` describes. Field paths are relative to the item and are single names.
+ */
+export interface CollectionItemDescriptor {
+    /** What one item is called, for a host's "add ..." affordance. */
+    label?: string;
+
+    /** The fields of one item. */
+    properties: PropertyDescriptor[];
+}
+
+export const CollectionItemDescriptorPropertyNames: (keyof CollectionItemDescriptor)[] = ['label', 'properties'];

package/descriptors/CollectionOperation.ts

@@ -0,0 +1,20 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+/**
+ * One thing a consumer may do to a collection a template author has exposed. Each is granted on its own: allowing
+ * a consumer to add an item says nothing about removing or reordering one.
+ */
+export enum CollectionOperation {
+    /** Add an item. */
+    Add = 'add',
+
+    /** Remove an item the consumer added. */
+    Remove = 'remove',
+
+    /** Change where an item the consumer added sits. */
+    Reorder = 'reorder',
+
+    /** Change the field values of an item the consumer added. */
+    EditFields = 'edit-fields',
+}

package/descriptors/ComponentDescriptor.ts

@@ -0,0 +1,33 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { PropertyDescriptor } from './PropertyDescriptor';
+
+/**
+ * What can be edited on one component a package provides.
+ *
+ * Packages contribute these alongside the components themselves (a bundle's `descriptors`), through the same
+ * package mechanism that already carries components, layouts and themes - there is no second registry to keep in
+ * step.
+ */
+export interface ComponentDescriptor {
+    /**
+     * The component this describes, as the package names it: `<package>:<bare name>`, the same key a bundle
+     * registers the component under (for example `Cratis.Components:dataTable`).
+     */
+    component: string;
+
+    /** A human-readable name for a palette or an inspector title. */
+    displayName?: string;
+
+    description?: string;
+
+    /** Names a specialised editor for the component as a whole, when its properties are not edited one by one. */
+    editorKind?: string;
+
+    properties: PropertyDescriptor[];
+}
+
+export const ComponentDescriptorPropertyNames: (keyof ComponentDescriptor)[] = [
+    'component', 'displayName', 'description', 'editorKind', 'properties',
+];

package/descriptors/LayoutCapabilities.ts

@@ -0,0 +1,32 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { LayoutChildPlacement } from './LayoutChildPlacement';
+import { LayoutType } from './LayoutType';
+
+/**
+ * What a layout type can do - the row of the capability matrix an editor consults to decide what to offer.
+ */
+export interface LayoutCapabilities {
+    /** Whether children can be inserted into it. */
+    acceptsChildren: boolean;
+
+    /** The most children it can hold, when it is limited. */
+    maximumChildren?: number;
+
+    /** Whether position comes from order or from per-child placement. */
+    childPlacement: LayoutChildPlacement;
+
+    /** Whether children can span several columns or rows. */
+    supportsGridSpan: boolean;
+
+    /** Whether it can vary by width and height size class. */
+    supportsSizeClassVariants: boolean;
+
+    /** The layout types it can be changed into, some of them lossily. */
+    convertibleTo: LayoutType[];
+}
+
+export const LayoutCapabilitiesPropertyNames: (keyof LayoutCapabilities)[] = [
+    'acceptsChildren', 'maximumChildren', 'childPlacement', 'supportsGridSpan', 'supportsSizeClassVariants', 'convertibleTo',
+];

package/descriptors/LayoutChildPlacement.ts

@@ -0,0 +1,16 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+/**
+ * How a layout type decides where its children go.
+ */
+export enum LayoutChildPlacement {
+    /** It holds no children. */
+    None = 'none',
+
+    /** By order: a child's position is its place in the sequence, and the layout reflows. */
+    Ordered = 'ordered',
+
+    /** By placement: each child carries its own position and size. */
+    Positioned = 'positioned',
+}

package/descriptors/LayoutType.ts

@@ -0,0 +1,28 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+/**
+ * Every layout type the model can express, as an editor addresses it. A flow container's kind and a panel's
+ * concrete type are both layout types, so "change this row to a column" and "change this stack to a wrap panel"
+ * are the same operation.
+ */
+export enum LayoutType {
+    FlowRow = 'flowRow',
+    FlowColumn = 'flowColumn',
+    FlowGrid = 'flowGrid',
+
+    /** A flow leaf: positions one element within a flow tree. */
+    FlowLeaf = 'flowLeaf',
+
+    /** A flow leaf that positions one of a layout's own slots. */
+    FlowSlotLeaf = 'flowSlotLeaf',
+
+    /** A freeform arrangement: one placement variant per size class. */
+    Freeform = 'freeform',
+
+    StackPanel = 'stackPanel',
+    WrapPanel = 'wrapPanel',
+    DockPanel = 'dockPanel',
+    GridPanel = 'gridPanel',
+    Canvas = 'canvas',
+}

package/descriptors/LayoutTypeDescriptor.ts

@@ -0,0 +1,25 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { LayoutCapabilities } from './LayoutCapabilities';
+import { LayoutType } from './LayoutType';
+import { PropertyDescriptor } from './PropertyDescriptor';
+
+/**
+ * What can be edited on one layout type, and what the type can do.
+ */
+export interface LayoutTypeDescriptor {
+    /** The layout type's identity. */
+    type: LayoutType;
+
+    label: string;
+    description?: string;
+    capabilities: LayoutCapabilities;
+
+    /** The type's own editable properties; `path` is a property name on the node. */
+    properties: PropertyDescriptor[];
+}
+
+export const LayoutTypeDescriptorPropertyNames: (keyof LayoutTypeDescriptor)[] = [
+    'type', 'label', 'description', 'capabilities', 'properties',
+];

package/descriptors/PropertyChoice.ts

@@ -0,0 +1,13 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+/**
+ * One allowed value of an `Enum` property.
+ */
+export interface PropertyChoice {
+    value: string | number;
+    label: string;
+    description?: string;
+}
+
+export const PropertyChoicePropertyNames: (keyof PropertyChoice)[] = ['value', 'label', 'description'];

package/descriptors/PropertyConstraints.ts

@@ -0,0 +1,41 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { QueryResultShape } from '../queries';
+
+/**
+ * The limits a property's value has to stay within. Every limit is optional; an absent one means no limit.
+ */
+export interface PropertyConstraints {
+    /** The property must have a value. */
+    required?: boolean;
+
+    /** The smallest allowed number. */
+    minimum?: number;
+
+    /** The largest allowed number. */
+    maximum?: number;
+
+    /** The number must be a whole number. */
+    integer?: boolean;
+
+    minimumLength?: number;
+    maximumLength?: number;
+
+    /** A regular expression a string must match in full. */
+    pattern?: string;
+
+    /** The fewest items a collection may hold. */
+    minimumItems?: number;
+
+    /** The most items a collection may hold. */
+    maximumItems?: number;
+
+    /** For a `QueryReference`: the result shapes the component can bind to. Absent means any. */
+    resultShapes?: `${QueryResultShape}`[];
+}
+
+export const PropertyConstraintsPropertyNames: (keyof PropertyConstraints)[] = [
+    'required', 'minimum', 'maximum', 'integer', 'minimumLength', 'maximumLength', 'pattern',
+    'minimumItems', 'maximumItems', 'resultShapes',
+];

package/descriptors/PropertyDescriptor.ts

@@ -0,0 +1,55 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { CollectionItemDescriptor } from './CollectionItemDescriptor';
+import { PropertyChoice } from './PropertyChoice';
+import { PropertyConstraints } from './PropertyConstraints';
+import { PropertyValueType } from './PropertyValueType';
+
+/**
+ * Describes one editable property of a node: where it lives, what it is called, what it may hold and how a host
+ * should edit it. A descriptor is plain data, so packages ship them and Studio reads them without loading a
+ * component.
+ */
+export interface PropertyDescriptor {
+    /**
+     * Where the value lives. For an `ExternalComponent` it is a key (or dotted key path) in the element's
+     * `properties` bag; for a model-native node such as a flow container it is the node's own property name.
+     */
+    path: string;
+
+    /** The label an editor shows. */
+    label: string;
+
+    /** The editor section the property belongs to. */
+    group: string;
+
+    valueType: PropertyValueType;
+
+    /** The allowed values of an `Enum` property. */
+    choices?: PropertyChoice[];
+
+    /** The value in effect when none is set. */
+    default?: unknown;
+
+    constraints?: PropertyConstraints;
+
+    /**
+     * Names a specialised editor. A host maps the name to its own editor - an icon picker, a query binder - and
+     * falls back to the default editor for `valueType` when it does not know the name.
+     */
+    editorKind?: string;
+
+    /** A sentence of help for the editor. */
+    description?: string;
+
+    /** Describes the items of a `Collection` property. Required when `valueType` is `Collection`. */
+    item?: CollectionItemDescriptor;
+
+    /** The value is shown but never edited. */
+    readOnly?: boolean;
+}
+
+export const PropertyDescriptorPropertyNames: (keyof PropertyDescriptor)[] = [
+    'path', 'label', 'group', 'valueType', 'choices', 'default', 'constraints', 'editorKind', 'description', 'item', 'readOnly',
+];

package/descriptors/PropertyValueType.ts

@@ -0,0 +1,30 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+/**
+ * The kind of value a property holds. It decides what a value must look like to be accepted, and gives a host a
+ * default editor to show - unless the descriptor names a specialised `editorKind`.
+ */
+export enum PropertyValueType {
+    String = 'string',
+    Number = 'number',
+    Boolean = 'boolean',
+
+    /** One of the descriptor's `choices`. */
+    Enum = 'enum',
+
+    /** An {@link IconReference}. The icon catalog is owned by the icon libraries, not by the model. */
+    Icon = 'icon',
+
+    /** A {@link DestinationReference}. */
+    Destination = 'destination',
+
+    /** A {@link QueryBinding}. */
+    QueryReference = 'queryReference',
+
+    /** An ordered list of items, each described by the descriptor's `item`. */
+    Collection = 'collection',
+
+    /** A structured value the descriptor's own `editorKind` knows how to edit. */
+    Object = 'object',
+}

package/descriptors/index.ts

@@ -0,0 +1,14 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+export * from './PropertyValueType';
+export * from './PropertyChoice';
+export * from './PropertyConstraints';
+export * from './CollectionItemDescriptor';
+export * from './PropertyDescriptor';
+export * from './ComponentDescriptor';
+export * from './CollectionOperation';
+export * from './LayoutType';
+export * from './LayoutChildPlacement';
+export * from './LayoutCapabilities';
+export * from './LayoutTypeDescriptor';

package/dist/cjs/common/DestinationReference.js

@@ -0,0 +1,11 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+const DestinationReferencePropertyNames = [
+    'screen',
+    'routeParameterBindings'
+];
+
+exports.DestinationReferencePropertyNames = DestinationReferencePropertyNames;
+//# sourceMappingURL=DestinationReference.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DestinationReference.js","sources":["../../../common/DestinationReference.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { BindingExpression } from './BindingExpression';\n\n/**\n * Where activating something takes the user: a screen, named rather than addressed. Turning the name into a\n * URL, query string or native deep link is a renderer's job, the same as for a `NavigateAction`.\n */\nexport interface DestinationReference {\n    /** The name of the screen to go to. */\n    screen: string;\n\n    /** The values for the screen's route parameters, keyed by parameter name. */\n    routeParameterBindings?: Record<string, BindingExpression>;\n}\n\nexport const DestinationReferencePropertyNames: (keyof DestinationReference)[] = ['screen', 'routeParameterBindings'];\n"],"names":["DestinationReferencePropertyNames"],"mappings":";;AAAA;AACA;MAgBaA,iCAAAA,GAAoE;AAAC,IAAA,QAAA;AAAU,IAAA;;;"}

package/dist/cjs/common/IconReference.js

@@ -0,0 +1,18 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * A qualified reference to one icon: the library it comes from, its key within that library and an optional
+ * style variant. This is the renderer-neutral, persisted form of an icon choice.
+ *
+ * Identity is all three fields. A label, a display name, a CSS class, an SVG or a position in a catalog is
+ * never identity - none of them survive a library upgrade, and a persisted choice has to.
+ */ const IconReferencePropertyNames = [
+    'library',
+    'key',
+    'variant'
+];
+
+exports.IconReferencePropertyNames = IconReferencePropertyNames;
+//# sourceMappingURL=IconReference.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IconReference.js","sources":["../../../common/IconReference.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\n/**\n * A qualified reference to one icon: the library it comes from, its key within that library and an optional\n * style variant. This is the renderer-neutral, persisted form of an icon choice.\n *\n * Identity is all three fields. A label, a display name, a CSS class, an SVG or a position in a catalog is\n * never identity - none of them survive a library upgrade, and a persisted choice has to.\n */\nexport interface IconReference {\n    /** The stable identity of the icon library package the icon belongs to. */\n    library: string;\n\n    /** The stable key of the icon within `library`. */\n    key: string;\n\n    /** The style variant (outlined, filled, ...), when the library has them. */\n    variant?: string;\n}\n\nexport const IconReferencePropertyNames: (keyof IconReference)[] = ['library', 'key', 'variant'];\n"],"names":["IconReferencePropertyNames"],"mappings":";;AAAA;AACA;AAEA;;;;;;UAkBaA,0BAAAA,GAAsD;AAAC,IAAA,SAAA;AAAW,IAAA,KAAA;AAAO,IAAA;;;"}

package/dist/cjs/descriptors/CollectionItemDescriptor.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"CollectionItemDescriptor.js","sources":["../../../descriptors/CollectionItemDescriptor.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 type { PropertyDescriptor } from './PropertyDescriptor';\n\n/**\n * Describes the items of a `Collection` property.\n *\n * An item is a record with a stable `id` (assigned by whoever creates it, never an array index) plus the fields\n * `properties` describes. Field paths are relative to the item and are single names.\n */\nexport interface CollectionItemDescriptor {\n    /** What one item is called, for a host's \"add ...\" affordance. */\n    label?: string;\n\n    /** The fields of one item. */\n    properties: PropertyDescriptor[];\n}\n\nexport const CollectionItemDescriptorPropertyNames: (keyof CollectionItemDescriptor)[] = ['label', 'properties'];\n"],"names":["CollectionItemDescriptorPropertyNames"],"mappings":";;AAAA;AACA;MAkBaA,qCAAAA,GAA4E;AAAC,IAAA,OAAA;AAAS,IAAA;;;"}

package/dist/cjs/descriptors/CollectionOperation.js

@@ -0,0 +1,17 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * One thing a consumer may do to a collection a template author has exposed. Each is granted on its own: allowing
+ * a consumer to add an item says nothing about removing or reordering one.
+ */ var CollectionOperation = /*#__PURE__*/ function(CollectionOperation) {
+    /** Add an item. */ CollectionOperation["Add"] = "add";
+    /** Remove an item the consumer added. */ CollectionOperation["Remove"] = "remove";
+    /** Change where an item the consumer added sits. */ CollectionOperation["Reorder"] = "reorder";
+    /** Change the field values of an item the consumer added. */ CollectionOperation["EditFields"] = "edit-fields";
+    return CollectionOperation;
+}({});
+
+exports.CollectionOperation = CollectionOperation;
+//# sourceMappingURL=CollectionOperation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CollectionOperation.js","sources":["../../../descriptors/CollectionOperation.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 * One thing a consumer may do to a collection a template author has exposed. Each is granted on its own: allowing\n * a consumer to add an item says nothing about removing or reordering one.\n */\nexport enum CollectionOperation {\n    /** Add an item. */\n    Add = 'add',\n\n    /** Remove an item the consumer added. */\n    Remove = 'remove',\n\n    /** Change where an item the consumer added sits. */\n    Reorder = 'reorder',\n\n    /** Change the field values of an item the consumer added. */\n    EditFields = 'edit-fields',\n}\n"],"names":["CollectionOperation"],"mappings":";;AAAA;AACA;AAEA;;;IAIO,IAAKA,mBAAAA,iBAAAA,SAAAA,mBAAAA,EAAAA;wBACS,mBAAA,CAAA,KAAA,CAAA,GAAA,KAAA;8CAGsB,mBAAA,CAAA,QAAA,CAAA,GAAA,QAAA;yDAGW,mBAAA,CAAA,SAAA,CAAA,GAAA,SAAA;kEAGS,mBAAA,CAAA,YAAA,CAAA,GAAA,aAAA;AAVnDA,IAAAA,OAAAA,mBAAAA;AAYX,CAAA,CAAA,EAAA;;"}

package/dist/cjs/descriptors/ComponentDescriptor.js

@@ -0,0 +1,14 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+const ComponentDescriptorPropertyNames = [
+    'component',
+    'displayName',
+    'description',
+    'editorKind',
+    'properties'
+];
+
+exports.ComponentDescriptorPropertyNames = ComponentDescriptorPropertyNames;
+//# sourceMappingURL=ComponentDescriptor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentDescriptor.js","sources":["../../../descriptors/ComponentDescriptor.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { PropertyDescriptor } from './PropertyDescriptor';\n\n/**\n * What can be edited on one component a package provides.\n *\n * Packages contribute these alongside the components themselves (a bundle's `descriptors`), through the same\n * package mechanism that already carries components, layouts and themes - there is no second registry to keep in\n * step.\n */\nexport interface ComponentDescriptor {\n    /**\n     * The component this describes, as the package names it: `<package>:<bare name>`, the same key a bundle\n     * registers the component under (for example `Cratis.Components:dataTable`).\n     */\n    component: string;\n\n    /** A human-readable name for a palette or an inspector title. */\n    displayName?: string;\n\n    description?: string;\n\n    /** Names a specialised editor for the component as a whole, when its properties are not edited one by one. */\n    editorKind?: string;\n\n    properties: PropertyDescriptor[];\n}\n\nexport const ComponentDescriptorPropertyNames: (keyof ComponentDescriptor)[] = [\n    'component', 'displayName', 'description', 'editorKind', 'properties',\n];\n"],"names":["ComponentDescriptorPropertyNames"],"mappings":";;AAAA;AACA;MA6BaA,gCAAAA,GAAkE;AAC3E,IAAA,WAAA;AAAa,IAAA,aAAA;AAAe,IAAA,aAAA;AAAe,IAAA,YAAA;AAAc,IAAA;;;"}

package/dist/cjs/descriptors/LayoutCapabilities.js

@@ -0,0 +1,15 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+const LayoutCapabilitiesPropertyNames = [
+    'acceptsChildren',
+    'maximumChildren',
+    'childPlacement',
+    'supportsGridSpan',
+    'supportsSizeClassVariants',
+    'convertibleTo'
+];
+
+exports.LayoutCapabilitiesPropertyNames = LayoutCapabilitiesPropertyNames;
+//# sourceMappingURL=LayoutCapabilities.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LayoutCapabilities.js","sources":["../../../descriptors/LayoutCapabilities.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 { LayoutChildPlacement } from './LayoutChildPlacement';\nimport { LayoutType } from './LayoutType';\n\n/**\n * What a layout type can do - the row of the capability matrix an editor consults to decide what to offer.\n */\nexport interface LayoutCapabilities {\n    /** Whether children can be inserted into it. */\n    acceptsChildren: boolean;\n\n    /** The most children it can hold, when it is limited. */\n    maximumChildren?: number;\n\n    /** Whether position comes from order or from per-child placement. */\n    childPlacement: LayoutChildPlacement;\n\n    /** Whether children can span several columns or rows. */\n    supportsGridSpan: boolean;\n\n    /** Whether it can vary by width and height size class. */\n    supportsSizeClassVariants: boolean;\n\n    /** The layout types it can be changed into, some of them lossily. */\n    convertibleTo: LayoutType[];\n}\n\nexport const LayoutCapabilitiesPropertyNames: (keyof LayoutCapabilities)[] = [\n    'acceptsChildren', 'maximumChildren', 'childPlacement', 'supportsGridSpan', 'supportsSizeClassVariants', 'convertibleTo',\n];\n"],"names":["LayoutCapabilitiesPropertyNames"],"mappings":";;AAAA;AACA;MA4BaA,+BAAAA,GAAgE;AACzE,IAAA,iBAAA;AAAmB,IAAA,iBAAA;AAAmB,IAAA,gBAAA;AAAkB,IAAA,kBAAA;AAAoB,IAAA,2BAAA;AAA6B,IAAA;;;"}

package/dist/cjs/descriptors/LayoutChildPlacement.js

@@ -0,0 +1,15 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * How a layout type decides where its children go.
+ */ var LayoutChildPlacement = /*#__PURE__*/ function(LayoutChildPlacement) {
+    /** It holds no children. */ LayoutChildPlacement["None"] = "none";
+    /** By order: a child's position is its place in the sequence, and the layout reflows. */ LayoutChildPlacement["Ordered"] = "ordered";
+    /** By placement: each child carries its own position and size. */ LayoutChildPlacement["Positioned"] = "positioned";
+    return LayoutChildPlacement;
+}({});
+
+exports.LayoutChildPlacement = LayoutChildPlacement;
+//# sourceMappingURL=LayoutChildPlacement.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LayoutChildPlacement.js","sources":["../../../descriptors/LayoutChildPlacement.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\n/**\n * How a layout type decides where its children go.\n */\nexport enum LayoutChildPlacement {\n    /** It holds no children. */\n    None = 'none',\n\n    /** By order: a child's position is its place in the sequence, and the layout reflows. */\n    Ordered = 'ordered',\n\n    /** By placement: each child carries its own position and size. */\n    Positioned = 'positioned',\n}\n"],"names":["LayoutChildPlacement"],"mappings":";;AAAA;AACA;AAEA;;IAGO,IAAKA,oBAAAA,iBAAAA,SAAAA,oBAAAA,EAAAA;iCACkB,oBAAA,CAAA,MAAA,CAAA,GAAA,MAAA;8FAG6D,oBAAA,CAAA,SAAA,CAAA,GAAA,SAAA;uEAGvB,oBAAA,CAAA,YAAA,CAAA,GAAA,YAAA;AAPxDA,IAAAA,OAAAA,oBAAAA;AASX,CAAA,CAAA,EAAA;;"}

package/dist/cjs/descriptors/LayoutType.js

@@ -0,0 +1,25 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Every layout type the model can express, as an editor addresses it. A flow container's kind and a panel's
+ * concrete type are both layout types, so "change this row to a column" and "change this stack to a wrap panel"
+ * are the same operation.
+ */ var LayoutType = /*#__PURE__*/ function(LayoutType) {
+    LayoutType["FlowRow"] = "flowRow";
+    LayoutType["FlowColumn"] = "flowColumn";
+    LayoutType["FlowGrid"] = "flowGrid";
+    /** A flow leaf: positions one element within a flow tree. */ LayoutType["FlowLeaf"] = "flowLeaf";
+    /** A flow leaf that positions one of a layout's own slots. */ LayoutType["FlowSlotLeaf"] = "flowSlotLeaf";
+    /** A freeform arrangement: one placement variant per size class. */ LayoutType["Freeform"] = "freeform";
+    LayoutType["StackPanel"] = "stackPanel";
+    LayoutType["WrapPanel"] = "wrapPanel";
+    LayoutType["DockPanel"] = "dockPanel";
+    LayoutType["GridPanel"] = "gridPanel";
+    LayoutType["Canvas"] = "canvas";
+    return LayoutType;
+}({});
+
+exports.LayoutType = LayoutType;
+//# sourceMappingURL=LayoutType.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LayoutType.js","sources":["../../../descriptors/LayoutType.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 * Every layout type the model can express, as an editor addresses it. A flow container's kind and a panel's\n * concrete type are both layout types, so \"change this row to a column\" and \"change this stack to a wrap panel\"\n * are the same operation.\n */\nexport enum LayoutType {\n    FlowRow = 'flowRow',\n    FlowColumn = 'flowColumn',\n    FlowGrid = 'flowGrid',\n\n    /** A flow leaf: positions one element within a flow tree. */\n    FlowLeaf = 'flowLeaf',\n\n    /** A flow leaf that positions one of a layout's own slots. */\n    FlowSlotLeaf = 'flowSlotLeaf',\n\n    /** A freeform arrangement: one placement variant per size class. */\n    Freeform = 'freeform',\n\n    StackPanel = 'stackPanel',\n    WrapPanel = 'wrapPanel',\n    DockPanel = 'dockPanel',\n    GridPanel = 'gridPanel',\n    Canvas = 'canvas',\n}\n"],"names":["LayoutType"],"mappings":";;AAAA;AACA;AAEA;;;;IAKO,IAAKA,UAAAA,iBAAAA,SAAAA,UAAAA,EAAAA;;;;kEAKmD,UAAA,CAAA,UAAA,CAAA,GAAA,UAAA;mEAGC,UAAA,CAAA,cAAA,CAAA,GAAA,cAAA;yEAGM,UAAA,CAAA,UAAA,CAAA,GAAA,UAAA;;;;;;AAX1DA,IAAAA,OAAAA,UAAAA;AAmBX,CAAA,CAAA,EAAA;;"}

package/dist/cjs/descriptors/LayoutTypeDescriptor.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"LayoutTypeDescriptor.js","sources":["../../../descriptors/LayoutTypeDescriptor.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 { LayoutCapabilities } from './LayoutCapabilities';\nimport { LayoutType } from './LayoutType';\nimport { PropertyDescriptor } from './PropertyDescriptor';\n\n/**\n * What can be edited on one layout type, and what the type can do.\n */\nexport interface LayoutTypeDescriptor {\n    /** The layout type's identity. */\n    type: LayoutType;\n\n    label: string;\n    description?: string;\n    capabilities: LayoutCapabilities;\n\n    /** The type's own editable properties; `path` is a property name on the node. */\n    properties: PropertyDescriptor[];\n}\n\nexport const LayoutTypeDescriptorPropertyNames: (keyof LayoutTypeDescriptor)[] = [\n    'type', 'label', 'description', 'capabilities', 'properties',\n];\n"],"names":["LayoutTypeDescriptorPropertyNames"],"mappings":";;AAAA;AACA;MAqBaA,iCAAAA,GAAoE;AAC7E,IAAA,MAAA;AAAQ,IAAA,OAAA;AAAS,IAAA,aAAA;AAAe,IAAA,cAAA;AAAgB,IAAA;;;"}

package/dist/cjs/descriptors/PropertyChoice.js

@@ -0,0 +1,14 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * One allowed value of an `Enum` property.
+ */ const PropertyChoicePropertyNames = [
+    'value',
+    'label',
+    'description'
+];
+
+exports.PropertyChoicePropertyNames = PropertyChoicePropertyNames;
+//# sourceMappingURL=PropertyChoice.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PropertyChoice.js","sources":["../../../descriptors/PropertyChoice.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 * One allowed value of an `Enum` property.\n */\nexport interface PropertyChoice {\n    value: string | number;\n    label: string;\n    description?: string;\n}\n\nexport const PropertyChoicePropertyNames: (keyof PropertyChoice)[] = ['value', 'label', 'description'];\n"],"names":["PropertyChoicePropertyNames"],"mappings":";;AAAA;AACA;AAEA;;UASaA,2BAAAA,GAAwD;AAAC,IAAA,OAAA;AAAS,IAAA,OAAA;AAAS,IAAA;;;"}

package/dist/cjs/descriptors/PropertyConstraints.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.
+const PropertyConstraintsPropertyNames = [
+    'required',
+    'minimum',
+    'maximum',
+    'integer',
+    'minimumLength',
+    'maximumLength',
+    'pattern',
+    'minimumItems',
+    'maximumItems',
+    'resultShapes'
+];
+
+exports.PropertyConstraintsPropertyNames = PropertyConstraintsPropertyNames;
+//# sourceMappingURL=PropertyConstraints.js.map