npm - @hyperfrontend/features - Versions diffs - 0.1.0 → 0.2.0 - Mend

@hyperfrontend/features 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (159) hide show

package/CHANGELOG.md +17 -0
package/_dependencies/@hyperfrontend/builder/bundle/dependencies/index.cjs.js +1 -0
package/_dependencies/@hyperfrontend/builder/bundle/dependencies/index.esm.js +1 -0
package/_dependencies/@hyperfrontend/builder/bundle/dependencies/worker/index.cjs.js +1 -0
package/_dependencies/@hyperfrontend/builder/bundle/dependencies/worker/index.esm.js +1 -0
package/_dependencies/@hyperfrontend/builder/bundle/index.cjs.js +12 -10
package/_dependencies/@hyperfrontend/builder/bundle/index.esm.js +14 -12
package/_dependencies/@hyperfrontend/builder/bundle/rollup/index.cjs.js +2 -0
package/_dependencies/@hyperfrontend/builder/bundle/rollup/index.esm.js +2 -0
package/_dependencies/@hyperfrontend/builder/bundle/rollup/worker/index.cjs.js +2 -0
package/_dependencies/@hyperfrontend/builder/bundle/rollup/worker/index.esm.js +2 -0
package/_dependencies/@hyperfrontend/builder/index.cjs.js +87 -53
package/_dependencies/@hyperfrontend/builder/index.esm.js +89 -55
package/_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/promise/index.cjs.js +4 -0
package/_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/promise/index.esm.js +3 -1
package/_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/reflect/index.cjs.js +10 -0
package/_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/reflect/index.esm.js +6 -0
package/_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/timers/index.cjs.js +5 -0
package/_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/timers/index.esm.js +5 -1
package/_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/typed-arrays/index.cjs.js +2 -2
package/_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/typed-arrays/index.esm.js +2 -2
package/_dependencies/@hyperfrontend/network-protocol/browser/channel/index.cjs.js +5 -19
package/_dependencies/@hyperfrontend/network-protocol/browser/channel/index.esm.js +1 -15
package/_dependencies/@hyperfrontend/network-protocol/browser/data/index.cjs.js +15 -23
package/_dependencies/@hyperfrontend/network-protocol/browser/data/index.esm.js +7 -15
package/_dependencies/@hyperfrontend/network-protocol/browser/packet/index.cjs.js +6 -14
package/_dependencies/@hyperfrontend/network-protocol/browser/packet/index.esm.js +7 -15
package/_dependencies/@hyperfrontend/network-protocol/browser/receiver/index.cjs.js +4 -18
package/_dependencies/@hyperfrontend/network-protocol/browser/receiver/index.esm.js +1 -15
package/_dependencies/@hyperfrontend/network-protocol/browser/sender/index.cjs.js +5 -19
package/_dependencies/@hyperfrontend/network-protocol/browser/sender/index.esm.js +2 -16
package/_dependencies/@hyperfrontend/network-protocol/browser/v1/index.cjs.js +16 -24
package/_dependencies/@hyperfrontend/network-protocol/browser/v1/index.esm.js +7 -15
package/_dependencies/@hyperfrontend/network-protocol/browser/v2/index.cjs.js +16 -24
package/_dependencies/@hyperfrontend/network-protocol/browser/v2/index.esm.js +7 -15
package/_dependencies/@hyperfrontend/network-protocol/node/channel/index.cjs.js +3 -17
package/_dependencies/@hyperfrontend/network-protocol/node/channel/index.esm.js +1 -15
package/_dependencies/@hyperfrontend/network-protocol/node/data/index.cjs.js +6 -14
package/_dependencies/@hyperfrontend/network-protocol/node/data/index.esm.js +7 -15
package/_dependencies/@hyperfrontend/network-protocol/node/packet/index.cjs.js +6 -14
package/_dependencies/@hyperfrontend/network-protocol/node/packet/index.esm.js +7 -15
package/_dependencies/@hyperfrontend/network-protocol/node/receiver/index.cjs.js +3 -17
package/_dependencies/@hyperfrontend/network-protocol/node/receiver/index.esm.js +1 -15
package/_dependencies/@hyperfrontend/network-protocol/node/sender/index.cjs.js +2 -16
package/_dependencies/@hyperfrontend/network-protocol/node/sender/index.esm.js +2 -16
package/_dependencies/@hyperfrontend/network-protocol/node/v1/index.cjs.js +6 -14
package/_dependencies/@hyperfrontend/network-protocol/node/v1/index.esm.js +7 -15
package/_dependencies/@hyperfrontend/network-protocol/node/v2/index.cjs.js +6 -14
package/_dependencies/@hyperfrontend/network-protocol/node/v2/index.esm.js +7 -15
package/_dependencies/@hyperfrontend/nexus/index.cjs.js +49 -19
package/_dependencies/@hyperfrontend/nexus/index.esm.js +49 -19
package/_dependencies/@hyperfrontend/project-scope/core/fs/index.cjs.js +62 -0
package/_dependencies/@hyperfrontend/project-scope/core/fs/index.esm.js +60 -2
package/_shared/generators/feature/generate-feature-module/index.esm.js +11 -6
package/_shared/generators/metadata/generate-metadata/index.esm.js +1 -0
package/_shared/shared/control/index.cjs.js +12 -2
package/_shared/shared/control/index.esm.js +12 -2
package/_shared/shared/request/index.cjs.js +91 -0
package/_shared/shared/request/index.esm.js +88 -0
package/_shared/shared/shutdown/index.esm.js +12 -0
package/bin/hf.js +643 -70
package/bundle/host/index.iife.js +290 -4041
package/bundle/host/index.iife.min.js +1 -1
package/bundle/host/index.umd.js +290 -4041
package/bundle/host/index.umd.min.js +1 -1
package/bundle/hostee/index.iife.js +215 -2893
package/bundle/hostee/index.iife.min.js +1 -1
package/bundle/hostee/index.umd.js +215 -2893
package/bundle/hostee/index.umd.min.js +1 -1
package/cli/args.d.ts +2 -0
package/cli/args.d.ts.map +1 -1
package/cli/commands/build.d.ts +8 -5
package/cli/commands/build.d.ts.map +1 -1
package/cli/commands/dev.d.ts +7 -2
package/cli/commands/dev.d.ts.map +1 -1
package/cli/config/resolve.d.ts +3 -1
package/cli/config/resolve.d.ts.map +1 -1
package/cli/index.cjs.js +643 -70
package/cli/index.d.ts +21 -10
package/cli/index.esm.js +591 -60
package/cli/usage.d.ts +1 -1
package/cli/usage.d.ts.map +1 -1
package/generators/feature/generate-feature-module.d.ts.map +1 -1
package/generators/index.cjs.js +435 -42
package/generators/index.d.ts +9 -8
package/generators/index.esm.js +404 -30
package/generators/metadata/generate-metadata.d.ts +4 -4
package/generators/metadata/generate-metadata.d.ts.map +1 -1
package/generators/shell/connector-types.d.ts +19 -0
package/generators/shell/connector-types.d.ts.map +1 -0
package/generators/shell/generate-shell.d.ts +5 -4
package/generators/shell/generate-shell.d.ts.map +1 -1
package/generators/shell/schema-type.d.ts +20 -0
package/generators/shell/schema-type.d.ts.map +1 -0
package/generators/shell/source-literal.d.ts +28 -0
package/generators/shell/source-literal.d.ts.map +1 -1
package/host/create-shell.d.ts +4 -1
package/host/create-shell.d.ts.map +1 -1
package/host/display-modes/dialog.d.ts +1 -1
package/host/display-modes/dialog.d.ts.map +1 -1
package/host/display-modes/embedded.d.ts +1 -1
package/host/display-modes/embedded.d.ts.map +1 -1
package/host/index.cjs.js +150 -30
package/host/index.d.ts +53 -38
package/host/index.d.ts.map +1 -1
package/host/index.esm.js +129 -9
package/host/lifecycle.d.ts.map +1 -1
package/host/plugins.d.ts +1 -34
package/host/plugins.d.ts.map +1 -1
package/host/types.d.ts +49 -0
package/host/types.d.ts.map +1 -1
package/hostee/index.cjs.js +54 -9
package/hostee/index.d.ts +41 -1
package/hostee/index.d.ts.map +1 -1
package/hostee/index.esm.js +51 -6
package/hostee/lifecycle.d.ts.map +1 -1
package/hostee/types.d.ts +40 -0
package/hostee/types.d.ts.map +1 -1
package/index.cjs.js +32 -1
package/index.d.ts +89 -3
package/index.d.ts.map +1 -1
package/index.esm.js +32 -1
package/nx/executors/build/index.cjs.js +14975 -137
package/nx/executors/build/index.esm.js +14935 -115
package/nx/executors/serve/executor.d.ts.map +1 -1
package/nx/executors/serve/index.cjs.js +6594 -80
package/nx/executors/serve/index.esm.js +6529 -44
package/nx/generators/feature/index.cjs.js +8751 -108
package/nx/generators/feature/index.esm.js +8711 -81
package/package.json +15 -5
package/server/debug-ui/index.d.ts +2 -0
package/server/debug-ui/index.d.ts.map +1 -0
package/server/debug-ui/index.html +15 -0
package/server/debug-ui/index.iife.js +427 -0
package/server/debug-ui/index.iife.min.js +1 -0
package/server/dev-server.d.ts.map +1 -1
package/server/index.cjs.js +78 -10
package/server/index.esm.js +78 -11
package/server/module-dir.d.ts +17 -0
package/server/module-dir.d.ts.map +1 -0
package/server/module-dir.stub.d.ts +15 -0
package/server/module-dir.stub.d.ts.map +1 -0
package/shared/contract.d.ts +1 -1
package/shared/contract.d.ts.map +1 -1
package/shared/control.d.ts +4 -0
package/shared/control.d.ts.map +1 -1
package/shared/invert-contract.d.ts +20 -0
package/shared/invert-contract.d.ts.map +1 -0
package/shared/request.d.ts +68 -0
package/shared/request.d.ts.map +1 -0
package/{nx/shared → shared}/shutdown.d.ts +3 -2
package/shared/shutdown.d.ts.map +1 -0
package/shared/types.d.ts +72 -1
package/shared/types.d.ts.map +1 -1
package/_shared/nx/shared/context/index.cjs.js +0 -18
package/_shared/nx/shared/context/index.esm.js +0 -16
package/nx/shared/shutdown.d.ts.map +0 -1
package/server/debug-ui/bootstrap.d.ts +0 -2
package/server/debug-ui/bootstrap.d.ts.map +0 -1

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@hyperfrontend/features",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "SDK, CLI, and dev server for building, embedding, and orchestrating hyperfrontend micro-frontend features.",
   "license": "MIT",
   "sideEffects": false,
