@printwithsynergy/artwork-pdf-editor 0.2.0 → 0.3.0

package/dist/components/BraillePanel.js

@@ -0,0 +1,221 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Wave 3 P5 — Braille layout editor.
+ *
+ * Pharmaceutical packaging in the EU is required to carry Braille
+ * matching the product name (Directive 2001/83/EC Article 56a) per
+ * the Marburg Medium dot-geometry standard (EN 15823). This panel
+ * lets the user type the source text, configure the dot geometry,
+ * and emit an ordered list of {@link BrailleCell}s the host renders
+ * as a vector layer.
+ *
+ * The transliterator covers Grade 1 English uncontracted Braille
+ * (letters A–Z, digits 0–9 with the AI 3456 prefix, common
+ * punctuation). Multi-language contracted Braille (Grade 2 English,
+ * German, French) is out of scope — hosts that need it wire their
+ * own translator (e.g. liblouis via a worker) and feed the resulting
+ * Unicode Braille string into {@link composeBraille} directly.
+ *
+ * @public
+ */
+import { useState } from "react";
+/**
+ * Marburg Medium dot-geometry defaults (EN 15823). Re-exported so
+ * server-side renderers can use the same constants for compliance
+ * checks. Values are in millimetres.
+ *
+ * @public
+ */
+export const MARBURG_MEDIUM = {
+    dotHeightMm: 0.2,
+    dotBaseDiameterMm: 1.44,
+    dotSpacingMm: 2.5,
+    cellWidthMm: 6.0,
+    charSpacingMm: 5.0,
+    lineSpacingMm: 10.0,
+};
+const LETTER_DOTS = {
+    a: [true, false, false, false, false, false],
+    b: [true, true, false, false, false, false],
+    c: [true, false, false, true, false, false],
+    d: [true, false, false, true, true, false],
+    e: [true, false, false, false, true, false],
+    f: [true, true, false, true, false, false],
+    g: [true, true, false, true, true, false],
+    h: [true, true, false, false, true, false],
+    i: [false, true, false, true, false, false],
+    j: [false, true, false, true, true, false],
+    k: [true, false, true, false, false, false],
+    l: [true, true, true, false, false, false],
+    m: [true, false, true, true, false, false],
+    n: [true, false, true, true, true, false],
+    o: [true, false, true, false, true, false],
+    p: [true, true, true, true, false, false],
+    q: [true, true, true, true, true, false],
+    r: [true, true, true, false, true, false],
+    s: [false, true, true, true, false, false],
+    t: [false, true, true, true, true, false],
+    u: [true, false, true, false, false, true],
+    v: [true, true, true, false, false, true],
+    w: [false, true, false, true, true, true],
+    x: [true, false, true, true, false, true],
+    y: [true, false, true, true, true, true],
+    z: [true, false, true, false, true, true],
+};
+// "Number indicator" prefix (dots 3-4-5-6). When the transliterator
+// emits a digit, it inserts this cell first; digits 0-9 share their
+// dot pattern with letters a-j (per the standard A=1, B=2 ... J=0).
+const NUMBER_PREFIX = [
+    false,
+    false,
+    true,
+    true,
+    true,
+    true,
+];
+const DIGIT_TO_LETTER = {
+    "1": "a",
+    "2": "b",
+    "3": "c",
+    "4": "d",
+    "5": "e",
+    "6": "f",
+    "7": "g",
+    "8": "h",
+    "9": "i",
+    "0": "j",
+};
+const PUNCT_DOTS = {
+    // Dot indices in the tuple are 1, 2, 3, 4, 5, 6 (left col top→bottom,
+    // right col top→bottom). Patterns follow Unified English Braille
+    // (UEB) and English Braille American Edition (EBAE), which agree on
+    // these punctuation symbols.
+    " ": [false, false, false, false, false, false],
+    ".": [false, true, false, false, true, true], // dots 2-5-6
+    ",": [false, true, false, false, false, false], // dot 2
+    ";": [false, true, true, false, false, false], // dots 2-3
+    ":": [false, true, false, false, true, false], // dots 2-5
+    "!": [false, true, true, false, true, false], // dots 2-3-5
+    "?": [true, false, false, true, true, true], // dots 1-4-5-6
+    "'": [false, false, true, false, false, false], // dot 3
+    "-": [false, false, true, false, false, true], // dots 3-6
+};
+function dotsToUnicode(dots) {
+    // Unicode Braille pattern codepoint = U+2800 + bitmask where bit 0
+    // is dot 1, bit 1 is dot 2, …, bit 5 is dot 6.
+    let bits = 0;
+    for (let i = 0; i < 6; i++) {
+        if (dots[i])
+            bits |= 1 << i;
+    }
+    return String.fromCodePoint(0x2800 + bits);
+}
+/**
+ * Transliterate a Grade 1 English string into placed Braille cells.
+ * The function only covers letters, digits, and a small set of
+ * common punctuation; unsupported characters are dropped and
+ * surfaced via `unsupportedChars` so the host can warn the user.
+ *
+ * Cells are laid out left-to-right at `charSpacingMm` intervals on
+ * a single line, all at `y = 0`. Multi-line layout is the host's
+ * responsibility (it can chunk the input on `\n` and translate each
+ * line separately).
+ *
+ * Pure function — exported so RSC / Astro-frontmatter callers can
+ * pre-compute placement.
+ *
+ * @public
+ */
+export function composeBraille(input) {
+    // Clamp the spacing for direct callers (RSC, host code) the same
+    // way the panel does. Zero / negative values produce overlapping
+    // or reverse-ordered cells, which is never what a host wants.
+    const charSpacing = input.charSpacingMm !== undefined && input.charSpacingMm > 0
+        ? input.charSpacingMm
+        : MARBURG_MEDIUM.charSpacingMm;
+    const cells = [];
+    const unsupportedChars = [];
+    let cursorMm = 0;
+    for (const ch of input.text) {
+        const lower = ch.toLowerCase();
+        const letterDots = LETTER_DOTS[lower];
+        if (letterDots) {
+            cells.push({
+                char: ch,
+                xMm: cursorMm,
+                yMm: 0,
+                dots: letterDots,
+            });
+            cursorMm += charSpacing;
+            continue;
+        }
+        const asLetter = DIGIT_TO_LETTER[ch];
+        if (asLetter !== undefined) {
+            const digitDots = LETTER_DOTS[asLetter];
+            if (digitDots) {
+                // Emit the number-indicator cell before each digit. A
+                // run-aware encoding would only prefix the first digit;
+                // per-digit is the conservative form and the standard
+                // accepts it.
+                cells.push({
+                    char: "#",
+                    xMm: cursorMm,
+                    yMm: 0,
+                    dots: NUMBER_PREFIX,
+                });
+                cursorMm += charSpacing;
+                cells.push({
+                    char: ch,
+                    xMm: cursorMm,
+                    yMm: 0,
+                    dots: digitDots,
+                });
+                cursorMm += charSpacing;
+                continue;
+            }
+        }
+        const punctDots = PUNCT_DOTS[ch];
+        if (punctDots) {
+            cells.push({
+                char: ch,
+                xMm: cursorMm,
+                yMm: 0,
+                dots: punctDots,
+            });
+            cursorMm += charSpacing;
+            continue;
+        }
+        unsupportedChars.push(ch);
+    }
+    const unicode = cells.map((cell) => dotsToUnicode(cell.dots)).join("");
+    return { cells, unicode, unsupportedChars };
+}
+/**
+ * Braille layout panel. The user types the source text, optionally
+ * tweaks character spacing for non-standard substrates, and clicks
+ * **Compose**; the host receives the placed cells.
+ *
+ * The panel does not render the Braille itself — preview is the
+ * host's responsibility because the dot geometry (ellipse vs.
+ * spherical dome) and the production process (foil-emboss vs. ink
+ * + spot-UV) drive how it should be visualised.
+ *
+ * @public
+ */
+export function BraillePanel({ onCompose, initialText = "", initialCharSpacingMm = MARBURG_MEDIUM.charSpacingMm, }) {
+    const [text, setText] = useState(initialText);
+    const [charSpacingMm, setCharSpacingMm] = useState(initialCharSpacingMm);
+    const [lastResult, setLastResult] = useState(null);
+    function handleCompose() {
+        const result = composeBraille({ text, charSpacingMm });
+        setLastResult(result);
+        onCompose(result);
+    }
+    return (_jsxs("div", { "data-testid": "braille-panel", style: { padding: "0.5rem", maxWidth: "24em" }, children: [_jsx("h3", { style: { margin: "0 0 0.5rem 0" }, children: "Braille (Marburg Medium)" }), _jsxs("label", { style: { display: "block", marginBottom: "0.5rem" }, children: ["Source text", _jsx("input", { type: "text", value: text, onChange: (e) => setText(e.target.value), "aria-label": "Braille source text", style: { marginLeft: "0.5rem", width: "16em" } })] }), _jsxs("label", { style: { display: "block", marginBottom: "0.5rem" }, children: ["Character spacing (mm)", _jsx("input", { type: "number", min: "0", step: "0.1", value: charSpacingMm, onChange: (e) => {
+                            const v = Number(e.target.value);
+                            setCharSpacingMm(Number.isNaN(v) || v <= 0 ? MARBURG_MEDIUM.charSpacingMm : v);
+                        }, "aria-label": "Character spacing in millimetres", style: { marginLeft: "0.5rem", width: "5em" } })] }), _jsx("button", { type: "button", onClick: handleCompose, style: { padding: "0.4rem 0.8rem" }, children: "Compose" }), lastResult && (_jsxs("div", { style: { marginTop: "0.5rem" }, children: [_jsx("div", { style: { fontFamily: "monospace", fontSize: "1.4em" }, children: lastResult.unicode }), lastResult.unsupportedChars.length > 0 && (_jsxs("div", { role: "alert", style: { marginTop: "0.25rem", color: "#a00", fontSize: "0.8em" }, children: ["Skipped characters: ", lastResult.unsupportedChars.join(" ")] }))] }))] }));
+}
+//# sourceMappingURL=BraillePanel.js.map

