@dxos/react-ui-canvas 0.13.0 → 0.14.0

package/dist/types/src/model/types.d.ts

@@ -48,24 +48,88 @@ export declare const Port: Schema.Struct<{
     readonly accepts: Schema.optional<Schema.Literals<readonly ["in", "out", "any"]>>;
 }>;
 export type Port = Schema.Schema.Type<typeof Port>;
-/** How strongly a hue fills a frame: 0 is an outline (transparent), 1 to 3 are lighter to stronger fills. */
+/** The hues the style pickers offer, neutral first, then in hue order; any theme hue still renders on a node. */
+export declare const STYLE_HUES: readonly ['neutral', 'red', 'orange', 'amber', 'green', 'teal', 'sky', 'blue', 'violet'];
+export declare const StyleHue: Schema.Literals<readonly ["neutral", "red", "orange", "amber", "green", "teal", "sky", "blue", "violet"]>;
+export type StyleHue = Schema.Schema.Type<typeof StyleHue>;
+/** How strongly a hue fills a frame: 0 is an outline (transparent), 1 to 3 are stronger to lighter fills. */
 export declare const NodeTone: Schema.Literals<readonly [0, 1, 2, 3]>;
 export type NodeTone = Schema.Schema.Type<typeof NodeTone>;
-/** Presentation choices a node carries; every field is optional and the frame supplies the default look. */
+/** The typefaces a shape's text may use: the theme's body face, or its fixed-width one. */
+export declare const FONT_FAMILIES: readonly ['default', 'monospace'];
+export type FontFamily = (typeof FONT_FAMILIES)[number];
+/** Where text sits across a shape, and down it. */
+export declare const HORIZONTAL_ALIGNS: readonly ['left', 'center', 'right'];
+export declare const VERTICAL_ALIGNS: readonly ['top', 'middle', 'bottom'];
+export type HorizontalAlign = (typeof HORIZONTAL_ALIGNS)[number];
+export type VerticalAlign = (typeof VERTICAL_ALIGNS)[number];
+/** How a line is drawn: a link's stroke, or a node's border. */
+export declare const LINE_STYLES: readonly ['solid', 'dashed', 'dotted'];
+/**
+ * The common base style every element shares, nodes and links alike: its colour and its line. Each kind extends it
+ * (`NodeStyle`), and a selection of several kinds edits only what they share. One field object per property, so
+ * the kinds declare the same field and the properties panel sees it as shared.
+ */
+export declare const lineStyleFields: {
+    /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+    hue: Schema.optional<Schema.String>;
+    /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+    lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
+};
+/** A link's style: the common base, unset drawn neutral and solid. */
+export declare const LineStyle: Schema.Struct<{
+    /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+    hue: Schema.optional<Schema.String>;
+    /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+    lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
+}>;
+export type LineStyle = Schema.Schema.Type<typeof LineStyle>;
+/**
+ * The common base plus a frame and text: what a shape draws. A shape with more to style extends it
+ * (`Schema.Struct({ ...styleFields, … })`).
+ */
+export declare const styleFields: {
+    /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+    hue: Schema.optional<Schema.String>;
+    /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+    lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
+    /** The hue's fill; unset is 2, the look a hue had before tones. */
+    tone: Schema.optional<Schema.Literals<readonly [0, 1, 2, 3]>>;
+    rounded: Schema.optional<Schema.Boolean>;
+    fill: Schema.optional<Schema.Boolean>;
+    border: Schema.optional<Schema.Boolean>;
+    /** A guide: drawn dashed and unfilled, an annotation rather than content. */
+    guide: Schema.optional<Schema.Boolean>;
+    /** The face of the shape's text; unset is the theme's body face. */
+    fontFamily: Schema.optional<Schema.Literals<readonly ["default", "monospace"]>>;
+    /** Text size in the node's own scene units (the editor offers a readable range; stored values are not checked). */
+    fontSize: Schema.optional<Schema.Number>;
+    /** Where the text sits across the shape; unset is the type's own (a label centres, a note starts at the left). */
+    alignHorizontal: Schema.optional<Schema.Literals<readonly ["left", "center", "right"]>>;
+    /** Where the text sits down the shape; unset is the type's own (a label is middled, a note starts at the top). */
+    alignVertical: Schema.optional<Schema.Literals<readonly ["top", "middle", "bottom"]>>;
+};
+/** Presentation choices a node carries: the shape style. */
 export declare const NodeStyle: Schema.Struct<{
-    /** One of the theme's hues, colouring fill, text and border together. */
-    readonly hue: Schema.optional<Schema.String>;
+    /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+    hue: Schema.optional<Schema.String>;
+    /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+    lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
     /** The hue's fill; unset is 2, the look a hue had before tones. */
-    readonly tone: Schema.optional<Schema.Literals<readonly [0, 1, 2, 3]>>;
-    readonly rounded: Schema.optional<Schema.Boolean>;
-    readonly fill: Schema.optional<Schema.Boolean>;
-    readonly border: Schema.optional<Schema.Boolean>;
+    tone: Schema.optional<Schema.Literals<readonly [0, 1, 2, 3]>>;
+    rounded: Schema.optional<Schema.Boolean>;
+    fill: Schema.optional<Schema.Boolean>;
+    border: Schema.optional<Schema.Boolean>;
     /** A guide: drawn dashed and unfilled, an annotation rather than content. */
-    readonly guide: Schema.optional<Schema.Boolean>;
+    guide: Schema.optional<Schema.Boolean>;
+    /** The face of the shape's text; unset is the theme's body face. */
+    fontFamily: Schema.optional<Schema.Literals<readonly ["default", "monospace"]>>;
     /** Text size in the node's own scene units (the editor offers a readable range; stored values are not checked). */
-    readonly fontSize: Schema.optional<Schema.Number>;
-    /** Extra classes on the frame, for a host's own look. */
-    readonly className: Schema.optional<Schema.String>;
+    fontSize: Schema.optional<Schema.Number>;
+    /** Where the text sits across the shape; unset is the type's own (a label centres, a note starts at the left). */
+    alignHorizontal: Schema.optional<Schema.Literals<readonly ["left", "center", "right"]>>;
+    /** Where the text sits down the shape; unset is the type's own (a label is middled, a note starts at the top). */
+    alignVertical: Schema.optional<Schema.Literals<readonly ["top", "middle", "bottom"]>>;
 }>;
 export type NodeStyle = Schema.Schema.Type<typeof NodeStyle>;
 /** The fields every node type shares; a type's schema is `Schema.Struct({ ...nodeBase, type: Literal, ... })`. */
@@ -92,20 +156,30 @@ export declare const nodeBase: {
     }>>>;
     /** Ports spread along each side, overriding the type's layout; ignored when the node carries `ports`. */
     portsPerSide: Schema.optional<Schema.Number>;
+    /** A style class of the drawing (`StyleClass`) the node takes its look from; its own `style` wins over it. */
+    /** The scene layer the element is on; unset, or naming no layer of the scene, it is on the bottom one. */
+    layer: Schema.optional<Schema.String>;
+    class: Schema.optional<Schema.String>;
     style: Schema.optional<Schema.Struct<{
-        /** One of the theme's hues, colouring fill, text and border together. */
-        readonly hue: Schema.optional<Schema.String>;
+        /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+        hue: Schema.optional<Schema.String>;
+        /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+        lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
         /** The hue's fill; unset is 2, the look a hue had before tones. */
-        readonly tone: Schema.optional<Schema.Literals<readonly [0, 1, 2, 3]>>;
-        readonly rounded: Schema.optional<Schema.Boolean>;
-        readonly fill: Schema.optional<Schema.Boolean>;
-        readonly border: Schema.optional<Schema.Boolean>;
+        tone: Schema.optional<Schema.Literals<readonly [0, 1, 2, 3]>>;
+        rounded: Schema.optional<Schema.Boolean>;
+        fill: Schema.optional<Schema.Boolean>;
+        border: Schema.optional<Schema.Boolean>;
         /** A guide: drawn dashed and unfilled, an annotation rather than content. */
-        readonly guide: Schema.optional<Schema.Boolean>;
+        guide: Schema.optional<Schema.Boolean>;
+        /** The face of the shape's text; unset is the theme's body face. */
+        fontFamily: Schema.optional<Schema.Literals<readonly ["default", "monospace"]>>;
         /** Text size in the node's own scene units (the editor offers a readable range; stored values are not checked). */
-        readonly fontSize: Schema.optional<Schema.Number>;
-        /** Extra classes on the frame, for a host's own look. */
-        readonly className: Schema.optional<Schema.String>;
+        fontSize: Schema.optional<Schema.Number>;
+        /** Where the text sits across the shape; unset is the type's own (a label centres, a note starts at the left). */
+        alignHorizontal: Schema.optional<Schema.Literals<readonly ["left", "center", "right"]>>;
+        /** Where the text sits down the shape; unset is the type's own (a label is middled, a note starts at the top). */
+        alignVertical: Schema.optional<Schema.Literals<readonly ["top", "middle", "bottom"]>>;
     }>>;
 };
 /** Any node as the engine sees it: the shared fields and a type name; the registry knows the rest. */
@@ -128,20 +202,28 @@ export declare const NodeBase: Schema.Struct<{
         readonly accepts: Schema.optional<Schema.Literals<readonly ["in", "out", "any"]>>;
     }>>>;
     readonly portsPerSide: Schema.optional<Schema.Number>;
