@lax-wp/editor 0.4.13 → 0.4.15-beta.0

package/dist/utils/cdts.d.ts

@@ -0,0 +1,37 @@
+/**
+ * CDTS (Category / Domain / Type / Subtype) coordinate helpers — REQ-D3.
+ *
+ * Pure functions only. The prefix test is DISPLAY-ONLY (the "active" chip);
+ * authorization and evaluation walk-up are server-authoritative.
+ */
+/** A CDTS coordinate. Empty/absent fields wildcard everything deeper. */
+export interface CdtsScope {
+    category?: string;
+    domain?: string;
+    type?: string;
+    subtype?: string;
+}
+/**
+ * Non-empty CDTS segments in order, stopping at the first empty field —
+ * matches the backend's Depth() semantics (a wildcarded parent with a set
+ * child counts as the parent's depth).
+ */
+export declare const scopeSegments: (scope: CdtsScope) => string[];
+/** Depth 0 = global, 4 = fully specified. */
+export declare const scopeDepth: (scope: CdtsScope) => number;
+/** Human-readable coordinate, e.g. "Gov › Services › MSA › IT-Services". */
+export declare const formatScope: (scope: CdtsScope, separator?: string) => string;
+/**
+ * True when `playbookScope` sits on the document's walk-up chain — i.e. its
+ * segments are a (possibly empty, possibly exact) prefix of the document's.
+ * A root-level (global) playbook matches every document.
+ */
+export declare const isOnChain: (playbookScope: CdtsScope, docScope: CdtsScope) => boolean;
+/**
+ * The document's CDTS walk-up chain, most-specific first, ending at the
+ * global root — the order rule groups render in (REQ-P3) and the order the
+ * evaluator applies playbooks in.
+ */
+export declare const chainFor: (docScope: CdtsScope) => CdtsScope[];
+/** Serialized form for the `?cdts=` query param: segments joined with "/". */
+export declare const serializeScope: (scope: CdtsScope) => string;

