@cratis/scene.blueprint.approvals 0.0.0-stage → 4.53.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/approvalsApplication.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 { approvalsNavigation, approvalsStructure } from './navigation';
+import { approvalsScreens } from './screens';
+import { approvalsDialogTemplates, approvalsScreenTemplates } from './templates';
+
+/** The id of the sample-data pack a new application starts with. */
+export const approvalsDefaultSampleDataId = 'approvals-general';
+
+/**
+ * The example application of the blueprint: the foundation's layouts, the approvals application's templates and dialogs and its seven 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/Approvals/approvals.play`) declares in Screenplay: the document, the structure and the navigation are the three things an application is made of.
+ */
+export function approvalsApplication(sampleData: string = approvalsDefaultSampleDataId): ApplicationDocument {
+    const profile: UiProfile = { ...previewProfile(undefined), name: 'Approvals', sampleData: { activePack: sampleData, mappings: [], bindings: [] } };
+    return { layouts: defaultLayouts, screenTemplates: approvalsScreenTemplates, dialogTemplates: approvalsDialogTemplates, screens: approvalsScreens, uiProfiles: [profile] };
+}
+
+/** What a host composes the screens with: the application's logo, which the shell's topbar shows. */
+export const approvalsComposition: CompositionOptions = { logo: approvalsNavigation.application.logo };
+
+/** The structure and navigation the shell's regions show and the items' destinations resolve against. */
+export const approvalsNavigationModel = () => ({ structure: new ApplicationStructureIndex(approvalsStructure), navigation: approvalsNavigation });

package/approvalsParts.ts

@@ -0,0 +1,50 @@
+// 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, ExternalComponent, InteractionActionKind, InteractionTriggerKind, NavigateAction, OpenDialogAction, SceneElement, TemplateMetadata, TemplateScope,
+} from '@cratis/scene.model';
+import { component, panel } from '@cratis/scene.blueprint.default';
+import { approvalsTemplateProvenance } from './templateProvenance';
+
+export { component, panel };
+
+/** The category of every template of this blueprint (spec Part B 1.2: `Business / <domain>`). */
+export const approvalsCategory = 'Business / Approvals';
+
+/** 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 approvalsMetadata = (name: string, type: 'Dashboard' | 'List' | 'Board' | 'Detail' | 'Form' | 'Dialog' | 'Workspace' | 'Wizard', scopes: TemplateScope[]): TemplateMetadata =>
+    ({ ...approvalsTemplateProvenance, type, category: approvalsCategory, 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 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 });
+

package/approvalsQueries.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 { BindingExpression, BindingSourceKind } from '@cratis/scene.model';
+
+/**
+ * A property taken from a query result - never a value. A 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 approvals application, each a shape the sample-data packs supply rows for. */
+export const ApprovalsQuery = {
+    /** One row: the `locale` and the `currency` the figures and dates are formatted in. */
+    Settings: 'ApprovalsSettings',
+    Inbox: 'InboxRequests',
+    InboxColumns: 'InboxColumns',
+    InboxFilterFields: 'InboxFilterFields',
+    InboxViews: 'InboxViews',
+    MyRequests: 'MyRequests',
+    MyRequestColumns: 'MyRequestColumns',
+    MyRequestFilterFields: 'MyRequestFilterFields',
+    MyRequestViews: 'MyRequestViews',
+    MyRequestColumnChoices: 'MyRequestColumnChoices',
+    MyRequestSelection: 'MyRequestSelection',
+    AllRequests: 'AllRequests',
+    AllRequestColumns: 'AllRequestColumns',
+    AllRequestFilterFields: 'AllRequestFilterFields',
+    AllRequestViews: 'AllRequestViews',
+    AllRequestColumnChoices: 'AllRequestColumnChoices',
+    AllRequestSelection: 'AllRequestSelection',
+    RequestTypes: 'RequestTypes',
+    RequestTypeColumns: 'RequestTypeColumns',
+    RequestTypeFilterFields: 'RequestTypeFilterFields',
+    RequestTypeViews: 'RequestTypeViews',
+    RequestTypeColumnChoices: 'RequestTypeColumnChoices',
+    RequestTypeSelection: 'RequestTypeSelection',
+    WizardSteps: 'RequestWizardSteps',
+    TypeSections: 'RequestTypeSections',
+    DetailSections: 'RequestDetailSections',
+    ReviewSections: 'RequestReviewSections',
+    ReviewValues: 'RequestReviewValues',
+    Request: 'RequestRecord',
+    RequestSummary: 'RequestSummary',
+    RequestSections: 'RequestSections',
+    Chain: 'RequestChain',
+    Attachments: 'RequestAttachments',
+    AttachmentColumns: 'AttachmentColumns',
+    Comments: 'RequestComments',
+    RequestTabs: 'RequestTabs',
+    DecisionSections: 'DecisionSections',
+    TypeEditorSections: 'RequestTypeEditorSections',
+    FormErrors: 'ApprovalsFormErrors',
+} as const;
+
+/** The locale and currency of the data, bound onto every component that formats a figure or a date. */
+export const localeOfData = { locale: fromQuery(ApprovalsQuery.Settings, '0.locale') };
+export const currencyOfData = { ...localeOfData, currency: fromQuery(ApprovalsQuery.Settings, '0.currency') };

