@flanksource/clicky-ui 0.3.17 → 0.3.18

package/dist/overlay/tour-context.js

@@ -0,0 +1,12 @@
+import { useContext, createContext } from "react";
+const TourContext = createContext(null);
+function useTour() {
+  const ctx = useContext(TourContext);
+  if (!ctx) throw new Error("useTour must be used within a <TourProvider>");
+  return ctx;
+}
+export {
+  TourContext,
+  useTour
+};
+//# sourceMappingURL=tour-context.js.map

package/dist/overlay/tour-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tour-context.js","sources":["../../src/overlay/tour-context.ts"],"sourcesContent":["import { createContext, useContext } from \"react\";\nimport type { TourCompletionStatus } from \"./tour-progress\";\nimport type { TourDefinition } from \"./tour-types\";\n\n/** Status of the running tour. `waiting` means its anchor has not appeared yet. */\nexport type TourStatus = \"idle\" | \"navigating\" | \"waiting\" | \"active\";\n\nexport type TourState = {\n  /** Running tour, or null. */\n  tourId: string | null;\n  /** Zero-based index within the running tour. */\n  index: number;\n  /** Enabled step count of the running tour — the denominator of \"2 of 6\". */\n  total: number;\n  status: TourStatus;\n};\n\nexport type TourContextValue = TourState & {\n  /**\n   * Start a registered tour. `at` jumps to a step id or index; `force` ignores a\n   * recorded completion, which is what a \"Take a tour\" button passes.\n   */\n  start: (tourId: string, options?: { at?: string | number; force?: boolean }) => void;\n  /** Advance; completes the tour on the last step. */\n  next: () => void;\n  back: () => void;\n  /** Jump within the running tour by step id or zero-based index. */\n  goTo: (step: string | number) => void;\n  /** End the running tour and record the outcome. Defaults to `\"dismissed\"`. */\n  finish: (status?: TourCompletionStatus) => void;\n  /** Has this tour been completed or dismissed at its current `version`? */\n  isFinished: (tourId: string) => boolean;\n  /** Forget completions so tours are eligible again — a \"Replay tours\" button. */\n  reset: (tourId?: string) => void;\n  /** Registered tours, for building a \"Take a tour\" menu. */\n  tours: TourDefinition[];\n};\n\nexport const TourContext = createContext<TourContextValue | null>(null);\n\n/** Access the tour API. Must be called under a `<TourProvider>`. */\nexport function useTour(): TourContextValue {\n  const ctx = useContext(TourContext);\n  if (!ctx) throw new Error(\"useTour must be used within a <TourProvider>\");\n  return ctx;\n}\n"],"names":[],"mappings":";AAsCO,MAAM,cAAc,cAAuC,IAAI;AAG/D,SAAS,UAA4B;AAC1C,QAAM,MAAM,WAAW,WAAW;AAClC,MAAI,CAAC,IAAK,OAAM,IAAI,MAAM,8CAA8C;AACxE,SAAO;AACT;"}

package/dist/overlay/tour-geometry.cjs

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+function clamp(value, min, max) {
+  return Math.min(Math.max(value, min), max);
+}
+function anchorRadius(element) {
+  const view = element.ownerDocument.defaultView;
+  if (!view) return 0;
+  const raw = view.getComputedStyle(element).borderTopLeftRadius;
+  if (!raw) return 0;
+  if (raw.endsWith("%")) {
+    const percent = Number.parseFloat(raw);
+    if (!Number.isFinite(percent)) return 0;
+    return element.getBoundingClientRect().width * percent / 100;
+  }
+  const px = Number.parseFloat(raw);
+  return Number.isFinite(px) ? px : 0;
+}
+function spotlightRect(options) {
+  const { anchor, padding, radius, viewport } = options;
+  const left = clamp(anchor.left - padding, 0, viewport.width);
+  const top = clamp(anchor.top - padding, 0, viewport.height);
+  const right = clamp(anchor.right + padding, 0, viewport.width);
+  const bottom = clamp(anchor.bottom + padding, 0, viewport.height);
+  const width = Math.max(right - left, 0);
+  const height = Math.max(bottom - top, 0);
+  const requested = radius ?? 0;
+  return {
+    x: left,
+    y: top,
+    width,
+    height,
+    radius: clamp(requested, 0, Math.min(width, height) / 2)
+  };
+}
+function roundedRectPath(rect) {
+  const { x, y, width, height, radius: r } = rect;
+  if (r <= 0) {
+    return `M${x},${y} H${x + width} V${y + height} H${x} Z`;
+  }
+  return [
+    `M${x + r},${y}`,
+    `H${x + width - r}`,
+    `A${r},${r} 0 0 1 ${x + width},${y + r}`,
+    `V${y + height - r}`,
+    `A${r},${r} 0 0 1 ${x + width - r},${y + height}`,
+    `H${x + r}`,
+    `A${r},${r} 0 0 1 ${x},${y + height - r}`,
+    `V${y + r}`,
+    `A${r},${r} 0 0 1 ${x + r},${y}`,
+    "Z"
+  ].join(" ");
+}
+function spotlightClipPath(options) {
+  const { viewport, cutout } = options;
+  const outer = `M0,0 H${viewport.width} V${viewport.height} H0 Z`;
+  if (!cutout || cutout.width <= 0 || cutout.height <= 0) {
+    return `path(evenodd, "${outer}")`;
+  }
+  return `path(evenodd, "${outer} ${roundedRectPath(cutout)}")`;
+}
+exports.anchorRadius = anchorRadius;
+exports.spotlightClipPath = spotlightClipPath;
+exports.spotlightRect = spotlightRect;
+//# sourceMappingURL=tour-geometry.cjs.map

