@askrjs/askr 0.0.4 → 0.0.5

package/dist/index.d.cts

@@ -1,168 +0,0 @@
-import { P as Props, J as JSXElement } from './jsx-AzPM8gMS.cjs';
-import { R as Route } from './router-DaGtH1Sq.cjs';
-
-/**
- * State primitive for Askr components
- * Optimized for minimal overhead and fast updates
- *
- * INVARIANTS ENFORCED:
- * - state() only callable during component render (currentInstance exists)
- * - state() called at top-level only (indices must be monotonically increasing)
- * - state values persist across re-renders (stored in stateValues array)
- * - state.set() cannot be called during render (causes infinite loops)
- * - state.set() always enqueues through scheduler (never direct mutation)
- * - state.set() callback (notifyUpdate) always available
- */
-
-/**
- * State value holder - callable to read, has set method to update
- * @example
- * const count = state(0);
- * count();           // read: 0
- * count.set(1);      // write: triggers re-render
- */
-interface State<T> {
-    (): T;
-    set(value: T): void;
-    set(updater: (prev: T) => T): void;
-    _hasBeenRead?: boolean;
-    _readers?: Map<ComponentInstance, number>;
-}
-/**
- * Creates a local state value for a component
- * Optimized for:
- * - O(1) read performance
- * - Minimal allocation per state
- * - Fast scheduler integration
- *
- * IMPORTANT: state() must be called during component render execution.
- * It captures the current component instance from context.
- * Calling outside a component function will throw an error.
- *
- * @example
- * ```ts
- * // ✅ Correct: called during render
- * export function Counter() {
- *   const count = state(0);
- *   return { type: 'button', children: [count()] };
- * }
- *
- * // ❌ Wrong: called outside component
- * const count = state(0);
- * export function BadComponent() {
- *   return { type: 'div' };
- * }
- * ```
- */
-declare function state<T>(initialValue: T): State<T>;
-
-/**
- * Common call contracts: Component signatures
- */
-
-type ComponentContext = {
-    signal: AbortSignal;
-};
-type ComponentVNode = {
-    type: string;
-    props?: Props;
-    children?: (string | ComponentVNode | null | undefined | false)[];
-};
-type ComponentFunction = (props: Props, context?: ComponentContext) => JSXElement | ComponentVNode | string | number | null;
-
-/**
- * Context system: lexical scope + render-time snapshots
- *
- * CORE SEMANTIC (Option A — Snapshot-Based):
- * ============================================
- * An async resource observes the context of the render that created it.
- * Context changes only take effect via re-render, not magically mid-await.
- *
- * This ensures:
- * - Deterministic behavior
- * - Concurrency safety
- * - Replayable execution
- * - Debuggability
- *
- * INVARIANTS:
- * - readContext() only works during component render (has currentContextFrame)
- * - Each render captures a context snapshot
- * - Async continuations see the snapshot from render start (frozen)
- * - Provider (Scope) creates a new frame that shadows parent
- * - Context updates require re-render to take effect
- */
-
-type ContextKey = symbol;
-interface ContextFrame {
-    parent: ContextFrame | null;
-    values: Map<ContextKey, unknown> | null;
-}
-
-/**
- * Component instance lifecycle management
- * Internal only — users never see this
- */
-
-interface ComponentInstance {
-    id: string;
-    fn: ComponentFunction;
-    props: Props;
-    target: Element | null;
-    mounted: boolean;
-    abortController: AbortController;
-    ssr?: boolean;
-    cleanupStrict?: boolean;
-    stateValues: State<unknown>[];
-    evaluationGeneration: number;
-    notifyUpdate: (() => void) | null;
-    _pendingFlushTask?: () => void;
-    _pendingRunTask?: () => void;
-    _enqueueRun?: () => void;
-    stateIndexCheck: number;
-    expectedStateIndices: number[];
-    firstRenderComplete: boolean;
-    mountOperations: Array<() => void | (() => void) | Promise<void | (() => void)>>;
-    cleanupFns: Array<() => void>;
-    hasPendingUpdate: boolean;
-    ownerFrame: ContextFrame | null;
-    isRoot?: boolean;
-    _currentRenderToken?: number;
-    lastRenderToken?: number;
-    _pendingReadStates?: Set<State<unknown>>;
-    _lastReadStates?: Set<State<unknown>>;
-    _placeholder?: Comment;
-}
-
-/**
- * App bootstrap and mount
- */
-
-type IslandConfig = {
-    root: Element | string;
-    component: ComponentFunction;
-    cleanupStrict?: boolean;
-    routes?: never;
-};
-type SPAConfig = {
-    root: Element | string;
-    routes: Route[];
-    cleanupStrict?: boolean;
-    component?: never;
-};
-/**
- * createIsland: Enhances existing DOM (no router, mounts once)
- */
-declare function createIsland(config: IslandConfig): void;
-/**
- * createSPA: Initializes router and mounts the app with provided route table
- */
-declare function createSPA(config: SPAConfig): Promise<void>;
-
-declare function derive<TOut>(fn: () => TOut): TOut | null;
-declare function derive<TIn, TOut>(source: {
-    value: TIn | null;
-    pending?: boolean;
-    error?: Error | null;
-} | TIn | (() => TIn), map: (value: TIn) => TOut): TOut | null;
-
-export { type IslandConfig, Props, type SPAConfig, type State, createIsland, createSPA, derive, state };

