@akcelik/strct 5.20.0 → 5.22.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akcelik/strct",
-  "version": "5.20.0",
+  "version": "5.22.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

@@ -4200,6 +4200,8 @@ interface StrctDatagridLabels {
      * reorders every row, a page replaces them, a filter hides most of them —
      * none of it is visible to someone who cannot see the table.
      */
+    /** The resize separator's name, per column. */
+    resizeColumn: (column: string) => string;
     /** The two empty states, and the way out of the filtered one. */
     noMatches: string;
     noMatchesFor: (query: string) => string;
@@ -4545,6 +4547,7 @@ declare class StrctDatagrid {
         quickFilter: string;
         loadMore: string;
         showing: (shown: number, total?: number) => string;
+        resizeColumn: (column: string) => string;
         noMatches: string;
         noMatchesFor: (query: string) => string;
         clearFilters: string;
@@ -4725,13 +4728,31 @@ declare class StrctDatagrid {
     private readonly selected;
     protected readonly selectedCount: _angular_core.Signal<number>;
     private readonly expandedRows;
-    private readonly columnWidths;
+    protected readonly columnWidths: _angular_core.WritableSignal<Map<string, number>>;
     protected readonly hiddenColumns: _angular_core.WritableSignal<Set<string>>;
     protected readonly chooserOpen: _angular_core.WritableSignal<boolean>;
     private resizeState;
     private readonly onMove;
     private readonly onUp;
     colWidth(key: string): string | null;
+    /**
+     * A focusable separator owes ARIA a value, and a column that has never been
+     * resized has no stored width — so the header's real width is swept after
+     * render and whenever the grid resizes. Without it every handle was an
+     * `aria-required-attr` violation (12 of them on the showcase's own page).
+     */
+    private readonly measuredWidths;
+    protected separatorValue(key: string): number | null;
+    private sweepHeaderWidths;
+    /**
+     * The keyboard half of a resize: the arrows step 16px (4px with Shift for a
+     * fine adjustment), Home gives the column back its natural width. Steps are
+     * the only way a separator can be moved without a pointer.
+     */
+    protected onResizeKey(event: KeyboardEvent, key: string): void;
+    /** Give the column back the width the content asks for. */
+    protected resetWidth(key: string): void;
+    private setColumnWidth;
     onResizeStart(e: MouseEvent, key: string): void;
     private onResizeMove;
     private onResizeEnd;
@@ -4933,6 +4954,13 @@ declare class StrctDatagrid {
     private readonly vRange;
     /** The rows actually rendered: the virtual window, or the current page. */
     protected readonly renderRows: _angular_core.Signal<StrctRow[]>;
+    /**
+     * A virtual grid draws 23 rows of 20.000 and, without these, says it has
+     * 23. The count includes the header row, as the ARIA spec asks.
+     */
+    protected readonly ariaRowCount: _angular_core.Signal<number | null>;
+    /** 1 is the header row, so data rows start at 2. */
+    protected ariaRowIndex(row: StrctRow): number | null;
     protected readonly topPad: _angular_core.Signal<number>;
     protected readonly bottomPad: _angular_core.Signal<number>;
     protected readonly stickyActive: _angular_core.Signal<boolean>;
@@ -4994,6 +5022,8 @@ declare class StrctDatagrid {
     /** Last serialized column state pushed outward (loop guard). */
     private lastStateKey;
     constructor();
+    /** Whether the saved (or bound) column state has been read yet. */
+    private stateRestored;
     private readPersistedState;
     private applyColumnState;
     /** Whether a persisted or bound state has already decided what is hidden. */
@@ -8385,6 +8415,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 = {
@@ -8466,6 +8503,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),
@@ -8473,13 +8511,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
@@ -8539,9 +8580,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;
@@ -8550,7 +8607,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. */