package/approvalsScreenSet.ts

@@ -0,0 +1,24 @@
+// 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 (`approvals.requests.new` is the `new` feature of `requests` in the `approvals` module). */
+export interface ApprovalsScreenDefinition 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 approvalsScreenDefinitions: ApprovalsScreenDefinition[] = [
+    { name: 'approvals.inbox', title: 'Inbox', template: 'ApprovalInbox', order: 0, description: 'The requests waiting for my decision, with Approve, Reject and Request changes on each.' },
+    { name: 'approvals.requests', title: 'My requests', template: 'MyRequests', order: 1, description: 'The requests I made, with draft, submitted, approved and rejected as chips.' },
+    { name: 'approvals.requests.new', title: 'New request', template: 'NewRequestWizard', parent: 'approvals.requests', description: 'Request type, details, attachments, then review and submit.' },
+    { name: 'approvals.requests.page', title: 'Request', template: 'RequestPage', parent: 'approvals.requests', description: 'One request: its summary, its approval chain, its attachments and the comments.' },
+    { name: 'approvals.all', title: 'All requests', template: 'AllRequests', order: 2, description: 'Every request in the organisation.' },
+    { name: 'approvals.templates', title: 'Templates', template: 'RequestTypes', order: 3, description: 'The request types an organisation offers, for administrators.' },
+    { name: 'approvals.templates.edit', title: 'Edit request type', template: 'RequestTypeEditForm', parent: 'approvals.templates', description: 'Edits what a request type asks for and who approves it.' },
+];

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 { approvalsBlueprintManifest } from './manifest';
+import { approvalsScreens } from './screens';
+import { approvalsDialogTemplates, approvalsScreenTemplates } 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 approvalsBlueprint: ScenePackageBundle = {
+    manifest: approvalsBlueprintManifest,
+    components: {},
+    screenTemplates: approvalsScreenTemplates,
+    dialogTemplates: approvalsDialogTemplates,
+    screens: approvalsScreens,
+};

package/blueprintCatalog.json

