@beyondwork/docx-react-component 1.0.66 → 1.0.69

package/src/runtime/scopes/workflow-overlap.ts

@@ -0,0 +1,92 @@
+/**
+ * Workflow-posture overlap — Layer 06 integration for scope compilation.
+ *
+ * Given a scope's canonical range and the workflow overlay, returns the
+ * `SemanticScopeWorkflow` projection: the ids of overlay scopes overlapping
+ * the range + the most-restrictive `effectiveMode` across them +
+ * `blockedReasons` when a `view`-mode overlap blocks the scope.
+ *
+ * The most-restrictive rule matches layer 06's `InteractionGuardSnapshot`
+ * composition (see `docs/architecture/06-workflow-review.md` §W3):
+ *   view > comment > suggest > edit
+ *
+ * When no overlay is threaded, or no overlap exists, the returned shape
+ * is `{ scopeIds: [], effectiveMode: "edit" }` — the honest degraded
+ * projection callers should treat as "posture unknown / no enforcement
+ * visible at this layer". Scope kinds whose own identity implies a
+ * posture (e.g. `field` → "view", `comment-thread` → "comment") continue
+ * to carry their identity-derived posture; this helper layers overlay
+ * overlap on top.
+ */
+
+import type { WorkflowOverlay, WorkflowScope } from "./_scope-dependencies.ts";
+
+import type { ScopePositionMap, ScopePositionRange } from "./position-map.ts";
+import { rangesOverlap } from "./scope-range.ts";
+import type { SemanticScopeWorkflow } from "./semantic-scope-types.ts";
+
+type WorkflowMode = "edit" | "suggest" | "comment" | "view";
+
+function modeRank(mode: WorkflowMode): number {
+  // Higher = more restrictive (wins the merge).
+  switch (mode) {
+    case "edit":
+      return 0;
+    case "suggest":
+      return 1;
+    case "comment":
+      return 2;
+    case "view":
+      return 3;
+  }
+}
+
+function mergeModes(a: WorkflowMode, b: WorkflowMode): WorkflowMode {
+  return modeRank(a) >= modeRank(b) ? a : b;
+}
+
+export interface WorkflowOverlapInputs {
+  readonly overlay: WorkflowOverlay | null | undefined;
+  readonly positionMap: ScopePositionMap;
+  readonly range: ScopePositionRange | null;
+  /**
+   * Scope-ids that should be treated as "self" and excluded from the
+   * overlap calculation — used when a marker-backed clause scope reads
+   * its own posture to avoid listing its own id again.
+   */
+  readonly selfScopeIds?: ReadonlySet<string>;
+}
+
+/**
+ * Compile the workflow projection for a scope. Returns a bounded
+ * `SemanticScopeWorkflow` populated from overlay overlap.
+ */
+export function resolveWorkflowOverlap(
+  inputs: WorkflowOverlapInputs,
+): SemanticScopeWorkflow {
+  const { overlay, positionMap, range, selfScopeIds } = inputs;
+  if (!overlay || !overlay.scopes || overlay.scopes.length === 0 || !range) {
+    return { scopeIds: [], effectiveMode: "edit" };
+  }
+  const overlappingIds: string[] = [];
+  const blockedReasons: string[] = [];
+  let mode: WorkflowMode = "edit";
+  for (const scope of overlay.scopes as readonly WorkflowScope[]) {
+    if (selfScopeIds && selfScopeIds.has(scope.scopeId)) continue;
+    const markerRange = positionMap.markerScopes.get(scope.scopeId);
+    if (!markerRange) continue;
+    if (!rangesOverlap(range, markerRange)) continue;
+    overlappingIds.push(scope.scopeId);
+    mode = mergeModes(mode, scope.mode);
+    if (scope.mode === "view") {
+      blockedReasons.push(`workflow-scope-view:${scope.scopeId}`);
+    }
+  }
+  overlappingIds.sort();
+  blockedReasons.sort();
+  return {
+    scopeIds: overlappingIds,
+    effectiveMode: mode,
+    ...(blockedReasons.length > 0 ? { blockedReasons } : {}),
+  };
+}

package/src/runtime/selection/index.ts

@@ -1,6 +1,6 @@
 /**
  * R.1 SelectionLayer — named module for cursor movement, validation, and
- * anchor projection. See `docs/plans/lane-1-editing-foundation.md` §R.1.
+ * anchor projection. See `CLAUDE.md (lane status table)` §R.1.
  *
  * This file is the layer's single entry point. Callers consume
  * `SelectionLayer.move(doc, sel, op)` / `SelectionLayer.validate(doc, sel)`

package/src/runtime/structure-ops/fragment-insert.ts

@@ -1,5 +1,5 @@
 /**
- * Slice 1 of the I2 Tier B rich-paste sub-plan (`docs/plans/lane-1-i2-tier-b-rich-paste.md`).
+ * Slice 1 of the I2 Tier B rich-paste sub-plan (`CLAUDE.md (lane status table)`).
  *
  * `applyFragmentInsert` is the canonical splicer for `CanonicalDocumentFragment` —
  * the block-level payload that the HTML and Word-clipboard paste parsers (Slices 2+3)

package/src/runtime/structure-ops/index.ts

@@ -1,6 +1,6 @@
 /**
  * R.3 StructureLayer — named shell module for structural mutations. See
- * `docs/plans/lane-1-editing-foundation.md` §R.3.
+ * `CLAUDE.md (lane status table)` §R.3.
  *
  * Mirrors R.2 EditLayer's pattern: a thin named entry point over existing
  * pure functions. The layer's purpose is to be the single site where callers