@stacknav/core 0.2.0

package/dist/navigation-stack.d.ts

@@ -0,0 +1,177 @@
+import { type Easing } from './animate.ts';
+/** One mounted page. `key` and `data` belong to the caller; the stack only carries them. */
+export interface StackEntry<T = unknown> {
+    el: HTMLElement;
+    index: number;
+    key: string | null;
+    data: T | null;
+}
+export interface SettleInput {
+    remainingPx: number;
+    velocity: number;
+}
+/**
+ * Describes what the pages look like at any progress p (1 = upper page fully
+ * open, 0 = upper page fully off-screen). Push runs p from 0 to 1, pop from
+ * 1 to 0.
+ */
+export interface Transition {
+    readonly duration: number;
+    readonly ease: Easing;
+    settle(input: SettleInput): {
+        duration: number;
+        ease: Easing;
+    };
+    begin?(lower: StackEntry | null, upper: StackEntry): void;
+    apply(lower: StackEntry | null, upper: StackEntry, p: number): void;
+    end?(lower: StackEntry | null, upper: StackEntry): void;
+}
+export type TransitionKind = 'push' | 'pop' | 'interactive';
+/** Where an operation came from: `api`, `gesture`, `history`, or any value a port defines. */
+export type NavigationSource = 'api' | 'gesture' | 'history' | (string & {});
+export interface MountOptions<T = unknown> {
+    animated?: boolean;
+    data?: T | null;
+    key?: string | null;
+    source?: NavigationSource;
+}
+export interface PushEvent {
+    entry: StackEntry;
+    entries: StackEntry[];
+    source: NavigationSource;
+}
+export interface PopEvent {
+    entry: StackEntry;
+    removed: StackEntry[];
+    entries: StackEntry[];
+    source: NavigationSource;
+}
+export interface ReplaceEvent {
+    entry: StackEntry;
+    removed: StackEntry[];
+    entries: StackEntry[];
+    source: NavigationSource;
+}
+export interface ResetEvent {
+    entries: StackEntry[];
+    removed: StackEntry[];
+    source: NavigationSource;
+}
+export interface TransitionEvent {
+    lower: StackEntry | null;
+    upper: StackEntry;
+    kind: TransitionKind;
+}
+export interface ProgressEvent {
+    lower: StackEntry | null;
+    upper: StackEntry;
+    p: number;
+}
+export interface StackEvents {
+    push: PushEvent;
+    pop: PopEvent;
+    replace: ReplaceEvent;
+    reset: ResetEvent;
+    transitionstart: TransitionEvent;
+    progress: ProgressEvent;
+    transitionend: TransitionEvent;
+}
+export interface InteractivePopHandle {
+    /** p = 1 fully open … 0 fully popped */
+    update(p: number): void;
+    /** Resolves when the settle animation ends. */
+    finish(input: {
+        complete: boolean;
+        velocity?: number;
+    }): Promise<void>;
+}
+export interface NavigationStackOptions {
+    container: HTMLElement;
+    transition: Transition;
+    pageClass?: string;
+}
+type Listener<E> = (detail: E) => void;
+/**
+ * A stack of page elements inside one container. The stack owns mounting,
+ * ordering, visibility and the transition lifecycle. A `Transition` decides
+ * what the pages look like at any progress p.
+ *
+ * Operations are serialized: one called during a transition waits its turn.
+ */
+export declare class NavigationStack {
+    readonly container: HTMLElement;
+    transition: Transition;
+    readonly pageClass: string;
+    entries: StackEntry[];
+    busy: boolean;
+    private _queue;
+    private _listeners;
+    constructor({ container, transition, pageClass }: NavigationStackOptions);
+    get depth(): number;
+    get top(): StackEntry | null;
+    width(): number;
+    canPop(): boolean;
+    /** The entry holding `el`, or the entry with `key`, if either is mounted. */
+    entryOf(elOrKey: HTMLElement | string): StackEntry | null;
+    on<K extends keyof StackEvents>(event: K, fn: Listener<StackEvents[K]>): () => void;
+    private _emit;
+    /**
+     * Pushes an element, or a function returning one. Resolves with the entry
+     * once the transition has finished. An element already mounted lower in the
+     * stack is moved to the top.
+     */
+    push<T = unknown>(elOrFactory: HTMLElement | (() => HTMLElement), { animated, data, key, source }?: MountOptions<T>): Promise<StackEntry>;
+    /** Pops one level. Resolves with the removed entry; its element is detached, not destroyed. */
+    pop(opts?: {
+        animated?: boolean;
+        source?: NavigationSource;
+    }): Promise<StackEntry | null>;
+    /** Pops until `depth` entries remain (≥ 1). Intermediate pages are removed without animation. */
+    popTo(depth: number, { animated, source }?: {
+        animated?: boolean;
+        source?: NavigationSource;
+    }): Promise<StackEntry | null>;
+    /**
+     * Pops the top page, revealing `el`. If `el` is already mounted beneath the
+     * top, everything above it is removed, as in `popTo`. If it is not mounted,
+     * it is placed directly beneath the top first, so a page that no longer
+     * exists (for example a fresh instance after a deep link) still arrives with
+     * a pop.
+     */
+    popWith<T = unknown>(el: HTMLElement, { animated, data, key, source }?: MountOptions<T>): Promise<StackEntry | null>;
+    /** Swaps the top page for `el` without animation. Returns the removed entry. */
+    replace<T = unknown>(el: HTMLElement, { data, key, source }?: MountOptions<T>): Promise<StackEntry | null>;
+    /**
+     * Convenience for ports that already resolved the direction: `push`, `pop`
+     * (via `popWith`) or `replace`.
+     */
+    present<T = unknown>(el: HTMLElement, direction: 'push' | 'pop' | 'replace', opts?: MountOptions<T>): Promise<StackEntry | null>;
+    /** Removes a mounted page without animation, wherever it sits. Returns its entry, or null. */
+    remove(el: HTMLElement, { source }?: {
+        source?: NavigationSource;
+    }): Promise<StackEntry | null>;
+    /** Replaces the whole stack without animation. Returns the removed entries. */
+    reset(elements: HTMLElement[], { source }?: {
+        source?: NavigationSource;
+    }): Promise<StackEntry[]>;
+    /** Starts a pointer-driven pop. Returns null if the stack cannot pop right now. */
+    beginInteractivePop(): InteractivePopHandle | null;
+    destroy(): void;
+    private _setBusy;
+    /** Serializes operations: while a transition runs, later calls wait their turn. */
+    private _run;
+    private _drain;
+    private _popRevealing;
+    private _mount;
+    private _unmount;
+    /** Drops `el` from the entries if it is mounted. Returns its old entry. */
+    private _forget;
+    private _begin;
+    private _apply;
+    private _end;
+    private _transition;
+    /** Makes only the top page visible, resets every transform, renumbers the indexes. */
+    private _settle;
+}
+export {};
+//# sourceMappingURL=navigation-stack.d.ts.map