@@ -0,0 +1,171 @@
+{
+  "schema": 1,
+  "blueprints": [
+    {
+      "package": "Cratis.Blueprint.Approvals",
+      "version": "1.0.0",
+      "domain": "approvals",
+      "displayName": "Approvals and Requests",
+      "description": "Requests and approvals: an approver's inbox, my requests, a new-request wizard, request pages with their approval chain and the request types an organisation offers.",
+      "thumbnail": "thumbnails/approvals.svg",
+      "license": "MIT",
+      "licenseUrl": "https://github.com/Cratis/Scene/blob/main/LICENSE",
+      "dependencies": [
+        {
+          "name": "Cratis.Blueprint.Default",
+          "versionRange": "^1.0.0"
+        }
+      ],
+      "screens": [
+        {
+          "name": "approvals.inbox",
+          "title": "Inbox",
+          "description": "The requests waiting for my decision, with Approve, Reject and Request changes on each.",
+          "template": "ApprovalInbox",
+          "order": 0
+        },
+        {
+          "name": "approvals.requests",
+          "title": "My requests",
+          "description": "The requests I made, with draft, submitted, approved and rejected as chips.",
+          "template": "MyRequests",
+          "order": 1
+        },
+        {
+          "name": "approvals.requests.new",
+          "title": "New request",
+          "description": "Request type, details, attachments, then review and submit.",
+          "template": "NewRequestWizard",
+          "parent": "approvals.requests"
+        },
+        {
+          "name": "approvals.requests.page",
+          "title": "Request",
+          "description": "One request: its summary, its approval chain, its attachments and the comments.",
+          "template": "RequestPage",
+          "parent": "approvals.requests"
+        },
+        {
+          "name": "approvals.all",
+          "title": "All requests",
+          "description": "Every request in the organisation.",
+          "template": "AllRequests",
+          "order": 2
+        },
+        {
+          "name": "approvals.templates",
+          "title": "Templates",
+          "description": "The request types an organisation offers, for administrators.",
+          "template": "RequestTypes",
+          "order": 3
+        },
+        {
+          "name": "approvals.templates.edit",
+          "title": "Edit request type",
+          "description": "Edits what a request type asks for and who approves it.",
+          "template": "RequestTypeEditForm",
+          "parent": "approvals.templates"
+        }
+      ],
+      "templates": [
+        {
+          "name": "ApprovalInbox",
+          "kind": "ScreenTemplate",
+          "displayName": "Approval inbox",
+          "description": "The requests waiting for my decision as cards, with Approve, Reject and Request changes inline.",
+          "type": "List",
+          "category": "Business / Approvals",
+          "thumbnail": "thumbnails/ApprovalInbox.svg"
+        },
+        {
+          "name": "MyRequests",
+          "kind": "ScreenTemplate",
+          "displayName": "My requests",
+          "description": "The requests I made, with draft, submitted, approved and rejected as chips.",
+          "type": "List",
+          "category": "Business / Approvals",
+          "thumbnail": "thumbnails/MyRequests.svg"
+        },
+        {
+          "name": "NewRequestWizard",
+          "kind": "ScreenTemplate",
+          "displayName": "New request",
+          "description": "Request type, details, attachments, then review and submit; the step survives a refresh and a draft can be saved.",
+          "type": "Wizard",
+          "category": "Business / Approvals",
+          "thumbnail": "thumbnails/NewRequestWizard.svg"
+        },
+        {
+          "name": "RequestPage",
+          "kind": "ScreenTemplate",
+          "displayName": "Request page",
+          "description": "One request: summary, approval chain, fields, attachments and comments, and the decision buttons.",
+          "type": "Detail",
+          "category": "Business / Approvals",
+          "thumbnail": "thumbnails/RequestPage.svg"
+        },
+        {
+          "name": "AllRequests",
+          "kind": "ScreenTemplate",
+          "displayName": "All requests",
+          "description": "Every request of the organisation with its type, requester, current approver and status.",
+          "type": "List",
+          "category": "Business / Approvals",
+          "thumbnail": "thumbnails/AllRequests.svg"
+        },
+        {
+          "name": "RequestTypes",
+          "kind": "ScreenTemplate",
+          "displayName": "Request types",
+          "description": "The request types an organisation offers, with the steps that approve each and whether it is active.",
+          "type": "List",
+          "category": "Business / Approvals",
+          "thumbnail": "thumbnails/RequestTypes.svg"
+        },
+        {
+          "name": "RequestTypeEditForm",
+          "kind": "ScreenTemplate",
+          "displayName": "Edit request type",
+          "description": "A form that edits a request type: its name, what it asks for and its approval steps.",
+          "type": "Form",
+          "category": "Business / Approvals",
+          "thumbnail": "thumbnails/RequestTypeEditForm.svg"
+        },
+        {
+          "name": "DecisionDialog",
+          "kind": "DialogTemplate",
+          "displayName": "Decision",
+          "description": "A confirmation with a decision (approve, reject or request changes) and a comment for the requester.",
+          "type": "Dialog",
+          "category": "Business / Approvals",
+          "thumbnail": "thumbnails/DecisionDialog.svg"
+        },
+        {
+          "name": "RequestTypeQuickCreate",
+          "kind": "DialogTemplate",
+          "displayName": "New request type",
+          "description": "A short form that adds a request type without leaving the page.",
+          "type": "Dialog",
+          "category": "Business / Approvals",
+          "thumbnail": "thumbnails/RequestTypeQuickCreate.svg"
+        }
+      ],
+      "sampleData": [
+        {
+          "id": "approvals-general",
+          "title": "Approvals · General",
+          "locale": "en-GB",
+          "path": "sampleData/approvals-general.json",
+          "default": true
+        },
+        {
+          "id": "approvals-nordic",
+          "title": "Approvals · Nordic",
+          "locale": "nb-NO",
+          "path": "sampleData/approvals-nordic.json",
+          "default": false
+        }
+      ]
+    }
+  ]
+}

