@artstorefronts/arthelper-nav 0.1.0-alpha.0

package/dist/nav-trigger.js

@@ -0,0 +1,21 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useNav } from './context.js';
+import { NavIcon, WaffleIcon } from './icons.js';
+import { themeVars } from './theme.js';
+/**
+ * The waffle plus active-app chip a host places by hand in its own header, beside
+ * its logo. This is the RESTORE control: while the bar is collapsed it is the only
+ * way back, so it is visibly interactive and always carries the restore label.
+ *
+ * It is display:none while the bar is expanded (and therefore out of the
+ * accessibility tree), which is why the label and aria-expanded are fixed rather
+ * than swapped — the bar's own waffle is the hide control.
+ */
+function NavTrigger({ className }) {
+    const { config, activeApp, collapsed, toggle } = useNav();
+    const classes = ['ahsuite-docked', className ?? ''].filter(Boolean).join(' ');
+    return (_jsxs("button", { "aria-expanded": false, "aria-label": "Show the suite bar", className: classes, "data-collapsed": collapsed ? 'true' : 'false', "data-theme": config.theme.mode, onClick: toggle, style: themeVars(config.theme), title: "Show the suite bar", type: "button", children: [_jsx("span", { className: "ahsuite-chip ahsuite-chip--active", children: _jsx(NavIcon, { name: activeApp?.app.icon ?? '' }) }), _jsx(WaffleIcon, { className: "ahsuite-waffle-mini" })] }));
+}
+export { NavTrigger };
+//# sourceMappingURL=nav-trigger.js.map

package/dist/nav-trigger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav-trigger.js","sourceRoot":"","sources":["../src/nav-trigger.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAMvC;;;;;;;;GAQG;AACH,SAAS,UAAU,CAAC,EAAE,SAAS,EAAmB;IAChD,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IAE1D,MAAM,OAAO,GAAG,CAAC,gBAAgB,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAE9E,OAAO,CACL,mCACiB,KAAK,gBACT,oBAAoB,EAC/B,SAAS,EAAE,OAAO,oBACF,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,gBAChC,MAAM,CAAC,KAAK,CAAC,IAAI,EAC7B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,EAC9B,KAAK,EAAC,oBAAoB,EAC1B,IAAI,EAAC,QAAQ,aAEb,eAAM,SAAS,EAAC,mCAAmC,YACjD,KAAC,OAAO,IAAC,IAAI,EAAE,SAAS,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,GAAI,GACvC,EACP,KAAC,UAAU,IAAC,SAAS,EAAC,qBAAqB,GAAG,IACvC,CACV,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/provider.d.ts

@@ -0,0 +1,19 @@
+import { type ReactNode } from 'react';
+import type { NavAppClickArgs, NavConfigPayload } from './types.js';
+interface NavProviderProps {
+    /** Full URL of the public nav-config endpoint. Derived by the host; no new env var. */
+    configUrl: string;
+    /** The catalog id of the app the host itself is — never inferred from the URL or the payload. */
+    activeAppId: string;
+    /** Called immediately before navigation. The only analytics seam; the package imports none. */
+    onAppClick?: (args: NavAppClickArgs) => void;
+    /** Overrides the compiled-in fallback, e.g. for a satellite with a different first-party set. */
+    fallbackConfig?: NavConfigPayload;
+    /** A server-rendered host passes the collapsed cookie it already read, so the first byte is correct. */
+    initialCollapsed?: boolean;
+    children?: ReactNode;
+}
+declare function NavProvider({ configUrl, activeAppId, onAppClick, fallbackConfig, initialCollapsed, children, }: NavProviderProps): import("react/jsx-runtime").JSX.Element;
+export { NavProvider };
+export type { NavProviderProps };
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":"AAEA,OAAO,EAA6C,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAMlF,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAkB,MAAM,YAAY,CAAC;AAEpF,UAAU,gBAAgB;IACxB,uFAAuF;IACvF,SAAS,EAAE,MAAM,CAAC;IAClB,iGAAiG;IACjG,WAAW,EAAE,MAAM,CAAC;IACpB,+FAA+F;IAC/F,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,CAAC;IAC7C,iGAAiG;IACjG,cAAc,CAAC,EAAE,gBAAgB,CAAC;IAClC,wGAAwG;IACxG,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,iBAAS,WAAW,CAAC,EACnB,SAAS,EACT,WAAW,EACX,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,QAAQ,GACT,EAAE,gBAAgB,2CAiDlB;AAED,OAAO,EAAE,WAAW,EAAE,CAAC;AACvB,YAAY,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/provider.js

