@cratis/scene.blueprint.bookings 0.0.0-stage → 4.71.0

package/README.md

@@ -1,3 +1,67 @@
-# Temporary Holding Version
+# Scene
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**Describing a user interface without describing a platform** — Scene is the UI model of the Cratis
+model-first layer (experimental).
+
+The object model and runtime for Screenplay-based UIs: `Scene.Model` (platform-agnostic screens, layouts,
+forms, contribution points, ui profiles and themes), `Scene.Engine` (binding/resolution runtime), and
+`Scene.React` (the React renderer).
+
+## Packages / Deployables
+
+[![Nuget](https://img.shields.io/nuget/v/Cratis.Scene.Model?logo=nuget)](http://nuget.org/packages/Cratis.Scene.Model)
+[![NPM](https://img.shields.io/npm/v/@cratis/scene.model?label=@cratis/scene.model&logo=npm)](https://www.npmjs.com/package/@cratis/scene.model)
+[![NPM](https://img.shields.io/npm/v/@cratis/scene.engine?label=@cratis/scene.engine&logo=npm)](https://www.npmjs.com/package/@cratis/scene.engine)
+[![NPM](https://img.shields.io/npm/v/@cratis/scene.react?label=@cratis/scene.react&logo=npm)](https://www.npmjs.com/package/@cratis/scene.react)
+
+## Builds
+
+[![.NET Build](https://github.com/cratis/scene/actions/workflows/dotnet-build.yml/badge.svg)](https://github.com/cratis/scene/actions/workflows/dotnet-build.yml)
+[![JavaScript Build](https://github.com/cratis/scene/actions/workflows/javascript-build.yml/badge.svg)](https://github.com/cratis/scene/actions/workflows/javascript-build.yml)
+
+## Description
+
+Scene owns the *object model and runtime* half of the Screenplay stack. In the model-first pipeline,
+[Screenplay](https://github.com/Cratis/Screenplay) describes an event-sourced, CQRS system,
+[Stage](https://github.com/Cratis/Stage) renders it into a running application, and Scene is how that
+application's user interface is described — independently of any rendering platform.
+
+`Scene.Model` is the platform-agnostic
+C# object model that [Stage](https://github.com/Cratis/Stage) translates Screenplay's parsed language constructs into, and that [Studio](https://github.com/Cratis/Studio)'s
+design-time tooling reads and writes. `Scene.Engine` walks that graph, resolves bindings (data, action, form,
+navigation contribution) and drives whichever renderer is plugged in — it does not know React exists.
+`Scene.React` is one renderer implementing the abstract vocabulary against real React/DOM; sibling positions
+are reserved for future `Scene.Native` / `Scene.Desktop` renderers. Vendor and internal component packages
+(PrimeReact, internal widget libraries) are adapters plugging into the renderer contract, not part of it.
+
+The design-time editor built on top of this object model lives in Studio, not here — see
+[StudioIssues#156](https://github.com/Cratis/StudioIssues/issues/156).
+
+## Support
+
+Cratis is an open community, and we are glad to help users, teams evaluating the stack, and contributors.
+
+| Channel | Details |
+|---|---|
+| Discord | Join the community on [Discord](https://discord.gg/kt4AMpV8WV) for questions and discussions |
+| GitHub Issues | [Report bugs or request features](https://github.com/Cratis/Scene/issues) |
+| Documentation | Read the docs at [cratis.io](https://cratis.io) |
+
+## The Cratis ecosystem
+
+This project is part of [Cratis](https://www.cratis.io) — free, MIT-licensed tools for building event-sourced and CQRS applications.
+
+- **[Chronicle](https://github.com/Cratis/Chronicle)** — event-sourcing database and runtime. Orleans-based kernel, pluggable storage (MongoDB default; PostgreSQL, SQL Server, SQLite, in-memory), language-agnostic gRPC contracts. [Docs](https://www.cratis.io/chronicle/)
+- **Chronicle clients** — first-class [.NET SDK](https://github.com/Cratis/Chronicle), plus [TypeScript](https://github.com/Cratis/Chronicle.TypeScript), [Kotlin/Java](https://github.com/Cratis/Chronicle.Kotlin), and [Elixir](https://github.com/Cratis/Chronicle.Elixir); [Python](https://github.com/Cratis/Chronicle.Python) coming soon (pre-alpha). AI agents connect through the [Chronicle MCP server](https://github.com/Cratis/Chronicle.Mcp).
+- **[Arc](https://github.com/Cratis/Arc)** — opinionated CQRS framework for ASP.NET Core with commands, queries, validation, authorization, and TypeScript proxy generation. Works without event sourcing. [Docs](https://www.cratis.io/arc/)
+- **[Components](https://github.com/Cratis/Components)** — React components aligned with Arc patterns. [Docs](https://www.cratis.io/components/)
+- **[CLI](https://github.com/Cratis/cli) + Workbench** — inspect and diagnose Chronicle from the terminal or the browser. [Docs](https://www.cratis.io/cli/)
+- **Model-first layer (experimental)** — [Studio](https://github.com/Cratis/Studio), [Screenplay](https://github.com/Cratis/Screenplay), [Stage](https://github.com/Cratis/Stage), Scene (this repository), [Prologue](https://github.com/Cratis/Prologue)
+- **Supporting** — [Fundamentals](https://github.com/Cratis/Fundamentals), [Specifications](https://github.com/Cratis/Specifications), [Synopsis](https://github.com/Cratis/Synopsis), [Lens](https://github.com/Cratis/Lens), [Narrator](https://github.com/Cratis/Narrator), and free [AI tooling](https://github.com/Cratis/AI) (preview); [Ensemble](https://github.com/Cratis/Ensemble) coming soon (pre-release)
+- **[Samples](https://github.com/Cratis/Samples)** — runnable event sourcing and CQRS samples for the whole stack
+
+Everything Cratis publishes today is MIT licensed and free to use.
+
+---
+
+Part of the [Cratis](https://www.cratis.io) platform · [MIT](./LICENSE)

package/blueprint.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 { ScenePackageBundle } from '@cratis/scene.react';
+import { bookingsBlueprintManifest } from './manifest';
+import { bookingsScreens } from './screens';
+import { bookingsDialogTemplates, bookingsScreenTemplates } from './templates';
+
+/** This blueprint as a loadable bundle: the manifest names things, this provides them. It provides no component - every component is the foundation's. */
+export const bookingsBlueprint: ScenePackageBundle = {
+    manifest: bookingsBlueprintManifest,
+    components: {},
+    screenTemplates: bookingsScreenTemplates,
+    dialogTemplates: bookingsDialogTemplates,
+    screens: bookingsScreens,
+};

package/blueprintCatalog.json

@@ -0,0 +1,123 @@
+{
+  "schema": 1,
+  "blueprints": [
+    {
+      "package": "Cratis.Blueprint.Bookings",
+      "version": "1.0.0",
+      "domain": "bookings",
+      "displayName": "Bookings",
+      "description": "Bookings for shared rooms, equipment and vehicles: a booking calendar, a booking list, a booking page, the resources and a wizard that books one in four steps.",
+      "thumbnail": "thumbnails/bookings.svg",
+      "license": "MIT",
+      "licenseUrl": "https://github.com/Cratis/Scene/blob/main/LICENSE",
+      "dependencies": [
+        {
+          "name": "Cratis.Blueprint.Default",
+          "versionRange": "^1.0.0"
+        }
+      ],
+      "screens": [
+        {
+          "name": "bookings.calendar",
+          "title": "Calendar",
+          "description": "Every booking on a calendar: who has what, and when.",
+          "template": "BookingsCalendar",
+          "order": 0
+        },
+        {
+          "name": "bookings.list",
+          "title": "Bookings",
+          "description": "Every booking with its resource, time and status.",
+          "template": "BookingsList",
+          "order": 1
+        },
+        {
+          "name": "bookings.record",
+          "title": "Booking",
+          "description": "One booking: key facts, its attendees, its extras and its activity.",
+          "template": "BookingPage",
+          "parent": "bookings.list"
+        },
+        {
+          "name": "bookings.resources",
+          "title": "Resources",
+          "description": "The rooms, equipment and vehicles that can be booked.",
+          "template": "ResourcesList",
+          "order": 2
+        },
+        {
+          "name": "bookings.new",
+          "title": "New booking",
+          "description": "Book a room, equipment or a vehicle in four short steps.",
+          "template": "NewBookingWizard",
+          "order": 3
+        }
+      ],
+      "templates": [
+        {
+          "name": "BookingsCalendar",
+          "kind": "ScreenTemplate",
+          "displayName": "Bookings calendar",
+          "description": "Every booking on the day it falls, on a month, a week or as an agenda, with the status told in words.",
+          "type": "Calendar",
+          "category": "Business / Bookings",
+          "thumbnail": "thumbnails/BookingsCalendar.svg"
+        },
+        {
+          "name": "BookingsList",
+          "kind": "ScreenTemplate",
+          "displayName": "Bookings list",
+          "description": "Every booking with its resource, who booked it, date and time and status, filtered by resource, status, person and date.",
+          "type": "List",
+          "category": "Business / Bookings",
+          "thumbnail": "thumbnails/BookingsList.svg"
+        },
+        {
+          "name": "BookingPage",
+          "kind": "ScreenTemplate",
+          "displayName": "Booking page",
+          "description": "One booking: status, date, hours and people, its details, attendees and extras, and its activity.",
+          "type": "Detail",
+          "category": "Business / Bookings",
+          "thumbnail": "thumbnails/BookingPage.svg"
+        },
+        {
+          "name": "ResourcesList",
+          "kind": "ScreenTemplate",
+          "displayName": "Resources list",
+          "description": "The rooms, equipment and vehicles that can be booked, with their capacity, location and whether each is free.",
+          "type": "List",
+          "category": "Business / Bookings",
+          "thumbnail": "thumbnails/ResourcesList.svg"
+        },
+        {
+          "name": "NewBookingWizard",
+          "kind": "ScreenTemplate",
+          "displayName": "New booking wizard",
+          "description": "Resource, time, details, then review and book; the step survives a refresh and an invalid step blocks Next and says why.",
+          "type": "Wizard",
+          "category": "Business / Bookings",
+          "thumbnail": "thumbnails/NewBookingWizard.svg"
+        },
+        {
+          "name": "BookingsQuickCreateBooking",
+          "kind": "DialogTemplate",
+          "displayName": "Bookings quick create booking",
+          "description": "A short form that creates one booking without leaving the page.",
+          "type": "Dialog",
+          "category": "Business / Bookings",
+          "thumbnail": "thumbnails/BookingsQuickCreateBooking.svg"
+        }
+      ],
+      "sampleData": [
+        {
+          "id": "bookings-en",
+          "title": "Bookings · English",
+          "locale": "en-GB",
+          "path": "sampleData/bookings-en.json",
+          "default": true
+        }
+      ]
+    }
+  ]
+}

package/bookingsApplication.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.
+
+import { UiProfile } from '@cratis/scene.model';
+import { ApplicationStructureIndex } from '@cratis/scene.engine';
+import { ApplicationDocument, CompositionOptions, defaultLayouts, previewProfile } from '@cratis/scene.blueprint.default';
+import { bookingsNavigation, bookingsStructure } from './navigation';
+import { bookingsScreens } from './screens';
+import { bookingsDialogTemplates, bookingsScreenTemplates } from './templates';
+
+/** The id of the sample-data pack a new application starts with. */
+export const bookingsDefaultSampleDataId = 'bookings-en';
+
+/**
+ * The example application of the blueprint: the foundation's layouts, the Bookings templates, the quick-create dialogs and their 5 screens, rendering against the
+ * foundation's packages with the default sample-data pack chosen. This is what a gallery previews and what the conformance fixture
+ * (`Samples/Bookings/bookings.play`) declares in Screenplay: the document, the structure and the navigation are the three things an application is made of.
+ */
+export function bookingsApplication(sampleData: string = bookingsDefaultSampleDataId): ApplicationDocument {
+    const profile: UiProfile = { ...previewProfile(undefined), name: 'Bookings', sampleData: { activePack: sampleData, mappings: [], bindings: [] } };
+    return { layouts: defaultLayouts, screenTemplates: bookingsScreenTemplates, dialogTemplates: bookingsDialogTemplates, screens: bookingsScreens, uiProfiles: [profile] };
+}
+
+/** What a host composes the screens with: the application's logo, which the shell's topbar shows. */
+export const bookingsComposition: CompositionOptions = { logo: bookingsNavigation.application.logo };
+
+/** The structure and navigation the shell's regions show and the items' destinations resolve against. */
+export const bookingsNavigationModel = () => ({ structure: new ApplicationStructureIndex(bookingsStructure), navigation: bookingsNavigation });

package/bookingsParts.ts

@@ -0,0 +1,58 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import {
+    Behavior, BindingSourceKind, DialogTemplate, ExternalComponent, InteractionActionKind, InteractionTriggerKind, NavigateAction, OpenDialogAction, SceneElement, ScreenTemplate, TemplateMetadata, TemplateScope,
+} from '@cratis/scene.model';
+import { component, panel } from '@cratis/scene.blueprint.default';
+import { bookingsTemplateProvenance } from './templateProvenance';
+
+export { component, panel };
+
+/** The category of every template of this blueprint (spec Part B 1.2: `Business / <domain>`). */
+export const bookingsCategory = 'Business / Bookings';
+
+/** The package-relative thumbnail of a template. */
+export const thumbnailOf = (templateName: string): string => `thumbnails/${templateName}.svg`;
+
+/** The metadata of a screen template of this blueprint: provenance, a type from the vocabulary, the category, a thumbnail and the levels it applies at. */
+export const bookingsMetadata = (name: string, type: 'Dashboard' | 'List' | 'Board' | 'Detail' | 'Form' | 'Dialog' | 'Workspace' | 'Calendar' | 'Timeline' | 'Inbox' | 'Profile' | 'Wizard', scopes: TemplateScope[]): TemplateMetadata =>
+    ({ ...bookingsTemplateProvenance, type, category: bookingsCategory, thumbnail: thumbnailOf(name), scopes });
+
+/** A button of the foundation: a verb, its emphasis, and the permission rule every action declares (spec Part B 1.5). */
+export const actionButton = (id: string, label: string, emphasis: 'primary' | 'secondary' | 'quiet' | 'danger', extra: Record<string, unknown> = {}, behaviors?: Behavior[]): ExternalComponent =>
+    ({ ...component(id, 'actionButton', { label, emphasis, permission: 'enabled', ...extra }), ...(behaviors ? { behaviors } : {}) });
+
+/** What pressing an element does: open the named dialog template over the page. */
+export const opensDialog = (dialogTemplate: string): Behavior[] =>
+    [{ bindings: [{ trigger: { kind: InteractionTriggerKind.Click }, actions: [{ kind: InteractionActionKind.OpenDialog, dialogTemplate } as OpenDialogAction] }] }];
+
+/** What pressing an element does: go to the named screen. */
+export const goesTo = (screen: string): Behavior[] =>
+    [{ bindings: [{ trigger: { kind: InteractionTriggerKind.Click }, actions: [{ kind: InteractionActionKind.Navigate, screen } as NavigateAction] }] }];
+
+/**
+ * What choosing a row of a list does: open the record page, handing it the chosen row's id. The list is single-selection, so choosing a row is
+ * opening it - the way a table of records works everywhere.
+ */
+export const opensRecordOnSelect = (listId: string, screen: string): Behavior[] => [{
+    bindings: [{
+        trigger: { kind: InteractionTriggerKind.Select },
+        actions: [{ kind: InteractionActionKind.Navigate, screen, arguments: [{ name: 'id', value: { kind: BindingSourceKind.ComponentProperty, componentId: listId, path: 'value' } }] } as NavigateAction],
+    }],
+}];
+
+/**
+ * What choosing a row of a list does: open the named dialog over the page - a side sheet with the row's detail, so the list stays where it was.
+ */
+export const opensDialogOnSelect = (dialogTemplate: string): Behavior[] =>
+    [{ bindings: [{ trigger: { kind: InteractionTriggerKind.Select }, actions: [{ kind: InteractionActionKind.OpenDialog, dialogTemplate } as OpenDialogAction] }] }];
+
+/** What a Cancel or Close control does: close the dialog it was opened from. */
+export const closesDialog = (): Behavior[] => [{ bindings: [{ trigger: { kind: InteractionTriggerKind.Click }, actions: [{ kind: InteractionActionKind.CloseDialog }] }] }];
+
+/** An element with the given behaviors attached. */
+export const withBehaviors = <T extends SceneElement>(element: T, behaviors: Behavior[]): T => ({ ...element, behaviors });
+
+export type BookingsScreenTemplate = ScreenTemplate;
+export type BookingsDialogTemplate = DialogTemplate;

package/bookingsQueries.ts

@@ -0,0 +1,60 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { BindingExpression, BindingSourceKind } from '@cratis/scene.model';
+
+/**
+ * A property taken from a query result - never a value. A bookings template declares *where* its data comes from and the sample-data pack, or the real
+ * query, supplies the rows (spec SD1); `path` reaches into the result (`0.value` is the first row's `value`, an empty path is the whole result).
+ */
+export const fromQuery = (query: string, path = ''): BindingExpression => ({ kind: BindingSourceKind.QueryResult, query, path });
+
+/** The queries of the screens that are not a plain list. Each is a shape the sample-data pack supplies rows for. */
+export const BookingsQuery = {
+    /** One row: the `locale` and `currency` the figures and dates are formatted in. */
+    Settings: 'BookingsSettings',
+    BookingEvents: 'BookingEvents',
+    BookingEventColumns: 'BookingEventColumns',
+    BookingWizardSteps: 'BookingWizardSteps',
+    BookingResourceSections: 'BookingResourceSections',
+    BookingWhenSections: 'BookingWhenSections',
+    BookingDetailSections: 'BookingDetailSections',
+    BookingReviewSections: 'BookingReviewSections',
+    BookingReviewValues: 'BookingReviewValues',
+    FormErrors: 'BookingsFormErrors',
+} as const;
+
+/** The entities a template is made for. */
+export enum BookingsEntityKind {
+    Booking = 'Booking',
+    Resource = 'Resource',
+}
+
+/** The read model (and so the shape) the records of each entity are queried from. */
+export const bookingsEntityPlural: Record<BookingsEntityKind, string> = {
+    [BookingsEntityKind.Booking]: 'Bookings',
+    [BookingsEntityKind.Resource]: 'Resources',
+};
+
+/**
+ * The queries one entity's templates bind to, named from the entity so a template never spells one out: the records, the columns and filter fields of the
+ * list, its saved views and column choices, the selection, the sections of the quick form, and what the record page shows.
+ */
+export const bookingsQueriesOf = (entity: BookingsEntityKind) => ({
+    rows: bookingsEntityPlural[entity],
+    columns: `${entity}Columns`,
+    filterFields: `${entity}FilterFields`,
+    views: `${entity}Views`,
+    columnChoices: `${entity}ColumnChoices`,
+    selection: `${entity}Selection`,
+    quickSections: `${entity}QuickSections`,
+    record: `${entity}Record`,
+    sections: `${entity}Sections`,
+    summary: `${entity}Summary`,
+    activity: `${entity}Activity`,
+    tabs: `${entity}Tabs`,
+});
+
+/** The locale and currency of the data, bound onto every component that formats a figure or a date. */
+export const localeOfData = { locale: fromQuery(BookingsQuery.Settings, '0.locale') };
+export const currencyOfData = { ...localeOfData, currency: fromQuery(BookingsQuery.Settings, '0.currency') };

package/bookingsScreenSet.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.
+
+import { BlueprintScreen } from '@cratis/scene.model';
+
+/** One ready-to-use screen: the qualified name that is also its place in the application (`bookings.list.record` would be the `record` feature of `list`). */
+export interface BookingsScreenDefinition extends BlueprintScreen {
+    template: string;
+    description: string;
+}
+
+/**
+ * The screens the blueprint brings, in navigation order. This one list is what the manifest's screen set, the `Screen` instances, the application structure
+ * and the navigation are all derived from, so they cannot disagree about which screens exist or where they sit.
+ */
+export const bookingsScreenDefinitions: BookingsScreenDefinition[] = [
+    { name: 'bookings.calendar', title: 'Calendar', template: 'BookingsCalendar', order: 0, description: 'Every booking on a calendar: who has what, and when.' },
+    { name: 'bookings.list', title: 'Bookings', template: 'BookingsList', order: 1, description: 'Every booking with its resource, time and status.' },
+    { name: 'bookings.record', title: 'Booking', template: 'BookingPage', parent: 'bookings.list', description: 'One booking: key facts, its attendees, its extras and its activity.' },
+    { name: 'bookings.resources', title: 'Resources', template: 'ResourcesList', order: 2, description: 'The rooms, equipment and vehicles that can be booked.' },
+    { name: 'bookings.new', title: 'New booking', template: 'NewBookingWizard', order: 3, description: 'Book a room, equipment or a vehicle in four short steps.' },
+];

package/dist/cjs/blueprint.js

@@ -0,0 +1,19 @@
+'use strict';
+
+var manifest = require('./manifest.js');
+var index = require('./screens/index.js');
+var index$1 = require('./templates/index.js');
+var formTemplates = require('./templates/formTemplates.js');
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/** This blueprint as a loadable bundle: the manifest names things, this provides them. It provides no component - every component is the foundation's. */ const bookingsBlueprint = {
+    manifest: manifest.bookingsBlueprintManifest,
+    components: {},
+    screenTemplates: index$1.bookingsScreenTemplates,
+    dialogTemplates: formTemplates.bookingsDialogs,
+    screens: index.bookingsScreens
+};
+
+exports.bookingsBlueprint = bookingsBlueprint;
+//# sourceMappingURL=blueprint.js.map

package/dist/cjs/blueprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blueprint.js","sources":["../../blueprint.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 { ScenePackageBundle } from '@cratis/scene.react';\nimport { bookingsBlueprintManifest } from './manifest';\nimport { bookingsScreens } from './screens';\nimport { bookingsDialogTemplates, bookingsScreenTemplates } from './templates';\n\n/** This blueprint as a loadable bundle: the manifest names things, this provides them. It provides no component - every component is the foundation's. */\nexport const bookingsBlueprint: ScenePackageBundle = {\n    manifest: bookingsBlueprintManifest,\n    components: {},\n    screenTemplates: bookingsScreenTemplates,\n    dialogTemplates: bookingsDialogTemplates,\n    screens: bookingsScreens,\n};\n"],"names":["bookingsBlueprint","manifest","bookingsBlueprintManifest","components","screenTemplates","bookingsScreenTemplates","dialogTemplates","bookingsDialogTemplates","screens","bookingsScreens"],"mappings":";;;;;;;AAAA;AACA;AAOA,2JACO,MAAMA,iBAAAA,GAAwC;IACjDC,QAAAA,EAAUC,kCAAAA;AACVC,IAAAA,UAAAA,EAAY,EAAC;IACbC,eAAAA,EAAiBC,+BAAAA;IACjBC,eAAAA,EAAiBC,6BAAAA;IACjBC,OAAAA,EAASC;AACb;;"}

package/dist/cjs/bookingsApplication.js

@@ -0,0 +1,49 @@
+'use strict';
+
+var scene_engine = require('@cratis/scene.engine');
+var scene_blueprint_default = require('@cratis/scene.blueprint.default');
+var navigation = require('./navigation.js');
+var index = require('./screens/index.js');
+var index$1 = require('./templates/index.js');
+var formTemplates = require('./templates/formTemplates.js');
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/** The id of the sample-data pack a new application starts with. */ const bookingsDefaultSampleDataId = 'bookings-en';
+/**
+ * The example application of the blueprint: the foundation's layouts, the Bookings templates, the quick-create dialogs and their 5 screens, rendering against the
+ * foundation's packages with the default sample-data pack chosen. This is what a gallery previews and what the conformance fixture
+ * (`Samples/Bookings/bookings.play`) declares in Screenplay: the document, the structure and the navigation are the three things an application is made of.
+ */ function bookingsApplication(sampleData = bookingsDefaultSampleDataId) {
+    const profile = {
+        ...scene_blueprint_default.previewProfile(undefined),
+        name: 'Bookings',
+        sampleData: {
+            activePack: sampleData,
+            mappings: [],
+            bindings: []
+        }
+    };
+    return {
+        layouts: scene_blueprint_default.defaultLayouts,
+        screenTemplates: index$1.bookingsScreenTemplates,
+        dialogTemplates: formTemplates.bookingsDialogs,
+        screens: index.bookingsScreens,
+        uiProfiles: [
+            profile
+        ]
+    };
+}
+/** What a host composes the screens with: the application's logo, which the shell's topbar shows. */ const bookingsComposition = {
+    logo: navigation.bookingsNavigation.application.logo
+};
+/** The structure and navigation the shell's regions show and the items' destinations resolve against. */ const bookingsNavigationModel = ()=>({
+        structure: new scene_engine.ApplicationStructureIndex(navigation.bookingsStructure),
+        navigation: navigation.bookingsNavigation
+    });
+
+exports.bookingsApplication = bookingsApplication;
+exports.bookingsComposition = bookingsComposition;
+exports.bookingsDefaultSampleDataId = bookingsDefaultSampleDataId;
+exports.bookingsNavigationModel = bookingsNavigationModel;
+//# sourceMappingURL=bookingsApplication.js.map

package/dist/cjs/bookingsApplication.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bookingsApplication.js","sources":["../../bookingsApplication.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 { UiProfile } from '@cratis/scene.model';\nimport { ApplicationStructureIndex } from '@cratis/scene.engine';\nimport { ApplicationDocument, CompositionOptions, defaultLayouts, previewProfile } from '@cratis/scene.blueprint.default';\nimport { bookingsNavigation, bookingsStructure } from './navigation';\nimport { bookingsScreens } from './screens';\nimport { bookingsDialogTemplates, bookingsScreenTemplates } from './templates';\n\n/** The id of the sample-data pack a new application starts with. */\nexport const bookingsDefaultSampleDataId = 'bookings-en';\n\n/**\n * The example application of the blueprint: the foundation's layouts, the Bookings templates, the quick-create dialogs and their 5 screens, rendering against the\n * foundation's packages with the default sample-data pack chosen. This is what a gallery previews and what the conformance fixture\n * (`Samples/Bookings/bookings.play`) declares in Screenplay: the document, the structure and the navigation are the three things an application is made of.\n */\nexport function bookingsApplication(sampleData: string = bookingsDefaultSampleDataId): ApplicationDocument {\n    const profile: UiProfile = { ...previewProfile(undefined), name: 'Bookings', sampleData: { activePack: sampleData, mappings: [], bindings: [] } };\n    return { layouts: defaultLayouts, screenTemplates: bookingsScreenTemplates, dialogTemplates: bookingsDialogTemplates, screens: bookingsScreens, uiProfiles: [profile] };\n}\n\n/** What a host composes the screens with: the application's logo, which the shell's topbar shows. */\nexport const bookingsComposition: CompositionOptions = { logo: bookingsNavigation.application.logo };\n\n/** The structure and navigation the shell's regions show and the items' destinations resolve against. */\nexport const bookingsNavigationModel = () => ({ structure: new ApplicationStructureIndex(bookingsStructure), navigation: bookingsNavigation });\n"],"names":["bookingsDefaultSampleDataId","bookingsApplication","sampleData","profile","previewProfile","undefined","name","activePack","mappings","bindings","layouts","defaultLayouts","screenTemplates","bookingsScreenTemplates","dialogTemplates","bookingsDialogTemplates","screens","bookingsScreens","uiProfiles","bookingsComposition","logo","bookingsNavigation","application","bookingsNavigationModel","structure","ApplicationStructureIndex","bookingsStructure","navigation"],"mappings":";;;;;;;;;AAAA;AACA;AASA,qEACO,MAAMA,2BAAAA,GAA8B;AAE3C;;;;AAIC,IACM,SAASC,mBAAAA,CAAoBC,UAAAA,GAAqBF,2BAA2B,EAAA;AAChF,IAAA,MAAMG,OAAAA,GAAqB;AAAE,QAAA,GAAGC,uCAAeC,SAAAA,CAAU;QAAEC,IAAAA,EAAM,UAAA;QAAYJ,UAAAA,EAAY;YAAEK,UAAAA,EAAYL,UAAAA;AAAYM,YAAAA,QAAAA,EAAU,EAAE;AAAEC,YAAAA,QAAAA,EAAU;AAAG;AAAE,KAAA;IAChJ,OAAO;QAAEC,OAAAA,EAASC,sCAAAA;QAAgBC,eAAAA,EAAiBC,+BAAAA;QAAyBC,eAAAA,EAAiBC,6BAAAA;QAAyBC,OAAAA,EAASC,qBAAAA;QAAiBC,UAAAA,EAAY;AAACf,YAAAA;AAAQ;AAAC,KAAA;AAC1K;AAEA,sGACO,MAAMgB,mBAAAA,GAA0C;IAAEC,IAAAA,EAAMC,6BAAAA,CAAmBC,WAAW,CAACF;AAAK;AAEnG,0GACO,MAAMG,uBAAAA,GAA0B,KAAO;AAAEC,QAAAA,SAAAA,EAAW,IAAIC,sCAAAA,CAA0BC,4BAAAA,CAAAA;QAAoBC,UAAAA,EAAYN;AAAmB,KAAA;;;;;"}

package/dist/cjs/bookingsParts.js

@@ -0,0 +1,151 @@
+'use strict';
+
+var scene_model = require('@cratis/scene.model');
+var scene_blueprint_default = require('@cratis/scene.blueprint.default');
+var templateProvenance = require('./templateProvenance.js');
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/** The category of every template of this blueprint (spec Part B 1.2: `Business / <domain>`). */ const bookingsCategory = 'Business / Bookings';
+/** The package-relative thumbnail of a template. */ const thumbnailOf = (templateName)=>`thumbnails/${templateName}.svg`;
+/** The metadata of a screen template of this blueprint: provenance, a type from the vocabulary, the category, a thumbnail and the levels it applies at. */ const bookingsMetadata = (name, type, scopes)=>({
+        ...templateProvenance.bookingsTemplateProvenance,
+        type,
+        category: bookingsCategory,
+        thumbnail: thumbnailOf(name),
+        scopes
+    });
+/** A button of the foundation: a verb, its emphasis, and the permission rule every action declares (spec Part B 1.5). */ const actionButton = (id, label, emphasis, extra = {}, behaviors)=>({
+        ...scene_blueprint_default.component(id, 'actionButton', {
+            label,
+            emphasis,
+            permission: 'enabled',
+            ...extra
+        }),
+        ...behaviors ? {
+            behaviors
+        } : {}
+    });
+/** What pressing an element does: open the named dialog template over the page. */ const opensDialog = (dialogTemplate)=>[
+        {
+            bindings: [
+                {
+                    trigger: {
+                        kind: scene_model.InteractionTriggerKind.Click
+                    },
+                    actions: [
+                        {
+                            kind: scene_model.InteractionActionKind.OpenDialog,
+                            dialogTemplate
+                        }
+                    ]
+                }
+            ]
+        }
+    ];
+/** What pressing an element does: go to the named screen. */ const goesTo = (screen)=>[
+        {
+            bindings: [
+                {
+                    trigger: {
+                        kind: scene_model.InteractionTriggerKind.Click
+                    },
+                    actions: [
+                        {
+                            kind: scene_model.InteractionActionKind.Navigate,
+                            screen
+                        }
+                    ]
+                }
+            ]
+        }
+    ];
+/**
+ * What choosing a row of a list does: open the record page, handing it the chosen row's id. The list is single-selection, so choosing a row is
+ * opening it - the way a table of records works everywhere.
+ */ const opensRecordOnSelect = (listId, screen)=>[
+        {
+            bindings: [
+                {
+                    trigger: {
+                        kind: scene_model.InteractionTriggerKind.Select
+                    },
+                    actions: [
+                        {
+                            kind: scene_model.InteractionActionKind.Navigate,
+                            screen,
+                            arguments: [
+                                {
+                                    name: 'id',
+                                    value: {
+                                        kind: scene_model.BindingSourceKind.ComponentProperty,
+                                        componentId: listId,
+                                        path: 'value'
+                                    }
+                                }
+                            ]
+                        }
+                    ]
+                }
+            ]
+        }
+    ];
+/**
+ * What choosing a row of a list does: open the named dialog over the page - a side sheet with the row's detail, so the list stays where it was.
+ */ const opensDialogOnSelect = (dialogTemplate)=>[
+        {
+            bindings: [
+                {
+                    trigger: {
+                        kind: scene_model.InteractionTriggerKind.Select
+                    },
+                    actions: [
+                        {
+                            kind: scene_model.InteractionActionKind.OpenDialog,
+                            dialogTemplate
+                        }
+                    ]
+                }
+            ]
+        }
+    ];
+/** What a Cancel or Close control does: close the dialog it was opened from. */ const closesDialog = ()=>[
+        {
+            bindings: [
+                {
+                    trigger: {
+                        kind: scene_model.InteractionTriggerKind.Click
+                    },
+                    actions: [
+                        {
+                            kind: scene_model.InteractionActionKind.CloseDialog
+                        }
+                    ]
+                }
+            ]
+        }
+    ];
+/** An element with the given behaviors attached. */ const withBehaviors = (element, behaviors)=>({
+        ...element,
+        behaviors
+    });
+
+Object.defineProperty(exports, "component", {
+    enumerable: true,
+    get: function () { return scene_blueprint_default.component; }
+});
+Object.defineProperty(exports, "panel", {
+    enumerable: true,
+    get: function () { return scene_blueprint_default.panel; }
+});
+exports.actionButton = actionButton;
+exports.bookingsCategory = bookingsCategory;
+exports.bookingsMetadata = bookingsMetadata;
+exports.closesDialog = closesDialog;
+exports.goesTo = goesTo;
+exports.opensDialog = opensDialog;
+exports.opensDialogOnSelect = opensDialogOnSelect;
+exports.opensRecordOnSelect = opensRecordOnSelect;
+exports.thumbnailOf = thumbnailOf;
+exports.withBehaviors = withBehaviors;
+//# sourceMappingURL=bookingsParts.js.map

package/dist/cjs/bookingsParts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bookingsParts.js","sources":["../../bookingsParts.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 {\n    Behavior, BindingSourceKind, DialogTemplate, ExternalComponent, InteractionActionKind, InteractionTriggerKind, NavigateAction, OpenDialogAction, SceneElement, ScreenTemplate, TemplateMetadata, TemplateScope,\n} from '@cratis/scene.model';\nimport { component, panel } from '@cratis/scene.blueprint.default';\nimport { bookingsTemplateProvenance } from './templateProvenance';\n\nexport { component, panel };\n\n/** The category of every template of this blueprint (spec Part B 1.2: `Business / <domain>`). */\nexport const bookingsCategory = 'Business / Bookings';\n\n/** The package-relative thumbnail of a template. */\nexport const thumbnailOf = (templateName: string): string => `thumbnails/${templateName}.svg`;\n\n/** The metadata of a screen template of this blueprint: provenance, a type from the vocabulary, the category, a thumbnail and the levels it applies at. */\nexport const bookingsMetadata = (name: string, type: 'Dashboard' | 'List' | 'Board' | 'Detail' | 'Form' | 'Dialog' | 'Workspace' | 'Calendar' | 'Timeline' | 'Inbox' | 'Profile' | 'Wizard', scopes: TemplateScope[]): TemplateMetadata =>\n    ({ ...bookingsTemplateProvenance, type, category: bookingsCategory, thumbnail: thumbnailOf(name), scopes });\n\n/** A button of the foundation: a verb, its emphasis, and the permission rule every action declares (spec Part B 1.5). */\nexport const actionButton = (id: string, label: string, emphasis: 'primary' | 'secondary' | 'quiet' | 'danger', extra: Record<string, unknown> = {}, behaviors?: Behavior[]): ExternalComponent =>\n    ({ ...component(id, 'actionButton', { label, emphasis, permission: 'enabled', ...extra }), ...(behaviors ? { behaviors } : {}) });\n\n/** What pressing an element does: open the named dialog template over the page. */\nexport const opensDialog = (dialogTemplate: string): Behavior[] =>\n    [{ bindings: [{ trigger: { kind: InteractionTriggerKind.Click }, actions: [{ kind: InteractionActionKind.OpenDialog, dialogTemplate } as OpenDialogAction] }] }];\n\n/** What pressing an element does: go to the named screen. */\nexport const goesTo = (screen: string): Behavior[] =>\n    [{ bindings: [{ trigger: { kind: InteractionTriggerKind.Click }, actions: [{ kind: InteractionActionKind.Navigate, screen } as NavigateAction] }] }];\n\n/**\n * What choosing a row of a list does: open the record page, handing it the chosen row's id. The list is single-selection, so choosing a row is\n * opening it - the way a table of records works everywhere.\n */\nexport const opensRecordOnSelect = (listId: string, screen: string): Behavior[] => [{\n    bindings: [{\n        trigger: { kind: InteractionTriggerKind.Select },\n        actions: [{ kind: InteractionActionKind.Navigate, screen, arguments: [{ name: 'id', value: { kind: BindingSourceKind.ComponentProperty, componentId: listId, path: 'value' } }] } as NavigateAction],\n    }],\n}];\n\n/**\n * What choosing a row of a list does: open the named dialog over the page - a side sheet with the row's detail, so the list stays where it was.\n */\nexport const opensDialogOnSelect = (dialogTemplate: string): Behavior[] =>\n    [{ bindings: [{ trigger: { kind: InteractionTriggerKind.Select }, actions: [{ kind: InteractionActionKind.OpenDialog, dialogTemplate } as OpenDialogAction] }] }];\n\n/** What a Cancel or Close control does: close the dialog it was opened from. */\nexport const closesDialog = (): Behavior[] => [{ bindings: [{ trigger: { kind: InteractionTriggerKind.Click }, actions: [{ kind: InteractionActionKind.CloseDialog }] }] }];\n\n/** An element with the given behaviors attached. */\nexport const withBehaviors = <T extends SceneElement>(element: T, behaviors: Behavior[]): T => ({ ...element, behaviors });\n\nexport type BookingsScreenTemplate = ScreenTemplate;\nexport type BookingsDialogTemplate = DialogTemplate;\n"],"names":["bookingsCategory","thumbnailOf","templateName","bookingsMetadata","name","type","scopes","bookingsTemplateProvenance","category","thumbnail","actionButton","id","label","emphasis","extra","behaviors","component","permission","opensDialog","dialogTemplate","bindings","trigger","kind","InteractionTriggerKind","Click","actions","InteractionActionKind","OpenDialog","goesTo","screen","Navigate","opensRecordOnSelect","listId","Select","arguments","value","BindingSourceKind","ComponentProperty","componentId","path","opensDialogOnSelect","closesDialog","CloseDialog","withBehaviors","element"],"mappings":";;;;;;AAAA;AACA;AAUA,kGACO,MAAMA,gBAAAA,GAAmB;AAEhC,qDACO,MAAMC,WAAAA,GAAc,CAACC,YAAAA,GAAiC,CAAC,WAAW,EAAEA,YAAAA,CAAa,IAAI;AAE5F,4JACO,MAAMC,gBAAAA,GAAmB,CAACC,IAAAA,EAAcC,IAAAA,EAA8IC,UACxL;AAAE,QAAA,GAAGC,6CAA0B;AAAEF,QAAAA,IAAAA;QAAMG,QAAAA,EAAUR,gBAAAA;AAAkBS,QAAAA,SAAAA,EAAWR,WAAAA,CAAYG,IAAAA,CAAAA;AAAOE,QAAAA;AAAO,KAAA;AAE7G,0HACO,MAAMI,YAAAA,GAAe,CAACC,EAAAA,EAAYC,KAAAA,EAAeC,QAAAA,EAAwDC,KAAAA,GAAiC,EAAE,EAAEC,aAChJ;QAAE,GAAGC,iCAAAA,CAAUL,IAAI,cAAA,EAAgB;AAAEC,YAAAA,KAAAA;AAAOC,YAAAA,QAAAA;YAAUI,UAAAA,EAAY,SAAA;AAAW,YAAA,GAAGH;SAAM,CAAE;AAAE,QAAA,GAAIC,SAAAA,GAAY;AAAEA,YAAAA;AAAU,SAAA,GAAI;AAAI,KAAA;AAEnI,oFACO,MAAMG,WAAAA,GAAc,CAACC,cAAAA,GACxB;AAAC,QAAA;YAAEC,QAAAA,EAAU;AAAC,gBAAA;oBAAEC,OAAAA,EAAS;AAAEC,wBAAAA,IAAAA,EAAMC,mCAAuBC;AAAM,qBAAA;oBAAGC,OAAAA,EAAS;AAAC,wBAAA;AAAEH,4BAAAA,IAAAA,EAAMI,kCAAsBC,UAAU;AAAER,4BAAAA;AAAe;AAAsB;AAAC;AAAE;AAAC;;AAElK,8DACO,MAAMS,MAAAA,GAAS,CAACC,MAAAA,GACnB;AAAC,QAAA;YAAET,QAAAA,EAAU;AAAC,gBAAA;oBAAEC,OAAAA,EAAS;AAAEC,wBAAAA,IAAAA,EAAMC,mCAAuBC;AAAM,qBAAA;oBAAGC,OAAAA,EAAS;AAAC,wBAAA;AAAEH,4BAAAA,IAAAA,EAAMI,kCAAsBI,QAAQ;AAAED,4BAAAA;AAAO;AAAoB;AAAC;AAAE;AAAC;;AAEtJ;;;AAGC,IACM,MAAME,mBAAAA,GAAsB,CAACC,QAAgBH,MAAAA,GAA+B;AAAC,QAAA;YAChFT,QAAAA,EAAU;AAAC,gBAAA;oBACPC,OAAAA,EAAS;AAAEC,wBAAAA,IAAAA,EAAMC,mCAAuBU;AAAO,qBAAA;oBAC/CR,OAAAA,EAAS;AAAC,wBAAA;AAAEH,4BAAAA,IAAAA,EAAMI,kCAAsBI,QAAQ;AAAED,4BAAAA,MAAAA;4BAAQK,SAAAA,EAAW;AAAC,gCAAA;oCAAE9B,IAAAA,EAAM,IAAA;oCAAM+B,KAAAA,EAAO;AAAEb,wCAAAA,IAAAA,EAAMc,8BAAkBC,iBAAiB;wCAAEC,WAAAA,EAAaN,MAAAA;wCAAQO,IAAAA,EAAM;AAAQ;AAAE;AAAE;AAAC;AAAoB;AACxM;AAAE;AACN;;AAEA;;AAEC,IACM,MAAMC,mBAAAA,GAAsB,CAACrB,cAAAA,GAChC;AAAC,QAAA;YAAEC,QAAAA,EAAU;AAAC,gBAAA;oBAAEC,OAAAA,EAAS;AAAEC,wBAAAA,IAAAA,EAAMC,mCAAuBU;AAAO,qBAAA;oBAAGR,OAAAA,EAAS;AAAC,wBAAA;AAAEH,4BAAAA,IAAAA,EAAMI,kCAAsBC,UAAU;AAAER,4BAAAA;AAAe;AAAsB;AAAC;AAAE;AAAC;;AAEnK,iFACO,MAAMsB,YAAAA,GAAe,IAAkB;AAAC,QAAA;YAAErB,QAAAA,EAAU;AAAC,gBAAA;oBAAEC,OAAAA,EAAS;AAAEC,wBAAAA,IAAAA,EAAMC,mCAAuBC;AAAM,qBAAA;oBAAGC,OAAAA,EAAS;AAAC,wBAAA;AAAEH,4BAAAA,IAAAA,EAAMI,kCAAsBgB;AAAY;AAAE;AAAC;AAAE;AAAC;;AAEzK,qDACO,MAAMC,gBAAgB,CAAyBC,OAAAA,EAAY7B,aAA8B;AAAE,QAAA,GAAG6B,OAAO;AAAE7B,QAAAA;AAAU,KAAA;;;;;;;;;;;;;;;;;;;"}