+    readonly layer: Schema.optional<Schema.String>;
+    readonly class: Schema.optional<Schema.String>;
     readonly style: Schema.optional<Schema.Struct<{
-        /** One of the theme's hues, colouring fill, text and border together. */
-        readonly hue: Schema.optional<Schema.String>;
+        /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+        hue: Schema.optional<Schema.String>;
+        /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+        lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
         /** The hue's fill; unset is 2, the look a hue had before tones. */
-        readonly tone: Schema.optional<Schema.Literals<readonly [0, 1, 2, 3]>>;
-        readonly rounded: Schema.optional<Schema.Boolean>;
-        readonly fill: Schema.optional<Schema.Boolean>;
-        readonly border: Schema.optional<Schema.Boolean>;
+        tone: Schema.optional<Schema.Literals<readonly [0, 1, 2, 3]>>;
+        rounded: Schema.optional<Schema.Boolean>;
+        fill: Schema.optional<Schema.Boolean>;
+        border: Schema.optional<Schema.Boolean>;
         /** A guide: drawn dashed and unfilled, an annotation rather than content. */
-        readonly guide: Schema.optional<Schema.Boolean>;
+        guide: Schema.optional<Schema.Boolean>;
+        /** The face of the shape's text; unset is the theme's body face. */
+        fontFamily: Schema.optional<Schema.Literals<readonly ["default", "monospace"]>>;
         /** Text size in the node's own scene units (the editor offers a readable range; stored values are not checked). */
-        readonly fontSize: Schema.optional<Schema.Number>;
-        /** Extra classes on the frame, for a host's own look. */
-        readonly className: Schema.optional<Schema.String>;
+        fontSize: Schema.optional<Schema.Number>;
+        /** Where the text sits across the shape; unset is the type's own (a label centres, a note starts at the left). */
+        alignHorizontal: Schema.optional<Schema.Literals<readonly ["left", "center", "right"]>>;
+        /** Where the text sits down the shape; unset is the type's own (a label is middled, a note starts at the top). */
+        alignVertical: Schema.optional<Schema.Literals<readonly ["top", "middle", "bottom"]>>;
     }>>;
     readonly type: Schema.String;
 }>;
@@ -150,7 +232,12 @@ export type NodeBase = Schema.Schema.Type<typeof NodeBase>;
 export declare const boxFields: {
     label: Schema.optional<Schema.String>;
 };