@@ -160,8 +160,12 @@
     "generators/feature/generate-feature-module.d.ts.map",
     "generators/metadata/generate-metadata.d.ts",
     "generators/metadata/generate-metadata.d.ts.map",
+    "generators/shell/connector-types.d.ts",
+    "generators/shell/connector-types.d.ts.map",
     "generators/shell/generate-shell.d.ts",
     "generators/shell/generate-shell.d.ts.map",
+    "generators/shell/schema-type.d.ts",
+    "generators/shell/schema-type.d.ts.map",
     "generators/shell/source-literal.d.ts",
     "generators/shell/source-literal.d.ts.map",
     "host/create-shell.d.ts",
@@ -219,14 +223,10 @@
     "nx/shared/context.d.ts.map",
     "nx/shared/flags.d.ts",
     "nx/shared/flags.d.ts.map",
-    "nx/shared/shutdown.d.ts",
-    "nx/shared/shutdown.d.ts.map",
     "server/config.d.ts",
     "server/config.d.ts.map",
     "server/debug-ui/app.d.ts",
     "server/debug-ui/app.d.ts.map",
-    "server/debug-ui/bootstrap.d.ts",
-    "server/debug-ui/bootstrap.d.ts.map",
     "server/debug-ui/controls.d.ts",
     "server/debug-ui/controls.d.ts.map",
     "server/debug-ui/message-log.d.ts",
