@askrjs/askr 0.0.1 → 0.0.2

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;
@@ -145,6 +146,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 +199,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 +244,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 +271,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 +310,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 +323,6 @@ declare function navigate(path: string): void;
 /**
  * Link component for client-side navigation
  */
-
 interface LinkProps {
     href: string;
     children?: unknown;
@@ -364,7 +337,46 @@ 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: unknown;
+    [key: string]: unknown;
+} | {
+    asChild?: false;
+    children?: unknown;
+};
+declare function Slot(props: SlotProps): unknown;
+
+/**
+ * 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>;
 
 type SSRData = Record<string, unknown>;
 
@@ -443,4 +455,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, 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, 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;
@@ -145,6 +146,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 +199,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 +244,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 +271,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 +310,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 +323,6 @@ declare function navigate(path: string): void;
 /**
  * Link component for client-side navigation
  */
-
 interface LinkProps {
     href: string;
     children?: unknown;
@@ -364,7 +337,46 @@ 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: unknown;
+    [key: string]: unknown;
+} | {
+    asChild?: false;
+    children?: unknown;
+};
+declare function Slot(props: SlotProps): unknown;
+
+/**
+ * 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>;
 
 type SSRData = Record<string, unknown>;
 
@@ -443,4 +455,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, 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, 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 };