@askrjs/askr 0.0.1 → 0.0.3

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { J as JSXElement, P as Props } from './types-DUDmnzD8.cjs';
+import { J as JSXElement, P as Props } from './types-DLTViI21.cjs';
 export { Fragment, jsx, jsxs } from './jsx/jsx-runtime.cjs';
 
 /**
@@ -28,7 +28,7 @@ interface Context<T> {
     readonly key: ContextKey;
     readonly defaultValue: T;
     readonly Scope: (props: {
-        value: T;
+        value: unknown;
         children?: unknown;
     }) => JSXElement;
 }
@@ -60,6 +60,7 @@ interface ComponentInstance {
     mounted: boolean;
     abortController: AbortController;
     ssr?: boolean;
+    cleanupStrict?: boolean;
     stateValues: State<unknown>[];
     evaluationGeneration: number;
     notifyUpdate: (() => void) | null;
@@ -78,6 +79,7 @@ interface ComponentInstance {
     lastRenderToken?: number;
     _pendingReadStates?: Set<State<unknown>>;
     _lastReadStates?: Set<State<unknown>>;
+    _placeholder?: Comment;
 }
 /**
  * Get the abort signal for the current component
@@ -145,6 +147,7 @@ declare function getSignal(): AbortSignal;
 interface State<T> {
     (): T;
     set(value: T): void;
+    set(updater: (prev: T) => T): void;
     _hasBeenRead?: boolean;
     _readers?: Map<ComponentInstance, number>;
 }
@@ -197,6 +200,8 @@ interface DataResult<T> {
 declare function resource<T>(fn: (opts: {
     signal: AbortSignal;
 }) => Promise<T> | T, deps?: unknown[]): DataResult<T>;
+declare function derive<TOut>(fn: () => TOut): TOut | null;
+declare function task(fn: () => void | (() => void) | Promise<void | (() => void)>): void;
 
 /**
  * Route definition and matching
@@ -240,7 +245,8 @@ interface RouteSnapshot {
     matches: readonly RouteMatch[];
 }
 declare function setServerLocation(url: string | null): void;
-declare function route(path?: string, handler?: RouteHandler, namespace?: string): void | RouteSnapshot;
+declare function route(): RouteSnapshot;
+declare function route(path: string, handler?: RouteHandler, namespace?: string): void;
 /**
  * Get all registered routes
  */
@@ -266,35 +272,22 @@ declare function getLoadedNamespaces(): string[];
  * App bootstrap and mount
  */
 
-interface AppConfig {
-    root: Element | string;
-    component: ComponentFunction;
-}
-/**
- * Bootstrap and mount app on client
- * Supports both sync and async components
- *
- * If createApp is called multiple times on the same root, the existing instance
- * is reused and its component function is updated. This ensures:
- * - Generation tokens work correctly (old async renders don't overwrite new ones)
- * - State is preserved across updates (if desired)
- * - DOM is diffed/updated rather than replaced
- */
-declare function createApp(config: AppConfig | SPAConfig): void;
-
 type IslandConfig = {
     root: Element | string;
     component: ComponentFunction;
+    cleanupStrict?: boolean;
     routes?: never;
 };
 type SPAConfig = {
     root: Element | string;
     routes: Route[];
+    cleanupStrict?: boolean;
     component?: never;
 };
 type HydrateSPAConfig = {
     root: Element | string;
     routes: Route[];
+    cleanupStrict?: boolean;
 };
 /**
  * createIsland: Enhances existing DOM (no router, mounts once)
@@ -318,24 +311,6 @@ declare function cleanupApp(root: Element | string): void;
  */
 declare function hasApp(root: Element | string): boolean;
 
