@wippy-fe/router 0.0.34 → 0.0.35

package/dist/index.d.ts

@@ -0,0 +1,290 @@
+import { host, on } from '@wippy-fe/proxy';
+export { ClassifierContext, LinkClassification, LinkKind, classifyLink, setLocalRouter } from '@wippy-fe/proxy';
+import { RouteRecordRaw, Router, RouteLocationRaw } from 'vue-router';
+import * as vue from 'vue';
+import { PropType } from 'vue';
+
+interface CreateAppRouterOptions {
+    /**
+     * Initial route path to prime history with. Usually `config.context?.route`
+     * or the subapp's current location from its mount context.
+     */
+    initialPath?: string;
+    /**
+     * Override the host API (testing / dev harness). Defaults to the `host`
+     * export from `@wippy-fe/proxy`.
+     */
+    host?: typeof host;
+    /**
+     * Override the event subscription API. Set to `null` to disable the
+     * `@history` subscription entirely. Defaults to `on` from `@wippy-fe/proxy`.
+     */
+    on?: typeof on | null;
+}
+/**
+ * Canonical memory-router factory for Wippy subapps.
+ *
+ * Every subapp currently duplicates the same boilerplate:
+ *   - create a memory history
+ *   - prime it with an initial path from context
+ *   - call `host.onRouteChanged` in `afterEach`
+ *   - listen for `@history` events from the host and mirror them to the router
+ *
+ * This factory encapsulates that boilerplate so subapps become one-liners:
+ *
+ *   ```ts
+ *   import { createAppRouter } from '@wippy-fe/router'
+ *   import { routes } from './routes'
+ *
+ *   const router = createAppRouter(routes, {
+ *     initialPath: appConfig.context?.route,
+ *   })
+ *   app.use(router)
+ *   ```
+ *
+ * Memory history is hardcoded — srcdoc iframes do not support `createWebHistory`
+ * (confirmed dead end — `window.location` is non-configurable in srcdoc, and
+ * framework routers read `location.pathname` directly). Only memory-based
+ * routing works inside child iframes.
+ */
+declare function createAppRouter(routes: RouteRecordRaw[], options?: CreateAppRouterOptions): Router;
+
+/**
+ * Explicit host-level navigation link. Use when you want to navigate
+ * to a known host page regardless of the current nesting level.
+ *
+ * Unlike `AutoRouterLink` (which classifies links automatically),
+ * `HostRouterLink` ALWAYS sends navigation to the host via postMessage.
+ *
+ * Use cases:
+ *   - Inside a nav-owner child linking to a different host page
+ *   - Anywhere you explicitly want host-level navigation
+ *
+ * Renders a real `<a>` for accessibility / right-click / SEO.
+ * Left-click calls `host.navigate()`. Modifier keys (ctrl, meta, shift)
+ * fall through to the browser default (open in new tab).
+ */
+declare const HostRouterLink: vue.DefineComponent<vue.ExtractPropTypes<{
+    to: {
+        type: PropType<string>;
+        required: true;
+    };
+}>, () => vue.VNode<vue.RendererNode, vue.RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {}, string, vue.PublicProps, Readonly<vue.ExtractPropTypes<{
+    to: {
+        type: PropType<string>;
+        required: true;
+    };
+}>> & Readonly<{}>, {}, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
+
+/**
+ * Drop-in replacement for Vue Router's `<RouterLink>` that classifies the
+ * target href and dispatches intelligently:
+ *
+ *   - `host-nav`   → preventDefault + `host.navigate(href)` via postMessage
+ *   - `child-nav`  → delegate to the real `<RouterLink>` (normal in-app nav)
+ *   - `external`   → render an `<a>` with `target="_blank" rel="noopener"`
+ *   - `ignore`     → render an `<a>` with a click-preventing handler
+ *
+ * Subapps migrate by changing a single import:
+ *
+ *   ```ts
+ *   // before
+ *   import { RouterLink } from 'vue-router'
+ *
+ *   // after
+ *   import { RouterLink } from '@wippy-fe/router'
+ *   ```
+ *
+ * Props are a compatible subset of vue-router's RouterLink. Slot API
+ * mirrors the default (non-custom) slot of the real RouterLink.
+ */
+declare const AutoRouterLink: vue.DefineComponent<vue.ExtractPropTypes<{
+    to: {
+        type: PropType<RouteLocationRaw>;
+        required: true;
+    };
+    replace: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    activeClass: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    exactActiveClass: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    ariaCurrentValue: {
+        type: PropType<"page" | "step" | "location" | "date" | "time" | "true" | "false">;
+        default: string;
+    };
+    /**
+     * For `external` kind: sets the anchor's target attribute.
+     * Defaults to `_blank` with safe `rel`. Pass empty string for same-tab.
+     */
+    externalTarget: {
+        type: StringConstructor;
+        default: string;
+    };
+}>, () => vue.VNode<vue.RendererNode, vue.RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {}, string, vue.PublicProps, Readonly<vue.ExtractPropTypes<{
+    to: {
+        type: PropType<RouteLocationRaw>;
+        required: true;
+    };
+    replace: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    activeClass: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    exactActiveClass: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    ariaCurrentValue: {
+        type: PropType<"page" | "step" | "location" | "date" | "time" | "true" | "false">;
+        default: string;
+    };
+    /**
+     * For `external` kind: sets the anchor's target attribute.
+     * Defaults to `_blank` with safe `rel`. Pass empty string for same-tab.
+     */
+    externalTarget: {
+        type: StringConstructor;
+        default: string;
+    };
+}>> & Readonly<{}>, {
+    replace: boolean;
+    activeClass: string;
+    exactActiveClass: string;
+    ariaCurrentValue: "time" | "page" | "step" | "location" | "date" | "true" | "false";
+    externalTarget: string;
+}, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
+/** @deprecated Use AutoRouterLink instead */
+declare const RouterLink: vue.DefineComponent<vue.ExtractPropTypes<{
+    to: {
+        type: PropType<RouteLocationRaw>;
+        required: true;
+    };
+    replace: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    activeClass: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    exactActiveClass: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    ariaCurrentValue: {
+        type: PropType<"page" | "step" | "location" | "date" | "time" | "true" | "false">;
+        default: string;
+    };
+    /**
+     * For `external` kind: sets the anchor's target attribute.
+     * Defaults to `_blank` with safe `rel`. Pass empty string for same-tab.
+     */
+    externalTarget: {
+        type: StringConstructor;
+        default: string;
+    };
+}>, () => vue.VNode<vue.RendererNode, vue.RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {}, string, vue.PublicProps, Readonly<vue.ExtractPropTypes<{
+    to: {
+        type: PropType<RouteLocationRaw>;
+        required: true;
+    };
+    replace: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    activeClass: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    exactActiveClass: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    ariaCurrentValue: {
+        type: PropType<"page" | "step" | "location" | "date" | "time" | "true" | "false">;
+        default: string;
+    };
+    /**
+     * For `external` kind: sets the anchor's target attribute.
+     * Defaults to `_blank` with safe `rel`. Pass empty string for same-tab.
+     */
+    externalTarget: {
+        type: StringConstructor;
+        default: string;
+    };
+}>> & Readonly<{}>, {
+    replace: boolean;
+    activeClass: string;
+    exactActiveClass: string;
+    ariaCurrentValue: "time" | "page" | "step" | "location" | "date" | "true" | "false";
+    externalTarget: string;
+}, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
+
+/**
+ * Client-side validator for mountRoute patterns.
+ *
+ * This mirrors the backend (wippy-framework/src/views/page_registry.lua)
+ * validator logic. The backend is the authoritative source — the frontend
+ * re-validates as a defensive safety net for two scenarios:
+ *
+ *   1. A subapp receives `mountRoutes` from `ChildAppConfig` and wants to
+ *      sanity-check them before registering or relying on them (e.g. during
+ *      nested-navigation mount, if a subapp acts as a mini-host).
+ *   2. The host's `syncMountRoutes` calls this to detect conflicts before
+ *      mutating the live Vue Router (fail-fast with a clear error rather
+ *      than leaving the router in a hybrid state).
+ *
+ * The validator is intentionally strict. v1 accepts ONLY the canonical form:
+ *   /:part(.*)*                 root mount
+ *   /<literal>/:part(.*)*       prefix mount (one or more literal segments)
+ *   /<lit1>/<lit2>/:part(.*)*   nested prefix mount
+ *
+ * Literal segments must match `[a-z0-9-]+` (lowercase alphanumerics + hyphens).
+ * The param name `:part` (not `:pathMatch`) matches gen-2-chat's existing
+ * `/c/:id/:part*` convention, so `route.params.part` is a uniform shape
+ * regardless of whether a page was reached via a mount route or via `/c/<id>`.
+ */
+declare const MOUNT_ROUTE_V1_REGEX: RegExp;
+type MountRouteIssueKind = 'syntax' | 'duplicate';
+interface MountRouteIssue {
+    kind: MountRouteIssueKind;
+    mountRoute: string;
+    pageId: string;
+    conflictingPageId?: string;
+}
+declare class MountRouteValidationError extends Error {
+    readonly issues: MountRouteIssue[];
+    constructor(issues: MountRouteIssue[]);
+}
+/**
+ * Validate an array of [mountRoute, pageId] tuples.
+ * Returns every issue found (does not stop at first). Empty result = clean.
+ *
+ * Accepts tuples (not a plain object) so duplicate mount routes surface as
+ * separate entries rather than being silently collapsed by object-key dedup.
+ */
+declare function validateMountRoutes(entries: Array<[mountRoute: string, pageId: string]>): MountRouteIssue[];
+/**
+ * Assert that a map of mountRoutes is valid. Throws MountRouteValidationError
+ * with a detailed message on any issue. Convenience for subapps that want to
+ * fail-fast rather than iterate the issues themselves.
+ */
+declare function assertValidMountRoutes(mountRoutes: Record<string, string>): void;
+
+export { AutoRouterLink, type CreateAppRouterOptions, HostRouterLink, MOUNT_ROUTE_V1_REGEX, type MountRouteIssue, type MountRouteIssueKind, MountRouteValidationError, RouterLink, assertValidMountRoutes, createAppRouter, validateMountRoutes };

