@draftably/editor 0.3.0 → 0.5.0

package/dist/types/src/components/canvas/Canvas.d.ts

@@ -7,6 +7,10 @@ export interface CanvasProps {
     onDropFiles?: (files: File[]) => Promise<void> | void;
     /** Shown under the hint on an empty canvas, such as a button that builds from a list. */
     emptyAction?: JSX.Element;
+    /** The host's slot targets, above the drawing and below the chrome layer. */
+    anchorLayer?: HTMLElement;
+    /** Nodes a host body covers: their titles hide, and their ports and handles draw on top. */
+    bodies?: () => ReadonlySet<string>;
 }
 /**
  * The canvas for the session in context: drawing, selection, dragging, inline editing, layout

package/dist/types/src/components/scene/NodeView.d.ts

@@ -14,5 +14,12 @@ export interface NodeViewProps {
     /** Comparison candidates: focusable so a keyboard user can choose the anchor. */
     focusable?: boolean;
     idPrefix?: string;
+    /** A host body covers this node: its ports and handles draw in the chrome layer above it. */
+    body?: boolean;
 }
+/**
+ * The ports and resize handles of a node with a host body, drawn in the editor's top layer so the
+ * body never hides them. Pointer input on them reaches the canvas's own handlers.
+ */
+export declare function NodeChrome(props: NodeViewProps): import("solid-js").JSX.Element;
 export declare function NodeView(props: NodeViewProps): import("solid-js").JSX.Element;

package/dist/types/src/components/scene/parts.d.ts

@@ -1,17 +1,13 @@
-import type { TypeProfile } from '../../model/fonts';
+import type { ResolvedAppearance } from '../../model/appearance';
+import type { NodeLabel } from '../../model/labels';
 import type { Rect } from '../../model/types';