package/dist/jsx/jsx-dev-runtime.cjs

@@ -1,46 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/jsx/jsx-dev-runtime.ts
-var jsx_dev_runtime_exports = {};
-__export(jsx_dev_runtime_exports, {
-  Fragment: () => Fragment,
-  jsxDEV: () => jsxDEV
-});
-module.exports = __toCommonJS(jsx_dev_runtime_exports);
-
-// src/common/jsx.ts
-var ELEMENT_TYPE = /* @__PURE__ */ Symbol.for("askr.element");
-var Fragment = /* @__PURE__ */ Symbol.for("askr.fragment");
-
-// src/jsx/jsx-dev-runtime.ts
-function jsxDEV(type, props, key) {
-  return {
-    $$typeof: ELEMENT_TYPE,
-    type,
-    props: props ?? {},
-    key: key ?? null
-  };
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  Fragment,
-  jsxDEV
-});
-//# sourceMappingURL=jsx-dev-runtime.cjs.map

package/dist/jsx/jsx-dev-runtime.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/jsx/jsx-dev-runtime.ts","../../src/common/jsx.ts"],"sourcesContent":["/**\n * JSX dev runtime factory\n * Same element shape as production runtime, with room for dev warnings.\n */\n\nimport './types';\nimport { ELEMENT_TYPE, Fragment, JSXElement } from './types';\n\nexport function jsxDEV(\n  type: unknown,\n  props: Record<string, unknown> | null,\n  key?: string | number\n): JSXElement {\n  return {\n    $$typeof: ELEMENT_TYPE,\n    type,\n    props: props ?? {},\n    key: key ?? null,\n  };\n}\n\n// Re-export Fragment for JSX\nexport { Fragment };\n","/**\n * Common call contracts: JSX element shape\n */\n\nimport type { Props } from './props';\n\nexport const ELEMENT_TYPE = Symbol.for('askr.element');\nexport const Fragment = Symbol.for('askr.fragment');\n\nexport interface JSXElement {\n  /** Internal element marker (optional for plain vnode objects) */\n  $$typeof?: symbol;\n\n  /** Element type: string, component, Fragment, etc */\n  type: unknown;\n\n  /** Props bag */\n  props: Props;\n\n  /** Optional key (normalized by runtime) */\n  key?: string | number | null;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACMO,IAAM,eAAe,uBAAO,IAAI,cAAc;AAC9C,IAAM,WAAW,uBAAO,IAAI,eAAe;;;ADC3C,SAAS,OACd,MACA,OACA,KACY;AACZ,SAAO;AAAA,IACL,UAAU;AAAA,IACV;AAAA,IACA,OAAO,SAAS,CAAC;AAAA,IACjB,KAAK,OAAO;AAAA,EACd;AACF;","names":[]}

package/dist/jsx/jsx-dev-runtime.d.cts

@@ -1,12 +0,0 @@
-import '../types-CZ5sWur5.cjs';
-import { J as JSXElement } from '../jsx-AzPM8gMS.cjs';
-export { F as Fragment } from '../jsx-AzPM8gMS.cjs';
-
-/**
- * JSX dev runtime factory
- * Same element shape as production runtime, with room for dev warnings.
- */
-
-declare function jsxDEV(type: unknown, props: Record<string, unknown> | null, key?: string | number): JSXElement;
-
-export { jsxDEV };

package/dist/jsx/jsx-dev-runtime.js