-export declare const RectNode: Schema.Struct<{
+/**
+ * The core base every node falls back to: its frame, ports, style and `label`. A node whose type the registry does
+ * not know (its plugin is off) is drawn and edited as this, a box showing its label, so a type that keeps its title
+ * in `label` still reads as itself.
+ */
+export declare const BaseNode: Schema.Struct<{
     readonly id: Schema.String;
     readonly z: Schema.String;
     readonly locked: Schema.optional<Schema.Boolean>;
@@ -169,27 +256,34 @@ export declare const RectNode: Schema.Struct<{
         readonly accepts: Schema.optional<Schema.Literals<readonly ["in", "out", "any"]>>;
     }>>>;
     readonly portsPerSide: Schema.optional<Schema.Number>;
+    readonly layer: Schema.optional<Schema.String>;
+    readonly class: Schema.optional<Schema.String>;
     readonly style: Schema.optional<Schema.Struct<{
-        /** One of the theme's hues, colouring fill, text and border together. */
-        readonly hue: Schema.optional<Schema.String>;
+        /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+        hue: Schema.optional<Schema.String>;
+        /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+        lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
         /** The hue's fill; unset is 2, the look a hue had before tones. */
-        readonly tone: Schema.optional<Schema.Literals<readonly [0, 1, 2, 3]>>;
-        readonly rounded: Schema.optional<Schema.Boolean>;
-        readonly fill: Schema.optional<Schema.Boolean>;
-        readonly border: Schema.optional<Schema.Boolean>;
+        tone: Schema.optional<Schema.Literals<readonly [0, 1, 2, 3]>>;
+        rounded: Schema.optional<Schema.Boolean>;
+        fill: Schema.optional<Schema.Boolean>;
+        border: Schema.optional<Schema.Boolean>;
         /** A guide: drawn dashed and unfilled, an annotation rather than content. */
-        readonly guide: Schema.optional<Schema.Boolean>;
+        guide: Schema.optional<Schema.Boolean>;
+        /** The face of the shape's text; unset is the theme's body face. */
+        fontFamily: Schema.optional<Schema.Literals<readonly ["default", "monospace"]>>;
         /** Text size in the node's own scene units (the editor offers a readable range; stored values are not checked). */
-        readonly fontSize: Schema.optional<Schema.Number>;
-        /** Extra classes on the frame, for a host's own look. */
-        readonly className: Schema.optional<Schema.String>;
+        fontSize: Schema.optional<Schema.Number>;
+        /** Where the text sits across the shape; unset is the type's own (a label centres, a note starts at the left). */
+        alignHorizontal: Schema.optional<Schema.Literals<readonly ["left", "center", "right"]>>;
+        /** Where the text sits down the shape; unset is the type's own (a label is middled, a note starts at the top). */
+        alignVertical: Schema.optional<Schema.Literals<readonly ["top", "middle", "bottom"]>>;
     }>>;
     readonly label: Schema.optional<Schema.String>;
-    readonly type: Schema.Literal<"rect">;
+    readonly type: Schema.String;
 }>;
-export type RectNode = Schema.Schema.Type<typeof RectNode>;
-/** An ellipse inscribed in the frame. */
-export declare const EllipseNode: Schema.Struct<{
+export type BaseNode = Schema.Schema.Type<typeof BaseNode>;
+export declare const RectNode: Schema.Struct<{
     readonly id: Schema.String;
     readonly z: Schema.String;
     readonly locked: Schema.optional<Schema.Boolean>;
@@ -208,27 +302,35 @@ export declare const EllipseNode: Schema.Struct<{
         readonly accepts: Schema.optional<Schema.Literals<readonly ["in", "out", "any"]>>;
     }>>>;
     readonly portsPerSide: Schema.optional<Schema.Number>;
+    readonly layer: Schema.optional<Schema.String>;
+    readonly class: Schema.optional<Schema.String>;
     readonly style: Schema.optional<Schema.Struct<{
-        /** One of the theme's hues, colouring fill, text and border together. */
-        readonly hue: Schema.optional<Schema.String>;
+        /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+        hue: Schema.optional<Schema.String>;
+        /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+        lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
         /** The hue's fill; unset is 2, the look a hue had before tones. */
-        readonly tone: Schema.optional<Schema.Literals<readonly [0, 1, 2, 3]>>;
-        readonly rounded: Schema.optional<Schema.Boolean>;
-        readonly fill: Schema.optional<Schema.Boolean>;
-        readonly border: Schema.optional<Schema.Boolean>;
+        tone: Schema.optional<Schema.Literals<readonly [0, 1, 2, 3]>>;
+        rounded: Schema.optional<Schema.Boolean>;
+        fill: Schema.optional<Schema.Boolean>;
+        border: Schema.optional<Schema.Boolean>;
         /** A guide: drawn dashed and unfilled, an annotation rather than content. */
-        readonly guide: Schema.optional<Schema.Boolean>;
+        guide: Schema.optional<Schema.Boolean>;
+        /** The face of the shape's text; unset is the theme's body face. */
+        fontFamily: Schema.optional<Schema.Literals<readonly ["default", "monospace"]>>;
         /** Text size in the node's own scene units (the editor offers a readable range; stored values are not checked). */
-        readonly fontSize: Schema.optional<Schema.Number>;
-        /** Extra classes on the frame, for a host's own look. */
-        readonly className: Schema.optional<Schema.String>;
+        fontSize: Schema.optional<Schema.Number>;
+        /** Where the text sits across the shape; unset is the type's own (a label centres, a note starts at the left). */
+        alignHorizontal: Schema.optional<Schema.Literals<readonly ["left", "center", "right"]>>;
+        /** Where the text sits down the shape; unset is the type's own (a label is middled, a note starts at the top). */
+        alignVertical: Schema.optional<Schema.Literals<readonly ["top", "middle", "bottom"]>>;
     }>>;
-    readonly type: Schema.Literal<"ellipse">;
     readonly label: Schema.optional<Schema.String>;
+    readonly type: Schema.Literal<"rect">;
 }>;
-export type EllipseNode = Schema.Schema.Type<typeof EllipseNode>;
-/** UML class box: a name compartment over attribute and method compartments. */
-export declare const ClassNode: Schema.Struct<{
+export type RectNode = Schema.Schema.Type<typeof RectNode>;
+/** An ellipse inscribed in the frame. */
+export declare const EllipseNode: Schema.Struct<{
     readonly id: Schema.String;
     readonly z: Schema.String;
     readonly locked: Schema.optional<Schema.Boolean>;
@@ -247,27 +349,33 @@ export declare const ClassNode: Schema.Struct<{
         readonly accepts: Schema.optional<Schema.Literals<readonly ["in", "out", "any"]>>;
     }>>>;
     readonly portsPerSide: Schema.optional<Schema.Number>;
+    readonly layer: Schema.optional<Schema.String>;
+    readonly class: Schema.optional<Schema.String>;
     readonly style: Schema.optional<Schema.Struct<{
-        /** One of the theme's hues, colouring fill, text and border together. */
-        readonly hue: Schema.optional<Schema.String>;
+        /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+        hue: Schema.optional<Schema.String>;
+        /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+        lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
         /** The hue's fill; unset is 2, the look a hue had before tones. */
-        readonly tone: Schema.optional<Schema.Literals<readonly [0, 1, 2, 3]>>;
-        readonly rounded: Schema.optional<Schema.Boolean>;
-        readonly fill: Schema.optional<Schema.Boolean>;
-        readonly border: Schema.optional<Schema.Boolean>;
+        tone: Schema.optional<Schema.Literals<readonly [0, 1, 2, 3]>>;
+        rounded: Schema.optional<Schema.Boolean>;
+        fill: Schema.optional<Schema.Boolean>;
+        border: Schema.optional<Schema.Boolean>;
         /** A guide: drawn dashed and unfilled, an annotation rather than content. */
-        readonly guide: Schema.optional<Schema.Boolean>;
+        guide: Schema.optional<Schema.Boolean>;
+        /** The face of the shape's text; unset is the theme's body face. */
+        fontFamily: Schema.optional<Schema.Literals<readonly ["default", "monospace"]>>;
         /** Text size in the node's own scene units (the editor offers a readable range; stored values are not checked). */
-        readonly fontSize: Schema.optional<Schema.Number>;
-        /** Extra classes on the frame, for a host's own look. */
-        readonly className: Schema.optional<Schema.String>;
+        fontSize: Schema.optional<Schema.Number>;
+        /** Where the text sits across the shape; unset is the type's own (a label centres, a note starts at the left). */
+        alignHorizontal: Schema.optional<Schema.Literals<readonly ["left", "center", "right"]>>;
+        /** Where the text sits down the shape; unset is the type's own (a label is middled, a note starts at the top). */
+        alignVertical: Schema.optional<Schema.Literals<readonly ["top", "middle", "bottom"]>>;
     }>>;
-    readonly type: Schema.Literal<"class">;
-    readonly name: Schema.String;
-    readonly attributes: Schema.$Array<Schema.String>;
-    readonly methods: Schema.$Array<Schema.String>;
+    readonly type: Schema.Literal<"ellipse">;
+    readonly label: Schema.optional<Schema.String>;
 }>;
-export type ClassNode = Schema.Schema.Type<typeof ClassNode>;
+export type EllipseNode = Schema.Schema.Type<typeof EllipseNode>;
 /** Free text on the canvas. Named for what it is, so a host may keep `text` for a type of its own. */
 export declare const NoteNode: Schema.Struct<{
     readonly id: Schema.String;
@@ -288,27 +396,35 @@ export declare const NoteNode: Schema.Struct<{
         readonly accepts: Schema.optional<Schema.Literals<readonly ["in", "out", "any"]>>;
     }>>>;
     readonly portsPerSide: Schema.optional<Schema.Number>;
+    readonly layer: Schema.optional<Schema.String>;
+    readonly class: Schema.optional<Schema.String>;
     readonly style: Schema.optional<Schema.Struct<{
-        /** One of the theme's hues, colouring fill, text and border together. */
-        readonly hue: Schema.optional<Schema.String>;
+        /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+        hue: Schema.optional<Schema.String>;
+        /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+        lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
         /** The hue's fill; unset is 2, the look a hue had before tones. */
-        readonly tone: Schema.optional<Schema.Literals<readonly [0, 1, 2, 3]>>;
-        readonly rounded: Schema.optional<Schema.Boolean>;
-        readonly fill: Schema.optional<Schema.Boolean>;
-        readonly border: Schema.optional<Schema.Boolean>;
+        tone: Schema.optional<Schema.Literals<readonly [0, 1, 2, 3]>>;
+        rounded: Schema.optional<Schema.Boolean>;
+        fill: Schema.optional<Schema.Boolean>;
+        border: Schema.optional<Schema.Boolean>;
         /** A guide: drawn dashed and unfilled, an annotation rather than content. */
-        readonly guide: Schema.optional<Schema.Boolean>;
+        guide: Schema.optional<Schema.Boolean>;
+        /** The face of the shape's text; unset is the theme's body face. */
+        fontFamily: Schema.optional<Schema.Literals<readonly ["default", "monospace"]>>;
         /** Text size in the node's own scene units (the editor offers a readable range; stored values are not checked). */
-        readonly fontSize: Schema.optional<Schema.Number>;
-        /** Extra classes on the frame, for a host's own look. */
-        readonly className: Schema.optional<Schema.String>;
+        fontSize: Schema.optional<Schema.Number>;
+        /** Where the text sits across the shape; unset is the type's own (a label centres, a note starts at the left). */
+        alignHorizontal: Schema.optional<Schema.Literals<readonly ["left", "center", "right"]>>;
+        /** Where the text sits down the shape; unset is the type's own (a label is middled, a note starts at the top). */
+        alignVertical: Schema.optional<Schema.Literals<readonly ["top", "middle", "bottom"]>>;
     }>>;
     readonly type: Schema.Literal<"note">;
     readonly text: Schema.String;
 }>;
 export type NoteNode = Schema.Schema.Type<typeof NoteNode>;
-/** Portal to the next depth: renders the referenced scene scaled into this node's bounds. */
-export declare const PortalNode: Schema.Struct<{
+/** A frame onto the next depth: renders its child scene scaled into this node's bounds. */
+export declare const FrameNode: Schema.Struct<{
     readonly id: Schema.String;
     readonly z: Schema.String;
     readonly locked: Schema.optional<Schema.Boolean>;
@@ -327,28 +443,36 @@ export declare const PortalNode: Schema.Struct<{
         readonly accepts: Schema.optional<Schema.Literals<readonly ["in", "out", "any"]>>;
     }>>>;
     readonly portsPerSide: Schema.optional<Schema.Number>;
+    readonly layer: Schema.optional<Schema.String>;
+    readonly class: Schema.optional<Schema.String>;
     readonly style: Schema.optional<Schema.Struct<{
-        /** One of the theme's hues, colouring fill, text and border together. */
-        readonly hue: Schema.optional<Schema.String>;
+        /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+        hue: Schema.optional<Schema.String>;
+        /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+        lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
         /** The hue's fill; unset is 2, the look a hue had before tones. */
-        readonly tone: Schema.optional<Schema.Literals<readonly [0, 1, 2, 3]>>;
-        readonly rounded: Schema.optional<Schema.Boolean>;
-        readonly fill: Schema.optional<Schema.Boolean>;
-        readonly border: Schema.optional<Schema.Boolean>;
+        tone: Schema.optional<Schema.Literals<readonly [0, 1, 2, 3]>>;
+        rounded: Schema.optional<Schema.Boolean>;
+        fill: Schema.optional<Schema.Boolean>;
+        border: Schema.optional<Schema.Boolean>;
         /** A guide: drawn dashed and unfilled, an annotation rather than content. */
-        readonly guide: Schema.optional<Schema.Boolean>;
+        guide: Schema.optional<Schema.Boolean>;
+        /** The face of the shape's text; unset is the theme's body face. */
+        fontFamily: Schema.optional<Schema.Literals<readonly ["default", "monospace"]>>;
         /** Text size in the node's own scene units (the editor offers a readable range; stored values are not checked). */
-        readonly fontSize: Schema.optional<Schema.Number>;
-        /** Extra classes on the frame, for a host's own look. */
-        readonly className: Schema.optional<Schema.String>;
+        fontSize: Schema.optional<Schema.Number>;
+        /** Where the text sits across the shape; unset is the type's own (a label centres, a note starts at the left). */
+        alignHorizontal: Schema.optional<Schema.Literals<readonly ["left", "center", "right"]>>;
+        /** Where the text sits down the shape; unset is the type's own (a label is middled, a note starts at the top). */
+        alignVertical: Schema.optional<Schema.Literals<readonly ["top", "middle", "bottom"]>>;
     }>>;
     readonly label: Schema.optional<Schema.String>;
-    readonly type: Schema.Literal<"scene">;
+    readonly type: Schema.Literal<"frame">;
     readonly scene: Schema.String;
     /** Draw the child scene inside the frame rather than the label; unset, it does so while there is no label. */
     readonly contents: Schema.optional<Schema.Boolean>;
 }>;
-export type PortalNode = Schema.Schema.Type<typeof PortalNode>;
+export type FrameNode = Schema.Schema.Type<typeof FrameNode>;
 /** The engine's own node types. A host may add its own (decision 1); those are `NodeBase` to the engine. */
 export declare const BuiltinNode: Schema.Union<readonly [Schema.Struct<{
     readonly id: Schema.String;
@@ -369,20 +493,28 @@ export declare const BuiltinNode: Schema.Union<readonly [Schema.Struct<{
         readonly accepts: Schema.optional<Schema.Literals<readonly ["in", "out", "any"]>>;
     }>>>;
     readonly portsPerSide: Schema.optional<Schema.Number>;
+    readonly layer: Schema.optional<Schema.String>;
+    readonly class: Schema.optional<Schema.String>;
     readonly style: Schema.optional<Schema.Struct<{
-        /** One of the theme's hues, colouring fill, text and border together. */
-        readonly hue: Schema.optional<Schema.String>;
+        /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+        hue: Schema.optional<Schema.String>;
+        /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+        lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
         /** The hue's fill; unset is 2, the look a hue had before tones. */
-        readonly tone: Schema.optional<Schema.Literals<readonly [0, 1, 2, 3]>>;
-        readonly rounded: Schema.optional<Schema.Boolean>;
-        readonly fill: Schema.optional<Schema.Boolean>;
-        readonly border: Schema.optional<Schema.Boolean>;
+        tone: Schema.optional<Schema.Literals<readonly [0, 1, 2, 3]>>;
+        rounded: Schema.optional<Schema.Boolean>;
+        fill: Schema.optional<Schema.Boolean>;
+        border: Schema.optional<Schema.Boolean>;
         /** A guide: drawn dashed and unfilled, an annotation rather than content. */
-        readonly guide: Schema.optional<Schema.Boolean>;
+        guide: Schema.optional<Schema.Boolean>;
+        /** The face of the shape's text; unset is the theme's body face. */
+        fontFamily: Schema.optional<Schema.Literals<readonly ["default", "monospace"]>>;
         /** Text size in the node's own scene units (the editor offers a readable range; stored values are not checked). */
-        readonly fontSize: Schema.optional<Schema.Number>;
-        /** Extra classes on the frame, for a host's own look. */
-        readonly className: Schema.optional<Schema.String>;
+        fontSize: Schema.optional<Schema.Number>;
+        /** Where the text sits across the shape; unset is the type's own (a label centres, a note starts at the left). */
+        alignHorizontal: Schema.optional<Schema.Literals<readonly ["left", "center", "right"]>>;
+        /** Where the text sits down the shape; unset is the type's own (a label is middled, a note starts at the top). */
+        alignVertical: Schema.optional<Schema.Literals<readonly ["top", "middle", "bottom"]>>;
     }>>;
     readonly label: Schema.optional<Schema.String>;
     readonly type: Schema.Literal<"rect">;
@@ -405,20 +537,28 @@ export declare const BuiltinNode: Schema.Union<readonly [Schema.Struct<{
         readonly accepts: Schema.optional<Schema.Literals<readonly ["in", "out", "any"]>>;
     }>>>;
     readonly portsPerSide: Schema.optional<Schema.Number>;
+    readonly layer: Schema.optional<Schema.String>;
+    readonly class: Schema.optional<Schema.String>;
     readonly style: Schema.optional<Schema.Struct<{
-        /** One of the theme's hues, colouring fill, text and border together. */
-        readonly hue: Schema.optional<Schema.String>;
+        /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+        hue: Schema.optional<Schema.String>;
+        /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+        lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
         /** The hue's fill; unset is 2, the look a hue had before tones. */
-        readonly tone: Schema.optional<Schema.Literals<readonly [0, 1, 2, 3]>>;
-        readonly rounded: Schema.optional<Schema.Boolean>;
-        readonly fill: Schema.optional<Schema.Boolean>;
-        readonly border: Schema.optional<Schema.Boolean>;
+        tone: Schema.optional<Schema.Literals<readonly [0, 1, 2, 3]>>;
+        rounded: Schema.optional<Schema.Boolean>;
+        fill: Schema.optional<Schema.Boolean>;
+        border: Schema.optional<Schema.Boolean>;
         /** A guide: drawn dashed and unfilled, an annotation rather than content. */
-        readonly guide: Schema.optional<Schema.Boolean>;
+        guide: Schema.optional<Schema.Boolean>;
+        /** The face of the shape's text; unset is the theme's body face. */
+        fontFamily: Schema.optional<Schema.Literals<readonly ["default", "monospace"]>>;
         /** Text size in the node's own scene units (the editor offers a readable range; stored values are not checked). */
-        readonly fontSize: Schema.optional<Schema.Number>;
-        /** Extra classes on the frame, for a host's own look. */
-        readonly className: Schema.optional<Schema.String>;
+        fontSize: Schema.optional<Schema.Number>;
+        /** Where the text sits across the shape; unset is the type's own (a label centres, a note starts at the left). */
+        alignHorizontal: Schema.optional<Schema.Literals<readonly ["left", "center", "right"]>>;
+        /** Where the text sits down the shape; unset is the type's own (a label is middled, a note starts at the top). */
+        alignVertical: Schema.optional<Schema.Literals<readonly ["top", "middle", "bottom"]>>;
     }>>;
     readonly type: Schema.Literal<"ellipse">;
     readonly label: Schema.optional<Schema.String>;
@@ -441,58 +581,28 @@ export declare const BuiltinNode: Schema.Union<readonly [Schema.Struct<{
         readonly accepts: Schema.optional<Schema.Literals<readonly ["in", "out", "any"]>>;
     }>>>;
     readonly portsPerSide: Schema.optional<Schema.Number>;
+    readonly layer: Schema.optional<Schema.String>;
+    readonly class: Schema.optional<Schema.String>;
     readonly style: Schema.optional<Schema.Struct<{
-        /** One of the theme's hues, colouring fill, text and border together. */
-        readonly hue: Schema.optional<Schema.String>;
-        /** The hue's fill; unset is 2, the look a hue had before tones. */
-        readonly tone: Schema.optional<Schema.Literals<readonly [0, 1, 2, 3]>>;
-        readonly rounded: Schema.optional<Schema.Boolean>;
-        readonly fill: Schema.optional<Schema.Boolean>;
-        readonly border: Schema.optional<Schema.Boolean>;
-        /** A guide: drawn dashed and unfilled, an annotation rather than content. */
-        readonly guide: Schema.optional<Schema.Boolean>;
-        /** Text size in the node's own scene units (the editor offers a readable range; stored values are not checked). */
-        readonly fontSize: Schema.optional<Schema.Number>;
-        /** Extra classes on the frame, for a host's own look. */
-        readonly className: Schema.optional<Schema.String>;
-    }>>;
-    readonly type: Schema.Literal<"class">;
-    readonly name: Schema.String;
-    readonly attributes: Schema.$Array<Schema.String>;
-    readonly methods: Schema.$Array<Schema.String>;
-}>, Schema.Struct<{
-    readonly id: Schema.String;
-    readonly z: Schema.String;
-    readonly locked: Schema.optional<Schema.Boolean>;
-    readonly center: Schema.Struct<{
-        readonly x: Schema.Number;
-        readonly y: Schema.Number;
-    }>;
-    readonly size: Schema.Struct<{
-        readonly width: Schema.Number;
-        readonly height: Schema.Number;
-    }>;
-    readonly ports: Schema.optional<Schema.$Array<Schema.Struct<{
-        readonly id: Schema.String;
-        readonly side: Schema.Literals<readonly ["n", "e", "s", "w"]>;
-        readonly offset: Schema.Number;
-        readonly accepts: Schema.optional<Schema.Literals<readonly ["in", "out", "any"]>>;
-    }>>>;
-    readonly portsPerSide: Schema.optional<Schema.Number>;
-    readonly style: Schema.optional<Schema.Struct<{
-        /** One of the theme's hues, colouring fill, text and border together. */
-        readonly hue: Schema.optional<Schema.String>;
+        /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+        hue: Schema.optional<Schema.String>;
+        /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+        lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
         /** The hue's fill; unset is 2, the look a hue had before tones. */
-        readonly tone: Schema.optional<Schema.Literals<readonly [0, 1, 2, 3]>>;
-        readonly rounded: Schema.optional<Schema.Boolean>;
-        readonly fill: Schema.optional<Schema.Boolean>;
-        readonly border: Schema.optional<Schema.Boolean>;
+        tone: Schema.optional<Schema.Literals<readonly [0, 1, 2, 3]>>;
+        rounded: Schema.optional<Schema.Boolean>;
+        fill: Schema.optional<Schema.Boolean>;
+        border: Schema.optional<Schema.Boolean>;
         /** A guide: drawn dashed and unfilled, an annotation rather than content. */
-        readonly guide: Schema.optional<Schema.Boolean>;
+        guide: Schema.optional<Schema.Boolean>;
+        /** The face of the shape's text; unset is the theme's body face. */
+        fontFamily: Schema.optional<Schema.Literals<readonly ["default", "monospace"]>>;
         /** Text size in the node's own scene units (the editor offers a readable range; stored values are not checked). */
-        readonly fontSize: Schema.optional<Schema.Number>;
-        /** Extra classes on the frame, for a host's own look. */
-        readonly className: Schema.optional<Schema.String>;
+        fontSize: Schema.optional<Schema.Number>;
+        /** Where the text sits across the shape; unset is the type's own (a label centres, a note starts at the left). */
+        alignHorizontal: Schema.optional<Schema.Literals<readonly ["left", "center", "right"]>>;
+        /** Where the text sits down the shape; unset is the type's own (a label is middled, a note starts at the top). */
+        alignVertical: Schema.optional<Schema.Literals<readonly ["top", "middle", "bottom"]>>;
     }>>;
     readonly type: Schema.Literal<"note">;
     readonly text: Schema.String;
@@ -515,23 +625,31 @@ export declare const BuiltinNode: Schema.Union<readonly [Schema.Struct<{
         readonly accepts: Schema.optional<Schema.Literals<readonly ["in", "out", "any"]>>;
     }>>>;
     readonly portsPerSide: Schema.optional<Schema.Number>;
+    readonly layer: Schema.optional<Schema.String>;
+    readonly class: Schema.optional<Schema.String>;
     readonly style: Schema.optional<Schema.Struct<{
-        /** One of the theme's hues, colouring fill, text and border together. */
-        readonly hue: Schema.optional<Schema.String>;
+        /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+        hue: Schema.optional<Schema.String>;
+        /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+        lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
         /** The hue's fill; unset is 2, the look a hue had before tones. */
-        readonly tone: Schema.optional<Schema.Literals<readonly [0, 1, 2, 3]>>;
-        readonly rounded: Schema.optional<Schema.Boolean>;
-        readonly fill: Schema.optional<Schema.Boolean>;
-        readonly border: Schema.optional<Schema.Boolean>;
+        tone: Schema.optional<Schema.Literals<readonly [0, 1, 2, 3]>>;
+        rounded: Schema.optional<Schema.Boolean>;
+        fill: Schema.optional<Schema.Boolean>;
+        border: Schema.optional<Schema.Boolean>;
         /** A guide: drawn dashed and unfilled, an annotation rather than content. */
-        readonly guide: Schema.optional<Schema.Boolean>;
+        guide: Schema.optional<Schema.Boolean>;
+        /** The face of the shape's text; unset is the theme's body face. */
+        fontFamily: Schema.optional<Schema.Literals<readonly ["default", "monospace"]>>;
         /** Text size in the node's own scene units (the editor offers a readable range; stored values are not checked). */
-        readonly fontSize: Schema.optional<Schema.Number>;
-        /** Extra classes on the frame, for a host's own look. */
-        readonly className: Schema.optional<Schema.String>;
+        fontSize: Schema.optional<Schema.Number>;
+        /** Where the text sits across the shape; unset is the type's own (a label centres, a note starts at the left). */
+        alignHorizontal: Schema.optional<Schema.Literals<readonly ["left", "center", "right"]>>;
+        /** Where the text sits down the shape; unset is the type's own (a label is middled, a note starts at the top). */
+        alignVertical: Schema.optional<Schema.Literals<readonly ["top", "middle", "bottom"]>>;
     }>>;
     readonly label: Schema.optional<Schema.String>;
-    readonly type: Schema.Literal<"scene">;
+    readonly type: Schema.Literal<"frame">;
     readonly scene: Schema.String;
     /** Draw the child scene inside the frame rather than the label; unset, it does so while there is no label. */
     readonly contents: Schema.optional<Schema.Boolean>;
@@ -546,13 +664,12 @@ export type NodeType = string;
 /** Narrows a node to one built-in type; sound because the registry maps each type name to one schema. */
 export declare const isRectNode: (node: NodeBase) => node is RectNode;
 export declare const isEllipseNode: (node: NodeBase) => node is EllipseNode;
-export declare const isClassNode: (node: NodeBase) => node is ClassNode;
 export declare const isNoteNode: (node: NodeBase) => node is NoteNode;
-export declare const isPortalNode: (node: NodeBase) => node is PortalNode;
+export declare const isFrameNode: (node: NodeBase) => node is FrameNode;
 /** A node built on the `box` prototype, carrying a centred, editable label. */
-export declare const isBoxNode: (node: NodeBase) => node is RectNode | PortalNode;
-/** Whether a portal draws its child scene: as set, else while it has no label to show instead. */
-export declare const showsContents: (node: PortalNode) => boolean;
+export declare const isBoxNode: (node: NodeBase) => node is RectNode | FrameNode;
+/** Whether a frame draws its child scene: as set, else while it has no label to show instead. */
+export declare const showsContents: (node: FrameNode) => boolean;
 export declare const isBuiltinNode: (node: NodeBase) => node is BuiltinNode;
 /** A link end on a node; no `port` means automatic (the closest appropriate pair, recomputed on every projection). */
 export declare const PortEndpoint: Schema.Struct<{
@@ -582,15 +699,48 @@ export declare const isPointEndpoint: (end: Endpoint) => end is PointEndpoint;
 /** The node an end is attached to; a free end has none. */
 export declare const endpointNode: (end: Endpoint) => NodeId | undefined;
 /** What is drawn at a link end. */
-export declare const Marker: Schema.Literals<readonly ["arrow", "circle"]>;
+/** An end marker: a filled `arrow`, a `circle`, or a hollow `triangle` (inheritance). */
+export declare const Marker: Schema.Literals<readonly ["arrow", "circle", "triangle"]>;
 export type Marker = Schema.Schema.Type<typeof Marker>;
 /** Markers at the source (`start`) and target (`end`) of a link. */
 /** A link's end markers; the properties form shows them side by side, as the two ends of the line. */
 export declare const LinkEnds: Schema.Struct<{
-    readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
-    readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
+    readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+    readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
 }>;
 export type LinkEnds = Schema.Schema.Type<typeof LinkEnds>;
+/**
+ * A named look of a drawing, kept beside its scenes: the nodes and links naming it derive their `style` from it (a
+ * link takes the common base, its colour and line style), so one class restyles both together.
+ */
+export declare const StyleClass: Schema.Struct<{
+    readonly id: Schema.String;
+    readonly name: Schema.String;
+    readonly style: Schema.optional<Schema.Struct<{
+        /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+        hue: Schema.optional<Schema.String>;
+        /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+        lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
+        /** The hue's fill; unset is 2, the look a hue had before tones. */
+        tone: Schema.optional<Schema.Literals<readonly [0, 1, 2, 3]>>;
+        rounded: Schema.optional<Schema.Boolean>;
+        fill: Schema.optional<Schema.Boolean>;
+        border: Schema.optional<Schema.Boolean>;
+        /** A guide: drawn dashed and unfilled, an annotation rather than content. */
+        guide: Schema.optional<Schema.Boolean>;
+        /** The face of the shape's text; unset is the theme's body face. */
+        fontFamily: Schema.optional<Schema.Literals<readonly ["default", "monospace"]>>;
+        /** Text size in the node's own scene units (the editor offers a readable range; stored values are not checked). */
+        fontSize: Schema.optional<Schema.Number>;
+        /** Where the text sits across the shape; unset is the type's own (a label centres, a note starts at the left). */
+        alignHorizontal: Schema.optional<Schema.Literals<readonly ["left", "center", "right"]>>;
+        /** Where the text sits down the shape; unset is the type's own (a label is middled, a note starts at the top). */
+        alignVertical: Schema.optional<Schema.Literals<readonly ["top", "middle", "bottom"]>>;
+    }>>;
+}>;
+export type StyleClass = Schema.Schema.Type<typeof StyleClass>;
+/** A drawing's style classes by id. */
+export type StyleMap = Readonly<Record<string, StyleClass>>;
 export declare const LineLink: Schema.Struct<{
     readonly id: Schema.String;
     readonly z: Schema.String;
@@ -613,10 +763,18 @@ export declare const LineLink: Schema.Struct<{
             readonly y: Schema.Number;
         }>;
     }>]>;
-    readonly directed: Schema.optional<Schema.Boolean>;
     readonly ends: Schema.optional<Schema.Struct<{
-        readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
-        readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
+        readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+        readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+    }>>;
+    readonly text: Schema.optional<Schema.String>;
+    readonly layer: Schema.optional<Schema.String>;
+    readonly class: Schema.optional<Schema.String>;
+    readonly style: Schema.optional<Schema.Struct<{
+        /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+        hue: Schema.optional<Schema.String>;
+        /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+        lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
     }>>;
     readonly type: Schema.Literal<"line">;
 }>;
@@ -644,10 +802,18 @@ export declare const CurveLink: Schema.Struct<{
             readonly y: Schema.Number;
         }>;
     }>]>;
-    readonly directed: Schema.optional<Schema.Boolean>;
     readonly ends: Schema.optional<Schema.Struct<{
-        readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
-        readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
+        readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+        readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+    }>>;
+    readonly text: Schema.optional<Schema.String>;
+    readonly layer: Schema.optional<Schema.String>;
+    readonly class: Schema.optional<Schema.String>;
+    readonly style: Schema.optional<Schema.Struct<{
+        /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+        hue: Schema.optional<Schema.String>;
+        /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+        lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
     }>>;
     readonly type: Schema.Literal<"curve">;
 }>;
@@ -675,10 +841,18 @@ export declare const SplineLink: Schema.Struct<{
             readonly y: Schema.Number;
         }>;
     }>]>;
-    readonly directed: Schema.optional<Schema.Boolean>;
     readonly ends: Schema.optional<Schema.Struct<{
-        readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
-        readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
+        readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+        readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+    }>>;
+    readonly text: Schema.optional<Schema.String>;
+    readonly layer: Schema.optional<Schema.String>;
+    readonly class: Schema.optional<Schema.String>;
+    readonly style: Schema.optional<Schema.Struct<{
+        /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+        hue: Schema.optional<Schema.String>;
+        /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+        lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
     }>>;
     readonly type: Schema.Literal<"spline">;
     readonly points: Schema.$Array<Schema.Struct<{
@@ -713,10 +887,18 @@ export declare const SmartLink: Schema.Struct<{
             readonly y: Schema.Number;
         }>;
     }>]>;
-    readonly directed: Schema.optional<Schema.Boolean>;
     readonly ends: Schema.optional<Schema.Struct<{
-        readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
-        readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
+        readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+        readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+    }>>;
+    readonly text: Schema.optional<Schema.String>;
+    readonly layer: Schema.optional<Schema.String>;
+    readonly class: Schema.optional<Schema.String>;
+    readonly style: Schema.optional<Schema.Struct<{
+        /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+        hue: Schema.optional<Schema.String>;
+        /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+        lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
     }>>;
     readonly type: Schema.Literal<"smart">;
 }>;
@@ -743,10 +925,18 @@ export declare const Link: Schema.Union<readonly [Schema.Struct<{
             readonly y: Schema.Number;
         }>;
     }>]>;
-    readonly directed: Schema.optional<Schema.Boolean>;
     readonly ends: Schema.optional<Schema.Struct<{
-        readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
-        readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
+        readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+        readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+    }>>;
+    readonly text: Schema.optional<Schema.String>;
+    readonly layer: Schema.optional<Schema.String>;
+    readonly class: Schema.optional<Schema.String>;
+    readonly style: Schema.optional<Schema.Struct<{
+        /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+        hue: Schema.optional<Schema.String>;
+        /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+        lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
     }>>;
     readonly type: Schema.Literal<"line">;
 }>, Schema.Struct<{
@@ -771,10 +961,18 @@ export declare const Link: Schema.Union<readonly [Schema.Struct<{
             readonly y: Schema.Number;
         }>;
     }>]>;
