craft-native 0.0.37

package/dist/dev/error-overlay.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Craft Error Overlay
+ * Visual error display for development with helpful suggestions
+ */
+export interface ErrorInfo {
+    message: string;
+    stack?: string;
+    source?: string;
+    line?: number;
+    column?: number;
+    componentStack?: string;
+    suggestions?: string[];
+}
+export interface ErrorOverlayConfig {
+    enableOverlay?: boolean;
+    enableConsole?: boolean;
+    dismissOnClick?: boolean;
+    position?: 'top' | 'bottom' | 'center';
+}
+export declare class ErrorOverlay {
+    private config;
+    private currentError;
+    private lastRawError;
+    private errorHandler;
+    private rejectionHandler;
+    constructor(config?: ErrorOverlayConfig);
+    /**
+     * Show error overlay. If the same error is already on screen (same message
+     * and stack), skip re-rendering — otherwise hot-reload triggers two
+     * identical overlays for the same uncaught exception.
+     */
+    show(error: Error | string, componentStack?: string): void;
+    /**
+     * Hide error overlay
+     */
+    hide(): void;
+    /**
+     * Get current error
+     */
+    getCurrentError(): ErrorInfo | null;
+    /**
+     * Install global error handlers. Idempotent — calling install() twice
+     * does not register duplicate listeners. Uses addEventListener (not
+     * `window.onerror = …`) so we don't clobber other libraries' handlers.
+     */
+    install(): void;
+    /**
+     * Uninstall global error handlers. Removes only the listeners we added —
+     * other libraries' handlers are left intact.
+     */
+    uninstall(): void;
+}
+declare class ErrorBoundary {
+    state: {
+        hasError: boolean;
+    };
+    props: {
+        children?: unknown;
+    };
+    static getDerivedStateFromError(): {
+        hasError: boolean;
+    };
+    componentDidCatch(_error: Error, _errorInfo: {
+        componentStack: string;
+    }): void;
+    render(): unknown;
+}
+export declare function createReactErrorBoundary(overlay: ErrorOverlay): typeof ErrorBoundary;
+export declare function getErrorOverlay(): ErrorOverlay;
+export declare function showError(error: Error | string): void;
+export declare function hideError(): void;
+export default ErrorOverlay;
+//# sourceMappingURL=error-overlay.d.ts.map

package/dist/dev/error-overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-overlay.d.ts","sourceRoot":"","sources":["../../src/dev/error-overlay.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAA;CACvC;AAsUD,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,YAAY,CAAyB;IAI7C,OAAO,CAAC,YAAY,CAA8B;IAElD,OAAO,CAAC,YAAY,CAA6C;IAEjE,OAAO,CAAC,gBAAgB,CAAwD;gBAEpE,MAAM,GAAE,kBAAuB;IAU3C;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI;IA2C1D;;OAEG;IACH,IAAI,IAAI,IAAI;IAUZ;;OAEG;IACH,eAAe,IAAI,SAAS,GAAG,IAAI;IAInC;;;;OAIG;IACH,OAAO,IAAI,IAAI;IAgBf;;;OAGG;IACH,SAAS,IAAI,IAAI;CAWlB;AAGD,cAAM,aAAa;IACjB,KAAK;;MAAsB;IAC3B,KAAK,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAK;IAElC,MAAM,CAAC,wBAAwB,IAAI;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE;IAIxD,iBAAiB,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAI9E,MAAM,IAAI,OAAO;CAMlB;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,aAAa,CAOpF;AAKD,wBAAgB,eAAe,IAAI,YAAY,CAK9C;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAErD;AAED,wBAAgB,SAAS,IAAI,IAAI,CAEhC;AAED,eAAe,YAAY,CAAA"}

