@askrjs/askr 0.0.28 → 0.0.30

package/dist/common/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","names":[],"sources":["../../src/common/env.ts"],"sourcesContent":["export type RuntimeEnv = Record<string, string | undefined>;\n\ntype RuntimeEnvGlobal = typeof globalThis & {\n  process?: {\n    env?: RuntimeEnv;\n  };\n};\n\ntype BuildTimeEnv = Record<string, unknown> & {\n  NODE_ENV?: unknown;\n  MODE?: unknown;\n  PROD?: unknown;\n  DEV?: unknown;\n};\n\nfunction normalizeEnv(source?: Record<string, unknown>): RuntimeEnv {\n  if (!source) {\n    return {};\n  }\n\n  const normalized: RuntimeEnv = {};\n  for (const [key, value] of Object.entries(source)) {\n    if (typeof value === 'string') {\n      normalized[key] = value;\n    } else if (typeof value === 'boolean' || typeof value === 'number') {\n      normalized[key] = String(value);\n    }\n  }\n\n  return normalized;\n}\n\nfunction getBuildTimeEnv(): RuntimeEnv {\n  const metaEnv = (import.meta as ImportMeta & { env?: BuildTimeEnv }).env;\n  const normalized = normalizeEnv(metaEnv);\n\n  if (normalized.NODE_ENV == null && metaEnv) {\n    if (typeof metaEnv.MODE === 'string' && metaEnv.MODE.length > 0) {\n      normalized.NODE_ENV = metaEnv.MODE;\n    } else if (metaEnv.PROD === true || metaEnv.PROD === 'true') {\n      normalized.NODE_ENV = 'production';\n    } else if (metaEnv.DEV === true || metaEnv.DEV === 'true') {\n      normalized.NODE_ENV = 'development';\n    }\n  }\n\n  return normalized;\n}\n\nfunction resolveNodeEnv(\n  processNodeEnv: string | undefined,\n  buildNodeEnv: string | undefined\n): string | undefined {\n  if (buildNodeEnv === 'production') {\n    return 'production';\n  }\n\n  if (processNodeEnv != null) {\n    return processNodeEnv;\n  }\n\n  if (buildNodeEnv === 'development') {\n    return 'development';\n  }\n\n  return buildNodeEnv === 'test' ? undefined : buildNodeEnv;\n}\n\nexport function getRuntimeEnv(): RuntimeEnv {\n  const processEnv = (globalThis as RuntimeEnvGlobal).process?.env ?? {};\n  const buildTimeEnv = getBuildTimeEnv();\n\n  return {\n    ...processEnv,\n    ...buildTimeEnv,\n    NODE_ENV: resolveNodeEnv(processEnv.NODE_ENV, buildTimeEnv.NODE_ENV),\n  };\n}\n\nexport function isProductionEnvironment(): boolean {\n  return getRuntimeEnv().NODE_ENV === 'production';\n}\n\nexport function isDevelopmentEnvironment(): boolean {\n  return !isProductionEnvironment();\n}\n\nexport function isRuntimeEnvFlagEnabled(name: string): boolean {\n  const value = getRuntimeEnv()[name];\n  return value === '1' || value === 'true';\n}\n"],"mappings":";AAeA,SAAS,aAAa,QAA8C;AAClE,KAAI,CAAC,OACH,QAAO,EAAE;CAGX,MAAM,aAAyB,EAAE;AACjC,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,OAAO,CAC/C,KAAI,OAAO,UAAU,SACnB,YAAW,OAAO;UACT,OAAO,UAAU,aAAa,OAAO,UAAU,SACxD,YAAW,OAAO,OAAO,MAAM;AAInC,QAAO;;AAGT,SAAS,kBAA8B;CACrC,MAAM,UAAW,OAAO,KAA6C;CACrE,MAAM,aAAa,aAAa,QAAQ;AAExC,KAAI,WAAW,YAAY,QAAQ,SACjC;MAAI,OAAO,QAAQ,SAAS,YAAY,QAAQ,KAAK,SAAS,EAC5D,YAAW,WAAW,QAAQ;WACrB,QAAQ,SAAS,QAAQ,QAAQ,SAAS,OACnD,YAAW,WAAW;WACb,QAAQ,QAAQ,QAAQ,QAAQ,QAAQ,OACjD,YAAW,WAAW;;AAI1B,QAAO;;AAGT,SAAS,eACP,gBACA,cACoB;AACpB,KAAI,iBAAiB,aACnB,QAAO;AAGT,KAAI,kBAAkB,KACpB,QAAO;AAGT,KAAI,iBAAiB,cACnB,QAAO;AAGT,QAAO,iBAAiB,SAAS,SAAY;;AAG/C,SAAgB,gBAA4B;CAC1C,MAAM,aAAc,WAAgC,SAAS,OAAO,EAAE;CACtE,MAAM,eAAe,iBAAiB;AAEtC,QAAO;EACL,GAAG;EACH,GAAG;EACH,UAAU,eAAe,WAAW,UAAU,aAAa,SAAS;EACrE;;AAGH,SAAgB,0BAAmC;AACjD,QAAO,eAAe,CAAC,aAAa;;AAGtC,SAAgB,2BAAoC;AAClD,QAAO,CAAC,yBAAyB;;AAGnC,SAAgB,wBAAwB,MAAuB;CAC7D,MAAM,QAAQ,eAAe,CAAC;AAC9B,QAAO,UAAU,OAAO,UAAU"}

