@akcelik/strct 5.21.0 → 5.23.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akcelik/strct",
-  "version": "5.21.0",
+  "version": "5.23.0",
   "description": "UIStruct — a standalone Angular component library with a tokenised, multi-palette theme system, built for datacenter / infrastructure management UIs.",
   "author": "Serkan Akcelik <serkan.akcelik@gmail.com>",
   "license": "MIT",

package/types/akcelik-strct.d.ts

@@ -1579,6 +1579,25 @@ interface StrctTreeNodeData {
     /** Initial expanded state. */
     expanded?: boolean;
     children?: StrctTreeNodeData[];
+    /**
+     * A quiet trailing word on the row — what `[strctTreeTrailing]` is for a
+     * projected node: "VM" on a virtual machine's own folder.
+     */
+    meta?: string;
+    /** A trailing tag instead of (or beside) `meta`. */
+    tag?: {
+        label: string;
+        status?: StrctBadgeStatus;
+    };
+    /**
+     * "It has children, they have not been read yet": the chevron and
+     * `aria-expanded` appear before `children` arrives, and expanding emits
+     * `(nodeToggled)` as usual. A node that turns out to be empty loses its
+     * chevron when `children` arrives as `[]`.
+     */
+    hasChildren?: boolean;
+    /** Its children are being read: a quiet row under it, and `aria-busy`. */
+    loading?: boolean;
     /** Arbitrary payload returned with (nodeActivated). */
     data?: unknown;
 }