package/dist/overlay/tour-geometry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tour-geometry.cjs","sources":["../../src/overlay/tour-geometry.ts"],"sourcesContent":["/**\n * Pure spotlight maths. The dim layer is one full-viewport element clipped with\n * `clip-path: path(evenodd, ...)`: the clipped-away hole does not hit-test, so\n * the dim blocks clicks while the anchor underneath stays live — the pointer\n * semantics come free, which no other cutout technique gives us (a\n * `box-shadow: 0 0 0 9999px` ring has them exactly inverted).\n */\n\nexport type Viewport = { width: number; height: number };\n\nexport type SpotlightRect = {\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n  radius: number;\n};\n\nfunction clamp(value: number, min: number, max: number): number {\n  return Math.min(Math.max(value, min), max);\n}\n\n/**\n * The anchor's own computed corner radius, so the cutout traces the control\n * rather than boxing it. A percentage radius resolves against the element's\n * width, matching how the browser paints it.\n */\nexport function anchorRadius(element: HTMLElement): number {\n  const view = element.ownerDocument.defaultView;\n  if (!view) return 0;\n  const raw = view.getComputedStyle(element).borderTopLeftRadius;\n  if (!raw) return 0;\n  if (raw.endsWith(\"%\")) {\n    const percent = Number.parseFloat(raw);\n    if (!Number.isFinite(percent)) return 0;\n    return (element.getBoundingClientRect().width * percent) / 100;\n  }\n  const px = Number.parseFloat(raw);\n  return Number.isFinite(px) ? px : 0;\n}\n\n/**\n * Anchor rect grown by `padding` and clamped to the viewport. The radius grows\n * with the padding so the cutout stays concentric with the control it traces,\n * and is capped at half the shorter side so an over-large radius cannot fold the\n * path in on itself.\n */\nexport function spotlightRect(options: {\n  anchor: DOMRect;\n  padding: number;\n  radius?: number | undefined;\n  viewport: Viewport;\n}): SpotlightRect {\n  const { anchor, padding, radius, viewport } = options;\n  const left = clamp(anchor.left - padding, 0, viewport.width);\n  const top = clamp(anchor.top - padding, 0, viewport.height);\n  const right = clamp(anchor.right + padding, 0, viewport.width);\n  const bottom = clamp(anchor.bottom + padding, 0, viewport.height);\n\n  const width = Math.max(right - left, 0);\n  const height = Math.max(bottom - top, 0);\n  const requested = radius ?? 0;\n\n  return {\n    x: left,\n    y: top,\n    width,\n    height,\n    radius: clamp(requested, 0, Math.min(width, height) / 2),\n  };\n}\n\nfunction roundedRectPath(rect: SpotlightRect): string {\n  const { x, y, width, height, radius: r } = rect;\n  if (r <= 0) {\n    return `M${x},${y} H${x + width} V${y + height} H${x} Z`;\n  }\n  return [\n    `M${x + r},${y}`,\n    `H${x + width - r}`,\n    `A${r},${r} 0 0 1 ${x + width},${y + r}`,\n    `V${y + height - r}`,\n    `A${r},${r} 0 0 1 ${x + width - r},${y + height}`,\n    `H${x + r}`,\n    `A${r},${r} 0 0 1 ${x},${y + height - r}`,\n    `V${y + r}`,\n    `A${r},${r} 0 0 1 ${x + r},${y}`,\n    \"Z\",\n  ].join(\" \");\n}\n\n/**\n * `path(evenodd, \"...\")` for the dim: the viewport rect minus a rounded cutout.\n * A missing or degenerate cutout yields the plain viewport rect, so a zero-size\n * anchor dims the page rather than emitting an invalid path the browser drops\n * (which would leave the dim uncut and the page unusable).\n */\nexport function spotlightClipPath(options: {\n  viewport: Viewport;\n  cutout: SpotlightRect | null;\n}): string {\n  const { viewport, cutout } = options;\n  const outer = `M0,0 H${viewport.width} V${viewport.height} H0 Z`;\n  if (!cutout || cutout.width <= 0 || cutout.height <= 0) {\n    return `path(evenodd, \"${outer}\")`;\n  }\n  return `path(evenodd, \"${outer} ${roundedRectPath(cutout)}\")`;\n}\n"],"names":[],"mappings":";;AAkBA,SAAS,MAAM,OAAe,KAAa,KAAqB;AAC9D,SAAO,KAAK,IAAI,KAAK,IAAI,OAAO,GAAG,GAAG,GAAG;AAC3C;AAOO,SAAS,aAAa,SAA8B;AACzD,QAAM,OAAO,QAAQ,cAAc;AACnC,MAAI,CAAC,KAAM,QAAO;AAClB,QAAM,MAAM,KAAK,iBAAiB,OAAO,EAAE;AAC3C,MAAI,CAAC,IAAK,QAAO;AACjB,MAAI,IAAI,SAAS,GAAG,GAAG;AACrB,UAAM,UAAU,OAAO,WAAW,GAAG;AACrC,QAAI,CAAC,OAAO,SAAS,OAAO,EAAG,QAAO;AACtC,WAAQ,QAAQ,sBAAA,EAAwB,QAAQ,UAAW;AAAA,EAC7D;AACA,QAAM,KAAK,OAAO,WAAW,GAAG;AAChC,SAAO,OAAO,SAAS,EAAE,IAAI,KAAK;AACpC;AAQO,SAAS,cAAc,SAKZ;AAChB,QAAM,EAAE,QAAQ,SAAS,QAAQ,aAAa;AAC9C,QAAM,OAAO,MAAM,OAAO,OAAO,SAAS,GAAG,SAAS,KAAK;AAC3D,QAAM,MAAM,MAAM,OAAO,MAAM,SAAS,GAAG,SAAS,MAAM;AAC1D,QAAM,QAAQ,MAAM,OAAO,QAAQ,SAAS,GAAG,SAAS,KAAK;AAC7D,QAAM,SAAS,MAAM,OAAO,SAAS,SAAS,GAAG,SAAS,MAAM;AAEhE,QAAM,QAAQ,KAAK,IAAI,QAAQ,MAAM,CAAC;AACtC,QAAM,SAAS,KAAK,IAAI,SAAS,KAAK,CAAC;AACvC,QAAM,YAAY,UAAU;AAE5B,SAAO;AAAA,IACL,GAAG;AAAA,IACH,GAAG;AAAA,IACH;AAAA,IACA;AAAA,IACA,QAAQ,MAAM,WAAW,GAAG,KAAK,IAAI,OAAO,MAAM,IAAI,CAAC;AAAA,EAAA;AAE3D;AAEA,SAAS,gBAAgB,MAA6B;AACpD,QAAM,EAAE,GAAG,GAAG,OAAO,QAAQ,QAAQ,MAAM;AAC3C,MAAI,KAAK,GAAG;AACV,WAAO,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,KAAK,IAAI,MAAM,KAAK,CAAC;AAAA,EACtD;AACA,SAAO;AAAA,IACL,IAAI,IAAI,CAAC,IAAI,CAAC;AAAA,IACd,IAAI,IAAI,QAAQ,CAAC;AAAA,IACjB,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,KAAK,IAAI,IAAI,CAAC;AAAA,IACtC,IAAI,IAAI,SAAS,CAAC;AAAA,IAClB,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,QAAQ,CAAC,IAAI,IAAI,MAAM;AAAA,IAC/C,IAAI,IAAI,CAAC;AAAA,IACT,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,SAAS,CAAC;AAAA,IACvC,IAAI,IAAI,CAAC;AAAA,IACT,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC;AAAA,IAC9B;AAAA,EAAA,EACA,KAAK,GAAG;AACZ;AAQO,SAAS,kBAAkB,SAGvB;AACT,QAAM,EAAE,UAAU,OAAA,IAAW;AAC7B,QAAM,QAAQ,SAAS,SAAS,KAAK,KAAK,SAAS,MAAM;AACzD,MAAI,CAAC,UAAU,OAAO,SAAS,KAAK,OAAO,UAAU,GAAG;AACtD,WAAO,kBAAkB,KAAK;AAAA,EAChC;AACA,SAAO,kBAAkB,KAAK,IAAI,gBAAgB,MAAM,CAAC;AAC3D;;;;"}

package/dist/overlay/tour-geometry.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Pure spotlight maths. The dim layer is one full-viewport element clipped with
+ * `clip-path: path(evenodd, ...)`: the clipped-away hole does not hit-test, so
+ * the dim blocks clicks while the anchor underneath stays live — the pointer
+ * semantics come free, which no other cutout technique gives us (a
+ * `box-shadow: 0 0 0 9999px` ring has them exactly inverted).
+ */
+export type Viewport = {
+    width: number;
+    height: number;
+};
+export type SpotlightRect = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    radius: number;
+};
+/**
+ * The anchor's own computed corner radius, so the cutout traces the control
+ * rather than boxing it. A percentage radius resolves against the element's
+ * width, matching how the browser paints it.
+ */
+export declare function anchorRadius(element: HTMLElement): number;
+/**
+ * Anchor rect grown by `padding` and clamped to the viewport. The radius grows
+ * with the padding so the cutout stays concentric with the control it traces,
+ * and is capped at half the shorter side so an over-large radius cannot fold the
+ * path in on itself.
+ */
+export declare function spotlightRect(options: {
+    anchor: DOMRect;
+    padding: number;
+    radius?: number | undefined;
+    viewport: Viewport;
+}): SpotlightRect;
+/**
+ * `path(evenodd, "...")` for the dim: the viewport rect minus a rounded cutout.
+ * A missing or degenerate cutout yields the plain viewport rect, so a zero-size
+ * anchor dims the page rather than emitting an invalid path the browser drops
+ * (which would leave the dim uncut and the page unusable).
+ */
+export declare function spotlightClipPath(options: {
+    viewport: Viewport;
+    cutout: SpotlightRect | null;
+}): string;
+//# sourceMappingURL=tour-geometry.d.ts.map

package/dist/overlay/tour-geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tour-geometry.d.ts","sourceRoot":"","sources":["../../src/overlay/tour-geometry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,QAAQ,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzD,MAAM,MAAM,aAAa,GAAG;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAMF;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAYzD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE;IACrC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,QAAQ,EAAE,QAAQ,CAAC;CACpB,GAAG,aAAa,CAkBhB;AAqBD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IACzC,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;CAC9B,GAAG,MAAM,CAOT"}

package/dist/overlay/tour-geometry.js

@@ -0,0 +1,65 @@
+function clamp(value, min, max) {
+  return Math.min(Math.max(value, min), max);
+}
+function anchorRadius(element) {
+  const view = element.ownerDocument.defaultView;
+  if (!view) return 0;
+  const raw = view.getComputedStyle(element).borderTopLeftRadius;
+  if (!raw) return 0;
+  if (raw.endsWith("%")) {
+    const percent = Number.parseFloat(raw);
+    if (!Number.isFinite(percent)) return 0;
+    return element.getBoundingClientRect().width * percent / 100;
+  }
+  const px = Number.parseFloat(raw);
+  return Number.isFinite(px) ? px : 0;
+}
+function spotlightRect(options) {
+  const { anchor, padding, radius, viewport } = options;
+  const left = clamp(anchor.left - padding, 0, viewport.width);
+  const top = clamp(anchor.top - padding, 0, viewport.height);
+  const right = clamp(anchor.right + padding, 0, viewport.width);
+  const bottom = clamp(anchor.bottom + padding, 0, viewport.height);
+  const width = Math.max(right - left, 0);
+  const height = Math.max(bottom - top, 0);
+  const requested = radius ?? 0;
+  return {
+    x: left,
+    y: top,
+    width,
+    height,
+    radius: clamp(requested, 0, Math.min(width, height) / 2)
+  };
+}
+function roundedRectPath(rect) {
+  const { x, y, width, height, radius: r } = rect;
+  if (r <= 0) {
+    return `M${x},${y} H${x + width} V${y + height} H${x} Z`;
+  }
+  return [
+    `M${x + r},${y}`,
+    `H${x + width - r}`,
+    `A${r},${r} 0 0 1 ${x + width},${y + r}`,
+    `V${y + height - r}`,
+    `A${r},${r} 0 0 1 ${x + width - r},${y + height}`,
+    `H${x + r}`,
+    `A${r},${r} 0 0 1 ${x},${y + height - r}`,
+    `V${y + r}`,
+    `A${r},${r} 0 0 1 ${x + r},${y}`,
+    "Z"
+  ].join(" ");
+}
+function spotlightClipPath(options) {
+  const { viewport, cutout } = options;
+  const outer = `M0,0 H${viewport.width} V${viewport.height} H0 Z`;
+  if (!cutout || cutout.width <= 0 || cutout.height <= 0) {
+    return `path(evenodd, "${outer}")`;
+  }
+  return `path(evenodd, "${outer} ${roundedRectPath(cutout)}")`;
+}
+export {
+  anchorRadius,
+  spotlightClipPath,
+  spotlightRect
+};
+//# sourceMappingURL=tour-geometry.js.map