package/dist/navigation-stack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-stack.d.ts","sourceRoot":"","sources":["../src/navigation-stack.ts"],"names":[],"mappings":"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"}

package/dist/navigation-stack.js

@@ -0,0 +1,296 @@
+import { tween } from "./animate.js";
+/**
+ * A stack of page elements inside one container. The stack owns mounting,
+ * ordering, visibility and the transition lifecycle. A `Transition` decides
+ * what the pages look like at any progress p.
+ *
+ * Operations are serialized: one called during a transition waits its turn.
+ */
+export class NavigationStack {
+    container;
+    transition;
+    pageClass;
+    entries = [];
+    busy = false;
+    _queue = [];
+    _listeners = new Map();
+    constructor({ container, transition, pageClass = 'sn-page' }) {
+        if (!container || !transition)
+            throw new Error('NavigationStack needs { container, transition }');
+        this.container = container;
+        this.transition = transition;
+        this.pageClass = pageClass;
+        container.classList.add('sn-container');
+    }
+    // ---------------------------------------------------------------- state
+    get depth() {
+        return this.entries.length;
+    }
+    get top() {
+        return this.entries[this.entries.length - 1] || null;
+    }
+    width() {
+        return this.container.clientWidth;
+    }
+    canPop() {
+        return !this.busy && this.entries.length > 1;
+    }
+    /** The entry holding `el`, or the entry with `key`, if either is mounted. */
+    entryOf(elOrKey) {
+        return this.entries.find((e) => (typeof elOrKey === 'string' ? e.key === elOrKey : e.el === elOrKey)) || null;
+    }
+    on(event, fn) {
+        if (!this._listeners.has(event))
+            this._listeners.set(event, new Set());
+        const set = this._listeners.get(event);
+        set.add(fn);
+        return () => {
+            set.delete(fn);
+        };
+    }
+    _emit(event, detail) {
+        const set = this._listeners.get(event);
+        if (set)
+            set.forEach((fn) => fn(detail));
+    }
+    // ------------------------------------------------------------ operations
+    /**
+     * Pushes an element, or a function returning one. Resolves with the entry
+     * once the transition has finished. An element already mounted lower in the
+     * stack is moved to the top.
+     */
+    push(elOrFactory, { animated = true, data = null, key = null, source = 'api' } = {}) {
+        return this._run(async () => {
+            const el = typeof elOrFactory === 'function' ? elOrFactory() : elOrFactory;
+            this._forget(el);
+            const lower = this.top;
+            const upper = this._mount(el, this.entries.length, data, key);
+            this.entries.push(upper);
+            await this._transition(lower, upper, 0, 1, animated, 'push');
+            this._settle();
+            this._emit('push', { entry: upper, entries: this.entries.slice(), source });
+            return upper;
+        });
+    }
+    /** Pops one level. Resolves with the removed entry; its element is detached, not destroyed. */
+    pop(opts = {}) {
+        return this.popTo(this.entries.length - 1, opts);
+    }
+    /** Pops until `depth` entries remain (≥ 1). Intermediate pages are removed without animation. */
+    popTo(depth, { animated = true, source = 'api' } = {}) {
+        return this._run(async () => {
+            if (depth < 1 || this.entries.length <= depth)
+                return null;
+            return this._popRevealing(depth, animated, source);
+        });
+    }
+    /**
+     * Pops the top page, revealing `el`. If `el` is already mounted beneath the
+     * top, everything above it is removed, as in `popTo`. If it is not mounted,
+     * it is placed directly beneath the top first, so a page that no longer
+     * exists (for example a fresh instance after a deep link) still arrives with
+     * a pop.
+     */
+    popWith(el, { animated = true, data = null, key = null, source = 'api' } = {}) {
+        return this._run(async () => {
+            if (!this.entries.length) {
+                const entry = this._mount(el, 0, data, key);
+                this.entries.push(entry);
+                this._settle();
+                this._emit('push', { entry, entries: this.entries.slice(), source });
+                return null;
+            }
+            const top = this.top;
+            if (top.el === el)
+                return null;
+            const existing = this.entries.findIndex((e) => e.el === el);
+            if (existing >= 0)
+                return this._popRevealing(existing + 1, animated, source);
+            const lower = this._mount(el, this.entries.length - 1, data, key, top.el);
+            this.entries.splice(this.entries.length - 1, 0, lower);
+            return this._popRevealing(this.entries.length - 1, animated, source);
+        });
+    }
+    /** Swaps the top page for `el` without animation. Returns the removed entry. */
+    replace(el, { data = null, key = null, source = 'api' } = {}) {
+        return this._run(async () => {
+            const old = this.top;
+            if (old && old.el === el)
+                return null;
+            this._forget(el);
+            const removed = old ? [this._unmount(this.entries.pop())] : [];
+            const entry = this._mount(el, this.entries.length, data, key);
+            this.entries.push(entry);
+            this._settle();
+            this._emit('replace', { entry, removed, entries: this.entries.slice(), source });
+            return removed[0] || null;
+        });
+    }
+    /**
+     * Convenience for ports that already resolved the direction: `push`, `pop`
+     * (via `popWith`) or `replace`.
+     */
+    present(el, direction, opts = {}) {
+        if (direction === 'pop')
+            return this.popWith(el, opts);
+        if (direction === 'replace')
+            return this.replace(el, opts);
+        return this.push(el, opts);
+    }
+    /** Removes a mounted page without animation, wherever it sits. Returns its entry, or null. */
+    remove(el, { source = 'api' } = {}) {
+        return this._run(async () => {
+            const entry = this._forget(el);
+            if (!entry)
+                return null;
+            this._settle();
+            this._emit('pop', { entry, removed: [entry], entries: this.entries.slice(), source });
+            return entry;
+        });
+    }
+    /** Replaces the whole stack without animation. Returns the removed entries. */
+    reset(elements, { source = 'api' } = {}) {
+        return this._run(async () => {
+            const removed = [];
+            while (this.entries.length)
+                removed.push(this._unmount(this.entries.pop()));
+            elements.forEach((el, i) => this.entries.push(this._mount(el, i, null, null)));
+            this._settle();
+            this._emit('reset', { entries: this.entries.slice(), removed, source });
+            return removed;
+        });
+    }
+    /** Starts a pointer-driven pop. Returns null if the stack cannot pop right now. */
+    beginInteractivePop() {
+        if (!this.canPop())
+            return null;
+        this._setBusy(true);
+        const upper = this.top;
+        const lower = this.entries[this.entries.length - 2];
+        let p = 1;
+        this._begin(lower, upper, 'interactive');
+        return {
+            update: (v) => {
+                p = Math.min(1, Math.max(0, v));
+                this._apply(lower, upper, p);
+            },
+            finish: async ({ complete, velocity = 0 }) => {
+                const remainingPx = (complete ? p : 1 - p) * this.width();
+                const { duration, ease } = this.transition.settle({ remainingPx, velocity });
+                await tween({ from: p, to: complete ? 0 : 1, duration, ease, onUpdate: (v) => this._apply(lower, upper, v) });
+                this._end(lower, upper, 'interactive');
+                if (complete) {
+                    this.entries.pop();
+                    this._unmount(upper);
+                }
+                this._settle();
+                this._setBusy(false);
+                if (complete)
+                    this._emit('pop', { entry: upper, removed: [upper], entries: this.entries.slice(), source: 'gesture' });
+                this._drain();
+            },
+        };
+    }
+    destroy() {
+        while (this.entries.length)
+            this._unmount(this.entries.pop());
+        this.container.classList.remove('sn-container');
+    }
+    // -------------------------------------------------------------- internals
+    _setBusy(v) {
+        this.busy = v;
+        this.container.classList.toggle('sn-busy', v);
+    }
+    /** Serializes operations: while a transition runs, later calls wait their turn. */
+    _run(fn) {
+        return new Promise((resolve, reject) => {
+            const task = async () => {
+                this._setBusy(true);
+                try {
+                    resolve(await fn());
+                }
+                catch (e) {
+                    reject(e);
+                }
+                finally {
+                    this._setBusy(false);
+                    this._drain();
+                }
+            };
+            if (this.busy)
+                this._queue.push(task);
+            else
+                task();
+        });
+    }
+    _drain() {
+        if (!this.busy && this._queue.length)
+            this._queue.shift()();
+    }
+    async _popRevealing(depth, animated, source) {
+        const upper = this.entries.pop(); // the visible page: it animates out
+        const removed = [];
+        while (this.entries.length > depth)
+            removed.push(this._unmount(this.entries.pop())); // intermediate pages: removed without animation
+        const lower = this.top;
+        await this._transition(lower, upper, 1, 0, animated, 'pop');
+        removed.push(this._unmount(upper));
+        this._settle();
+        this._emit('pop', { entry: upper, removed, entries: this.entries.slice(), source });
+        return upper;
+    }
+    _mount(el, index, data, key, before = null) {
+        el.classList.add(this.pageClass);
+        if (before)
+            this.container.insertBefore(el, before);
+        else if (el.parentElement !== this.container)
+            this.container.append(el);
+        return { el, index, key, data };
+    }
+    _unmount(entry) {
+        entry.el.classList.remove(this.pageClass, 'sn-page-visible');
+        entry.el.style.transform = '';
+        entry.el.remove();
+        return entry;
+    }
+    /** Drops `el` from the entries if it is mounted. Returns its old entry. */
+    _forget(el) {
+        const i = this.entries.findIndex((e) => e.el === el);
+        if (i < 0)
+            return null;
+        const [entry] = this.entries.splice(i, 1);
+        return this._unmount(entry);
+    }
+    _begin(lower, upper, kind) {
+        if (lower)
+            lower.el.classList.add('sn-page-visible');
+        upper.el.classList.add('sn-page-visible');
+        this.transition.begin?.(lower, upper);
+        this._emit('transitionstart', { lower, upper, kind });
+    }
+    _apply(lower, upper, p) {
+        this.transition.apply(lower, upper, p);
+        this._emit('progress', { lower, upper, p });
+    }
+    _end(lower, upper, kind) {
+        this.transition.end?.(lower, upper);
+        this._emit('transitionend', { lower, upper, kind });
+    }
+    async _transition(lower, upper, from, to, animated, kind) {
+        this._begin(lower, upper, kind);
+        this._apply(lower, upper, from);
+        const duration = animated ? this.transition.duration : 0;
+        await tween({ from, to, duration, ease: this.transition.ease, onUpdate: (p) => this._apply(lower, upper, p) });
+        this._end(lower, upper, kind);
+    }
+    /** Makes only the top page visible, resets every transform, renumbers the indexes. */
+    _settle() {
+        const top = this.top;
+        this.entries.forEach((e, i) => {
+            e.index = i;
+            e.el.classList.toggle('sn-page-visible', e === top);
+            e.el.style.transform = e === top ? 'translate3d(0,0,0)' : '';
+        });
+    }
+}
+//# sourceMappingURL=navigation-stack.js.map