@@ -1680,6 +1699,8 @@ declare class StrctTreeNode {
     rowEl(): HTMLElement | null;
     /** Roving tabindex: inside a tree only the active row is tabbable. */
     protected readonly rowTabindex: _angular_core.Signal<0 | -1>;
+    /** Wording of the "children are being read" row (from the owning tree). */
+    protected readonly loadingLabel: _angular_core.Signal<string>;
     /** Accessible label of the chevron toggle (factory from the owning tree). */
     protected readonly chevronAriaLabel: _angular_core.Signal<string>;
     protected onRowFocus(): void;
@@ -1732,6 +1753,8 @@ declare class StrctTree {
     readonly dragExpandDelay: _angular_core.InputSignal<number>;
     /** Emitted for an accepted drop only. */
     readonly nodeDrop: _angular_core.OutputEmitterRef<StrctTreeDropEvent>;
+    /** Wording of the row shown under a node whose children are being read (`node.loading`). */
+    readonly loadingLabel: _angular_core.InputSignal<string>;
     /** Accessible label of each node's chevron toggle; receives the expanded state and the node label. */
     readonly chevronAriaLabel: _angular_core.InputSignal<(expanded: boolean, label: string) => string>;
     /** Emitted when any data-driven node is clicked. */
@@ -1829,7 +1852,7 @@ declare class StrctTree {
     /** Toggle a node's expansion, updating state and emitting outputs. */
     toggleNode(node: StrctTreeNodeData): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctTree, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctTree, "strct-tree", never, { "nodes": { "alias": "nodes"; "required": false; "isSignal": true; }; "density": { "alias": "density"; "required": false; "isSignal": true; }; "framed": { "alias": "framed"; "required": false; "isSignal": true; }; "maxHeight": { "alias": "maxHeight"; "required": false; "isSignal": true; }; "nodeMenu": { "alias": "nodeMenu"; "required": false; "isSignal": true; }; "canDrag": { "alias": "canDrag"; "required": false; "isSignal": true; }; "canDrop": { "alias": "canDrop"; "required": false; "isSignal": true; }; "dragExpandDelay": { "alias": "dragExpandDelay"; "required": false; "isSignal": true; }; "chevronAriaLabel": { "alias": "chevronAriaLabel"; "required": false; "isSignal": true; }; "expandedIds": { "alias": "expandedIds"; "required": false; "isSignal": true; }; }, { "nodeDrop": "nodeDrop"; "nodeActivated": "nodeActivated"; "nodeMenuSelect": "nodeMenuSelect"; "expandedIds": "expandedIdsChange"; "expandedChange": "expandedChange"; "nodeToggled": "nodeToggled"; }, ["projectedNodes"], ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctTree, "strct-tree", never, { "nodes": { "alias": "nodes"; "required": false; "isSignal": true; }; "density": { "alias": "density"; "required": false; "isSignal": true; }; "framed": { "alias": "framed"; "required": false; "isSignal": true; }; "maxHeight": { "alias": "maxHeight"; "required": false; "isSignal": true; }; "nodeMenu": { "alias": "nodeMenu"; "required": false; "isSignal": true; }; "canDrag": { "alias": "canDrag"; "required": false; "isSignal": true; }; "canDrop": { "alias": "canDrop"; "required": false; "isSignal": true; }; "dragExpandDelay": { "alias": "dragExpandDelay"; "required": false; "isSignal": true; }; "loadingLabel": { "alias": "loadingLabel"; "required": false; "isSignal": true; }; "chevronAriaLabel": { "alias": "chevronAriaLabel"; "required": false; "isSignal": true; }; "expandedIds": { "alias": "expandedIds"; "required": false; "isSignal": true; }; }, { "nodeDrop": "nodeDrop"; "nodeActivated": "nodeActivated"; "nodeMenuSelect": "nodeMenuSelect"; "expandedIds": "expandedIdsChange"; "expandedChange": "expandedChange"; "nodeToggled": "nodeToggled"; }, ["projectedNodes"], ["*"], true, never>;
 }
 
 /** Fixed modal width presets: sm 480 · md 640 · lg 860 · xl 1080 (px). */
@@ -2711,6 +2734,11 @@ declare class StrctSearchbox implements ControlValueAccessor {
     protected onTouched: () => void;
     protected onInput(event: Event): void;
     /** Clear the text (Escape / the × button). */
+    /**
+     * An Escape that clears a value is used: a modal around this box takes an
+     * unhandled Escape as "close me", and the same keystroke did both.
+     */
+    protected onEscape(event: Event): void;
     clear(): void;
     /** Focus the input programmatically (e.g. from a global shortcut). */
     focus(): void;
@@ -8415,6 +8443,13 @@ declare const STRCT_MD_LIMITS: {
     readonly depth: 8;
     /** Inline delimiter runs considered per text span. */
     readonly delimiters: 2000;
+    /**
+     * How far a closing delimiter or bracket is looked for. Without it every
+     * unmatched opener scanned to the end of the document, once each: a 64 KiB
+     * line of "*a " took 1.6 s to read, and a streamed reply is read again on
+     * every token.
+     */
+    readonly scan: 4096;
 };
 type StrctMdAlign = 'start' | 'center' | 'end' | null;
 type StrctMdInline = {
@@ -8496,6 +8531,7 @@ type StrctMdTokenizer = (text: string) => StrctMdToken[];
 declare function strctParseMarkdown(source: string, options?: {
     streaming?: boolean;
     tokenize?: StrctMdTokenizer;
+    breaks?: boolean;
 }): StrctMdBlock[];
 /**
  * Inline reading. Code spans win over everything (their content is literal),
@@ -8503,13 +8539,16 @@ declare function strctParseMarkdown(source: string, options?: {
  */
 declare function parseInlines(source: string, options?: {
     tokenize?: StrctMdTokenizer;
+    breaks?: boolean;
 }): StrctMdInline[];
 /**
  * What a link may do. Anything that is not plainly safe stays the text the
  * model wrote: `javascript:`, `data:`, a protocol-relative `//host`, or
  * anything this does not recognise.
  */
-declare function strctClassifyHref(href: string): 'external' | 'internal' | null;
+declare function strctClassifyHref(href: string, options?: {
+    mailto?: boolean;
+}): 'external' | 'internal' | null;
 
 /**
  * A template for a span the consumer claimed through `tokens`, keyed by the
@@ -8569,9 +8608,25 @@ declare class StrctMarkdown {
     readonly linkPolicy: _angular_core.InputSignal<((href: string) => "external" | "internal" | null) | null>;
     /** Claim runs of plain text — an inventory id becomes an object chip. */
     readonly tokens: _angular_core.InputSignal<StrctMdTokenizer | null>;
+    /**
+     * A single newline is a line break, the way a comment box reads: a model
+     * writing "Host: X\nCPU: 40 %" means two lines. Off by default, which is
+     * CommonMark.
+     */
+    readonly breaks: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** What a screen reader hears after an external link (localisable). */
+    readonly newTabLabel: _angular_core.InputSignal<string>;
+    /**
+     * The token templates of the view that nested this one. A list item or a
+     * quote is drawn by a nested view, which has no projected content of its
+     * own — without this its claimed runs fall back to plain text.
+     */
+    readonly inheritedTokens: _angular_core.InputSignal<readonly StrctMarkdownToken[]>;
     /** An in-app link was followed; the consumer routes it. */
     readonly navigate: _angular_core.OutputEmitterRef<string>;
-    private readonly tokenDefs;
+    private readonly ownTokenDefs;
+    /** This view's own templates, plus the ones handed down to it. */
+    protected readonly allTokenDefs: _angular_core.Signal<readonly StrctMarkdownToken[]>;
     protected readonly blocks: _angular_core.Signal<StrctMdBlock[]>;
     protected level(level: number): number;
     protected hrefKind(href: string): 'external' | 'internal' | null;
@@ -8580,7 +8635,7 @@ declare class StrctMarkdown {
     protected caretOn(index: number): boolean;
     protected onInternal(event: Event, href: string): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctMarkdown, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctMarkdown, "strct-markdown", never, { "source": { "alias": "source"; "required": false; "isSignal": true; }; "tree": { "alias": "tree"; "required": false; "isSignal": true; }; "streaming": { "alias": "streaming"; "required": false; "isSignal": true; }; "headingOffset": { "alias": "headingOffset"; "required": false; "isSignal": true; }; "linkPolicy": { "alias": "linkPolicy"; "required": false; "isSignal": true; }; "tokens": { "alias": "tokens"; "required": false; "isSignal": true; }; }, { "navigate": "navigate"; }, ["tokenDefs"], never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctMarkdown, "strct-markdown", never, { "source": { "alias": "source"; "required": false; "isSignal": true; }; "tree": { "alias": "tree"; "required": false; "isSignal": true; }; "streaming": { "alias": "streaming"; "required": false; "isSignal": true; }; "headingOffset": { "alias": "headingOffset"; "required": false; "isSignal": true; }; "linkPolicy": { "alias": "linkPolicy"; "required": false; "isSignal": true; }; "tokens": { "alias": "tokens"; "required": false; "isSignal": true; }; "breaks": { "alias": "breaks"; "required": false; "isSignal": true; }; "newTabLabel": { "alias": "newTabLabel"; "required": false; "isSignal": true; }; "inheritedTokens": { "alias": "inheritedTokens"; "required": false; "isSignal": true; }; }, { "navigate": "navigate"; }, ["ownTokenDefs"], never, true, never>;
 }
 
 /** One product (or platform) a person may switch to. */
@@ -8603,8 +8658,15 @@ interface StrctProductItem {
     description?: string;
     /** The dot beside that line. */
     status?: StrctStatus;
-    /** The product's own colour (a token or value): the icons take it. */
+    /** The product's own colour (a token or value): the row's icon takes it. */
     tone?: string;
+    /**
+     * The chip's own shade. The chip sits on `--hdr`, which is dark in every
+     * scheme, and the menu rows on `--bg-1`: one colour measured 2.45–2.93 : 1
+     * on one of the two, under the 3 : 1 a graphical object owes. Falls back to
+     * `tone`.
+     */
+    headerTone?: string;
     /** Render the row as a real router link (middle-click, a new tab). */
     routerLink?: string | unknown[];
     /** Render the row as a plain link. */