isotone 1.0.10 → 1.1.1

package/dist/core.d.ts

@@ -197,8 +197,10 @@ interface OverlayVariant {
      * when the file was not hashable), so a later change to the real file can
      * be detected and three-way merged into the override.
      */
+    /** `added`: a file the project does not have; the variant introduces it. */
     files: Record<string, {
         base: string | null;
+        added?: true;
     }>;
 }
 /** An overlay variant as the endpoint lists it: the manifest plus what the
@@ -297,12 +299,24 @@ declare function overlayGroups<T extends OverlayVariant>(variants: T[]): Overlay
  */
 declare function variantAppliesTo(pattern: string | undefined, route: string): boolean;
 declare function overlayAxes(list: OverlayVariantsList, route: string): SelectVariantAxis[];
+/**
+ * The tab's live variant store, which the Vite plugin creates on the page
+ * in live mode (`window.__isotoneLive`). Only the part the panel uses.
+ */
+interface LiveVariantSelection {
+    readonly active: string[];
+    /** Switch the tab; true when the page has to reload to show it. */
+    select(next: string[]): boolean;
+    subscribe(listener: () => void): () => void;
+    reload(): void;
+}
 /**
  * A `VariantsSource` over the overlay endpoint. One select axis per group on
  * the route; choosing an option replaces that group's active member and
- * posts the whole active set, and the server answers by hot-swapping the
- * files, so nothing here has to re-render anything. `refresh()` re-reads
- * the listing; the panel calls it when it opens.
+ * posts the whole active set. In live mode the tab's store switches the page
+ * at once (or asks for a reload), and the post makes the pick the server's
+ * default; otherwise the server answers the post by hot-swapping the files.
+ * `refresh()` re-reads the listing; the panel calls it when it opens.
  */
 declare function createOverlayVariantsSource(cfg: {
     /** Absolute or same-origin URL of the variants endpoint. */
@@ -312,6 +326,8 @@ declare function createOverlayVariantsSource(cfg: {
     storage?: Pick<Storage, 'getItem' | 'setItem' | 'removeItem'> | null;
     /** The element knobs write their properties on. Default: `document.documentElement`. */
     knobRoot?: Parameters<typeof applyKnobValues>[2] | null;
+    /** The tab's live store. Default: the one the Vite plugin put on the page, if any. */
+    live?: LiveVariantSelection | null;
 }): VariantsSource & {
     refresh(): Promise<void>;
     readonly list: OverlayVariantsList | null;
@@ -435,4 +451,4 @@ declare function createIterationStore(cfg?: IterationStoreConfig): {
     readonly hasUnsyncedNotes: boolean;
 };
 
-export { type ColorSwatch, type ColorVariantAxis, type IterationElement, type IterationNote, type IterationStoreConfig, KNOBS_STORAGE_KEY, type KnobAxis, type NodeLike, type NoteContext, OVERLAY_DEFAULT_OPTION, OVERLAY_GROUP_ID, type OverlayGroup, type OverlayVariant, type OverlayVariantStatus, type OverlayVariantsList, type RangeVariantAxis, type RouteGateOptions, type SaveLocation, type SelectVariantAxis, VARIANTS_ENDPOINT, type VariantAction, type VariantAxis, type VariantAxisCondition, type VariantOption, type VariantReference, type VariantRemoval, type VariantSelections, type VariantsSource, applyKnobValues, axisDefault, createIterationStore, createOverlayVariantsSource, createVariantsSource, defaultSelections, describeIterationElement, elementAsNode, formatRangeValue, isAxisVisible, isDirty, isRouteVisible, isValidSelection, knobCssValue, knobDelta, knobVar, knobsFor, overlayAxes, overlayGroups, parseVariantParam, serializeVariantParam, variantAppliesTo, visibleAxes };
+export { type ColorSwatch, type ColorVariantAxis, type IterationElement, type IterationNote, type IterationStoreConfig, KNOBS_STORAGE_KEY, type KnobAxis, type LiveVariantSelection, type NodeLike, type NoteContext, OVERLAY_DEFAULT_OPTION, OVERLAY_GROUP_ID, type OverlayGroup, type OverlayVariant, type OverlayVariantStatus, type OverlayVariantsList, type RangeVariantAxis, type RouteGateOptions, type SaveLocation, type SelectVariantAxis, VARIANTS_ENDPOINT, type VariantAction, type VariantAxis, type VariantAxisCondition, type VariantOption, type VariantReference, type VariantRemoval, type VariantSelections, type VariantsSource, applyKnobValues, axisDefault, createIterationStore, createOverlayVariantsSource, createVariantsSource, defaultSelections, describeIterationElement, elementAsNode, formatRangeValue, isAxisVisible, isDirty, isRouteVisible, isValidSelection, knobCssValue, knobDelta, knobVar, knobsFor, overlayAxes, overlayGroups, parseVariantParam, serializeVariantParam, variantAppliesTo, visibleAxes };

package/dist/core.js

@@ -3,7 +3,7 @@ import {
   describeIterationElement,
   elementAsNode,
   isRouteVisible
-} from "./chunk-OOFRFHCN.js";
+} from "./chunk-FKEKBZ3E.js";
 import {
   KNOBS_STORAGE_KEY,
   OVERLAY_DEFAULT_OPTION,
@@ -28,7 +28,7 @@ import {
   serializeVariantParam,
   variantAppliesTo,
   visibleAxes
-} from "./chunk-OSETWKGE.js";
+} from "./chunk-PUXQGUMQ.js";
 import "./chunk-A4DX2V4C.js";
 export {
   KNOBS_STORAGE_KEY,