@cratis/scene.model 4.11.0 → 4.12.0

package/forms/CommandFormLayout.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 { FormColumn } from './FormColumn';
+import { FormFieldPlacement } from './FormFieldPlacement';
+import { FormWidth } from './FormWidth';
+
+/**
+ * Platform-neutral command-form geometry. It is independent of auto/manual field generation mode.
+ */
+export interface CommandFormLayout {
+    columns: FormColumn[];
+    placements: FormFieldPlacement[];
+    columnGap?: FormWidth;
+    rowGap?: FormWidth;
+}
+
+export const CommandFormLayoutPropertyNames: (keyof CommandFormLayout)[] = ['columns', 'placements', 'columnGap', 'rowGap'];

package/forms/Form.ts

@@ -1,6 +1,8 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
+import { CommandFormLayout } from './CommandFormLayout';
+import { FormGenerationMode } from './FormGenerationMode';
 import { PopulateSource } from './PopulateSource';
 import { FormField } from './FormField';
 import { Behavior } from '../interactions';
@@ -12,6 +14,8 @@ export interface Form {
     name: string;
     forCommand: string;
     populateSource?: PopulateSource;
+    generationMode?: FormGenerationMode;
+    layout?: CommandFormLayout;
     fields: FormField[];
     /**
      * The behaviors attached here - what happens when someone interacts with it. Additive with whatever is
@@ -20,4 +24,4 @@ export interface Form {
     behaviors?: Behavior[];
 }
 
-export const FormPropertyNames: (keyof Form)[] = ['name', 'forCommand', 'populateSource', 'fields', 'behaviors'];
+export const FormPropertyNames: (keyof Form)[] = ['name', 'forCommand', 'populateSource', 'generationMode', 'layout', 'fields', 'behaviors'];

package/forms/FormColumn.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.
+
+import { FormWidth } from './FormWidth';
+
+/**
+ * One column in a command-form geometry grid. Indexes are one-based for authored stability.
+ */
+export interface FormColumn {
+    index: number;
+    width?: FormWidth;
+    minWidth?: FormWidth;
+    maxWidth?: FormWidth;
+}
+
+export const FormColumnPropertyNames: (keyof FormColumn)[] = ['index', 'width', 'minWidth', 'maxWidth'];

package/forms/FormField.ts

@@ -1,6 +1,8 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
+import { FormFieldPlacement } from './FormFieldPlacement';
+
 /**
  * One field of a {@link Form}. Mirrors the three population tiers Screenplay's `form` construct
  * establishes: auto-mapped by name (`sourceProperty` and `composeUsing` both undefined), explicitly
@@ -11,6 +13,7 @@ export interface FormField {
     sourceProperty?: string;
     composeUsing?: string;
     label?: string;
+    placement?: FormFieldPlacement;
 }
 
-export const FormFieldPropertyNames: (keyof FormField)[] = ['name', 'sourceProperty', 'composeUsing', 'label'];
+export const FormFieldPropertyNames: (keyof FormField)[] = ['name', 'sourceProperty', 'composeUsing', 'label', 'placement'];

package/forms/FormFieldPlacement.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 { FormWidth } from './FormWidth';
+
+/**
+ * Authored placement for one command-form field in a platform-neutral grid. Row and column are one-based.
+ */
+export interface FormFieldPlacement {
+    field: string;
+    row: number;
+    column: number;
+    rowSpan?: number;
+    columnSpan?: number;
+    width?: FormWidth;
+}
+
+export const FormFieldPlacementPropertyNames: (keyof FormFieldPlacement)[] = ['field', 'row', 'column', 'rowSpan', 'columnSpan', 'width'];

package/forms/FormGenerationMode.ts

@@ -0,0 +1,10 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+/**
+ * How a command form's fields are generated.
+ */
+export enum FormGenerationMode {
+    Auto = 'auto',
+    Manual = 'manual',
+}

package/forms/FormWidth.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.
+
+import { FormWidthUnit } from './FormWidthUnit';
+
+/**
+ * A platform-neutral width value for form geometry.
+ */
+export interface FormWidth {
+    unit: FormWidthUnit;
+
+    /** The numeric value for fraction, pixel and percent widths. Omitted for `auto`. */
+    value?: number;
+}
+
+export const FormWidthPropertyNames: (keyof FormWidth)[] = ['unit', 'value'];

package/forms/FormWidthUnit.ts

@@ -0,0 +1,12 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+/**
+ * The unit used by a command-form column, gap or field width.
+ */
+export enum FormWidthUnit {
+    Fraction = 'fraction',
+    Pixels = 'pixels',
+    Percent = 'percent',
+    Auto = 'auto',
+}

package/forms/index.ts

@@ -1,8 +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 './CommandFormLayout';
 export * from './Form';
+export * from './FormColumn';
 export * from './FormField';
+export * from './FormFieldPlacement';
+export * from './FormGenerationMode';
+export * from './FormWidth';
+export * from './FormWidthUnit';
 export * from './PopulateSource';
 export * from './PopulateViaQuery';
 export * from './PopulateFromItem';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@cratis/scene.model",
-    "version": "4.11.0",
+    "version": "4.12.0",
     "description": "The TypeScript mirror of Cratis.Scene.Model — the platform-agnostic Screen object model.",
     "keywords": [
         "cratis",