@cratis/scene.model 4.8.0 → 4.9.0

package/layouts/Layout.ts

@@ -4,6 +4,7 @@
 import { Arrangement } from './Arrangement';
 import { Slot } from './Slot';
 import { Behavior } from '../interactions';
+import { Outlet } from '../screens/Outlet';
 import { TemplateMetadata } from '../screens/TemplateMetadata';
 
 /**
@@ -29,8 +30,11 @@ export interface Layout {
      */
     behaviors?: Behavior[];
 
+    /** Named routed replacement surfaces this layout owns. Static slots remain template composition surfaces. */
+    outlets?: Outlet[];
+
     /** Optional browse metadata; ApplicationShell retains this existing Layout role. */
     metadata?: TemplateMetadata;
 }
 
-export const LayoutPropertyNames: (keyof Layout)[] = ['name', 'slots', 'arrangement', 'behaviors', 'metadata'];
+export const LayoutPropertyNames: (keyof Layout)[] = ['name', 'slots', 'arrangement', 'behaviors', 'outlets', 'metadata'];

package/package.json

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

package/packages/ScenePackage.ts

@@ -1,6 +1,7 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
+import { PackageDesignTimeMetadata } from '../descriptors';
 import { IconLibrary } from '../icons';
 import { PackageDependency } from './PackageDependency';
 import { PackageKind } from './PackageKind';
@@ -92,6 +93,15 @@ export interface ScenePackage {
      * What the package declares about its icons. Present exactly for a {@link PackageKind.IconLibrary}.
      */
     iconLibrary?: IconLibrary;
+
+    /** Optional design-time extensions carried as metadata; runtime hosts do not load them unless approved. */
+    designTime?: PackageDesignTimeMetadata;
+
+    /** Asset URLs or package-relative asset entries (CSS, fonts, images) required by a web renderer. */
+    assets?: string[];
+
+    /** Runtime singleton dependency names that must not be duplicated across approved bundles. */
+    runtimeSingletons?: string[];
 }
 
 export const ScenePackagePropertyNames: (keyof ScenePackage)[] = [
@@ -110,4 +120,7 @@ export const ScenePackagePropertyNames: (keyof ScenePackage)[] = [
     'license',
     'licenseUrl',
     'iconLibrary',
+    'designTime',
+    'assets',
+    'runtimeSingletons',
 ];

package/screens/Outlet.ts

@@ -0,0 +1,15 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+/**
+ * A named replacement surface for routed or nested screen content.
+ */
+export interface Outlet {
+    /** Stable outlet name used by destinations. */
+    name: string;
+
+    /** Optional description for designers. */
+    description?: string;
+}
+
+export const OutletPropertyNames: (keyof Outlet)[] = ['name', 'description'];

package/screens/ScreenTemplate.ts

@@ -4,6 +4,7 @@
 import { SceneElement } from '../elements';
 import { Arrangement, Slot } from '../layouts';
 import { Behavior } from '../interactions';
+import { Outlet } from './Outlet';
 import { TemplateMetadata } from './TemplateMetadata';
 
 /**
@@ -65,6 +66,9 @@ export interface ScreenTemplate {
      */
     behaviors?: Behavior[];
 
+    /** Named routed replacement surfaces this template owns. Static slots remain composition surfaces. */
+    outlets?: Outlet[];
+
     /** Optional semantic type, browse category and scope restrictions. */
     metadata?: TemplateMetadata;
 }
@@ -78,5 +82,6 @@ export const ScreenTemplatePropertyNames: (keyof ScreenTemplate)[] = [
     'displayName',
     'description',
     'behaviors',
+    'outlets',
     'metadata',
 ];

package/screens/index.ts

@@ -1,6 +1,7 @@
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 
+export * from './Outlet';
 export * from './Screen';
 export * from './ScreenTemplate';
 export * from './DialogTemplate';