@@ -0,0 +1,46 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useCallback, useEffect, useMemo, useState } from 'react';
+import { cached, fetchConfig } from './config.js';
+import { NavContext } from './context.js';
+import { readCollapsed, writeCollapsed } from './cookie.js';
+import { FALLBACK_CONFIG } from './fallback.js';
+import { resolveApps } from './resolve.js';
+function NavProvider({ configUrl, activeAppId, onAppClick, fallbackConfig, initialCollapsed, children, }) {
+    const fallback = fallbackConfig ?? FALLBACK_CONFIG;
+    // Stale-while-revalidate: paint the last good payload (or the embedded fallback)
+    // synchronously, then swap in the fetched one. First paint never waits on the network.
+    const [config, setConfig] = useState(() => cached(configUrl) ?? fallback);
+    const [collapsed, setCollapsedState] = useState(() => initialCollapsed ?? readCollapsed() ?? false);
+    useEffect(() => {
+        let live = true;
+        void fetchConfig(configUrl).then((next) => {
+            if (!live || !next) {
+                return;
+            }
+            setConfig(next);
+        });
+        return () => {
+            live = false;
+        };
+    }, [configUrl]);
+    const setCollapsed = useCallback((next) => {
+        setCollapsedState(next);
+        writeCollapsed(next);
+    }, []);
+    const toggle = useCallback(() => {
+        setCollapsedState((current) => {
+            writeCollapsed(!current);
+            return !current;
+        });
+    }, []);
+    const apps = useMemo(() => resolveApps(config, activeAppId, fallback), [config, activeAppId, fallback]);
+    const activeApp = useMemo(() => apps.find((item) => item.active), [apps]);
+    const activate = useCallback((entry) => {
+        onAppClick?.({ app: entry.app, activeAppId, collapsed });
+    }, [onAppClick, activeAppId, collapsed]);
+    const value = useMemo(() => ({ config, activeAppId, apps, activeApp, collapsed, setCollapsed, toggle, activate }), [config, activeAppId, apps, activeApp, collapsed, setCollapsed, toggle, activate]);
+    return _jsx(NavContext.Provider, { value: value, children: children });
+}
+export { NavProvider };
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

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

package/dist/resolve.d.ts

@@ -0,0 +1,32 @@
+import type { NavApp, NavConfigPayload, ResolvedNavApp } from './types.js';
+declare function hasDestination(app: NavApp): boolean;
+/**
+ * The one filter, applied identically to the embedded fallback and to the fetched
+ * payload: an entry renders only when it is enabled AND has a destination, so an
+ * endpoint outage can never paint a dead tile.
+ *
+ * The host's own app is the single exemption from `enabled` — it is always
+ * rendered and indicated, resolved from the fallback when the payload omits it,
+ * because an app that hid itself from its own bar would leave the artist with no
+ * indication of where they are and NavTrigger with no chip to dock. It is never
+ * exempt from the destination requirement: without one it becomes an inert
+ * indicator chip rather than a broken link.
+ *
+ * A LEGITIMATELY EMPTY payload (`apps: []`, which `normalize` now honours instead of
+ * discarding) changes nothing here, deliberately. The empty array is a statement about
+ * the CATALOG — the set of other apps a viewer may switch to — and the host's own entry
+ * has never been part of that set; it is the one exemption from it. Both invariants
+ * therefore hold at once: the catalog is empty, and the viewer still sees where they
+ * are and NavTrigger still has a chip to dock. Dropping the active entry too would
+ * trade a real regression (no orientation, a blank docked chip) for no gain, and the
+ * resolver cannot even see the distinction — an empty fetched payload and an empty
+ * `fallbackConfig` arrive here identically.
+ *
+ * Note this is not a licence to invent destinations: only the ids the compiled-in
+ * FALLBACK_CONFIG actually carries (today just `home`) can be resolved this way, which
+ * is why an empty payload leaves a satellite host's bar genuinely empty rather than
+ * guessing at a domain that may not exist on the stage yet.
+ */
+declare function resolveApps(config: NavConfigPayload, activeAppId: string, fallback: NavConfigPayload): ResolvedNavApp[];
+export { hasDestination, resolveApps };
+//# sourceMappingURL=resolve.d.ts.map

package/dist/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE3E,iBAAS,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE5C;AAUD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,iBAAS,WAAW,CAAC,MAAM,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,cAAc,EAAE,CAYhH;AAED,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC"}

package/dist/resolve.js