package/dist/cjs/approvalsApplication.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 approvalsDefaultSampleDataId = 'approvals-general';
+/**
+ * The example application of the blueprint: the foundation's layouts, the approvals application's templates and dialogs and its seven 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/Approvals/approvals.play`) declares in Screenplay: the document, the structure and the navigation are the three things an application is made of.
+ */ function approvalsApplication(sampleData = approvalsDefaultSampleDataId) {
+    const profile = {
+        ...scene_blueprint_default.previewProfile(undefined),
+        name: 'Approvals',
+        sampleData: {
+            activePack: sampleData,
+            mappings: [],
+            bindings: []
+        }
+    };
+    return {
+        layouts: scene_blueprint_default.defaultLayouts,
+        screenTemplates: index$1.approvalsScreenTemplates,
+        dialogTemplates: formTemplates.approvalsDialogTemplates,
+        screens: index.approvalsScreens,
+        uiProfiles: [
+            profile
+        ]
+    };
+}
+/** What a host composes the screens with: the application's logo, which the shell's topbar shows. */ const approvalsComposition = {
+    logo: navigation.approvalsNavigation.application.logo
+};
+/** The structure and navigation the shell's regions show and the items' destinations resolve against. */ const approvalsNavigationModel = ()=>({
+        structure: new scene_engine.ApplicationStructureIndex(navigation.approvalsStructure),
+        navigation: navigation.approvalsNavigation
+    });
+
+exports.approvalsApplication = approvalsApplication;
+exports.approvalsComposition = approvalsComposition;
+exports.approvalsDefaultSampleDataId = approvalsDefaultSampleDataId;
+exports.approvalsNavigationModel = approvalsNavigationModel;
+//# sourceMappingURL=approvalsApplication.js.map

package/dist/cjs/approvalsApplication.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approvalsApplication.js","sources":["../../approvalsApplication.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 { approvalsNavigation, approvalsStructure } from './navigation';\nimport { approvalsScreens } from './screens';\nimport { approvalsDialogTemplates, approvalsScreenTemplates } from './templates';\n\n/** The id of the sample-data pack a new application starts with. */\nexport const approvalsDefaultSampleDataId = 'approvals-general';\n\n/**\n * The example application of the blueprint: the foundation's layouts, the approvals application's templates and dialogs and its seven 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/Approvals/approvals.play`) declares in Screenplay: the document, the structure and the navigation are the three things an application is made of.\n */\nexport function approvalsApplication(sampleData: string = approvalsDefaultSampleDataId): ApplicationDocument {\n    const profile: UiProfile = { ...previewProfile(undefined), name: 'Approvals', sampleData: { activePack: sampleData, mappings: [], bindings: [] } };\n    return { layouts: defaultLayouts, screenTemplates: approvalsScreenTemplates, dialogTemplates: approvalsDialogTemplates, screens: approvalsScreens, uiProfiles: [profile] };\n}\n\n/** What a host composes the screens with: the application's logo, which the shell's topbar shows. */\nexport const approvalsComposition: CompositionOptions = { logo: approvalsNavigation.application.logo };\n\n/** The structure and navigation the shell's regions show and the items' destinations resolve against. */\nexport const approvalsNavigationModel = () => ({ structure: new ApplicationStructureIndex(approvalsStructure), navigation: approvalsNavigation });\n"],"names":["approvalsDefaultSampleDataId","approvalsApplication","sampleData","profile","previewProfile","undefined","name","activePack","mappings","bindings","layouts","defaultLayouts","screenTemplates","approvalsScreenTemplates","dialogTemplates","approvalsDialogTemplates","screens","approvalsScreens","uiProfiles","approvalsComposition","logo","approvalsNavigation","application","approvalsNavigationModel","structure","ApplicationStructureIndex","approvalsStructure","navigation"],"mappings":";;;;;;;;;AAAA;AACA;AASA,qEACO,MAAMA,4BAAAA,GAA+B;AAE5C;;;;AAIC,IACM,SAASC,oBAAAA,CAAqBC,UAAAA,GAAqBF,4BAA4B,EAAA;AAClF,IAAA,MAAMG,OAAAA,GAAqB;AAAE,QAAA,GAAGC,uCAAeC,SAAAA,CAAU;QAAEC,IAAAA,EAAM,WAAA;QAAaJ,UAAAA,EAAY;YAAEK,UAAAA,EAAYL,UAAAA;AAAYM,YAAAA,QAAAA,EAAU,EAAE;AAAEC,YAAAA,QAAAA,EAAU;AAAG;AAAE,KAAA;IACjJ,OAAO;QAAEC,OAAAA,EAASC,sCAAAA;QAAgBC,eAAAA,EAAiBC,gCAAAA;QAA0BC,eAAAA,EAAiBC,sCAAAA;QAA0BC,OAAAA,EAASC,sBAAAA;QAAkBC,UAAAA,EAAY;AAACf,YAAAA;AAAQ;AAAC,KAAA;AAC7K;AAEA,sGACO,MAAMgB,oBAAAA,GAA2C;IAAEC,IAAAA,EAAMC,8BAAAA,CAAoBC,WAAW,CAACF;AAAK;AAErG,0GACO,MAAMG,wBAAAA,GAA2B,KAAO;AAAEC,QAAAA,SAAAA,EAAW,IAAIC,sCAAAA,CAA0BC,6BAAAA,CAAAA;QAAqBC,UAAAA,EAAYN;AAAoB,KAAA;;;;;"}