package/dist/components/BraillePanel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BraillePanel.js","sourceRoot":"","sources":["../../src/components/BraillePanel.tsx"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,YAAY,CAAC;;AAEb;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEjC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,WAAW,EAAE,GAAG;IAChB,iBAAiB,EAAE,IAAI;IACvB,YAAY,EAAE,GAAG;IACjB,WAAW,EAAE,GAAG;IAChB,aAAa,EAAE,GAAG;IAClB,aAAa,EAAE,IAAI;CACX,CAAC;AAuCX,MAAM,WAAW,GAA2E;IAC1F,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IAC5C,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IAC3C,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC;IAC3C,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC;IAC1C,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC;IAC3C,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC;IAC1C,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC;IACzC,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC;IAC1C,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC;IAC3C,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC;IAC1C,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IAC3C,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IAC1C,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC;IAC1C,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC;IACzC,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC;IAC1C,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC;IACzC,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC;IACxC,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC;IACzC,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC;IAC1C,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC;IACzC,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC;IAC1C,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC;IACzC,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;IACzC,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC;IACzC,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;IACxC,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,I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"}

package/dist/components/BrandAssetsPanel.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Wave 4 B1 — Brand-assets registry panel.
+ *
+ * Surfaces the document's brand-asset registry
+ * (`DocumentV3.brandAssets`) as a browsable list grouped by kind:
+ * logo, swatch, typography, graphic-style, other. Hosts get a
+ * controlled read-only view; mutation (add / remove / re-hash)
+ * happens elsewhere — typically in a host-side asset-cache UI that
+ * writes back into the document.
+ *
+ * Pairs with Wave 4 B2's brand-consistency rule (lint-pdf side): the
+ * rule consults this same registry, so what the user sees in the
+ * panel is what the rule will check against. The panel is the human
+ * surface; B2 is the machine one.
+ *
+ * @public
+ */
+import type { ReactElement } from "react";
+/**
+ * One brand asset. Structurally compatible with `BrandAssetRef` from
+ * `@artworkpdf/document-model` — duplicated here so the editor stays
+ * consumable without the document-model SDK (same pattern as
+ * `ComplianceFinding`, `PreflightFinding`, etc.).
+ *
+ * `hash` is the content sha256 the host's asset cache uses as its
+ * primary key. `sourceUrl` is optional and only set when the asset
+ * originally came from an external CDN — local-only assets omit it.
+ *
+ * @public
+ */
+export type BrandAsset = {
+    id: string;
+    hash: string;
+    name: string;
+    kind: BrandAssetKind;
+    mimeType?: string;
+    sourceUrl?: string;
+};
+/**
+ * The discriminator on which the panel groups assets and which the
+ * B2 consistency rule pivots on. `"other"` is the escape hatch for
+ * tenant-specific kinds that don't map to the four canonical buckets.
+ *
+ * @public
+ */
+export type BrandAssetKind = "logo" | "swatch" | "typography" | "graphic-style" | "other";
+/**
+ * Canonical order brand-asset kinds render in. The order matches the
+ * mental hierarchy a brand lead expects: identity (logo), color, type,
+ * generic-style, miscellaneous. Hosts that want a different order can
+ * read the assets list straight from `DocumentV3.brandAssets` and
+ * drive their own renderer over {@link filterBrandAssets}.
+ *
+ * @public
+ */
+export declare const BRAND_ASSET_KIND_ORDER: readonly BrandAssetKind[];
+/**
+ * Result row from {@link groupBrandAssetsByKind}.
+ *
+ * @public
+ */
+export type BrandAssetGroup = {
+    kind: BrandAssetKind;
+    assets: readonly BrandAsset[];
+};
+/**
+ * Filter spec accepted by {@link filterBrandAssets}.
+ *
+ * @public
+ */
+export type BrandAssetFilter = {
+    /** Match assets whose `kind` field equals this value. Absent → no
+     *  kind filter. */
+    kind?: BrandAssetKind;
+    /** Case-insensitive substring filter on `name`. Whitespace-only
+     *  strings are treated as absent so a stray space in the search
+     *  input doesn't blank the list. */
+    query?: string;
+};
+/**
+ * @public
+ */
+export type BrandAssetsPanelProps = {
+    /** The full brand-asset registry. Typically
+     *  `DocumentV3.brandAssets ?? []`. Empty array → "no assets
+     *  registered" empty state. */
+    assets: readonly BrandAsset[];
+    /** Optional kind to pre-filter the panel to. Distinct from the
+     *  in-panel filter chips — hosts wire this to a deep-link route
+     *  ("?brand-kind=logo") so reloading the page lands in the same
+     *  bucket. */
+    filterKind?: BrandAssetKind;
+    /** Optional callback fired when an asset row is clicked. Hosts
+     *  typically wire this to a side panel that shows the asset's
+     *  preview + hash + reference count. */
+    onSelect?: (asset: BrandAsset) => void;
+};
+/**
+ * Group assets by kind in {@link BRAND_ASSET_KIND_ORDER}. Returns a
+ * stable five-bucket shape (one entry per canonical kind, even when
+ * empty) so renderers can iterate without worrying about absent keys.
+ *
+ * Pure function — no React, no DOM.
+ *
+ * @public
+ */
+export declare function groupBrandAssetsByKind(assets: readonly BrandAsset[]): readonly BrandAssetGroup[];
+/**
+ * Filter assets by kind / name substring. Returns a new array;
+ * preserves input order. Pure function.
+ *
+ * @public
+ */
+export declare function filterBrandAssets(assets: readonly BrandAsset[], filter: BrandAssetFilter): readonly BrandAsset[];
+/**
+ * Read-only browser for `DocumentV3.brandAssets` grouped by kind.
+ *
+ * Renders the registry as a count header plus one section per kind in
+ * {@link BRAND_ASSET_KIND_ORDER}. When `filterKind` is set, only that
+ * bucket's assets are visible; the panel surfaces a distinct
+ * "no {kind} assets in this document" message when the filter
+ * matches nothing (vs the registry-is-empty message). Hosts opt in
+ * to row interaction by passing `onSelect` — otherwise rows render
+ * as static content so screen readers don't announce non-functional
+ * buttons.
+ *
+ * @public
+ */
+export declare function BrandAssetsPanel({ assets, filterKind, onSelect, }: BrandAssetsPanelProps): ReactElement;
+//# sourceMappingURL=BrandAssetsPanel.d.ts.map