@@ -1,19 +0,0 @@
-import {
-  ELEMENT_TYPE,
-  Fragment
-} from "../chunk-FJUXFA72.js";
-
-// src/jsx/jsx-dev-runtime.ts
-function jsxDEV(type, props, key) {
-  return {
-    $$typeof: ELEMENT_TYPE,
-    type,
-    props: props ?? {},
-    key: key ?? null
-  };
-}
-export {
-  Fragment,
-  jsxDEV
-};
-//# sourceMappingURL=jsx-dev-runtime.js.map

package/dist/jsx/jsx-dev-runtime.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/jsx/jsx-dev-runtime.ts"],"sourcesContent":["/**\n * JSX dev runtime factory\n * Same element shape as production runtime, with room for dev warnings.\n */\n\nimport './types';\nimport { ELEMENT_TYPE, Fragment, JSXElement } from './types';\n\nexport function jsxDEV(\n  type: unknown,\n  props: Record<string, unknown> | null,\n  key?: string | number\n): JSXElement {\n  return {\n    $$typeof: ELEMENT_TYPE,\n    type,\n    props: props ?? {},\n    key: key ?? null,\n  };\n}\n\n// Re-export Fragment for JSX\nexport { Fragment };\n"],"mappings":";;;;;;AAQO,SAAS,OACd,MACA,OACA,KACY;AACZ,SAAO;AAAA,IACL,UAAU;AAAA,IACV;AAAA,IACA,OAAO,SAAS,CAAC;AAAA,IACjB,KAAK,OAAO;AAAA,EACd;AACF;","names":[]}

package/dist/jsx/jsx-runtime.cjs

@@ -1,54 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/jsx/jsx-runtime.ts
-var jsx_runtime_exports = {};
-__export(jsx_runtime_exports, {
-  ELEMENT_TYPE: () => ELEMENT_TYPE,
-  Fragment: () => Fragment,
-  jsx: () => jsx,
-  jsxDEV: () => jsxDEV,
-  jsxs: () => jsxs
-});
-module.exports = __toCommonJS(jsx_runtime_exports);
-var ELEMENT_TYPE = /* @__PURE__ */ Symbol.for("askr.element");
-var Fragment = /* @__PURE__ */ Symbol.for("askr.fragment");
-function jsxDEV(type, props, key) {
-  return {
-    $$typeof: ELEMENT_TYPE,
-    type,
-    props: props ?? {},
-    key: key ?? null
-  };
-}
-function jsx(type, props, key) {
-  return jsxDEV(type, props, key);
-}
-function jsxs(type, props, key) {
-  return jsxDEV(type, props, key);
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  ELEMENT_TYPE,
-  Fragment,
-  jsx,
-  jsxDEV,
-  jsxs
-});
-//# sourceMappingURL=jsx-runtime.cjs.map

package/dist/jsx/jsx-runtime.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/jsx/jsx-runtime.ts"],"sourcesContent":["/**\n * JSX dev runtime\n * Same shape as production runtime, with room for dev warnings.\n */\n\nimport './types';\n\nexport const ELEMENT_TYPE = Symbol.for('askr.element');\nexport const Fragment = Symbol.for('askr.fragment');\n\nexport interface JSXElement {\n  $$typeof: symbol;\n  type: unknown;\n  props: Record<string, unknown>;\n  key: string | number | null;\n}\n\nexport function jsxDEV(\n  type: unknown,\n  props: Record<string, unknown> | null,\n  key?: string | number\n): JSXElement {\n  return {\n    $$typeof: ELEMENT_TYPE,\n    type,\n    props: props ?? {},\n    key: key ?? null,\n  };\n}\n\n// Production-style helpers: alias to the DEV factory for now\nexport function jsx(\n  type: unknown,\n  props: Record<string, unknown> | null,\n  key?: string | number\n) {\n  return jsxDEV(type, props, key);\n}\n\nexport function jsxs(\n  type: unknown,\n  props: Record<string, unknown> | null,\n  key?: string | number\n) {\n  return jsxDEV(type, props, key);\n}\n\n// `Fragment` is already exported above.\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAOO,IAAM,eAAe,uBAAO,IAAI,cAAc;AAC9C,IAAM,WAAW,uBAAO,IAAI,eAAe;AAS3C,SAAS,OACd,MACA,OACA,KACY;AACZ,SAAO;AAAA,IACL,UAAU;AAAA,IACV;AAAA,IACA,OAAO,SAAS,CAAC;AAAA,IACjB,KAAK,OAAO;AAAA,EACd;AACF;AAGO,SAAS,IACd,MACA,OACA,KACA;AACA,SAAO,OAAO,MAAM,OAAO,GAAG;AAChC;AAEO,SAAS,KACd,MACA,OACA,KACA;AACA,SAAO,OAAO,MAAM,OAAO,GAAG;AAChC;","names":[]}