package/dist/overlay/tour-geometry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tour-geometry.js","sources":["../../src/overlay/tour-geometry.ts"],"sourcesContent":["/**\n * Pure spotlight maths. The dim layer is one full-viewport element clipped with\n * `clip-path: path(evenodd, ...)`: the clipped-away hole does not hit-test, so\n * the dim blocks clicks while the anchor underneath stays live — the pointer\n * semantics come free, which no other cutout technique gives us (a\n * `box-shadow: 0 0 0 9999px` ring has them exactly inverted).\n */\n\nexport type Viewport = { width: number; height: number };\n\nexport type SpotlightRect = {\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n  radius: number;\n};\n\nfunction clamp(value: number, min: number, max: number): number {\n  return Math.min(Math.max(value, min), max);\n}\n\n/**\n * The anchor's own computed corner radius, so the cutout traces the control\n * rather than boxing it. A percentage radius resolves against the element's\n * width, matching how the browser paints it.\n */\nexport function anchorRadius(element: HTMLElement): number {\n  const view = element.ownerDocument.defaultView;\n  if (!view) return 0;\n  const raw = view.getComputedStyle(element).borderTopLeftRadius;\n  if (!raw) return 0;\n  if (raw.endsWith(\"%\")) {\n    const percent = Number.parseFloat(raw);\n    if (!Number.isFinite(percent)) return 0;\n    return (element.getBoundingClientRect().width * percent) / 100;\n  }\n  const px = Number.parseFloat(raw);\n  return Number.isFinite(px) ? px : 0;\n}\n\n/**\n * Anchor rect grown by `padding` and clamped to the viewport. The radius grows\n * with the padding so the cutout stays concentric with the control it traces,\n * and is capped at half the shorter side so an over-large radius cannot fold the\n * path in on itself.\n */\nexport function spotlightRect(options: {\n  anchor: DOMRect;\n  padding: number;\n  radius?: number | undefined;\n  viewport: Viewport;\n}): SpotlightRect {\n  const { anchor, padding, radius, viewport } = options;\n  const left = clamp(anchor.left - padding, 0, viewport.width);\n  const top = clamp(anchor.top - padding, 0, viewport.height);\n  const right = clamp(anchor.right + padding, 0, viewport.width);\n  const bottom = clamp(anchor.bottom + padding, 0, viewport.height);\n\n  const width = Math.max(right - left, 0);\n  const height = Math.max(bottom - top, 0);\n  const requested = radius ?? 0;\n\n  return {\n    x: left,\n    y: top,\n    width,\n    height,\n    radius: clamp(requested, 0, Math.min(width, height) / 2),\n  };\n}\n\nfunction roundedRectPath(rect: SpotlightRect): string {\n  const { x, y, width, height, radius: r } = rect;\n  if (r <= 0) {\n    return `M${x},${y} H${x + width} V${y + height} H${x} Z`;\n  }\n  return [\n    `M${x + r},${y}`,\n    `H${x + width - r}`,\n    `A${r},${r} 0 0 1 ${x + width},${y + r}`,\n    `V${y + height - r}`,\n    `A${r},${r} 0 0 1 ${x + width - r},${y + height}`,\n    `H${x + r}`,\n    `A${r},${r} 0 0 1 ${x},${y + height - r}`,\n    `V${y + r}`,\n    `A${r},${r} 0 0 1 ${x + r},${y}`,\n    \"Z\",\n  ].join(\" \");\n}\n\n/**\n * `path(evenodd, \"...\")` for the dim: the viewport rect minus a rounded cutout.\n * A missing or degenerate cutout yields the plain viewport rect, so a zero-size\n * anchor dims the page rather than emitting an invalid path the browser drops\n * (which would leave the dim uncut and the page unusable).\n */\nexport function spotlightClipPath(options: {\n  viewport: Viewport;\n  cutout: SpotlightRect | null;\n}): string {\n  const { viewport, cutout } = options;\n  const outer = `M0,0 H${viewport.width} V${viewport.height} H0 Z`;\n  if (!cutout || cutout.width <= 0 || cutout.height <= 0) {\n    return `path(evenodd, \"${outer}\")`;\n  }\n  return `path(evenodd, \"${outer} ${roundedRectPath(cutout)}\")`;\n}\n"],"names":[],"mappings":"AAkBA,SAAS,MAAM,OAAe,KAAa,KAAqB;AAC9D,SAAO,KAAK,IAAI,KAAK,IAAI,OAAO,GAAG,GAAG,GAAG;AAC3C;AAOO,SAAS,aAAa,SAA8B;AACzD,QAAM,OAAO,QAAQ,cAAc;AACnC,MAAI,CAAC,KAAM,QAAO;AAClB,QAAM,MAAM,KAAK,iBAAiB,OAAO,EAAE;AAC3C,MAAI,CAAC,IAAK,QAAO;AACjB,MAAI,IAAI,SAAS,GAAG,GAAG;AACrB,UAAM,UAAU,OAAO,WAAW,GAAG;AACrC,QAAI,CAAC,OAAO,SAAS,OAAO,EAAG,QAAO;AACtC,WAAQ,QAAQ,sBAAA,EAAwB,QAAQ,UAAW;AAAA,EAC7D;AACA,QAAM,KAAK,OAAO,WAAW,GAAG;AAChC,SAAO,OAAO,SAAS,EAAE,IAAI,KAAK;AACpC;AAQO,SAAS,cAAc,SAKZ;AAChB,QAAM,EAAE,QAAQ,SAAS,QAAQ,aAAa;AAC9C,QAAM,OAAO,MAAM,OAAO,OAAO,SAAS,GAAG,SAAS,KAAK;AAC3D,QAAM,MAAM,MAAM,OAAO,MAAM,SAAS,GAAG,SAAS,MAAM;AAC1D,QAAM,QAAQ,MAAM,OAAO,QAAQ,SAAS,GAAG,SAAS,KAAK;AAC7D,QAAM,SAAS,MAAM,OAAO,SAAS,SAAS,GAAG,SAAS,MAAM;AAEhE,QAAM,QAAQ,KAAK,IAAI,QAAQ,MAAM,CAAC;AACtC,QAAM,SAAS,KAAK,IAAI,SAAS,KAAK,CAAC;AACvC,QAAM,YAAY,UAAU;AAE5B,SAAO;AAAA,IACL,GAAG;AAAA,IACH,GAAG;AAAA,IACH;AAAA,IACA;AAAA,IACA,QAAQ,MAAM,WAAW,GAAG,KAAK,IAAI,OAAO,MAAM,IAAI,CAAC;AAAA,EAAA;AAE3D;AAEA,SAAS,gBAAgB,MAA6B;AACpD,QAAM,EAAE,GAAG,GAAG,OAAO,QAAQ,QAAQ,MAAM;AAC3C,MAAI,KAAK,GAAG;AACV,WAAO,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,KAAK,IAAI,MAAM,KAAK,CAAC;AAAA,EACtD;AACA,SAAO;AAAA,IACL,IAAI,IAAI,CAAC,IAAI,CAAC;AAAA,IACd,IAAI,IAAI,QAAQ,CAAC;AAAA,IACjB,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,KAAK,IAAI,IAAI,CAAC;AAAA,IACtC,IAAI,IAAI,SAAS,CAAC;AAAA,IAClB,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,QAAQ,CAAC,IAAI,IAAI,MAAM;AAAA,IAC/C,IAAI,IAAI,CAAC;AAAA,IACT,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,SAAS,CAAC;AAAA,IACvC,IAAI,IAAI,CAAC;AAAA,IACT,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC;AAAA,IAC9B;AAAA,EAAA,EACA,KAAK,GAAG;AACZ;AAQO,SAAS,kBAAkB,SAGvB;AACT,QAAM,EAAE,UAAU,OAAA,IAAW;AAC7B,QAAM,QAAQ,SAAS,SAAS,KAAK,KAAK,SAAS,MAAM;AACzD,MAAI,CAAC,UAAU,OAAO,SAAS,KAAK,OAAO,UAAU,GAAG;AACtD,WAAO,kBAAkB,KAAK;AAAA,EAChC;AACA,SAAO,kBAAkB,KAAK,IAAI,gBAAgB,MAAM,CAAC;AAC3D;"}

package/dist/overlay/tour-model.cjs

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const DEFAULT_TOUR_LABELS = {
+  back: "Back",
+  next: "Next",
+  done: "Done",
+  skip: "Skip tour",
+  close: "Close tour",
+  counter: (current, total) => `${current} of ${total}`,
+  announce: (current, total, title) => `Step ${current} of ${total}: ${title}`
+};
+function validateTourDefinition(definition) {
+  const where = `tour "${definition.id}"`;
+  if (!definition.id) throw new Error("Tour definition is missing an id");
+  if (definition.steps.length === 0) throw new Error(`${where} has no steps`);
+  if (definition.version !== void 0 && definition.version < 1) {
+    throw new Error(`${where} has version ${definition.version}; versions start at 1`);
+  }
+  const seen = /* @__PURE__ */ new Set();
+  for (const step of definition.steps) {
+    if (!step.id) throw new Error(`${where} has a step with no id`);
+    if (seen.has(step.id)) throw new Error(`${where} has duplicate step id "${step.id}"`);
+    seen.add(step.id);
+    if (step.body !== void 0 && step.markdown !== void 0) {
+      throw new Error(`${where} step "${step.id}" sets both body and markdown; pick one`);
+    }
+  }
+}
+function isEnabled(step) {
+  return step.enabled ? step.enabled() : true;
+}
+function activeSteps(steps) {
+  return steps.filter(isEnabled);
+}
+function seekEnabledIndex(steps, from, direction) {
+  const delta = direction === "next" ? 1 : -1;
+  for (let index = from; index >= 0 && index < steps.length; index += delta) {
+    const step = steps[index];
+    if (step && isEnabled(step)) return index;
+  }
+  return null;
+}
+function nextStepIndex(steps, from, direction) {
+  return seekEnabledIndex(steps, direction === "next" ? from + 1 : from - 1, direction);
+}
+function resolveStepIndex(steps, at) {
+  if (typeof at === "number") {
+    if (at < 0 || at >= steps.length) {
+      throw new Error(`Tour step index ${at} is out of range (0..${steps.length - 1})`);
+    }
+    return at;
+  }
+  const index = steps.findIndex((step) => step.id === at);
+  if (index === -1) throw new Error(`Unknown tour step id "${at}"`);
+  return index;
+}
+function displayPosition(steps, index) {
+  let position = 0;
+  for (let cursor = 0; cursor <= index && cursor < steps.length; cursor += 1) {
+    const step = steps[cursor];
+    if (step && isEnabled(step)) position += 1;
+  }
+  return Math.max(position, 1);
+}
+function describeTarget(target) {
+  if (target === void 0) return "(none)";
+  if (typeof target === "string") return target;
+  if (typeof target === "function") return "(resolver)";
+  return `<${target.tagName.toLowerCase()}>`;
+}
+exports.DEFAULT_TOUR_LABELS = DEFAULT_TOUR_LABELS;
+exports.activeSteps = activeSteps;
+exports.describeTarget = describeTarget;
+exports.displayPosition = displayPosition;
+exports.nextStepIndex = nextStepIndex;
+exports.resolveStepIndex = resolveStepIndex;
+exports.seekEnabledIndex = seekEnabledIndex;
+exports.validateTourDefinition = validateTourDefinition;
+//# sourceMappingURL=tour-model.cjs.map

package/dist/overlay/tour-model.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tour-model.cjs","sources":["../../src/overlay/tour-model.ts"],"sourcesContent":["import type { TourDefinition, TourLabels, TourStep, TourTarget } from \"./tour-types\";\n\n/**\n * Pure sequencing for a tour: validation, step arithmetic, and default copy. No\n * DOM and no React, so the whole traversal is testable without rendering — the\n * counter and skip rules are where the subtle bugs live.\n */\n\nexport const DEFAULT_TOUR_LABELS: TourLabels = {\n  back: \"Back\",\n  next: \"Next\",\n  done: \"Done\",\n  skip: \"Skip tour\",\n  close: \"Close tour\",\n  counter: (current, total) => `${current} of ${total}`,\n  announce: (current, total, title) => `Step ${current} of ${total}: ${title}`,\n};\n\n/**\n * Rejects a definition that cannot run, at registration rather than mid-render in\n * front of a user. Duplicate ids are fatal because `goTo` and the persistence key\n * both address steps by id.\n */\nexport function validateTourDefinition(definition: TourDefinition): void {\n  const where = `tour \"${definition.id}\"`;\n  if (!definition.id) throw new Error(\"Tour definition is missing an id\");\n  if (definition.steps.length === 0) throw new Error(`${where} has no steps`);\n  if (definition.version !== undefined && definition.version < 1) {\n    throw new Error(`${where} has version ${definition.version}; versions start at 1`);\n  }\n\n  const seen = new Set<string>();\n  for (const step of definition.steps) {\n    if (!step.id) throw new Error(`${where} has a step with no id`);\n    if (seen.has(step.id)) throw new Error(`${where} has duplicate step id \"${step.id}\"`);\n    seen.add(step.id);\n    if (step.body !== undefined && step.markdown !== undefined) {\n      throw new Error(`${where} step \"${step.id}\" sets both body and markdown; pick one`);\n    }\n  }\n}\n\nfunction isEnabled(step: TourStep): boolean {\n  return step.enabled ? step.enabled() : true;\n}\n\n/** Steps whose `enabled()` passes — the denominator for \"2 of 6\". */\nexport function activeSteps(steps: TourStep[]): TourStep[] {\n  return steps.filter(isEnabled);\n}\n\n/**\n * Index of the first enabled step at or after `from` when moving forward, or at\n * or before it when moving back. `null` means the tour has run off that end.\n */\nexport function seekEnabledIndex(\n  steps: TourStep[],\n  from: number,\n  direction: \"next\" | \"back\",\n): number | null {\n  const delta = direction === \"next\" ? 1 : -1;\n  for (let index = from; index >= 0 && index < steps.length; index += delta) {\n    const step = steps[index];\n    if (step && isEnabled(step)) return index;\n  }\n  return null;\n}\n\n/** Next/previous enabled index, skipping the step at `from`. `null` past either end. */\nexport function nextStepIndex(\n  steps: TourStep[],\n  from: number,\n  direction: \"next\" | \"back\",\n): number | null {\n  return seekEnabledIndex(steps, direction === \"next\" ? from + 1 : from - 1, direction);\n}\n\n/** Resolve a step id or raw index to a raw index, throwing on an unknown id. */\nexport function resolveStepIndex(steps: TourStep[], at: string | number): number {\n  if (typeof at === \"number\") {\n    if (at < 0 || at >= steps.length) {\n      throw new Error(`Tour step index ${at} is out of range (0..${steps.length - 1})`);\n    }\n    return at;\n  }\n  const index = steps.findIndex((step) => step.id === at);\n  if (index === -1) throw new Error(`Unknown tour step id \"${at}\"`);\n  return index;\n}\n\n/** 1-based position of a raw index among the enabled steps, for the counter. */\nexport function displayPosition(steps: TourStep[], index: number): number {\n  let position = 0;\n  for (let cursor = 0; cursor <= index && cursor < steps.length; cursor += 1) {\n    const step = steps[cursor];\n    if (step && isEnabled(step)) position += 1;\n  }\n  return Math.max(position, 1);\n}\n\n/** Human-readable target, for warnings and `TourStepErrorInfo.target`. */\nexport function describeTarget(target: TourTarget | undefined): string {\n  if (target === undefined) return \"(none)\";\n  if (typeof target === \"string\") return target;\n  if (typeof target === \"function\") return \"(resolver)\";\n  return `<${target.tagName.toLowerCase()}>`;\n}\n"],"names":[],"mappings":";;AAQO,MAAM,sBAAkC;AAAA,EAC7C,MAAM;AAAA,EACN,MAAM;AAAA,EACN,MAAM;AAAA,EACN,MAAM;AAAA,EACN,OAAO;AAAA,EACP,SAAS,CAAC,SAAS,UAAU,GAAG,OAAO,OAAO,KAAK;AAAA,EACnD,UAAU,CAAC,SAAS,OAAO,UAAU,QAAQ,OAAO,OAAO,KAAK,KAAK,KAAK;AAC5E;AAOO,SAAS,uBAAuB,YAAkC;AACvE,QAAM,QAAQ,SAAS,WAAW,EAAE;AACpC,MAAI,CAAC,WAAW,GAAI,OAAM,IAAI,MAAM,kCAAkC;AACtE,MAAI,WAAW,MAAM,WAAW,SAAS,IAAI,MAAM,GAAG,KAAK,eAAe;AAC1E,MAAI,WAAW,YAAY,UAAa,WAAW,UAAU,GAAG;AAC9D,UAAM,IAAI,MAAM,GAAG,KAAK,gBAAgB,WAAW,OAAO,uBAAuB;AAAA,EACnF;AAEA,QAAM,2BAAW,IAAA;AACjB,aAAW,QAAQ,WAAW,OAAO;AACnC,QAAI,CAAC,KAAK,GAAI,OAAM,IAAI,MAAM,GAAG,KAAK,wBAAwB;AAC9D,QAAI,KAAK,IAAI,KAAK,EAAE,EAAG,OAAM,IAAI,MAAM,GAAG,KAAK,2BAA2B,KAAK,EAAE,GAAG;AACpF,SAAK,IAAI,KAAK,EAAE;AAChB,QAAI,KAAK,SAAS,UAAa,KAAK,aAAa,QAAW;AAC1D,YAAM,IAAI,MAAM,GAAG,KAAK,UAAU,KAAK,EAAE,yCAAyC;AAAA,IACpF;AAAA,EACF;AACF;AAEA,SAAS,UAAU,MAAyB;AAC1C,SAAO,KAAK,UAAU,KAAK,QAAA,IAAY;AACzC;AAGO,SAAS,YAAY,OAA+B;AACzD,SAAO,MAAM,OAAO,SAAS;AAC/B;AAMO,SAAS,iBACd,OACA,MACA,WACe;AACf,QAAM,QAAQ,cAAc,SAAS,IAAI;AACzC,WAAS,QAAQ,MAAM,SAAS,KAAK,QAAQ,MAAM,QAAQ,SAAS,OAAO;AACzE,UAAM,OAAO,MAAM,KAAK;AACxB,QAAI,QAAQ,UAAU,IAAI,EAAG,QAAO;AAAA,EACtC;AACA,SAAO;AACT;AAGO,SAAS,cACd,OACA,MACA,WACe;AACf,SAAO,iBAAiB,OAAO,cAAc,SAAS,OAAO,IAAI,OAAO,GAAG,SAAS;AACtF;AAGO,SAAS,iBAAiB,OAAmB,IAA6B;AAC/E,MAAI,OAAO,OAAO,UAAU;AAC1B,QAAI,KAAK,KAAK,MAAM,MAAM,QAAQ;AAChC,YAAM,IAAI,MAAM,mBAAmB,EAAE,wBAAwB,MAAM,SAAS,CAAC,GAAG;AAAA,IAClF;AACA,WAAO;AAAA,EACT;AACA,QAAM,QAAQ,MAAM,UAAU,CAAC,SAAS,KAAK,OAAO,EAAE;AACtD,MAAI,UAAU,GAAI,OAAM,IAAI,MAAM,yBAAyB,EAAE,GAAG;AAChE,SAAO;AACT;AAGO,SAAS,gBAAgB,OAAmB,OAAuB;AACxE,MAAI,WAAW;AACf,WAAS,SAAS,GAAG,UAAU,SAAS,SAAS,MAAM,QAAQ,UAAU,GAAG;AAC1E,UAAM,OAAO,MAAM,MAAM;AACzB,QAAI,QAAQ,UAAU,IAAI,EAAG,aAAY;AAAA,EAC3C;AACA,SAAO,KAAK,IAAI,UAAU,CAAC;AAC7B;AAGO,SAAS,eAAe,QAAwC;AACrE,MAAI,WAAW,OAAW,QAAO;AACjC,MAAI,OAAO,WAAW,SAAU,QAAO;AACvC,MAAI,OAAO,WAAW,WAAY,QAAO;AACzC,SAAO,IAAI,OAAO,QAAQ,YAAA,CAAa;AACzC;;;;;;;;;"}