package/dist/components/BrandAssetsPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrandAssetsPanel.d.ts","sourceRoot":"","sources":["../../src/components/BrandAssetsPanel.tsx"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAG1C;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,cAAc,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,YAAY,GAAG,eAAe,GAAG,OAAO,CAAC;AAE1F;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,cAAc,EAM3D,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,SAAS,UAAU,EAAE,CAAC;CAC/B,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B;uBACmB;IACnB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB;;wCAEoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC;;mCAE+B;IAC/B,MAAM,EAAE,SAAS,UAAU,EAAE,CAAC;IAC9B;;;kBAGc;IACd,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B;;4CAEwC;IACxC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;CACxC,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,GAAG,SAAS,eAAe,EAAE,CAchG;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,UAAU,EAAE,EAC7B,MAAM,EAAE,gBAAgB,GACvB,SAAS,UAAU,EAAE,CAOvB;AAUD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,MAAM,EACN,UAAU,EACV,QAAQ,GACT,EAAE,qBAAqB,GAAG,YAAY,CAyDtC"}

package/dist/components/BrandAssetsPanel.js

@@ -0,0 +1,125 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useMemo } from "react";
+/**
+ * Canonical order brand-asset kinds render in. The order matches the
+ * mental hierarchy a brand lead expects: identity (logo), color, type,
+ * generic-style, miscellaneous. Hosts that want a different order can
+ * read the assets list straight from `DocumentV3.brandAssets` and
+ * drive their own renderer over {@link filterBrandAssets}.
+ *
+ * @public
+ */
+export const BRAND_ASSET_KIND_ORDER = [
+    "logo",
+    "swatch",
+    "typography",
+    "graphic-style",
+    "other",
+];
+/**
+ * Group assets by kind in {@link BRAND_ASSET_KIND_ORDER}. Returns a
+ * stable five-bucket shape (one entry per canonical kind, even when
+ * empty) so renderers can iterate without worrying about absent keys.
+ *
+ * Pure function — no React, no DOM.
+ *
+ * @public
+ */
+export function groupBrandAssetsByKind(assets) {
+    const buckets = new Map(BRAND_ASSET_KIND_ORDER.map((k) => [k, []]));
+    for (const a of assets) {
+        // Defensive: TS makes `kind` a strict union, but runtime data
+        // (a JSON load from an external source, a forward-compat extension
+        // in the registry) could carry kinds we don't know about. Drop
+        // such entries into "other" rather than silently losing them.
+        const bucket = buckets.get(a.kind) ?? buckets.get("other");
+        bucket?.push(a);
+    }
+    return BRAND_ASSET_KIND_ORDER.map((kind) => ({
+        kind,
+        assets: buckets.get(kind) ?? [],
+    }));
+}
+/**
+ * Filter assets by kind / name substring. Returns a new array;
+ * preserves input order. Pure function.
+ *
+ * @public
+ */
+export function filterBrandAssets(assets, filter) {
+    const trimmedQuery = filter.query?.trim().toLowerCase() ?? "";
+    return assets.filter((a) => {
+        if (filter.kind && a.kind !== filter.kind)
+            return false;
+        if (trimmedQuery && !a.name.toLowerCase().includes(trimmedQuery))
+            return false;
+        return true;
+    });
+}
+const KIND_LABELS = {
+    logo: "Logos",
+    swatch: "Swatches",
+    typography: "Typography",
+    "graphic-style": "Graphic styles",
+    other: "Other",
+};
+/**
+ * Read-only browser for `DocumentV3.brandAssets` grouped by kind.
+ *
+ * Renders the registry as a count header plus one section per kind in
+ * {@link BRAND_ASSET_KIND_ORDER}. When `filterKind` is set, only that
+ * bucket's assets are visible; the panel surfaces a distinct
+ * "no {kind} assets in this document" message when the filter
+ * matches nothing (vs the registry-is-empty message). Hosts opt in
+ * to row interaction by passing `onSelect` — otherwise rows render
+ * as static content so screen readers don't announce non-functional
+ * buttons.
+ *
+ * @public
+ */
+export function BrandAssetsPanel({ assets, filterKind, onSelect, }) {
+    const visibleAssets = useMemo(() => (filterKind ? filterBrandAssets(assets, { kind: filterKind }) : assets), [assets, filterKind]);
+    const groups = useMemo(() => groupBrandAssetsByKind(visibleAssets), [visibleAssets]);
+    if (assets.length === 0) {
+        return (_jsx("div", { "data-testid": "brand-assets-panel", style: { padding: "0.5rem", opacity: 0.6 }, children: "No brand assets registered for this document." }));
+    }
+    return (_jsxs("div", { "data-testid": "brand-assets-panel", style: { padding: "0.5rem" }, children: [_jsxs("h3", { style: { margin: "0 0 0.5rem 0", fontSize: "0.875rem" }, children: ["Brand assets (", visibleAssets.length, ")"] }), visibleAssets.length === 0 && filterKind && (_jsxs("div", { "data-testid": "brand-assets-panel-empty-filter", style: { opacity: 0.6, fontSize: "0.875rem" }, children: ["No ", filterKind, " assets in this document."] })), groups.map((group) => {
+                if (group.assets.length === 0)
+                    return null;
+                return (_jsxs("section", { "data-testid": `brand-assets-group-${group.kind}`, style: { marginBottom: "0.75rem" }, children: [_jsxs("h4", { style: {
+                                margin: "0 0 0.25rem 0",
+                                fontSize: "0.75rem",
+                                color: "#666",
+                                textTransform: "uppercase",
+                                letterSpacing: "0.05em",
+                            }, children: [KIND_LABELS[group.kind], " (", group.assets.length, ")"] }), _jsx("ul", { style: { listStyle: "none", padding: 0, margin: 0 }, children: group.assets.map((asset) => (_jsx(BrandAssetRow, { asset: asset, onSelect: onSelect }, asset.id))) })] }, group.kind));
+            })] }));
+}
+/**
+ * Renders one asset row inside a kind section. The row is a `<button>`
+ * when the host wired `onSelect` (announces interactivity to screen
+ * readers) and a plain `<div>` otherwise so static rows aren't read
+ * as clickable controls that do nothing.
+ *
+ * Intra-package helper — not exported.
+ */
+function BrandAssetRow({ asset, onSelect, }) {
+    const rowStyle = {
+        display: "flex",
+        alignItems: "baseline",
+        gap: "0.5rem",
+        width: "100%",
+        padding: "0.25rem 0.5rem",
+    };
+    const rowContents = (_jsxs(_Fragment, { children: [_jsx("span", { style: { flex: 1 }, children: asset.name }), _jsx("small", { "data-testid": `brand-asset-hash-${asset.id}`, style: { opacity: 0.6, fontFamily: "monospace" }, title: asset.hash, children: asset.hash.slice(0, 8) })] }));
+    return (_jsx("li", { children: onSelect ? (_jsx("button", { type: "button", onClick: () => onSelect(asset), "aria-label": `Brand asset: ${asset.name} (${asset.kind})`, style: {
+                ...rowStyle,
+                background: "transparent",
+                border: "none",
+                cursor: "pointer",
+                textAlign: "left",
+            }, children: rowContents })) : (_jsx("div", { style: rowStyle, children: rowContents })) }));
+}
+//# sourceMappingURL=BrandAssetsPanel.js.map