package/dist/jsx/jsx-runtime.d.cts

@@ -1,21 +0,0 @@
-import '../types-CZ5sWur5.cjs';
-import '../jsx-AzPM8gMS.cjs';
-
-/**
- * JSX dev runtime
- * Same shape as production runtime, with room for dev warnings.
- */
-
-declare const ELEMENT_TYPE: unique symbol;
-declare const Fragment: unique symbol;
-interface JSXElement {
-    $$typeof: symbol;
-    type: unknown;
-    props: Record<string, unknown>;
-    key: string | number | null;
-}
-declare function jsxDEV(type: unknown, props: Record<string, unknown> | null, key?: string | number): JSXElement;
-declare function jsx(type: unknown, props: Record<string, unknown> | null, key?: string | number): JSXElement;
-declare function jsxs(type: unknown, props: Record<string, unknown> | null, key?: string | number): JSXElement;
-
-export { ELEMENT_TYPE, Fragment, type JSXElement, jsx, jsxDEV, jsxs };

package/dist/jsx/jsx-runtime.d.ts

@@ -1,21 +0,0 @@
-import '../types-CZHOAiC1.js';
-import '../jsx-AzPM8gMS.js';
-
-/**
- * JSX dev runtime
- * Same shape as production runtime, with room for dev warnings.
- */
-
-declare const ELEMENT_TYPE: unique symbol;
-declare const Fragment: unique symbol;
-interface JSXElement {
-    $$typeof: symbol;
-    type: unknown;
-    props: Record<string, unknown>;
-    key: string | number | null;
-}
-declare function jsxDEV(type: unknown, props: Record<string, unknown> | null, key?: string | number): JSXElement;
-declare function jsx(type: unknown, props: Record<string, unknown> | null, key?: string | number): JSXElement;
-declare function jsxs(type: unknown, props: Record<string, unknown> | null, key?: string | number): JSXElement;
-
-export { ELEMENT_TYPE, Fragment, type JSXElement, jsx, jsxDEV, jsxs };

package/dist/jsx/jsx-runtime.js

@@ -1,16 +0,0 @@
-import {
-  ELEMENT_TYPE,
-  Fragment,
-  jsx,
-  jsxDEV,
-  jsxs
-} from "../chunk-SALJX5PZ.js";
-import "../chunk-FJUXFA72.js";
-export {
-  ELEMENT_TYPE,
-  Fragment,
-  jsx,
-  jsxDEV,
-  jsxs
-};
-//# sourceMappingURL=jsx-runtime.js.map

package/dist/jsx/jsx-runtime.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/jsx-AzPM8gMS.d.cts

@@ -1,35 +0,0 @@
-/**
- * Common call contracts: Props
- *
- * This file holds structural types shared across multiple modules.
- */
-/**
- * Props accepted by components and elements.
- * Intentionally permissive but provides a single named type.
- */
-interface Props {
-    /** Optional key for keyed lists (string | number | symbol for internal frames) */
-    key?: string | number | symbol;
-    /** Optional children slot */
-    children?: unknown;
-    /** Allow additional arbitrary attributes (e.g., class, id, data-*) */
-    [attr: string]: unknown;
-}
-
-/**
- * Common call contracts: JSX element shape
- */
-
-declare const Fragment: unique symbol;
-interface JSXElement {
-    /** Internal element marker (optional for plain vnode objects) */
-    $$typeof?: symbol;
-    /** Element type: string, component, Fragment, etc */
-    type: unknown;
-    /** Props bag */
-    props: Props;
-    /** Optional key (normalized by runtime) */
-    key?: string | number | null;
-}
-
-export { Fragment as F, type JSXElement as J, type Props as P };

package/dist/navigate-LUVYHYZZ.js

@@ -1,17 +0,0 @@
-import {
-  cleanupNavigation,
-  initializeNavigation,
-  navigate,
-  registerAppInstance
-} from "./chunk-VRAEBIJ3.js";
-import "./chunk-Z5ZSTLYF.js";
-import "./chunk-XHKZGJE3.js";
-import "./chunk-SALJX5PZ.js";
-import "./chunk-FJUXFA72.js";
-export {
-  cleanupNavigation,
-  initializeNavigation,
-  navigate,
-  registerAppInstance
-};
-//# sourceMappingURL=navigate-LUVYHYZZ.js.map

package/dist/navigate-LUVYHYZZ.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}