package/dist/overlay/tour-model.d.ts

@@ -0,0 +1,29 @@
+import { TourDefinition, TourLabels, TourStep, TourTarget } from './tour-types';
+/**
+ * Pure sequencing for a tour: validation, step arithmetic, and default copy. No
+ * DOM and no React, so the whole traversal is testable without rendering — the
+ * counter and skip rules are where the subtle bugs live.
+ */
+export declare const DEFAULT_TOUR_LABELS: TourLabels;
+/**
+ * Rejects a definition that cannot run, at registration rather than mid-render in
+ * front of a user. Duplicate ids are fatal because `goTo` and the persistence key
+ * both address steps by id.
+ */
+export declare function validateTourDefinition(definition: TourDefinition): void;
+/** Steps whose `enabled()` passes — the denominator for "2 of 6". */
+export declare function activeSteps(steps: TourStep[]): TourStep[];
+/**
+ * Index of the first enabled step at or after `from` when moving forward, or at
+ * or before it when moving back. `null` means the tour has run off that end.
+ */
+export declare function seekEnabledIndex(steps: TourStep[], from: number, direction: "next" | "back"): number | null;
+/** Next/previous enabled index, skipping the step at `from`. `null` past either end. */
+export declare function nextStepIndex(steps: TourStep[], from: number, direction: "next" | "back"): number | null;
+/** Resolve a step id or raw index to a raw index, throwing on an unknown id. */
+export declare function resolveStepIndex(steps: TourStep[], at: string | number): number;
+/** 1-based position of a raw index among the enabled steps, for the counter. */
+export declare function displayPosition(steps: TourStep[], index: number): number;
+/** Human-readable target, for warnings and `TourStepErrorInfo.target`. */
+export declare function describeTarget(target: TourTarget | undefined): string;
+//# sourceMappingURL=tour-model.d.ts.map