package/dist/common/jsx.d.ts

@@ -1,17 +1,19 @@
-/**
- * Common call contracts: JSX element shape
- */
-import type { Props } from './props';
-export declare const ELEMENT_TYPE: unique symbol;
-export declare const Fragment: unique symbol;
-export interface JSXElement {
-    /** Internal element marker */
-    $$typeof: symbol;
-    /** Element type: string, component, Fragment, etc */
-    type: string | ((props: Props) => unknown) | symbol;
-    /** Props bag */
-    props: Props;
-    /** Optional key (normalized by runtime) */
-    key?: string | number | null;
+import { Props } from "./props.js";
+
+//#region src/common/jsx.d.ts
+declare const ELEMENT_TYPE: unique symbol;
+declare const Fragment: unique symbol;
+declare const STATIC_CHILDREN: unique symbol;
+interface JSXElement {
+  /** Internal element marker */
+  $$typeof: symbol;
+  /** Element type: string, component, Fragment, etc */
+  type: string | ((props: Props) => unknown) | symbol;
+  /** Props bag */
+  props: Props;
+  /** Optional key (normalized by runtime) */
+  key?: string | number | null;
 }
+//#endregion
+export { Fragment, JSXElement };
 //# sourceMappingURL=jsx.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"jsx.d.ts","sourceRoot":"","sources":["../../src/common/jsx.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,eAAO,MAAM,YAAY,eAA6B,CAAC;AACvD,eAAO,MAAM,QAAQ,eAA8B,CAAC;AAEpD,MAAM,WAAW,UAAU;IACzB,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IAEjB,qDAAqD;IACrD,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,GAAG,MAAM,CAAC;IAEpD,gBAAgB;IAChB,KAAK,EAAE,KAAK,CAAC;IAEb,2CAA2C;IAC3C,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAC9B"}
+{"version":3,"file":"jsx.d.ts","names":[],"sources":["../../src/common/jsx.ts"],"mappings":";;;cAMa,YAAA;AAAA,cACA,QAAA;AAAA,cACA,eAAA;AAAA,UAEI,UAAA;EAHJ;EAKX,QAAA;;EAGA,IAAA,aAAiB,KAAA,EAAO,KAAA;EARyB;EAWjD,KAAA,EAAO,KAAA;EAVwD;EAa/D,GAAA;AAAA"}

package/dist/common/jsx.js

@@ -1 +1,8 @@
-const o=Symbol.for("askr.element"),r=Symbol.for("askr.fragment");export{o as ELEMENT_TYPE,r as Fragment};
+//#region src/common/jsx.ts
+const ELEMENT_TYPE = Symbol.for("askr.element");
+const Fragment = Symbol.for("askr.fragment");
+const STATIC_CHILDREN = Symbol.for("askr.static-children");
+//#endregion
+export { ELEMENT_TYPE, Fragment, STATIC_CHILDREN };
+
+//# sourceMappingURL=jsx.js.map

package/dist/common/jsx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx.js","names":[],"sources":["../../src/common/jsx.ts"],"sourcesContent":["/**\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');\nexport const STATIC_CHILDREN = Symbol.for('askr.static-children');\n\nexport interface JSXElement {\n  /** Internal element marker */\n  $$typeof: symbol;\n\n  /** Element type: string, component, Fragment, etc */\n  type: string | ((props: Props) => unknown) | symbol;\n\n  /** Props bag */\n  props: Props;\n\n  /** Optional key (normalized by runtime) */\n  key?: string | number | null;\n}\n"],"mappings":";AAMA,MAAa,eAAe,OAAO,IAAI,eAAe;AACtD,MAAa,WAAW,OAAO,IAAI,gBAAgB;AACnD,MAAa,kBAAkB,OAAO,IAAI,uBAAuB"}