package/dist/components/BrandAssetsPanel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrandAssetsPanel.js","sourceRoot":"","sources":["../../src/components/BrandAssetsPanel.tsx"],"names":[],"mappings":"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"}

package/dist/components/BrandConsistencyPanel.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Wave 4 B2 — Brand-consistency findings panel.
+ *
+ * Companion to the B1 {@link BrandAssetsPanel} (Wave 4 PR-5). The
+ * brand-assets panel lists the registry the designer is supposed to
+ * pull from; this one surfaces a host-loader-supplied list of
+ * violations against that registry — logo placed too small, fill
+ * color outside the swatches set, typography pairing off the brand
+ * kit, etc.
+ *
+ * Findings reference a `brandAssetId` so the host can jump to the
+ * matching asset in the registry / focus the offending object on the
+ * canvas. The loader is the same shape as the rest of the Wave 4
+ * panel family: one call per mount resolves the full finding set.
+ *
+ * Pairs with lint-pdf's brand-consistency profile when one is
+ * deployed (cross-repo, deferred); hosts running purely client-side
+ * heuristics can wire a local loader in the meantime.
+ *
+ * @public
+ */
+import type { ReactElement } from "react";
+import type { BrandAssetKind } from "./BrandAssetsPanel";
+/**
+ * Severity of a brand-consistency finding. Mirrors lint-pdf's three
+ * tiers so the two systems agree on the wire shape.
+ *
+ * @public
+ */
+export type BrandConsistencySeverity = "error" | "warn" | "info";
+/**
+ * One brand-consistency finding. `brandAssetId` is the foreign key
+ * into the host's brand-asset registry (the same id surfaced by the
+ * B1 {@link BrandAssetsPanel}); `assetKind` is duplicated for fast
+ * grouping without a lookup. The optional `objectId` lets the host
+ * focus the violating canvas object.
+ *
+ * @public
+ */
+export type BrandConsistencyFinding = {
+    /** Stable identifier — the panel uses it as the React key and
+     *  exposes it through `onSelect`. */
+    id: string;
+    /** Foreign key into the host's brand-asset registry. */
+    brandAssetId: string;
+    /** Duplicated from the asset for fast grouping; saves a registry
+     *  lookup per row. */
+    assetKind: BrandAssetKind;
+    severity: BrandConsistencySeverity;
+    summary: string;
+    description?: string;
+    /** Optional id of the canvas object that violates the rule. Hosts
+     *  wire this to a focus / scroll-into-view affordance. */
+    objectId?: string;
+};
+/**
+ * Host adapter — resolves the full finding list for the active
+ * document. Rejects on transport / validation errors and the panel
+ * surfaces the message inline. Hosts should memoize the function
+ * with `useCallback` so an unrelated parent re-render doesn't
+ * trigger a spurious refetch.
+ *
+ * @public
+ */
+export type BrandConsistencyLoaderFn = () => Promise<readonly BrandConsistencyFinding[]>;
+/**
+ * Filter spec accepted by {@link filterBrandConsistencyFindings}.
+ *
+ * @public
+ */
+export type BrandConsistencyFilter = {
+    /** Pre-filter to a single severity. Absent → all severities. */
+    severity?: BrandConsistencySeverity;
+    /** Pre-filter to a single asset kind. Absent → all kinds. */
+    assetKind?: BrandAssetKind;
+};
+/**
+ * Result row from {@link groupBrandConsistencyFindingsBySeverity}.
+ *
+ * @public
+ */
+export type BrandConsistencyGroup = {
+    severity: BrandConsistencySeverity;
+    findings: readonly BrandConsistencyFinding[];
+};
+/**
+ * Canonical severity order — errors first so press-blocking issues
+ * surface at the top.
+ *
+ * @public
+ */
+export declare const BRAND_CONSISTENCY_SEVERITY_ORDER: readonly BrandConsistencySeverity[];
+/**
+ * Pure helper — filters findings by severity / asset kind. Returns a
+ * new array; preserves input order. Pure function.
+ *
+ * @public
+ */
+export declare function filterBrandConsistencyFindings(findings: readonly BrandConsistencyFinding[], filter: BrandConsistencyFilter): readonly BrandConsistencyFinding[];
+/**
+ * Pure helper — groups findings by severity in
+ * {@link BRAND_CONSISTENCY_SEVERITY_ORDER}. Returns a stable
+ * three-bucket shape so renderers iterate without absent-key checks.
+ *
+ * Pure function.
+ *
+ * @public
+ */
+export declare function groupBrandConsistencyFindingsBySeverity(findings: readonly BrandConsistencyFinding[]): readonly BrandConsistencyGroup[];
+/**
+ * Configuration for the {@link BrandConsistencyPanel}. The host
+ * always supplies the {@link BrandConsistencyLoaderFn}; the optional
+ * `onSelect` callback lets the host wire a focus affordance (jump to
+ * the violating object on the canvas, scroll the brand-assets panel
+ * to the matching registry entry, etc.).
+ *
+ * @public
+ */
+export type BrandConsistencyPanelProps = {
+    loader: BrandConsistencyLoaderFn;
+    /** Optional severity pre-filter applied before grouping. */
+    filterSeverity?: BrandConsistencySeverity;
+    /** Optional asset-kind pre-filter applied before grouping. */
+    filterAssetKind?: BrandAssetKind;
+    /** Id of the currently active finding — the matching row renders
+     *  in the "active" style. Hosts wire this to whichever surface
+     *  drives selection. */
+    activeFindingId?: string;
+    /** Fired when the user clicks a row. */
+    onSelect?: (finding: BrandConsistencyFinding) => void;
+};
+/**
+ * Stateful panel — loads the finding stream on mount, surfaces the
+ * filtered + grouped list, and emits `onSelect` on row click.
+ * Handles loading / error / empty states inline.
+ *
+ * @public
+ */
+export declare function BrandConsistencyPanel({ loader, filterSeverity, filterAssetKind, activeFindingId, onSelect, }: BrandConsistencyPanelProps): ReactElement;
+//# sourceMappingURL=BrandConsistencyPanel.d.ts.map