-    readonly directed: Schema.optional<Schema.Boolean>;
     readonly ends: Schema.optional<Schema.Struct<{
-        readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
-        readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
+        readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+        readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+    }>>;
+    readonly text: Schema.optional<Schema.String>;
+    readonly layer: Schema.optional<Schema.String>;
+    readonly class: Schema.optional<Schema.String>;
+    readonly style: Schema.optional<Schema.Struct<{
+        /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+        hue: Schema.optional<Schema.String>;
+        /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+        lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
     }>>;
     readonly type: Schema.Literal<"curve">;
 }>, Schema.Struct<{
@@ -799,10 +997,18 @@ export declare const Link: Schema.Union<readonly [Schema.Struct<{
             readonly y: Schema.Number;
         }>;
     }>]>;
-    readonly directed: Schema.optional<Schema.Boolean>;
     readonly ends: Schema.optional<Schema.Struct<{
-        readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
-        readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
+        readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+        readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+    }>>;
+    readonly text: Schema.optional<Schema.String>;
+    readonly layer: Schema.optional<Schema.String>;
+    readonly class: Schema.optional<Schema.String>;
+    readonly style: Schema.optional<Schema.Struct<{
+        /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+        hue: Schema.optional<Schema.String>;
+        /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+        lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
     }>>;
     readonly type: Schema.Literal<"spline">;
     readonly points: Schema.$Array<Schema.Struct<{
@@ -831,10 +1037,18 @@ export declare const Link: Schema.Union<readonly [Schema.Struct<{
             readonly y: Schema.Number;
         }>;
     }>]>;