@@ -235,6 +235,10 @@
     "server/debug-ui/styles.d.ts.map",
     "server/dev-server.d.ts",
     "server/dev-server.d.ts.map",
+    "server/module-dir.d.ts",
+    "server/module-dir.d.ts.map",
+    "server/module-dir.stub.d.ts",
+    "server/module-dir.stub.d.ts.map",
     "server/static-handler.d.ts",
     "server/static-handler.d.ts.map",
     "shared/contract.d.ts",
@@ -243,8 +247,14 @@
     "shared/control.d.ts.map",
     "shared/event-emitter.d.ts",
     "shared/event-emitter.d.ts.map",
+    "shared/invert-contract.d.ts",
+    "shared/invert-contract.d.ts.map",
+    "shared/request.d.ts",
+    "shared/request.d.ts.map",
     "shared/sdk-info.d.ts",
     "shared/sdk-info.d.ts.map",
+    "shared/shutdown.d.ts",
+    "shared/shutdown.d.ts.map",
     "shared/types.d.ts",
     "shared/types.d.ts.map",
     "!**/*.js.map"

package/server/debug-ui/index.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+
2	+ export { };

package/server/debug-ui/index.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/features/src/server/debug-ui/index.ts"],"names":[],"mappings":""}

package/server/debug-ui/index.html ADDED Viewed

@@ -0,0 +1,15 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>hyperfrontend · debug</title>
+  </head>
+  <body style="margin: 0; background: #1e1e1e">
+    <div id="hf-debug-root"></div>
+    <script>
+      window.__HF_DEBUG_MANIFEST__ = HF_MANIFEST_PLACEHOLDER
+    </script>
+    <script src="/__debug/index.iife.min.js"></script>
+  </body>
+</html>

package/server/debug-ui/index.iife.js ADDED Viewed