package/dist/components/BrandConsistencyPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrandConsistencyPanel.d.ts","sourceRoot":"","sources":["../../src/components/BrandConsistencyPanel.tsx"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAE1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,MAAM,wBAAwB,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEjE;;;;;;;;GAQG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC;yCACqC;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC;IACrB;0BACsB;IACtB,SAAS,EAAE,cAAc,CAAC;IAC1B,QAAQ,EAAE,wBAAwB,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;8DAC0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,wBAAwB,GAAG,MAAM,OAAO,CAAC,SAAS,uBAAuB,EAAE,CAAC,CAAC;AAEzF;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,gEAAgE;IAChE,QAAQ,CAAC,EAAE,wBAAwB,CAAC;IACpC,6DAA6D;IAC7D,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,wBAAwB,CAAC;IACnC,QAAQ,EAAE,SAAS,uBAAuB,EAAE,CAAC;CAC9C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,EAAE,SAAS,wBAAwB,EAI/E,CAAC;AAcF;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,SAAS,uBAAuB,EAAE,EAC5C,MAAM,EAAE,sBAAsB,GAC7B,SAAS,uBAAuB,EAAE,CAMpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,uCAAuC,CACrD,QAAQ,EAAE,SAAS,uBAAuB,EAAE,GAC3C,SAAS,qBAAqB,EAAE,CAWlC;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,MAAM,EAAE,wBAAwB,CAAC;IACjC,4DAA4D;IAC5D,cAAc,CAAC,EAAE,wBAAwB,CAAC;IAC1C,8DAA8D;IAC9D,eAAe,CAAC,EAAE,cAAc,CAAC;IACjC;;4BAEwB;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,IAAI,CAAC;CACvD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,MAAM,EACN,cAAc,EACd,eAAe,EACf,eAAe,EACf,QAAQ,GACT,EAAE,0BAA0B,GAAG,YAAY,CA8G3C"}