@askrjs/askr 0.0.38 → 0.0.40

package/dist/common/router.d.ts

@@ -1,14 +1,23 @@
+import { RenderableChild } from "./vnode.js";
+
 //#region src/common/router.d.ts
 /**
  * Common call contracts: Router types
  */
+type RouteParams = Record<string, string>;
+type StripRoutePathSuffix<Path extends string> = Path extends `${infer Base}?${string}` ? StripRoutePathSuffix<Base> : Path extends `${infer Base}#${string}` ? StripRoutePathSuffix<Base> : Path;
+type TrimRoutePathSlashes<Path extends string> = Path extends `/${infer Rest}` ? TrimRoutePathSlashes<Rest> : Path extends `${infer Rest}/` ? TrimRoutePathSlashes<Rest> : Path;
+type ExtractRouteSegmentParam<Segment extends string> = Segment extends `{${infer Param}}` ? Param : Segment extends '*' ? '*' : never;
+type ExtractRoutePathParamNames<Path extends string> = TrimRoutePathSlashes<StripRoutePathSuffix<Path>> extends `${infer Segment}/${infer Rest}` ? ExtractRouteSegmentParam<Segment> | ExtractRoutePathParamNames<Rest> : ExtractRouteSegmentParam<TrimRoutePathSlashes<StripRoutePathSuffix<Path>>>;
+type RoutePathParams<Path extends string> = [ExtractRoutePathParamNames<Path>] extends [never] ? Record<never, string> : { [Key in ExtractRoutePathParamNames<Path>]: string };
 /**
  * A route page component: a regular component that receives route params as
- * props (always `Record<string, string>` derived from the URL pattern).
+ * props derived from the URL pattern.
  *
- * Components may accept no params at all — `() => unknown` is assignable.
+ * Components may accept no params at all — zero-argument components are still
+ * assignable.
  */
-type RouteComponent = (props: Record<string, string>) => unknown;
+type RouteComponent<TParams extends RouteParams = RouteParams> = (props: TParams) => RenderableChild;
 type RouteMode = 'spa' | 'ssr' | 'ssg';
 type RouteAuthMode = true | 'guest';
 type AccessRedirectStatus = 301 | 302 | 303 | 307 | 308;
@@ -27,9 +36,9 @@ interface AccessDenyDecision {
   status: AccessDenyStatus;
 }
 type AccessDecision = AccessAllowDecision | AccessRedirectDecision | AccessDenyDecision;