@@ -0,0 +1,427 @@
+(function () {
+    'use strict';
+    const _Object = globalThis.Object;
+    const freeze = _Object.freeze;
+    const assign = _Object.assign;
+    const _URL = globalThis.URL;
+    const _Reflect$1 = globalThis.Reflect;
+    const createURL = (url, base) => _Reflect$1.construct(_URL, [url, base]);
+    typeof _URL.createObjectURL === 'function'
+        ? _URL.createObjectURL.bind(_URL)
+        : () => {
+            throw new Error('URL.createObjectURL is not available in this environment');
+        };
+    typeof _URL.revokeObjectURL === 'function'
+        ? _URL.revokeObjectURL.bind(_URL)
+        : () => {
+            throw new Error('URL.revokeObjectURL is not available in this environment');
+        };
+    const _Array = globalThis.Array;
+    const isArray = _Array.isArray;
+    const from = _Array.from;
+    const _Set = globalThis.Set;
+    const _Reflect = globalThis.Reflect;
+    const createSet = (iterable) => _Reflect.construct(_Set, iterable ? [iterable] : []);
+    function nonEmptyStrings(values) {
+        return values.filter((value) => ![undefined, null, ''].includes(value) && value.trim() !== '');
+    }
+    function uniqueStrings(values) {
+        return from(createSet(values));
+    }
+    function createElement(tagName, config) {
+        const element = document.createElement(tagName);
+        if (config?.inlineStyle) {
+            assign(element.style, config.inlineStyle);
+        }
+        const classList = [];
+        if (config?.classNames && isArray(config.classNames)) {
+            classList.push(...config.classNames);
+        }
+        if (config?.className) {
+            classList.push(config.className);
+        }
+        element.classList.add(...nonEmptyStrings(uniqueStrings(classList)));
+        let isVisible = false;
+        const addChild = (child) => {
+            if (!child)
+                return;
+            const childElement = 'ref' in child ? child.ref : child;
+            if (!element.contains(childElement)) {
+                element.appendChild(childElement);
+            }
+        };
+        const attachTo = (parent) => {
+            if (!parent)
+                return;
+            const parentElement = 'ref' in parent ? parent.ref : parent;
+            if (!parentElement.contains(element)) {
+                parentElement.appendChild(element);
+            }
+        };
+        const getTransition = (duration) => {
+            return duration ? `opacity ${(duration / 1000).toFixed(1)}s` : 'none';
+        };
+        const show = (duration) => {
+            element.style.transition = getTransition(duration);
+            element.style.opacity = '1';
+            isVisible = true;
+        };
+        const hide = (duration) => {
+            element.style.transition = getTransition(duration);
+            element.style.opacity = '0';
+            isVisible = false;
+        };
+        const removeChild = (child) => {
+            if (!child)
+                return;
+            const childElement = 'ref' in child ? child.ref : child;
+            if (element.contains(childElement)) {
+                element.removeChild(childElement);
+            }
+        };
+        const detachFromParent = () => {
+            const parent = element.parentElement;
+            if (parent) {
+                parent.removeChild(element);
+            }
+        };
+        return {
+            get addChild() {
+                return addChild;
+            },
+            get attachTo() {
+                return attachTo;
+            },
+            get show() {
+                return show;
+            },
+            get hide() {
+                return hide;
+            },
+            get removeChild() {
+                return removeChild;
+            },
+            get detachFromParent() {
+                return detachFromParent;
+            },
+            get ref() {
+                return element;
+            },
+            get visible() {
+                return isVisible;
+            },
+        };
+    }
+    function span(config) {
+        return createElement('span', config);
+    }
+    function div(config) {
+        return createElement('div', config);
+    }
+    function button(config) {
+        return createElement('button', config);
+    }
+    function input(config) {
+        return createElement('input', config);
+    }
+    function label(config) {
+        return createElement('label', config);
+    }
+    const DisplayMode = freeze({
+        Embedded: 'embedded',
+        Dialog: 'dialog',
+        Popup: 'popup',
+        Standalone: 'standalone',
+    });
+    const palette = {
+        background: '#1e1e1e',
+        panel: '#252526',
+        text: '#d4d4d4',
+        muted: '#858585',
+        border: '#3c3c3c',
+        incoming: '#4ec9b0',
+        outgoing: '#dcdcaa',
+        online: '#4caf50',
+        offline: '#f44336',
+    };
+    const rootStyle = {
+        display: 'flex',
+        flexDirection: 'column',
+        gap: '12px',
+        height: '100vh',
+        boxSizing: 'border-box',
+        padding: '12px',
+        background: palette.background,
+        color: palette.text,
+        fontFamily: 'ui-monospace, SFMono-Regular, Menlo, monospace',
+        fontSize: '13px',
+    };
+    const panelStyle = {
+        border: `1px solid ${palette.border}`,
+        borderRadius: '4px',
+        background: palette.panel,
+        padding: '10px',
+    };
+    const toolbarStyle = {
+        display: 'flex',
+        flexWrap: 'wrap',
+        alignItems: 'center',
+        gap: '10px',
+    };
+    const controlStyle = {
+        background: palette.background,
+        color: palette.text,
+        border: `1px solid ${palette.border}`,
+        borderRadius: '3px',
+        padding: '4px 6px',
+        font: 'inherit',
+    };
+    const labelStyle = {
+        display: 'inline-flex',
+        alignItems: 'center',
+        gap: '4px',
+        color: palette.muted,
+    };
+    const logStyle = {
+        flex: '1',
+        overflowY: 'auto',
+        margin: '0',
+        whiteSpace: 'pre-wrap',
+        wordBreak: 'break-word',
+    };
+    function statusDotStyle(connected) {
+        return {
+            width: '10px',
+            height: '10px',
+            borderRadius: '50%',
+            background: connected ? palette.online : palette.offline,
+        };
+    }
+    function messageEntryStyle(direction) {
+        return {
+            borderLeft: `3px solid ${direction === 'incoming' ? palette.incoming : palette.outgoing}`,
+            padding: '2px 8px',
+            margin: '4px 0',
+        };
+    }
+    const DISPLAY_MODES = [DisplayMode.Embedded, DisplayMode.Dialog, DisplayMode.Popup, DisplayMode.Standalone];
+    const PROTOCOLS = ['none', 'v1', 'v2'];
+    function buildSelect(values, current, onChange) {
+        const select = createElement('select', { inlineStyle: controlStyle }).ref;
+        values.forEach((value) => {
+            const option = createElement('option').ref;
+            option.value = value;
+            option.textContent = value;
+            if (value === current) {
+                option.selected = true;
+            }
+            select.appendChild(option);
+        });
+        select.addEventListener('change', () => onChange(select.value));
+        return select;
+    }
+    function labelled(caption, control) {
+        const wrapper = label({ inlineStyle: labelStyle });
+        const text = span();
+        text.ref.textContent = caption;
+        wrapper.addChild(text);
+        wrapper.addChild(control);
+        return wrapper.ref;
+    }
+    function createControls(options) {
+        let width = options.width;
+        let height = options.height;
+        const panel = div({ inlineStyle: { ...panelStyle, ...toolbarStyle } });
+        const dot = div({ inlineStyle: statusDotStyle(false) });
+        const statusText = span();
+        statusText.ref.textContent = 'disconnected';
+        const status = div({ inlineStyle: labelStyle });
+        status.addChild(dot);
+        status.addChild(statusText);
+        panel.addChild(status);
+        const modeSelect = buildSelect(DISPLAY_MODES, options.displayMode, options.onDisplayModeChange);
+        panel.addChild(labelled('mode', modeSelect));
+        const emitResize = () => options.onResize({ width, height });
+        const widthInput = buildNumberInput(width, (value) => {
+            width = value;
+            emitResize();
+        });
+        const heightInput = buildNumberInput(height, (value) => {
+            height = value;
+            emitResize();
+        });
+        panel.addChild(labelled('w', widthInput));
+        panel.addChild(labelled('h', heightInput));
+        const protocolSelect = buildSelect(PROTOCOLS, options.protocol, options.onProtocolChange);
+        panel.addChild(labelled('security', protocolSelect));
+        return {
+            element: panel.ref,
+            setConnected: (connected) => {
+                dot.ref.style.background = connected ? palette.online : palette.offline;
+                statusText.ref.textContent = connected ? 'connected' : 'disconnected';
+            },
+        };
+    }
+    function buildNumberInput(value, onChange) {
+        const field = input({ inlineStyle: { ...controlStyle, width: '70px' } }).ref;
+        field.type = 'number';
+        field.value = `${value}`;
+        field.addEventListener('input', () => onChange(Number(field.value)));
+        return field;
+    }
+    const _JSON = globalThis.JSON;
+    const stringify = _JSON.stringify;
+    const VIEWS = ['raw', 'decrypted', 'pretty'];
+    function formatPayload(message, view) {
+        if (view === 'raw') {
+            return stringify(message.raw);
+        }
+        if (view === 'decrypted') {
+            return message.decrypted === undefined ? '(encrypted — no decrypted payload)' : stringify(message.decrypted);
+        }
+        return stringify(message.decrypted ?? message.raw, null, 2);
+    }
+    function renderEntry(message, view) {
+        const entry = div({ inlineStyle: messageEntryStyle(message.direction) });
+        const heading = div({ inlineStyle: { color: palette.muted, marginBottom: '2px' } });
+        heading.ref.textContent = `${message.direction === 'incoming' ? '◀ in' : '▶ out'}${message.channel ? ` · ${message.channel}` : ''}`;
+        const body = div();
+        body.ref.textContent = formatPayload(message, view);
+        entry.addChild(heading);
+        entry.addChild(body);
+        return entry.ref;
+    }
+    function createMessageLog() {
+        const messages = [];
+        let view = 'pretty';
+        const element = div({ inlineStyle: { ...panelStyle, display: 'flex', flexDirection: 'column', flex: '1', minHeight: '0' } });
+        const toolbar = div({ inlineStyle: toolbarStyle });
+        const title = div({ inlineStyle: labelStyle });
+        title.ref.textContent = 'Messages';
+        toolbar.addChild(title);
+        const body = div({ inlineStyle: logStyle });
+        const render = () => {
+            body.ref.textContent = '';
+            messages.forEach((message) => body.addChild(renderEntry(message, view)));
+        };
+        VIEWS.forEach((candidate) => {
+            const toggle = button({ inlineStyle: controlStyle });
+            toggle.ref.type = 'button';
+            toggle.ref.textContent = candidate;
+            toggle.ref.addEventListener('click', () => {
+                view = candidate;
+                render();
+            });
+            toolbar.addChild(toggle);
+        });
+        element.addChild(toolbar);
+        element.addChild(body);
+        return {
+            element: element.ref,
+            append: (message) => {
+                messages.push(message);
+                body.addChild(renderEntry(message, view));
+            },
+            setView: (next) => {
+                view = next;
+                render();
+            },
+            clear: () => {
+                messages.length = 0;
+                render();
+            },
+        };
+    }
+    const DEFAULT_WIDTH = 480;
+    const DEFAULT_HEIGHT = 360;
+    function originOf(url) {
+        try {
+            return createURL(url).origin;
+        }
+        catch {
+            return null;
+        }
+    }
+    function mountDebugUi(root, manifest, deps = {}) {
+        const view = deps.window ?? window;
+        assign(root.style, rootStyle);
+        const iframe = createElement('iframe', {
+            inlineStyle: { border: 'none', width: `${DEFAULT_WIDTH}px`, height: `${DEFAULT_HEIGHT}px`, background: '#fff' },
+        }).ref;
+        const firstApp = manifest.apps[0];
+        if (firstApp !== undefined) {
+            iframe.src = firstApp.url;
+        }
+        let securityReadout;
+        if (manifest.debug.securityView) {
+            const security = div({ inlineStyle: labelStyle });
+            const readout = span();
+            readout.ref.textContent = 'protocol: none';
+            security.addChild(readout);
+            securityReadout = readout.ref;
+            root.appendChild(security.ref);
+        }
+        const controls = createControls({
+            displayMode: DisplayMode.Embedded,
+            width: DEFAULT_WIDTH,
+            height: DEFAULT_HEIGHT,
+            protocol: 'none',
+            onDisplayModeChange: (mode) => iframe.setAttribute('data-display-mode', mode),
+            onResize: ({ width, height }) => {
+                iframe.style.width = `${width}px`;
+                iframe.style.height = `${height}px`;
+            },
+            onProtocolChange: (protocol) => {
+                if (securityReadout !== undefined) {
+                    securityReadout.textContent = `protocol: ${protocol}`;
+                }
+            },
+        });
+        root.appendChild(controls.element);
+        const stage = div({ inlineStyle: { ...panelStyle, flex: '1', display: 'flex', minHeight: '0', overflow: 'auto' } });
+        stage.ref.appendChild(iframe);
+        root.appendChild(stage.ref);
+        let log;
+        if (manifest.debug.messageLog) {
+            log = createMessageLog();
+            root.appendChild(log.element);
+        }
+        const allowedOrigins = manifest.apps.map((app) => originOf(app.url)).filter((origin) => origin !== null);
+        const onMessage = (event) => {
+            if (!allowedOrigins.includes(event.origin)) {
+                return;
+            }
+            controls.setConnected(true);
+            log?.append({ direction: 'incoming', raw: event.data });
+        };
+        view.addEventListener('message', onMessage);
+        return {
+            element: root,
+            cleanup: () => {
+                view.removeEventListener('message', onMessage);
+                root.textContent = '';
+            },
+        };
+    }
+    const root = document.getElementById('hf-debug-root');
+    const manifest = window.__HF_DEBUG_MANIFEST__;
+    if (root !== null && manifest !== undefined) {
+        mountDebugUi(root, manifest);
+    }
+})();

