@cratis/scene.model 4.12.0 → 4.13.0

package/package.json

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

package/screens/Outlet.ts

@@ -10,6 +10,13 @@ export interface Outlet {
 
     /** Optional description for designers. */
     description?: string;
+
+    /**
+     * The semantic template types (`TemplateMetadata.type`) a screen must have to be placed in this outlet,
+     * such as `Detail` or `Form`. Absent accepts any screen. A destination that places a screen of another
+     * type here is diagnosed as an incompatible outlet rather than rendered somewhere it was not designed for.
+     */
+    accepts?: string[];
 }
 
-export const OutletPropertyNames: (keyof Outlet)[] = ['name', 'description'];
+export const OutletPropertyNames: (keyof Outlet)[] = ['name', 'description', 'accepts'];

package/screens/TemplateAttribution.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.
+
+/**
+ * Who authored a template and what must accompany it when it is reused.
+ */
+export interface TemplateAttribution {
+    /** The person or organization that authored the template. */
+    author: string;
+
+    /** An absolute `https` URL where the template's source or documentation lives. */
+    url?: string;
+
+    /** An attribution notice a license requires to travel with the template, shown by a template browser. */
+    notice?: string;
+}
+
+export const TemplateAttributionPropertyNames: (keyof TemplateAttribution)[] = ['author', 'url', 'notice'];

package/screens/TemplateCompatibility.ts

@@ -0,0 +1,21 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { PackageDependency } from '../packages/PackageDependency';
+
+/**
+ * Which Scene and package versions a template was authored and verified against.
+ *
+ * A template names components, slots and bindings that only exist in particular versions of Scene and of
+ * the packages that provide them. Declaring the ranges lets a catalog mark a template as incompatible with
+ * the active package set before an author picks it, instead of rendering placeholders after they have.
+ */
+export interface TemplateCompatibility {
+    /** The Scene model version range the template requires, such as `^4.13.0`. */
+    scene: string;
+
+    /** The packages, and their version ranges, whose components or layouts the template uses. */
+    packages?: PackageDependency[];
+}
+
+export const TemplateCompatibilityPropertyNames: (keyof TemplateCompatibility)[] = ['scene', 'packages'];

package/screens/TemplateMetadata.ts

@@ -1,6 +1,9 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
+import { TemplateAttribution } from './TemplateAttribution';
+import { TemplateCompatibility } from './TemplateCompatibility';
+
 /** The application hierarchy at which a reusable template is selected. */
 export enum TemplateScope {
     Application = 'Application',
@@ -21,6 +24,16 @@ export interface TemplateMetadata {
     category?: string;
     /** Explicit scope restriction. Absent uses the structural role; an empty list allows no scope. */
     scopes?: TemplateScope[];
+    /** The Scene and package versions the template requires. Required for every shipped template. */
+    compatibility?: TemplateCompatibility;
+    /** Who authored the template. Required for every shipped template. */
+    attribution?: TemplateAttribution;
+    /** The SPDX license identifier the template is available under, such as `MIT`. Required for every shipped template. */
+    license?: string;
+    /** An absolute `https` URL to the license terms. */
+    licenseUrl?: string;
 }
 
-export const TemplateMetadataPropertyNames: (keyof TemplateMetadata)[] = ['type', 'category', 'scopes'];
+export const TemplateMetadataPropertyNames: (keyof TemplateMetadata)[] = [
+    'type', 'category', 'scopes', 'compatibility', 'attribution', 'license', 'licenseUrl',
+];

package/screens/index.ts

@@ -5,4 +5,6 @@ export * from './Outlet';
 export * from './Screen';
 export * from './ScreenTemplate';
 export * from './DialogTemplate';
+export * from './TemplateAttribution';
+export * from './TemplateCompatibility';
 export * from './TemplateMetadata';