-/**
- * Small layout helper (centralized)
- * Usage: const parent = layout(ParentLayout); route('/parent', () => parent(<Child />));
- *
- * A layout is simply a component that receives `children`.
- * This helper intentionally avoids vnode inspection, heuristics, or double-invocation.
- * Prefer boring, explicit code over cleverness.
- *
- * Example:
- * const Parent = ({ children }: { children?: unknown }) => <div class="parent">{children}</div>;
- * const parent = layout(Parent);
- * route('/parent', () => parent(<div class="child">C</div>));
- */
-type Component<P = object> = (props: P & {
-    children?: unknown;
-}) => unknown;
-declare function layout<P>(Layout: Component<P>): (children?: unknown) => unknown;
-
 /**
  * Client-side navigation with History API
  */
@@ -349,7 +324,6 @@ declare function navigate(path: string): void;
 /**
  * Link component for client-side navigation
  */
-
 interface LinkProps {
     href: string;
     children?: unknown;
@@ -364,9 +338,92 @@ interface LinkProps {
  * - Shift+click (opens in new window)
  * - Right-click context menu
  */
-declare function Link({ href, children }: LinkProps): JSXElement;
+declare function Link({ href, children }: LinkProps): unknown;
+
+/**
+ * Layout helper.
+ *
+ * A layout is just a normal component that wraps children.
+ * Persistence and reuse are handled by the runtime via component identity.
+ *
+ * This helper exists purely for readability and convention.
+ */
+type LayoutComponent<P = object> = (props: P & {
+    children?: unknown;
+}) => unknown;
+declare function layout<P = object>(Layout: LayoutComponent<P>): (children?: unknown, props?: P) => unknown;
+
+type SlotProps = {
+    asChild: true;
+    children: JSXElement;
+    [key: string]: unknown;
+} | {
+    asChild?: false;
+    children?: unknown;
+};
+declare function Slot(props: SlotProps): JSXElement | null;
+
+/**
+ * Portal / Host primitive.
+ *
+ * A portal is a named render slot within the existing tree.
+ * It does NOT create a second tree or touch the DOM directly.
+ */
+interface Portal<T = unknown> {
+    /** Mount point — rendered exactly once */
+    (): unknown;
+    /** Render content into the portal */
+    render(props: {
+        children?: T;
+    }): unknown;
+}
+declare function definePortal<T = unknown>(): Portal<T>;
+/**
+ * Reset the default portal state. Used by tests to ensure isolation.
+ * @internal
+ */
+declare function _resetDefaultPortal(): void;
+declare const DefaultPortal: Portal<unknown>;
+
+/**
+ * SSR Context Management
+ *
+ * Provides context for server-side rendering including:
+ * - SSRContext: Full context for sink-based streaming SSR
+ * - RenderContext: Lightweight context for sync render passes
+ */
 
 type SSRData = Record<string, unknown>;
+/** Lightweight context for synchronous render passes */
+type RenderContext = {
+    seed: number;
+};
+
+/**
+ * Shared SSR types
+ */
+
+/** VNode representation for SSR rendering */
+type VNode = {
+    type: string | SSRComponent;
+    props?: Props;
+    children?: unknown[];
+};
+/**
+ * Component function signature for SSR.
+ * Components receive props and an optional context with signal and SSR context.
+ */
+type SSRComponent = (props: Props, context?: {
+    signal?: AbortSignal;
+    ssr?: RenderContext;
+}) => VNode | JSXElement | string | number | boolean | null;
+
+/**
+ * SSR Data Management
+ *
+ * Manages render-phase keying for deterministic SSR data lookup.
+ * Note: SSR collection/prepass APIs have been removed — SSR is strictly synchronous.
+ */
 
 type ResourceDescriptor = {
     key: string;
@@ -379,11 +436,14 @@ type ResourceDescriptor = {
 type ResourcePlan = {
     resources: ResourceDescriptor[];
 };
+/** @deprecated SSR prepass has been removed */
 declare function resolvePlan(_plan: ResourcePlan): Promise<Record<string, unknown>>;
+/** @deprecated SSR prepass has been removed */
 declare function collectResources(_opts: {
     url: string;
     routes: SSRRoute[];
 }): ResourcePlan;
+/** @deprecated Alias for resolvePlan */
 declare const resolveResources: typeof resolvePlan;
 
 /**
@@ -395,11 +455,6 @@ declare const resolveResources: typeof resolvePlan;
  * when an async component or async resource is encountered during sync SSR.
  */
 
-type VNode = {
-    type: string;
-    props?: Props;
-    children?: (string | VNode | null | undefined | false)[];
-};
 /**
  * Single synchronous SSR entrypoint: render a component to an HTML string.
  * This is strictly synchronous and deterministic. Optionally provide a seed
@@ -443,4 +498,4 @@ declare function renderToStream(opts: {
     onComplete(): void;
 }): void;
 
-export { type Context, type DataResult, type HydrateSPAConfig, type IslandConfig, Link, type LinkProps, Props, type Route, type RouteHandler, type RouteMatch, type RouteSnapshot, type SPAConfig, type State, cleanupApp, clearRoutes, collectResources, createApp, createIsland, createSPA, defineContext, getLoadedNamespaces, getNamespaceRoutes, getRoutes, getSignal, hasApp, hydrateSPA, layout, navigate, readContext, renderToStream, renderToString, renderToStringSync, renderToStringSyncForUrl, resolveResources, resource, route, scheduleEventHandler, setServerLocation, state, unloadNamespace };
+export { type Context, type DataResult, DefaultPortal, type HydrateSPAConfig, type IslandConfig, type LayoutComponent, Link, type LinkProps, type Portal, Props, type Route, type RouteHandler, type RouteMatch, type RouteSnapshot, type SPAConfig, Slot, type SlotProps, type State, _resetDefaultPortal, cleanupApp, clearRoutes, collectResources, createIsland, createSPA, defineContext, definePortal, derive, getLoadedNamespaces, getNamespaceRoutes, getRoutes, getSignal, hasApp, hydrateSPA, layout, navigate, readContext, renderToStream, renderToString, renderToStringSync, renderToStringSyncForUrl, resolveResources, resource, route, scheduleEventHandler, setServerLocation, state, task, unloadNamespace };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { J as JSXElement, P as Props } from './types-DUDmnzD8.js';
+import { J as JSXElement, P as Props } from './types-DLTViI21.js';
 export { Fragment, jsx, jsxs } from './jsx/jsx-runtime.js';
 
 /**
@@ -28,7 +28,7 @@ interface Context<T> {
     readonly key: ContextKey;
     readonly defaultValue: T;
     readonly Scope: (props: {
-        value: T;
+        value: unknown;
         children?: unknown;
     }) => JSXElement;
 }
@@ -60,6 +60,7 @@ interface ComponentInstance {
     mounted: boolean;
     abortController: AbortController;
     ssr?: boolean;
+    cleanupStrict?: boolean;
     stateValues: State<unknown>[];
     evaluationGeneration: number;
     notifyUpdate: (() => void) | null;
@@ -78,6 +79,7 @@ interface ComponentInstance {
     lastRenderToken?: number;
     _pendingReadStates?: Set<State<unknown>>;
     _lastReadStates?: Set<State<unknown>>;
+    _placeholder?: Comment;
 }
 /**
  * Get the abort signal for the current component
@@ -145,6 +147,7 @@ declare function getSignal(): AbortSignal;
 interface State<T> {
     (): T;
     set(value: T): void;
+    set(updater: (prev: T) => T): void;
     _hasBeenRead?: boolean;
     _readers?: Map<ComponentInstance, number>;
 }
@@ -197,6 +200,8 @@ interface DataResult<T> {
 declare function resource<T>(fn: (opts: {
     signal: AbortSignal;
 }) => Promise<T> | T, deps?: unknown[]): DataResult<T>;
+declare function derive<TOut>(fn: () => TOut): TOut | null;
+declare function task(fn: () => void | (() => void) | Promise<void | (() => void)>): void;
 
 /**
  * Route definition and matching
@@ -240,7 +245,8 @@ interface RouteSnapshot {
     matches: readonly RouteMatch[];
 }
 declare function setServerLocation(url: string | null): void;
-declare function route(path?: string, handler?: RouteHandler, namespace?: string): void | RouteSnapshot;
+declare function route(): RouteSnapshot;
+declare function route(path: string, handler?: RouteHandler, namespace?: string): void;
 /**
  * Get all registered routes
  */
@@ -266,35 +272,22 @@ declare function getLoadedNamespaces(): string[];
  * App bootstrap and mount
  */
 
-interface AppConfig {
-    root: Element | string;
-    component: ComponentFunction;
-}
-/**
- * Bootstrap and mount app on client
- * Supports both sync and async components
- *
- * If createApp is called multiple times on the same root, the existing instance
- * is reused and its component function is updated. This ensures:
- * - Generation tokens work correctly (old async renders don't overwrite new ones)
- * - State is preserved across updates (if desired)
- * - DOM is diffed/updated rather than replaced
- */
-declare function createApp(config: AppConfig | SPAConfig): void;
-
 type IslandConfig = {
     root: Element | string;
     component: ComponentFunction;
+    cleanupStrict?: boolean;
     routes?: never;
 };
 type SPAConfig = {
     root: Element | string;
     routes: Route[];
+    cleanupStrict?: boolean;
     component?: never;
 };
 type HydrateSPAConfig = {
     root: Element | string;
     routes: Route[];
+    cleanupStrict?: boolean;
 };
 /**
  * createIsland: Enhances existing DOM (no router, mounts once)
@@ -318,24 +311,6 @@ declare function cleanupApp(root: Element | string): void;
  */
 declare function hasApp(root: Element | string): boolean;
 
-/**
- * Small layout helper (centralized)
- * Usage: const parent = layout(ParentLayout); route('/parent', () => parent(<Child />));
- *
- * A layout is simply a component that receives `children`.
- * This helper intentionally avoids vnode inspection, heuristics, or double-invocation.
- * Prefer boring, explicit code over cleverness.
- *
- * Example:
- * const Parent = ({ children }: { children?: unknown }) => <div class="parent">{children}</div>;
- * const parent = layout(Parent);
- * route('/parent', () => parent(<div class="child">C</div>));
- */
-type Component<P = object> = (props: P & {
-    children?: unknown;
-}) => unknown;
-declare function layout<P>(Layout: Component<P>): (children?: unknown) => unknown;
-
 /**
  * Client-side navigation with History API
  */
@@ -349,7 +324,6 @@ declare function navigate(path: string): void;
 /**
  * Link component for client-side navigation
  */
-
 interface LinkProps {
     href: string;
     children?: unknown;
@@ -364,9 +338,92 @@ interface LinkProps {
  * - Shift+click (opens in new window)
  * - Right-click context menu
  */
-declare function Link({ href, children }: LinkProps): JSXElement;
+declare function Link({ href, children }: LinkProps): unknown;
+
+/**
+ * Layout helper.
+ *
+ * A layout is just a normal component that wraps children.
+ * Persistence and reuse are handled by the runtime via component identity.
+ *
+ * This helper exists purely for readability and convention.
+ */
+type LayoutComponent<P = object> = (props: P & {
+    children?: unknown;
+}) => unknown;
+declare function layout<P = object>(Layout: LayoutComponent<P>): (children?: unknown, props?: P) => unknown;
+
+type SlotProps = {
+    asChild: true;
+    children: JSXElement;
+    [key: string]: unknown;
+} | {
+    asChild?: false;
+    children?: unknown;
+};
+declare function Slot(props: SlotProps): JSXElement | null;
+
+/**
+ * Portal / Host primitive.
+ *
+ * A portal is a named render slot within the existing tree.
+ * It does NOT create a second tree or touch the DOM directly.
+ */
+interface Portal<T = unknown> {
+    /** Mount point — rendered exactly once */
+    (): unknown;
+    /** Render content into the portal */
+    render(props: {
+        children?: T;
+    }): unknown;
+}
+declare function definePortal<T = unknown>(): Portal<T>;
+/**
+ * Reset the default portal state. Used by tests to ensure isolation.
+ * @internal
+ */
+declare function _resetDefaultPortal(): void;
+declare const DefaultPortal: Portal<unknown>;
+
+/**
+ * SSR Context Management
+ *
+ * Provides context for server-side rendering including:
+ * - SSRContext: Full context for sink-based streaming SSR
+ * - RenderContext: Lightweight context for sync render passes
+ */
 
 type SSRData = Record<string, unknown>;
+/** Lightweight context for synchronous render passes */
+type RenderContext = {
+    seed: number;
+};
+
+/**
+ * Shared SSR types
+ */
+
+/** VNode representation for SSR rendering */
+type VNode = {
+    type: string | SSRComponent;
+    props?: Props;
+    children?: unknown[];
+};
+/**
+ * Component function signature for SSR.
+ * Components receive props and an optional context with signal and SSR context.
+ */
+type SSRComponent = (props: Props, context?: {
+    signal?: AbortSignal;
+    ssr?: RenderContext;
+}) => VNode | JSXElement | string | number | boolean | null;
+
+/**
+ * SSR Data Management
+ *
+ * Manages render-phase keying for deterministic SSR data lookup.
+ * Note: SSR collection/prepass APIs have been removed — SSR is strictly synchronous.
+ */
 
 type ResourceDescriptor = {
     key: string;
@@ -379,11 +436,14 @@ type ResourceDescriptor = {
 type ResourcePlan = {
     resources: ResourceDescriptor[];
 };
+/** @deprecated SSR prepass has been removed */
 declare function resolvePlan(_plan: ResourcePlan): Promise<Record<string, unknown>>;
+/** @deprecated SSR prepass has been removed */
 declare function collectResources(_opts: {
     url: string;
     routes: SSRRoute[];
 }): ResourcePlan;
+/** @deprecated Alias for resolvePlan */
 declare const resolveResources: typeof resolvePlan;
 
 /**
@@ -395,11 +455,6 @@ declare const resolveResources: typeof resolvePlan;
  * when an async component or async resource is encountered during sync SSR.
  */
 
-type VNode = {
-    type: string;
-    props?: Props;
-    children?: (string | VNode | null | undefined | false)[];
-};
 /**
  * Single synchronous SSR entrypoint: render a component to an HTML string.
  * This is strictly synchronous and deterministic. Optionally provide a seed
@@ -443,4 +498,4 @@ declare function renderToStream(opts: {
     onComplete(): void;
 }): void;
 
-export { type Context, type DataResult, type HydrateSPAConfig, type IslandConfig, Link, type LinkProps, Props, type Route, type RouteHandler, type RouteMatch, type RouteSnapshot, type SPAConfig, type State, cleanupApp, clearRoutes, collectResources, createApp, createIsland, createSPA, defineContext, getLoadedNamespaces, getNamespaceRoutes, getRoutes, getSignal, hasApp, hydrateSPA, layout, navigate, readContext, renderToStream, renderToString, renderToStringSync, renderToStringSyncForUrl, resolveResources, resource, route, scheduleEventHandler, setServerLocation, state, unloadNamespace };
+export { type Context, type DataResult, DefaultPortal, type HydrateSPAConfig, type IslandConfig, type LayoutComponent, Link, type LinkProps, type Portal, Props, type Route, type RouteHandler, type RouteMatch, type RouteSnapshot, type SPAConfig, Slot, type SlotProps, type State, _resetDefaultPortal, cleanupApp, clearRoutes, collectResources, createIsland, createSPA, defineContext, definePortal, derive, getLoadedNamespaces, getNamespaceRoutes, getRoutes, getSignal, hasApp, hydrateSPA, layout, navigate, readContext, renderToStream, renderToString, renderToStringSync, renderToStringSyncForUrl, resolveResources, resource, route, scheduleEventHandler, setServerLocation, state, task, unloadNamespace };