package/dist/cjs/approvalsParts.js

@@ -0,0 +1,131 @@
+'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 approvalsCategory = 'Business / Approvals';
+/** 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 approvalsMetadata = (name, type, scopes)=>({
+        ...templateProvenance.approvalsTemplateProvenance,
+        type,
+        category: approvalsCategory,
+        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 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.approvalsCategory = approvalsCategory;
+exports.approvalsMetadata = approvalsMetadata;
+exports.closesDialog = closesDialog;
+exports.goesTo = goesTo;
+exports.opensDialog = opensDialog;
+exports.opensRecordOnSelect = opensRecordOnSelect;
+exports.thumbnailOf = thumbnailOf;
+exports.withBehaviors = withBehaviors;
+//# sourceMappingURL=approvalsParts.js.map

package/dist/cjs/approvalsParts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approvalsParts.js","sources":["../../approvalsParts.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, ExternalComponent, InteractionActionKind, InteractionTriggerKind, NavigateAction, OpenDialogAction, SceneElement, TemplateMetadata, TemplateScope,\n} from '@cratis/scene.model';\nimport { component, panel } from '@cratis/scene.blueprint.default';\nimport { approvalsTemplateProvenance } 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 approvalsCategory = 'Business / Approvals';\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 approvalsMetadata = (name: string, type: 'Dashboard' | 'List' | 'Board' | 'Detail' | 'Form' | 'Dialog' | 'Workspace' | 'Wizard', scopes: TemplateScope[]): TemplateMetadata =>\n    ({ ...approvalsTemplateProvenance, type, category: approvalsCategory, 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/** 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\n"],"names":["approvalsCategory","thumbnailOf","templateName","approvalsMetadata","name","type","scopes","approvalsTemplateProvenance","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","closesDialog","CloseDialog","withBehaviors","element"],"mappings":";;;;;;AAAA;AACA;AAUA,kGACO,MAAMA,iBAAAA,GAAoB;AAEjC,qDACO,MAAMC,WAAAA,GAAc,CAACC,YAAAA,GAAiC,CAAC,WAAW,EAAEA,YAAAA,CAAa,IAAI;AAE5F,4JACO,MAAMC,iBAAAA,GAAoB,CAACC,IAAAA,EAAcC,IAAAA,EAA8FC,UACzI;AAAE,QAAA,GAAGC,8CAA2B;AAAEF,QAAAA,IAAAA;QAAMG,QAAAA,EAAUR,iBAAAA;AAAmBS,QAAAA,SAAAA,EAAWR,WAAAA,CAAYG,IAAAA,CAAAA;AAAOE,QAAAA;AAAO,KAAA;AAE/G,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,iFACO,MAAMC,YAAAA,GAAe,IAAkB;AAAC,QAAA;YAAEpB,QAAAA,EAAU;AAAC,gBAAA;oBAAEC,OAAAA,EAAS;AAAEC,wBAAAA,IAAAA,EAAMC,mCAAuBC;AAAM,qBAAA;oBAAGC,OAAAA,EAAS;AAAC,wBAAA;AAAEH,4BAAAA,IAAAA,EAAMI,kCAAsBe;AAAY;AAAE;AAAC;AAAE;AAAC;;AAEzK,qDACO,MAAMC,gBAAgB,CAAyBC,OAAAA,EAAY5B,aAA8B;AAAE,QAAA,GAAG4B,OAAO;AAAE5B,QAAAA;AAAU,KAAA;;;;;;;;;;;;;;;;;;"}