@herdingbits/trailhead-core 0.0.1

package/README.md

@@ -0,0 +1,30 @@
+# @herdingbits/trailhead-core
+
+Core shell orchestration for the Trailhead micro-frontend framework.
+
+## Installation
+
+```bash
+npm install @herdingbits/trailhead-core
+```
+
+## Usage
+
+```typescript
+import { Trailhead } from '@herdingbits/trailhead-core';
+import { YourAdapter } from '@herdingbits/trailhead-your-design-system';
+
+const shell = new Trailhead({
+  adapter: new YourAdapter(),
+  basePath: '/app',
+  apiUrl: 'https://api.example.com'
+});
+```
+
+## Documentation
+
+See the [main Trailhead documentation](https://github.com/herdingbits/trailhead) for more information.
+
+## License
+
+MIT

package/dist/adapters/public-api.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Public Adapter API - For creating custom design system adapters
+ */
+export type { DesignSystemAdapter, FeedbackAdapter, ToastVariant, DialogButton, DialogConfig, DialogResult, } from './types.js';
+//# sourceMappingURL=public-api.d.ts.map

package/dist/adapters/public-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-api.d.ts","sourceRoot":"","sources":["../../src/adapters/public-api.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,GACb,MAAM,YAAY,CAAC"}

package/dist/adapters/public-api.js

@@ -0,0 +1,4 @@
+/**
+ * Public Adapter API - For creating custom design system adapters
+ */
+export {};

package/dist/adapters/types.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Design System Adapter Interfaces
+ *
+ * These interfaces define the contract between Trailhead core and design system implementations.
+ */
+export type ToastVariant = "success" | "error" | "warning" | "info";
+export interface DialogButton<T extends string = string> {
+    label: string;
+    value: T;
+    variant?: string;
+}
+export interface DialogConfig<T extends string = string> {
+    message: string;
+    title?: string;
+    buttons: DialogButton<T>[];
+}
+export interface DialogResult<T extends string = string> {
+    value: T | null;
+}
+/**
+ * Feedback Adapter - Handles user feedback (toasts, dialogs, busy states)
+ */
+export interface FeedbackAdapter {
+    /**
+     * Show a busy overlay with a message
+     */
+    showBusy(message: string): void;
+    /**
+     * Clear the busy overlay
+     */
+    clearBusy(): void;
+    /**
+     * Show a toast notification
+     */
+    showToast(message: string, variant: ToastVariant, duration?: number): void;
+    /**
+     * Show a dialog with custom buttons
+     */
+    showDialog<T extends string>(config: DialogConfig<T>): Promise<DialogResult<T>>;
+}
+/**
+ * Design System Adapter - Main adapter interface
+ */
+export interface DesignSystemAdapter {
+    /**
+     * Adapter name (e.g., "shoelace", "cloudscape")
+     */
+    name: string;
+    /**
+     * Adapter version
+     */
+    version: string;
+    /**
+     * Initialize the design system (load assets, set base paths, etc.)
+     */
+    init(basePath: string): Promise<void>;
+    /**
+     * Feedback adapter for user notifications
+     */
+    feedback: FeedbackAdapter;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/adapters/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEpE,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,CAAC,CAAC;IACT,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IACrD,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhC;;OAEG;IACH,SAAS,IAAI,IAAI,CAAC;IAElB;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3E;;OAEG;IACH,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;CACjF;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtC;;OAEG;IACH,QAAQ,EAAE,eAAe,CAAC;CAC3B"}

package/dist/adapters/types.js

@@ -0,0 +1,6 @@
+/**
+ * Design System Adapter Interfaces
+ *
+ * These interfaces define the contract between Trailhead core and design system implementations.
+ */
+export {};

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @herdingbits/trailhead-core
+ * Core shell orchestration and services
+ */
+export { Trailhead } from './shell.js';
+export type { ShellConfig } from './shell.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+/**
+ * @herdingbits/trailhead-core
+ * Core shell orchestration and services
+ */
+export { Trailhead } from './shell.js';

package/dist/lib/feedback.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Feedback system - imperative API for user feedback
+ * No React, pure DOM manipulation
+ */
+import type { AlertVariant } from "../types/shell-api";
+/**
+ * Show blocking busy overlay with spinner
+ */
+export declare function busy(message: string): void;
+/**
+ * Clear busy overlay
+ */
+export declare function clear(): void;
+/**
+ * Show toast notification
+ */
+export declare function alert(message: string, variant?: AlertVariant, duration?: number): void;
+/**
+ * Show success toast
+ */
+export declare function success(message: string, duration?: number): void;
+/**
+ * Show error toast
+ */
+export declare function error(message: string, duration?: number): void;
+/**
+ * Show warning toast
+ */
+export declare function warning(message: string, duration?: number): void;
+/**
+ * Show info toast
+ */
+export declare function info(message: string, duration?: number): void;
+/**
+ * Show dialog with custom buttons
+ */
+export declare function custom<T extends string>(message: string, title: string, buttons: Array<{
+    label: string;
+    value: T;
+    variant?: string;
+}>): Promise<T | null>;
+/**
+ * Show confirm dialog (Cancel/Confirm)
+ */
+export declare function confirm(message: string, title?: string): Promise<boolean>;
+/**
+ * Show OK dialog
+ */
+export declare function ok(message: string, title?: string): Promise<void>;
+/**
+ * Show Yes/No dialog
+ */
+export declare function yesNo(message: string, title?: string): Promise<boolean>;
+/**
+ * Show Yes/No/Cancel dialog
+ */
+export declare function yesNoCancel(message: string, title?: string): Promise<"yes" | "no" | "cancel">;
+//# sourceMappingURL=feedback.d.ts.map

package/dist/lib/feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.d.ts","sourceRoot":"","sources":["../../src/lib/feedback.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAKvD;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAkB1C;AAED;;GAEG;AACH,wBAAgB,KAAK,IAAI,IAAI,CAI5B;AAED;;GAEG;AACH,wBAAgB,KAAK,CACnB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,YAAqB,EAC9B,QAAQ,GAAE,MAAa,GACtB,IAAI,CAiBN;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAEhE;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAE9D;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAEhE;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAE7D;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,EACrC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAC5D,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAqCnB;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAKpF;AAED;;GAEG;AACH,wBAAgB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAIhF;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAKlF;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,MAAkB,GACxB,OAAO,CAAC,KAAK,GAAG,IAAI,GAAG,QAAQ,CAAC,CAMlC"}

package/dist/lib/feedback.js

@@ -0,0 +1,145 @@
+let busyOverlay = null;
+let toastContainer = null;
+/**
+ * Show blocking busy overlay with spinner
+ */
+export function busy(message) {
+    if (!busyOverlay) {
+        busyOverlay = document.createElement("div");
+        busyOverlay.id = "shell-busy-overlay";
+        busyOverlay.innerHTML = `
+      <div class="shell-busy-content">
+        <div class="shell-spinner"></div>
+        <div class="shell-busy-message"></div>
+      </div>
+    `;
+        document.body.appendChild(busyOverlay);
+    }
+    const messageEl = busyOverlay.querySelector(".shell-busy-message");
+    if (messageEl) {
+        messageEl.textContent = message;
+    }
+    busyOverlay.style.display = "flex";
+}
+/**
+ * Clear busy overlay
+ */
+export function clear() {
+    if (busyOverlay) {
+        busyOverlay.style.display = "none";
+    }
+}
+/**
+ * Show toast notification
+ */
+export function alert(message, variant = "info", duration = 3000) {
+    if (!toastContainer) {
+        toastContainer = document.createElement("div");
+        toastContainer.id = "shell-toast-container";
+        document.body.appendChild(toastContainer);
+    }
+    const toast = document.createElement("div");
+    toast.className = `shell-toast shell-toast-${variant}`;
+    toast.textContent = message;
+    toastContainer.appendChild(toast);
+    setTimeout(() => toast.classList.add("shell-toast-show"), 10);
+    setTimeout(() => {
+        toast.classList.remove("shell-toast-show");
+        setTimeout(() => toast.remove(), 300);
+    }, duration);
+}
+/**
+ * Show success toast
+ */
+export function success(message, duration) {
+    alert(message, "success", duration);
+}
+/**
+ * Show error toast
+ */
+export function error(message, duration) {
+    alert(message, "error", duration || 5000);
+}
+/**
+ * Show warning toast
+ */
+export function warning(message, duration) {
+    alert(message, "warning", duration || 4000);
+}
+/**
+ * Show info toast
+ */
+export function info(message, duration) {
+    alert(message, "info", duration);
+}
+/**
+ * Show dialog with custom buttons
+ */
+export function custom(message, title, buttons) {
+    return new Promise((resolve) => {
+        const dialog = document.createElement("div");
+        dialog.className = "shell-dialog-overlay";
+        dialog.innerHTML = `
+      <div class="shell-dialog">
+        <div class="shell-dialog-title">${title}</div>
+        <div class="shell-dialog-message">${message}</div>
+        <div class="shell-dialog-buttons">
+          ${buttons
+            .map((btn) => `<button class="shell-btn shell-btn-${btn.variant || "default"}" data-value="${btn.value}">${btn.label}</button>`)
+            .join("")}
+        </div>
+      </div>
+    `;
+        dialog.querySelectorAll("button").forEach((btn) => {
+            btn.onclick = () => {
+                const value = btn.getAttribute("data-value");
+                dialog.remove();
+                resolve(value);
+            };
+        });
+        // Click outside to cancel
+        dialog.onclick = (e) => {
+            if (e.target === dialog) {
+                dialog.remove();
+                resolve(null);
+            }
+        };
+        document.body.appendChild(dialog);
+    });
+}
+/**
+ * Show confirm dialog (Cancel/Confirm)
+ */
+export function confirm(message, title = "Confirm") {
+    return custom(message, title, [
+        { label: "Cancel", value: "cancel", variant: "secondary" },
+        { label: "Confirm", value: "confirm", variant: "primary" },
+    ]).then((result) => result === "confirm");
+}
+/**
+ * Show OK dialog
+ */
+export function ok(message, title = "Information") {
+    return custom(message, title, [
+        { label: "OK", value: "ok", variant: "primary" },
+    ]).then(() => undefined);
+}
+/**
+ * Show Yes/No dialog
+ */
+export function yesNo(message, title = "Confirm") {
+    return custom(message, title, [
+        { label: "No", value: "no", variant: "secondary" },
+        { label: "Yes", value: "yes", variant: "primary" },
+    ]).then((result) => result === "yes");
+}
+/**
+ * Show Yes/No/Cancel dialog
+ */
+export function yesNoCancel(message, title = "Confirm") {
+    return custom(message, title, [
+        { label: "Cancel", value: "cancel", variant: "secondary" },
+        { label: "No", value: "no", variant: "secondary" },
+        { label: "Yes", value: "yes", variant: "primary" },
+    ]).then((result) => result || "cancel");
+}

package/dist/lib/http.d.ts

@@ -0,0 +1,26 @@
+import type { RequestOptions, Result } from "../types/shell-api";
+/**
+ * Initialize HTTP client
+ */
+export declare function init(baseUrl?: string): void;
+/**
+ * GET request
+ */
+export declare function get<T>(url: string, options?: RequestOptions): Promise<Result<T>>;
+/**
+ * POST request
+ */
+export declare function post<T>(url: string, data?: any, options?: RequestOptions): Promise<Result<T>>;
+/**
+ * PUT request
+ */
+export declare function put<T>(url: string, data?: any, options?: RequestOptions): Promise<Result<T>>;
+/**
+ * PATCH request
+ */
+export declare function patch<T>(url: string, data?: any, options?: RequestOptions): Promise<Result<T>>;
+/**
+ * DELETE request
+ */
+export declare function del<T>(url: string, options?: RequestOptions): Promise<Result<T>>;
+//# sourceMappingURL=http.d.ts.map

package/dist/lib/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/lib/http.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAyC,MAAM,oBAAoB,CAAC;AAKxG;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,GAAE,MAAW,GAAG,IAAI,CAM/C;AA4ED;;GAEG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAEhF;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,CAAC,EACpB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,GAAG,EACV,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAEpB;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,CAAC,EACnB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,GAAG,EACV,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAEpB;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,CAAC,EACrB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,GAAG,EACV,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAEpB;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAEhF"}

package/dist/lib/http.js

@@ -0,0 +1,98 @@
+/**
+ * HTTP client using ky with automatic feedback orchestration
+ */
+import ky from "ky";
+import * as requestManager from "./requestManager";
+let kyInstance;
+/**
+ * Initialize HTTP client
+ */
+export function init(baseUrl = "") {
+    kyInstance = ky.create({
+        prefixUrl: baseUrl,
+        timeout: 30000,
+        retry: 0,
+    });
+}
+/**
+ * Make HTTP request with feedback orchestration
+ */
+async function request(method, url, data, options = {}) {
+    const { requestKey, busyMessage, successMessage, showSuccess = false, noFeedback = false, headers = {}, } = options;
+    try {
+        requestManager.startRequest(requestKey, busyMessage, noFeedback);
+        const kyOptions = {
+            method,
+            headers,
+        };
+        if (data && (method === "POST" || method === "PUT" || method === "PATCH")) {
+            kyOptions.json = data;
+        }
+        const response = await kyInstance(url, kyOptions);
+        const result = await response.json();
+        requestManager.endRequest(requestKey, noFeedback);
+        if (!noFeedback && showSuccess && successMessage) {
+            requestManager.showSuccess(successMessage);
+        }
+        return {
+            success: true,
+            data: result,
+            requestKey,
+        };
+    }
+    catch (err) {
+        requestManager.endRequest(requestKey, noFeedback);
+        const error = {
+            name: err.name || "HttpError",
+            message: err.message || "Request failed",
+            status: err.response?.status,
+        };
+        if (err.response) {
+            try {
+                error.data = await err.response.json();
+                error.message = error.data.message || error.message;
+            }
+            catch {
+                // Response not JSON
+            }
+        }
+        if (!noFeedback) {
+            requestManager.showError(error.message);
+        }
+        return {
+            success: false,
+            error,
+            requestKey,
+        };
+    }
+}
+/**
+ * GET request
+ */
+export function get(url, options) {
+    return request("GET", url, undefined, options);
+}
+/**
+ * POST request
+ */
+export function post(url, data, options) {
+    return request("POST", url, data, options);
+}
+/**
+ * PUT request
+ */
+export function put(url, data, options) {
+    return request("PUT", url, data, options);
+}
+/**
+ * PATCH request
+ */
+export function patch(url, data, options) {
+    return request("PATCH", url, data, options);
+}
+/**
+ * DELETE request
+ */
+export function del(url, options) {
+    return request("DELETE", url, undefined, options);
+}

package/dist/lib/i18n.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Translation helper function
+ * In source code, this returns the key as-is (English)
+ * At build time, the i18n plugin replaces t("key") with the translated string
+ */
+export declare const t: (key: string) => string;
+//# sourceMappingURL=i18n.d.ts.map

package/dist/lib/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/lib/i18n.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,CAAC,GAAI,KAAK,MAAM,KAAG,MAAa,CAAC"}

package/dist/lib/i18n.js

@@ -0,0 +1,6 @@
+/**
+ * Translation helper function
+ * In source code, this returns the key as-is (English)
+ * At build time, the i18n plugin replaces t("key") with the translated string
+ */
+export const t = (key) => key;

package/dist/lib/requestManager.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Request manager - orchestrates HTTP requests with feedback
+ */
+import type { FeedbackAdapter } from "../adapters/types.js";
+/**
+ * Initialize request manager with feedback adapter
+ */
+export declare function init(adapter: FeedbackAdapter): void;
+/**
+ * Track request start
+ */
+export declare function startRequest(requestKey?: string, busyMessage?: string, noFeedback?: boolean): void;
+/**
+ * Track request end
+ */
+export declare function endRequest(requestKey?: string, noFeedback?: boolean): void;
+/**
+ * Show success feedback
+ */
+export declare function showSuccess(message: string): void;
+/**
+ * Show error feedback
+ */
+export declare function showError(message: string): void;
+/**
+ * Get active request count
+ */
+export declare function getActiveRequestCount(): number;
+/**
+ * Check if specific request is active
+ */
+export declare function isRequestActive(requestKey: string): boolean;
+//# sourceMappingURL=requestManager.d.ts.map

package/dist/lib/requestManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requestManager.d.ts","sourceRoot":"","sources":["../../src/lib/requestManager.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAM5D;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAEnD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,UAAU,CAAC,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,EACpB,UAAU,CAAC,EAAE,OAAO,GACnB,IAAI,CAYN;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,UAAU,CAAC,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,OAAO,GACnB,IAAI,CAgBN;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAIjD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAI/C;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAE3D"}

package/dist/lib/requestManager.js

@@ -0,0 +1,72 @@
+let activeRequests = 0;
+const requestKeys = new Map();
+let feedbackAdapter = null;
+/**
+ * Initialize request manager with feedback adapter
+ */
+export function init(adapter) {
+    feedbackAdapter = adapter;
+}
+/**
+ * Track request start
+ */
+export function startRequest(requestKey, busyMessage, noFeedback) {
+    if (noFeedback || !feedbackAdapter)
+        return;
+    if (requestKey) {
+        const count = requestKeys.get(requestKey) || 0;
+        requestKeys.set(requestKey, count + 1);
+    }
+    activeRequests++;
+    if (activeRequests === 1) {
+        feedbackAdapter.showBusy(busyMessage || "Loading...");
+    }
+}
+/**
+ * Track request end
+ */
+export function endRequest(requestKey, noFeedback) {
+    if (noFeedback || !feedbackAdapter)
+        return;
+    if (requestKey) {
+        const count = requestKeys.get(requestKey) || 0;
+        if (count > 1) {
+            requestKeys.set(requestKey, count - 1);
+        }
+        else {
+            requestKeys.delete(requestKey);
+        }
+    }
+    activeRequests--;
+    if (activeRequests === 0) {
+        feedbackAdapter.clearBusy();
+    }
+}
+/**
+ * Show success feedback
+ */
+export function showSuccess(message) {
+    if (feedbackAdapter) {
+        feedbackAdapter.showToast(message, "success");
+    }
+}
+/**
+ * Show error feedback
+ */
+export function showError(message) {
+    if (feedbackAdapter) {
+        feedbackAdapter.showToast(message, "error", 5000);
+    }
+}
+/**
+ * Get active request count
+ */
+export function getActiveRequestCount() {
+    return activeRequests;
+}
+/**
+ * Check if specific request is active
+ */
+export function isRequestActive(requestKey) {
+    return requestKeys.has(requestKey);
+}

package/dist/shell.d.ts

@@ -0,0 +1,54 @@
+import type { DesignSystemAdapter } from "./adapters/types.js";
+export interface ShellConfig {
+    adapter: DesignSystemAdapter;
+    basePath?: string;
+    apiUrl?: string;
+}
+export declare class Trailhead {
+    private navigation;
+    private routeChangeCallbacks;
+    private basePath;
+    private adapter;
+    constructor(config: ShellConfig);
+    /**
+     * Initialize shell
+     */
+    private init;
+    /**
+     * Initialize design system adapter
+     */
+    private initAdapter;
+    /**
+     * Create shell API
+     */
+    private createAPI;
+    /**
+     * Load navigation configuration
+     */
+    private loadNavigation;
+    /**
+     * Render navigation menu
+     */
+    private renderNavigation;
+    /**
+     * Setup routing
+     */
+    private setupRouting;
+    /**
+     * Navigate to path
+     */
+    private navigate;
+    /**
+     * Handle route change
+     */
+    private handleRoute;
+    /**
+     * Update active navigation item
+     */
+    private updateActiveNav;
+    /**
+     * Load plugin application
+     */
+    private loadPlugin;
+}
+//# sourceMappingURL=shell.d.ts.map

package/dist/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../src/shell.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAK/D,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,mBAAmB,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,UAAU,CAAiB;IACnC,OAAO,CAAC,oBAAoB,CAAqC;IACjE,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAsB;gBAEzB,MAAM,EAAE,WAAW;IAM/B;;OAEG;YACW,IAAI;IAwBlB;;OAEG;YACW,WAAW;IAUzB;;OAEG;IACH,OAAO,CAAC,SAAS;IAmFjB;;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;IAenB;;OAEG;IACH,OAAO,CAAC,eAAe;IAavB;;OAEG;YACW,UAAU;CAsCzB"}

package/dist/shell.js

@@ -0,0 +1,236 @@
+import * as http from "./lib/http.js";
+import * as requestManager from "./lib/requestManager.js";
+import { t } from "./lib/i18n.js";
+export class Trailhead {
+    constructor(config) {
+        this.navigation = [];
+        this.routeChangeCallbacks = [];
+        this.basePath = config.basePath || "";
+        this.adapter = config.adapter;
+        this.init(config.apiUrl);
+    }
+    /**
+     * Initialize shell
+     */
+    async init(apiUrl) {
+        // Initialize design system adapter
+        await this.initAdapter();
+        // Initialize request manager and HTTP client with adapter
+        requestManager.init(this.adapter.feedback);
+        http.init(apiUrl || "");
+        // Expose shell API globally
+        window.shell = this.createAPI();
+        // Load navigation
+        await this.loadNavigation();
+        // Setup routing
+        this.setupRouting();
+        // Render navigation
+        this.renderNavigation();
+        // Load initial route
+        this.handleRoute();
+    }
+    /**
+     * Initialize design system adapter
+     */
+    async initAdapter() {
+        try {
+            await this.adapter.init(this.basePath);
+            console.log(`[Trailhead] Initialized ${this.adapter.name} adapter v${this.adapter.version}`);
+        }
+        catch (error) {
+            console.error("Failed to initialize design system adapter:", error);
+            throw error;
+        }
+    }
+    /**
+     * Create shell API
+     */
+    createAPI() {
+        const adapter = this.adapter;
+        return {
+            version: "1.0.0",
+            feedback: {
+                busy: (message) => adapter.feedback.showBusy(message),
+                clear: () => adapter.feedback.clearBusy(),
+                success: (message, duration) => adapter.feedback.showToast(message, "success", duration),
+                error: (message, duration) => adapter.feedback.showToast(message, "error", duration || 5000),
+                warning: (message, duration) => adapter.feedback.showToast(message, "warning", duration || 4000),
+                info: (message, duration) => adapter.feedback.showToast(message, "info", duration),
+                alert: (message, variant = "info", duration) => adapter.feedback.showToast(message, variant, duration),
+                confirm: (message, title = "Confirm") => adapter.feedback.showDialog({
+                    message,
+                    title,
+                    buttons: [
+                        { label: "Cancel", value: "cancel", variant: "secondary" },
+                        { label: "Confirm", value: "confirm", variant: "primary" },
+                    ],
+                }).then((result) => result.value === "confirm"),
+                ok: (message, title = "Information") => adapter.feedback.showDialog({
+                    message,
+                    title,
+                    buttons: [{ label: "OK", value: "ok", variant: "primary" }],
+                }).then(() => undefined),
+                yesNo: (message, title = "Confirm") => adapter.feedback.showDialog({
+                    message,
+                    title,
+                    buttons: [
+                        { label: "No", value: "no", variant: "secondary" },
+                        { label: "Yes", value: "yes", variant: "primary" },
+                    ],
+                }).then((result) => result.value === "yes"),
+                yesNoCancel: (message, title = "Confirm") => adapter.feedback.showDialog({
+                    message,
+                    title,
+                    buttons: [
+                        { label: "Cancel", value: "cancel", variant: "secondary" },
+                        { label: "No", value: "no", variant: "secondary" },
+                        { label: "Yes", value: "yes", variant: "primary" },
+                    ],
+                }).then((result) => result.value || "cancel"),
+                custom: (message, title, buttons) => adapter.feedback.showDialog({ message, title, buttons })
+                    .then((result) => result.value),
+            },
+            http: {
+                get: http.get,
+                post: http.post,
+                put: http.put,
+                patch: http.patch,
+                delete: http.del,
+            },
+            navigation: {
+                navigate: (path) => this.navigate(path),
+                getCurrentPath: () => window.location.pathname,
+                onRouteChange: (callback) => {
+                    this.routeChangeCallbacks.push(callback);
+                    return () => {
+                        const index = this.routeChangeCallbacks.indexOf(callback);
+                        if (index > -1) {
+                            this.routeChangeCallbacks.splice(index, 1);
+                        }
+                    };
+                },
+            },
+        };
+    }
+    /**
+     * Load navigation configuration
+     */
+    async loadNavigation() {
+        try {
+            const response = await fetch(`${this.basePath}/navigation.json`);
+            this.navigation = await response.json();
+        }
+        catch (error) {
+            console.error("Failed to load navigation:", error);
+            this.navigation = [];
+        }
+    }
+    /**
+     * Render navigation menu
+     */
+    renderNavigation() {
+        const nav = document.getElementById("shell-navigation");
+        if (!nav)
+            return;
+        nav.innerHTML = this.navigation
+            .map((item) => `
+      <a href="${this.basePath}${item.path}"
+         class="shell-nav-item"
+         data-path="${item.path}"
+         data-app="${item.app}">
+        <i class="shell-icon shell-icon-${item.icon}"></i>
+        <span class="shell-nav-label">${item.label}</span>
+      </a>
+    `)
+            .join("");
+        nav.querySelectorAll("a").forEach((link) => {
+            link.addEventListener("click", (e) => {
+                e.preventDefault();
+                const path = link.getAttribute("data-path");
+                if (path) {
+                    this.navigate(path);
+                }
+            });
+        });
+    }
+    /**
+     * Setup routing
+     */
+    setupRouting() {
+        window.addEventListener("popstate", () => {
+            this.handleRoute();
+        });
+    }
+    /**
+     * Navigate to path
+     */
+    navigate(path) {
+        window.location.href = this.basePath + path;
+    }
+    /**
+     * Handle route change
+     */
+    handleRoute() {
+        let path = window.location.pathname;
+        if (this.basePath && path.startsWith(this.basePath)) {
+            path = path.substring(this.basePath.length) || "/";
+        }
+        const navItem = this.navigation.find((item) => path.startsWith(item.path));
+        if (navItem) {
+            this.loadPlugin(navItem.app, navItem.path);
+            this.updateActiveNav(navItem.path);
+        }
+    }
+    /**
+     * Update active navigation item
+     */
+    updateActiveNav(path) {
+        const nav = document.getElementById("shell-navigation");
+        if (!nav)
+            return;
+        nav.querySelectorAll("a").forEach((link) => {
+            if (link.getAttribute("data-path") === path) {
+                link.classList.add("shell-nav-item-active");
+            }
+            else {
+                link.classList.remove("shell-nav-item-active");
+            }
+        });
+    }
+    /**
+     * Load plugin application
+     */
+    async loadPlugin(appName, appPath) {
+        const root = document.getElementById("shell-content");
+        if (!root)
+            return;
+        root.innerHTML = `<div class="shell-loading">${t("Loading...")}</div>`;
+        try {
+            const pluginUrl = `${this.basePath}${appPath}/app.js`;
+            const pluginCss = `${this.basePath}${appPath}/${appName}.css`;
+            // Load CSS
+            const link = document.createElement("link");
+            link.rel = "stylesheet";
+            link.href = pluginCss;
+            document.head.appendChild(link);
+            // Load JS
+            const script = document.createElement("script");
+            script.src = pluginUrl;
+            script.type = "module";
+            script.onload = () => {
+                root.innerHTML = "";
+                if (window.AppMount) {
+                    window.AppMount(root);
+                }
+            };
+            script.onerror = () => {
+                root.innerHTML = `<div class="shell-error">${t("Failed to load application")}: ${appName}</div>`;
+            };
+            document.body.appendChild(script);
+        }
+        catch (error) {
+            console.error("Failed to load plugin:", error);
+            root.innerHTML = `<div class="shell-error">${t("Failed to load application")}</div>`;
+        }
+    }
+}

package/dist/types/public-api.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Public Shell API - Only these types are exposed to plugin applications
+ * This file explicitly defines what's public vs internal
+ */
+export type { ShellAPI, FeedbackAPI, AlertVariant, HttpAPI, RequestOptions, Result, SuccessResult, ErrorResult, HttpError, NavigationAPI, NavItem, } from './shell-api.js';
+//# sourceMappingURL=public-api.d.ts.map

package/dist/types/public-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-api.d.ts","sourceRoot":"","sources":["../../src/types/public-api.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EACV,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,OAAO,EACP,cAAc,EACd,MAAM,EACN,aAAa,EACb,WAAW,EACX,SAAS,EACT,aAAa,EACb,OAAO,GACR,MAAM,gBAAgB,CAAC"}

package/dist/types/public-api.js

@@ -0,0 +1,5 @@
+/**
+ * Public Shell API - Only these types are exposed to plugin applications
+ * This file explicitly defines what's public vs internal
+ */
+export {};

package/dist/types/shell-api.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Shell API Interface
+ * Exposed to plugin applications via window.shell
+ */
+export interface ShellAPI {
+    version: string;
+    feedback: FeedbackAPI;
+    http: HttpAPI;
+    navigation: NavigationAPI;
+}
+/**
+ * Feedback system API
+ */
+export interface FeedbackAPI {
+    busy(message: string): void;
+    clear(): void;
+    success(message: string, duration?: number): void;
+    error(message: string, duration?: number): void;
+    warning(message: string, duration?: number): void;
+    info(message: string, duration?: number): void;
+    alert(message: string, variant?: AlertVariant, duration?: number): void;
+    confirm(message: string, title?: string): Promise<boolean>;
+    ok(message: string, title?: string): Promise<void>;
+    yesNo(message: string, title?: string): Promise<boolean>;
+    yesNoCancel(message: string, title?: string): Promise<"yes" | "no" | "cancel">;
+    custom<T extends string>(message: string, title: string, buttons: Array<{
+        label: string;
+        value: T;
+        variant?: string;
+    }>): Promise<T | null>;
+}
+export type AlertVariant = "success" | "error" | "warning" | "info";
+/**
+ * HTTP client API with automatic feedback orchestration
+ */
+export interface HttpAPI {
+    get<T = any>(url: string, options?: RequestOptions): Promise<Result<T>>;
+    post<T = any>(url: string, data?: any, options?: RequestOptions): Promise<Result<T>>;
+    put<T = any>(url: string, data?: any, options?: RequestOptions): Promise<Result<T>>;
+    patch<T = any>(url: string, data?: any, options?: RequestOptions): Promise<Result<T>>;
+    delete<T = any>(url: string, options?: RequestOptions): Promise<Result<T>>;
+}
+export interface RequestOptions {
+    requestKey?: string;
+    busyMessage?: string;
+    successMessage?: string;
+    showSuccess?: boolean;
+    noFeedback?: boolean;
+    headers?: Record<string, string>;
+}
+export interface SuccessResult<T> {
+    success: true;
+    data: T;
+    requestKey?: string;
+}
+export interface ErrorResult {
+    success: false;
+    error: HttpError;
+    requestKey?: string;
+}
+export type Result<T> = SuccessResult<T> | ErrorResult;
+export interface HttpError {
+    name: string;
+    message: string;
+    status?: number;
+    data?: any;
+}
+/**
+ * Navigation API
+ */
+export interface NavigationAPI {
+    navigate(path: string): void;
+    getCurrentPath(): string;
+    onRouteChange(callback: (path: string) => void): () => void;
+}
+/**
+ * Navigation configuration
+ */
+export interface NavItem {
+    id: string;
+    path: string;
+    app: string;
+    icon: string;
+    label: string;
+    order: number;
+    badge?: () => number;
+}
+/**
+ * Global window extension
+ */
+declare global {
+    interface Window {
+        shell: ShellAPI;
+        AppMount?: (container: HTMLElement) => void;
+    }
+}
+//# sourceMappingURL=shell-api.d.ts.map

package/dist/types/shell-api.d.ts.map

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

package/dist/types/shell-api.js

@@ -0,0 +1,5 @@
+/**
+ * Shell API Interface
+ * Exposed to plugin applications via window.shell
+ */
+export {};

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@herdingbits/trailhead-core",
+  "version": "0.0.1",
+  "description": "Core shell orchestration for Trailhead micro-frontend framework",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "clean": "rm -rf dist ../types/*.d.ts ../types/adapters",
+    "build": "npm run clean && tsc && npm run build:types",
+    "build:types": "tsc src/types/public-api.ts --declaration --emitDeclarationOnly --outDir ../types --skipLibCheck && tsc src/adapters/public-api.ts --declaration --emitDeclarationOnly --outDir ../types/adapters --skipLibCheck",
+    "test": "vitest"
+  },
+  "dependencies": {
+    "ky": "^1.14.3"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "keywords": [
+    "micro-frontend",
+    "shell",
+    "trailhead"
+  ],
+  "author": "HerdingBits",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/herdingbits/trailhead.git",
+    "directory": "packages/core"
+  }
+}