package/dist/index.js

@@ -0,0 +1,235 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/classify.ts
+import { classifyLink, setLocalRouter } from "@wippy-fe/proxy";
+
+// src/create-app-router.ts
+import { host as defaultHost, on as defaultOn, setLocalRouter as setLocalRouter2 } from "@wippy-fe/proxy";
+import { createMemoryHistory, createRouter } from "vue-router";
+function createAppRouter(routes, options = {}) {
+  const host3 = options.host ?? defaultHost;
+  const on = options.on === void 0 ? defaultOn : options.on;
+  const history = createMemoryHistory();
+  if (options.initialPath)
+    history.replace(options.initialPath);
+  const router = createRouter({ history, routes });
+  setLocalRouter2((path) => router.resolve(path));
+  let lastAppliedNavId;
+  router.afterEach((to) => {
+    const navId = lastAppliedNavId;
+    lastAppliedNavId = void 0;
+    host3.onRouteChanged(to.fullPath, navId);
+  });
+  if (on) {
+    on("@history", ({ path, navId }) => {
+      if (!path)
+        return;
+      if (navId !== void 0)
+        lastAppliedNavId = navId;
+      const normalized = path.startsWith("/") ? path : `/${path}`;
+      if (router.currentRoute.value.fullPath !== normalized)
+        router.push(normalized);
+    });
+  }
+  return router;
+}
+
+// src/host-router-link.ts
+import { host } from "@wippy-fe/proxy";
+import { defineComponent, h } from "vue";
+var HostRouterLink = defineComponent({
+  name: "WippyHostRouterLink",
+  props: {
+    to: {
+      type: String,
+      required: true
+    }
+  },
+  setup(props, { slots }) {
+    return () => h(
+      "a",
+      {
+        href: props.to,
+        onClick: (e) => {
+          if (e.defaultPrevented || e.button !== 0)
+            return;
+          if (e.metaKey || e.altKey || e.ctrlKey || e.shiftKey)
+            return;
+          e.preventDefault();
+          host.navigate(props.to);
+        }
+      },
+      slots.default?.()
+    );
+  }
+});
+
+// src/router-link.ts
+import { host as host2 } from "@wippy-fe/proxy";
+import { defineComponent as defineComponent2, h as h2 } from "vue";
+import { useRouter, RouterLink as VueRouterLink } from "vue-router";
+var AutoRouterLink = defineComponent2({
+  name: "WippyAutoRouterLink",
+  props: {
+    to: {
+      type: [String, Object],
+      required: true
+    },
+    replace: {
+      type: Boolean,
+      default: false
+    },
+    activeClass: {
+      type: String,
+      default: void 0
+    },
+    exactActiveClass: {
+      type: String,
+      default: void 0
+    },
+    ariaCurrentValue: {
+      type: String,
+      default: "page"
+    },
+    /**
+     * For `external` kind: sets the anchor's target attribute.
+     * Defaults to `_blank` with safe `rel`. Pass empty string for same-tab.
+     */
+    externalTarget: {
+      type: String,
+      default: "_blank"
+    }
+  },
+  setup(props, { slots }) {
+    const router = useRouter();
+    return () => {
+      const resolved = router.resolve(props.to);
+      const classification = host2.classifyLink(resolved.href);
+      if (classification.kind === "host-nav") {
+        return h2(
+          "a",
+          {
+            "href": resolved.href,
+            "onClick": (event) => {
+              if (event.defaultPrevented)
+                return;
+              if (event.button !== 0)
+                return;
+              if (event.metaKey || event.altKey || event.ctrlKey || event.shiftKey)
+                return;
+              event.preventDefault();
+              host2.navigate(classification.normalizedPath ?? classification.href);
+            },
+            "aria-current": props.ariaCurrentValue
+          },
+          slots.default?.()
+        );
+      }
+      if (classification.kind === "external") {
+        const isBlank = props.externalTarget === "_blank";
+        return h2(
+          "a",
+          {
+            href: resolved.href,
+            target: props.externalTarget || void 0,
+            rel: isBlank ? "noopener noreferrer" : void 0
+          },
+          slots.default?.()
+        );
+      }
+      if (classification.kind === "ignore") {
+        return h2(
+          "a",
+          {
+            href: resolved.href || "#",
+            onClick: (event) => event.preventDefault()
+          },
+          slots.default?.()
+        );
+      }
+      return h2(
+        VueRouterLink,
+        {
+          to: props.to,
+          replace: props.replace,
+          activeClass: props.activeClass,
+          exactActiveClass: props.exactActiveClass,
+          ariaCurrentValue: props.ariaCurrentValue
+        },
+        slots.default ? { default: (scope) => slots.default?.(scope) } : void 0
+      );
+    };
+  }
+});
+var RouterLink = AutoRouterLink;
+
+// src/validate-mount-routes.ts
+var MOUNT_ROUTE_V1_REGEX = /^\/([a-z0-9-]+(\/[a-z0-9-]+)*\/)?:part\(\.\*\)\*$/;
+var MountRouteValidationError = class extends Error {
+  constructor(issues) {
+    super(formatMessage(issues));
+    __publicField(this, "issues", issues);
+    this.name = "MountRouteValidationError";
+  }
+};
+function formatMessage(issues) {
+  const lines = ["[wippy-fe/router] mountRoute validation failed:", ""];
+  for (const issue of issues) {
+    if (issue.kind === "syntax") {
+      lines.push(
+        `  \u2022 Page "${issue.pageId}" has invalid mountRoute "${issue.mountRoute}".`,
+        `    v1 only supports "/<literal>/:part(.*)*" and "/:part(.*)*".`
+      );
+    } else {
+      lines.push(
+        `  \u2022 Pages "${issue.pageId}" and "${issue.conflictingPageId}" both claim`,
+        `    mountRoute "${issue.mountRoute}". Mount routes must be unique.`
+      );
+    }
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+function validateMountRoutes(entries) {
+  const issues = [];
+  const seen = /* @__PURE__ */ new Map();
+  for (const [mountRoute, pageId] of entries) {
+    if (typeof mountRoute !== "string" || !MOUNT_ROUTE_V1_REGEX.test(mountRoute)) {
+      issues.push({ kind: "syntax", mountRoute: String(mountRoute), pageId });
+      continue;
+    }
+    const previousOwner = seen.get(mountRoute);
+    if (previousOwner && previousOwner !== pageId) {
+      issues.push({
+        kind: "duplicate",
+        mountRoute,
+        pageId,
+        conflictingPageId: previousOwner
+      });
+      continue;
+    }
+    seen.set(mountRoute, pageId);
+  }
+  return issues;
+}
+function assertValidMountRoutes(mountRoutes) {
+  const entries = Object.entries(mountRoutes);
+  const issues = validateMountRoutes(entries);
+  if (issues.length > 0)
+    throw new MountRouteValidationError(issues);
+}
+export {
+  AutoRouterLink,
+  HostRouterLink,
+  MOUNT_ROUTE_V1_REGEX,
+  MountRouteValidationError,
+  RouterLink,
+  assertValidMountRoutes,
+  classifyLink,
+  createAppRouter,
+  setLocalRouter,
+  validateMountRoutes
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/classify.ts","../src/create-app-router.ts","../src/host-router-link.ts","../src/router-link.ts","../src/validate-mount-routes.ts"],"sourcesContent":["/**\n * Re-export of the link classifier from @wippy-fe/proxy for one-import\n * convenience in Vue subapps. Canonical home for the classifier is\n * @wippy-fe/proxy — vanilla JS subapps should import directly from there.\n */\nexport { classifyLink, setLocalRouter } from '@wippy-fe/proxy'\nexport type {\n  ClassifierContext,\n  LinkClassification,\n  LinkKind,\n} from '@wippy-fe/proxy'\n","import type { Router, RouteRecordRaw } from 'vue-router'\nimport { host as defaultHost, on as defaultOn, setLocalRouter } from '@wippy-fe/proxy'\nimport { createMemoryHistory, createRouter } from 'vue-router'\n\nexport interface CreateAppRouterOptions {\n  /**\n   * Initial route path to prime history with. Usually `config.context?.route`\n   * or the subapp's current location from its mount context.\n   */\n  initialPath?: string\n  /**\n   * Override the host API (testing / dev harness). Defaults to the `host`\n   * export from `@wippy-fe/proxy`.\n   */\n  host?: typeof defaultHost\n  /**\n   * Override the event subscription API. Set to `null` to disable the\n   * `@history` subscription entirely. Defaults to `on` from `@wippy-fe/proxy`.\n   */\n  on?: typeof defaultOn | null\n}\n\n/**\n * Canonical memory-router factory for Wippy subapps.\n *\n * Every subapp currently duplicates the same boilerplate:\n *   - create a memory history\n *   - prime it with an initial path from context\n *   - call `host.onRouteChanged` in `afterEach`\n *   - listen for `@history` events from the host and mirror them to the router\n *\n * This factory encapsulates that boilerplate so subapps become one-liners:\n *\n *   ```ts\n *   import { createAppRouter } from '@wippy-fe/router'\n *   import { routes } from './routes'\n *\n *   const router = createAppRouter(routes, {\n *     initialPath: appConfig.context?.route,\n *   })\n *   app.use(router)\n *   ```\n *\n * Memory history is hardcoded — srcdoc iframes do not support `createWebHistory`\n * (confirmed dead end — `window.location` is non-configurable in srcdoc, and\n * framework routers read `location.pathname` directly). Only memory-based\n * routing works inside child iframes.\n */\nexport function createAppRouter(\n  routes: RouteRecordRaw[],\n  options: CreateAppRouterOptions = {},\n): Router {\n  const host = options.host ?? defaultHost\n  const on = options.on === undefined ? defaultOn : options.on\n\n  const history = createMemoryHistory()\n  if (options.initialPath)\n    history.replace(options.initialPath)\n\n  const router = createRouter({ history, routes })\n\n  // Register this router with the link classifier so it can check own\n  // routes before falling back to mount route / system route matching.\n  setLocalRouter((path: string) => router.resolve(path))\n\n  // Track the last navId applied from a parent-initiated update.\n  // When the router navigates in response to a parent @history event,\n  // suppress the resulting afterEach from sending CmdRouteChanged back up\n  // (which would create an echo loop).\n  let lastAppliedNavId: number | undefined\n\n  router.afterEach((to) => {\n    // If this navigation was triggered by a parent @history update,\n    // pass the navId so the host can identify it as an echo and suppress.\n    const navId = lastAppliedNavId\n    lastAppliedNavId = undefined\n    host.onRouteChanged(to.fullPath, navId)\n  })\n\n  if (on) {\n    on('@history', ({ path, navId }: { path?: string, navId?: number }) => {\n      if (!path)\n        return\n      if (navId !== undefined)\n        lastAppliedNavId = navId\n      const normalized = path.startsWith('/') ? path : `/${path}`\n      if (router.currentRoute.value.fullPath !== normalized)\n        router.push(normalized)\n    })\n  }\n\n  return router\n}\n","import type { PropType } from 'vue'\nimport { host } from '@wippy-fe/proxy'\nimport { defineComponent, h } from 'vue'\n\n/**\n * Explicit host-level navigation link. Use when you want to navigate\n * to a known host page regardless of the current nesting level.\n *\n * Unlike `AutoRouterLink` (which classifies links automatically),\n * `HostRouterLink` ALWAYS sends navigation to the host via postMessage.\n *\n * Use cases:\n *   - Inside a nav-owner child linking to a different host page\n *   - Anywhere you explicitly want host-level navigation\n *\n * Renders a real `<a>` for accessibility / right-click / SEO.\n * Left-click calls `host.navigate()`. Modifier keys (ctrl, meta, shift)\n * fall through to the browser default (open in new tab).\n */\nexport const HostRouterLink = defineComponent({\n  name: 'WippyHostRouterLink',\n  props: {\n    to: {\n      type: String as PropType<string>,\n      required: true,\n    },\n  },\n  setup(props, { slots }) {\n    return () => h(\n      'a',\n      {\n        href: props.to,\n        onClick: (e: MouseEvent) => {\n          if (e.defaultPrevented || e.button !== 0)\n            return\n          if (e.metaKey || e.altKey || e.ctrlKey || e.shiftKey)\n            return\n          e.preventDefault()\n          host.navigate(props.to)\n        },\n      },\n      slots.default?.(),\n    )\n  },\n})\n","import type { PropType } from 'vue'\nimport type { RouteLocationRaw } from 'vue-router'\nimport { host } from '@wippy-fe/proxy'\nimport { defineComponent, h } from 'vue'\nimport { useRouter, RouterLink as VueRouterLink } from 'vue-router'\n\n/**\n * Drop-in replacement for Vue Router's `<RouterLink>` that classifies the\n * target href and dispatches intelligently:\n *\n *   - `host-nav`   → preventDefault + `host.navigate(href)` via postMessage\n *   - `child-nav`  → delegate to the real `<RouterLink>` (normal in-app nav)\n *   - `external`   → render an `<a>` with `target=\"_blank\" rel=\"noopener\"`\n *   - `ignore`     → render an `<a>` with a click-preventing handler\n *\n * Subapps migrate by changing a single import:\n *\n *   ```ts\n *   // before\n *   import { RouterLink } from 'vue-router'\n *\n *   // after\n *   import { RouterLink } from '@wippy-fe/router'\n *   ```\n *\n * Props are a compatible subset of vue-router's RouterLink. Slot API\n * mirrors the default (non-custom) slot of the real RouterLink.\n */\nexport const AutoRouterLink = defineComponent({\n  name: 'WippyAutoRouterLink',\n  props: {\n    to: {\n      type: [String, Object] as PropType<RouteLocationRaw>,\n      required: true,\n    },\n    replace: {\n      type: Boolean,\n      default: false,\n    },\n    activeClass: {\n      type: String,\n      default: undefined,\n    },\n    exactActiveClass: {\n      type: String,\n      default: undefined,\n    },\n    ariaCurrentValue: {\n      type: String as PropType<'page' | 'step' | 'location' | 'date' | 'time' | 'true' | 'false'>,\n      default: 'page',\n    },\n    /**\n     * For `external` kind: sets the anchor's target attribute.\n     * Defaults to `_blank` with safe `rel`. Pass empty string for same-tab.\n     */\n    externalTarget: {\n      type: String,\n      default: '_blank',\n    },\n  },\n  setup(props, { slots }) {\n    const router = useRouter()\n\n    return () => {\n      const resolved = router.resolve(props.to)\n      const classification = host.classifyLink(resolved.href)\n\n      if (classification.kind === 'host-nav') {\n        return h(\n          'a',\n          {\n            'href': resolved.href,\n            'onClick': (event: MouseEvent) => {\n              if (event.defaultPrevented)\n                return\n              if (event.button !== 0)\n                return\n              if (event.metaKey || event.altKey || event.ctrlKey || event.shiftKey)\n                return\n              event.preventDefault()\n              host.navigate(classification.normalizedPath ?? classification.href)\n            },\n            'aria-current': props.ariaCurrentValue,\n          },\n          slots.default?.(),\n        )\n      }\n\n      if (classification.kind === 'external') {\n        const isBlank = props.externalTarget === '_blank'\n        return h(\n          'a',\n          {\n            href: resolved.href,\n            target: props.externalTarget || undefined,\n            rel: isBlank ? 'noopener noreferrer' : undefined,\n          },\n          slots.default?.(),\n        )\n      }\n\n      if (classification.kind === 'ignore') {\n        return h(\n          'a',\n          {\n            href: resolved.href || '#',\n            onClick: (event: MouseEvent) => event.preventDefault(),\n          },\n          slots.default?.(),\n        )\n      }\n\n      // child-nav → delegate to real vue-router RouterLink\n      return h(\n        VueRouterLink,\n        {\n          to: props.to,\n          replace: props.replace,\n          activeClass: props.activeClass,\n          exactActiveClass: props.exactActiveClass,\n          ariaCurrentValue: props.ariaCurrentValue,\n        },\n        slots.default\n          ? { default: (scope: unknown) => slots.default?.(scope) }\n          : undefined,\n      )\n    }\n  },\n})\n\n/** @deprecated Use AutoRouterLink instead */\nexport const RouterLink = AutoRouterLink\n","/**\n * Client-side validator for mountRoute patterns.\n *\n * This mirrors the backend (wippy-framework/src/views/page_registry.lua)\n * validator logic. The backend is the authoritative source — the frontend\n * re-validates as a defensive safety net for two scenarios:\n *\n *   1. A subapp receives `mountRoutes` from `ChildAppConfig` and wants to\n *      sanity-check them before registering or relying on them (e.g. during\n *      nested-navigation mount, if a subapp acts as a mini-host).\n *   2. The host's `syncMountRoutes` calls this to detect conflicts before\n *      mutating the live Vue Router (fail-fast with a clear error rather\n *      than leaving the router in a hybrid state).\n *\n * The validator is intentionally strict. v1 accepts ONLY the canonical form:\n *   /:part(.*)*                 root mount\n *   /<literal>/:part(.*)*       prefix mount (one or more literal segments)\n *   /<lit1>/<lit2>/:part(.*)*   nested prefix mount\n *\n * Literal segments must match `[a-z0-9-]+` (lowercase alphanumerics + hyphens).\n * The param name `:part` (not `:pathMatch`) matches gen-2-chat's existing\n * `/c/:id/:part*` convention, so `route.params.part` is a uniform shape\n * regardless of whether a page was reached via a mount route or via `/c/<id>`.\n */\n\nexport const MOUNT_ROUTE_V1_REGEX = /^\\/([a-z0-9-]+(\\/[a-z0-9-]+)*\\/)?:part\\(\\.\\*\\)\\*$/\n\nexport type MountRouteIssueKind = 'syntax' | 'duplicate'\n\nexport interface MountRouteIssue {\n  kind: MountRouteIssueKind\n  mountRoute: string\n  pageId: string\n  conflictingPageId?: string\n}\n\nexport class MountRouteValidationError extends Error {\n  constructor(public readonly issues: MountRouteIssue[]) {\n    super(formatMessage(issues))\n    this.name = 'MountRouteValidationError'\n  }\n}\n\nfunction formatMessage(issues: MountRouteIssue[]): string {\n  const lines: string[] = ['[wippy-fe/router] mountRoute validation failed:', '']\n  for (const issue of issues) {\n    if (issue.kind === 'syntax') {\n      lines.push(\n        `  • Page \"${issue.pageId}\" has invalid mountRoute \"${issue.mountRoute}\".`,\n        `    v1 only supports \"/<literal>/:part(.*)*\" and \"/:part(.*)*\".`,\n      )\n    }\n    else {\n      lines.push(\n        `  • Pages \"${issue.pageId}\" and \"${issue.conflictingPageId}\" both claim`,\n        `    mountRoute \"${issue.mountRoute}\". Mount routes must be unique.`,\n      )\n    }\n    lines.push('')\n  }\n  return lines.join('\\n')\n}\n\n/**\n * Validate an array of [mountRoute, pageId] tuples.\n * Returns every issue found (does not stop at first). Empty result = clean.\n *\n * Accepts tuples (not a plain object) so duplicate mount routes surface as\n * separate entries rather than being silently collapsed by object-key dedup.\n */\nexport function validateMountRoutes(\n  entries: Array<[mountRoute: string, pageId: string]>,\n): MountRouteIssue[] {\n  const issues: MountRouteIssue[] = []\n  const seen = new Map<string, string>()\n\n  for (const [mountRoute, pageId] of entries) {\n    if (typeof mountRoute !== 'string' || !MOUNT_ROUTE_V1_REGEX.test(mountRoute)) {\n      issues.push({ kind: 'syntax', mountRoute: String(mountRoute), pageId })\n      continue\n    }\n    const previousOwner = seen.get(mountRoute)\n    if (previousOwner && previousOwner !== pageId) {\n      issues.push({\n        kind: 'duplicate',\n        mountRoute,\n        pageId,\n        conflictingPageId: previousOwner,\n      })\n      continue\n    }\n    seen.set(mountRoute, pageId)\n  }\n\n  return issues\n}\n\n/**\n * Assert that a map of mountRoutes is valid. Throws MountRouteValidationError\n * with a detailed message on any issue. Convenience for subapps that want to\n * fail-fast rather than iterate the issues themselves.\n */\nexport function assertValidMountRoutes(\n  mountRoutes: Record<string, string>,\n): void {\n  const entries: Array<[string, string]> = Object.entries(mountRoutes)\n  const issues = validateMountRoutes(entries)\n  if (issues.length > 0)\n    throw new MountRouteValidationError(issues)\n}\n"],"mappings":"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","names":["setLocalRouter","host","host","defineComponent","h"]}

package/package.json

@@ -1,18 +1,30 @@
 {
   "name": "@wippy-fe/router",
-  "version": "0.0.34",
-  "description": "Drop-in Vue Router helpers for Wippy subapps — RouterLink with host-nav detection, canonical memory-router factory, and link classifier re-export.",
+  "version": "0.0.35",
+  "description": "Drop-in Vue Router helpers for Wippy subapps - RouterLink with host-nav detection, canonical memory-router factory, and link classifier re-export.",
   "license": "UNLICENSED",
   "type": "module",
-  "main": "src/index.ts",
-  "types": "src/index.ts",
+  "sideEffects": false,
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
   "files": [
-    "src/",
-    "package.json"
+    "package.json",
+    "dist/"
   ],
   "peerDependencies": {
     "vue": "^3.5.0",
     "vue-router": "^4.5.0",
-    "@wippy-fe/proxy": "0.0.34"
+    "@wippy-fe/proxy": "^0.0.35"
+  },
+  "scripts": {
+    "build": "tsup"
   }
 }

package/src/classify.ts

@@ -1,11 +0,0 @@
-/**
- * Re-export of the link classifier from @wippy-fe/proxy for one-import
- * convenience in Vue subapps. Canonical home for the classifier is
- * @wippy-fe/proxy — vanilla JS subapps should import directly from there.
- */
-export { classifyLink, setLocalRouter } from '@wippy-fe/proxy'
-export type {
-  ClassifierContext,
-  LinkClassification,
-  LinkKind,
-} from '@wippy-fe/proxy'

package/src/create-app-router.ts

@@ -1,93 +0,0 @@
-import type { Router, RouteRecordRaw } from 'vue-router'
-import { host as defaultHost, on as defaultOn, setLocalRouter } from '@wippy-fe/proxy'
-import { createMemoryHistory, createRouter } from 'vue-router'
-
-export interface CreateAppRouterOptions {
-  /**
-   * Initial route path to prime history with. Usually `config.context?.route`
-   * or the subapp's current location from its mount context.
-   */
-  initialPath?: string
-  /**
-   * Override the host API (testing / dev harness). Defaults to the `host`
-   * export from `@wippy-fe/proxy`.
-   */
-  host?: typeof defaultHost
-  /**
-   * Override the event subscription API. Set to `null` to disable the
-   * `@history` subscription entirely. Defaults to `on` from `@wippy-fe/proxy`.
-   */
-  on?: typeof defaultOn | null
-}
-
-/**
- * Canonical memory-router factory for Wippy subapps.
- *
- * Every subapp currently duplicates the same boilerplate:
- *   - create a memory history
- *   - prime it with an initial path from context
- *   - call `host.onRouteChanged` in `afterEach`
- *   - listen for `@history` events from the host and mirror them to the router
- *
- * This factory encapsulates that boilerplate so subapps become one-liners:
- *
- *   ```ts
- *   import { createAppRouter } from '@wippy-fe/router'
- *   import { routes } from './routes'
- *
- *   const router = createAppRouter(routes, {
- *     initialPath: appConfig.context?.route,
- *   })
- *   app.use(router)
- *   ```
- *
- * Memory history is hardcoded — srcdoc iframes do not support `createWebHistory`
- * (confirmed dead end — `window.location` is non-configurable in srcdoc, and
- * framework routers read `location.pathname` directly). Only memory-based
- * routing works inside child iframes.
- */
-export function createAppRouter(
-  routes: RouteRecordRaw[],
-  options: CreateAppRouterOptions = {},
-): Router {
-  const host = options.host ?? defaultHost
-  const on = options.on === undefined ? defaultOn : options.on
-
-  const history = createMemoryHistory()
-  if (options.initialPath)
-    history.replace(options.initialPath)
-
-  const router = createRouter({ history, routes })
-
-  // Register this router with the link classifier so it can check own
-  // routes before falling back to mount route / system route matching.
-  setLocalRouter((path: string) => router.resolve(path))
-
-  // Track the last navId applied from a parent-initiated update.
-  // When the router navigates in response to a parent @history event,
-  // suppress the resulting afterEach from sending CmdRouteChanged back up
-  // (which would create an echo loop).
-  let lastAppliedNavId: number | undefined
-
-  router.afterEach((to) => {
-    // If this navigation was triggered by a parent @history update,
-    // pass the navId so the host can identify it as an echo and suppress.
-    const navId = lastAppliedNavId
-    lastAppliedNavId = undefined
-    host.onRouteChanged(to.fullPath, navId)
-  })
-
-  if (on) {
-    on('@history', ({ path, navId }: { path?: string, navId?: number }) => {
-      if (!path)
-        return
-      if (navId !== undefined)
-        lastAppliedNavId = navId
-      const normalized = path.startsWith('/') ? path : `/${path}`
-      if (router.currentRoute.value.fullPath !== normalized)
-        router.push(normalized)
-    })
-  }
-
-  return router
-}

package/src/host-router-link.ts

@@ -1,45 +0,0 @@
-import type { PropType } from 'vue'
-import { host } from '@wippy-fe/proxy'
-import { defineComponent, h } from 'vue'
-
-/**
- * Explicit host-level navigation link. Use when you want to navigate
- * to a known host page regardless of the current nesting level.
- *
- * Unlike `AutoRouterLink` (which classifies links automatically),
- * `HostRouterLink` ALWAYS sends navigation to the host via postMessage.
- *
- * Use cases:
- *   - Inside a nav-owner child linking to a different host page
- *   - Anywhere you explicitly want host-level navigation
- *
- * Renders a real `<a>` for accessibility / right-click / SEO.
- * Left-click calls `host.navigate()`. Modifier keys (ctrl, meta, shift)
- * fall through to the browser default (open in new tab).
- */
-export const HostRouterLink = defineComponent({
-  name: 'WippyHostRouterLink',
-  props: {
-    to: {
-      type: String as PropType<string>,
-      required: true,
-    },
-  },
-  setup(props, { slots }) {
-    return () => h(
-      'a',
-      {
-        href: props.to,
-        onClick: (e: MouseEvent) => {
-          if (e.defaultPrevented || e.button !== 0)
-            return
-          if (e.metaKey || e.altKey || e.ctrlKey || e.shiftKey)
-            return
-          e.preventDefault()
-          host.navigate(props.to)
-        },
-      },
-      slots.default?.(),
-    )
-  },
-})

package/src/index.ts

@@ -1,13 +0,0 @@
-export { classifyLink, setLocalRouter } from './classify'
-export type { ClassifierContext, LinkClassification, LinkKind } from './classify'
-export { createAppRouter, type CreateAppRouterOptions } from './create-app-router'
-export { HostRouterLink } from './host-router-link'
-export { AutoRouterLink, RouterLink } from './router-link'
-export {
-  assertValidMountRoutes,
-  MOUNT_ROUTE_V1_REGEX,
-  type MountRouteIssue,
-  type MountRouteIssueKind,
-  MountRouteValidationError,
-  validateMountRoutes,
-} from './validate-mount-routes'

package/src/router-link.ts

@@ -1,132 +0,0 @@
-import type { PropType } from 'vue'
-import type { RouteLocationRaw } from 'vue-router'
-import { host } from '@wippy-fe/proxy'
-import { defineComponent, h } from 'vue'
-import { useRouter, RouterLink as VueRouterLink } from 'vue-router'
-
-/**
- * Drop-in replacement for Vue Router's `<RouterLink>` that classifies the
- * target href and dispatches intelligently:
- *
- *   - `host-nav`   → preventDefault + `host.navigate(href)` via postMessage
- *   - `child-nav`  → delegate to the real `<RouterLink>` (normal in-app nav)
- *   - `external`   → render an `<a>` with `target="_blank" rel="noopener"`
- *   - `ignore`     → render an `<a>` with a click-preventing handler
- *
- * Subapps migrate by changing a single import:
- *
- *   ```ts
- *   // before
- *   import { RouterLink } from 'vue-router'
- *
- *   // after
- *   import { RouterLink } from '@wippy-fe/router'
- *   ```
- *
- * Props are a compatible subset of vue-router's RouterLink. Slot API
- * mirrors the default (non-custom) slot of the real RouterLink.
- */
-export const AutoRouterLink = defineComponent({
-  name: 'WippyAutoRouterLink',
-  props: {
-    to: {
-      type: [String, Object] as PropType<RouteLocationRaw>,
-      required: true,
-    },
-    replace: {
-      type: Boolean,
-      default: false,
-    },
-    activeClass: {
-      type: String,
-      default: undefined,
-    },
-    exactActiveClass: {
-      type: String,
-      default: undefined,
-    },
-    ariaCurrentValue: {
-      type: String as PropType<'page' | 'step' | 'location' | 'date' | 'time' | 'true' | 'false'>,
-      default: 'page',
-    },
-    /**
-     * For `external` kind: sets the anchor's target attribute.
-     * Defaults to `_blank` with safe `rel`. Pass empty string for same-tab.
-     */
-    externalTarget: {
-      type: String,
-      default: '_blank',
-    },
-  },
-  setup(props, { slots }) {
-    const router = useRouter()
-
-    return () => {
-      const resolved = router.resolve(props.to)
-      const classification = host.classifyLink(resolved.href)
-
-      if (classification.kind === 'host-nav') {
-        return h(
-          'a',
-          {
-            'href': resolved.href,
-            'onClick': (event: MouseEvent) => {
-              if (event.defaultPrevented)
-                return
-              if (event.button !== 0)
-                return
-              if (event.metaKey || event.altKey || event.ctrlKey || event.shiftKey)
-                return
-              event.preventDefault()
-              host.navigate(classification.normalizedPath ?? classification.href)
-            },
-            'aria-current': props.ariaCurrentValue,
-          },
-          slots.default?.(),
-        )
-      }
-
-      if (classification.kind === 'external') {
-        const isBlank = props.externalTarget === '_blank'
-        return h(
-          'a',
-          {
-            href: resolved.href,
-            target: props.externalTarget || undefined,
-            rel: isBlank ? 'noopener noreferrer' : undefined,
-          },
-          slots.default?.(),
-        )
-      }
-
-      if (classification.kind === 'ignore') {
-        return h(
-          'a',
-          {
-            href: resolved.href || '#',
-            onClick: (event: MouseEvent) => event.preventDefault(),
-          },
-          slots.default?.(),
-        )
-      }
-
-      // child-nav → delegate to real vue-router RouterLink
-      return h(
-        VueRouterLink,
-        {
-          to: props.to,
-          replace: props.replace,
-          activeClass: props.activeClass,
-          exactActiveClass: props.exactActiveClass,
-          ariaCurrentValue: props.ariaCurrentValue,
-        },
-        slots.default
-          ? { default: (scope: unknown) => slots.default?.(scope) }
-          : undefined,
-      )
-    }
-  },
-})
-
-/** @deprecated Use AutoRouterLink instead */
-export const RouterLink = AutoRouterLink

package/src/validate-mount-routes.ts

@@ -1,110 +0,0 @@
-/**
- * Client-side validator for mountRoute patterns.
- *
- * This mirrors the backend (wippy-framework/src/views/page_registry.lua)
- * validator logic. The backend is the authoritative source — the frontend
- * re-validates as a defensive safety net for two scenarios:
- *
- *   1. A subapp receives `mountRoutes` from `ChildAppConfig` and wants to
- *      sanity-check them before registering or relying on them (e.g. during
- *      nested-navigation mount, if a subapp acts as a mini-host).
- *   2. The host's `syncMountRoutes` calls this to detect conflicts before
- *      mutating the live Vue Router (fail-fast with a clear error rather
- *      than leaving the router in a hybrid state).
- *
- * The validator is intentionally strict. v1 accepts ONLY the canonical form:
- *   /:part(.*)*                 root mount
- *   /<literal>/:part(.*)*       prefix mount (one or more literal segments)
- *   /<lit1>/<lit2>/:part(.*)*   nested prefix mount
- *
- * Literal segments must match `[a-z0-9-]+` (lowercase alphanumerics + hyphens).
- * The param name `:part` (not `:pathMatch`) matches gen-2-chat's existing
- * `/c/:id/:part*` convention, so `route.params.part` is a uniform shape
- * regardless of whether a page was reached via a mount route or via `/c/<id>`.
- */
-
-export const MOUNT_ROUTE_V1_REGEX = /^\/([a-z0-9-]+(\/[a-z0-9-]+)*\/)?:part\(\.\*\)\*$/
-
-export type MountRouteIssueKind = 'syntax' | 'duplicate'
-
-export interface MountRouteIssue {
-  kind: MountRouteIssueKind
-  mountRoute: string
-  pageId: string
-  conflictingPageId?: string
-}
-
-export class MountRouteValidationError extends Error {
-  constructor(public readonly issues: MountRouteIssue[]) {
-    super(formatMessage(issues))
-    this.name = 'MountRouteValidationError'
-  }
-}
-
-function formatMessage(issues: MountRouteIssue[]): string {
-  const lines: string[] = ['[wippy-fe/router] mountRoute validation failed:', '']
-  for (const issue of issues) {
-    if (issue.kind === 'syntax') {
-      lines.push(
-        `  • Page "${issue.pageId}" has invalid mountRoute "${issue.mountRoute}".`,
-        `    v1 only supports "/<literal>/:part(.*)*" and "/:part(.*)*".`,
-      )
-    }
-    else {
-      lines.push(
-        `  • Pages "${issue.pageId}" and "${issue.conflictingPageId}" both claim`,
-        `    mountRoute "${issue.mountRoute}". Mount routes must be unique.`,
-      )
-    }
-    lines.push('')
-  }
-  return lines.join('\n')
-}
-
-/**
- * Validate an array of [mountRoute, pageId] tuples.
- * Returns every issue found (does not stop at first). Empty result = clean.
- *
- * Accepts tuples (not a plain object) so duplicate mount routes surface as
- * separate entries rather than being silently collapsed by object-key dedup.
- */
-export function validateMountRoutes(
-  entries: Array<[mountRoute: string, pageId: string]>,
-): MountRouteIssue[] {
-  const issues: MountRouteIssue[] = []
-  const seen = new Map<string, string>()
-
-  for (const [mountRoute, pageId] of entries) {
-    if (typeof mountRoute !== 'string' || !MOUNT_ROUTE_V1_REGEX.test(mountRoute)) {
-      issues.push({ kind: 'syntax', mountRoute: String(mountRoute), pageId })
-      continue
-    }
-    const previousOwner = seen.get(mountRoute)
-    if (previousOwner && previousOwner !== pageId) {
-      issues.push({
-        kind: 'duplicate',
-        mountRoute,
-        pageId,
-        conflictingPageId: previousOwner,
-      })
-      continue
-    }
-    seen.set(mountRoute, pageId)
-  }
-
-  return issues
-}
-
-/**
- * Assert that a map of mountRoutes is valid. Throws MountRouteValidationError
- * with a detailed message on any issue. Convenience for subapps that want to
- * fail-fast rather than iterate the issues themselves.
- */
-export function assertValidMountRoutes(
-  mountRoutes: Record<string, string>,
-): void {
-  const entries: Array<[string, string]> = Object.entries(mountRoutes)
-  const issues = validateMountRoutes(entries)
-  if (issues.length > 0)
-    throw new MountRouteValidationError(issues)
-}