-    readonly directed: Schema.optional<Schema.Boolean>;
     readonly ends: Schema.optional<Schema.Struct<{
-        readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
-        readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
+        readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+        readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+    }>>;
+    readonly text: Schema.optional<Schema.String>;
+    readonly layer: Schema.optional<Schema.String>;
+    readonly class: Schema.optional<Schema.String>;
+    readonly style: Schema.optional<Schema.Struct<{
+        /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+        hue: Schema.optional<Schema.String>;
+        /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+        lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
     }>>;
     readonly type: Schema.Literal<"smart">;
 }>]>;
@@ -842,10 +1056,24 @@ export type Link = Schema.Schema.Type<typeof Link>;
 export type LinkType = Link['type'];
 export declare const LINK_TYPES: readonly LinkType[];
 export type Element = Node | Link;
-/** The markers a link draws: its explicit `ends`, else an arrowhead at the target when it is `directed`. */
+/** The markers a link draws. */
 export declare const linkMarkers: (link: Link) => LinkEnds;
 export declare const isNode: (element: Element) => element is Node;
 export declare const isLink: (element: Element) => element is Link;
+/** A layer id, unique within its scene. */
+export type LayerId = string;
+/**
+ * A scene's layer: elements paint by their layer's order (`z`, bottom first), then by their own `z`. A hidden layer
+ * is neither drawn nor hit. A scene with no layers has one, implicitly (`DEFAULT_LAYER`).
+ */
+export declare const Layer: Schema.Struct<{
+    readonly id: Schema.String;
+    readonly name: Schema.String;
+    /** Fractional order key (see `order.ts`): the bottom layer has the least. */
+    readonly z: Schema.String;
+    readonly hidden: Schema.optional<Schema.Boolean>;
+}>;
+export type Layer = Schema.Schema.Type<typeof Layer>;
 /**
  * The scene schema over a set of node schemas: a host composes it from its registry's types, so the
  * schema stays exact for every type while the engine only ever sees `NodeBase`.
@@ -876,10 +1104,18 @@ export declare const createSceneSchema: <const Nodes extends readonly Schema.Cod
                 readonly y: Schema.Number;
             }>;
         }>]>;
-        readonly directed: Schema.optional<Schema.Boolean>;
         readonly ends: Schema.optional<Schema.Struct<{
-            readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
-            readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
+            readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+            readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+        }>>;
+        readonly text: Schema.optional<Schema.String>;
+        readonly layer: Schema.optional<Schema.String>;
+        readonly class: Schema.optional<Schema.String>;
+        readonly style: Schema.optional<Schema.Struct<{
+            /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+            hue: Schema.optional<Schema.String>;
+            /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+            lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
         }>>;
         readonly type: Schema.Literal<"line">;
     }>, Schema.Struct<{
@@ -904,10 +1140,18 @@ export declare const createSceneSchema: <const Nodes extends readonly Schema.Cod
                 readonly y: Schema.Number;
             }>;
         }>]>;
-        readonly directed: Schema.optional<Schema.Boolean>;
         readonly ends: Schema.optional<Schema.Struct<{
-            readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
-            readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
+            readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+            readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+        }>>;
+        readonly text: Schema.optional<Schema.String>;
+        readonly layer: Schema.optional<Schema.String>;
+        readonly class: Schema.optional<Schema.String>;
+        readonly style: Schema.optional<Schema.Struct<{
+            /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+            hue: Schema.optional<Schema.String>;
+            /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+            lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
         }>>;
         readonly type: Schema.Literal<"curve">;
     }>, Schema.Struct<{
@@ -932,10 +1176,18 @@ export declare const createSceneSchema: <const Nodes extends readonly Schema.Cod
                 readonly y: Schema.Number;
             }>;
         }>]>;
-        readonly directed: Schema.optional<Schema.Boolean>;
         readonly ends: Schema.optional<Schema.Struct<{
-            readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
-            readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
+            readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+            readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+        }>>;
+        readonly text: Schema.optional<Schema.String>;
+        readonly layer: Schema.optional<Schema.String>;
+        readonly class: Schema.optional<Schema.String>;
+        readonly style: Schema.optional<Schema.Struct<{
+            /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+            hue: Schema.optional<Schema.String>;
+            /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+            lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
         }>>;
         readonly type: Schema.Literal<"spline">;
         readonly points: Schema.$Array<Schema.Struct<{
@@ -964,13 +1216,28 @@ export declare const createSceneSchema: <const Nodes extends readonly Schema.Cod
                 readonly y: Schema.Number;
             }>;
         }>]>;
-        readonly directed: Schema.optional<Schema.Boolean>;
         readonly ends: Schema.optional<Schema.Struct<{
-            readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
-            readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
+            readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+            readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+        }>>;
+        readonly text: Schema.optional<Schema.String>;
+        readonly layer: Schema.optional<Schema.String>;
+        readonly class: Schema.optional<Schema.String>;
+        readonly style: Schema.optional<Schema.Struct<{
+            /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+            hue: Schema.optional<Schema.String>;
+            /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+            lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
         }>>;
         readonly type: Schema.Literal<"smart">;
     }>]>>;
+    readonly layers: Schema.optional<Schema.$Record<Schema.String, Schema.Struct<{
+        readonly id: Schema.String;
+        readonly name: Schema.String;
+        /** Fractional order key (see `order.ts`): the bottom layer has the least. */
+        readonly z: Schema.String;
+        readonly hidden: Schema.optional<Schema.Boolean>;
+    }>>>;
 }>;
 /** The scene schema over the built-in node types. */
 export declare const Scene: Schema.Struct<{
@@ -995,20 +1262,28 @@ export declare const Scene: Schema.Struct<{
             readonly accepts: Schema.optional<Schema.Literals<readonly ["in", "out", "any"]>>;
         }>>>;
         readonly portsPerSide: Schema.optional<Schema.Number>;
+        readonly layer: Schema.optional<Schema.String>;
+        readonly class: Schema.optional<Schema.String>;
         readonly style: Schema.optional<Schema.Struct<{
-            /** One of the theme's hues, colouring fill, text and border together. */
-            readonly hue: Schema.optional<Schema.String>;
+            /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+            hue: Schema.optional<Schema.String>;
+            /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+            lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
             /** The hue's fill; unset is 2, the look a hue had before tones. */
-            readonly tone: Schema.optional<Schema.Literals<readonly [0, 1, 2, 3]>>;
-            readonly rounded: Schema.optional<Schema.Boolean>;
-            readonly fill: Schema.optional<Schema.Boolean>;
-            readonly border: Schema.optional<Schema.Boolean>;
+            tone: Schema.optional<Schema.Literals<readonly [0, 1, 2, 3]>>;
+            rounded: Schema.optional<Schema.Boolean>;
+            fill: Schema.optional<Schema.Boolean>;
+            border: Schema.optional<Schema.Boolean>;
             /** A guide: drawn dashed and unfilled, an annotation rather than content. */
-            readonly guide: Schema.optional<Schema.Boolean>;
+            guide: Schema.optional<Schema.Boolean>;
+            /** The face of the shape's text; unset is the theme's body face. */
+            fontFamily: Schema.optional<Schema.Literals<readonly ["default", "monospace"]>>;
             /** Text size in the node's own scene units (the editor offers a readable range; stored values are not checked). */
-            readonly fontSize: Schema.optional<Schema.Number>;
-            /** Extra classes on the frame, for a host's own look. */
-            readonly className: Schema.optional<Schema.String>;
+            fontSize: Schema.optional<Schema.Number>;
+            /** Where the text sits across the shape; unset is the type's own (a label centres, a note starts at the left). */
+            alignHorizontal: Schema.optional<Schema.Literals<readonly ["left", "center", "right"]>>;
+            /** Where the text sits down the shape; unset is the type's own (a label is middled, a note starts at the top). */
+            alignVertical: Schema.optional<Schema.Literals<readonly ["top", "middle", "bottom"]>>;
         }>>;
         readonly label: Schema.optional<Schema.String>;
         readonly type: Schema.Literal<"rect">;
@@ -1031,20 +1306,28 @@ export declare const Scene: Schema.Struct<{
             readonly accepts: Schema.optional<Schema.Literals<readonly ["in", "out", "any"]>>;
         }>>>;
         readonly portsPerSide: Schema.optional<Schema.Number>;
+        readonly layer: Schema.optional<Schema.String>;
+        readonly class: Schema.optional<Schema.String>;
         readonly style: Schema.optional<Schema.Struct<{
-            /** One of the theme's hues, colouring fill, text and border together. */
-            readonly hue: Schema.optional<Schema.String>;
+            /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+            hue: Schema.optional<Schema.String>;
+            /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+            lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
             /** The hue's fill; unset is 2, the look a hue had before tones. */
-            readonly tone: Schema.optional<Schema.Literals<readonly [0, 1, 2, 3]>>;
-            readonly rounded: Schema.optional<Schema.Boolean>;
-            readonly fill: Schema.optional<Schema.Boolean>;
-            readonly border: Schema.optional<Schema.Boolean>;
+            tone: Schema.optional<Schema.Literals<readonly [0, 1, 2, 3]>>;
+            rounded: Schema.optional<Schema.Boolean>;
+            fill: Schema.optional<Schema.Boolean>;
+            border: Schema.optional<Schema.Boolean>;
             /** A guide: drawn dashed and unfilled, an annotation rather than content. */
-            readonly guide: Schema.optional<Schema.Boolean>;
+            guide: Schema.optional<Schema.Boolean>;
+            /** The face of the shape's text; unset is the theme's body face. */
+            fontFamily: Schema.optional<Schema.Literals<readonly ["default", "monospace"]>>;
             /** Text size in the node's own scene units (the editor offers a readable range; stored values are not checked). */
-            readonly fontSize: Schema.optional<Schema.Number>;
-            /** Extra classes on the frame, for a host's own look. */
-            readonly className: Schema.optional<Schema.String>;
+            fontSize: Schema.optional<Schema.Number>;
+            /** Where the text sits across the shape; unset is the type's own (a label centres, a note starts at the left). */
+            alignHorizontal: Schema.optional<Schema.Literals<readonly ["left", "center", "right"]>>;
+            /** Where the text sits down the shape; unset is the type's own (a label is middled, a note starts at the top). */
+            alignVertical: Schema.optional<Schema.Literals<readonly ["top", "middle", "bottom"]>>;
         }>>;
         readonly type: Schema.Literal<"ellipse">;
         readonly label: Schema.optional<Schema.String>;
@@ -1067,58 +1350,28 @@ export declare const Scene: Schema.Struct<{
             readonly accepts: Schema.optional<Schema.Literals<readonly ["in", "out", "any"]>>;
         }>>>;
         readonly portsPerSide: Schema.optional<Schema.Number>;
+        readonly layer: Schema.optional<Schema.String>;
+        readonly class: Schema.optional<Schema.String>;
         readonly style: Schema.optional<Schema.Struct<{
-            /** One of the theme's hues, colouring fill, text and border together. */
-            readonly hue: Schema.optional<Schema.String>;
+            /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+            hue: Schema.optional<Schema.String>;
+            /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+            lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
             /** The hue's fill; unset is 2, the look a hue had before tones. */
-            readonly tone: Schema.optional<Schema.Literals<readonly [0, 1, 2, 3]>>;
-            readonly rounded: Schema.optional<Schema.Boolean>;
-            readonly fill: Schema.optional<Schema.Boolean>;
-            readonly border: Schema.optional<Schema.Boolean>;
+            tone: Schema.optional<Schema.Literals<readonly [0, 1, 2, 3]>>;
+            rounded: Schema.optional<Schema.Boolean>;
+            fill: Schema.optional<Schema.Boolean>;
+            border: Schema.optional<Schema.Boolean>;
             /** A guide: drawn dashed and unfilled, an annotation rather than content. */
-            readonly guide: Schema.optional<Schema.Boolean>;
+            guide: Schema.optional<Schema.Boolean>;
+            /** The face of the shape's text; unset is the theme's body face. */
+            fontFamily: Schema.optional<Schema.Literals<readonly ["default", "monospace"]>>;
             /** Text size in the node's own scene units (the editor offers a readable range; stored values are not checked). */
-            readonly fontSize: Schema.optional<Schema.Number>;
-            /** Extra classes on the frame, for a host's own look. */
-            readonly className: Schema.optional<Schema.String>;
-        }>>;
-        readonly type: Schema.Literal<"class">;
-        readonly name: Schema.String;
-        readonly attributes: Schema.$Array<Schema.String>;
-        readonly methods: Schema.$Array<Schema.String>;
-    }>, Schema.Struct<{
-        readonly id: Schema.String;
-        readonly z: Schema.String;
-        readonly locked: Schema.optional<Schema.Boolean>;
-        readonly center: Schema.Struct<{
-            readonly x: Schema.Number;
-            readonly y: Schema.Number;
-        }>;
-        readonly size: Schema.Struct<{
-            readonly width: Schema.Number;
-            readonly height: Schema.Number;
-        }>;
-        readonly ports: Schema.optional<Schema.$Array<Schema.Struct<{
-            readonly id: Schema.String;
-            readonly side: Schema.Literals<readonly ["n", "e", "s", "w"]>;
-            readonly offset: Schema.Number;
-            readonly accepts: Schema.optional<Schema.Literals<readonly ["in", "out", "any"]>>;
-        }>>>;
-        readonly portsPerSide: Schema.optional<Schema.Number>;
-        readonly style: Schema.optional<Schema.Struct<{
-            /** One of the theme's hues, colouring fill, text and border together. */
-            readonly hue: Schema.optional<Schema.String>;
-            /** The hue's fill; unset is 2, the look a hue had before tones. */
-            readonly tone: Schema.optional<Schema.Literals<readonly [0, 1, 2, 3]>>;
-            readonly rounded: Schema.optional<Schema.Boolean>;
-            readonly fill: Schema.optional<Schema.Boolean>;
-            readonly border: Schema.optional<Schema.Boolean>;
-            /** A guide: drawn dashed and unfilled, an annotation rather than content. */
-            readonly guide: Schema.optional<Schema.Boolean>;
-            /** Text size in the node's own scene units (the editor offers a readable range; stored values are not checked). */
-            readonly fontSize: Schema.optional<Schema.Number>;
-            /** Extra classes on the frame, for a host's own look. */
-            readonly className: Schema.optional<Schema.String>;
+            fontSize: Schema.optional<Schema.Number>;
+            /** Where the text sits across the shape; unset is the type's own (a label centres, a note starts at the left). */
+            alignHorizontal: Schema.optional<Schema.Literals<readonly ["left", "center", "right"]>>;
+            /** Where the text sits down the shape; unset is the type's own (a label is middled, a note starts at the top). */
+            alignVertical: Schema.optional<Schema.Literals<readonly ["top", "middle", "bottom"]>>;
         }>>;
         readonly type: Schema.Literal<"note">;
         readonly text: Schema.String;
@@ -1141,23 +1394,31 @@ export declare const Scene: Schema.Struct<{
             readonly accepts: Schema.optional<Schema.Literals<readonly ["in", "out", "any"]>>;
         }>>>;
         readonly portsPerSide: Schema.optional<Schema.Number>;
+        readonly layer: Schema.optional<Schema.String>;
+        readonly class: Schema.optional<Schema.String>;
         readonly style: Schema.optional<Schema.Struct<{
-            /** One of the theme's hues, colouring fill, text and border together. */
-            readonly hue: Schema.optional<Schema.String>;
+            /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+            hue: Schema.optional<Schema.String>;
+            /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+            lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
             /** The hue's fill; unset is 2, the look a hue had before tones. */
-            readonly tone: Schema.optional<Schema.Literals<readonly [0, 1, 2, 3]>>;
-            readonly rounded: Schema.optional<Schema.Boolean>;
-            readonly fill: Schema.optional<Schema.Boolean>;
-            readonly border: Schema.optional<Schema.Boolean>;
+            tone: Schema.optional<Schema.Literals<readonly [0, 1, 2, 3]>>;
+            rounded: Schema.optional<Schema.Boolean>;
+            fill: Schema.optional<Schema.Boolean>;
+            border: Schema.optional<Schema.Boolean>;
             /** A guide: drawn dashed and unfilled, an annotation rather than content. */
-            readonly guide: Schema.optional<Schema.Boolean>;
+            guide: Schema.optional<Schema.Boolean>;
+            /** The face of the shape's text; unset is the theme's body face. */
+            fontFamily: Schema.optional<Schema.Literals<readonly ["default", "monospace"]>>;
             /** Text size in the node's own scene units (the editor offers a readable range; stored values are not checked). */
-            readonly fontSize: Schema.optional<Schema.Number>;
-            /** Extra classes on the frame, for a host's own look. */
-            readonly className: Schema.optional<Schema.String>;
+            fontSize: Schema.optional<Schema.Number>;
+            /** Where the text sits across the shape; unset is the type's own (a label centres, a note starts at the left). */
+            alignHorizontal: Schema.optional<Schema.Literals<readonly ["left", "center", "right"]>>;
+            /** Where the text sits down the shape; unset is the type's own (a label is middled, a note starts at the top). */
+            alignVertical: Schema.optional<Schema.Literals<readonly ["top", "middle", "bottom"]>>;
         }>>;
         readonly label: Schema.optional<Schema.String>;
-        readonly type: Schema.Literal<"scene">;
+        readonly type: Schema.Literal<"frame">;
         readonly scene: Schema.String;
         /** Draw the child scene inside the frame rather than the label; unset, it does so while there is no label. */
         readonly contents: Schema.optional<Schema.Boolean>;
@@ -1184,10 +1445,18 @@ export declare const Scene: Schema.Struct<{
                 readonly y: Schema.Number;
             }>;
         }>]>;