package/dist/utils/groundingAdapter.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Grounding adapter — REQ-D4.
+ *
+ * A thin, read-only, memoized pure function over the review response the
+ * existing redline flow already holds. Parses the `grounding[]` sidecar
+ * (REDLINE_WIRE_FORMAT.md §5 Channel 2) and indexes fired counts by rule_id.
+ * No suggestion-store rebuild in Phase 1; a reload before a re-run yields
+ * null counts, which render as "—" (REQ-R2).
+ */
+/** One entry of the `grounding[]` sidecar (Channel 2). */
+export interface GroundingRecord {
+    node_path?: unknown;
+    redline_user_id?: unknown;
+    redline_timestamp?: unknown;
+    rule_id?: unknown;
+    [key: string]: unknown;
+}
+/** Anything shaped like the orchestrator's review response. */
+export interface ReviewResponseLike {
+    grounding?: unknown;
+    [key: string]: unknown;
+}
+/**
+ * Count grounding entries per rule_id. Pure and defensive:
+ * - absent / empty / non-array `grounding` → empty map;
+ * - entries without a string rule_id are skipped;
+ * - unknown rule_ids are counted anyway (consumers simply won't look them up);
+ * - duplicate citations — same (node_path, redline_user_id, redline_timestamp)
+ *   identity key — are counted once.
+ */
+export declare const countFiredByRule: (grounding: unknown) => Map<string, number>;
+/**
+ * Memoized fired-count index for a review response. Returns null when no
+ * review response exists yet (pre-run: badges must show "—", never "0 fired").
+ */
+export declare const firedCountsByRule: (review: ReviewResponseLike | null | undefined) => ReadonlyMap<string, number> | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lax-wp/editor",
-  "version": "0.4.13",
+  "version": "0.4.15-beta.0",
   "description": "A modern, feature-rich editor built with React and TipTap",
   "keywords": [
     "editor",
@@ -38,6 +38,7 @@
     "build": "npm run build:types && vite build",
     "build:types": "tsc --project tsconfig.build.json",
     "lint": "eslint .",
+    "test": "vitest run",
     "preview": "vite preview",
     "prepublishOnly": "npm run build",
     "link:register": "npm run build && npm link",
@@ -47,46 +48,48 @@
   "dependencies": {
     "@emotion/react": "^11.14.0",
     "@emotion/styled": "^11.14.1",
+    "@microsoft/fetch-event-source": "^2.0.1",
     "@mui/icons-material": "^7.3.4",
     "@mui/material": "^7.3.4",
-    "@tiptap/extension-blockquote": "^3.6.5",
-    "@tiptap/extension-bold": "^3.6.5",
-    "@tiptap/extension-character-count": "^3.6.2",
-    "@tiptap/extension-code-block-lowlight": "^3.6.5",
-    "@tiptap/extension-collaboration": "^3.22.3",
-    "@tiptap/extension-collaboration-caret": "^3.10.7",
-    "@tiptap/extension-document": "^3.6.2",
-    "@tiptap/extension-hard-break": "^3.6.6",
-    "@tiptap/extension-heading": "^3.6.5",
-    "@tiptap/extension-highlight": "^3.6.2",
-    "@tiptap/extension-horizontal-rule": "^3.6.5",
-    "@tiptap/extension-image": "^3.6.5",
-    "@tiptap/extension-italic": "^3.6.5",
-    "@tiptap/extension-link": "^3.6.5",
-    "@tiptap/extension-list": "^3.6.2",
-    "@tiptap/extension-paragraph": "^3.6.5",
-    "@tiptap/extension-strike": "^3.6.5",
-    "@tiptap/extension-subscript": "^3.6.2",
-    "@tiptap/extension-superscript": "^3.6.2",
-    "@tiptap/extension-table": "^3.6.5",
-    "@tiptap/extension-task-item": "^3.6.2",
-    "@tiptap/extension-task-list": "^3.6.2",
-    "@tiptap/extension-text": "^3.6.5",
-    "@tiptap/extension-text-align": "^3.6.5",
-    "@tiptap/extension-text-style": "^3.20.1",
-    "@tiptap/extension-typography": "^3.6.2",
-    "@tiptap/extension-underline": "^3.6.5",
-    "@tiptap/extensions": "^3.6.2",
-    "@tiptap/pm": "^3.22.3",
-    "@tiptap/react": "^3.6.2",
-    "@tiptap/starter-kit": "^3.6.2",
+    "@tiptap/extension-blockquote": "^3.31.2",
+    "@tiptap/extension-bold": "^3.31.2",
+    "@tiptap/extension-character-count": "^3.31.2",
+    "@tiptap/extension-code-block-lowlight": "^3.31.2",
+    "@tiptap/extension-collaboration": "^3.31.2",
+    "@tiptap/extension-collaboration-caret": "^3.31.2",
+    "@tiptap/extension-document": "^3.31.2",
+    "@tiptap/extension-hard-break": "^3.31.2",
+    "@tiptap/extension-heading": "^3.31.2",
+    "@tiptap/extension-highlight": "^3.31.2",
+    "@tiptap/extension-horizontal-rule": "^3.31.2",
+    "@tiptap/extension-image": "^3.31.2",
+    "@tiptap/extension-italic": "^3.31.2",
+    "@tiptap/extension-link": "^3.31.2",
+    "@tiptap/extension-list": "^3.31.2",
+    "@tiptap/extension-paragraph": "^3.31.2",
+    "@tiptap/extension-strike": "^3.31.2",
+    "@tiptap/extension-subscript": "^3.31.2",
+    "@tiptap/extension-superscript": "^3.31.2",
+    "@tiptap/extension-table": "^3.31.2",
+    "@tiptap/extension-task-item": "^3.31.2",
+    "@tiptap/extension-task-list": "^3.31.2",
+    "@tiptap/extension-text": "^3.31.2",
+    "@tiptap/extension-text-align": "^3.31.2",
+    "@tiptap/extension-text-style": "^3.31.2",
+    "@tiptap/extension-typography": "^3.31.2",
+    "@tiptap/extension-underline": "^3.31.2",
+    "@tiptap/extensions": "^3.31.2",
+    "@tiptap/pm": "^3.31.2",
+    "@tiptap/react": "^3.31.2",
+    "@tiptap/starter-kit": "^3.31.2",
     "classnames": "^2.5.1",
     "html-to-image": "^1.11.13",
     "install": "^0.13.0",
     "lowlight": "^3.3.0",
     "react-custom-scrollbars-2": "^4.5.0",
     "react-keyshorts": "^2.0.2",
-    "react-select": "^5.10.2"
+    "react-select": "^5.10.2",
+    "zod": "^3.25.76"
   },
   "peerDependencies": {
     "@lax-wp/design-system": "*",
@@ -125,6 +128,8 @@
     "@eslint/js": "^9.30.1",
     "@lax-wp/design-system": "^0.11.20",
     "@monaco-editor/react": "^4.6.0",
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/user-event": "^14.6.1",
     "@types/react": "^18.2.0",
     "@types/react-dom": "^18.2.0",
     "@vitejs/plugin-react": "^4.7.0",
@@ -138,6 +143,7 @@
     "eslint-plugin-react-refresh": "^0.4.20",
     "framer-motion": "^12.23.12",
     "globals": "^16.3.0",
+    "jsdom": "^30.0.1",
     "lottie-web": "^5.12.2",
     "playwright": "^1.54.1",
     "postcss": "^8.4.49",