nudge-ui 0.2.0

package/dist/inspector/projection/structuralProjectionBoundary.js

@@ -0,0 +1,65 @@
+import { isRenderedInstanceRef } from "../changes/editModel.js";
+export function isStructuralProjectionReport(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const candidate = value;
+    if (!hasOnlyKeys(candidate, ["changeId", "status", "reason"])
+        || typeof candidate.changeId !== "string")
+        return false;
+    const status = candidate.status;
+    if (status !== "applied" && status !== "missing" && status !== "ambiguous" && status !== "overridden")
+        return false;
+    const reason = candidate.reason;
+    if (reason !== undefined && !isStructuralProjectionReason(reason))
+        return false;
+    return status === "applied" ? reason === undefined : reason !== undefined;
+}
+export function isStructuralDelete(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const candidate = value;
+    if (!hasOnlyKeys(candidate, ["id", "kind", "target"]))
+        return false;
+    return candidate.kind === "delete"
+        && typeof candidate.id === "string"
+        && isRenderedInstanceRef(candidate.target);
+}
+export function isStructuralMove(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const candidate = value;
+    if (!hasOnlyKeys(candidate, ["id", "kind", "target", "source", "destination", "presentation"]) || candidate.kind !== "move"
+        || typeof candidate.id !== "string" || !isRenderedInstanceRef(candidate.target))
+        return false;
+    if (!candidate.source || typeof candidate.source !== "object"
+        || !candidate.destination || typeof candidate.destination !== "object"
+        || !candidate.presentation || typeof candidate.presentation !== "object")
+        return false;
+    const source = candidate.source;
+    const destination = candidate.destination;
+    const presentation = candidate.presentation;
+    return hasOnlyKeys(source, ["parent"])
+        && isRenderedInstanceRef(source.parent)
+        && hasOnlyKeys(destination, ["parent", "before"])
+        && isRenderedInstanceRef(destination.parent)
+        && (destination.before === null || isRenderedInstanceRef(destination.before))
+        && hasOnlyKeys(presentation, ["sourceParentTag", "destinationParentTag", "fromIndex", "toIndex"])
+        && typeof presentation.sourceParentTag === "string"
+        && typeof presentation.destinationParentTag === "string"
+        && Number.isSafeInteger(presentation.fromIndex) && presentation.fromIndex >= 0
+        && Number.isSafeInteger(presentation.toIndex) && presentation.toIndex >= 0;
+}
+export function isStructuralChange(value) {
+    return isStructuralDelete(value) || isStructuralMove(value);
+}
+function hasOnlyKeys(value, allowed) {
+    return Object.keys(value).every((key) => allowed.includes(key));
+}
+function isStructuralProjectionReason(value) {
+    return value === "target"
+        || value === "source-parent"
+        || value === "destination-parent"
+        || value === "anchor"
+        || value === "illegal-destination"
+        || value === "react-override";
+}

package/dist/inspector/projection/textProjection.d.ts

@@ -0,0 +1,53 @@
+import { isTextProjectionTargetValue, type TextContentChangeRecord, type TextProjectionTarget, type TextProjectionScope, type TextBindingEvidence } from "../inline-text/textChangeBoundary.js";
+/** Strict JSON boundary guard for a text projection target. */
+export declare const isTextProjectionTarget: typeof isTextProjectionTargetValue;
+export type { TextProjectionTarget } from "../inline-text/textChangeBoundary.js";
+export type TextProjectionStatus = "applied" | "missing" | "ambiguous" | "overridden";
+export interface TextProjectionReport {
+    changeId: string;
+    status: TextProjectionStatus;
+}
+export interface TextContentProjectionDiagnostic extends TextProjectionReport {
+    document: "Inspect" | `Canvas ${string}`;
+    scope?: TextProjectionScope;
+    evidence?: TextBindingEvidence;
+}
+/** Dedicated document-local marker; never part of canonical session identity. */
+export declare const TEXT_PROJECTION_ATTR = "data-projection-text";
+/** Inspector-owned hit target for a projected text node whose value is empty. */
+export declare const EMPTY_TEXT_PROJECTION_ATTR = "data-empty-text";
+/** Inspector-owned exact-node evidence paired with EMPTY_TEXT_PROJECTION_ATTR. */
+export declare const EMPTY_TEXT_PROJECTION_PATH_ATTR = "data-empty-text-path";
+export type TextProjectionResolution = {
+    status: "resolved";
+    element: HTMLElement;
+} | {
+    status: "missing";
+} | {
+    status: "ambiguous";
+};
+/** Find the exact text node represented by a target, tolerating a changed
+ * child path only when one bounded before/after text node remains unique. */
+export declare function resolveTextProjectionTextNode(element: HTMLElement, target: Pick<TextProjectionTarget, "textNodePath"> & Partial<Pick<TextProjectionTarget, "beforeText">>, expectedText?: string | undefined): Text | null;
+/** Capture stable source/evidence identity without retaining a DOM reference. */
+export declare function captureTextProjectionTarget(element: HTMLElement, beforeText?: string, selectedTextNode?: Text): TextProjectionTarget | null;
+/**
+ * Resolve against source identity and bounded evidence. Occurrence is kept as
+ * presentation metadata only and is never used to choose among identical
+ * repeated outputs.
+ */
+export declare function resolveTextProjectionTarget(doc: Document, target: TextProjectionTarget, afterText?: string): TextProjectionResolution;
+export declare function textProjectionSelector(target: TextProjectionTarget): string | null;
+export declare function collectTextContentChanges(changes: ReadonlyArray<unknown>): TextContentChangeRecord[];
+/** Returns the canonical record represented by an inspector empty-text slot. */
+export declare function getTextContentChangeById(changeId: string): TextContentChangeRecord | null;
+/** Apply one controller-owned text snapshot to a document adapter. */
+export declare function applyTextContentProjection(doc: Document, changes: ReadonlyArray<TextContentChangeRecord>): TextProjectionReport[];
+export declare function getTextProjectionReports(doc: Document): readonly TextProjectionReport[];
+export declare function subscribeTextProjectionDiagnostics(listener: () => void): () => void;
+export declare function getTextProjectionDiagnosticRevision(): number;
+export declare function recordCanvasTextProjectionReports(cardId: string, revision: number, reports: readonly TextProjectionReport[]): void;
+export declare function clearCanvasTextProjectionReports(cardId: string): void;
+export declare function getTextContentChangeDiagnostics(changeId: string): TextContentProjectionDiagnostic[];
+export declare function isTextProjectionReport(value: unknown): value is TextProjectionReport;
+export declare function resetTextProjectionState(): void;