package/dist/navigation-stack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-stack.js","sourceRoot":"","sources":["../src/navigation-stack.ts"],"names":[],"mappings":"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"}

package/dist/stacknav.css

@@ -0,0 +1,33 @@
+/* Tune the iOS transition by setting these on .sn-container or any ancestor:
+     --sn-duration: 500ms;                        push/pop length
+     --sn-easing: cubic-bezier(0.32, 0.72, 0, 1); its curve: a cubic-bezier, a keyword, or ios
+     --sn-parallax: 30%;                          how far the page beneath travels
+     --sn-dim-color: #000;                        overlay on the page beneath
+     --sn-dim-max: 10%;                           its opacity at full open
+     --sn-shadow: -3px 0 14px rgba(0,0,0,0.16);   on the incoming page; none to remove it
+     --sn-settle-min: 120ms;                      bounds for finishing a swipe
+     --sn-settle-max: 400ms;
+     --sn-settle-easing: ios-settle;              the curve a released swipe finishes on
+     --sn-settle-velocity-floor: 900;             px/s assumed when the pointer was slower
+     --sn-time-scale: 1;                          multiplies every duration */
+.sn-container {
+  position: relative;
+  overflow: hidden;
+}
+.sn-page {
+  position: absolute;
+  inset: 0;
+  overflow-y: auto;
+  overflow-x: hidden;
+  -webkit-overflow-scrolling: touch;
+  overscroll-behavior-y: contain;
+  touch-action: pan-y;
+  visibility: hidden;
+  will-change: transform;
+}
+.sn-page-visible {
+  visibility: visible;
+}
+.sn-busy .sn-page {
+  pointer-events: none;
+}