-/** Multi-line, vertically centered text in one of the diagram's type profiles. */
-export declare function SceneText(props: {
-    lines: string[];
-    x: number;
-    y: number;
-    lineHeight: number;
-    type: TypeProfile;
+/** A shape's title: its name lines, then its detail lines a step smaller in `detailFill`. */
+export declare function NodeTitle(props: {
+    label: NodeLabel;
+    look: ResolvedAppearance;
     fill: string;
-    class?: string;
-    /** Strike the text through, as for a removed object. */
+    detailFill: string;
     strike?: boolean;
-    /** Fade of the text alone, as for a removed object. */
     fade?: number;
 }): import("solid-js").JSX.Element;
 /** The removed marker, a minus in a disc, centred at (x, y). */

package/dist/types/src/components/session-context.d.ts

@@ -52,7 +52,8 @@ export declare const useSessionIfAny: () => ({
     redo: () => void;
     canUndo: () => boolean;
     canRedo: () => boolean;
-    setCamera: (camera: import("../model/types").Camera) => void;
+    setCamera: (camera: import("../model/types").Camera, reason?: import("../runtime/camera").CameraReason) => void;
+    onCamera: (listener: (reason: import("../runtime/camera").CameraReason) => void) => () => boolean;
     disableBrowserStorage: () => boolean;
     setPersistenceBlocked: (blocked: boolean) => void;
     persist: () => void;
@@ -273,6 +274,9 @@ export declare const useSessionIfAny: () => ({
     showState: (id: string | null) => void;
     stepState: (by: 1 | -1) => boolean;
     drawnDoc: () => import("../model/types").Diagram;
+    dark: import("solid-js").Accessor<boolean>;
+    setDark: import("solid-js").Setter<boolean>;
+    drawnAppearance: () => import("../model/appearance").DiagramAppearance;
 } & {
     tool: import("solid-js").Accessor<import("../state/session/editor").Tool>;
     setToolSignal: import("solid-js").Setter<import("../state/session/editor").Tool>;
@@ -482,5 +486,7 @@ export declare const useSessionIfAny: () => ({
     onDoubleClick: (e: MouseEvent) => void;
     selectForContextMenu: (e: MouseEvent) => void;
     dragKind: () => string | undefined;
+} & {
+    describeLink: (href: string) => string;
 }) | undefined;
 export declare function useDiagramSession(): DiagramSession;

package/dist/types/src/dsl/cells.d.ts

@@ -15,6 +15,7 @@ export interface CellInput {
     size?: {
         width: number;
         height?: number;
+        minHeight?: number;
     };
 }
 export interface CellBox {

package/dist/types/src/dsl/compile.d.ts

@@ -99,11 +99,12 @@ export declare function layoutFor(m: Model, scope: string): ModelLayout;
 /**
  * Size of a node: its requested size, or the default width with a height that fits the title in
  * the theme's type and padding. A requested size is kept exactly; `overflow` reports a title that
- * no longer fits in it.
+ * no longer fits in it. With `height=auto`, `min-height` is a floor under the title's height.
  */
 export declare function leafSize(o: ModelObject, size: {
     width: number;
     height?: number;
+    minHeight?: number;
 } | undefined, look: ResolvedAppearance): {
     w: number;
     h: number;

package/dist/types/src/dsl/legend-notes.d.ts

@@ -1,3 +1,17 @@
+/**
+ * `check` advice on the key and the prose round a drawing: a key that leaves a color or a line
+ * style unexplained, a `legend` swatch drawn in a shade that no node of its family uses, and
+ * heading prose that the drawing should say instead.
+ */
+import { type Shade } from '../model/appearance';
 import type { Diagnostic } from './compile';
 import type { Model } from './syntax';
 export declare function legendNotes(m: Model): Diagnostic[];
+/**
+ * The shade a `legend family` swatch draws when its line sets none: what the family's nodes draw.
+ * When no node names the family and its nodes are all member cards (they inherit it from a group
+ * on a quiet surface shade), that is the member card's shade; otherwise it is a colored node's.
+ */
+export declare function legendShade(m: Model, family: string): Shade;
+/** Give each `legend family` line with no `shade=` the shade its family's nodes draw. */
+export declare function settleLegendShades(m: Model): void;

package/dist/types/src/dsl/syntax.d.ts

@@ -210,11 +210,13 @@ export type Hint = {
     line: number;
 }
 /** `height` is unset for `height=auto`: the title's height at that width, as without a size. */
+/** `minHeight` is a floor under `height=auto`, for a host that draws more than the title. */
  | {
     type: 'size';
     id: string;
     width: number;
     height?: number;
+    minHeight?: number;
     line: number;
 };
 export type Strength = 'prefer' | 'required';
@@ -306,7 +308,7 @@ export declare const isIdentifier: (s: string) => boolean;
 export declare const COLORS: DslColor[];
 export declare const DSL_SHAPES: DslShape[];
 /** Shapes a node's box can draw as it was: a marker's box is a thin cut, so it has no other shape. */
-export declare const PAST_SHAPES: ("text" | "diamond" | "circle" | "box" | "pill")[];
+export declare const PAST_SHAPES: ("text" | "box" | "pill" | "circle" | "diamond")[];
 /** Parse and validate source. Throws `DslError` with a line number for the first problem. */
 export declare function parseModel(source: string | SourceDoc): Model;
 /**

package/dist/types/src/dsl/translate.d.ts

@@ -7,7 +7,7 @@
  * write snaps back when the source is reprojected, so nothing unsaved looks saved. Changes the
  * file cannot express are rejected outright.
  */
-import type { DiagramAppearance } from '../model/appearance';
+import { type DiagramAppearance } from '../model/appearance';
 import type { Diagram } from '../model/types';
 import { type Scene } from './compile';
 import { type SourceDoc } from './syntax';

package/dist/types/src/editor/css.d.ts

@@ -0,0 +1,3 @@
+export declare function registerEditorCss(key: string, css: string): void;
+/** Add the editor's styles to `root`, once. One constructable sheet per page, shared. */
+export declare function adoptEditorCss(root: Document | ShadowRoot): void;

package/dist/types/src/editor/element.d.ts

@@ -1,11 +1,13 @@
-/**
- * `<draft-editor>`: the editor as a custom element, for any framework or plain HTML. Its `source`
- * attribute or property sets the text; every kept edit fires `draft-change` with the new text.
- * It mounts when added to the page and stops its session when removed.
- */
-import { type MountedEditor } from './mount';
+import { type EditorOptions, type MountedEditor } from './mount';
+export type { DraftEventMap, HostEventName, HostEvents } from '../runtime/host';
+export type { EditorOptions };
 export interface DraftEditorElement extends HTMLElement {
     source: string;
+    /**
+     * Every `mountEditor` option except `source` and `onChange`. Callbacks apply live; a new
+     * `storageKey` mounts a new editor. A new object with the same values does nothing.
+     */
+    options: EditorOptions;
     readonly editor?: MountedEditor;
 }
 declare global {