@@ -0,0 +1,51 @@
+import { FALLBACK_CONFIG } from './fallback.js';
+function hasDestination(app) {
+    return app.href.trim().length > 0;
+}
+function entry(app, activeAppId) {
+    return { app, active: app.id === activeAppId, navigable: hasDestination(app) };
+}
+function findApp(apps, id) {
+    return apps.find((app) => app.id === id);
+}
+/**
+ * The one filter, applied identically to the embedded fallback and to the fetched
+ * payload: an entry renders only when it is enabled AND has a destination, so an
+ * endpoint outage can never paint a dead tile.
+ *
+ * The host's own app is the single exemption from `enabled` — it is always
+ * rendered and indicated, resolved from the fallback when the payload omits it,
+ * because an app that hid itself from its own bar would leave the artist with no
+ * indication of where they are and NavTrigger with no chip to dock. It is never
+ * exempt from the destination requirement: without one it becomes an inert
+ * indicator chip rather than a broken link.
+ *
+ * A LEGITIMATELY EMPTY payload (`apps: []`, which `normalize` now honours instead of
+ * discarding) changes nothing here, deliberately. The empty array is a statement about
+ * the CATALOG — the set of other apps a viewer may switch to — and the host's own entry
+ * has never been part of that set; it is the one exemption from it. Both invariants
+ * therefore hold at once: the catalog is empty, and the viewer still sees where they
+ * are and NavTrigger still has a chip to dock. Dropping the active entry too would
+ * trade a real regression (no orientation, a blank docked chip) for no gain, and the
+ * resolver cannot even see the distinction — an empty fetched payload and an empty
+ * `fallbackConfig` arrive here identically.
+ *
+ * Note this is not a licence to invent destinations: only the ids the compiled-in
+ * FALLBACK_CONFIG actually carries (today just `home`) can be resolved this way, which
+ * is why an empty payload leaves a satellite host's bar genuinely empty rather than
+ * guessing at a domain that may not exist on the stage yet.
+ */
+function resolveApps(config, activeAppId, fallback) {
+    const visible = config.apps.filter((app) => app.id === activeAppId || (app.enabled && hasDestination(app)));
+    const resolved = visible.map((app) => entry(app, activeAppId));
+    if (resolved.some((item) => item.active)) {
+        return resolved;
+    }
+    const embedded = findApp(fallback.apps, activeAppId) ?? findApp(FALLBACK_CONFIG.apps, activeAppId);
+    if (!embedded) {
+        return resolved;
+    }
+    return [entry(embedded, activeAppId), ...resolved];
+}
+export { hasDestination, resolveApps };
+//# sourceMappingURL=resolve.js.map

package/dist/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGhD,SAAS,cAAc,CAAC,GAAW;IACjC,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,KAAK,CAAC,GAAW,EAAE,WAAmB;IAC7C,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,WAAW,EAAE,SAAS,EAAE,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;AACjF,CAAC;AAED,SAAS,OAAO,CAAC,IAAc,EAAE,EAAU;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,SAAS,WAAW,CAAC,MAAwB,EAAE,WAAmB,EAAE,QAA0B;IAC5F,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,WAAW,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC5G,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC;IAC/D,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACzC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,OAAO,CAAC,eAAe,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACnG,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE,GAAG,QAAQ,CAAC,CAAC;AACrD,CAAC;AAED,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC"}

package/dist/theme.d.ts

@@ -0,0 +1,13 @@
+import type { CSSProperties } from 'react';
+import type { NavTheme } from './types.js';
+/**
+ * The palettes themselves live in index.css, keyed off data-theme, so switching
+ * mode is a config edit rather than a package release. Only the two tokens CSS
+ * cannot know in advance come through inline.
+ *
+ * accent_color replaces the active chip's two-stop gradient with a single flat
+ * fill: one value cannot define two stops, so nothing is derived from it.
+ */
+declare function themeVars(theme: NavTheme): CSSProperties;
+export { themeVars };
+//# sourceMappingURL=theme.d.ts.map

package/dist/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;;;GAOG;AACH,iBAAS,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,aAAa,CASjD;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/theme.js

@@ -0,0 +1,21 @@
+'use client';
+/**
+ * The palettes themselves live in index.css, keyed off data-theme, so switching
+ * mode is a config edit rather than a package release. Only the two tokens CSS
+ * cannot know in advance come through inline.
+ *
+ * accent_color replaces the active chip's two-stop gradient with a single flat
+ * fill: one value cannot define two stops, so nothing is derived from it.
+ */
+function themeVars(theme) {
+    const vars = {
+        '--ahsuite-tiles-justify': theme.alignment === 'centered' ? 'center' : 'flex-start',
+    };
+    if (theme.accent_color) {
+        vars['--ahsuite-chip-active-bg'] = theme.accent_color;
+        vars['--ahsuite-chip-active-image'] = 'none';
+    }
+    return vars;
+}
+export { themeVars };
+//# sourceMappingURL=theme.js.map

