nudge-ui 0.2.5 → 0.2.6

package/dist/inspector/conformance/typographyCases.d.ts

@@ -1,7 +1,2 @@
 import type { ConformanceFixture } from "./fixture.js";
-/**
- * Framework-neutral typography corpus. The fixture runner asserts authored
- * CSS and capability independently from browser-computed output; the gallery
- * lets a human exercise the same cases through the real inspector.
- */
 export declare const TYPOGRAPHY_CASES: ConformanceFixture[];

package/dist/inspector/conformance/typographyCases.js

@@ -10,11 +10,6 @@ const TYPE_WEIGHT = token("--type-weight-strong", "650", "fixtures/typography.cs
 const TYPE_LEADING = token("--type-leading-body", "1.5", "fixtures/typography.css:4");
 const TYPE_TRACKING = token("--type-tracking-tight", "-0.018em", "fixtures/typography.css:5");
 const TYPE_FAMILY = token("--type-family-body", 'Inter, ui-sans-serif, system-ui, sans-serif', "fixtures/typography.css:6");
-/**
- * Framework-neutral typography corpus. The fixture runner asserts authored
- * CSS and capability independently from browser-computed output; the gallery
- * lets a human exercise the same cases through the real inspector.
- */
 export const TYPOGRAPHY_CASES = [
     {
         id: "type-direct-literals",

package/dist/inspector/drafts/draftStore.d.ts

@@ -12,19 +12,13 @@ export interface DraftChangesSnapshot extends DraftContents {
 /** A canonical write result. `blocked` means the lease or a save lock refused the write. */
 export type CommitResult = "applied" | "unchanged" | "blocked";
 /** Why the active draft's preview must be rebuilt. */
-export type DraftProjectionEvent = 
-/** The active draft's contents changed through an edit, revert, undo, or redo. */
-{
+export type DraftProjectionEvent = {
     readonly kind: "edit";
     readonly verificationTargets?: ReadonlyMap<string, HTMLElement | null>;
-}
-/** Source verification removed these records from the active draft. */
- | {
+} | {
     readonly kind: "reconcile";
     readonly structuralIds: ReadonlySet<string>;
-}
-/** Another draft became active, or drafts were loaded. */
- | {
+} | {
     readonly kind: "switch";
 }
 /** The active draft was cleared; every earlier preview diagnostic is void. */
@@ -56,15 +50,11 @@ export interface DraftStoreSeams {
     readonly timeline: Timeline;
     readonly storage: DraftStorage;
     readonly sketches: DraftSketchSource;
+    /** Brings a draft's owning frame back when history replays an edit. */
+    revealDraft(draftId: string, cardId?: string): void;
     /** Rebuilds the active draft's preview. Called after subscribers see the new snapshot. */
     project(snapshot: DraftChangesSnapshot, event: DraftProjectionEvent): void;
 }
-/**
- * The Workspace's drafts. A draft's identity is its target key (ADR-0030):
- * every frame that shows one page or iteration edits the same draft. Every
- * write is lease-gated, every change to the active draft is projected, and
- * reconciliation removes only verified records, including from history.
- */
 export interface DraftStore {
     getActive(): DraftChangesSnapshot;
     /** Fires for any draft content change, active-draft switch, or history change. */
@@ -78,22 +68,19 @@ export interface DraftStore {
     isLocked(id?: string): boolean;
     /** Blocks writes to one draft until the returned release runs. */
     lock(id: string): () => void;
-    /** Makes a draft active; `reveal` brings its frame back when history replays an edit. */
-    activate(id: string, reveal?: () => void): void;
+    /** Makes a draft active; `cardId` is the frame history replay should reveal for it. */
+    activate(id: string, cardId?: string): void;
     commitChanges(incoming: readonly ChangeRecord[], verificationTargets?: ReadonlyMap<string, HTMLElement | null>): CommitResult;
     revertChange(change: ChangeRecord): boolean;
     discardChanges(target: DraftDiscardTarget): boolean;
     commitStructuralChange(change: StructuralChange): boolean;
     revertStructuralChange(changeId: string): boolean;
-    /** Replaces the active draft as one undoable edit. */
     commitContents(next: DraftContents): boolean;
     undo(): boolean;
     redo(): boolean;
-    /** Removes source-verified records so no undo step can resurrect them. */
     reconcile(id: string, verifiedKeys: ReadonlySet<string>, verifiedStructuralIds: ReadonlySet<string>): number;
     clear(id: string, expectedRevision?: number): boolean;
     clearActive(): boolean;
-    /** Drops a draft whose content no longer exists, such as a deleted iteration. */
     forget(id: string): void;
     sketchOwner(document: SketchDocument): string | null;
     assignSketch(draftId: string, sketchId: string): void;
@@ -102,7 +89,6 @@ export interface DraftStore {
         persistent?: boolean;
     }): void;
     persist(): void;
-    /** Discards stored and in-memory drafts for the current project. */
     discardAll(): void;
     reset(): void;
 }

package/dist/inspector/drafts/draftStore.js

@@ -161,14 +161,19 @@ export function createDraftStore(seams) {
             const draft = draftState();
             const before = draft.contents;
             replaceContents(draft, next);
-            seams.timeline.recordEdit({ draftId: draft.id, activate: draft.activate, before, after: draft.contents }, sameDraftContents);
+            seams.timeline.recordEdit({
+                draftId: draft.id,
+                focus: { draftId: draft.id, ...(draft.activateCardId ? { cardId: draft.activateCardId } : {}) },
+                before,
+                after: draft.contents,
+            }, sameDraftContents);
             project(event);
             return true;
         });
     }
-    function activate(id, reveal) {
+    function activate(id, cardId) {
         mutate(() => {
-            draftState(id).activate = reveal;
+            draftState(id).activateCardId = cardId;
             if (activeId() === id)
                 return;
             activeDraftId = id;
@@ -182,8 +187,13 @@ export function createDraftStore(seams) {
         return mutate(() => {
             const replayed = seams.timeline.replay(direction, (entry, next) => {
                 replaceContents(draftState(entry.draftId), next);
-                entry.activate?.();
-                if (!entry.activate)
+                // Replay always makes the entry's draft active, including when another
+                // draft is active; a known frame is revealed before that switch.
+                if (entry.focus?.cardId)
+                    seams.revealDraft(entry.focus.draftId, entry.focus.cardId);
+                else
+                    seams.revealDraft(entry.draftId);
+                if (activeId() !== entry.draftId)
                     activate(entry.draftId);
             });
             if (replayed)

package/dist/inspector/drafts/model.d.ts

@@ -1,18 +1,19 @@
 import type { ChangeRecord } from "../changes/types.js";
 import type { StructuralChange } from "../changes/structuralTypes.js";
-/** The canonical intent of one draft: ordinary records and structural records. */
 export interface DraftContents {
     readonly changes: readonly ChangeRecord[];
     readonly structuralChanges: readonly StructuralChange[];
 }
-export type DraftTarget = {
+export interface ApplicationTarget {
     readonly kind: "application";
     readonly route: string;
-} | {
+}
+export interface HtmlTarget {
     readonly kind: "html";
     readonly artifactId: string;
     readonly path: string;
-};
+}
+export type DraftTarget = ApplicationTarget | HtmlTarget;
 /** A draft's ID is its target key, so every frame showing the same page or iteration edits one draft. */
 export interface Draft {
     readonly id: string;
@@ -25,18 +26,9 @@ export interface DraftSnapshot {
     readonly projectId: string;
     readonly drafts: readonly Draft[];
 }
-export declare function applicationTarget(url?: string): {
-    kind: "application";
-    route: string;
-};
-export declare function htmlTarget(artifactId: string): {
-    kind: "html";
-    artifactId: string;
-    path: string;
-};
-/** The HTML iteration artifact ID when the URL addresses an iteration document. */
+export declare function applicationTarget(url?: string): ApplicationTarget;
+export declare function htmlTarget(artifactId: string): HtmlTarget;
 export declare function artifactIdFromUrl(url: string): string | null;
-/** Maps a captured document URL to the draft that owns it: an iteration preview or an application page. */
 export declare function documentTarget(url: string): DraftTarget;
 export declare function targetKey(target: DraftTarget): string;
 export declare function targetFromKey(key: string): DraftTarget | null;

package/dist/inspector/drafts/model.js

@@ -10,11 +10,9 @@ export function applicationTarget(url = window.location.href) {
 export function htmlTarget(artifactId) {
     return { kind: "html", artifactId, path: `.nudge/artifacts/${artifactId}/document.html` };
 }
-/** The HTML iteration artifact ID when the URL addresses an iteration document. */
 export function artifactIdFromUrl(url) {
     return ARTIFACT_PATH.exec(new URL(url, window.location.href).pathname)?.[1] ?? null;
 }
-/** Maps a captured document URL to the draft that owns it: an iteration preview or an application page. */
 export function documentTarget(url) {
     const artifactId = artifactIdFromUrl(url);
     return artifactId ? htmlTarget(artifactId) : applicationTarget(url);

package/dist/inspector/drafts/store.d.ts

@@ -23,12 +23,10 @@ export interface AppendChangesOptions {
     /** The rendered target captured for each change key at commit time. */
     verificationTargets?: ReadonlyMap<string, HTMLElement | null>;
 }
-/** Appends records and reports whether canonical workspace state changed. */
 export declare function appendChanges(incoming: readonly ChangeRecord[], options?: AppendChangesOptions): CommitResult;
 export declare function appendChange(change: ChangeRecord): CommitResult;
 export declare function revertChange(change: ChangeRecord): void;
 export declare function discardChangesForSelector(selector: string): void;
-/** Relink removes every CSS declaration owned by one durable rendered target. */
 export declare function discardChangesForInstanceOverride(overrideId: string): void;
 export declare function commitStructuralChange(change: StructuralChange): boolean;
 export declare function revertStructuralChange(changeId: string): boolean;
@@ -36,14 +34,10 @@ export declare function revertStructuralChange(changeId: string): boolean;
 export declare function commitDraftContents(changes: readonly ChangeRecord[], structuralChanges: readonly StructuralChange[]): boolean;
 export declare function undo(): boolean;
 export declare function redo(): boolean;
-/**
- * Removes source-verified records without letting older undo snapshots
- * resurrect their previews. Newer, unsent edits and their history survive.
- */
+/** Removes only source-verified records, and older undo snapshots must not resurrect their previews. */
 export declare function reconcileDraftChanges(id: string, verifiedKeys: ReadonlySet<string>, verifiedStructuralIds: ReadonlySet<string>): number;
 /** Clears the active draft and its edit steps, preserving other session history. */
 export declare function clearActiveDraft(): void;
-/** Drops a draft whose content no longer exists, such as a deleted iteration. */
 export declare function forgetDraft(id: string): void;
 export declare function loadDrafts(projectId: string, options?: {
     persistent?: boolean;
@@ -59,7 +53,6 @@ export declare function getDraftContentsForCard(cardId: string): DraftContents |
 export declare function activateDraftForCard(cardId: string): void;
 export declare function activateDraft(draftId: string, preferredCardId?: string): void;
 export declare function clearSavedIterationDraft(cardId: string, expectedRevision?: number): boolean;
-/** Returns the first preferred frame that exists, then the first frame. */
 export declare function getEditableCardId(...preferredCardIds: readonly (string | null | undefined)[]): string | null;
 export declare function sketchOwner(document: SketchDocument): string | null;
 export declare function assignSketchToDraft(draftId: string, sketchId: string): void;

package/dist/inspector/drafts/store.js

@@ -11,7 +11,6 @@ import { sessionTimeline } from "../workspace/timeline.js";
 import { createDraftStore } from "./draftStore.js";
 import { targetFromKey, targetKey } from "./model.js";
 const preview = createDraftPreview(() => drafts.getActive());
-/** The Workspace's drafts, wired to the Canvas lease, session timeline, local storage, and host preview. */
 const drafts = createDraftStore({
     canWrite: () => canWriteWorkspace(),
     timeline: sessionTimeline,
@@ -21,6 +20,7 @@ const drafts = createDraftStore({
         remove: (key) => inspectorStorage()?.removeItem(key),
     },
     sketches: { getSnapshot: () => getSketchStoreSnapshot(), subscribe: (listener) => subscribeSketchStore(listener) },
+    revealDraft: (draftId, cardId) => revealDraft(draftId, cardId),
     project: (snapshot, event) => preview.project(snapshot, event),
 });
 const contentDrafts = new WeakMap();
@@ -71,7 +71,6 @@ export function getChangesList() {
 export function getPendingRules() {
     return buildManagedStyleRules(activeChanges());
 }
-/** Appends records and reports whether canonical workspace state changed. */
 export function appendChanges(incoming, options = {}) {
     return drafts.commitChanges(incoming, options.verificationTargets);
 }
@@ -84,7 +83,6 @@ export function revertChange(change) {
 export function discardChangesForSelector(selector) {
     drafts.discardChanges({ kind: "selector", selector });
 }
-/** Relink removes every CSS declaration owned by one durable rendered target. */
 export function discardChangesForInstanceOverride(overrideId) {
     drafts.discardChanges({ kind: "instance-override", id: overrideId });
 }
@@ -104,10 +102,7 @@ export function undo() {
 export function redo() {
     return drafts.redo();
 }
-/**
- * Removes source-verified records without letting older undo snapshots
- * resurrect their previews. Newer, unsent edits and their history survive.
- */
+/** Removes only source-verified records, and older undo snapshots must not resurrect their previews. */
 export function reconcileDraftChanges(id, verifiedKeys, verifiedStructuralIds) {
     return drafts.reconcile(id, verifiedKeys, verifiedStructuralIds);
 }
@@ -120,7 +115,6 @@ export function clearActiveDraft() {
     cancelInlineTextForClear();
     drafts.clearActive();
 }
-/** Drops a draft whose content no longer exists, such as a deleted iteration. */
 export function forgetDraft(id) {
     drafts.forget(id);
 }
@@ -162,7 +156,7 @@ export function activateDraftForCard(cardId) {
         activateDraft(draftId, cardId);
 }
 export function activateDraft(draftId, preferredCardId) {
-    drafts.activate(draftId, () => revealDraft(draftId, preferredCardId));
+    drafts.activate(draftId, preferredCardId);
 }
 function revealDraft(draftId, preferredCardId) {
     const cards = getCanvasCards();
@@ -186,7 +180,6 @@ export function clearSavedIterationDraft(cardId, expectedRevision) {
     const draftId = draftIdForCard(cardId);
     return !!draftId && drafts.clear(draftId, expectedRevision);
 }
-/** Returns the first preferred frame that exists, then the first frame. */
 export function getEditableCardId(...preferredCardIds) {
     const cards = getCanvasCards();
     return preferredCardIds.find((id) => !!id && cards.some((card) => card.id === id)) ?? cards[0]?.id ?? null;

package/dist/inspector/editScope.d.ts

@@ -1,4 +1,3 @@
 export declare const EDIT_SCOPES: readonly ["source-site", "rendered-instance"];
 export type EditScope = (typeof EDIT_SCOPES)[number];
-/** Returns whether a host value names a supported edit scope. */
 export declare function isEditScope(value: unknown): value is EditScope;

package/dist/inspector/editScope.js

@@ -1,5 +1,4 @@
 export const EDIT_SCOPES = ["source-site", "rendered-instance"];
-/** Returns whether a host value names a supported edit scope. */
 export function isEditScope(value) {
     return EDIT_SCOPES.some((scope) => scope === value);
 }

package/dist/inspector/inline-text/inlineTextDiagnostics.d.ts

@@ -4,7 +4,5 @@ export declare function getInlineTextDiagnostics(): readonly InlineTextDiagnosti
 export declare function getInlineTextDiagnostic(): InlineTextDiagnostic | null;
 export declare function subscribeInlineTextDiagnostics(listener: () => void): () => void;
 export declare function useInlineTextDiagnostic(): InlineTextDiagnostic | null;
-/** Clear the current diagnostic, optionally only when it belongs to a frame. */
 export declare function clearInlineTextDiagnostics(ownerDocument?: Document): void;
-/** Keep feedback for the target that was just selected, but clear stale feedback. */
 export declare function clearInlineTextDiagnosticsForSelection(selectedElements: readonly HTMLElement[]): void;

package/dist/inspector/inline-text/inlineTextDiagnostics.js

@@ -43,7 +43,6 @@ export function useInlineTextDiagnostic() {
     useSyncExternalStore(subscribeInlineTextDiagnostics, () => revision, () => revision);
     return getInlineTextDiagnostic();
 }
-/** Clear the current diagnostic, optionally only when it belongs to a frame. */
 export function clearInlineTextDiagnostics(ownerDocument) {
     const current = diagnostics.at(-1);
     if (!current)
@@ -53,7 +52,6 @@ export function clearInlineTextDiagnostics(ownerDocument) {
     diagnostics = [];
     notify();
 }
-/** Keep feedback for the target that was just selected, but clear stale feedback. */
 export function clearInlineTextDiagnosticsForSelection(selectedElements) {
     const current = diagnostics.at(-1);
     if (!current)

package/dist/inspector/inline-text/inlineTextEditor.d.ts

@@ -37,7 +37,6 @@ export declare function getInlineTextSession(): InlineTextSession | null;
 export declare function useInlineTextSession(): InlineTextSession | null;
 export declare function isInlineTextEditingActive(): boolean;
 export declare function cancelInlineTextEdit(): void;
-/** End a session owned by a document/frame that is about to be disposed. */
 export declare function disposeInlineTextEdit(reason?: "frame-disposed" | "route-disposed", ownerDocument?: Document): void;
 export type InlineTextEditIntent = {
     kind: "pointer-down";
@@ -55,15 +54,10 @@ export type InlineTextEditIntent = {
         y: number;
     };
 };
-/**
- * Handle one native interaction while keeping session-transition policy
- * local. Pointer-down preserves double-click intent across the first click's
- * blur commit, even when canonical projection replaces the target DOM.
- */
+/** Pointer-down preserves double-click intent across the first click's blur commit. */
 export declare function handleInlineTextEditIntent(intent: InlineTextEditIntent): InlineTextInteractionDisposition;
 export declare const inlineTextEditor: InlineTextEditor;
-/** Re-enter an existing canonical rendered-text projection through its empty
- * inspector affordance. This never guesses a new DOM target or source node. */
+/** Re-enters an existing projection; never guesses a new DOM target or source node. */
 export declare function beginInlineTextEditFromEmptyProjection(marker: HTMLElement): InlineTextSession | TextEditRejection;
 export declare function beginInlineTextEdit(element: HTMLElement, point?: {
     x: number;