package/dist/styles.d.ts

@@ -0,0 +1,29 @@
+/**
+ * The only styles the engine needs. These cover layout, not appearance: the
+ * look lives in the transition and is tuned through the `--sn-*` custom
+ * properties (see `IOS_TRANSITION_CSS_VARS` and the README). Those properties
+ * are documented but deliberately not declared, because leaving one unset is
+ * what makes its JS default apply.
+ *
+ * The string is kept minified because it ships inside every consumer's JS
+ * bundle (`injectStyles()` is the default path); `scripts/write-css.mjs`
+ * expands it into the readable `dist/stacknav.css`. What each rule is for:
+ *
+ * - `.sn-container`: the stack's scroll-clipping frame.
+ * - `.sn-page`: absolutely fills the container and is its own scroll container.
+ *   `touch-action: pan-y` keeps vertical scrolling native while horizontal
+ *   drags reach the gesture; `visibility: hidden` keeps pages beneath the top
+ *   mounted (scroll position, form state) but out of sight and out of the
+ *   accessibility tree.
+ * - `.sn-page-visible`: the top page, and both pages during a transition.
+ * - `.sn-busy .sn-page`: no clicks land on a page that is mid-transition.
+ */
+export declare const STACKNAV_CSS: string;
+export declare const STACKNAV_STYLE_ID = "stacknav-styles";
+/**
+ * Inserts the engine's stylesheet into `doc` once. Framework ports call this so
+ * apps need no stylesheet import. Apps that ship `stacknav.css` themselves can
+ * skip it.
+ */
+export declare function injectStyles(doc?: Document | null): void;
+//# sourceMappingURL=styles.d.ts.map