package/server/debug-ui/index.iife.min.js ADDED Viewed

@@ -0,0 +1 @@

+ !function(){"use strict";const e=globalThis.Object,t=e.freeze,n=e.assign,i=globalThis.URL,o=globalThis.Reflect;"function"==typeof i.createObjectURL&&i.createObjectURL.bind(i),"function"==typeof i.revokeObjectURL&&i.revokeObjectURL.bind(i);const d=globalThis.Array,r=d.isArray,l=d.from,a=globalThis.Set,c=globalThis.Reflect;function s(e){return l((t=e,c.construct(a,t?[t]:[])));var t}function p(e,t){const i=document.createElement(e);t?.inlineStyle&&n(i.style,t.inlineStyle);const o=[];var d;t?.classNames&&r(t.classNames)&&o.push(...t.classNames),t?.className&&o.push(t.className),i.classList.add(...(d=s(o),d.filter(e=>![void 0,null,""].includes(e)&&""!==e.trim())));let l=!1;const a=e=>{if(!e)return;const t="ref"in e?e.ref:e;i.contains(t)||i.appendChild(t)},c=e=>{if(!e)return;const t="ref"in e?e.ref:e;t.contains(i)||t.appendChild(i)},p=e=>e?`opacity ${(e/1e3).toFixed(1)}s`:"none",u=e=>{i.style.transition=p(e),i.style.opacity="1",l=!0},f=e=>{i.style.transition=p(e),i.style.opacity="0",l=!1},h=e=>{if(!e)return;const t="ref"in e?e.ref:e;i.contains(t)&&i.removeChild(t)},g=()=>{const e=i.parentElement;e&&e.removeChild(i)};return{get addChild(){return a},get attachTo(){return c},get show(){return u},get hide(){return f},get removeChild(){return h},get detachFromParent(){return g},get ref(){return i},get visible(){return l}}}function u(e){return p("span",e)}function f(e){return p("div",e)}const h=t({Embedded:"embedded",Dialog:"dialog",Popup:"popup",Standalone:"standalone"}),g="#1e1e1e",y="#d4d4d4",x="#858585",m="#3c3c3c",C="#4ec9b0",b="#dcdcaa",v="#4caf50",w="#f44336",S={display:"flex",flexDirection:"column",gap:"12px",height:"100vh",boxSizing:"border-box",padding:"12px",background:g,color:y,fontFamily:"ui-monospace, SFMono-Regular, Menlo, monospace",fontSize:"13px"},E={border:`1px solid ${m}`,borderRadius:"4px",background:"#252526",padding:"10px"},R={display:"flex",flexWrap:"wrap",alignItems:"center",gap:"10px"},L={background:g,color:y,border:`1px solid ${m}`,borderRadius:"3px",padding:"4px 6px",font:"inherit"},k={display:"inline-flex",alignItems:"center",gap:"4px",color:x},$={flex:"1",overflowY:"auto",margin:"0",whiteSpace:"pre-wrap",wordBreak:"break-word"};const T=[h.Embedded,h.Dialog,h.Popup,h.Standalone],M=["none","v1","v2"];function N(e,t,n){const i=p("select",{inlineStyle:L}).ref;return e.forEach(e=>{const n=p("option").ref;n.value=e,n.textContent=e,e===t&&(n.selected=!0),i.appendChild(n)}),i.addEventListener("change",()=>n(i.value)),i}function D(e,t){const n=p("label",{inlineStyle:k});const i=u();return i.ref.textContent=e,n.addChild(i),n.addChild(t),n.ref}function F(e,t){const n=(i={inlineStyle:{...L,width:"70px"}},p("input",i)).ref;var i;return n.type="number",n.value=`${e}`,n.addEventListener("input",()=>t(Number(n.value))),n}const O=globalThis.JSON.stringify,U=["raw","decrypted","pretty"];function _(e,t){const n=f({inlineStyle:(i=e.direction,{borderLeft:`3px solid ${"incoming"===i?C:b}`,padding:"2px 8px",margin:"4px 0"})});var i;const o=f({inlineStyle:{color:x,marginBottom:"2px"}});o.ref.textContent=`${"incoming"===e.direction?"◀ in":"▶ out"}${e.channel?` · ${e.channel}`:""}`;const d=f();return d.ref.textContent=function(e,t){return"raw"===t?O(e.raw):"decrypted"===t?void 0===e.decrypted?"(encrypted — no decrypted payload)":O(e.decrypted):O(e.decrypted??e.raw,null,2)}(e,t),n.addChild(o),n.addChild(d),n.ref}function j(){const e=[];let t="pretty";const n=f({inlineStyle:{...E,display:"flex",flexDirection:"column",flex:"1",minHeight:"0"}}),i=f({inlineStyle:R}),o=f({inlineStyle:k});o.ref.textContent="Messages",i.addChild(o);const d=f({inlineStyle:$}),r=()=>{d.ref.textContent="",e.forEach(e=>d.addChild(_(e,t)))};return U.forEach(e=>{const n=p("button",{inlineStyle:L});n.ref.type="button",n.ref.textContent=e,n.ref.addEventListener("click",()=>{t=e,r()}),i.addChild(n)}),n.addChild(i),n.addChild(d),{element:n.ref,append:n=>{e.push(n),d.addChild(_(n,t))},setView:e=>{t=e,r()},clear:()=>{e.length=0,r()}}}function z(e){try{return((e,t)=>o.construct(i,[e,t]))(e).origin}catch{return null}}const P=document.getElementById("hf-debug-root"),A=window.__HF_DEBUG_MANIFEST__;null!==P&&void 0!==A&&function(e,t,i={}){const o=i.window??window;n(e.style,S);const d=p("iframe",{inlineStyle:{border:"none",width:"480px",height:"360px",background:"#fff"}}).ref,r=t.apps[0];let l;if(void 0!==r&&(d.src=r.url),t.debug.securityView){const t=f({inlineStyle:k}),n=u();n.ref.textContent="protocol: none",t.addChild(n),l=n.ref,e.appendChild(t.ref)}const a=function(e){let t=e.width,n=e.height;const i=f({inlineStyle:{...E,...R}}),o=f({inlineStyle:(d=!1,{width:"10px",height:"10px",borderRadius:"50%",background:d?v:w})});var d;const r=u();r.ref.textContent="disconnected";const l=f({inlineStyle:k});l.addChild(o),l.addChild(r),i.addChild(l);const a=N(T,e.displayMode,e.onDisplayModeChange);i.addChild(D("mode",a));const c=()=>e.onResize({width:t,height:n}),s=F(t,e=>{t=e,c()}),p=F(n,e=>{n=e,c()});i.addChild(D("w",s)),i.addChild(D("h",p));const h=N(M,e.protocol,e.onProtocolChange);return i.addChild(D("security",h)),{element:i.ref,setConnected:e=>{o.ref.style.background=e?v:w,r.ref.textContent=e?"connected":"disconnected"}}}({displayMode:h.Embedded,width:480,height:360,protocol:"none",onDisplayModeChange:e=>d.setAttribute("data-display-mode",e),onResize:({width:e,height:t})=>{d.style.width=`${e}px`,d.style.height=`${t}px`},onProtocolChange:e=>{void 0!==l&&(l.textContent=`protocol: ${e}`)}});e.appendChild(a.element);const c=f({inlineStyle:{...E,flex:"1",display:"flex",minHeight:"0",overflow:"auto"}});let s;c.ref.appendChild(d),e.appendChild(c.ref),t.debug.messageLog&&(s=j(),e.appendChild(s.element));const g=t.apps.map(e=>z(e.url)).filter(e=>null!==e),y=e=>{g.includes(e.origin)&&(a.setConnected(!0),s?.append({direction:"incoming",raw:e.data}))};o.addEventListener("message",y)}(P,A)}();