package/dist/overlay/tour-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tour-model.d.ts","sourceRoot":"","sources":["../../src/overlay/tour-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAErF;;;;GAIG;AAEH,eAAO,MAAM,mBAAmB,EAAE,UAQjC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI,CAiBvE;AAMD,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAEzD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,QAAQ,EAAE,EACjB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAAG,MAAM,GACzB,MAAM,GAAG,IAAI,CAOf;AAED,wFAAwF;AACxF,wBAAgB,aAAa,CAC3B,KAAK,EAAE,QAAQ,EAAE,EACjB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAAG,MAAM,GACzB,MAAM,GAAG,IAAI,CAEf;AAED,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAU/E;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAOxE;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,CAKrE"}

package/dist/overlay/tour-model.js

@@ -0,0 +1,79 @@
+const DEFAULT_TOUR_LABELS = {
+  back: "Back",
+  next: "Next",
+  done: "Done",
+  skip: "Skip tour",
+  close: "Close tour",
+  counter: (current, total) => `${current} of ${total}`,
+  announce: (current, total, title) => `Step ${current} of ${total}: ${title}`
+};
+function validateTourDefinition(definition) {
+  const where = `tour "${definition.id}"`;
+  if (!definition.id) throw new Error("Tour definition is missing an id");
+  if (definition.steps.length === 0) throw new Error(`${where} has no steps`);
+  if (definition.version !== void 0 && definition.version < 1) {
+    throw new Error(`${where} has version ${definition.version}; versions start at 1`);
+  }
+  const seen = /* @__PURE__ */ new Set();
+  for (const step of definition.steps) {
+    if (!step.id) throw new Error(`${where} has a step with no id`);
+    if (seen.has(step.id)) throw new Error(`${where} has duplicate step id "${step.id}"`);
+    seen.add(step.id);
+    if (step.body !== void 0 && step.markdown !== void 0) {
+      throw new Error(`${where} step "${step.id}" sets both body and markdown; pick one`);
+    }
+  }
+}
+function isEnabled(step) {
+  return step.enabled ? step.enabled() : true;
+}
+function activeSteps(steps) {
+  return steps.filter(isEnabled);
+}
+function seekEnabledIndex(steps, from, direction) {
+  const delta = direction === "next" ? 1 : -1;
+  for (let index = from; index >= 0 && index < steps.length; index += delta) {
+    const step = steps[index];
+    if (step && isEnabled(step)) return index;
+  }
+  return null;
+}
+function nextStepIndex(steps, from, direction) {
+  return seekEnabledIndex(steps, direction === "next" ? from + 1 : from - 1, direction);
+}
+function resolveStepIndex(steps, at) {
+  if (typeof at === "number") {
+    if (at < 0 || at >= steps.length) {
+      throw new Error(`Tour step index ${at} is out of range (0..${steps.length - 1})`);
+    }
+    return at;
+  }
+  const index = steps.findIndex((step) => step.id === at);
+  if (index === -1) throw new Error(`Unknown tour step id "${at}"`);
+  return index;
+}
+function displayPosition(steps, index) {
+  let position = 0;
+  for (let cursor = 0; cursor <= index && cursor < steps.length; cursor += 1) {
+    const step = steps[cursor];
+    if (step && isEnabled(step)) position += 1;
+  }
+  return Math.max(position, 1);
+}
+function describeTarget(target) {
+  if (target === void 0) return "(none)";
+  if (typeof target === "string") return target;
+  if (typeof target === "function") return "(resolver)";
+  return `<${target.tagName.toLowerCase()}>`;
+}
+export {
+  DEFAULT_TOUR_LABELS,
+  activeSteps,
+  describeTarget,
+  displayPosition,
+  nextStepIndex,
+  resolveStepIndex,
+  seekEnabledIndex,
+  validateTourDefinition
+};
+//# sourceMappingURL=tour-model.js.map