package/dist/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../src/styles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,YAAY,QAIiB,CAAC;AAE3C,eAAO,MAAM,iBAAiB,oBAAoB,CAAC;AAEnD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,GAAE,QAAQ,GAAG,IAAwD,GAAG,IAAI,CAM3G"}

package/dist/styles.js

@@ -0,0 +1,39 @@
+/**
+ * The only styles the engine needs. These cover layout, not appearance: the
+ * look lives in the transition and is tuned through the `--sn-*` custom
+ * properties (see `IOS_TRANSITION_CSS_VARS` and the README). Those properties
+ * are documented but deliberately not declared, because leaving one unset is
+ * what makes its JS default apply.
+ *
+ * The string is kept minified because it ships inside every consumer's JS
+ * bundle (`injectStyles()` is the default path); `scripts/write-css.mjs`
+ * expands it into the readable `dist/stacknav.css`. What each rule is for:
+ *
+ * - `.sn-container`: the stack's scroll-clipping frame.
+ * - `.sn-page`: absolutely fills the container and is its own scroll container.
+ *   `touch-action: pan-y` keeps vertical scrolling native while horizontal
+ *   drags reach the gesture; `visibility: hidden` keeps pages beneath the top
+ *   mounted (scroll position, form state) but out of sight and out of the
+ *   accessibility tree.
+ * - `.sn-page-visible`: the top page, and both pages during a transition.
+ * - `.sn-busy .sn-page`: no clicks land on a page that is mid-transition.
+ */
+export const STACKNAV_CSS = '.sn-container{position:relative;overflow:hidden}' +
+    '.sn-page{position:absolute;inset:0;overflow-y:auto;overflow-x:hidden;-webkit-overflow-scrolling:touch;overscroll-behavior-y:contain;touch-action:pan-y;visibility:hidden;will-change:transform}' +
+    '.sn-page-visible{visibility:visible}' +
+    '.sn-busy .sn-page{pointer-events:none}';
+export const STACKNAV_STYLE_ID = 'stacknav-styles';
+/**
+ * Inserts the engine's stylesheet into `doc` once. Framework ports call this so
+ * apps need no stylesheet import. Apps that ship `stacknav.css` themselves can
+ * skip it.
+ */
+export function injectStyles(doc = typeof document === 'undefined' ? null : document) {
+    if (!doc || doc.getElementById(STACKNAV_STYLE_ID))
+        return;
+    const style = doc.createElement('style');
+    style.id = STACKNAV_STYLE_ID;
+    style.textContent = STACKNAV_CSS;
+    (doc.head ?? doc.documentElement).append(style);
+}
+//# sourceMappingURL=styles.js.map