package/dist/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAKb;;;;;;;GAOG;AACH,SAAS,SAAS,CAAC,KAAe;IAChC,MAAM,IAAI,GAA2B;QACnC,yBAAyB,EAAE,KAAK,CAAC,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY;KACpF,CAAC;IACF,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;QACvB,IAAI,CAAC,0BAA0B,CAAC,GAAG,KAAK,CAAC,YAAY,CAAC;QACtD,IAAI,CAAC,6BAA6B,CAAC,GAAG,MAAM,CAAC;IAC/C,CAAC;IACD,OAAO,IAAqB,CAAC;AAC/B,CAAC;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,50 @@
+/**
+ * The wire shape of GET /rest/nav-config.
+ *
+ * The contract is additive: within a schema_version fields are only ever added,
+ * never removed or repurposed. Renderers ignore fields they do not recognise and
+ * degrade rather than throw on a higher schema_version, so an asynchronously
+ * deployed fleet can run mixed renderer versions against one payload.
+ */
+type NavThemeMode = 'dark' | 'light';
+type NavAlignment = 'left' | 'centered';
+interface NavTheme {
+    mode: NavThemeMode;
+    accent_color: string | null;
+    alignment: NavAlignment;
+}
+interface NavLogo {
+    label: string;
+    href: string;
+}
+interface NavApp {
+    id: string;
+    label: string;
+    icon: string;
+    href: string;
+    enabled: boolean;
+}
+interface NavConfigPayload {
+    schema_version: number;
+    theme: NavTheme;
+    logo: NavLogo;
+    apps: NavApp[];
+}
+/**
+ * One entry as the renderer sees it. `navigable` is false for the host's own app
+ * when the catalog gives it no destination: it still renders and is still
+ * indicated, but as an inert chip rather than a broken link.
+ */
+interface ResolvedNavApp {
+    app: NavApp;
+    active: boolean;
+    navigable: boolean;
+}
+/** The single seam a host's analytics hooks into. Fired immediately before navigation. */
+interface NavAppClickArgs {
+    app: NavApp;
+    activeAppId: string;
+    collapsed: boolean;
+}
+export type { NavAlignment, NavApp, NavAppClickArgs, NavConfigPayload, NavLogo, NavTheme, NavThemeMode, ResolvedNavApp, };
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,KAAK,YAAY,GAAG,MAAM,GAAG,OAAO,CAAC;AAErC,KAAK,YAAY,GAAG,MAAM,GAAG,UAAU,CAAC;AAExC,UAAU,QAAQ;IAChB,IAAI,EAAE,YAAY,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,YAAY,CAAC;CACzB;AAED,UAAU,OAAO;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,MAAM;IACd,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,UAAU,gBAAgB;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,QAAQ,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED;;;;GAIG;AACH,UAAU,cAAc;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,0FAA0F;AAC1F,UAAU,eAAe;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,YAAY,EACV,YAAY,EACZ,MAAM,EACN,eAAe,EACf,gBAAgB,EAChB,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,cAAc,GACf,CAAC"}

package/dist/types.js

@@ -0,0 +1,10 @@
+/**
+ * The wire shape of GET /rest/nav-config.
+ *
+ * The contract is additive: within a schema_version fields are only ever added,
+ * never removed or repurposed. Renderers ignore fields they do not recognise and
+ * degrade rather than throw on a higher schema_version, so an asynchronously
+ * deployed fleet can run mixed renderer versions against one payload.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@artstorefronts/arthelper-nav",
+  "version": "0.1.0-alpha.0",
+  "description": "The ArtHelper suite navigation bar — a config-driven, cross-origin app switcher.",
+  "license": "ISC",
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "/dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc && node --import tsx build.ts",
+    "test": "vitest --watch=false"
+  },
+  "peerDependencies": {
+    "lucide-react": ">=0.446.0",
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@testing-library/dom": "^10.4.0",
+    "@testing-library/react": "^16.3.2",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "jsdom": "^26.1.0",
+    "lucide-react": "^0.446.0",
+    "react": "19.1.2",
+    "react-dom": "19.1.2",
+    "tsx": "^4.0.0",
+    "typescript": "^5.6.2",
+    "vitest": "^3.2.4"
+  }
+}