package/dist/common/props.d.ts

@@ -1,3 +1,4 @@
+//#region src/common/props.d.ts
 /**
  * Common call contracts: Props
  *
@@ -7,17 +8,19 @@
  * Props accepted by components and elements.
  * Intentionally permissive but provides a single named type.
  */
-export 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;
+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;
 }
-export interface ComponentNode {
-    type: 'component' | 'element' | 'text';
-    value?: unknown;
-    children?: ComponentNode[];
+interface ComponentNode {
+  type: 'component' | 'element' | 'text';
+  value?: unknown;
+  children?: ComponentNode[];
 }
+//#endregion
+export { Props };
 //# sourceMappingURL=props.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../../src/common/props.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,WAAW,KAAK;IACpB,kFAAkF;IAClF,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAC/B,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sEAAsE;IACtE,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;CAC5B"}
+{"version":3,"file":"props.d.ts","names":[],"sources":["../../src/common/props.ts"],"mappings":";;AAUA;;;;;;;;UAAiB,KAAA;EASA;EAPf,GAAA;;EAEA,QAAA;EAMA;EAAA,CAJC,IAAA;AAAA;AAAA,UAGc,aAAA;EACf,IAAA;EACA,KAAA;EACA,QAAA,GAAW,aAAA;AAAA"}

package/dist/common/router.d.ts

@@ -1,39 +1,197 @@
+//#region src/common/router.d.ts
 /**
  * Common call contracts: Router types
  */
-export interface RouteHandler {
-    (params: Record<string, string>, context?: {
-        signal: AbortSignal;
-    }): unknown;
-}
-export interface Route {
-    path: string;
-    handler: RouteHandler;
-    namespace?: string;
-}
-export interface ResolvedRoute {
-    handler: RouteHandler;
+/**
+ * A route page component: a regular component that receives route params as
+ * props (always `Record<string, string>` derived from the URL pattern).
+ *
+ * Components may accept no params at all — `() => unknown` is assignable.
+ */
+type RouteComponent = (props: Record<string, string>) => unknown;
+type RouteMode = 'spa' | 'ssr' | 'ssg';
+type RouteAuthMode = true | 'guest';
+type AccessRedirectStatus = 301 | 302 | 303 | 307 | 308;
+type AccessDenyStatus = 401 | 403 | 404;
+interface AccessAllowDecision {
+  kind: 'allow';
+}
+interface AccessRedirectDecision {
+  kind: 'redirect';
+  to: string;
+  status?: AccessRedirectStatus;
+  replace?: boolean;
+}
+interface AccessDenyDecision {
+  kind: 'deny';
+  status: AccessDenyStatus;
+}
+type AccessDecision = AccessAllowDecision | AccessRedirectDecision | AccessDenyDecision;
+interface RouteContext<Session = unknown, User = unknown> {
+  mode: RouteMode;
+  params: Record<string, string>;
+  pathname: string;
+  search: string;
+  hash: string;
+  href: string;
+  session: Session | null;
+  user: User | null;
+  signal: AbortSignal;
+}
+type RoutePolicy = (context: RouteContext) => AccessDecision | Promise<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>>;
+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>;
+}
+interface CommonAccessOptions {
+  auth?: RouteAuthMode;
+  role?: string;
+  permission?: string;
+  policies?: readonly RoutePolicy[];
+}
+/**
+ * Options for `route()` declarations.
+ *
+ * - `loader`: server data loader called before render, result passed as SSR data
+ * - `entries`: SSG entry generator — returns one param map per static page
+ * - `title`: page title hint used by SSG and document-meta integrations
+ * - `namespace`: MFE namespace key for grouped route management
+ */
+interface RouteOptions extends CommonAccessOptions {
+  loader?: (context: {
     params: Record<string, string>;
+  }) => unknown;
+  entries?: () => Array<Record<string, string>> | Promise<Array<Record<string, string>>>;
+  title?: string;
+  namespace?: string;
+}
+/**
+ * A single parsed segment from a route path.
+ *
+ * - `static`:   a literal path segment, e.g. `"users"` in `/users/{id}`
+ * - `param`:    a `{name}` capture group — `value` holds the param name
+ * - `wildcard`: a bare `*` segment that captures exactly one segment
+ * - `catchall`: the `/*` catch-all that matches any depth
+ */
+interface ParsedSegment {
+  kind: 'static' | 'param' | 'wildcard' | 'catchall';
+  /** For static/wildcard/catchall: the literal text; for param: the param name. */
+  value: string;
+}
+/** Resolved layout component as stored in a route record's layout chain. */
+interface LayoutScopeRecord {
+  component: (props: {
+    children?: unknown;
+  }) => unknown;
+}
+interface RegisterRoutesOptions {
+  auth?: RouteAuthOptions;
+}
+type RouteDefinition = () => void;
+interface RouteRequestOptions {
+  manifest?: RouteManifest;
+  mode?: RouteMode;
+  auth?: RouteAuthOptions;
+  signal?: AbortSignal;
+}
+interface RouteRenderResult {
+  kind: 'render';
+  handler: RouteHandler;
+  params: Record<string, string>;
+}
+type RouteRequestResult = RouteRenderResult | AccessRedirectDecision | AccessDenyDecision | null;
+interface GroupHelperOptions extends CommonAccessOptions {
+  layout?: (props: {
+    children?: unknown;
+  }) => unknown;
+}
+/**
+ * A fully normalized route record produced by `route(path, Component, options?)`.
+ *
+ * This is the canonical representation shared by:
+ *   - SPA matching and navigation
+ *   - SSR request resolution
+ *   - SSG manifest expansion
+ */
+interface RouteRecord {
+  /** Canonical normalized absolute path, e.g. `/posts/{slug}` */
+  path: string;
+  /** The page component to render when this route is active */
+  component: RouteComponent;
+  /** Pre-parsed segment list for fast matching and typed param extraction */
+  segments: ParsedSegment[];
+  /** Pre-computed specificity rank (higher = more specific) */
+  rank: number;
+  /** Layout chain from outermost to innermost, applied automatically on render */
+  layoutChain: LayoutScopeRecord[];
+  /** Route metadata: loader, entries, policies, title, namespace */
+  options: RouteOptions;
+  /** True when this is the `/*` catch-all fallback route */
+  isFallback: boolean;
+  /**
+   * Runtime-ready handler with layout composition baked in.
+   * Compatible with the low-level `RouteHandler` signature so that navigation
+   * and SSR rendering do not need to know about layout chains.
+   */
+  handler: RouteHandler;
+}
+/**
+ * The normalized route manifest produced by registered route definitions.
+ * declarations.  Pass it to `createSPA`, `hydrateSPA`, or `renderToString`
+ * instead of assembling plain `Route[]` arrays.
+ *
+ * ```ts
+ * import { getManifest } from '@askrjs/askr/router';
+ * await createSPA({ root: '#app', manifest: getManifest() });
+ * ```
+ */
+interface RouteManifest {
+  records: RouteRecord[];
+  auth?: RouteAuthOptions;
+}
+interface RouteHandler {
+  (params: Record<string, string>, context?: {
+    signal: AbortSignal;
+  }): unknown;
+}
+interface Route {
+  path: string;
+  handler: RouteHandler;
+  namespace?: string;
+}
+interface ResolvedRoute {
+  handler: RouteHandler;
+  params: Record<string, string>;
+}
+interface RouteMatch {
+  path: string;
+  params: Readonly<Record<string, string>>;
+  name?: string;
+  namespace?: string;
+}
+interface RouteQuery {
+  get(key: string): string | null;
+  getAll(key: string): string[];
+  has(key: string): boolean;
+  toJSON(): Record<string, string | string[]>;
 }
-export interface RouteMatch {
-    path: string;
-    params: Readonly<Record<string, string>>;
-    name?: string;
-    namespace?: string;
-}
-export interface RouteQuery {
-    get(key: string): string | null;
-    getAll(key: string): string[];
-    has(key: string): boolean;
-    toJSON(): Record<string, string | string[]>;
-}
-export interface RouteSnapshot {
-    path: string;
-    params: Readonly<Record<string, string>>;
-    query: Readonly<RouteQuery>;
-    hash: string | null;
-    name?: string;
-    namespace?: string;
-    matches: readonly RouteMatch[];
+interface RouteSnapshot {
+  path: string;
+  params: Readonly<Record<string, string>>;
+  query: Readonly<RouteQuery>;
+  hash: string | null;
+  name?: string;
+  namespace?: string;
+  matches: readonly RouteMatch[];
 }
+//#endregion
+export { AccessDecision, AccessDenyDecision, AccessDenyStatus, AccessRedirectDecision, AccessRedirectStatus, GroupHelperOptions, LayoutScopeRecord, ParsedSegment, RegisterRoutesOptions, ResolvedRoute, Route, RouteAuthMode, RouteAuthOptions, RouteAuthResolver, RouteAuthState, RouteComponent, RouteContext, RouteDefinition, RouteHandler, RouteManifest, RouteMatch, RouteMode, RouteOptions, 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","sourceRoot":"","sources":["../../src/common/router.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,YAAY;IAC3B,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC;CAC9E;AAED,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAChC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC9B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACzC,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC5B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;CAChC"}
+{"version":3,"file":"router.d.ts","names":[],"sources":["../../src/common/router.ts"],"mappings":"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"}

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

@@ -1,8 +1,11 @@
+//#region src/common/ssr-errors.d.ts
 /**
  * Common call contracts: SSR error types
  */
-export declare class SSRDataMissingError extends Error {
-    readonly code = "SSR_DATA_MISSING";
-    constructor(message?: string);
+declare class SSRDataMissingError extends Error {
+  readonly code = "SSR_DATA_MISSING";
+  constructor(message?: string);
 }
+//#endregion
+export { SSRDataMissingError };
 //# sourceMappingURL=ssr-errors.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ssr-errors.d.ts","sourceRoot":"","sources":["../../src/common/ssr-errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,sBAAsB;gBAEjC,OAAO,SAAkI;CAM5I"}
+{"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"}

package/dist/common/ssr-errors.js

@@ -1 +1,16 @@
-class e extends Error{constructor(t="Server-side rendering requires all data to be available synchronously. This component attempted to use async data during SSR."){super(t),this.code="SSR_DATA_MISSING",this.name="SSRDataMissingError",Object.setPrototypeOf(this,e.prototype)}}export{e as SSRDataMissingError};
+//#region src/common/ssr-errors.ts
+/**
+* Common call contracts: SSR error types
+*/
+var SSRDataMissingError = class SSRDataMissingError extends Error {
+	constructor(message = "Server-side rendering requires all data to be available synchronously. This component attempted to use async data during SSR.") {
+		super(message);
+		this.code = "SSR_DATA_MISSING";
+		this.name = "SSRDataMissingError";
+		Object.setPrototypeOf(this, SSRDataMissingError.prototype);
+	}
+};
+//#endregion
+export { SSRDataMissingError };
+
+//# sourceMappingURL=ssr-errors.js.map

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

@@ -0,0 +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;AACA,QAAM,QAAQ;cAJA;AAKd,OAAK,OAAO;AACZ,SAAO,eAAe,MAAM,oBAAoB,UAAU"}

package/dist/common/ssr.d.ts

@@ -1,17 +1,20 @@
+//#region src/common/ssr.d.ts
 /**
  * Common call contracts: SSR types
  */
-export type SSRData = Record<string, unknown>;
+type SSRData = Record<string, unknown>;
 /** Full context for sink-based streaming SSR */
-export type SSRContext = {
-    url: string;
-    seed: number;
-    data?: SSRData;
-    params?: Record<string, string>;
-    signal?: AbortSignal;
+type SSRContext = {
+  url: string;
+  seed: number;
+  data?: SSRData;
+  params?: Record<string, string>;
+  signal?: AbortSignal;
 };
 /** Lightweight context for synchronous render passes */
-export type RenderContext = {
-    seed: number;
+type RenderContext = {
+  seed: number;
 };
+//#endregion
+export { SSRData };
 //# sourceMappingURL=ssr.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ssr.d.ts","sourceRoot":"","sources":["../../src/common/ssr.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE9C,gDAAgD;AAChD,MAAM,MAAM,UAAU,GAAG;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,wDAAwD;AACxD,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd,CAAC"}
+{"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"}

package/dist/common/vnode.d.ts

@@ -1,17 +1,19 @@
-/**
- * Common call contracts: VNode / virtual DOM shapes
- */
-import type { Props } from './props';
-import type { ForState } from '../runtime/for';
-export interface DOMElement {
-    type: string | ((props: Props) => any) | symbol;
-    props?: Props;
-    children?: VNode[];
-    key?: string | number | null;
-    [Symbol.iterator]?: never;
-    _forState?: ForState<unknown>;
+import { Props } from "./props.js";
+import { ForState } from "../runtime/for.js";
+import { ControlBoundaryState } from "../runtime/control.js";
+//#region src/common/vnode.d.ts
+interface DOMElement {
+  type: string | ((props: Props) => any) | symbol;
+  props?: Props;
+  children?: VNode[];
+  key?: string | number | null;
+  [Symbol.iterator]?: never;
+  _controlState?: ControlBoundaryState;
+  _forState?: ForState<unknown>;
 }
-export declare const __FOR_BOUNDARY__: unique symbol;
-export type VNode = DOMElement | string | number | boolean | null | undefined;
-export declare function _isDOMElement(node: unknown): node is DOMElement;
+type VNode = DOMElement | string | number | boolean | null | undefined;
+declare const __FOR_BOUNDARY__: symbol;
+declare function _isDOMElement(node: unknown): node is DOMElement;
+//#endregion
+export { VNode };
 //# sourceMappingURL=vnode.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"vnode.d.ts","sourceRoot":"","sources":["../../src/common/vnode.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,WAAW,UAAU;IAKzB,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC;IAChD,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC7B,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,CAAC;IAC1B,SAAS,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;CAC/B;AAGD,eAAO,MAAM,gBAAgB,eAA6B,CAAC;AAG3D,MAAM,MAAM,KAAK,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;AAE9E,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,UAAU,CAE/D"}
+{"version":3,"file":"vnode.d.ts","names":[],"sources":["../../src/common/vnode.ts"],"mappings":";;;;UAUiB,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"}

package/dist/common/vnode.js

@@ -1 +1,10 @@
-const t=Symbol("__FOR_BOUNDARY__");function e(_){return typeof _=="object"&&_!==null&&"type"in _}export{t as __FOR_BOUNDARY__,e as _isDOMElement};
+import { __CONTROL_BOUNDARY__ } from "./control.js";
+//#region src/common/vnode.ts
+const __FOR_BOUNDARY__ = __CONTROL_BOUNDARY__;
+function _isDOMElement(node) {
+	return typeof node === "object" && node !== null && "type" in node;
+}
+//#endregion
+export { __FOR_BOUNDARY__, _isDOMElement };
+
+//# sourceMappingURL=vnode.js.map

package/dist/common/vnode.js.map

@@ -0,0 +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 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":";;AA6BA,MAAa,mBAAmB;AAEhC,SAAgB,cAAc,MAAmC;AAC/D,QAAO,OAAO,SAAS,YAAY,SAAS,QAAQ,UAAU"}

package/dist/components/link.d.ts

@@ -1,30 +1,31 @@
+//#region src/components/link.d.ts
 /**
  * Link component for client-side navigation
  */
-export interface LinkProps {
-    href: string;
-    class?: string;
-    children?: unknown;
-    /**
-     * Optional rel attribute for link relationships.
-     * Common values: "noopener", "noreferrer", "nofollow"
-     */
-    rel?: string;
-    /**
-     * Optional target attribute.
-     * Use "_blank" for new tab/window.
-     */
-    target?: string;
-    /**
-     * Optional aria-current attribute for indicating current page/location.
-     * Use "page" for the current page in navigation.
-     */
-    'aria-current'?: 'page' | 'step' | 'location' | 'date' | 'time' | 'true' | 'false';
-    /**
-     * Optional aria-label for accessibility when link text isn't descriptive enough.
-     */
-    'aria-label'?: string;
-}
+type LinkProps = Omit<JSX.IntrinsicElements['a'], 'children' | 'href' | 'class' | 'rel' | 'target' | 'aria-current' | 'aria-label'> & {
+  href: string;
+  class?: string;
+  children?: unknown;
+  /**
+   * Optional rel attribute for link relationships.
+   * Common values: "noopener", "noreferrer", "nofollow"
+   */
+  rel?: string;
+  /**
+   * Optional target attribute.
+   * Use "_blank" for new tab/window.
+   */
+  target?: string;
+  /**
+   * Optional aria-current attribute for indicating current page/location.
+   * Use "page" for the current page in navigation.
+   */
+  'aria-current'?: 'page' | 'step' | 'location' | 'date' | 'time' | 'true' | 'false';
+  /**
+   * Optional aria-label for accessibility when link text isn't descriptive enough.
+   */
+  'aria-label'?: string;
+};
 /**
  * Link component that prevents default navigation and uses navigate()
  * Provides declarative way to navigate between routes
@@ -52,5 +53,16 @@ export interface LinkProps {
  * - Keyboard handling automatic
  * - Composable via mergeProps
  */
-export declare function Link({ href, class: className, children, rel, target, 'aria-current': ariaCurrent, 'aria-label': ariaLabel, }: LinkProps): JSX.Element;
+declare function Link({
+  href,
+  class: className,
+  children,
+  rel,
+  target,
+  'aria-current': ariaCurrent,
+  'aria-label': ariaLabel,
+  ...rest
+}: LinkProps): JSX.Element;
+//#endregion
+export { Link, LinkProps };
 //# sourceMappingURL=link.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../../src/components/link.tsx"],"names":[],"mappings":"AAAA;;GAEG;AAOH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,cAAc,CAAC,EACX,MAAM,GACN,MAAM,GACN,UAAU,GACV,MAAM,GACN,MAAM,GACN,MAAM,GACN,OAAO,CAAC;IACZ;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,IAAI,CAAC,EACnB,IAAI,EACJ,KAAK,EAAE,SAAS,EAChB,QAAQ,EACR,GAAG,EACH,MAAM,EACN,cAAc,EAAE,WAAW,EAC3B,YAAY,EAAE,SAAS,GACxB,EAAE,SAAS,GAAG,GAAG,CAAC,OAAO,CA0CzB"}
+{"version":3,"file":"link.d.ts","names":[],"sources":["../../src/components/link.tsx"],"mappings":";;AAQA;;KAAY,SAAA,GAAY,IAAA,CACtB,GAAA,CAAI,iBAAA;EASJ,IAAA;EACA,KAAA;EACA,QAAA;EAXI;;;;EAgBJ,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,GAAA,CAAI,OAAA"}