package/dist/styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.js","sourceRoot":"","sources":["../src/styles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,YAAY,GACvB,kDAAkD;IAClD,iMAAiM;IACjM,sCAAsC;IACtC,wCAAwC,CAAC;AAE3C,MAAM,CAAC,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;AAEnD;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,MAAuB,OAAO,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ;IACnG,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,iBAAiB,CAAC;QAAE,OAAO;IAC1D,MAAM,KAAK,GAAG,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IACzC,KAAK,CAAC,EAAE,GAAG,iBAAiB,CAAC;IAC7B,KAAK,CAAC,WAAW,GAAG,YAAY,CAAC;IACjC,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAClD,CAAC"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@stacknav/core",
+  "version": "0.2.0",
+  "description": "Framework-agnostic iOS-style push/pop navigation stack: transition, interactive swipe back, direction resolution, history mirroring.",
+  "license": "MIT",
+  "type": "module",
+  "keywords": [
+    "navigation",
+    "transition",
+    "ios",
+    "swipe-back",
+    "stack",
+    "animation"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./stacknav.css": "./dist/stacknav.css",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "sideEffects": [
+    "*.css"
+  ],
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "esbuild": "^0.28.0",
+    "typescript": "~6.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && node scripts/write-css.mjs",
+    "test": "node --test \"test/**/*.test.ts\"",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "size": "node scripts/size.mjs"
+  }
+}