package/dist/dev/hot-reload.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Craft Hot Reload
+ * Hot module replacement and live reload for development
+ */
+import { WebSocket } from 'ws';
+import { EventEmitter } from 'events';
+export interface HotReloadConfig {
+    port?: number;
+    watchDir: string;
+    extensions?: string[];
+    ignored?: (string | RegExp)[];
+    cssOnly?: boolean;
+    preserveState?: boolean;
+    verbose?: boolean;
+}
+export interface HotReloadClient {
+    ws: WebSocket;
+    id: string;
+    platform: string;
+}
+export interface FileChange {
+    path: string;
+    type: 'add' | 'change' | 'unlink';
+    timestamp: number;
+}
+export declare class HotReloadServer extends EventEmitter {
+    private config;
+    private server;
+    private wss;
+    private clients;
+    private fileVersions;
+    private debounceTimers;
+    private stateSnapshots;
+    private watcher;
+    constructor(config: HotReloadConfig);
+    /**
+     * Start the hot reload server
+     */
+    start(): void;
+    /**
+     * Stop the hot reload server
+     */
+    /**
+     * Stop the hot-reload server and release every resource it acquired.
+     *
+     * Returns a Promise so callers that need to know when the server has
+     * actually torn down (tests, lifecycle managers) can `await stop()`.
+     * The return value is non-breaking: synchronous callers can still
+     * fire-and-forget `server.stop()`.
+     */
+    stop(): Promise<void>;
+    /**
+     * Start watching files for changes. Stores the FSWatcher reference so
+     * stop() can release it.
+     */
+    private startWatching;
+    /**
+     * Handle file change
+     */
+    private handleFileChange;
+    /**
+     * Broadcast CSS update (no full reload needed)
+     */
+    private broadcastCssUpdate;
+    /**
+     * Broadcast hot module update
+     */
+    private broadcastHotUpdate;
+    /**
+     * Broadcast full reload
+     */
+    private broadcastFullReload;
+    /**
+     * Broadcast message to all clients
+     */
+    private broadcast;
+    /**
+     * Handle HTTP request (for HMR runtime).
+     *
+     * `/hmr-module/<path>` previously joined the user-supplied path with
+     * `watchDir` and read it — letting any client on the dev port read
+     * arbitrary files via `../../etc/passwd`. We now:
+     *   - decode percent-encodes (so `..%2F` is caught),
+     *   - reject any segment containing `..` or null bytes,
+     *   - resolve the result and require it to live under `watchDir` (this
+     *     also blocks symlink escapes that resolve outside the root).
+     *
+     * Anything else returns 403 — silently 404'ing made traversal probes
+     * indistinguishable from "file not found".
+     */
+    private handleHttpRequest;
+    /**
+     * Resolve an HMR-module URL path against `watchDir`. Returns null when
+     * the path is empty, contains traversal sequences, embeds NULs, or
+     * resolves outside the watch root. Exposed as a method so the test
+     * suite can exercise the validator directly.
+     */
+    private resolveHmrModulePath;
+    /**
+     * Handle client message
+     */
+    private handleClientMessage;
+    /**
+     * Get HMR runtime code for injection into client
+     */
+    private getHmrRuntime;
+    private shouldIgnore;
+    private getAcceptDependencies;
+    private generateClientId;
+    /**
+     * Get connected clients count
+     */
+    getClientCount(): number;
+    /**
+     * Get list of connected clients
+     */
+    getClients(): Array<{
+        id: string;
+        platform: string;
+    }>;
+}
+/**
+ * Create HMR client code for injection
+ */
+export declare function createHmrClient(serverUrl: string): string;
+export default HotReloadServer;
+//# sourceMappingURL=hot-reload.d.ts.map

package/dist/dev/hot-reload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hot-reload.d.ts","sourceRoot":"","sources":["../../src/dev/hot-reload.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAmB,SAAS,EAAE,MAAM,IAAI,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAIrC,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,OAAO,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAA;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,SAAS,CAAA;IACb,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAA;IACjC,SAAS,EAAE,MAAM,CAAA;CAClB;AAGD,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,MAAM,CAA+C;IAC7D,OAAO,CAAC,GAAG,CAA+B;IAC1C,OAAO,CAAC,OAAO,CAA0C;IACzD,OAAO,CAAC,YAAY,CAAiC;IACrD,OAAO,CAAC,cAAc,CAAyC;IAC/D,OAAO,CAAC,cAAc,CAA8B;IAIpD,OAAO,CAAC,OAAO,CAAyB;gBAE5B,MAAM,EAAE,eAAe;IAanC;;OAEG;IACH,KAAK,IAAI,IAAI;IAsDb;;OAEG;IACH;;;;;;;OAOG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B3B;;;OAGG;IACH,OAAO,CAAC,aAAa;IA8BrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAwCxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAc1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAgB1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAQ3B;;OAEG;IACH,OAAO,CAAC,SAAS;IAUjB;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,iBAAiB;IA4BzB;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IA0B5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA2B3B;;OAEG;IACH,OAAO,CAAC,aAAa;IA4JrB,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,qBAAqB;IAK7B,OAAO,CAAC,gBAAgB;IAQxB;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,UAAU,IAAI,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAMtD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAYzD;AAED,eAAe,eAAe,CAAA"}