@herdingbits/trailhead-types 0.0.4 → 0.0.5

package/README.md

@@ -1,6 +1,6 @@
 # @herdingbits/trailhead-types
 
-TypeScript type definitions for Trailhead single page applications (SPAs).
+TypeScript types for Trailhead SPAs. Provides shell API types for independent applications.
 
 **Note:** This package is auto-generated from `@herdingbits/trailhead-core` during build. Do not edit these files directly.
 
@@ -8,6 +8,8 @@ TypeScript type definitions for Trailhead single page applications (SPAs).
 
 Provides TypeScript types for single page applications (SPAs) that integrate with the Trailhead shell. Install this as a dev dependency to get type checking and IntelliSense for the shell API.
 
+**Your SPAs don't import the shell** - they access it via `window.shell`. These types just help TypeScript understand what's available.
+
 ## Installation
 
 ```bash
@@ -21,11 +23,18 @@ npm install --save-dev @herdingbits/trailhead-types
 ```typescript
 import type { ShellAPI } from '@herdingbits/trailhead-types';
 
-export function init(shell: ShellAPI) {
+// Declare global type
+declare global {
+  interface Window {
+    shell: ShellAPI;
+  }
+}
+
+export function init() {
   // TypeScript knows the shell API
-  shell.feedback.success('App loaded!');
+  window.shell.feedback.success('App loaded!');
   
-  const result = await shell.http.get('/api/data');
+  const result = await window.shell.http.get('/api/data');
   if (result.success) {
     console.log(result.data);
   }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@herdingbits/trailhead-types",
-  "version": "0.0.4",
-  "description": "TypeScript type definitions for Trailhead micro-frontend framework",
+  "version": "0.0.5",
+  "description": "TypeScript types for Trailhead SPAs. Provides shell API types for independent applications.",
   "type": "module",
   "types": "./public-api.d.ts",
   "exports": {
@@ -33,4 +33,4 @@
     "url": "https://github.com/herdingbits/trailhead.git",
     "directory": "packages/types"
   }
-}
+}