package/dist/overlay/tour-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tour-model.js","sources":["../../src/overlay/tour-model.ts"],"sourcesContent":["import type { TourDefinition, TourLabels, TourStep, TourTarget } from \"./tour-types\";\n\n/**\n * Pure sequencing for a tour: validation, step arithmetic, and default copy. No\n * DOM and no React, so the whole traversal is testable without rendering — the\n * counter and skip rules are where the subtle bugs live.\n */\n\nexport const DEFAULT_TOUR_LABELS: TourLabels = {\n  back: \"Back\",\n  next: \"Next\",\n  done: \"Done\",\n  skip: \"Skip tour\",\n  close: \"Close tour\",\n  counter: (current, total) => `${current} of ${total}`,\n  announce: (current, total, title) => `Step ${current} of ${total}: ${title}`,\n};\n\n/**\n * Rejects a definition that cannot run, at registration rather than mid-render in\n * front of a user. Duplicate ids are fatal because `goTo` and the persistence key\n * both address steps by id.\n */\nexport function validateTourDefinition(definition: TourDefinition): void {\n  const where = `tour \"${definition.id}\"`;\n  if (!definition.id) throw new Error(\"Tour definition is missing an id\");\n  if (definition.steps.length === 0) throw new Error(`${where} has no steps`);\n  if (definition.version !== undefined && definition.version < 1) {\n    throw new Error(`${where} has version ${definition.version}; versions start at 1`);\n  }\n\n  const seen = new Set<string>();\n  for (const step of definition.steps) {\n    if (!step.id) throw new Error(`${where} has a step with no id`);\n    if (seen.has(step.id)) throw new Error(`${where} has duplicate step id \"${step.id}\"`);\n    seen.add(step.id);\n    if (step.body !== undefined && step.markdown !== undefined) {\n      throw new Error(`${where} step \"${step.id}\" sets both body and markdown; pick one`);\n    }\n  }\n}\n\nfunction isEnabled(step: TourStep): boolean {\n  return step.enabled ? step.enabled() : true;\n}\n\n/** Steps whose `enabled()` passes — the denominator for \"2 of 6\". */\nexport function activeSteps(steps: TourStep[]): TourStep[] {\n  return steps.filter(isEnabled);\n}\n\n/**\n * Index of the first enabled step at or after `from` when moving forward, or at\n * or before it when moving back. `null` means the tour has run off that end.\n */\nexport function seekEnabledIndex(\n  steps: TourStep[],\n  from: number,\n  direction: \"next\" | \"back\",\n): number | null {\n  const delta = direction === \"next\" ? 1 : -1;\n  for (let index = from; index >= 0 && index < steps.length; index += delta) {\n    const step = steps[index];\n    if (step && isEnabled(step)) return index;\n  }\n  return null;\n}\n\n/** Next/previous enabled index, skipping the step at `from`. `null` past either end. */\nexport function nextStepIndex(\n  steps: TourStep[],\n  from: number,\n  direction: \"next\" | \"back\",\n): number | null {\n  return seekEnabledIndex(steps, direction === \"next\" ? from + 1 : from - 1, direction);\n}\n\n/** Resolve a step id or raw index to a raw index, throwing on an unknown id. */\nexport function resolveStepIndex(steps: TourStep[], at: string | number): number {\n  if (typeof at === \"number\") {\n    if (at < 0 || at >= steps.length) {\n      throw new Error(`Tour step index ${at} is out of range (0..${steps.length - 1})`);\n    }\n    return at;\n  }\n  const index = steps.findIndex((step) => step.id === at);\n  if (index === -1) throw new Error(`Unknown tour step id \"${at}\"`);\n  return index;\n}\n\n/** 1-based position of a raw index among the enabled steps, for the counter. */\nexport function displayPosition(steps: TourStep[], index: number): number {\n  let position = 0;\n  for (let cursor = 0; cursor <= index && cursor < steps.length; cursor += 1) {\n    const step = steps[cursor];\n    if (step && isEnabled(step)) position += 1;\n  }\n  return Math.max(position, 1);\n}\n\n/** Human-readable target, for warnings and `TourStepErrorInfo.target`. */\nexport function describeTarget(target: TourTarget | undefined): string {\n  if (target === undefined) return \"(none)\";\n  if (typeof target === \"string\") return target;\n  if (typeof target === \"function\") return \"(resolver)\";\n  return `<${target.tagName.toLowerCase()}>`;\n}\n"],"names":[],"mappings":"AAQO,MAAM,sBAAkC;AAAA,EAC7C,MAAM;AAAA,EACN,MAAM;AAAA,EACN,MAAM;AAAA,EACN,MAAM;AAAA,EACN,OAAO;AAAA,EACP,SAAS,CAAC,SAAS,UAAU,GAAG,OAAO,OAAO,KAAK;AAAA,EACnD,UAAU,CAAC,SAAS,OAAO,UAAU,QAAQ,OAAO,OAAO,KAAK,KAAK,KAAK;AAC5E;AAOO,SAAS,uBAAuB,YAAkC;AACvE,QAAM,QAAQ,SAAS,WAAW,EAAE;AACpC,MAAI,CAAC,WAAW,GAAI,OAAM,IAAI,MAAM,kCAAkC;AACtE,MAAI,WAAW,MAAM,WAAW,SAAS,IAAI,MAAM,GAAG,KAAK,eAAe;AAC1E,MAAI,WAAW,YAAY,UAAa,WAAW,UAAU,GAAG;AAC9D,UAAM,IAAI,MAAM,GAAG,KAAK,gBAAgB,WAAW,OAAO,uBAAuB;AAAA,EACnF;AAEA,QAAM,2BAAW,IAAA;AACjB,aAAW,QAAQ,WAAW,OAAO;AACnC,QAAI,CAAC,KAAK,GAAI,OAAM,IAAI,MAAM,GAAG,KAAK,wBAAwB;AAC9D,QAAI,KAAK,IAAI,KAAK,EAAE,EAAG,OAAM,IAAI,MAAM,GAAG,KAAK,2BAA2B,KAAK,EAAE,GAAG;AACpF,SAAK,IAAI,KAAK,EAAE;AAChB,QAAI,KAAK,SAAS,UAAa,KAAK,aAAa,QAAW;AAC1D,YAAM,IAAI,MAAM,GAAG,KAAK,UAAU,KAAK,EAAE,yCAAyC;AAAA,IACpF;AAAA,EACF;AACF;AAEA,SAAS,UAAU,MAAyB;AAC1C,SAAO,KAAK,UAAU,KAAK,QAAA,IAAY;AACzC;AAGO,SAAS,YAAY,OAA+B;AACzD,SAAO,MAAM,OAAO,SAAS;AAC/B;AAMO,SAAS,iBACd,OACA,MACA,WACe;AACf,QAAM,QAAQ,cAAc,SAAS,IAAI;AACzC,WAAS,QAAQ,MAAM,SAAS,KAAK,QAAQ,MAAM,QAAQ,SAAS,OAAO;AACzE,UAAM,OAAO,MAAM,KAAK;AACxB,QAAI,QAAQ,UAAU,IAAI,EAAG,QAAO;AAAA,EACtC;AACA,SAAO;AACT;AAGO,SAAS,cACd,OACA,MACA,WACe;AACf,SAAO,iBAAiB,OAAO,cAAc,SAAS,OAAO,IAAI,OAAO,GAAG,SAAS;AACtF;AAGO,SAAS,iBAAiB,OAAmB,IAA6B;AAC/E,MAAI,OAAO,OAAO,UAAU;AAC1B,QAAI,KAAK,KAAK,MAAM,MAAM,QAAQ;AAChC,YAAM,IAAI,MAAM,mBAAmB,EAAE,wBAAwB,MAAM,SAAS,CAAC,GAAG;AAAA,IAClF;AACA,WAAO;AAAA,EACT;AACA,QAAM,QAAQ,MAAM,UAAU,CAAC,SAAS,KAAK,OAAO,EAAE;AACtD,MAAI,UAAU,GAAI,OAAM,IAAI,MAAM,yBAAyB,EAAE,GAAG;AAChE,SAAO;AACT;AAGO,SAAS,gBAAgB,OAAmB,OAAuB;AACxE,MAAI,WAAW;AACf,WAAS,SAAS,GAAG,UAAU,SAAS,SAAS,MAAM,QAAQ,UAAU,GAAG;AAC1E,UAAM,OAAO,MAAM,MAAM;AACzB,QAAI,QAAQ,UAAU,IAAI,EAAG,aAAY;AAAA,EAC3C;AACA,SAAO,KAAK,IAAI,UAAU,CAAC;AAC7B;AAGO,SAAS,eAAe,QAAwC;AACrE,MAAI,WAAW,OAAW,QAAO;AACjC,MAAI,OAAO,WAAW,SAAU,QAAO;AACvC,MAAI,OAAO,WAAW,WAAY,QAAO;AACzC,SAAO,IAAI,OAAO,QAAQ,YAAA,CAAa;AACzC;"}

package/dist/overlay/tour-progress.cjs

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const DEFAULT_KEY = "clicky-ui-tours";
+function isCompletion(value) {
+  if (!value || typeof value !== "object") return false;
+  const entry = value;
+  return typeof entry.tourId === "string" && (entry.status === "completed" || entry.status === "dismissed") && typeof entry.version === "number";
+}
+function localStorageTourStorage(key = DEFAULT_KEY) {
+  const load = () => {
+    if (typeof localStorage === "undefined") return [];
+    try {
+      const raw = localStorage.getItem(key);
+      if (!raw) return [];
+      const parsed = JSON.parse(raw);
+      return Array.isArray(parsed) ? parsed.filter(isCompletion) : [];
+    } catch {
+      return [];
+    }
+  };
+  const save = (entries) => {
+    if (typeof localStorage === "undefined") return;
+    try {
+      localStorage.setItem(key, JSON.stringify(entries));
+    } catch {
+    }
+  };
+  return {
+    read: load,
+    write: (entry) => save([...load().filter((e) => e.tourId !== entry.tourId), entry]),
+    clear: (tourId) => save(tourId ? load().filter((e) => e.tourId !== tourId) : [])
+  };
+}
+function memoryTourStorage(seed = []) {
+  let entries = [...seed];
+  return {
+    read: () => entries,
+    write: (entry) => {
+      entries = [...entries.filter((e) => e.tourId !== entry.tourId), entry];
+    },
+    clear: (tourId) => {
+      entries = tourId ? entries.filter((e) => e.tourId !== tourId) : [];
+    }
+  };
+}
+function isTourFinished(completions, definition) {
+  const entry = completions.find((completion) => completion.tourId === definition.id);
+  if (!entry) return false;
+  return entry.version >= (definition.version ?? 1);
+}
+exports.isTourFinished = isTourFinished;
+exports.localStorageTourStorage = localStorageTourStorage;
+exports.memoryTourStorage = memoryTourStorage;
+//# sourceMappingURL=tour-progress.cjs.map