-interface RouteContext<Session = unknown, User = unknown> {
+interface RouteContext<Session = unknown, User = unknown, TParams extends RouteParams = RouteParams> {
   mode: RouteMode;
-  params: Record<string, string>;
+  params: TParams;
   pathname: string;
   search: string;
   hash: string;
@@ -38,18 +47,18 @@ interface RouteContext<Session = unknown, User = unknown> {
   user: User | null;
   signal: AbortSignal;
 }
-type RoutePolicy = (context: RouteContext) => AccessDecision | Promise<AccessDecision>;
+type RoutePolicy = (context: RouteContext) => AccessDecision | PromiseLike<AccessDecision>;
 interface RouteAuthState<Session = unknown, User = unknown> {
   session: Session | null;
   user: User | null;
 }
-type RouteAuthResolver<Session = unknown, User = unknown> = (context: Omit<RouteContext<Session, User>, 'session' | 'user'>) => RouteAuthState<Session, User> | Promise<RouteAuthState<Session, User>>;
+type RouteAuthResolver<Session = unknown, User = unknown> = (context: Omit<RouteContext<Session, User>, 'session' | 'user'>) => RouteAuthState<Session, User> | PromiseLike<RouteAuthState<Session, User>>;
 interface RouteAuthOptions<Session = unknown, User = unknown> {
   resolve: RouteAuthResolver<Session, User>;
-  loginPath?: string | ((context: RouteContext<Session, User>) => string | Promise<string>);
-  guestRedirectTo?: string | ((context: RouteContext<Session, User>) => string | Promise<string>);
-  hasRole?: (user: User, role: string, context: RouteContext<Session, User>) => boolean | Promise<boolean>;
-  hasPermission?: (user: User, permission: string, context: RouteContext<Session, User>) => boolean | Promise<boolean>;
+  loginPath?: string | ((context: RouteContext<Session, User>) => string | PromiseLike<string>);
+  guestRedirectTo?: string | ((context: RouteContext<Session, User>) => string | PromiseLike<string>);
+  hasRole?: (user: User, role: string, context: RouteContext<Session, User>) => boolean | PromiseLike<boolean>;
+  hasPermission?: (user: User, permission: string, context: RouteContext<Session, User>) => boolean | PromiseLike<boolean>;
 }
 interface CommonAccessOptions {
   auth?: RouteAuthMode;
@@ -65,11 +74,11 @@ interface CommonAccessOptions {
  * - `title`: page title hint used by SSG and document-meta integrations
  * - `namespace`: MFE namespace key for grouped route management
  */
-interface RouteOptions extends CommonAccessOptions {
+interface RouteOptions<TParams extends RouteParams = RouteParams> extends CommonAccessOptions {
   loader?: (context: {
-    params: Record<string, string>;
+    params: TParams;
   }) => unknown;
-  entries?: () => Array<Record<string, string>> | Promise<Array<Record<string, string>>>;
+  entries?: () => Array<TParams> | Promise<Array<TParams>>;
   title?: string;
   namespace?: string;
 }
@@ -90,8 +99,8 @@ interface ParsedSegment {
 /** Resolved layout component as stored in a route record's layout chain. */
 interface LayoutScopeRecord {
   component: (props: {
-    children?: unknown;
-  }) => unknown;
+    children?: RenderableChild;
+  }) => RenderableChild;
 }
 /** Resolved page host component as stored in a route record's page chain. */
 interface PageScopeRecord {
@@ -107,16 +116,16 @@ interface RouteRequestOptions {
   auth?: RouteAuthOptions;
   signal?: AbortSignal;
 }
-interface RouteRenderResult {
+interface RouteRenderResult<TParams extends RouteParams = RouteParams> {
   kind: 'render';
-  handler: RouteHandler;
-  params: Record<string, string>;
+  handler: RouteHandler<TParams>;
+  params: TParams;
 }
-type RouteRequestResult = RouteRenderResult | AccessRedirectDecision | AccessDenyDecision | null;
+type RouteRequestResult<TParams extends RouteParams = RouteParams> = RouteRenderResult<TParams> | AccessRedirectDecision | AccessDenyDecision | null;
 interface GroupHelperOptions extends CommonAccessOptions {
   layout?: (props: {
-    children?: unknown;
-  }) => unknown;
+    children?: RenderableChild;
+  }) => RenderableChild;
 }
 /**
  * A fully normalized route record produced by `route(path, Component, options?)`.
@@ -164,23 +173,23 @@ interface RouteManifest {
   records: RouteRecord[];
   auth?: RouteAuthOptions;
 }
-interface RouteHandler {
-  (params: Record<string, string>, context?: {
+interface RouteHandler<TParams extends RouteParams = RouteParams> {
+  (params: TParams, context?: {
     signal: AbortSignal;
-  }): unknown;
+  }): RenderableChild;
 }
-interface Route {
+interface Route<TParams extends RouteParams = RouteParams> {
   path: string;
-  handler: RouteHandler;
+  handler: RouteHandler<TParams>;
   namespace?: string;
 }
-interface ResolvedRoute {
-  handler: RouteHandler;
-  params: Record<string, string>;
+interface ResolvedRoute<TParams extends RouteParams = RouteParams> {
+  handler: RouteHandler<TParams>;
+  params: TParams;
 }
-interface RouteMatch {
+interface RouteMatch<TParams extends RouteParams = RouteParams> {
   path: string;
-  params: Readonly<Record<string, string>>;
+  params: Readonly<TParams>;
   name?: string;
   namespace?: string;
 }
@@ -190,15 +199,15 @@ interface RouteQuery {
   has(key: string): boolean;
   toJSON(): Record<string, string | string[]>;
 }
-interface RouteSnapshot {
+interface RouteSnapshot<TParams extends RouteParams = RouteParams> {
   path: string;
-  params: Readonly<Record<string, string>>;
+  params: Readonly<TParams>;
   query: Readonly<RouteQuery>;
   hash: string | null;
   name?: string;
   namespace?: string;
-  matches: readonly RouteMatch[];
+  matches: readonly RouteMatch<TParams>[];
 }
 //#endregion
-export { AccessDecision, AccessDenyDecision, AccessDenyStatus, AccessRedirectDecision, AccessRedirectStatus, GroupHelperOptions, LayoutScopeRecord, PageHelperOptions, PageScopeRecord, ParsedSegment, RegisterRoutesOptions, ResolvedRoute, Route, RouteAuthMode, RouteAuthOptions, RouteAuthResolver, RouteAuthState, RouteComponent, RouteContext, RouteDefinition, RouteHandler, RouteManifest, RouteMatch, RouteMode, RouteOptions, RoutePolicy, RouteQuery, RouteRecord, RouteRenderResult, RouteRequestOptions, RouteRequestResult, RouteSnapshot };
+export { AccessAllowDecision, AccessDecision, AccessDenyDecision, AccessDenyStatus, AccessRedirectDecision, AccessRedirectStatus, GroupHelperOptions, LayoutScopeRecord, PageHelperOptions, PageScopeRecord, ParsedSegment, RegisterRoutesOptions, ResolvedRoute, Route, RouteAuthMode, RouteAuthOptions, RouteAuthResolver, RouteAuthState, RouteComponent, RouteContext, RouteDefinition, RouteHandler, RouteManifest, RouteMatch, RouteMode, RouteOptions, RouteParams, RoutePathParams, RoutePolicy, RouteQuery, RouteRecord, RouteRenderResult, RouteRequestOptions, RouteRequestResult, RouteSnapshot };
 //# sourceMappingURL=router.d.ts.map

package/dist/common/router.d.ts.map

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

package/dist/common/ssr-errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ssr-errors.d.ts","names":[],"sources":["../../src/common/ssr-errors.ts"],"mappings":";;AAIA;;cAAa,mBAAA,SAA4B,KAAA;EAAA,SAC9B,IAAA;cAEP,OAAA;AAAA"}
+{"version":3,"file":"ssr-errors.d.ts","names":[],"sources":["../../src/common/ssr-errors.ts"],"mappings":";;AAIA;;cAAa,mBAAA,SAA4B,KAAK;EAAA,SACnC,IAAA;cAEP,OAAA;AAAA"}

package/dist/common/ssr-errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"ssr-errors.js","names":[],"sources":["../../src/common/ssr-errors.ts"],"sourcesContent":["/**\n * Common call contracts: SSR error types\n */\n\nexport class SSRDataMissingError extends Error {\n  readonly code = 'SSR_DATA_MISSING';\n  constructor(\n    message = 'Server-side rendering requires all data to be available synchronously. This component attempted to use async data during SSR.'\n  ) {\n    super(message);\n    this.name = 'SSRDataMissingError';\n    Object.setPrototypeOf(this, SSRDataMissingError.prototype);\n  }\n}\n"],"mappings":";;;;AAIA,IAAa,sBAAb,MAAa,4BAA4B,MAAM;CAE7C,YACE,UAAU,iIACV;EACA,MAAM,QAAQ;cAJA;EAKd,KAAK,OAAO;EACZ,OAAO,eAAe,MAAM,oBAAoB,UAAU"}
+{"version":3,"file":"ssr-errors.js","names":[],"sources":["../../src/common/ssr-errors.ts"],"sourcesContent":["/**\n * Common call contracts: SSR error types\n */\n\nexport class SSRDataMissingError extends Error {\n  readonly code = 'SSR_DATA_MISSING';\n  constructor(\n    message = 'Server-side rendering requires all data to be available synchronously. This component attempted to use async data during SSR.'\n  ) {\n    super(message);\n    this.name = 'SSRDataMissingError';\n    Object.setPrototypeOf(this, SSRDataMissingError.prototype);\n  }\n}\n"],"mappings":";;;;AAIA,IAAa,sBAAb,MAAa,4BAA4B,MAAM;CAE7C,YACE,UAAU,iIACV;EACA,MAAM,OAAO;cAJC;EAKd,KAAK,OAAO;EACZ,OAAO,eAAe,MAAM,oBAAoB,SAAS;CAC3D;AACF"}

package/dist/common/ssr.d.ts

@@ -3,6 +3,7 @@
  * Common call contracts: SSR types
  */
 type SSRData = Record<string, unknown>;
+declare const SSR_RENDER_DATA_ATTR = "data-askr-render-data";
 /** Full context for sink-based streaming SSR */
 type SSRContext = {
   url: string;

package/dist/common/ssr.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ssr.d.ts","names":[],"sources":["../../src/common/ssr.ts"],"mappings":";;AAIA;;KAAY,OAAA,GAAU,MAAA;;KAGV,UAAA;EACV,GAAA;EACA,IAAA;EACA,IAAA,GAAO,OAAA;EACP,MAAA,GAAS,MAAA;EACT,MAAA,GAAS,WAAA;AAAA;;KAIC,aAAA;EACV,IAAA;AAAA"}
+{"version":3,"file":"ssr.d.ts","names":[],"sources":["../../src/common/ssr.ts"],"mappings":";;AAIA;;KAAY,OAAA,GAAU,MAAM;AAAA,cAEf,oBAAA;AAFe;AAAA,KAKhB,UAAA;EACV,GAAA;EACA,IAAA;EACA,IAAA,GAAO,OAAA;EACP,MAAA,GAAS,MAAA;EACT,MAAA,GAAS,WAAA;AAAA;;KAIC,aAAA;EACV,IAAI;AAAA"}

package/dist/common/ssr.js

@@ -0,0 +1,6 @@
+//#region src/common/ssr.ts
+const SSR_RENDER_DATA_ATTR = "data-askr-render-data";
+//#endregion
+export { SSR_RENDER_DATA_ATTR };
+
+//# sourceMappingURL=ssr.js.map

package/dist/common/ssr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssr.js","names":[],"sources":["../../src/common/ssr.ts"],"sourcesContent":["/**\n * Common call contracts: SSR types\n */\n\nexport type SSRData = Record<string, unknown>;\n\nexport const SSR_RENDER_DATA_ATTR = 'data-askr-render-data';\n\n/** Full context for sink-based streaming SSR */\nexport type SSRContext = {\n  url: string;\n  seed: number;\n  data?: SSRData;\n  params?: Record<string, string>;\n  signal?: AbortSignal;\n};\n\n/** Lightweight context for synchronous render passes */\nexport type RenderContext = {\n  seed: number;\n};\n"],"mappings":";AAMA,MAAa,uBAAuB"}

package/dist/common/vnode.d.ts

@@ -13,8 +13,9 @@ interface DOMElement {
   _forState?: ForState<unknown>;
 }
 type VNode = DOMElement | string | number | boolean | null | undefined;
+type RenderableChild = VNode | readonly VNode[];
 declare const __FOR_BOUNDARY__: symbol;
 declare function _isDOMElement(node: unknown): node is DOMElement;
 //#endregion
-export { VNode };
+export { RenderableChild, VNode };
 //# sourceMappingURL=vnode.d.ts.map

package/dist/common/vnode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vnode.d.ts","names":[],"sources":["../../src/common/vnode.ts"],"mappings":";;;;cAUa,kBAAA;AAAA,UAEI,UAAA;EAKf,IAAA,aAAiB,KAAA,EAAO,KAAA;EACxB,KAAA,GAAQ,KAAA;EACR,QAAA,GAAW,KAAA;EACX,GAAA;EAAA,CACC,MAAA,CAAO,QAAA;EACR,aAAA,GAAgB,oBAAA;EAChB,SAAA,GAAY,QAAA;AAAA;AAAA,KAIF,KAAA,GAAQ,UAAA;AAAA,cAIP,gBAAA;AAAA,iBAEG,aAAA,CAAc,IAAA,YAAgB,IAAA,IAAQ,UAAA"}
+{"version":3,"file":"vnode.d.ts","names":[],"sources":["../../src/common/vnode.ts"],"mappings":";;;;cAUa,kBAAA;AAAA,UAEI,UAAA;EAKf,IAAA,aAAiB,KAAA,EAAO,KAAA;EACxB,KAAA,GAAQ,KAAA;EACR,QAAA,GAAW,KAAA;EACX,GAAA;EAAA,CACC,MAAA,CAAO,QAAA;EACR,aAAA,GAAgB,oBAAA;EAChB,SAAA,GAAY,QAAA;AAAA;AAAA,KAIF,KAAA,GAAQ,UAAU;AAAA,KAClB,eAAA,GAAkB,KAAA,YAAiB,KAAK;AAAA,cAIvC,gBAAA;AAAA,iBAEG,aAAA,CAAc,IAAA,YAAgB,IAAA,IAAQ,UAAU"}

package/dist/common/vnode.js.map

@@ -1 +1 @@
-{"version":3,"file":"vnode.js","names":[],"sources":["../../src/common/vnode.ts"],"sourcesContent":["/**\n * Common call contracts: VNode / virtual DOM shapes\n */\n\nimport type { Props } from './props';\nimport type { ControlBoundaryState } from '../runtime/control';\nimport type { ForState } from '../runtime/for';\nexport { __CONTROL_BOUNDARY__ } from './control';\nimport { __CONTROL_BOUNDARY__ } from './control';\n\nexport const __ERROR_BOUNDARY__ = Symbol.for('askr.error-boundary');\n\nexport interface DOMElement {\n  // Element `type` can be an intrinsic tag name, a component function, or\n  // a special symbol (e.g. `Fragment`). Include `symbol` in the type union\n  // so runtime comparisons against `Fragment` are type-safe.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  type: string | ((props: Props) => any) | symbol;\n  props?: Props;\n  children?: VNode[];\n  key?: string | number | null;\n  [Symbol.iterator]?: never;\n  _controlState?: ControlBoundaryState; // Internal: control boundary state\n  _forState?: ForState<unknown>; // Deprecated internal alias during migration\n}\n\n// Type for virtual DOM nodes\nexport type VNode = DOMElement | string | number | boolean | null | undefined;\n\n// Backward-compatible internal alias while renderer/runtime migrates away from\n// the old For-only boundary naming.\nexport const __FOR_BOUNDARY__ = __CONTROL_BOUNDARY__;\n\nexport function _isDOMElement(node: unknown): node is DOMElement {\n  return typeof node === 'object' && node !== null && 'type' in node;\n}\n"],"mappings":";;AAUA,MAAa,qBAAqB,OAAO,IAAI,sBAAsB;AAqBnE,MAAa,mBAAmB;AAEhC,SAAgB,cAAc,MAAmC;CAC/D,OAAO,OAAO,SAAS,YAAY,SAAS,QAAQ,UAAU"}
+{"version":3,"file":"vnode.js","names":[],"sources":["../../src/common/vnode.ts"],"sourcesContent":["/**\n * Common call contracts: VNode / virtual DOM shapes\n */\n\nimport type { Props } from './props';\nimport type { ControlBoundaryState } from '../runtime/control';\nimport type { ForState } from '../runtime/for';\nexport { __CONTROL_BOUNDARY__ } from './control';\nimport { __CONTROL_BOUNDARY__ } from './control';\n\nexport const __ERROR_BOUNDARY__ = Symbol.for('askr.error-boundary');\n\nexport interface DOMElement {\n  // Element `type` can be an intrinsic tag name, a component function, or\n  // a special symbol (e.g. `Fragment`). Include `symbol` in the type union\n  // so runtime comparisons against `Fragment` are type-safe.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  type: string | ((props: Props) => any) | symbol;\n  props?: Props;\n  children?: VNode[];\n  key?: string | number | null;\n  [Symbol.iterator]?: never;\n  _controlState?: ControlBoundaryState; // Internal: control boundary state\n  _forState?: ForState<unknown>; // Deprecated internal alias during migration\n}\n\n// Type for virtual DOM nodes\nexport type VNode = DOMElement | string | number | boolean | null | undefined;\nexport type RenderableChild = VNode | readonly VNode[];\n\n// Backward-compatible internal alias while renderer/runtime migrates away from\n// the old For-only boundary naming.\nexport const __FOR_BOUNDARY__ = __CONTROL_BOUNDARY__;\n\nexport function _isDOMElement(node: unknown): node is DOMElement {\n  return typeof node === 'object' && node !== null && 'type' in node;\n}\n"],"mappings":";;AAUA,MAAa,qBAAqB,OAAO,IAAI,qBAAqB;AAsBlE,MAAa,mBAAmB;AAEhC,SAAgB,cAAc,MAAmC;CAC/D,OAAO,OAAO,SAAS,YAAY,SAAS,QAAQ,UAAU;AAChE"}

package/dist/components/error-boundary.d.ts

@@ -1,12 +1,15 @@
 import { Props } from "../common/props.js";
 import { JSXElement } from "../common/jsx.js";
 import { ComponentInstance } from "../runtime/component.js";
+import { VNode } from "../common/vnode.js";
 
 //#region src/components/error-boundary.d.ts
-type ErrorBoundaryFallbackRender = (error: unknown, reset: () => void) => unknown;
+type ErrorBoundaryContent = VNode | readonly VNode[];
+type ErrorBoundaryFallbackValue = ErrorBoundaryContent | Node;
+type ErrorBoundaryFallbackRender = (error: unknown, reset: () => void) => ErrorBoundaryFallbackValue;
 interface ErrorBoundaryProps extends Props {
-  children?: unknown;
-  fallback?: unknown | ErrorBoundaryFallbackRender;
+  children?: ErrorBoundaryContent;
+  fallback?: ErrorBoundaryFallbackValue | ErrorBoundaryFallbackRender;
   onError?: (error: unknown) => void;
   resetKey?: unknown;
 }
@@ -17,7 +20,7 @@ type ErrorBoundaryVNode = JSXElement & {
 declare function ErrorBoundary(props: ErrorBoundaryProps): JSXElement;
 declare function isErrorBoundaryVNode(value: unknown): value is ErrorBoundaryVNode;
 declare function resolveErrorBoundaryState(vnode: ErrorBoundaryVNode): ErrorBoundaryState | null;
-declare function resolveErrorBoundaryFallback(fallback: ErrorBoundaryProps['fallback'], error: unknown, reset: () => void): unknown;
+declare function resolveErrorBoundaryFallback(fallback: ErrorBoundaryProps['fallback'], error: unknown, reset: () => void): ErrorBoundaryFallbackValue;
 declare function createBoundaryReset(instance: ComponentInstance): () => void;
 declare function reportBoundaryError(instance: ComponentInstance, error: unknown, onError?: (error: unknown) => void): void;
 //#endregion

package/dist/components/error-boundary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-boundary.d.ts","names":[],"sources":["../../src/components/error-boundary.tsx"],"mappings":";;;;;KAUY,2BAAA,IACV,KAAA,WACA,KAAA;AAAA,UAGe,kBAAA,SAA2B,KAAA;EAC1C,QAAA;EACA,QAAA,aAAqB,2BAAA;EACrB,OAAA,IAAW,KAAA;EACX,QAAA;AAAA;AAAA,KAGG,kBAAA,GAAqB,WAAA,CAAY,iBAAA;AAAA,KAEjC,kBAAA,GAAqB,UAAA;EACxB,UAAA,GAAa,iBAAA;AAAA;AAAA,iBA+DC,aAAA,CAAc,KAAA,EAAO,kBAAA,GAAqB,UAAA;AAAA,iBAY1C,oBAAA,CACd,KAAA,YACC,KAAA,IAAS,kBAAA;AAAA,iBAQI,yBAAA,CACd,KAAA,EAAO,kBAAA,GACN,kBAAA;AAAA,iBAIa,4BAAA,CACd,QAAA,EAAU,kBAAA,cACV,KAAA,WACA,KAAA;AAAA,iBAoDc,mBAAA,CAAoB,QAAA,EAAU,iBAAA;AAAA,iBAc9B,mBAAA,CACd,QAAA,EAAU,iBAAA,EACV,KAAA,WACA,OAAA,IAAW,KAAA"}
+{"version":3,"file":"error-boundary.d.ts","names":[],"sources":["../../src/components/error-boundary.tsx"],"mappings":";;;;;;KAWK,oBAAA,GAAuB,KAAA,YAAiB,KAAK;AAAA,KAC7C,0BAAA,GAA6B,oBAAA,GAAuB,IAAI;AAAA,KAEjD,2BAAA,IACV,KAAA,WACA,KAAA,iBACG,0BAA0B;AAAA,UAEd,kBAAA,SAA2B,KAAA;EAC1C,QAAA,GAAW,oBAAA;EACX,QAAA,GAAW,0BAAA,GAA6B,2BAAA;EACxC,OAAA,IAAW,KAAA;EACX,QAAA;AAAA;AAAA,KAGG,kBAAA,GAAqB,WAAW,CAAC,iBAAA;AAAA,KAEjC,kBAAA,GAAqB,UAAA;EACxB,UAAA,GAAa,iBAAiB;AAAA;AAAA,iBA+DhB,aAAA,CAAc,KAAA,EAAO,kBAAA,GAAqB,UAAU;AAAA,iBAYpD,oBAAA,CACd,KAAA,YACC,KAAA,IAAS,kBAAkB;AAAA,iBAQd,yBAAA,CACd,KAAA,EAAO,kBAAA,GACN,kBAAkB;AAAA,iBAIL,4BAAA,CACd,QAAA,EAAU,kBAAA,cACV,KAAA,WACA,KAAA,eACC,0BAA0B;AAAA,iBAmDb,mBAAA,CAAoB,QAA2B,EAAjB,iBAAiB;AAAA,iBAc/C,mBAAA,CACd,QAAA,EAAU,iBAAiB,EAC3B,KAAA,WACA,OAAA,IAAW,KAAA"}

package/dist/components/error-boundary.js.map

@@ -1 +1 @@
-{"version":3,"file":"error-boundary.js","names":[],"sources":["../../src/components/error-boundary.tsx"],"sourcesContent":["import type { Props } from '../common/props';\nimport { ELEMENT_TYPE, type JSXElement } from '../common/jsx';\nimport { __ERROR_BOUNDARY__ } from '../common/vnode';\nimport {\n  getCurrentComponentInstance,\n  type ComponentInstance,\n} from '../runtime/component';\nimport { logger } from '../dev/logger';\nimport { isDevelopmentEnvironment } from '../common/env';\n\nexport type ErrorBoundaryFallbackRender = (\n  error: unknown,\n  reset: () => void\n) => unknown;\n\nexport interface ErrorBoundaryProps extends Props {\n  children?: unknown;\n  fallback?: unknown | ErrorBoundaryFallbackRender;\n  onError?: (error: unknown) => void;\n  resetKey?: unknown;\n}\n\ntype ErrorBoundaryState = NonNullable<ComponentInstance['errorBoundaryState']>;\n\ntype ErrorBoundaryVNode = JSXElement & {\n  __instance?: ComponentInstance;\n};\n\nfunction getBoundaryMessage(error: unknown): string {\n  if (error instanceof Error) {\n    return error.message || error.name || 'Unknown error';\n  }\n\n  if (typeof error === 'string') {\n    return error;\n  }\n\n  try {\n    return JSON.stringify(error);\n  } catch {\n    return String(error);\n  }\n}\n\nfunction ensureBoundaryState(\n  instance: ComponentInstance,\n  resetKey: unknown\n): ErrorBoundaryState {\n  const boundaryState =\n    instance.errorBoundaryState ??\n    (instance.errorBoundaryState = {\n      error: null,\n      resetKey,\n      notified: false,\n    });\n\n  if (!Object.is(boundaryState.resetKey, resetKey)) {\n    boundaryState.error = null;\n    boundaryState.resetKey = resetKey;\n    boundaryState.notified = false;\n  }\n\n  return boundaryState;\n}\n\nfunction createBoundaryVNode(\n  instance: ComponentInstance,\n  props: ErrorBoundaryProps\n): ErrorBoundaryVNode {\n  const key =\n    typeof props.key === 'symbol'\n      ? null\n      : ((props.key ?? null) as string | number | null);\n\n  return {\n    $$typeof: ELEMENT_TYPE,\n    type: __ERROR_BOUNDARY__,\n    props: {\n      children: props.children,\n      fallback: props.fallback,\n      onError: props.onError,\n      resetKey: props.resetKey,\n    },\n    key,\n    __instance: instance,\n  };\n}\n\nexport function ErrorBoundary(props: ErrorBoundaryProps): JSXElement {\n  const instance = getCurrentComponentInstance();\n  if (!instance) {\n    throw new Error(\n      '[Askr] ErrorBoundary() can only be used during component render execution.'\n    );\n  }\n\n  ensureBoundaryState(instance, props.resetKey);\n  return createBoundaryVNode(instance, props);\n}\n\nexport function isErrorBoundaryVNode(\n  value: unknown\n): value is ErrorBoundaryVNode {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    (value as ErrorBoundaryVNode).type === __ERROR_BOUNDARY__\n  );\n}\n\nexport function resolveErrorBoundaryState(\n  vnode: ErrorBoundaryVNode\n): ErrorBoundaryState | null {\n  return vnode.__instance?.errorBoundaryState ?? null;\n}\n\nexport function resolveErrorBoundaryFallback(\n  fallback: ErrorBoundaryProps['fallback'],\n  error: unknown,\n  reset: () => void\n): unknown {\n  if (typeof fallback === 'function') {\n    return fallback(error, reset);\n  }\n\n  if (fallback !== undefined) {\n    return fallback;\n  }\n\n  const message = getBoundaryMessage(error);\n  const wrapper = document.createElement('div');\n  wrapper.setAttribute('role', 'alert');\n  wrapper.setAttribute('data-askr-error-boundary', 'true');\n  wrapper.style.boxSizing = 'border-box';\n  wrapper.style.padding = '1rem';\n  wrapper.style.border = '1px solid currentColor';\n  wrapper.style.borderRadius = '0.75rem';\n  wrapper.style.display = 'grid';\n  wrapper.style.gap = '0.75rem';\n  wrapper.style.maxWidth = '100%';\n\n  const title = document.createElement('strong');\n  title.textContent = 'Something went wrong while rendering this view.';\n\n  const summary = document.createElement('p');\n  summary.textContent =\n    'The app recovered into a visible fallback so the error is not hidden in the console.';\n  summary.style.margin = '0';\n\n  const details = document.createElement('details');\n  details.open = isDevelopmentEnvironment();\n\n  const detailsSummary = document.createElement('summary');\n  detailsSummary.textContent = 'Error details';\n\n  const pre = document.createElement('pre');\n  pre.textContent = message;\n  pre.style.margin = '0';\n  pre.style.whiteSpace = 'pre-wrap';\n  pre.style.wordBreak = 'break-word';\n\n  const button = document.createElement('button');\n  button.type = 'button';\n  button.textContent = 'Try again';\n  button.addEventListener('click', () => reset());\n\n  details.append(detailsSummary, pre);\n  wrapper.append(title, summary, details, button);\n  return wrapper;\n}\n\nexport function createBoundaryReset(instance: ComponentInstance): () => void {\n  return () => {\n    const boundaryState = instance.errorBoundaryState;\n    if (!boundaryState) {\n      return;\n    }\n    boundaryState.error = null;\n    boundaryState.notified = false;\n    queueMicrotask(() => {\n      instance._enqueueRun?.();\n    });\n  };\n}\n\nexport function reportBoundaryError(\n  instance: ComponentInstance,\n  error: unknown,\n  onError?: (error: unknown) => void\n): void {\n  const boundaryState = instance.errorBoundaryState;\n  if (\n    boundaryState &&\n    Object.is(boundaryState.error, error) &&\n    boundaryState.notified\n  ) {\n    return;\n  }\n\n  if (boundaryState) {\n    boundaryState.error = error;\n    boundaryState.notified = true;\n  }\n\n  try {\n    onError?.(error);\n  } catch (hookError) {\n    logger.error('[Askr] ErrorBoundary onError handler threw:', hookError);\n  }\n\n  logger.error('[Askr] ErrorBoundary caught render error:', error);\n}\n"],"mappings":";;;;;;AA4BA,SAAS,mBAAmB,OAAwB;CAClD,IAAI,iBAAiB,OACnB,OAAO,MAAM,WAAW,MAAM,QAAQ;CAGxC,IAAI,OAAO,UAAU,UACnB,OAAO;CAGT,IAAI;EACF,OAAO,KAAK,UAAU,MAAM;SACtB;EACN,OAAO,OAAO,MAAM;;;AAIxB,SAAS,oBACP,UACA,UACoB;CACpB,MAAM,gBACJ,SAAS,uBACR,SAAS,qBAAqB;EAC7B,OAAO;EACP;EACA,UAAU;EACX;CAEH,IAAI,CAAC,OAAO,GAAG,cAAc,UAAU,SAAS,EAAE;EAChD,cAAc,QAAQ;EACtB,cAAc,WAAW;EACzB,cAAc,WAAW;;CAG3B,OAAO;;AAGT,SAAS,oBACP,UACA,OACoB;CACpB,MAAM,MACJ,OAAO,MAAM,QAAQ,WACjB,OACE,MAAM,OAAO;CAErB,OAAO;EACL,UAAU;EACV,MAAM;EACN,OAAO;GACL,UAAU,MAAM;GAChB,UAAU,MAAM;GAChB,SAAS,MAAM;GACf,UAAU,MAAM;GACjB;EACD;EACA,YAAY;EACb;;AAGH,SAAgB,cAAc,OAAuC;CACnE,MAAM,WAAW,6BAA6B;CAC9C,IAAI,CAAC,UACH,MAAM,IAAI,MACR,6EACD;CAGH,oBAAoB,UAAU,MAAM,SAAS;CAC7C,OAAO,oBAAoB,UAAU,MAAM;;AAmB7C,SAAgB,6BACd,UACA,OACA,OACS;CACT,IAAI,OAAO,aAAa,YACtB,OAAO,SAAS,OAAO,MAAM;CAG/B,IAAI,aAAa,QACf,OAAO;CAGT,MAAM,UAAU,mBAAmB,MAAM;CACzC,MAAM,UAAU,SAAS,cAAc,MAAM;CAC7C,QAAQ,aAAa,QAAQ,QAAQ;CACrC,QAAQ,aAAa,4BAA4B,OAAO;CACxD,QAAQ,MAAM,YAAY;CAC1B,QAAQ,MAAM,UAAU;CACxB,QAAQ,MAAM,SAAS;CACvB,QAAQ,MAAM,eAAe;CAC7B,QAAQ,MAAM,UAAU;CACxB,QAAQ,MAAM,MAAM;CACpB,QAAQ,MAAM,WAAW;CAEzB,MAAM,QAAQ,SAAS,cAAc,SAAS;CAC9C,MAAM,cAAc;CAEpB,MAAM,UAAU,SAAS,cAAc,IAAI;CAC3C,QAAQ,cACN;CACF,QAAQ,MAAM,SAAS;CAEvB,MAAM,UAAU,SAAS,cAAc,UAAU;CACjD,QAAQ,OAAO,0BAA0B;CAEzC,MAAM,iBAAiB,SAAS,cAAc,UAAU;CACxD,eAAe,cAAc;CAE7B,MAAM,MAAM,SAAS,cAAc,MAAM;CACzC,IAAI,cAAc;CAClB,IAAI,MAAM,SAAS;CACnB,IAAI,MAAM,aAAa;CACvB,IAAI,MAAM,YAAY;CAEtB,MAAM,SAAS,SAAS,cAAc,SAAS;CAC/C,OAAO,OAAO;CACd,OAAO,cAAc;CACrB,OAAO,iBAAiB,eAAe,OAAO,CAAC;CAE/C,QAAQ,OAAO,gBAAgB,IAAI;CACnC,QAAQ,OAAO,OAAO,SAAS,SAAS,OAAO;CAC/C,OAAO;;AAGT,SAAgB,oBAAoB,UAAyC;CAC3E,aAAa;EACX,MAAM,gBAAgB,SAAS;EAC/B,IAAI,CAAC,eACH;EAEF,cAAc,QAAQ;EACtB,cAAc,WAAW;EACzB,qBAAqB;GACnB,SAAS,eAAe;IACxB;;;AAIN,SAAgB,oBACd,UACA,OACA,SACM;CACN,MAAM,gBAAgB,SAAS;CAC/B,IACE,iBACA,OAAO,GAAG,cAAc,OAAO,MAAM,IACrC,cAAc,UAEd;CAGF,IAAI,eAAe;EACjB,cAAc,QAAQ;EACtB,cAAc,WAAW;;CAG3B,IAAI;EACF,UAAU,MAAM;UACT,WAAW;EAClB,OAAO,MAAM,+CAA+C,UAAU;;CAGxE,OAAO,MAAM,6CAA6C,MAAM"}
+{"version":3,"file":"error-boundary.js","names":[],"sources":["../../src/components/error-boundary.tsx"],"sourcesContent":["import type { Props } from '../common/props';\nimport { ELEMENT_TYPE, type JSXElement } from '../common/jsx';\nimport type { VNode } from '../common/vnode';\nimport { __ERROR_BOUNDARY__ } from '../common/vnode';\nimport {\n  getCurrentComponentInstance,\n  type ComponentInstance,\n} from '../runtime/component';\nimport { logger } from '../dev/logger';\nimport { isDevelopmentEnvironment } from '../common/env';\n\ntype ErrorBoundaryContent = VNode | readonly VNode[];\ntype ErrorBoundaryFallbackValue = ErrorBoundaryContent | Node;\n\nexport type ErrorBoundaryFallbackRender = (\n  error: unknown,\n  reset: () => void\n) => ErrorBoundaryFallbackValue;\n\nexport interface ErrorBoundaryProps extends Props {\n  children?: ErrorBoundaryContent;\n  fallback?: ErrorBoundaryFallbackValue | ErrorBoundaryFallbackRender;\n  onError?: (error: unknown) => void;\n  resetKey?: unknown;\n}\n\ntype ErrorBoundaryState = NonNullable<ComponentInstance['errorBoundaryState']>;\n\ntype ErrorBoundaryVNode = JSXElement & {\n  __instance?: ComponentInstance;\n};\n\nfunction getBoundaryMessage(error: unknown): string {\n  if (error instanceof Error) {\n    return error.message || error.name || 'Unknown error';\n  }\n\n  if (typeof error === 'string') {\n    return error;\n  }\n\n  try {\n    return JSON.stringify(error);\n  } catch {\n    return String(error);\n  }\n}\n\nfunction ensureBoundaryState(\n  instance: ComponentInstance,\n  resetKey: unknown\n): ErrorBoundaryState {\n  const boundaryState =\n    instance.errorBoundaryState ??\n    (instance.errorBoundaryState = {\n      error: null,\n      resetKey,\n      notified: false,\n    });\n\n  if (!Object.is(boundaryState.resetKey, resetKey)) {\n    boundaryState.error = null;\n    boundaryState.resetKey = resetKey;\n    boundaryState.notified = false;\n  }\n\n  return boundaryState;\n}\n\nfunction createBoundaryVNode(\n  instance: ComponentInstance,\n  props: ErrorBoundaryProps\n): ErrorBoundaryVNode {\n  const key =\n    typeof props.key === 'symbol'\n      ? null\n      : ((props.key ?? null) as string | number | null);\n\n  return {\n    $$typeof: ELEMENT_TYPE,\n    type: __ERROR_BOUNDARY__,\n    props: {\n      children: props.children,\n      fallback: props.fallback,\n      onError: props.onError,\n      resetKey: props.resetKey,\n    },\n    key,\n    __instance: instance,\n  };\n}\n\nexport function ErrorBoundary(props: ErrorBoundaryProps): JSXElement {\n  const instance = getCurrentComponentInstance();\n  if (!instance) {\n    throw new Error(\n      '[Askr] ErrorBoundary() can only be used during component render execution.'\n    );\n  }\n\n  ensureBoundaryState(instance, props.resetKey);\n  return createBoundaryVNode(instance, props);\n}\n\nexport function isErrorBoundaryVNode(\n  value: unknown\n): value is ErrorBoundaryVNode {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    (value as ErrorBoundaryVNode).type === __ERROR_BOUNDARY__\n  );\n}\n\nexport function resolveErrorBoundaryState(\n  vnode: ErrorBoundaryVNode\n): ErrorBoundaryState | null {\n  return vnode.__instance?.errorBoundaryState ?? null;\n}\n\nexport function resolveErrorBoundaryFallback(\n  fallback: ErrorBoundaryProps['fallback'],\n  error: unknown,\n  reset: () => void\n): ErrorBoundaryFallbackValue {\n  if (typeof fallback === 'function') {\n    return fallback(error, reset);\n  }\n\n  if (fallback !== undefined) {\n    return fallback;\n  }\n\n  const message = getBoundaryMessage(error);\n  const wrapper = document.createElement('div');\n  wrapper.setAttribute('role', 'alert');\n  wrapper.setAttribute('data-askr-error-boundary', 'true');\n  wrapper.style.boxSizing = 'border-box';\n  wrapper.style.padding = '1rem';\n  wrapper.style.border = '1px solid currentColor';\n  wrapper.style.borderRadius = '0.75rem';\n  wrapper.style.display = 'grid';\n  wrapper.style.gap = '0.75rem';\n  wrapper.style.maxWidth = '100%';\n\n  const title = document.createElement('strong');\n  title.textContent = 'Something went wrong while rendering this view.';\n\n  const summary = document.createElement('p');\n  summary.textContent =\n    'The app recovered into a visible fallback so the error is not hidden in the console.';\n  summary.style.margin = '0';\n\n  const details = document.createElement('details');\n  details.open = isDevelopmentEnvironment();\n\n  const detailsSummary = document.createElement('summary');\n  detailsSummary.textContent = 'Error details';\n\n  const pre = document.createElement('pre');\n  pre.textContent = message;\n  pre.style.margin = '0';\n  pre.style.whiteSpace = 'pre-wrap';\n  pre.style.wordBreak = 'break-word';\n\n  const button = document.createElement('button');\n  button.type = 'button';\n  button.textContent = 'Try again';\n  button.addEventListener('click', () => reset());\n\n  details.append(detailsSummary, pre);\n  wrapper.append(title, summary, details, button);\n  return wrapper;\n}\n\nexport function createBoundaryReset(instance: ComponentInstance): () => void {\n  return () => {\n    const boundaryState = instance.errorBoundaryState;\n    if (!boundaryState) {\n      return;\n    }\n    boundaryState.error = null;\n    boundaryState.notified = false;\n    queueMicrotask(() => {\n      instance._enqueueRun?.();\n    });\n  };\n}\n\nexport function reportBoundaryError(\n  instance: ComponentInstance,\n  error: unknown,\n  onError?: (error: unknown) => void\n): void {\n  const boundaryState = instance.errorBoundaryState;\n  if (\n    boundaryState &&\n    Object.is(boundaryState.error, error) &&\n    boundaryState.notified\n  ) {\n    return;\n  }\n\n  if (boundaryState) {\n    boundaryState.error = error;\n    boundaryState.notified = true;\n  }\n\n  try {\n    onError?.(error);\n  } catch (hookError) {\n    logger.error('[Askr] ErrorBoundary onError handler threw:', hookError);\n  }\n\n  logger.error('[Askr] ErrorBoundary caught render error:', error);\n}\n"],"mappings":"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"}

package/dist/components/link.d.ts

@@ -1,10 +1,11 @@
 import { Props } from "../common/props.js";
 import { JSXElement } from "../common/jsx.js";
+import { RenderableChild } from "../common/vnode.js";
 //#region src/components/link.d.ts
 type LinkProps = Omit<Props, 'children' | 'href' | 'class' | 'rel' | 'target' | 'aria-current' | 'aria-label'> & {
   href: string;
   class?: string;
-  children?: unknown;
+  children?: RenderableChild;
   /**
    * Optional rel attribute for link relationships.
    * Common values: "noopener", "noreferrer", "nofollow"

package/dist/components/link.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"link.d.ts","names":[],"sources":["../../src/components/link.tsx"],"mappings":";;;KAWY,SAAA,GAAY,IAAA,CACtB,KAAA;EASA,IAAA;EACA,KAAA;EACA,QAAA;EAXA;;;;EAgBA,GAAA;EAKA;;;;EAAA,MAAA;EA8Cc;;;;EAzCd,cAAA;EA4CA;;;EAjCA,YAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8Bc,IAAA,CAAA;EACd,IAAA;EACA,KAAA,EAAO,SAAA;EACP,QAAA;EACA,GAAA;EACA,MAAA;EAAA,gBACgB,WAAA;EAAA,cACF,SAAA;EAAA,GACX;AAAA,GACF,SAAA,GAAY,UAAA"}
+{"version":3,"file":"link.d.ts","names":[],"sources":["../../src/components/link.tsx"],"mappings":";;;;KAYY,SAAA,GAAY,IAAA,CACtB,KAAA;EASA,IAAA;EACA,KAAA;EACA,QAAA,GAAW,eAAA;EAAA;;;;EAKX,GAAA;EAPA;;;;EAYA,MAAA;EAAA;;;;EAKA,cAAA;EAyDc;;;EA9Cd,YAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;AAuDuB;;iBATT,IAAA,CAAA;EACd,IAAA;EACA,KAAA,EAAO,SAAA;EACP,QAAA;EACA,GAAA;EACA,MAAA;EAAA,gBACgB,WAAA;EAAA,cACF,SAAA;EAAA,GACX;AAAA,GACF,SAAA,GAAY,UAAA"}

package/dist/components/link.js

@@ -8,6 +8,15 @@ import { applyInteractionPolicy } from "../foundations/interactions/interaction-
 /**
 * Link component for client-side navigation
 */
+function isSameOriginNavigableHref(href) {
+	if (typeof window === "undefined") return true;
+	try {
+		const target = new URL(href, window.location.href);
+		return target.origin === window.location.origin && (target.protocol === "http:" || target.protocol === "https:");
+	} catch {
+		return false;
+	}
+}
 /**
 * Link component that prevents default navigation and uses navigate()
 * Provides declarative way to navigate between routes
@@ -44,7 +53,7 @@ function Link({ href, class: className, children, rel, target, "aria-current": a
 				onPress: (e) => {
 					const event = e;
 					if ((event.button ?? 0) !== 0 || event.ctrlKey || event.metaKey || event.shiftKey || event.altKey) return;
-					if (target) return;
+					if (target || !isSameOriginNavigableHref(href)) return;
 					event.preventDefault();
 					navigate(href);
 				}

package/dist/components/link.js.map

@@ -1 +1 @@
-{"version":3,"file":"link.js","names":[],"sources":["../../src/components/link.tsx"],"sourcesContent":["/**\n * Link component for client-side navigation\n */\n\nimport '../jsx/types';\nimport type { JSXElement } from '../common/jsx';\nimport type { Props } from '../common/props';\nimport { navigate } from '../router/navigate';\nimport { applyInteractionPolicy } from '../foundations/interactions/interaction-policy';\nimport { mergeProps } from '../foundations/utilities/merge-props';\n\nexport type LinkProps = Omit<\n  Props,\n  | 'children'\n  | 'href'\n  | 'class'\n  | 'rel'\n  | 'target'\n  | 'aria-current'\n  | 'aria-label'\n> & {\n  href: string;\n  class?: string;\n  children?: unknown;\n  /**\n   * Optional rel attribute for link relationships.\n   * Common values: \"noopener\", \"noreferrer\", \"nofollow\"\n   */\n  rel?: string;\n  /**\n   * Optional target attribute.\n   * Use \"_blank\" for new tab/window.\n   */\n  target?: string;\n  /**\n   * Optional aria-current attribute for indicating current page/location.\n   * Use \"page\" for the current page in navigation.\n   */\n  'aria-current'?:\n    | 'page'\n    | 'step'\n    | 'location'\n    | 'date'\n    | 'time'\n    | 'true'\n    | 'false';\n  /**\n   * Optional aria-label for accessibility when link text isn't descriptive enough.\n   */\n  'aria-label'?: string;\n};\n\n/**\n * Link component that prevents default navigation and uses navigate()\n * Provides declarative way to navigate between routes\n *\n * Accessibility features:\n * - Proper semantic <a> element (not a button)\n * - Supports aria-current for indicating active page\n * - Supports aria-label for descriptive labels\n * - Keyboard accessible (Enter key handled by native <a> element)\n *\n * Respects native browser behaviors:\n * - Middle-click (opens in new tab)\n * - Ctrl/Cmd+click (opens in new tab)\n * - Shift+click (opens in new window)\n * - Alt+click (downloads link)\n * - Right-click context menu\n *\n * Best practices:\n * - Use target=\"_blank\" with rel=\"noopener noreferrer\" for external links\n * - Use aria-current=\"page\" for the current page in navigation\n * - Provide descriptive link text or aria-label\n *\n * Uses applyInteractionPolicy to enforce pit-of-success principles:\n * - Interaction behavior centralized in foundations\n * - Keyboard handling automatic\n * - Composable via mergeProps\n */\nexport function Link({\n  href,\n  class: className,\n  children,\n  rel,\n  target,\n  'aria-current': ariaCurrent,\n  'aria-label': ariaLabel,\n  ...rest\n}: LinkProps): JSXElement {\n  const interaction = applyInteractionPolicy({\n    isNative: true,\n    disabled: false,\n    onPress: (e: Event) => {\n      const event = e as MouseEvent;\n\n      // Only intercept left-click without modifiers\n      // Default button to 0 if undefined (for mock events in tests)\n      const button = event.button ?? 0;\n      if (\n        button !== 0 || // not left-click\n        event.ctrlKey || // Ctrl/Cmd+click\n        event.metaKey || // Cmd on Mac\n        event.shiftKey || // Shift+click\n        event.altKey // Alt+click\n      ) {\n        return; // Let browser handle it (new tab, etc.)\n      }\n\n      // Don't intercept external links or explicit target\n      if (target) {\n        return; // Let browser handle it\n      }\n\n      event.preventDefault();\n      navigate(href);\n    },\n  });\n\n  const props = mergeProps(rest, {\n    ...interaction,\n    href,\n    class: className,\n    rel,\n    target,\n    'aria-current': ariaCurrent,\n    'aria-label': ariaLabel,\n  });\n\n  return <a {...props}>{children}</a>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+EA,SAAgB,KAAK,EACnB,MACA,OAAO,WACP,UACA,KACA,QACA,gBAAgB,aAChB,cAAc,WACd,GAAG,QACqB;CAwCxB,OAAO,oBAAC,KAAD;EAAG,GAVI,WAAW,MAAM;GAC7B,GA9BkB,uBAAuB;IACzC,UAAU;IACV,UAAU;IACV,UAAU,MAAa;KACrB,MAAM,QAAQ;KAKd,KADe,MAAM,UAAU,OAElB,KACX,MAAM,WACN,MAAM,WACN,MAAM,YACN,MAAM,QAEN;KAIF,IAAI,QACF;KAGF,MAAM,gBAAgB;KACtB,SAAS,KAAK;;IAEjB,CAGI;GACH;GACA,OAAO;GACP;GACA;GACA,gBAAgB;GAChB,cAAc;GACf,CAEa;EAAQ;EAAa,CAAA"}
+{"version":3,"file":"link.js","names":[],"sources":["../../src/components/link.tsx"],"sourcesContent":["/**\n * Link component for client-side navigation\n */\n\nimport '../jsx/types';\nimport type { JSXElement } from '../common/jsx';\nimport type { Props } from '../common/props';\nimport type { RenderableChild } from '../common/vnode';\nimport { navigate } from '../router/navigate';\nimport { applyInteractionPolicy } from '../foundations/interactions/interaction-policy';\nimport { mergeProps } from '../foundations/utilities/merge-props';\n\nexport type LinkProps = Omit<\n  Props,\n  | 'children'\n  | 'href'\n  | 'class'\n  | 'rel'\n  | 'target'\n  | 'aria-current'\n  | 'aria-label'\n> & {\n  href: string;\n  class?: string;\n  children?: RenderableChild;\n  /**\n   * Optional rel attribute for link relationships.\n   * Common values: \"noopener\", \"noreferrer\", \"nofollow\"\n   */\n  rel?: string;\n  /**\n   * Optional target attribute.\n   * Use \"_blank\" for new tab/window.\n   */\n  target?: string;\n  /**\n   * Optional aria-current attribute for indicating current page/location.\n   * Use \"page\" for the current page in navigation.\n   */\n  'aria-current'?:\n    | 'page'\n    | 'step'\n    | 'location'\n    | 'date'\n    | 'time'\n    | 'true'\n    | 'false';\n  /**\n   * Optional aria-label for accessibility when link text isn't descriptive enough.\n   */\n  'aria-label'?: string;\n};\n\nfunction isSameOriginNavigableHref(href: string): boolean {\n  if (typeof window === 'undefined') {\n    return true;\n  }\n\n  try {\n    const target = new URL(href, window.location.href);\n    return (\n      target.origin === window.location.origin &&\n      (target.protocol === 'http:' || target.protocol === 'https:')\n    );\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Link component that prevents default navigation and uses navigate()\n * Provides declarative way to navigate between routes\n *\n * Accessibility features:\n * - Proper semantic <a> element (not a button)\n * - Supports aria-current for indicating active page\n * - Supports aria-label for descriptive labels\n * - Keyboard accessible (Enter key handled by native <a> element)\n *\n * Respects native browser behaviors:\n * - Middle-click (opens in new tab)\n * - Ctrl/Cmd+click (opens in new tab)\n * - Shift+click (opens in new window)\n * - Alt+click (downloads link)\n * - Right-click context menu\n *\n * Best practices:\n * - Use target=\"_blank\" with rel=\"noopener noreferrer\" for external links\n * - Use aria-current=\"page\" for the current page in navigation\n * - Provide descriptive link text or aria-label\n *\n * Uses applyInteractionPolicy to enforce pit-of-success principles:\n * - Interaction behavior centralized in foundations\n * - Keyboard handling automatic\n * - Composable via mergeProps\n */\nexport function Link({\n  href,\n  class: className,\n  children,\n  rel,\n  target,\n  'aria-current': ariaCurrent,\n  'aria-label': ariaLabel,\n  ...rest\n}: LinkProps): JSXElement {\n  const interaction = applyInteractionPolicy({\n    isNative: true,\n    disabled: false,\n    onPress: (e: Event) => {\n      const event = e as MouseEvent;\n\n      // Only intercept left-click without modifiers\n      // Default button to 0 if undefined (for mock events in tests)\n      const button = event.button ?? 0;\n      if (\n        button !== 0 || // not left-click\n        event.ctrlKey || // Ctrl/Cmd+click\n        event.metaKey || // Cmd on Mac\n        event.shiftKey || // Shift+click\n        event.altKey // Alt+click\n      ) {\n        return; // Let browser handle it (new tab, etc.)\n      }\n\n      // Don't intercept external links or explicit target.\n      if (target || !isSameOriginNavigableHref(href)) {\n        return; // Let browser handle it\n      }\n\n      event.preventDefault();\n      navigate(href);\n    },\n  });\n\n  const props = mergeProps(rest, {\n    ...interaction,\n    href,\n    class: className,\n    rel,\n    target,\n    'aria-current': ariaCurrent,\n    'aria-label': ariaLabel,\n  });\n\n  return <a {...props}>{children}</a>;\n}\n"],"mappings":";;;;;;;;;;AAqDA,SAAS,0BAA0B,MAAuB;CACxD,IAAI,OAAO,WAAW,aACpB,OAAO;CAGT,IAAI;EACF,MAAM,SAAS,IAAI,IAAI,MAAM,OAAO,SAAS,IAAI;EACjD,OACE,OAAO,WAAW,OAAO,SAAS,WACjC,OAAO,aAAa,WAAW,OAAO,aAAa;CAExD,QAAQ;EACN,OAAO;CACT;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,SAAgB,KAAK,EACnB,MACA,OAAO,WACP,UACA,KACA,QACA,gBAAgB,aAChB,cAAc,WACd,GAAG,QACqB;CAwCxB,OAAO,oBAAC,KAAD;EAAG,GAVI,WAAW,MAAM;GAC7B,GA9BkB,uBAAuB;IACzC,UAAU;IACV,UAAU;IACV,UAAU,MAAa;KACrB,MAAM,QAAQ;KAKd,KADe,MAAM,UAAU,OAElB,KACX,MAAM,WACN,MAAM,WACN,MAAM,YACN,MAAM,QAEN;KAIF,IAAI,UAAU,CAAC,0BAA0B,IAAI,GAC3C;KAGF,MAAM,eAAe;KACrB,SAAS,IAAI;IACf;GACF,CAGK;GACH;GACA,OAAO;GACP;GACA;GACA,gBAAgB;GAChB,cAAc;EAChB,CAEc;EAAQ;CAAY,CAAA;AACpC"}

package/dist/control/case.d.ts

@@ -1,13 +1,15 @@
 import { JSXElement } from "../common/jsx.js";
+import { BoundaryChild } from "./shared.js";
 
 //#region src/control/case.d.ts
+type MatchChild = BoundaryChild | (() => BoundaryChild);
 type MatchProps = {
   key?: string | number | null;
   when: unknown;
-  children: unknown;
+  children: MatchChild;
 };
 type CaseProps = {
-  fallback?: unknown;
+  fallback?: BoundaryChild;
   children?: unknown;
 };
 declare function Match(_props: MatchProps): null;

package/dist/control/case.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"case.d.ts","names":[],"sources":["../../src/control/case.ts"],"mappings":";;;KAeY,UAAA;EACV,GAAA;EACA,IAAA;EACA,QAAA;AAAA;AAAA,KAGU,SAAA;EACV,QAAA;EACA,QAAA;AAAA;AAAA,iBAmBc,KAAA,CAAM,MAAA,EAAQ,UAAA;AAAA,cAqFjB,IAAA,GAEP,KAAA,EAAO,SAAA,KAAc,UAAA"}
+{"version":3,"file":"case.d.ts","names":[],"sources":["../../src/control/case.ts"],"mappings":";;;;KAeK,UAAA,GAAa,aAAA,UAAuB,aAAa;AAAA,KAE1C,UAAA;EACV,GAAA;EACA,IAAA;EACA,QAAA,EAAU,UAAU;AAAA;AAAA,KAGV,SAAA;EACV,QAAA,GAAW,aAAa;EACxB,QAAA;AAAA;AAAA,iBAmBc,KAAA,CAAM,MAAkB,EAAV,UAAU;AAAA,cAyF3B,IAAA,GAEP,KAAA,EAAO,SAAA,KAAc,UAAU"}

package/dist/control/case.js.map

@@ -1 +1 @@
-{"version":3,"file":"case.js","names":[],"sources":["../../src/control/case.ts"],"sourcesContent":["import {\n  __CONTROL_BOUNDARY__,\n  markEagerControlPrimitive,\n} from '../common/control';\nimport type { JSXElement } from '../common/jsx';\nimport type { VNode } from '../common/vnode';\nimport { isDevelopmentEnvironment } from '../common/env';\nimport {\n  createCaseState,\n  type CaseState,\n  type MatchBranch,\n} from '../runtime/control';\nimport { state } from '../runtime/state';\nimport { normalizeBoundaryChild } from './shared';\n\nexport type MatchProps = {\n  key?: string | number | null;\n  when: unknown;\n  children: unknown;\n};\n\nexport type CaseProps = {\n  fallback?: unknown;\n  children?: unknown;\n};\n\nfunction flattenChildren(children: unknown): unknown[] {\n  if (!Array.isArray(children)) {\n    return children == null || children === false ? [] : [children];\n  }\n\n  const result: unknown[] = [];\n  for (const child of children) {\n    if (Array.isArray(child)) {\n      result.push(...flattenChildren(child));\n      continue;\n    }\n    result.push(child);\n  }\n  return result;\n}\n\nexport function Match(_props: MatchProps): null {\n  if (isDevelopmentEnvironment()) {\n    throw new Error(\n      '[askr] <Match> may only be used as a direct child of <Case>.'\n    );\n  }\n  return null;\n}\n\nfunction createCaseFallbackRenderer(fallback: unknown): (() => VNode) | null {\n  const normalizedFallback = normalizeBoundaryChild(fallback);\n  if (normalizedFallback == null || normalizedFallback === false) {\n    return null;\n  }\n  return () => normalizedFallback;\n}\n\nfunction createMatchBranchKey(\n  key: string | number | null | undefined,\n  index: number\n): string | number {\n  if (key == null) {\n    return index;\n  }\n  return `match:${index}:${typeof key}:${String(key)}`;\n}\n\nfunction readMatchBranches(children: unknown): MatchBranch[] {\n  const branches: MatchBranch[] = [];\n  const flatChildren = flattenChildren(children);\n\n  for (let index = 0; index < flatChildren.length; index += 1) {\n    const child = flatChildren[index];\n    if (child == null || child === false) {\n      continue;\n    }\n\n    if (\n      typeof child === 'object' &&\n      child !== null &&\n      'type' in child &&\n      (child as JSXElement).type === Match\n    ) {\n      const element = child as JSXElement;\n      const props = (element.props ?? {}) as MatchProps;\n      const key = createMatchBranchKey(element.key, index);\n      const render =\n        typeof props.children === 'function'\n          ? () =>\n              normalizeBoundaryChild((props.children as () => VNode)()) as VNode\n          : () => normalizeBoundaryChild(props.children) as VNode;\n      branches.push({\n        key,\n        render,\n        when: props.when,\n      });\n      continue;\n    }\n\n    if (isDevelopmentEnvironment()) {\n      throw new Error('[askr] <Case> only accepts <Match> children.');\n    }\n  }\n\n  return branches;\n}\n\nfunction CasePrimitive(props: CaseProps): JSXElement {\n  const matches = readMatchBranches(props.children);\n  const fallback = createCaseFallbackRenderer(props.fallback);\n\n  const caseStateContainer = state<CaseState>(\n    createCaseState(matches, fallback)\n  );\n  const caseState = caseStateContainer();\n\n  caseState.matches = matches;\n  caseState.fallback = fallback;\n\n  return {\n    type: __CONTROL_BOUNDARY__,\n    _controlState: caseState,\n  } as unknown as JSXElement;\n}\n\nexport const Case = markEagerControlPrimitive(\n  CasePrimitive as (props: CaseProps) => JSXElement\n) as (props: CaseProps) => JSXElement;\n"],"mappings":";;;;;;AA0BA,SAAS,gBAAgB,UAA8B;CACrD,IAAI,CAAC,MAAM,QAAQ,SAAS,EAC1B,OAAO,YAAY,QAAQ,aAAa,QAAQ,EAAE,GAAG,CAAC,SAAS;CAGjE,MAAM,SAAoB,EAAE;CAC5B,KAAK,MAAM,SAAS,UAAU;EAC5B,IAAI,MAAM,QAAQ,MAAM,EAAE;GACxB,OAAO,KAAK,GAAG,gBAAgB,MAAM,CAAC;GACtC;;EAEF,OAAO,KAAK,MAAM;;CAEpB,OAAO;;AAGT,SAAgB,MAAM,QAA0B;CAC9C,IAAI,0BAA0B,EAC5B,MAAM,IAAI,MACR,+DACD;CAEH,OAAO;;AAGT,SAAS,2BAA2B,UAAyC;CAC3E,MAAM,qBAAqB,uBAAuB,SAAS;CAC3D,IAAI,sBAAsB,QAAQ,uBAAuB,OACvD,OAAO;CAET,aAAa;;AAGf,SAAS,qBACP,KACA,OACiB;CACjB,IAAI,OAAO,MACT,OAAO;CAET,OAAO,SAAS,MAAM,GAAG,OAAO,IAAI,GAAG,OAAO,IAAI;;AAGpD,SAAS,kBAAkB,UAAkC;CAC3D,MAAM,WAA0B,EAAE;CAClC,MAAM,eAAe,gBAAgB,SAAS;CAE9C,KAAK,IAAI,QAAQ,GAAG,QAAQ,aAAa,QAAQ,SAAS,GAAG;EAC3D,MAAM,QAAQ,aAAa;EAC3B,IAAI,SAAS,QAAQ,UAAU,OAC7B;EAGF,IACE,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACT,MAAqB,SAAS,OAC/B;GACA,MAAM,UAAU;GAChB,MAAM,QAAS,QAAQ,SAAS,EAAE;GAClC,MAAM,MAAM,qBAAqB,QAAQ,KAAK,MAAM;GACpD,MAAM,SACJ,OAAO,MAAM,aAAa,mBAEpB,uBAAwB,MAAM,UAA0B,CAAC,SACrD,uBAAuB,MAAM,SAAS;GAClD,SAAS,KAAK;IACZ;IACA;IACA,MAAM,MAAM;IACb,CAAC;GACF;;EAGF,IAAI,0BAA0B,EAC5B,MAAM,IAAI,MAAM,+CAA+C;;CAInE,OAAO;;AAGT,SAAS,cAAc,OAA8B;CACnD,MAAM,UAAU,kBAAkB,MAAM,SAAS;CACjD,MAAM,WAAW,2BAA2B,MAAM,SAAS;CAK3D,MAAM,YAHqB,MACzB,gBAAgB,SAAS,SAAS,CAElB,EAAoB;CAEtC,UAAU,UAAU;CACpB,UAAU,WAAW;CAErB,OAAO;EACL,MAAM;EACN,eAAe;EAChB;;AAGH,MAAa,OAAO,0BAClB,cACD"}
+{"version":3,"file":"case.js","names":[],"sources":["../../src/control/case.ts"],"sourcesContent":["import {\n  __CONTROL_BOUNDARY__,\n  markEagerControlPrimitive,\n} from '../common/control';\nimport type { JSXElement } from '../common/jsx';\nimport type { VNode } from '../common/vnode';\nimport { isDevelopmentEnvironment } from '../common/env';\nimport {\n  createCaseState,\n  type CaseState,\n  type MatchBranch,\n} from '../runtime/control';\nimport { state } from '../runtime/state';\nimport { type BoundaryChild, normalizeBoundaryChild } from './shared';\n\ntype MatchChild = BoundaryChild | (() => BoundaryChild);\n\nexport type MatchProps = {\n  key?: string | number | null;\n  when: unknown;\n  children: MatchChild;\n};\n\nexport type CaseProps = {\n  fallback?: BoundaryChild;\n  children?: unknown;\n};\n\nfunction flattenChildren(children: unknown): unknown[] {\n  if (!Array.isArray(children)) {\n    return children == null || children === false ? [] : [children];\n  }\n\n  const result: unknown[] = [];\n  for (const child of children) {\n    if (Array.isArray(child)) {\n      result.push(...flattenChildren(child));\n      continue;\n    }\n    result.push(child);\n  }\n  return result;\n}\n\nexport function Match(_props: MatchProps): null {\n  if (isDevelopmentEnvironment()) {\n    throw new Error(\n      '[askr] <Match> may only be used as a direct child of <Case>.'\n    );\n  }\n  return null;\n}\n\nfunction createCaseFallbackRenderer(\n  fallback: BoundaryChild | undefined\n): (() => VNode) | null {\n  const normalizedFallback = normalizeBoundaryChild(fallback);\n  if (normalizedFallback == null || normalizedFallback === false) {\n    return null;\n  }\n  return () => normalizedFallback;\n}\n\nfunction createMatchBranchKey(\n  key: string | number | null | undefined,\n  index: number\n): string | number {\n  if (key == null) {\n    return index;\n  }\n  return `match:${index}:${typeof key}:${String(key)}`;\n}\n\nfunction readMatchBranches(children: unknown): MatchBranch[] {\n  const branches: MatchBranch[] = [];\n  const flatChildren = flattenChildren(children);\n\n  for (let index = 0; index < flatChildren.length; index += 1) {\n    const child = flatChildren[index];\n    if (child == null || child === false) {\n      continue;\n    }\n\n    if (\n      typeof child === 'object' &&\n      child !== null &&\n      'type' in child &&\n      (child as JSXElement).type === Match\n    ) {\n      const element = child as JSXElement;\n      const props = (element.props ?? {}) as MatchProps;\n      const key = createMatchBranchKey(element.key, index);\n      const render =\n        typeof props.children === 'function'\n          ? () =>\n              normalizeBoundaryChild(\n                (props.children as () => BoundaryChild)()\n              ) as VNode\n          : () => normalizeBoundaryChild(props.children) as VNode;\n      branches.push({\n        key,\n        render,\n        when: props.when,\n      });\n      continue;\n    }\n\n    if (isDevelopmentEnvironment()) {\n      throw new Error('[askr] <Case> only accepts <Match> children.');\n    }\n  }\n\n  return branches;\n}\n\nfunction CasePrimitive(props: CaseProps): JSXElement {\n  const matches = readMatchBranches(props.children);\n  const fallback = createCaseFallbackRenderer(props.fallback);\n\n  const caseStateContainer = state<CaseState>(\n    createCaseState(matches, fallback)\n  );\n  const caseState = caseStateContainer();\n\n  caseState.matches = matches;\n  caseState.fallback = fallback;\n\n  return {\n    type: __CONTROL_BOUNDARY__,\n    _controlState: caseState,\n  } as unknown as JSXElement;\n}\n\nexport const Case = markEagerControlPrimitive(\n  CasePrimitive as (props: CaseProps) => JSXElement\n) as (props: CaseProps) => JSXElement;\n"],"mappings":";;;;;;AA4BA,SAAS,gBAAgB,UAA8B;CACrD,IAAI,CAAC,MAAM,QAAQ,QAAQ,GACzB,OAAO,YAAY,QAAQ,aAAa,QAAQ,CAAC,IAAI,CAAC,QAAQ;CAGhE,MAAM,SAAoB,CAAC;CAC3B,KAAK,MAAM,SAAS,UAAU;EAC5B,IAAI,MAAM,QAAQ,KAAK,GAAG;GACxB,OAAO,KAAK,GAAG,gBAAgB,KAAK,CAAC;GACrC;EACF;EACA,OAAO,KAAK,KAAK;CACnB;CACA,OAAO;AACT;AAEA,SAAgB,MAAM,QAA0B;CAC9C,IAAI,yBAAyB,GAC3B,MAAM,IAAI,MACR,8DACF;CAEF,OAAO;AACT;AAEA,SAAS,2BACP,UACsB;CACtB,MAAM,qBAAqB,uBAAuB,QAAQ;CAC1D,IAAI,sBAAsB,QAAQ,uBAAuB,OACvD,OAAO;CAET,aAAa;AACf;AAEA,SAAS,qBACP,KACA,OACiB;CACjB,IAAI,OAAO,MACT,OAAO;CAET,OAAO,SAAS,MAAM,GAAG,OAAO,IAAI,GAAG,OAAO,GAAG;AACnD;AAEA,SAAS,kBAAkB,UAAkC;CAC3D,MAAM,WAA0B,CAAC;CACjC,MAAM,eAAe,gBAAgB,QAAQ;CAE7C,KAAK,IAAI,QAAQ,GAAG,QAAQ,aAAa,QAAQ,SAAS,GAAG;EAC3D,MAAM,QAAQ,aAAa;EAC3B,IAAI,SAAS,QAAQ,UAAU,OAC7B;EAGF,IACE,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACT,MAAqB,SAAS,OAC/B;GACA,MAAM,UAAU;GAChB,MAAM,QAAS,QAAQ,SAAS,CAAC;GACjC,MAAM,MAAM,qBAAqB,QAAQ,KAAK,KAAK;GACnD,MAAM,SACJ,OAAO,MAAM,aAAa,mBAEpB,uBACG,MAAM,SAAiC,CAC1C,UACI,uBAAuB,MAAM,QAAQ;GACjD,SAAS,KAAK;IACZ;IACA;IACA,MAAM,MAAM;GACd,CAAC;GACD;EACF;EAEA,IAAI,yBAAyB,GAC3B,MAAM,IAAI,MAAM,8CAA8C;CAElE;CAEA,OAAO;AACT;AAEA,SAAS,cAAc,OAA8B;CACnD,MAAM,UAAU,kBAAkB,MAAM,QAAQ;CAChD,MAAM,WAAW,2BAA2B,MAAM,QAAQ;CAK1D,MAAM,YAHqB,MACzB,gBAAgB,SAAS,QAAQ,CAEjB,EAAmB;CAErC,UAAU,UAAU;CACpB,UAAU,WAAW;CAErB,OAAO;EACL,MAAM;EACN,eAAe;CACjB;AACF;AAEA,MAAa,OAAO,0BAClB,aACF"}

package/dist/control/for.d.ts

@@ -1,11 +1,12 @@
 import { JSXElement } from "../common/jsx.js";
+import { BoundaryChild } from "./shared.js";
 import { VNode } from "../common/vnode.js";
 
 //#region src/control/for.d.ts
 type ForEachSource<T> = T[] | (() => T[]);
 type ForBaseProps<T> = {
   each: ForEachSource<T>;
-  fallback?: unknown;
+  fallback?: BoundaryChild;
   children: (item: T, index: () => number) => VNode;
 };
 type KeyedForProps<T, K extends string | number> = ForBaseProps<T> & {

package/dist/control/for.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"for.d.ts","names":[],"sources":["../../src/control/for.ts"],"mappings":";;;;KAgBY,aAAA,MAAmB,CAAA,YAAa,CAAA;AAAA,KAEvC,YAAA;EACH,IAAA,EAAM,aAAA,CAAc,CAAA;EACpB,QAAA;EACA,QAAA,GAAW,IAAA,EAAM,CAAA,EAAG,KAAA,mBAAwB,KAAA;AAAA;AAAA,KAGzC,aAAA,iCAA8C,YAAA,CAAa,CAAA;EAC9D,EAAA,GAAK,IAAA,EAAM,CAAA,EAAG,KAAA,aAAkB,CAAA;EAChC,OAAA;AAAA;AAAA,KAGG,eAAA,MAAqB,YAAA,CAAa,CAAA;EACrC,EAAA;EACA,OAAA;AAAA;AAAA,KAGU,QAAA,mDACR,aAAA,CAAc,CAAA,EAAG,CAAA,IACjB,eAAA,CAAgB,CAAA;AAAA,cA0EP,GAAA,mDAKX,KAAA,EAAO,QAAA,CAAS,CAAA,EAAG,CAAA,MAChB,UAAA"}
+{"version":3,"file":"for.d.ts","names":[],"sources":["../../src/control/for.ts"],"mappings":";;;;;KAgBY,aAAA,MAAmB,CAAA,YAAa,CAAC;AAAA,KAExC,YAAA;EACH,IAAA,EAAM,aAAA,CAAc,CAAA;EACpB,QAAA,GAAW,aAAA;EACX,QAAA,GAAW,IAAA,EAAM,CAAA,EAAG,KAAA,mBAAwB,KAAA;AAAA;AAAA,KAGzC,aAAA,iCAA8C,YAAA,CAAa,CAAA;EAC9D,EAAA,GAAK,IAAA,EAAM,CAAA,EAAG,KAAA,aAAkB,CAAA;EAChC,OAAA;AAAA;AAAA,KAGG,eAAA,MAAqB,YAAY,CAAC,CAAA;EACrC,EAAA;EACA,OAAA;AAAA;AAAA,KAGU,QAAA,mDACR,aAAA,CAAc,CAAA,EAAG,CAAA,IACjB,eAAA,CAAgB,CAAA;AAAA,cA0EP,GAAA,mDAKX,KAAA,EAAO,QAAA,CAAS,CAAA,EAAG,CAAA,MAChB,UAAA"}

package/dist/control/for.js.map

@@ -1 +1 @@
-{"version":3,"file":"for.js","names":[],"sources":["../../src/control/for.ts"],"sourcesContent":["/**\n * For JSX primitive\n *\n * Creates a keyed child-scope boundary for efficient list rendering.\n */\n\nimport {\n  __CONTROL_BOUNDARY__,\n  markEagerControlPrimitive,\n} from '../common/control';\nimport type { JSXElement } from '../common/jsx';\nimport type { DOMElement, VNode } from '../common/vnode';\nimport { createFineGrainedEffect } from '../runtime/effect';\nimport { type ForState, useForState } from '../runtime/for';\nimport { normalizeBoundaryChild } from './shared';\n\nexport type ForEachSource<T> = T[] | (() => T[]);\n\ntype ForBaseProps<T> = {\n  each: ForEachSource<T>;\n  fallback?: unknown;\n  children: (item: T, index: () => number) => VNode;\n};\n\ntype KeyedForProps<T, K extends string | number> = ForBaseProps<T> & {\n  by: (item: T, index: number) => K;\n  byIndex?: never;\n};\n\ntype IndexedForProps<T> = ForBaseProps<T> & {\n  by?: never;\n  byIndex: true;\n};\n\nexport type ForProps<T, K extends string | number = string | number> =\n  | KeyedForProps<T, K>\n  | IndexedForProps<T>;\n\nfunction resolveEach<T>(each: ForEachSource<T>): T[] {\n  const resolved = typeof each === 'function' ? each() : each;\n  if (!Array.isArray(resolved)) {\n    throw new Error('For each must resolve to an array.');\n  }\n  return resolved;\n}\n\nfunction resolveKeyFn<T>(\n  props: ForProps<T>\n): (item: T, index: number) => string | number {\n  if ('by' in props && typeof props.by === 'function') {\n    return props.by;\n  }\n  if ('byIndex' in props && props.byIndex === true) {\n    return (_item, index) => index;\n  }\n  throw new Error(\n    '[askr] <For> requires a stable `by` key function. Use `byIndex` only as an explicit positional escape hatch.'\n  );\n}\n\nfunction createForBoundary<T>(props: ForProps<T>): DOMElement {\n  if ('by' in props && typeof props.by === 'function' && 'byIndex' in props) {\n    throw new Error('[askr] <For> accepts either `by` or `byIndex`, not both.');\n  }\n\n  const byFn = resolveKeyFn(props);\n  const fallback = normalizeBoundaryChild(props.fallback);\n  const forState = useForState(props.each, byFn, props.children, fallback);\n\n  const computeItems = () => resolveEach(forState.eachSource);\n  if (!forState._sourceEffect) {\n    forState._suspendSourceCommit = true;\n    forState._sourceEffect = createFineGrainedEffect({\n      lane: 'reactive',\n      compute: computeItems,\n      commit: (items) => {\n        forState.currentItems = items;\n\n        if (forState._suspendSourceCommit) {\n          return;\n        }\n\n        forState._needsSourceReconcile = true;\n\n        if (forState._enqueueBoundaryCommit) {\n          forState._enqueueBoundaryCommit();\n          return;\n        }\n\n        forState.parentInstance?._enqueueRun?.();\n      },\n    });\n    forState._suspendSourceCommit = false;\n  } else {\n    forState._suspendSourceCommit = true;\n    forState._sourceEffect.updateCompute(computeItems);\n    forState._suspendSourceCommit = false;\n  }\n\n  return {\n    type: __CONTROL_BOUNDARY__,\n    _controlState: forState as unknown as ForState<unknown>,\n    _forState: forState as unknown as ForState<unknown>,\n  };\n}\n\nfunction ForPrimitive<T>(props: ForProps<T>): JSXElement {\n  return createForBoundary(props) as unknown as JSXElement;\n}\n\nexport const For = markEagerControlPrimitive(\n  ForPrimitive as <T, K extends string | number = string | number>(\n    props: ForProps<T, K>\n  ) => JSXElement\n) as <T, K extends string | number = string | number>(\n  props: ForProps<T, K>\n) => JSXElement;\n"],"mappings":";;;;;;;;;;AAsCA,SAAS,YAAe,MAA6B;CACnD,MAAM,WAAW,OAAO,SAAS,aAAa,MAAM,GAAG;CACvD,IAAI,CAAC,MAAM,QAAQ,SAAS,EAC1B,MAAM,IAAI,MAAM,qCAAqC;CAEvD,OAAO;;AAGT,SAAS,aACP,OAC6C;CAC7C,IAAI,QAAQ,SAAS,OAAO,MAAM,OAAO,YACvC,OAAO,MAAM;CAEf,IAAI,aAAa,SAAS,MAAM,YAAY,MAC1C,QAAQ,OAAO,UAAU;CAE3B,MAAM,IAAI,MACR,+GACD;;AAGH,SAAS,kBAAqB,OAAgC;CAC5D,IAAI,QAAQ,SAAS,OAAO,MAAM,OAAO,cAAc,aAAa,OAClE,MAAM,IAAI,MAAM,2DAA2D;CAG7E,MAAM,OAAO,aAAa,MAAM;CAChC,MAAM,WAAW,uBAAuB,MAAM,SAAS;CACvD,MAAM,WAAW,YAAY,MAAM,MAAM,MAAM,MAAM,UAAU,SAAS;CAExE,MAAM,qBAAqB,YAAY,SAAS,WAAW;CAC3D,IAAI,CAAC,SAAS,eAAe;EAC3B,SAAS,uBAAuB;EAChC,SAAS,gBAAgB,wBAAwB;GAC/C,MAAM;GACN,SAAS;GACT,SAAS,UAAU;IACjB,SAAS,eAAe;IAExB,IAAI,SAAS,sBACX;IAGF,SAAS,wBAAwB;IAEjC,IAAI,SAAS,wBAAwB;KACnC,SAAS,wBAAwB;KACjC;;IAGF,SAAS,gBAAgB,eAAe;;GAE3C,CAAC;EACF,SAAS,uBAAuB;QAC3B;EACL,SAAS,uBAAuB;EAChC,SAAS,cAAc,cAAc,aAAa;EAClD,SAAS,uBAAuB;;CAGlC,OAAO;EACL,MAAM;EACN,eAAe;EACf,WAAW;EACZ;;AAGH,SAAS,aAAgB,OAAgC;CACvD,OAAO,kBAAkB,MAAM;;AAGjC,MAAa,MAAM,0BACjB,aAGD"}
+{"version":3,"file":"for.js","names":[],"sources":["../../src/control/for.ts"],"sourcesContent":["/**\n * For JSX primitive\n *\n * Creates a keyed child-scope boundary for efficient list rendering.\n */\n\nimport {\n  __CONTROL_BOUNDARY__,\n  markEagerControlPrimitive,\n} from '../common/control';\nimport type { JSXElement } from '../common/jsx';\nimport type { DOMElement, VNode } from '../common/vnode';\nimport { createFineGrainedEffect } from '../runtime/effect';\nimport { type ForState, useForState } from '../runtime/for';\nimport { type BoundaryChild, normalizeBoundaryChild } from './shared';\n\nexport type ForEachSource<T> = T[] | (() => T[]);\n\ntype ForBaseProps<T> = {\n  each: ForEachSource<T>;\n  fallback?: BoundaryChild;\n  children: (item: T, index: () => number) => VNode;\n};\n\ntype KeyedForProps<T, K extends string | number> = ForBaseProps<T> & {\n  by: (item: T, index: number) => K;\n  byIndex?: never;\n};\n\ntype IndexedForProps<T> = ForBaseProps<T> & {\n  by?: never;\n  byIndex: true;\n};\n\nexport type ForProps<T, K extends string | number = string | number> =\n  | KeyedForProps<T, K>\n  | IndexedForProps<T>;\n\nfunction resolveEach<T>(each: ForEachSource<T>): T[] {\n  const resolved = typeof each === 'function' ? each() : each;\n  if (!Array.isArray(resolved)) {\n    throw new Error('For each must resolve to an array.');\n  }\n  return resolved;\n}\n\nfunction resolveKeyFn<T>(\n  props: ForProps<T>\n): (item: T, index: number) => string | number {\n  if ('by' in props && typeof props.by === 'function') {\n    return props.by;\n  }\n  if ('byIndex' in props && props.byIndex === true) {\n    return (_item, index) => index;\n  }\n  throw new Error(\n    '[askr] <For> requires a stable `by` key function. Use `byIndex` only as an explicit positional escape hatch.'\n  );\n}\n\nfunction createForBoundary<T>(props: ForProps<T>): DOMElement {\n  if ('by' in props && typeof props.by === 'function' && 'byIndex' in props) {\n    throw new Error('[askr] <For> accepts either `by` or `byIndex`, not both.');\n  }\n\n  const byFn = resolveKeyFn(props);\n  const fallback = normalizeBoundaryChild(props.fallback);\n  const forState = useForState(props.each, byFn, props.children, fallback);\n\n  const computeItems = () => resolveEach(forState.eachSource);\n  if (!forState._sourceEffect) {\n    forState._suspendSourceCommit = true;\n    forState._sourceEffect = createFineGrainedEffect({\n      lane: 'reactive',\n      compute: computeItems,\n      commit: (items) => {\n        forState.currentItems = items;\n\n        if (forState._suspendSourceCommit) {\n          return;\n        }\n\n        forState._needsSourceReconcile = true;\n\n        if (forState._enqueueBoundaryCommit) {\n          forState._enqueueBoundaryCommit();\n          return;\n        }\n\n        forState.parentInstance?._enqueueRun?.();\n      },\n    });\n    forState._suspendSourceCommit = false;\n  } else {\n    forState._suspendSourceCommit = true;\n    forState._sourceEffect.updateCompute(computeItems);\n    forState._suspendSourceCommit = false;\n  }\n\n  return {\n    type: __CONTROL_BOUNDARY__,\n    _controlState: forState as unknown as ForState<unknown>,\n    _forState: forState as unknown as ForState<unknown>,\n  };\n}\n\nfunction ForPrimitive<T>(props: ForProps<T>): JSXElement {\n  return createForBoundary(props) as unknown as JSXElement;\n}\n\nexport const For = markEagerControlPrimitive(\n  ForPrimitive as <T, K extends string | number = string | number>(\n    props: ForProps<T, K>\n  ) => JSXElement\n) as <T, K extends string | number = string | number>(\n  props: ForProps<T, K>\n) => JSXElement;\n"],"mappings":";;;;;;;;;;AAsCA,SAAS,YAAe,MAA6B;CACnD,MAAM,WAAW,OAAO,SAAS,aAAa,KAAK,IAAI;CACvD,IAAI,CAAC,MAAM,QAAQ,QAAQ,GACzB,MAAM,IAAI,MAAM,oCAAoC;CAEtD,OAAO;AACT;AAEA,SAAS,aACP,OAC6C;CAC7C,IAAI,QAAQ,SAAS,OAAO,MAAM,OAAO,YACvC,OAAO,MAAM;CAEf,IAAI,aAAa,SAAS,MAAM,YAAY,MAC1C,QAAQ,OAAO,UAAU;CAE3B,MAAM,IAAI,MACR,8GACF;AACF;AAEA,SAAS,kBAAqB,OAAgC;CAC5D,IAAI,QAAQ,SAAS,OAAO,MAAM,OAAO,cAAc,aAAa,OAClE,MAAM,IAAI,MAAM,0DAA0D;CAG5E,MAAM,OAAO,aAAa,KAAK;CAC/B,MAAM,WAAW,uBAAuB,MAAM,QAAQ;CACtD,MAAM,WAAW,YAAY,MAAM,MAAM,MAAM,MAAM,UAAU,QAAQ;CAEvE,MAAM,qBAAqB,YAAY,SAAS,UAAU;CAC1D,IAAI,CAAC,SAAS,eAAe;EAC3B,SAAS,uBAAuB;EAChC,SAAS,gBAAgB,wBAAwB;GAC/C,MAAM;GACN,SAAS;GACT,SAAS,UAAU;IACjB,SAAS,eAAe;IAExB,IAAI,SAAS,sBACX;IAGF,SAAS,wBAAwB;IAEjC,IAAI,SAAS,wBAAwB;KACnC,SAAS,uBAAuB;KAChC;IACF;IAEA,SAAS,gBAAgB,cAAc;GACzC;EACF,CAAC;EACD,SAAS,uBAAuB;CAClC,OAAO;EACL,SAAS,uBAAuB;EAChC,SAAS,cAAc,cAAc,YAAY;EACjD,SAAS,uBAAuB;CAClC;CAEA,OAAO;EACL,MAAM;EACN,eAAe;EACf,WAAW;CACb;AACF;AAEA,SAAS,aAAgB,OAAgC;CACvD,OAAO,kBAAkB,KAAK;AAChC;AAEA,MAAa,MAAM,0BACjB,YAGF"}

package/dist/control/shared.d.ts

@@ -0,0 +1,9 @@
+import { RenderableChild, VNode } from "../common/vnode.js";
+
+//#region src/control/shared.d.ts
+type BoundaryChild = RenderableChild;
+declare function normalizeBoundaryChild(value: unknown): VNode | null;
+declare function resolveMaybeAccessor<T>(value: T | (() => T)): T;
+//#endregion
+export { BoundaryChild };
+//# sourceMappingURL=shared.d.ts.map

package/dist/control/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","names":[],"sources":["../../src/control/shared.ts"],"mappings":";;;KAGY,aAAA,GAAgB,eAAe;AAAA,iBAE3B,sBAAA,CAAuB,KAAA,YAAiB,KAAK;AAAA,iBAmB7C,oBAAA,GAAA,CAAwB,KAAA,EAAO,CAAA,UAAW,CAAA,IAAK,CAAA"}

package/dist/control/shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"shared.js","names":[],"sources":["../../src/control/shared.ts"],"sourcesContent":["import { Fragment } from '../common/jsx';\nimport type { DOMElement, VNode } from '../common/vnode';\n\nexport function normalizeBoundaryChild(value: unknown): VNode | null {\n  if (Array.isArray(value)) {\n    if (value.length === 0) {\n      return null;\n    }\n    if (value.length === 1) {\n      return normalizeBoundaryChild(value[0]);\n    }\n    return {\n      type: Fragment,\n      props: {\n        children: value,\n      },\n    } as DOMElement;\n  }\n\n  return (value ?? null) as VNode | null;\n}\n\nexport function resolveMaybeAccessor<T>(value: T | (() => T)): T {\n  return typeof value === 'function' ? (value as () => T)() : value;\n}\n"],"mappings":";;AAGA,SAAgB,uBAAuB,OAA8B;CACnE,IAAI,MAAM,QAAQ,MAAM,EAAE;EACxB,IAAI,MAAM,WAAW,GACnB,OAAO;EAET,IAAI,MAAM,WAAW,GACnB,OAAO,uBAAuB,MAAM,GAAG;EAEzC,OAAO;GACL,MAAM;GACN,OAAO,EACL,UAAU,OACX;GACF;;CAGH,OAAQ,SAAS;;AAGnB,SAAgB,qBAAwB,OAAyB;CAC/D,OAAO,OAAO,UAAU,aAAc,OAAmB,GAAG"}
+{"version":3,"file":"shared.js","names":[],"sources":["../../src/control/shared.ts"],"sourcesContent":["import { Fragment } from '../common/jsx';\nimport type { DOMElement, RenderableChild, VNode } from '../common/vnode';\n\nexport type BoundaryChild = RenderableChild;\n\nexport function normalizeBoundaryChild(value: unknown): VNode | null {\n  if (Array.isArray(value)) {\n    if (value.length === 0) {\n      return null;\n    }\n    if (value.length === 1) {\n      return normalizeBoundaryChild(value[0]);\n    }\n    return {\n      type: Fragment,\n      props: {\n        children: value,\n      },\n    } as DOMElement;\n  }\n\n  return (value ?? null) as VNode | null;\n}\n\nexport function resolveMaybeAccessor<T>(value: T | (() => T)): T {\n  return typeof value === 'function' ? (value as () => T)() : value;\n}\n"],"mappings":";;AAKA,SAAgB,uBAAuB,OAA8B;CACnE,IAAI,MAAM,QAAQ,KAAK,GAAG;EACxB,IAAI,MAAM,WAAW,GACnB,OAAO;EAET,IAAI,MAAM,WAAW,GACnB,OAAO,uBAAuB,MAAM,EAAE;EAExC,OAAO;GACL,MAAM;GACN,OAAO,EACL,UAAU,MACZ;EACF;CACF;CAEA,OAAQ,SAAS;AACnB;AAEA,SAAgB,qBAAwB,OAAyB;CAC/D,OAAO,OAAO,UAAU,aAAc,MAAkB,IAAI;AAC9D"}

package/dist/control/show.d.ts

@@ -1,12 +1,13 @@
 import { JSXElement } from "../common/jsx.js";
-import { VNode } from "../common/vnode.js";
+import { BoundaryChild } from "./shared.js";
 
 //#region src/control/show.d.ts
 type ShowSource<T> = T | (() => T);
+type Truthy<T> = T extends false | '' | 0 | 0n | null | undefined ? never : T;
 type ShowProps<T> = {
   when: ShowSource<T>;
-  fallback?: unknown;
-  children: unknown | ((value: NonNullable<T>) => VNode);
+  fallback?: BoundaryChild;
+  children: BoundaryChild | ((value: Truthy<T>) => BoundaryChild);
 };
 declare const Show: <T>(props: ShowProps<T>) => JSXElement;
 //#endregion

package/dist/control/show.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"show.d.ts","names":[],"sources":["../../src/control/show.ts"],"mappings":";;;;KAUK,UAAA,MAAgB,CAAA,UAAW,CAAA;AAAA,KAEpB,SAAA;EACV,IAAA,EAAM,UAAA,CAAW,CAAA;EACjB,QAAA;EACA,QAAA,cAAsB,KAAA,EAAO,WAAA,CAAY,CAAA,MAAO,KAAA;AAAA;AAAA,cA+CrC,IAAA,MAEJ,KAAA,EAAO,SAAA,CAAU,CAAA,MAAO,UAAA"}
+{"version":3,"file":"show.d.ts","names":[],"sources":["../../src/control/show.ts"],"mappings":";;;;KAcK,UAAA,MAAgB,CAAA,UAAW,CAAC;AAAA,KAC5B,MAAA,MAAY,CAAA,0DAA2D,CAAC;AAAA,KAEjE,SAAA;EACV,IAAA,EAAM,UAAA,CAAW,CAAA;EACjB,QAAA,GAAW,aAAA;EACX,QAAA,EAAU,aAAA,KAAkB,KAAA,EAAO,MAAA,CAAO,CAAA,MAAO,aAAA;AAAA;AAAA,cA+CtC,IAAA,MAEJ,KAAA,EAAO,SAAA,CAAU,CAAA,MAAO,UAAA"}

package/dist/control/show.js.map

@@ -1 +1 @@
-{"version":3,"file":"show.js","names":[],"sources":["../../src/control/show.ts"],"sourcesContent":["import {\n  __CONTROL_BOUNDARY__,\n  markEagerControlPrimitive,\n} from '../common/control';\nimport type { JSXElement } from '../common/jsx';\nimport type { VNode } from '../common/vnode';\nimport { createShowState, type ShowState } from '../runtime/control';\nimport { state } from '../runtime/state';\nimport { normalizeBoundaryChild, resolveMaybeAccessor } from './shared';\n\ntype ShowSource<T> = T | (() => T);\n\nexport type ShowProps<T> = {\n  when: ShowSource<T>;\n  fallback?: unknown;\n  children: unknown | ((value: NonNullable<T>) => VNode);\n};\n\nfunction createTruthyRenderer<T>(\n  props: ShowProps<T>\n): ShowState['renderTruthy'] {\n  if (typeof props.children === 'function') {\n    return (value: unknown) =>\n      normalizeBoundaryChild(\n        (props.children as (resolved: NonNullable<T>) => VNode)(\n          value as NonNullable<T>\n        )\n      ) as VNode;\n  }\n\n  const staticChild = normalizeBoundaryChild(props.children);\n  return () => staticChild as VNode;\n}\n\nfunction createFallbackRenderer(fallback: unknown): (() => VNode) | null {\n  const normalizedFallback = normalizeBoundaryChild(fallback);\n  if (normalizedFallback == null || normalizedFallback === false) {\n    return null;\n  }\n  return () => normalizedFallback;\n}\n\nfunction ShowPrimitive<T>(props: ShowProps<T>): JSXElement {\n  const selectedValue = resolveMaybeAccessor(props.when);\n  const renderTruthy = createTruthyRenderer(props);\n  const renderFallback = createFallbackRenderer(props.fallback);\n\n  const showStateContainer = state<ShowState>(\n    createShowState(selectedValue, renderTruthy, renderFallback)\n  );\n  const showState = showStateContainer();\n\n  showState.selectedValue = selectedValue;\n  showState.renderTruthy = renderTruthy;\n  showState.renderFallback = renderFallback;\n\n  return {\n    type: __CONTROL_BOUNDARY__,\n    _controlState: showState,\n  } as unknown as JSXElement;\n}\n\nexport const Show = markEagerControlPrimitive(\n  ShowPrimitive as <T>(props: ShowProps<T>) => JSXElement\n) as <T>(props: ShowProps<T>) => JSXElement;\n"],"mappings":";;;;;AAkBA,SAAS,qBACP,OAC2B;CAC3B,IAAI,OAAO,MAAM,aAAa,YAC5B,QAAQ,UACN,uBACG,MAAM,SACL,MACD,CACF;CAGL,MAAM,cAAc,uBAAuB,MAAM,SAAS;CAC1D,aAAa;;AAGf,SAAS,uBAAuB,UAAyC;CACvE,MAAM,qBAAqB,uBAAuB,SAAS;CAC3D,IAAI,sBAAsB,QAAQ,uBAAuB,OACvD,OAAO;CAET,aAAa;;AAGf,SAAS,cAAiB,OAAiC;CACzD,MAAM,gBAAgB,qBAAqB,MAAM,KAAK;CACtD,MAAM,eAAe,qBAAqB,MAAM;CAChD,MAAM,iBAAiB,uBAAuB,MAAM,SAAS;CAK7D,MAAM,YAHqB,MACzB,gBAAgB,eAAe,cAAc,eAAe,CAE5C,EAAoB;CAEtC,UAAU,gBAAgB;CAC1B,UAAU,eAAe;CACzB,UAAU,iBAAiB;CAE3B,OAAO;EACL,MAAM;EACN,eAAe;EAChB;;AAGH,MAAa,OAAO,0BAClB,cACD"}
+{"version":3,"file":"show.js","names":[],"sources":["../../src/control/show.ts"],"sourcesContent":["import {\n  __CONTROL_BOUNDARY__,\n  markEagerControlPrimitive,\n} from '../common/control';\nimport type { JSXElement } from '../common/jsx';\nimport type { VNode } from '../common/vnode';\nimport { createShowState, type ShowState } from '../runtime/control';\nimport { state } from '../runtime/state';\nimport {\n  type BoundaryChild,\n  normalizeBoundaryChild,\n  resolveMaybeAccessor,\n} from './shared';\n\ntype ShowSource<T> = T | (() => T);\ntype Truthy<T> = T extends false | '' | 0 | 0n | null | undefined ? never : T;\n\nexport type ShowProps<T> = {\n  when: ShowSource<T>;\n  fallback?: BoundaryChild;\n  children: BoundaryChild | ((value: Truthy<T>) => BoundaryChild);\n};\n\nfunction createTruthyRenderer<T>(\n  props: ShowProps<T>\n): ShowState['renderTruthy'] {\n  if (typeof props.children === 'function') {\n    return (value: unknown) =>\n      normalizeBoundaryChild(\n        (props.children as (resolved: Truthy<T>) => VNode)(value as Truthy<T>)\n      ) as VNode;\n  }\n\n  const staticChild = normalizeBoundaryChild(props.children);\n  return () => staticChild as VNode;\n}\n\nfunction createFallbackRenderer(\n  fallback: BoundaryChild | undefined\n): (() => VNode) | null {\n  const normalizedFallback = normalizeBoundaryChild(fallback);\n  if (normalizedFallback == null || normalizedFallback === false) {\n    return null;\n  }\n  return () => normalizedFallback;\n}\n\nfunction ShowPrimitive<T>(props: ShowProps<T>): JSXElement {\n  const selectedValue = resolveMaybeAccessor(props.when);\n  const renderTruthy = createTruthyRenderer(props);\n  const renderFallback = createFallbackRenderer(props.fallback);\n\n  const showStateContainer = state<ShowState>(\n    createShowState(selectedValue, renderTruthy, renderFallback)\n  );\n  const showState = showStateContainer();\n\n  showState.selectedValue = selectedValue;\n  showState.renderTruthy = renderTruthy;\n  showState.renderFallback = renderFallback;\n\n  return {\n    type: __CONTROL_BOUNDARY__,\n    _controlState: showState,\n  } as unknown as JSXElement;\n}\n\nexport const Show = markEagerControlPrimitive(\n  ShowPrimitive as <T>(props: ShowProps<T>) => JSXElement\n) as <T>(props: ShowProps<T>) => JSXElement;\n"],"mappings":";;;;;AAuBA,SAAS,qBACP,OAC2B;CAC3B,IAAI,OAAO,MAAM,aAAa,YAC5B,QAAQ,UACN,uBACG,MAAM,SAA4C,KAAkB,CACvE;CAGJ,MAAM,cAAc,uBAAuB,MAAM,QAAQ;CACzD,aAAa;AACf;AAEA,SAAS,uBACP,UACsB;CACtB,MAAM,qBAAqB,uBAAuB,QAAQ;CAC1D,IAAI,sBAAsB,QAAQ,uBAAuB,OACvD,OAAO;CAET,aAAa;AACf;AAEA,SAAS,cAAiB,OAAiC;CACzD,MAAM,gBAAgB,qBAAqB,MAAM,IAAI;CACrD,MAAM,eAAe,qBAAqB,KAAK;CAC/C,MAAM,iBAAiB,uBAAuB,MAAM,QAAQ;CAK5D,MAAM,YAHqB,MACzB,gBAAgB,eAAe,cAAc,cAAc,CAE3C,EAAmB;CAErC,UAAU,gBAAgB;CAC1B,UAAU,eAAe;CACzB,UAAU,iBAAiB;CAE3B,OAAO;EACL,MAAM;EACN,eAAe;CACjB;AACF;AAEA,MAAa,OAAO,0BAClB,aACF"}