@herdingbits/trailhead-core 0.0.15 → 0.0.16

package/README.md

@@ -34,7 +34,8 @@ import { YourAdapter } from '@herdingbits/trailhead-your-design-system';
 
 const shell = new Trailhead({
   adapter: new YourAdapter(),
-  basePath: '/app',
+  appBasePath: '/app',       // URL prefix where SPAs are hosted
+  shellUrl: '/app',          // URL where shell.js and navigation.json are served (defaults to appBasePath)
   apiUrl: 'https://api.example.com'
 });
 ```

package/dist/adapters/types.d.ts

@@ -61,7 +61,7 @@ export interface DesignSystemAdapter {
      * Called once at shell startup. Register web component base paths,
      * inject global stylesheets, or perform any other design-system-specific setup.
      */
-    init(basePath: string): Promise<void>;
+    init(shellUrl: string): Promise<void>;
     /** Feedback implementation backed by this adapter's design system components. */
     feedback: FeedbackAdapter;
 }

package/dist/shell.d.ts

@@ -9,12 +9,12 @@ import type { DesignSystemAdapter } from "./adapters/types.js";
 export interface ShellConfig {
     /** Design system adapter that backs all shell UI — toasts, dialogs, and busy overlays. */
     adapter: DesignSystemAdapter;
-    /** URL prefix under which the shell is hosted (e.g., `"/sample/trailhead"`). Used to strip the prefix from routes and prepend it to SPA asset URLs. */
-    basePath?: string;
+    /** URL prefix under which SPAs are hosted (e.g., `"/sample/trailhead"`). Used to strip the prefix from routes, construct SPA asset URLs, and build navigation links. */
+    appBasePath?: string;
     /** Base URL prepended to all SPA HTTP requests made via `shell.http`. */
     apiUrl?: string;
-    /** URL from which shell static assets (e.g., `navigation.json`) are fetched. Defaults to `basePath`. */
-    shellResourceUrl?: string;
+    /** URL from which the shell bundle and static assets (e.g., `navigation.json`) are fetched. Defaults to `appBasePath`. */
+    shellUrl?: string;
 }
 /**
  * The Trailhead shell. Bootstraps the micro-frontend host by loading navigation config,
@@ -31,9 +31,9 @@ export interface ShellConfig {
 export declare class Trailhead {
     private navigation;
     private routeChangeCallbacks;
-    /** URL prefix under which the shell is hosted. Empty string when hosted at the root. */
-    readonly basePath: string;
-    private readonly shellResourceUrl;
+    /** URL prefix under which SPAs are hosted. Empty string when hosted at the root. */
+    readonly appBasePath: string;
+    private readonly shellUrl;
     /** The active design system adapter supplying UI components to the shell. */
     readonly adapter: DesignSystemAdapter;
     /**

package/dist/shell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../src/shell.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAY,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAI/D;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,0FAA0F;IAC1F,OAAO,EAAE,mBAAmB,CAAC;IAE7B,uJAAuJ;IACvJ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,wGAAwG;IACxG,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,UAAU,CAAiB;IACnC,OAAO,CAAC,oBAAoB,CAAqC;IAEjE,wFAAwF;IACxF,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAE1C,6EAA6E;IAC7E,SAAgB,OAAO,EAAE,mBAAmB,CAAC;IAE7C;;;;;OAKG;gBACS,MAAM,EAAE,WAAW;IAO/B;;;OAGG;IACI,aAAa,IAAI,OAAO,EAAE;IAIjC;;OAEG;YACW,IAAI;IAwBlB;;OAEG;YACW,WAAW;IAUzB;;OAEG;IACH,OAAO,CAAC,SAAS;IAiFjB;;OAEG;YACW,cAAc;IAU5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA6BxB;;OAEG;IACH,OAAO,CAAC,YAAY;IAMpB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAIhB;;OAEG;IACH,OAAO,CAAC,WAAW;IAsBnB;;OAEG;IACH,OAAO,CAAC,eAAe;IAavB;;OAEG;YACW,UAAU;CAqDzB"}
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../src/shell.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAY,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAI/D;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,0FAA0F;IAC1F,OAAO,EAAE,mBAAmB,CAAC;IAE7B,wKAAwK;IACxK,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,0HAA0H;IAC1H,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,UAAU,CAAiB;IACnC,OAAO,CAAC,oBAAoB,CAAqC;IAEjE,oFAAoF;IACpF,SAAgB,WAAW,EAAE,MAAM,CAAC;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAElC,6EAA6E;IAC7E,SAAgB,OAAO,EAAE,mBAAmB,CAAC;IAE7C;;;;;OAKG;gBACS,MAAM,EAAE,WAAW;IAO/B;;;OAGG;IACI,aAAa,IAAI,OAAO,EAAE;IAIjC;;OAEG;YACW,IAAI;IAwBlB;;OAEG;YACW,WAAW;IAUzB;;OAEG;IACH,OAAO,CAAC,SAAS;IAiFjB;;OAEG;YACW,cAAc;IAU5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA6BxB;;OAEG;IACH,OAAO,CAAC,YAAY;IAMpB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAIhB;;OAEG;IACH,OAAO,CAAC,WAAW;IAsBnB;;OAEG;IACH,OAAO,CAAC,eAAe;IAavB;;OAEG;YACW,UAAU;CAqDzB"}

package/dist/shell.js

@@ -22,8 +22,8 @@ export class Trailhead {
     constructor(config) {
         this.navigation = [];
         this.routeChangeCallbacks = [];
-        this.basePath = config.basePath || "";
-        this.shellResourceUrl = config.shellResourceUrl || this.basePath;
+        this.appBasePath = config.appBasePath || "";
+        this.shellUrl = config.shellUrl || this.appBasePath;
         this.adapter = config.adapter;
         this.init(config.apiUrl);
     }
@@ -59,7 +59,7 @@ export class Trailhead {
      */
     async initAdapter() {
         try {
-            await this.adapter.init(this.basePath);
+            await this.adapter.init(this.shellUrl);
             console.log(`[Trailhead] Initialized ${this.adapter.name} adapter v${this.adapter.version}`);
         }
         catch (error) {
@@ -149,7 +149,7 @@ export class Trailhead {
      */
     async loadNavigation() {
         try {
-            const response = await fetch(`${this.shellResourceUrl}/navigation.json`);
+            const response = await fetch(`${this.shellUrl}/navigation.json`);
             this.navigation = await response.json();
         }
         catch (error) {
@@ -166,7 +166,7 @@ export class Trailhead {
             return;
         nav.innerHTML = this.navigation
             .map((item) => `
