@cratis/event-models 0.348.3 → 0.349.0

package/README.md

@@ -235,6 +235,8 @@ import { ScreenEditorPrimeReactProvider } from '@cratis/event-models/screen-edit
 
 `@cratis/components` 4.25 or later is required by this entry, and is now the minimum for the package. Consumers that only draw the board need to move to it too.
 
+A host that keeps more with a screen than a prototype (sketches, mockup pages, images) offers it from the same add button: `actions.prototypeVisuals` is a list of `{ id, label, description?, icon?, onChosen(sliceId, actorId, host) }` listed in the add menu below the prototype choices, after a separator. While an actor has no screen, `UiCell`'s `visual` prop draws the host's latest visual in the place of the thumbnail - without flow connectors, and with the add button still shown so a prototype can be started. A cell that has a prototype ignores it.
+
 ## Logo, view options and your own tools
 
 The board can draw the Cratis logo and a toolbar over itself. Both are off unless you ask for them:

package/dist/Board/BoardActions.d.ts

@@ -2,6 +2,7 @@ import type { Guid } from '@cratis/fundamentals';
 import type { CardSurface } from '../Cards/CardSurface';
 import type { CellAction } from '../Rows/CellAction';
 import type { PrototypeTemplate } from '../Rows/UserExperience/PrototypeTemplate';
+import type { PrototypeVisualAction } from '../Rows/UserExperience/PrototypeVisualAction';
 import type { SpecificationAction, SpecificationCollectionAction, SpecificationGenerationAction, SpecificationProblemAction } from '../Specifications/SpecificationAction';
 import type { SliceHeaderAction } from '../Slices/SliceHeaderAction';
 import type { SlicePreviewAction } from '../Slices/SlicePreviewAction';
@@ -36,6 +37,7 @@ export interface BoardActions {
     readModelCardFor?: (readModelId: Guid) => CardSurface | undefined;
     eventsRow?: readonly CellAction[];
     prototypeTemplates?: readonly PrototypeTemplate[];
+    prototypeVisuals?: readonly PrototypeVisualAction[];
     interactionRow?: readonly CellAction[];
     specificationRun?: SpecificationAction;
     specificationStop?: SpecificationAction;

package/dist/Rows/UserExperience/AddPrototypeButton.d.ts

@@ -1,7 +1,10 @@
 import type { PrototypeTemplate } from './PrototypeTemplate';
+import type { PrototypeVisualAction } from './PrototypeVisualAction';
 export interface AddPrototypeButtonProps {
     templates: readonly PrototypeTemplate[];
     onFromScratch: (host: DOMRect) => void;
     onFromTemplate: (template: PrototypeTemplate, host: DOMRect) => void;
+    visuals?: readonly PrototypeVisualAction[];
+    onVisual?: (visual: PrototypeVisualAction, host: DOMRect) => void;
 }
-export declare const AddPrototypeButton: ({ templates, onFromScratch, onFromTemplate }: AddPrototypeButtonProps) => import("react").JSX.Element;
+export declare const AddPrototypeButton: ({ templates, onFromScratch, onFromTemplate, visuals, onVisual }: AddPrototypeButtonProps) => import("react").JSX.Element;

package/dist/Rows/UserExperience/PrototypeVisualAction.d.ts

@@ -0,0 +1,9 @@
+import type { ReactNode } from 'react';
+import type { Guid } from '@cratis/fundamentals';
+export interface PrototypeVisualAction {
+    id: string;
+    label: string;
+    description?: string;
+    icon?: ReactNode;
+    onChosen: (sliceId: Guid, actorId: string, host: DOMRect) => void;
+}

package/dist/Rows/UserExperience/UiCell.d.ts

@@ -20,5 +20,6 @@ export interface UiCellProps {
     }) => ReactNode;
     adornment?: ReactNode;
     corner?: ReactNode;
+    visual?: ReactNode;
 }
-export declare const UiCell: ({ elements, windowSize, layout, collapsed, conn, rowHeight, actorId, hasScreen, renderThumbnail, adornment, corner }: UiCellProps) => React.JSX.Element;
+export declare const UiCell: ({ elements, windowSize, layout, collapsed, conn, rowHeight, actorId, hasScreen, renderThumbnail, adornment, corner, visual }: UiCellProps) => React.JSX.Element;

package/dist/Rows/UserExperience/addPrototypeMenuItems.d.ts

@@ -1,8 +1,10 @@
 import type { EventModelMessages } from '../../Messages';
 import type { MenuDropdownItem } from '../../Menus';
 import type { PrototypeTemplate } from './PrototypeTemplate';
+import type { PrototypeVisualAction } from './PrototypeVisualAction';
 export interface AddPrototypeMenuActions {
     onFromScratch: () => void;
     onFromTemplate: (template: PrototypeTemplate) => void;
+    onVisual?: (visual: PrototypeVisualAction) => void;
 }
-export declare const addPrototypeMenuItems: (templates: readonly PrototypeTemplate[], messages: EventModelMessages['prototypes'], actions: AddPrototypeMenuActions) => MenuDropdownItem[];
+export declare const addPrototypeMenuItems: (templates: readonly PrototypeTemplate[], messages: EventModelMessages['prototypes'], actions: AddPrototypeMenuActions, visuals?: readonly PrototypeVisualAction[]) => MenuDropdownItem[];

package/dist/Rows/UserExperience/index.d.ts

@@ -3,3 +3,4 @@ export * from './AddPrototypeButton';
 export * from './addPrototypeMenuItems';
 export * from './PrototypeTemplate';
 export * from './UiThumbnailProps';
+export * from './PrototypeVisualAction';

package/dist/Slices/sliceFindings.d.ts

@@ -0,0 +1,3 @@
+import { type SliceAnnotation } from '../Model';
+import type { SliceProblem } from './SliceProblem';
+export declare const sliceFindingsOf: (annotations?: readonly SliceAnnotation[], problems?: readonly SliceProblem[]) => SliceAnnotation[];