-        readonly directed: Schema.optional<Schema.Boolean>;
         readonly ends: Schema.optional<Schema.Struct<{
-            readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
-            readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
+            readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+            readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+        }>>;
+        readonly text: Schema.optional<Schema.String>;
+        readonly layer: Schema.optional<Schema.String>;
+        readonly class: Schema.optional<Schema.String>;
+        readonly style: Schema.optional<Schema.Struct<{
+            /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+            hue: Schema.optional<Schema.String>;
+            /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+            lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
         }>>;
         readonly type: Schema.Literal<"line">;
     }>, Schema.Struct<{
@@ -1212,10 +1481,18 @@ export declare const Scene: Schema.Struct<{
                 readonly y: Schema.Number;
             }>;
         }>]>;
-        readonly directed: Schema.optional<Schema.Boolean>;
         readonly ends: Schema.optional<Schema.Struct<{
-            readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
-            readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
+            readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+            readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+        }>>;
+        readonly text: Schema.optional<Schema.String>;
+        readonly layer: Schema.optional<Schema.String>;
+        readonly class: Schema.optional<Schema.String>;
+        readonly style: Schema.optional<Schema.Struct<{
+            /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+            hue: Schema.optional<Schema.String>;
+            /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+            lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
         }>>;
         readonly type: Schema.Literal<"curve">;
     }>, Schema.Struct<{
@@ -1240,10 +1517,18 @@ export declare const Scene: Schema.Struct<{
                 readonly y: Schema.Number;
             }>;
         }>]>;