package/server/dev-server.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"dev-server.d.ts","sourceRoot":"","sources":["../../../../../../../libs/features/src/server/dev-server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;~~AAezD~~,0CAA0C;AAC1C,MAAM,WAAW,YAAY;IAC3B,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,6CAA6C;IAC7C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACrB;AAED,mDAAmD;AACnD,MAAM,WAAW,cAAc;IAC7B,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,6CAA6C;IAC7C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACrB;AAED,wFAAwF;AACxF,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,SAAS,cAAc,EAAE,CAAA;IACxC,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAA;CACjC;AAED,2EAA2E;AAC3E,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,SAAS,YAAY,EAAE,CAAA;IACtC,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAA;IAC9B,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,4DAA4D;IAC5D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAED,kFAAkF;AAClF,MAAM,WAAW,aAAc,SAAQ,iBAAiB;IACtD,qDAAqD;IACrD,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,KAAK,IAAI,KAAK,MAAM,CAAA;IAChG,+GAA+G;IAC/G,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;~~AAsHD~~;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,iBAAiB,EAAE,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,~~CA6BlH~~"}
1	+ {"version":3,"file":"dev-server.d.ts","sourceRoot":"","sources":["../../../../../../../libs/features/src/server/dev-server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAgBzD,0CAA0C;AAC1C,MAAM,WAAW,YAAY;IAC3B,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,6CAA6C;IAC7C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACrB;AAED,mDAAmD;AACnD,MAAM,WAAW,cAAc;IAC7B,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,6CAA6C;IAC7C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACrB;AAED,wFAAwF;AACxF,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,SAAS,cAAc,EAAE,CAAA;IACxC,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAA;CACjC;AAED,2EAA2E;AAC3E,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,SAAS,YAAY,EAAE,CAAA;IACtC,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAA;IAC9B,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,4DAA4D;IAC5D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAED,kFAAkF;AAClF,MAAM,WAAW,aAAc,SAAQ,iBAAiB;IACtD,qDAAqD;IACrD,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,KAAK,IAAI,KAAK,MAAM,CAAA;IAChG,+GAA+G;IAC/G,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAqKD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,iBAAiB,EAAE,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CA8BlH"}

package/server/index.cjs.js CHANGED Viewed

@@ -11,6 +11,7 @@ const index_cjs_js$6 = require('../_dependencies/@hyperfrontend/immutable-api-ut
 const index_cjs_js$5 = require('../_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/promise/index.cjs.js');
 const index_cjs_js$4 = require('../_dependencies/@hyperfrontend/immutable-api-utils/built-in-copy/object/index.cjs.js');
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 // note: Resolution order — JSON first, then JS, then TS.
 const CONFIG_EXTENSIONS = ['.json', '.js', '.mjs', '.cjs', '.ts', '.cts', '.mts'];
 /** Base name (no extension) of the dev-server config file. */
@@ -263,6 +264,29 @@ async function resolveDevConfig(options) {
     };
 }
+/**
+ * Directory of the currently-running module under either module system.
+ *
+ * The CommonJS build (and any CommonJS host) exposes `__dirname`; the
+ * ES-module build derives the directory from `import.meta.url`. Both formats
+ * ship beside the `debug-ui` assets, so the result anchors asset
+ * self-location wherever the package is installed or embedded.
+ *
+ * @returns Absolute directory path of the running module.
+ *
+ * @example Anchoring an asset lookup beside the running module
+ * ```typescript
+ * const assetDir = join(currentModuleDir(), 'debug-ui')
+ * ```
+ */
+function currentModuleDir() {
+    // why: `typeof` guards the CommonJS-only global so the ES-module build falls through to `import.meta.url` instead of crashing on an undefined identifier.
+    if (typeof __dirname !== 'undefined') {
+        return __dirname;
+    }
+    return node_path.dirname(node_url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs.js', document.baseURI).href))));
+}
 // note: Minimal MIME table for the asset types a compiled feature/debug-UI bundle ships; anything else falls back to octet-stream.
 const CONTENT_TYPES = index_cjs_js$4.freeze({
     '.html': 'text/html; charset=utf-8',
@@ -371,23 +395,66 @@ function createStaticHandler(root, deps = {}) {
     return (req, res) => serveFile(root, req.url ?? '/', res, deps);
 }
-// note: Path prefix the control server serves the compiled debug-UI assets under; the page loads `/__debug/bootstrap.js`.
+// note: Path prefix the control server serves the compiled debug-UI assets under; the page loads `/__debug/index.iife.min.js`.
 const DEBUG_PREFIX = '/__debug';
 // note: Placeholder the debug-UI HTML embeds; the control server swaps it for the live JSON manifest at request time.
 const MANIFEST_TOKEN = 'HF_MANIFEST_PLACEHOLDER';
 /**
- * Resolves the directory the compiled debug-UI assets ship in, located beside
- * this module via `__dirname` so the server finds them wherever the package is
- * installed.
+ * Probes a single directory for the shipped debug-UI assets, checking both a
+ * sibling `debug-ui` folder (running from the `server/` output) and a nested
+ * `server/debug-ui` folder (running from another package entry, such as the
+ * CLI bin at the package root).
+ *
+ * @param dir - Candidate directory expected to hold the assets.
+ * @param isFile - File probe used to confirm the assets exist.
+ * @returns The `debug-ui` asset directory, or `undefined` when it is not here.
+ */
+function probeAssetDir(dir, isFile) {
+    const sibling = node_path.join(dir, 'debug-ui');
+    if (isFile(node_path.join(sibling, 'index.html'))) {
+        return sibling;
+    }
+    const nested = node_path.join(dir, 'server', 'debug-ui');
+    return isFile(node_path.join(nested, 'index.html')) ? nested : undefined;
+}
+/**
+ * Locates the debug-UI assets by ascending from a start directory toward the
+ * filesystem root, returning the first ancestor holding a `debug-ui` folder.
+ *
+ * @param startDir - Directory the ascent begins from.
+ * @param isFile - File probe used to confirm the assets exist.
+ * @returns The `debug-ui` asset directory, or `undefined` when no ancestor holds one.
+ */
+function ascendForAssets(startDir, isFile) {
+    let dir = startDir;
+    let parent = node_path.dirname(dir);
+    // how: probe each level then step up; the final probe covers the filesystem root, where parent === dir
+    while (parent !== dir) {
+        const found = probeAssetDir(dir, isFile);
+        if (found !== undefined) {
+            return found;
+        }
+        dir = parent;
+        parent = node_path.dirname(dir);
+    }
+    return probeAssetDir(dir, isFile);
+}
+/**
+ * Resolves the directory the compiled debug-UI assets ship in by ascending
+ * from the running module (located via `__dirname` in CommonJS or
+ * `import.meta.url` in ESM). The ascent finds the assets wherever the package
+ * lives — the built dist, an installed `node_modules` copy, or embedded
+ * inside a consumer's bundle output.
  *
+ * @param isFile - File probe used to confirm the assets exist.
  * @returns The absolute debug-UI asset directory.
  */
-function defaultAssetRoot() {
-    /* istanbul ignore if -- @preserve the ESM build has no __dirname; the shipped CommonJS build and the test runner always define it */
-    if (typeof __dirname === 'undefined') {
-        throw index_cjs_js$1.createError('@hyperfrontend/features dev server self-location requires the CommonJS build; inject `assetRoot` otherwise.');
+function defaultAssetRoot(isFile) {
+    const located = ascendForAssets(currentModuleDir(), isFile);
+    if (located === undefined) {
+        throw index_cjs_js$1.createError('@hyperfrontend/features dev server could not locate the bundled debug-UI assets beside the running module; inject `assetRoot` to point at a directory containing the debug-UI `index.html`.');
     }
-    return node_path.join(__dirname, 'debug-ui');
+    return located;
 }
 /**
  * Reads the listening port from a server, throwing if the address is unexpectedly absent.
@@ -498,7 +565,6 @@ function controlHandler(manifest, assetRoot, deps) {
  */
 async function startDevServer(config, deps = {}) {
     const createServer = deps.createServer ?? node_http.createServer;
-    const assetRoot = deps.assetRoot ?? defaultAssetRoot();
     const servers = [];
     const apps = [];
     for (const app of config.apps) {
@@ -510,6 +576,8 @@ async function startDevServer(config, deps = {}) {
     const manifest = { apps: apps.map((app) => ({ name: app.name, url: app.url })), debug: config.debug };
     let debugUrl;
     if (config.debug.enabled) {
+        // why: resolved only when the debug UI is enabled so consumers with it disabled never pay for (or fail on) asset self-location.
+        const assetRoot = deps.assetRoot ?? defaultAssetRoot(deps.isFile ?? index_cjs_js.isFile);
         const control = createServer(controlHandler(manifest, assetRoot, deps));
         const port = await listen(control, config.debugPort);
         servers.push(control);