package/dist/overlay/tour-progress.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tour-progress.cjs","sources":["../../src/overlay/tour-progress.ts"],"sourcesContent":["import type { TourDefinition } from \"./tour-types\";\n\n/**\n * Completion persistence for tours.\n *\n * The default is a localStorage store so the zero-config path works, but the\n * seam is an adapter rather than a boolean because completion is *user* state,\n * not device state: someone who signs in on a second machine should not re-see a\n * first-run tour, and an admin may want to reset one for a whole org. Both are\n * expressible as a `TourStorage`; neither is expressible as \"the library owns\n * localStorage\" or as a bare `completed` prop.\n */\n\nexport type TourCompletionStatus = \"completed\" | \"dismissed\";\n\nexport type TourCompletion = {\n  tourId: string;\n  status: TourCompletionStatus;\n  /** The definition `version` this was recorded against. */\n  version: number;\n  /** ISO timestamp. */\n  at: string;\n};\n\nexport type TourStorage = {\n  read: () => TourCompletion[] | Promise<TourCompletion[]>;\n  write: (entry: TourCompletion) => void | Promise<void>;\n  clear: (tourId?: string) => void | Promise<void>;\n};\n\nconst DEFAULT_KEY = \"clicky-ui-tours\";\n\nfunction isCompletion(value: unknown): value is TourCompletion {\n  if (!value || typeof value !== \"object\") return false;\n  const entry = value as Partial<TourCompletion>;\n  return (\n    typeof entry.tourId === \"string\" &&\n    (entry.status === \"completed\" || entry.status === \"dismissed\") &&\n    typeof entry.version === \"number\"\n  );\n}\n\n/**\n * localStorage-backed store, keyed like `clicky-ui-theme` / `clicky-ui-density`.\n * A corrupt or unreadable value reads as \"nothing recorded\" — the cost of being\n * wrong is re-offering a tour, so refusing to boot over it would be worse.\n */\nexport function localStorageTourStorage(key: string = DEFAULT_KEY): TourStorage {\n  const load = (): TourCompletion[] => {\n    if (typeof localStorage === \"undefined\") return [];\n    try {\n      const raw = localStorage.getItem(key);\n      if (!raw) return [];\n      const parsed: unknown = JSON.parse(raw);\n      return Array.isArray(parsed) ? parsed.filter(isCompletion) : [];\n    } catch {\n      return [];\n    }\n  };\n\n  const save = (entries: TourCompletion[]) => {\n    if (typeof localStorage === \"undefined\") return;\n    try {\n      localStorage.setItem(key, JSON.stringify(entries));\n    } catch {\n      // A full or blocked quota must not break the tour that just finished.\n    }\n  };\n\n  return {\n    read: load,\n    write: (entry) => save([...load().filter((e) => e.tourId !== entry.tourId), entry]),\n    clear: (tourId) => save(tourId ? load().filter((e) => e.tourId !== tourId) : []),\n  };\n}\n\n/** In-memory store, for tests, stories, and embedded/mocked renderings. */\nexport function memoryTourStorage(seed: TourCompletion[] = []): TourStorage {\n  let entries = [...seed];\n  return {\n    read: () => entries,\n    write: (entry) => {\n      entries = [...entries.filter((e) => e.tourId !== entry.tourId), entry];\n    },\n    clear: (tourId) => {\n      entries = tourId ? entries.filter((e) => e.tourId !== tourId) : [];\n    },\n  };\n}\n\n/**\n * True when a recorded completion still covers the definition's current version.\n * Bumping `version` on a reworked tour makes prior completions stale, so it is\n * offered again with no migration step.\n */\nexport function isTourFinished(\n  completions: TourCompletion[],\n  definition: TourDefinition,\n): boolean {\n  const entry = completions.find((completion) => completion.tourId === definition.id);\n  if (!entry) return false;\n  return entry.version >= (definition.version ?? 1);\n}\n"],"names":[],"mappings":";;AA8BA,MAAM,cAAc;AAEpB,SAAS,aAAa,OAAyC;AAC7D,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,QAAM,QAAQ;AACd,SACE,OAAO,MAAM,WAAW,aACvB,MAAM,WAAW,eAAe,MAAM,WAAW,gBAClD,OAAO,MAAM,YAAY;AAE7B;AAOO,SAAS,wBAAwB,MAAc,aAA0B;AAC9E,QAAM,OAAO,MAAwB;AACnC,QAAI,OAAO,iBAAiB,YAAa,QAAO,CAAA;AAChD,QAAI;AACF,YAAM,MAAM,aAAa,QAAQ,GAAG;AACpC,UAAI,CAAC,IAAK,QAAO,CAAA;AACjB,YAAM,SAAkB,KAAK,MAAM,GAAG;AACtC,aAAO,MAAM,QAAQ,MAAM,IAAI,OAAO,OAAO,YAAY,IAAI,CAAA;AAAA,IAC/D,QAAQ;AACN,aAAO,CAAA;AAAA,IACT;AAAA,EACF;AAEA,QAAM,OAAO,CAAC,YAA8B;AAC1C,QAAI,OAAO,iBAAiB,YAAa;AACzC,QAAI;AACF,mBAAa,QAAQ,KAAK,KAAK,UAAU,OAAO,CAAC;AAAA,IACnD,QAAQ;AAAA,IAER;AAAA,EACF;AAEA,SAAO;AAAA,IACL,MAAM;AAAA,IACN,OAAO,CAAC,UAAU,KAAK,CAAC,GAAG,KAAA,EAAO,OAAO,CAAC,MAAM,EAAE,WAAW,MAAM,MAAM,GAAG,KAAK,CAAC;AAAA,IAClF,OAAO,CAAC,WAAW,KAAK,SAAS,KAAA,EAAO,OAAO,CAAC,MAAM,EAAE,WAAW,MAAM,IAAI,CAAA,CAAE;AAAA,EAAA;AAEnF;AAGO,SAAS,kBAAkB,OAAyB,IAAiB;AAC1E,MAAI,UAAU,CAAC,GAAG,IAAI;AACtB,SAAO;AAAA,IACL,MAAM,MAAM;AAAA,IACZ,OAAO,CAAC,UAAU;AAChB,gBAAU,CAAC,GAAG,QAAQ,OAAO,CAAC,MAAM,EAAE,WAAW,MAAM,MAAM,GAAG,KAAK;AAAA,IACvE;AAAA,IACA,OAAO,CAAC,WAAW;AACjB,gBAAU,SAAS,QAAQ,OAAO,CAAC,MAAM,EAAE,WAAW,MAAM,IAAI,CAAA;AAAA,IAClE;AAAA,EAAA;AAEJ;AAOO,SAAS,eACd,aACA,YACS;AACT,QAAM,QAAQ,YAAY,KAAK,CAAC,eAAe,WAAW,WAAW,WAAW,EAAE;AAClF,MAAI,CAAC,MAAO,QAAO;AACnB,SAAO,MAAM,YAAY,WAAW,WAAW;AACjD;;;;"}

package/dist/overlay/tour-progress.d.ts

@@ -0,0 +1,40 @@
+import { TourDefinition } from './tour-types';
+/**
+ * Completion persistence for tours.
+ *
+ * The default is a localStorage store so the zero-config path works, but the
+ * seam is an adapter rather than a boolean because completion is *user* state,
+ * not device state: someone who signs in on a second machine should not re-see a
+ * first-run tour, and an admin may want to reset one for a whole org. Both are
+ * expressible as a `TourStorage`; neither is expressible as "the library owns
+ * localStorage" or as a bare `completed` prop.
+ */
+export type TourCompletionStatus = "completed" | "dismissed";
+export type TourCompletion = {
+    tourId: string;
+    status: TourCompletionStatus;
+    /** The definition `version` this was recorded against. */
+    version: number;
+    /** ISO timestamp. */
+    at: string;
+};
+export type TourStorage = {
+    read: () => TourCompletion[] | Promise<TourCompletion[]>;
+    write: (entry: TourCompletion) => void | Promise<void>;
+    clear: (tourId?: string) => void | Promise<void>;
+};
+/**
+ * localStorage-backed store, keyed like `clicky-ui-theme` / `clicky-ui-density`.
+ * A corrupt or unreadable value reads as "nothing recorded" — the cost of being
+ * wrong is re-offering a tour, so refusing to boot over it would be worse.
+ */
+export declare function localStorageTourStorage(key?: string): TourStorage;
+/** In-memory store, for tests, stories, and embedded/mocked renderings. */
+export declare function memoryTourStorage(seed?: TourCompletion[]): TourStorage;
+/**
+ * True when a recorded completion still covers the definition's current version.
+ * Bumping `version` on a reworked tour makes prior completions stale, so it is
+ * offered again with no migration step.
+ */
+export declare function isTourFinished(completions: TourCompletion[], definition: TourDefinition): boolean;
+//# sourceMappingURL=tour-progress.d.ts.map

