@sigx/terminal 0.1.24 → 0.1.26

package/dist/index.js

@@ -665,6 +665,59 @@ function component(setup, options) {
 	getComponentPlugins().forEach((p) => p.onDefine?.(options?.name, factory, setup));
 	return factory;
 }
+var SigxError = class extends Error {
+	constructor(message, options) {
+		super(message);
+		this.name = "SigxError";
+		this.code = options.code;
+		this.suggestion = options.suggestion;
+		if (options.cause) this.cause = options.cause;
+	}
+};
+const SigxErrorCode = {
+	NO_MOUNT_FUNCTION: "SIGX001",
+	RENDER_TARGET_NOT_FOUND: "SIGX100",
+	MOUNT_TARGET_NOT_FOUND: "SIGX101",
+	ASYNC_SETUP_CLIENT: "SIGX102",
+	PROVIDE_OUTSIDE_SETUP: "SIGX200",
+	PROVIDE_INVALID_INJECTABLE: "SIGX201"
+};
+function noMountFunctionError() {
+	return new SigxError("No mount function provided and no default mount function set.", {
+		code: SigxErrorCode.NO_MOUNT_FUNCTION,
+		suggestion: "Either pass a mount function to app.mount(), or import a platform package (e.g., @sigx/runtime-dom or @sigx/runtime-terminal) that sets the default."
+	});
+}
+function renderTargetNotFoundError(selector) {
+	return new SigxError(`Render target "${selector}" not found.`, {
+		code: SigxErrorCode.RENDER_TARGET_NOT_FOUND,
+		suggestion: `Make sure the element exists in your HTML: <div id="${selector.replace(/^#/, "")}"></div>`
+	});
+}
+function mountTargetNotFoundError(selector) {
+	return new SigxError(`Mount target "${selector}" not found.`, {
+		code: SigxErrorCode.MOUNT_TARGET_NOT_FOUND,
+		suggestion: `Make sure the element exists in your HTML: <div id="${selector.replace(/^#/, "")}"></div>`
+	});
+}
+function asyncSetupClientError(componentName) {
+	return new SigxError(`Async setup in component "${componentName}" is only supported during SSR.`, {
+		code: SigxErrorCode.ASYNC_SETUP_CLIENT,
+		suggestion: "On the client, use pre-loaded data from hydration or fetch in onMounted."
+	});
+}
+function provideOutsideSetupError() {
+	return new SigxError("defineProvide must be called inside a component setup function.", {
+		code: SigxErrorCode.PROVIDE_OUTSIDE_SETUP,
+		suggestion: "Move the defineProvide() call inside your component's setup function, or use app.defineProvide() at the app level."
+	});
+}
+function provideInvalidInjectableError() {
+	return new SigxError("defineProvide must be called with a function created by defineInjectable.", {
+		code: SigxErrorCode.PROVIDE_INVALID_INJECTABLE,
+		suggestion: "Create an injectable first:\n  const useMyService = defineInjectable(() => new MyService());\n  defineProvide(useMyService);"
+	});
+}
 var globalInstances = /* @__PURE__ */ new Map();
 var appContextToken = Symbol("sigx:appContext");
 function lookupProvided(token) {
@@ -678,9 +731,10 @@ function lookupProvided(token) {
 }
 function provideAtComponent(token, value) {
 	const ctx = getCurrentInstance();
-	if (!ctx) throw new Error("defineProvide must be called inside a component setup function");
-	if (!ctx.provides) ctx.provides = /* @__PURE__ */ new Map();
-	ctx.provides.set(token, value);
+	if (!ctx) throw provideOutsideSetupError();
+	const node = ctx;
+	if (!node.provides) node.provides = /* @__PURE__ */ new Map();
+	node.provides.set(token, value);
 }
 function defineInjectable(factory) {
 	const token = Symbol();
@@ -697,7 +751,7 @@ function defineInjectable(factory) {
 function defineProvide(useFn, factory) {
 	const actualFactory = factory ?? useFn._factory;
 	const token = useFn._token;
-	if (!actualFactory || !token) throw new Error("defineProvide must be called with a function created by defineInjectable");
+	if (!actualFactory || !token) throw provideInvalidInjectableError();
 	const instance = actualFactory();
 	provideAtComponent(token, instance);
 	return instance;
@@ -709,9 +763,10 @@ function getAppContextToken() {
 	return appContextToken;
 }
 function provideAppContext(ctx, appContext) {
-	if (!ctx.provides) ctx.provides = /* @__PURE__ */ new Map();
-	ctx.provides.set(appContextToken, appContext);
-	if (appContext.provides) for (const [token, value] of appContext.provides) ctx.provides.set(token, value);
+	const node = ctx;
+	if (!node.provides) node.provides = /* @__PURE__ */ new Map();
+	node.provides.set(appContextToken, appContext);
+	if (appContext.provides) for (const [token, value] of appContext.provides) node.provides.set(token, value);
 }
 const __DIRECTIVE__ = Symbol.for("sigx.directive");
 function defineDirective(definition) {
@@ -754,7 +809,7 @@ function defineApp(rootComponent) {
 		defineProvide(useFn, factory) {
 			const actualFactory = factory ?? useFn._factory;
 			const token = useFn._token;
-			if (!actualFactory || !token) throw new Error("defineProvide must be called with a function created by defineInjectable");
+			if (!actualFactory || !token) throw provideInvalidInjectableError();
 			const instance = actualFactory();
 			context.provides.set(token, instance);
 			return instance;
@@ -777,7 +832,7 @@ function defineApp(rootComponent) {
 				return app;
 			}
 			const mountFn = renderFn ?? defaultMountFn;
-			if (!mountFn) throw new Error("No mount function provided and no default mount function set. Either pass a mount function to app.mount(), or import a platform package (e.g., @sigx/runtime-dom or @sigx/runtime-terminal) that sets the default.");
+			if (!mountFn) throw noMountFunctionError();
 			container = target;
 			isMounted = true;
 			const result = mountFn(rootComponent, target, context);
@@ -903,10 +958,60 @@ function isComponent(type) {
 }
 const Fragment = Symbol.for("sigx.Fragment");
 const Text = Symbol.for("sigx.Text");
+const Comment = Symbol.for("sigx.Comment");
 function normalizeChildren(children) {
 	if (children == null || children === false || children === true) return [];
 	if (isComputed(children)) return normalizeChildren(children.value);
-	if (Array.isArray(children)) return children.flatMap((c) => normalizeChildren(c));
+	if (Array.isArray(children)) return children.map((c) => {
+		if (c == null || c === false || c === true) return {
+			type: Comment,
+			props: {},
+			key: null,
+			children: [],
+			dom: null
+		};
+		if (isComputed(c)) return normalizeChildren(c.value)[0] ?? {
+			type: Comment,
+			props: {},
+			key: null,
+			children: [],
+			dom: null
+		};
+		if (typeof c === "string" || typeof c === "number") return {
+			type: Text,
+			props: {},
+			key: null,
+			children: [],
+			dom: null,
+			text: c
+		};
+		if (Array.isArray(c)) {
+			const nested = normalizeChildren(c);
+			if (nested.length === 0) return {
+				type: Comment,
+				props: {},
+				key: null,
+				children: [],
+				dom: null
+			};
+			if (nested.length === 1) return nested[0];
+			return {
+				type: Fragment,
+				props: {},
+				key: null,
+				children: nested,
+				dom: null
+			};
+		}
+		if (c.type) return c;
+		return {
+			type: Comment,
+			props: {},
+			key: null,
+			children: [],
+			dom: null
+		};
+	});
 	if (typeof children === "string" || typeof children === "number") return [{
 		type: Text,
 		props: {},
@@ -1045,6 +1150,22 @@ function lazy(loader) {
 			state,
 			tick: 0
 		});
+		function renderInner(Comp) {
+			const fwdProps = { ...ctx.props };
+			const defaultContent = ctx.slots.default();
+			if (defaultContent.length > 0) fwdProps.children = defaultContent;
+			const slotsFromProps = ctx.slots._slotsFromProps;
+			if (slotsFromProps) {
+				const namedSlots = {};
+				let hasNamed = false;
+				for (const key of Object.keys(slotsFromProps)) {
+					namedSlots[key] = slotsFromProps[key];
+					hasNamed = true;
+				}
+				if (hasNamed) fwdProps.slots = namedSlots;
+			}
+			return jsx(Comp, fwdProps);
+		}
 		if (!promise) promise = loader().then((mod) => {
 			Component = "default" in mod ? mod.default : mod;
 			state = "resolved";
@@ -1073,15 +1194,13 @@ function lazy(loader) {
 				loadState.tick++;
 			});
 		});
-		if (state === "resolved" && Component) return () => {
-			return jsx(Component, {});
-		};
+		if (state === "resolved" && Component) return () => renderInner(Component);
 		if (state === "rejected" && error) throw error;
 		if (!registerPendingPromise(promise)) promise.catch(() => {});
 		return () => {
 			const currentState = loadState.state;
 			loadState.tick;
-			if (currentState === "resolved" && Component) return jsx(Component, {});
+			if (currentState === "resolved" && Component) return renderInner(Component);
 			if (currentState === "rejected" && error) throw error;
 			return null;
 		};
@@ -1157,6 +1276,25 @@ const Suspense = component((ctx) => {
 function isLazyComponent(component) {
 	return component && component.__lazy === true;
 }
+function useAsync(loader) {
+	const state = signal({
+		value: null,
+		loading: true,
+		error: null
+	});
+	loader().then((val) => {
+		batch(() => {
+			state.value = val;
+			state.loading = false;
+		});
+	}).catch((err) => {
+		batch(() => {
+			state.error = err instanceof Error ? err : new Error(String(err));
+			state.loading = false;
+		});
+	});
+	return state;
+}
 const ErrorBoundary = component((ctx) => {
 	const { fallback } = ctx.props;
 	const { slots } = ctx;
@@ -1256,7 +1394,7 @@ function defineFactory(setup, _lifetime, _typeIdentifier) {
 		const dispose = () => {
 			deactivations.forEach((d) => d());
 			subscriptions.unsubscribe();
-			result.dispose?.();
+			if (result && typeof result === "object" && "dispose" in result && typeof result.dispose === "function") result.dispose();
 		};
 		if (customDispose) customDispose(dispose);
 		else try {
@@ -1487,6 +1625,12 @@ function createRenderer(options) {
 			hostInsert(node, container, before);
 			return;
 		}
+		if (vnode.type === Comment) {
+			const node = hostCreateComment("");
+			vnode.dom = node;
+			hostInsert(node, container, before);
+			return;
+		}
 		if (vnode.type === Fragment) {
 			const anchor = hostCreateComment("");
 			vnode.dom = anchor;
@@ -1539,6 +1683,10 @@ function createRenderer(options) {
 			if (vnode.dom) hostRemove(vnode.dom);
 			return;
 		}
+		if (vnode.type === Comment) {
+			if (vnode.dom) hostRemove(vnode.dom);
+			return;
+		}
 		if (vnode.props?.ref) untrack(() => {
 			if (typeof vnode.props.ref === "function") vnode.props.ref(null);
 			else if (vnode.props.ref && typeof vnode.props.ref === "object") vnode.props.ref.current = null;
@@ -1618,6 +1766,10 @@ function createRenderer(options) {
 			if (oldVNode.text !== newVNode.text) hostSetText(newVNode.dom, String(newVNode.text));
 			return;
 		}
+		if (newVNode.type === Comment) {
+			newVNode.dom = oldVNode.dom;
+			return;
+		}
 		if (newVNode.type === Fragment) {
 			patchChildren(oldVNode, newVNode, container, false);
 			return;
@@ -1798,7 +1950,7 @@ function createRenderer(options) {
 		let renderFn;
 		try {
 			const setupResult = setup(ctx);
-			if (setupResult && typeof setupResult.then === "function") throw new Error(`Async setup in component "${componentName}" is only supported during SSR. On the client, use pre-loaded data from hydration or fetch in onMounted.`);
+			if (setupResult && typeof setupResult.then === "function") throw asyncSetupClientError(componentName ?? "anonymous");
 			renderFn = setupResult;
 			notifyComponentCreated(currentAppContext, componentInstance);
 			createdHooks.forEach((hook) => hook());
@@ -1853,7 +2005,7 @@ function createRenderer(options) {
 			};
 		}
 		const mountCtx = { el: container };
-		mountHooks.forEach((hook) => hook(mountCtx));
+		untrack(() => mountHooks.forEach((hook) => hook(mountCtx)));
 		notifyComponentMounted(currentAppContext, componentInstance);
 		vnode.cleanup = () => {
 			notifyComponentUnmounted(currentAppContext, componentInstance);
@@ -2425,6 +2577,6 @@ const terminalMount = (component, options, appContext) => {
 	};
 };
 setDefaultMount(terminalMount);
-export { Button, CLIENT_DIRECTIVES, CLIENT_DIRECTIVE_PREFIX, Checkbox, ComputedSymbol, ErrorBoundary, Fragment, Input, InstanceLifetimes, ProgressBar, Select, SubscriptionHandler, Suspense, Text, Utils, batch, component, compound, computed, createModel, createModelFromBinding, createTopic, defineApp, defineDirective, defineFactory, defineInjectable, defineProvide, detectAccess, effect, effectScope, exitTerminal, focus, focusNext, focusPrev, focusState, getComponentMeta, getCurrentInstance, guid, isComponent, isComputed, isDirective, isLazyComponent, isModel, isReactive, jsx, jsxDEV, jsxs, lazy, mountTerminal, onCreated, onKey, onMounted, onUnmounted, onUpdated, registerFocusable, render, renderNodeToLines, renderTerminal, signal, terminalMount, toRaw, toSubscriber, unregisterFocusable, untrack, useAppContext, watch };
+export { Button, CLIENT_DIRECTIVES, CLIENT_DIRECTIVE_PREFIX, Checkbox, Comment, ComputedSymbol, ErrorBoundary, Fragment, Input, InstanceLifetimes, ProgressBar, Select, SigxError, SigxErrorCode, SubscriptionHandler, Suspense, Text, Utils, asyncSetupClientError, batch, component, compound, computed, createModel, createModelFromBinding, createTopic, defineApp, defineDirective, defineFactory, defineInjectable, defineProvide, detectAccess, effect, effectScope, exitTerminal, focus, focusNext, focusPrev, focusState, getComponentMeta, getCurrentInstance, guid, isComponent, isComputed, isDirective, isLazyComponent, isModel, isReactive, jsx, jsxDEV, jsxs, lazy, mountTargetNotFoundError, mountTerminal, noMountFunctionError, onCreated, onKey, onMounted, onUnmounted, onUpdated, provideInvalidInjectableError, provideOutsideSetupError, registerFocusable, render, renderNodeToLines, renderTargetNotFoundError, renderTerminal, signal, terminalMount, toRaw, toSubscriber, unregisterFocusable, untrack, useAppContext, useAsync, watch };
 
 //# sourceMappingURL=index.js.map