-      <a href="${this.basePath}${item.path}"
+      <a href="${this.appBasePath}${item.path}"
          class="shell-nav-item"
          data-path="${item.path}"
          data-app="${item.app}">
@@ -197,15 +197,15 @@ export class Trailhead {
      * Navigate to path
      */
     navigate(path) {
-        window.location.href = this.basePath + path;
+        window.location.href = this.appBasePath + path;
     }
     /**
      * Handle route change
      */
     handleRoute() {
         let path = window.location.pathname;
-        if (this.basePath && path.startsWith(this.basePath)) {
-            path = path.substring(this.basePath.length) || "/";
+        if (this.appBasePath && path.startsWith(this.appBasePath)) {
+            path = path.substring(this.appBasePath.length) || "/";
         }
         const navItem = this.navigation.find((item) => path.startsWith(item.path));
         if (navItem) {
@@ -244,19 +244,19 @@ export class Trailhead {
             return;
         root.innerHTML = `<div class="shell-loading">Loading...</div>`;
         const isDev = window.__SHELL_DEV__ === true;
-        const appBasePath = this.basePath + appPath;
+        const appBasePath = this.appBasePath + appPath;
         try {
             if (isDev) {
                 // ✅ DEV PATH — Vite-native, HMR-compatible
                 const mod = await import(
                 /* @vite-ignore */
-                `${this.basePath}${appPath}/src/index.ts`);
+                `${this.appBasePath}${appPath}/src/index.ts`);
                 root.innerHTML = "";
                 mod.AppMount(root, appBasePath);
                 return;
             }
-            const pluginUrl = `${this.basePath}${appPath}/app.js`;
-            const pluginCss = `${this.basePath}${appPath}/${appName}.css`;
+            const pluginUrl = `${this.appBasePath}${appPath}/app.js`;
+            const pluginCss = `${this.appBasePath}${appPath}/${appName}.css`;
             // Load CSS
             const link = document.createElement("link");
             link.rel = "stylesheet";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@herdingbits/trailhead-core",
-  "version": "0.0.15",
+  "version": "0.0.16",
   "description": "Simple application shell that orchestrates multiple SPAs. No webpack magic, just the browser's native module system.",
   "type": "module",
   "main": "./dist/index.js",