package/dist/overlay/tour-progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tour-progress.d.ts","sourceRoot":"","sources":["../../src/overlay/tour-progress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD;;;;;;;;;GASG;AAEH,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,WAAW,CAAC;AAE7D,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,oBAAoB,CAAC;IAC7B,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,cAAc,EAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IACzD,KAAK,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD,CAAC;AAcF;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,GAAE,MAAoB,GAAG,WAAW,CA2B9E;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,cAAc,EAAO,GAAG,WAAW,CAW1E;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,cAAc,EAAE,EAC7B,UAAU,EAAE,cAAc,GACzB,OAAO,CAIT"}

package/dist/overlay/tour-progress.js

@@ -0,0 +1,54 @@
+const DEFAULT_KEY = "clicky-ui-tours";
+function isCompletion(value) {
+  if (!value || typeof value !== "object") return false;
+  const entry = value;
+  return typeof entry.tourId === "string" && (entry.status === "completed" || entry.status === "dismissed") && typeof entry.version === "number";
+}
+function localStorageTourStorage(key = DEFAULT_KEY) {
+  const load = () => {
+    if (typeof localStorage === "undefined") return [];
+    try {
+      const raw = localStorage.getItem(key);
+      if (!raw) return [];
+      const parsed = JSON.parse(raw);
+      return Array.isArray(parsed) ? parsed.filter(isCompletion) : [];
+    } catch {
+      return [];
+    }
+  };
+  const save = (entries) => {
+    if (typeof localStorage === "undefined") return;
+    try {
+      localStorage.setItem(key, JSON.stringify(entries));
+    } catch {
+    }
+  };
+  return {
+    read: load,
+    write: (entry) => save([...load().filter((e) => e.tourId !== entry.tourId), entry]),
+    clear: (tourId) => save(tourId ? load().filter((e) => e.tourId !== tourId) : [])
+  };
+}
+function memoryTourStorage(seed = []) {
+  let entries = [...seed];
+  return {
+    read: () => entries,
+    write: (entry) => {
+      entries = [...entries.filter((e) => e.tourId !== entry.tourId), entry];
+    },
+    clear: (tourId) => {
+      entries = tourId ? entries.filter((e) => e.tourId !== tourId) : [];
+    }
+  };
+}
+function isTourFinished(completions, definition) {
+  const entry = completions.find((completion) => completion.tourId === definition.id);
+  if (!entry) return false;
+  return entry.version >= (definition.version ?? 1);
+}
+export {
+  isTourFinished,
+  localStorageTourStorage,
+  memoryTourStorage
+};
+//# sourceMappingURL=tour-progress.js.map

package/dist/overlay/tour-progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tour-progress.js","sources":["../../src/overlay/tour-progress.ts"],"sourcesContent":["import type { TourDefinition } from \"./tour-types\";\n\n/**\n * Completion persistence for tours.\n *\n * The default is a localStorage store so the zero-config path works, but the\n * seam is an adapter rather than a boolean because completion is *user* state,\n * not device state: someone who signs in on a second machine should not re-see a\n * first-run tour, and an admin may want to reset one for a whole org. Both are\n * expressible as a `TourStorage`; neither is expressible as \"the library owns\n * localStorage\" or as a bare `completed` prop.\n */\n\nexport type TourCompletionStatus = \"completed\" | \"dismissed\";\n\nexport type TourCompletion = {\n  tourId: string;\n  status: TourCompletionStatus;\n  /** The definition `version` this was recorded against. */\n  version: number;\n  /** ISO timestamp. */\n  at: string;\n};\n\nexport type TourStorage = {\n  read: () => TourCompletion[] | Promise<TourCompletion[]>;\n  write: (entry: TourCompletion) => void | Promise<void>;\n  clear: (tourId?: string) => void | Promise<void>;\n};\n\nconst DEFAULT_KEY = \"clicky-ui-tours\";\n\nfunction isCompletion(value: unknown): value is TourCompletion {\n  if (!value || typeof value !== \"object\") return false;\n  const entry = value as Partial<TourCompletion>;\n  return (\n    typeof entry.tourId === \"string\" &&\n    (entry.status === \"completed\" || entry.status === \"dismissed\") &&\n    typeof entry.version === \"number\"\n  );\n}\n\n/**\n * localStorage-backed store, keyed like `clicky-ui-theme` / `clicky-ui-density`.\n * A corrupt or unreadable value reads as \"nothing recorded\" — the cost of being\n * wrong is re-offering a tour, so refusing to boot over it would be worse.\n */\nexport function localStorageTourStorage(key: string = DEFAULT_KEY): TourStorage {\n  const load = (): TourCompletion[] => {\n    if (typeof localStorage === \"undefined\") return [];\n    try {\n      const raw = localStorage.getItem(key);\n      if (!raw) return [];\n      const parsed: unknown = JSON.parse(raw);\n      return Array.isArray(parsed) ? parsed.filter(isCompletion) : [];\n    } catch {\n      return [];\n    }\n  };\n\n  const save = (entries: TourCompletion[]) => {\n    if (typeof localStorage === \"undefined\") return;\n    try {\n      localStorage.setItem(key, JSON.stringify(entries));\n    } catch {\n      // A full or blocked quota must not break the tour that just finished.\n    }\n  };\n\n  return {\n    read: load,\n    write: (entry) => save([...load().filter((e) => e.tourId !== entry.tourId), entry]),\n    clear: (tourId) => save(tourId ? load().filter((e) => e.tourId !== tourId) : []),\n  };\n}\n\n/** In-memory store, for tests, stories, and embedded/mocked renderings. */\nexport function memoryTourStorage(seed: TourCompletion[] = []): TourStorage {\n  let entries = [...seed];\n  return {\n    read: () => entries,\n    write: (entry) => {\n      entries = [...entries.filter((e) => e.tourId !== entry.tourId), entry];\n    },\n    clear: (tourId) => {\n      entries = tourId ? entries.filter((e) => e.tourId !== tourId) : [];\n    },\n  };\n}\n\n/**\n * True when a recorded completion still covers the definition's current version.\n * Bumping `version` on a reworked tour makes prior completions stale, so it is\n * offered again with no migration step.\n */\nexport function isTourFinished(\n  completions: TourCompletion[],\n  definition: TourDefinition,\n): boolean {\n  const entry = completions.find((completion) => completion.tourId === definition.id);\n  if (!entry) return false;\n  return entry.version >= (definition.version ?? 1);\n}\n"],"names":[],"mappings":"AA8BA,MAAM,cAAc;AAEpB,SAAS,aAAa,OAAyC;AAC7D,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,QAAM,QAAQ;AACd,SACE,OAAO,MAAM,WAAW,aACvB,MAAM,WAAW,eAAe,MAAM,WAAW,gBAClD,OAAO,MAAM,YAAY;AAE7B;AAOO,SAAS,wBAAwB,MAAc,aAA0B;AAC9E,QAAM,OAAO,MAAwB;AACnC,QAAI,OAAO,iBAAiB,YAAa,QAAO,CAAA;AAChD,QAAI;AACF,YAAM,MAAM,aAAa,QAAQ,GAAG;AACpC,UAAI,CAAC,IAAK,QAAO,CAAA;AACjB,YAAM,SAAkB,KAAK,MAAM,GAAG;AACtC,aAAO,MAAM,QAAQ,MAAM,IAAI,OAAO,OAAO,YAAY,IAAI,CAAA;AAAA,IAC/D,QAAQ;AACN,aAAO,CAAA;AAAA,IACT;AAAA,EACF;AAEA,QAAM,OAAO,CAAC,YAA8B;AAC1C,QAAI,OAAO,iBAAiB,YAAa;AACzC,QAAI;AACF,mBAAa,QAAQ,KAAK,KAAK,UAAU,OAAO,CAAC;AAAA,IACnD,QAAQ;AAAA,IAER;AAAA,EACF;AAEA,SAAO;AAAA,IACL,MAAM;AAAA,IACN,OAAO,CAAC,UAAU,KAAK,CAAC,GAAG,KAAA,EAAO,OAAO,CAAC,MAAM,EAAE,WAAW,MAAM,MAAM,GAAG,KAAK,CAAC;AAAA,IAClF,OAAO,CAAC,WAAW,KAAK,SAAS,KAAA,EAAO,OAAO,CAAC,MAAM,EAAE,WAAW,MAAM,IAAI,CAAA,CAAE;AAAA,EAAA;AAEnF;AAGO,SAAS,kBAAkB,OAAyB,IAAiB;AAC1E,MAAI,UAAU,CAAC,GAAG,IAAI;AACtB,SAAO;AAAA,IACL,MAAM,MAAM;AAAA,IACZ,OAAO,CAAC,UAAU;AAChB,gBAAU,CAAC,GAAG,QAAQ,OAAO,CAAC,MAAM,EAAE,WAAW,MAAM,MAAM,GAAG,KAAK;AAAA,IACvE;AAAA,IACA,OAAO,CAAC,WAAW;AACjB,gBAAU,SAAS,QAAQ,OAAO,CAAC,MAAM,EAAE,WAAW,MAAM,IAAI,CAAA;AAAA,IAClE;AAAA,EAAA;AAEJ;AAOO,SAAS,eACd,aACA,YACS;AACT,QAAM,QAAQ,YAAY,KAAK,CAAC,eAAe,WAAW,WAAW,WAAW,EAAE;AAClF,MAAI,CAAC,MAAO,QAAO;AACnB,SAAO,MAAM,YAAY,WAAW,WAAW;AACjD;"}