-        readonly directed: Schema.optional<Schema.Boolean>;
         readonly ends: Schema.optional<Schema.Struct<{
-            readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
-            readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
+            readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+            readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+        }>>;
+        readonly text: Schema.optional<Schema.String>;
+        readonly layer: Schema.optional<Schema.String>;
+        readonly class: Schema.optional<Schema.String>;
+        readonly style: Schema.optional<Schema.Struct<{
+            /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+            hue: Schema.optional<Schema.String>;
+            /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+            lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
         }>>;
         readonly type: Schema.Literal<"spline">;
         readonly points: Schema.$Array<Schema.Struct<{
@@ -1272,13 +1557,28 @@ export declare const Scene: Schema.Struct<{
                 readonly y: Schema.Number;
             }>;
         }>]>;
-        readonly directed: Schema.optional<Schema.Boolean>;
         readonly ends: Schema.optional<Schema.Struct<{
-            readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
-            readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
+            readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+            readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+        }>>;
+        readonly text: Schema.optional<Schema.String>;
+        readonly layer: Schema.optional<Schema.String>;
+        readonly class: Schema.optional<Schema.String>;
+        readonly style: Schema.optional<Schema.Struct<{
+            /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+            hue: Schema.optional<Schema.String>;
+            /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+            lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
         }>>;
         readonly type: Schema.Literal<"smart">;
     }>]>>;
