@graphrefly/graphrefly 0.47.2 → 0.48.0

package/dist/utils/cqrs/index.d.cts

@@ -1,7 +1,7 @@
 import { Node } from '@graphrefly/pure-ts/core';
 import { ReactiveLogBundle, AppendLogStorageTier } from '@graphrefly/pure-ts/extra';
 import { Graph, GraphOptions } from '@graphrefly/pure-ts/graph';
-import { BaseAuditRecord } from '../../base/mutation/index.cjs';
+import { BaseAuditRecord, ReadonlyAuditLog } from '../../base/mutation/index.cjs';
 
 /**
  * CQRS patterns (roadmap §4.5).
@@ -93,16 +93,18 @@ declare const sagaInvocationKeyOf: <T>(i: SagaInvocation<T>) => string;
  * `Node<unknown>` return that side-attached `_saga` via an unsafe cast.
  *
  * `node` is the saga's effect node (subscribe to observe processing
- * activity). `invocations` is the per-event-type audit log; `audit` aliases
- * `invocations` (Audit 2 `.audit` duplication). `cursors` exposes the
- * per-event-type cursor state nodes for monitoring / testing.
+ * activity). `invocations` is the per-event-type audit log; `audit` is a
+ * **read-only view** of `invocations` (Audit 2 `.audit` duplication; M7 —
+ * the alias can no longer silently `append`/`clear` the canonical log).
+ * `cursors` exposes the per-event-type cursor state nodes for monitoring /
+ * testing.
  *
  * @category patterns
  */
 interface SagaController<T = unknown> {
     readonly node: Node<unknown>;
     readonly invocations: ReactiveLogBundle<SagaInvocation<T>>;
-    readonly audit: ReactiveLogBundle<SagaInvocation<T>>;
+    readonly audit: ReadonlyAuditLog<SagaInvocation<T>>;
     readonly cursors: {
         readonly [eventName: string]: Node<number>;
     };
@@ -312,8 +314,11 @@ declare class CqrsGraph<_EM extends CqrsEventMap = Record<string, unknown>> exte
     private readonly _dispatchSeqCursor;
     /** Audit log of every command dispatch (Audit 2). */
     readonly dispatches: ReactiveLogBundle<DispatchRecord>;
-    /** Alias for {@link CqrsGraph.dispatches} (Audit 2 `.audit` duplication). */
-    readonly audit: ReactiveLogBundle<DispatchRecord>;
+    /**
+     * Read-only view of {@link CqrsGraph.dispatches} (Audit 2 `.audit`
+     * duplication; M7 — cannot mutate the canonical log via the alias).
+     */
+    readonly audit: ReadonlyAuditLog<DispatchRecord>;
     /** Per-aggregate LRU eviction observability; secondary log to `dispatches`. */
     readonly aggregateEvictions: ReactiveLogBundle<AggregateEvictionRecord>;
     constructor(name: string, opts?: CqrsOptions);

package/dist/utils/cqrs/index.d.ts

@@ -1,7 +1,7 @@
 import { Node } from '@graphrefly/pure-ts/core';
 import { ReactiveLogBundle, AppendLogStorageTier } from '@graphrefly/pure-ts/extra';
 import { Graph, GraphOptions } from '@graphrefly/pure-ts/graph';
-import { BaseAuditRecord } from '../../base/mutation/index.js';
+import { BaseAuditRecord, ReadonlyAuditLog } from '../../base/mutation/index.js';
 
 /**
  * CQRS patterns (roadmap §4.5).
@@ -93,16 +93,18 @@ declare const sagaInvocationKeyOf: <T>(i: SagaInvocation<T>) => string;
  * `Node<unknown>` return that side-attached `_saga` via an unsafe cast.
  *
  * `node` is the saga's effect node (subscribe to observe processing
- * activity). `invocations` is the per-event-type audit log; `audit` aliases
- * `invocations` (Audit 2 `.audit` duplication). `cursors` exposes the
- * per-event-type cursor state nodes for monitoring / testing.
+ * activity). `invocations` is the per-event-type audit log; `audit` is a
+ * **read-only view** of `invocations` (Audit 2 `.audit` duplication; M7 —
+ * the alias can no longer silently `append`/`clear` the canonical log).
+ * `cursors` exposes the per-event-type cursor state nodes for monitoring /
+ * testing.
  *
  * @category patterns
  */
 interface SagaController<T = unknown> {
     readonly node: Node<unknown>;
     readonly invocations: ReactiveLogBundle<SagaInvocation<T>>;
-    readonly audit: ReactiveLogBundle<SagaInvocation<T>>;
+    readonly audit: ReadonlyAuditLog<SagaInvocation<T>>;
     readonly cursors: {
         readonly [eventName: string]: Node<number>;
     };
@@ -312,8 +314,11 @@ declare class CqrsGraph<_EM extends CqrsEventMap = Record<string, unknown>> exte
     private readonly _dispatchSeqCursor;
     /** Audit log of every command dispatch (Audit 2). */
     readonly dispatches: ReactiveLogBundle<DispatchRecord>;
-    /** Alias for {@link CqrsGraph.dispatches} (Audit 2 `.audit` duplication). */
-    readonly audit: ReactiveLogBundle<DispatchRecord>;
+    /**
+     * Read-only view of {@link CqrsGraph.dispatches} (Audit 2 `.audit`
+     * duplication; M7 — cannot mutate the canonical log via the alias).
+     */
+    readonly audit: ReadonlyAuditLog<DispatchRecord>;
     /** Per-aggregate LRU eviction observability; secondary log to `dispatches`. */
     readonly aggregateEvictions: ReactiveLogBundle<AggregateEvictionRecord>;
     constructor(name: string, opts?: CqrsOptions);

package/dist/utils/cqrs/index.js

@@ -4,9 +4,9 @@ import {
   cqrsEventKeyOf,
   dispatchKeyOf,
   sagaInvocationKeyOf
-} from "../../chunk-NY2PYHNC.js";
+} from "../../chunk-5UY3PNFY.js";
 import "../../chunk-FMPF42Q4.js";
-import "../../chunk-BXGZFGZ4.js";
+import "../../chunk-C5QD5DQX.js";
 import "../../chunk-AZDQPQ3V.js";
 export {
   CqrsGraph,

package/dist/utils/demo-shell/index.cjs

@@ -81,6 +81,40 @@ function graphSpecToMermaid(g, opts) {
 // src/utils/reactive-layout/reactive-layout.ts
 var import_core = require("@graphrefly/pure-ts/core");
 var import_graph = require("@graphrefly/pure-ts/graph");
+
+// src/utils/reactive-layout/measurement-adapters.ts
+var IntlSegmentAdapter = class {
+  wordSeg = null;
+  graphemeSeg = null;
+  constructor() {
+    if (typeof Intl === "undefined" || typeof Intl.Segmenter !== "function") {
+      throw new TypeError(
+        "IntlSegmentAdapter: Intl.Segmenter is not available in this runtime (Hermes / older embedded JS engines). Pass a custom SegmentAdapter via `reactiveLayout({ segmentAdapter })` \u2014 see the SegmentAdapter JSDoc for the polyfill recipe (e.g. `intl-segmenter-polyfill` or `@formatjs/intl-segmenter`)."
+      );
+    }
+  }
+  segmentWords(text) {
+    if (this.wordSeg === null) {
+      this.wordSeg = new Intl.Segmenter(void 0, { granularity: "word" });
+    }
+    return this.wordSeg.segment(text);
+  }
+  segmentGraphemes(text) {
+    if (this.graphemeSeg === null) {
+      this.graphemeSeg = new Intl.Segmenter(void 0, { granularity: "grapheme" });
+    }
+    return this.graphemeSeg.segment(text);
+  }
+};
+var _defaultSegmentAdapter = null;
+function getDefaultSegmentAdapter() {
+  if (_defaultSegmentAdapter === null) {
+    _defaultSegmentAdapter = new IntlSegmentAdapter();
+  }
+  return _defaultSegmentAdapter;
+}
+
+// src/utils/reactive-layout/reactive-layout.ts
 function isCJK(s) {
   for (const ch of s) {
     const c = ch.codePointAt(0);
@@ -135,10 +169,9 @@ var leftStickyPunctuation = /* @__PURE__ */ new Set([
 function normalizeWhitespace(text) {
   return text.replace(/[\t\n\r\f ]+/g, " ").replace(/^ | $/g, "");
 }
-function segmentText(normalized) {
-  const wordSegmenter = new Intl.Segmenter(void 0, { granularity: "word" });
+function segmentText(normalized, segmentAdapter) {
   const pieces = [];
-  for (const s of wordSegmenter.segment(normalized)) {
+  for (const s of segmentAdapter.segmentWords(normalized)) {
     const text = s.segment;
     const isWordLike = s.isWordLike ?? false;
     const texts = [];
@@ -174,13 +207,11 @@ function segmentText(normalized) {
   }
   return pieces;
 }
-function analyzeAndMeasure(text, font, adapter, cache, stats) {
+function analyzeAndMeasure(text, font, adapter, cache, stats, segmentAdapter) {
   const normalized = normalizeWhitespace(text);
   if (normalized.length === 0) return [];
-  const pieces = segmentText(normalized);
-  const graphemeSegmenter = new Intl.Segmenter(void 0, {
-    granularity: "grapheme"
-  });
+  const segAdapter = segmentAdapter ?? getDefaultSegmentAdapter();
+  const pieces = segmentText(normalized, segAdapter);
   const rawTexts = [];
   const rawKinds = [];
   const rawWordLike = [];
@@ -245,7 +276,7 @@ function analyzeAndMeasure(text, font, adapter, cache, stats) {
     }
     if (isCJK(t)) {
       let unitText = "";
-      for (const gs of graphemeSegmenter.segment(t)) {
+      for (const gs of segAdapter.segmentGraphemes(t)) {
         const grapheme = gs.segment;
         if (unitText.length > 0 && kinsokuStart.has(grapheme)) {
           unitText += grapheme;
@@ -277,7 +308,7 @@ function analyzeAndMeasure(text, font, adapter, cache, stats) {
     let graphemeWidths = null;
     if (mergedWordLike[i] && t.length > 1) {
       const gWidths = [];
-      for (const gs of graphemeSegmenter.segment(t)) {
+      for (const gs of segAdapter.segmentGraphemes(t)) {
         gWidths.push(measureCached(gs.segment));
       }
       if (gWidths.length > 1) {
@@ -288,10 +319,11 @@ function analyzeAndMeasure(text, font, adapter, cache, stats) {
   }
   return segments;
 }
-function computeLineBreaks(segments, maxWidth, adapter, font, cache) {
+function computeLineBreaks(segments, maxWidth, adapter, font, cache, segmentAdapter) {
   if (segments.length === 0) {
     return { lines: [], lineCount: 0 };
   }
+  const segAdapter = segmentAdapter ?? getDefaultSegmentAdapter();
   const lines = [];
   let lineW = 0;
   let hasContent = false;
@@ -317,10 +349,7 @@ function computeLineBreaks(segments, maxWidth, adapter, font, cache) {
       const seg = segments[i];
       if (seg.kind === "soft-hyphen" || seg.kind === "hard-break") continue;
       if (i === lineStartSeg && lineStartGrapheme > 0 && seg.graphemeWidths) {
-        const graphemeSegmenter = new Intl.Segmenter(void 0, {
-          granularity: "grapheme"
-        });
-        const graphemes = [...graphemeSegmenter.segment(seg.text)].map((g) => g.segment);
+        const graphemes = [...segAdapter.segmentGraphemes(seg.text)].map((g) => g.segment);
         text += graphemes.slice(lineStartGrapheme).join("");
       } else {
         text += seg.text;
@@ -328,10 +357,7 @@ function computeLineBreaks(segments, maxWidth, adapter, font, cache) {
     }
     if (endGrapheme > 0 && endSeg < segments.length) {
       const seg = segments[endSeg];
-      const graphemeSegmenter = new Intl.Segmenter(void 0, {
-        granularity: "grapheme"
-      });
-      const graphemes = [...graphemeSegmenter.segment(seg.text)].map((g) => g.segment);
+      const graphemes = [...segAdapter.segmentGraphemes(seg.text)].map((g) => g.segment);
       const startG = lineStartSeg === endSeg ? lineStartGrapheme : 0;
       text += graphemes.slice(startG, endGrapheme).join("");
     }