+    readonly layers: Schema.optional<Schema.$Record<Schema.String, Schema.Struct<{
+        readonly id: Schema.String;
+        readonly name: Schema.String;
+        /** Fractional order key (see `order.ts`): the bottom layer has the least. */
+        readonly z: Schema.String;
+        readonly hidden: Schema.optional<Schema.Boolean>;
+    }>>>;
 }>;
 /** The scene schema over any node with the shared fields: what the engine itself can validate for a host. */
 export declare const OpenScene: Schema.Struct<{
@@ -1303,20 +1603,28 @@ export declare const OpenScene: Schema.Struct<{
             readonly accepts: Schema.optional<Schema.Literals<readonly ["in", "out", "any"]>>;
         }>>>;
         readonly portsPerSide: Schema.optional<Schema.Number>;
+        readonly layer: Schema.optional<Schema.String>;
+        readonly class: Schema.optional<Schema.String>;
         readonly style: Schema.optional<Schema.Struct<{
-            /** One of the theme's hues, colouring fill, text and border together. */
-            readonly hue: Schema.optional<Schema.String>;
+            /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+            hue: Schema.optional<Schema.String>;
+            /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+            lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
             /** The hue's fill; unset is 2, the look a hue had before tones. */
-            readonly tone: Schema.optional<Schema.Literals<readonly [0, 1, 2, 3]>>;
-            readonly rounded: Schema.optional<Schema.Boolean>;
-            readonly fill: Schema.optional<Schema.Boolean>;
-            readonly border: Schema.optional<Schema.Boolean>;
+            tone: Schema.optional<Schema.Literals<readonly [0, 1, 2, 3]>>;
+            rounded: Schema.optional<Schema.Boolean>;
+            fill: Schema.optional<Schema.Boolean>;
+            border: Schema.optional<Schema.Boolean>;
             /** A guide: drawn dashed and unfilled, an annotation rather than content. */
-            readonly guide: Schema.optional<Schema.Boolean>;
+            guide: Schema.optional<Schema.Boolean>;
+            /** The face of the shape's text; unset is the theme's body face. */
+            fontFamily: Schema.optional<Schema.Literals<readonly ["default", "monospace"]>>;
             /** Text size in the node's own scene units (the editor offers a readable range; stored values are not checked). */
-            readonly fontSize: Schema.optional<Schema.Number>;
-            /** Extra classes on the frame, for a host's own look. */
-            readonly className: Schema.optional<Schema.String>;
+            fontSize: Schema.optional<Schema.Number>;
+            /** Where the text sits across the shape; unset is the type's own (a label centres, a note starts at the left). */
+            alignHorizontal: Schema.optional<Schema.Literals<readonly ["left", "center", "right"]>>;
+            /** Where the text sits down the shape; unset is the type's own (a label is middled, a note starts at the top). */
+            alignVertical: Schema.optional<Schema.Literals<readonly ["top", "middle", "bottom"]>>;
         }>>;
         readonly type: Schema.String;
     }>]>>;
@@ -1342,10 +1650,18 @@ export declare const OpenScene: Schema.Struct<{
                 readonly y: Schema.Number;
             }>;
         }>]>;
-        readonly directed: Schema.optional<Schema.Boolean>;
         readonly ends: Schema.optional<Schema.Struct<{
-            readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
-            readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
+            readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+            readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+        }>>;
+        readonly text: Schema.optional<Schema.String>;
+        readonly layer: Schema.optional<Schema.String>;
+        readonly class: Schema.optional<Schema.String>;
+        readonly style: Schema.optional<Schema.Struct<{
+            /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+            hue: Schema.optional<Schema.String>;
+            /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+            lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
         }>>;
         readonly type: Schema.Literal<"line">;
     }>, Schema.Struct<{
@@ -1370,10 +1686,18 @@ export declare const OpenScene: Schema.Struct<{
                 readonly y: Schema.Number;
             }>;
         }>]>;
-        readonly directed: Schema.optional<Schema.Boolean>;
         readonly ends: Schema.optional<Schema.Struct<{
-            readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
-            readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
+            readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+            readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+        }>>;
+        readonly text: Schema.optional<Schema.String>;
+        readonly layer: Schema.optional<Schema.String>;
+        readonly class: Schema.optional<Schema.String>;
+        readonly style: Schema.optional<Schema.Struct<{
+            /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+            hue: Schema.optional<Schema.String>;
+            /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+            lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
         }>>;
         readonly type: Schema.Literal<"curve">;
     }>, Schema.Struct<{
@@ -1398,10 +1722,18 @@ export declare const OpenScene: Schema.Struct<{
                 readonly y: Schema.Number;
             }>;
         }>]>;
-        readonly directed: Schema.optional<Schema.Boolean>;
         readonly ends: Schema.optional<Schema.Struct<{
-            readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
-            readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
+            readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+            readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+        }>>;
+        readonly text: Schema.optional<Schema.String>;
+        readonly layer: Schema.optional<Schema.String>;
+        readonly class: Schema.optional<Schema.String>;
+        readonly style: Schema.optional<Schema.Struct<{
+            /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+            hue: Schema.optional<Schema.String>;
+            /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+            lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
         }>>;
         readonly type: Schema.Literal<"spline">;
         readonly points: Schema.$Array<Schema.Struct<{
@@ -1430,19 +1762,35 @@ export declare const OpenScene: Schema.Struct<{
                 readonly y: Schema.Number;
             }>;
         }>]>;
-        readonly directed: Schema.optional<Schema.Boolean>;
         readonly ends: Schema.optional<Schema.Struct<{
-            readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
-            readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle"]>>;
+            readonly start: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+            readonly end: Schema.optional<Schema.Literals<readonly ["arrow", "circle", "triangle"]>>;
+        }>>;
+        readonly text: Schema.optional<Schema.String>;
+        readonly layer: Schema.optional<Schema.String>;
+        readonly class: Schema.optional<Schema.String>;
+        readonly style: Schema.optional<Schema.Struct<{
+            /** One of the theme's hues: a link's stroke; a node's fill, text and border together. */
+            hue: Schema.optional<Schema.String>;
+            /** Solid, dashed or dotted: a link's stroke, or a node's border. */
+            lineStyle: Schema.optional<Schema.Literals<readonly ["solid", "dashed", "dotted"]>>;
         }>>;
         readonly type: Schema.Literal<"smart">;
     }>]>>;
+    readonly layers: Schema.optional<Schema.$Record<Schema.String, Schema.Struct<{
+        readonly id: Schema.String;
+        readonly name: Schema.String;
+        /** Fractional order key (see `order.ts`): the bottom layer has the least. */
+        readonly z: Schema.String;
+        readonly hidden: Schema.optional<Schema.Boolean>;
+    }>>>;
 }>;
 export type Scene = {
     readonly id: SceneId;
     readonly name?: string;
     readonly nodes: Readonly<Record<NodeId, Node>>;
     readonly links: Readonly<Record<LinkId, Link>>;
+    readonly layers?: Readonly<Record<LayerId, Layer>>;
 };
 /** A node or link of the scene by id. */
 export declare const getElement: (scene: Scene, id: ElementId) => Element | undefined;
@@ -1450,7 +1798,9 @@ export declare const getElement: (scene: Scene, id: ElementId) => Element | unde
 export type NodeValues = Partial<Omit<NodeBase, 'id' | 'type'>> & {
     readonly [key: string]: unknown;
 };
-export type LinkValues = Partial<Omit<Link, 'id' | 'type'>>;
+/** Per link type, so a spline's `points` are among the values an `update` may set. */
+type ValuesOf<T> = T extends unknown ? Partial<Omit<T, 'id' | 'type'>> : never;
+export type LinkValues = ValuesOf<Link>;
 /**
  * What the surface asks of a projection (§3). The surface never writes coordinates itself: a
  * projection may apply, rewrite or reject each intent and then re-emits the positioned scene.
@@ -1491,6 +1841,16 @@ export type Intent = {
     kind: 'layout';
     ids?: ElementId[];
 }
+/** Adds a layer, or replaces the one of its id (a rename, a visibility toggle, a move in the order). */
+ | {
+    kind: 'layer';
+    layer: Layer;
+}
+/** Removes a layer and every element on it; the last layer of a scene stays. */
+ | {
+    kind: 'removeLayer';
+    id: LayerId;
+}
 /** Several intents applied as one model change (one undo step), e.g. a paste. */
  | {
     kind: 'batch';
@@ -1517,4 +1877,5 @@ export type Tool = {
     kind: 'link';
     type: LinkType;
 };
+export {};
 //# sourceMappingURL=types.d.ts.map