@vesk/compiler 0.1.1 → 0.2.8

package/dist/typecheck.d.ts

@@ -9,6 +9,8 @@ export interface TypecheckError {
     code: string;
     message: string;
 }
+export declare const AMBIENT = "\ndeclare namespace JSX {\n  type VeskEventHandler<E extends Event = Event> = (event: E) => void;\n  interface VeskCommonAttributes {\n    key?: string | number;\n    class?: string;\n    id?: string;\n    style?: string;\n    title?: string;\n    hidden?: boolean | string;\n    lang?: string;\n    dir?: 'ltr' | 'rtl' | 'auto';\n    tabIndex?: number;\n    role?: string;\n  }\n  interface VeskEventAttributes {\n    onClick?: VeskEventHandler<MouseEvent>;\n    onDblClick?: VeskEventHandler<MouseEvent>;\n    onMouseDown?: VeskEventHandler<MouseEvent>;\n    onMouseUp?: VeskEventHandler<MouseEvent>;\n    onMouseEnter?: VeskEventHandler<MouseEvent>;\n    onMouseLeave?: VeskEventHandler<MouseEvent>;\n    onMouseMove?: VeskEventHandler<MouseEvent>;\n    onKeyDown?: VeskEventHandler<KeyboardEvent>;\n    onKeyUp?: VeskEventHandler<KeyboardEvent>;\n    onFocus?: VeskEventHandler<FocusEvent>;\n    onBlur?: VeskEventHandler<FocusEvent>;\n    onInput?: VeskEventHandler<InputEvent>;\n    onChange?: VeskEventHandler<Event>;\n    onSubmit?: VeskEventHandler<SubmitEvent>;\n    onScroll?: VeskEventHandler<UIEvent>;\n    onWheel?: VeskEventHandler<WheelEvent>;\n    // Lowercase aliases \u2014 HTML attribute names are case-insensitive and real\n    // code writes onclick=/oninput=. Keep in sync with the camelCase members.\n    onclick?: VeskEventHandler<MouseEvent>;\n    ondblclick?: VeskEventHandler<MouseEvent>;\n    onmousedown?: VeskEventHandler<MouseEvent>;\n    onmouseup?: VeskEventHandler<MouseEvent>;\n    onmouseenter?: VeskEventHandler<MouseEvent>;\n    onmouseleave?: VeskEventHandler<MouseEvent>;\n    onmousemove?: VeskEventHandler<MouseEvent>;\n    onkeydown?: VeskEventHandler<KeyboardEvent>;\n    onkeyup?: VeskEventHandler<KeyboardEvent>;\n    onfocus?: VeskEventHandler<FocusEvent>;\n    onblur?: VeskEventHandler<FocusEvent>;\n    oninput?: VeskEventHandler<InputEvent>;\n    onchange?: VeskEventHandler<Event>;\n    onsubmit?: VeskEventHandler<SubmitEvent>;\n  }\n  type Component = string | number | boolean | null | undefined | Component[];\n  interface VeskGlobalAttributes extends VeskCommonAttributes, VeskEventAttributes {\n    children?: Component;\n  }\n  interface VeskAnchorAttributes extends VeskGlobalAttributes {\n    href?: string;\n    target?: string;\n    rel?: string;\n    download?: string | boolean;\n    type?: string;\n    hreflang?: string;\n  }\n  interface VeskMediaAttributes extends VeskGlobalAttributes {\n    src?: string;\n    width?: string | number;\n    height?: string | number;\n  }\n  interface VeskInputAttributes extends VeskGlobalAttributes {\n    type?: string;\n    name?: string;\n    value?: string | number | readonly string[];\n    placeholder?: string;\n    checked?: boolean | string;\n    disabled?: boolean | string;\n    readOnly?: boolean | string;\n    required?: boolean | string;\n    min?: string | number;\n    max?: string | number;\n    step?: string | number;\n    pattern?: string;\n    autoComplete?: string;\n    autoFocus?: boolean | string;\n    multiple?: boolean | string;\n    accept?: string;\n    size?: number;\n    list?: string;\n  }\n  interface IntrinsicElements {\n    html?: VeskGlobalAttributes & { manifest?: string };\n    head?: VeskGlobalAttributes;\n    body?: VeskGlobalAttributes;\n    div?: VeskGlobalAttributes;\n    span?: VeskGlobalAttributes;\n    p?: VeskGlobalAttributes;\n    h1?: VeskGlobalAttributes;\n    h2?: VeskGlobalAttributes;\n    h3?: VeskGlobalAttributes;\n    h4?: VeskGlobalAttributes;\n    h5?: VeskGlobalAttributes;\n    h6?: VeskGlobalAttributes;\n    a?: VeskAnchorAttributes;\n    nav?: VeskGlobalAttributes;\n    header?: VeskGlobalAttributes;\n    footer?: VeskGlobalAttributes;\n    main?: VeskGlobalAttributes;\n    section?: VeskGlobalAttributes;\n    article?: VeskGlobalAttributes;\n    aside?: VeskGlobalAttributes;\n    button?: VeskGlobalAttributes & {\n      type?: 'button' | 'submit' | 'reset';\n      disabled?: boolean | string;\n      name?: string;\n      value?: string | number;\n    };\n    form?: VeskGlobalAttributes & {\n      action?: string;\n      method?: 'get' | 'post';\n      target?: string;\n      encType?: string;\n      noValidate?: boolean | string;\n      name?: string;\n      autoComplete?: string;\n    };\n    input?: VeskInputAttributes;\n    textarea?: VeskGlobalAttributes & {\n      rows?: number;\n      cols?: number;\n      placeholder?: string;\n      value?: string | number;\n      disabled?: boolean | string;\n      readOnly?: boolean | string;\n      required?: boolean | string;\n      name?: string;\n    };\n    select?: VeskGlobalAttributes & {\n      name?: string;\n      value?: string | number | readonly string[];\n      disabled?: boolean | string;\n      required?: boolean | string;\n      multiple?: boolean | string;\n      size?: number;\n      autoComplete?: string;\n    };\n    option?: VeskGlobalAttributes & {\n      value?: string | number;\n      selected?: boolean | string;\n      disabled?: boolean | string;\n      label?: string;\n    };\n    optgroup?: VeskGlobalAttributes & { label?: string; disabled?: boolean | string };\n    label?: VeskGlobalAttributes & { htmlFor?: string };\n    fieldset?: VeskGlobalAttributes & { disabled?: boolean | string; name?: string; form?: string };\n    legend?: VeskGlobalAttributes;\n    datalist?: VeskGlobalAttributes;\n    img?: VeskGlobalAttributes & {\n      src?: string;\n      alt?: string;\n      width?: string | number;\n      height?: string | number;\n      srcSet?: string;\n      sizes?: string;\n      loading?: 'eager' | 'lazy';\n      decoding?: 'sync' | 'async' | 'auto';\n    };\n    picture?: VeskGlobalAttributes;\n    source?: VeskGlobalAttributes & { src?: string; srcSet?: string; sizes?: string; media?: string; type?: string };\n    video?: VeskMediaAttributes & {\n      controls?: boolean | string;\n      autoPlay?: boolean | string;\n      loop?: boolean | string;\n      muted?: boolean | string;\n      preload?: 'none' | 'metadata' | 'auto' | '';\n      poster?: string;\n      playsInline?: boolean | string;\n    };\n    audio?: VeskGlobalAttributes & {\n      src?: string;\n      controls?: boolean | string;\n      autoPlay?: boolean | string;\n      loop?: boolean | string;\n      muted?: boolean | string;\n      preload?: 'none' | 'metadata' | 'auto' | '';\n    };\n    track?: VeskGlobalAttributes & {\n      src?: string;\n      kind?: string;\n      srclang?: string;\n      label?: string;\n      default?: boolean | string;\n    };\n    canvas?: VeskGlobalAttributes & { width?: number; height?: number };\n    iframe?: VeskGlobalAttributes & {\n      src?: string;\n      srcDoc?: string;\n      width?: string | number;\n      height?: string | number;\n      allow?: string;\n      loading?: 'eager' | 'lazy';\n      sandbox?: string;\n      allowFullScreen?: boolean | string;\n      referrerPolicy?: string;\n    };\n    embed?: VeskGlobalAttributes & { src?: string; type?: string; width?: string | number; height?: string | number };\n    object?: VeskGlobalAttributes & { data?: string; type?: string; name?: string; width?: string | number; height?: string | number };\n    table?: VeskGlobalAttributes;\n    caption?: VeskGlobalAttributes;\n    thead?: VeskGlobalAttributes;\n    tbody?: VeskGlobalAttributes;\n    tfoot?: VeskGlobalAttributes;\n    tr?: VeskGlobalAttributes;\n    th?: VeskGlobalAttributes & { colSpan?: number; rowSpan?: number; scope?: string; headers?: string };\n    td?: VeskGlobalAttributes & { colSpan?: number; rowSpan?: number; headers?: string };\n    col?: VeskGlobalAttributes & { span?: number };\n    colgroup?: VeskGlobalAttributes & { span?: number };\n    ul?: VeskGlobalAttributes;\n    ol?: VeskGlobalAttributes & { start?: number; reversed?: boolean | string; type?: string };\n    li?: VeskGlobalAttributes & { value?: number };\n    dl?: VeskGlobalAttributes;\n    dt?: VeskGlobalAttributes;\n    dd?: VeskGlobalAttributes;\n    br?: VeskGlobalAttributes;\n    hr?: VeskGlobalAttributes;\n    pre?: VeskGlobalAttributes;\n    code?: VeskGlobalAttributes;\n    blockquote?: VeskGlobalAttributes & { cite?: string };\n    q?: VeskGlobalAttributes & { cite?: string };\n    strong?: VeskGlobalAttributes;\n    em?: VeskGlobalAttributes;\n    small?: VeskGlobalAttributes;\n    s?: VeskGlobalAttributes;\n    cite?: VeskGlobalAttributes;\n    dfn?: VeskGlobalAttributes;\n    abbr?: VeskGlobalAttributes & { title?: string };\n    time?: VeskGlobalAttributes & { dateTime?: string };\n    data?: VeskGlobalAttributes & { value?: string | number };\n    mark?: VeskGlobalAttributes;\n    del?: VeskGlobalAttributes & { cite?: string; dateTime?: string };\n    ins?: VeskGlobalAttributes & { cite?: string; dateTime?: string };\n    sub?: VeskGlobalAttributes;\n    sup?: VeskGlobalAttributes;\n    u?: VeskGlobalAttributes;\n    kbd?: VeskGlobalAttributes;\n    samp?: VeskGlobalAttributes;\n    var?: VeskGlobalAttributes;\n    figure?: VeskGlobalAttributes;\n    figcaption?: VeskGlobalAttributes;\n    details?: VeskGlobalAttributes & { open?: boolean | string };\n    summary?: VeskGlobalAttributes;\n    dialog?: VeskGlobalAttributes & { open?: boolean | string };\n    menu?: VeskGlobalAttributes;\n    address?: VeskGlobalAttributes;\n    b?: VeskGlobalAttributes;\n    i?: VeskGlobalAttributes;\n    ruby?: VeskGlobalAttributes;\n    rt?: VeskGlobalAttributes;\n    rp?: VeskGlobalAttributes;\n    bdi?: VeskGlobalAttributes;\n    bdo?: VeskGlobalAttributes;\n    wbr?: VeskGlobalAttributes;\n    area?: VeskGlobalAttributes & {\n      coords?: string;\n      shape?: string;\n      href?: string;\n      target?: string;\n      alt?: string;\n    };\n    map?: VeskGlobalAttributes & { name?: string };\n    noscript?: VeskGlobalAttributes;\n    template?: VeskGlobalAttributes;\n    slot?: VeskGlobalAttributes & { name?: string };\n    meta?: VeskGlobalAttributes & { name?: string; content?: string; charSet?: string; httpEquiv?: string };\n    title?: VeskGlobalAttributes;\n    base?: VeskGlobalAttributes & { href?: string; target?: string };\n    link?: VeskGlobalAttributes & {\n      rel?: string;\n      href?: string;\n      sizes?: string;\n      media?: string;\n      as?: string;\n      crossOrigin?: string;\n      integrity?: string;\n      type?: string;\n    };\n    style?: VeskGlobalAttributes & { media?: string };\n    script?: VeskGlobalAttributes & {\n      src?: string;\n      async?: boolean | string;\n      defer?: boolean | string;\n      type?: string;\n      crossOrigin?: string;\n      integrity?: string;\n      nonce?: string;\n      noModule?: boolean | string;\n    };\n    svg?: VeskGlobalAttributes & {\n      viewBox?: string;\n      xmlns?: string;\n      width?: string | number;\n      height?: string | number;\n      fill?: string;\n      stroke?: string;\n      strokeWidth?: string | number;\n    };\n    g?: VeskGlobalAttributes & { transform?: string; fill?: string; stroke?: string; strokeWidth?: string | number };\n    path?: VeskGlobalAttributes & {\n      d?: string;\n      fill?: string;\n      stroke?: string;\n      strokeWidth?: string | number;\n      fillRule?: string;\n      clipRule?: string;\n    };\n    circle?: VeskGlobalAttributes & {\n      cx?: string | number;\n      cy?: string | number;\n      r?: string | number;\n      fill?: string;\n      stroke?: string;\n      strokeWidth?: string | number;\n    };\n    ellipse?: VeskGlobalAttributes & {\n      cx?: string | number;\n      cy?: string | number;\n      rx?: string | number;\n      ry?: string | number;\n      fill?: string;\n    };\n    rect?: VeskGlobalAttributes & {\n      x?: string | number;\n      y?: string | number;\n      width?: string | number;\n      height?: string | number;\n      rx?: string | number;\n      ry?: string | number;\n      fill?: string;\n    };\n    line?: VeskGlobalAttributes & {\n      x1?: string | number;\n      y1?: string | number;\n      x2?: string | number;\n      y2?: string | number;\n      stroke?: string;\n      strokeWidth?: string | number;\n    };\n    polyline?: VeskGlobalAttributes & { points?: string; fill?: string; stroke?: string };\n    polygon?: VeskGlobalAttributes & { points?: string; fill?: string; stroke?: string };\n    text?: VeskGlobalAttributes & { x?: string | number; y?: string | number; fill?: string; fontSize?: string | number };\n    defs?: VeskGlobalAttributes;\n    linearGradient?: VeskGlobalAttributes;\n    radialGradient?: VeskGlobalAttributes;\n    stop?: VeskGlobalAttributes & { offset?: string | number; stopColor?: string; stopOpacity?: string | number };\n\n    // Unknown/custom tags stay permissive \u2014 components and web components\n    // resolve through the index signature, known tags get the typed members.\n    [elemName: string]: unknown;\n  }\n  type Component = string | number | boolean | null | undefined | Component[];\n}\ndeclare type Component = string | number | boolean | null | undefined | Component[];\ndeclare const Head: (props: { children?: Component }) => Component;\ninterface Tracked<T> {\n  get(): T;\n  set(value: T): void;\n}\ninterface Derived<T> {\n  get(): T;\n  set(value: T): void;\n}\ndeclare function track<T>(initialValue: T): Tracked<T>;\ndeclare function track<T>(fn: () => T): Derived<T>;\ndeclare function derived<T>(fn: () => T): Derived<T>;\ndeclare function effect(fn: () => void): unknown;\ndeclare function untrack<T>(fn: () => T): T;\ndeclare function peek<T>(fn: () => T): T;\ndeclare function tick(): Promise<void>;\ndeclare function flushSync(fn: () => void): void;\ndeclare function on_destroy(fn: () => void): void;\ndeclare function createContext<T>(defaultValue?: T): { id: symbol; defaultValue: T | undefined };\n// useFetch returns a THENABLE resource, not the data itself. In async\n// components you must `await` it before reading/iterating the payload;\n// passing `into: <tracked cell>` writes the payload into the cell and makes\n// awaiting unnecessary (the return value can be ignored).\ninterface VeskResource<T> {\n  loading: boolean;\n  error: unknown;\n  data: T | undefined;\n  refresh(): void;\n  abort(): void;\n  then<TResult1 = T, TResult2 = never>(\n    onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | undefined | null,\n    onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | undefined | null,\n  ): PromiseLike<TResult1 | TResult2>;\n}\ninterface VeskUseFetchOptions<T> {\n  /** Cache/SSR key \u2014 defaults to the URL string. */\n  key?: string;\n  /** Target tracked cell (from track<T>()) \u2014 the payload is written into it, so awaiting is unnecessary. */\n  into?: Tracked<T>;\n  staleTime?: number;\n  keepPreviousData?: boolean;\n  retry?: number;\n  retryDelay?: number;\n  timeout?: number;\n  enabled?: boolean;\n  dedupe?: boolean;\n  method?: string;\n  headers?: Record<string, string>;\n  body?: unknown;\n  credentials?: 'omit' | 'same-origin' | 'include';\n  signal?: { readonly aborted: boolean };\n}\ndeclare function useFetch<T = unknown>(\n  urlOrFn: string | (() => Promise<T>),\n  options?: VeskUseFetchOptions<T>,\n): VeskResource<T>;\ndeclare function useRouter(): unknown;\ndeclare function useParams(): Record<string, string>;\ndeclare function usePathname(): string;\ndeclare function useSearchParams(): URLSearchParams;\ndeclare function useNavigate(): (to: string) => void;\ndeclare function defineAction(...args: unknown[]): unknown;\ndeclare const Form: (props: { [k: string]: unknown; children?: Component }) => Component;\ndeclare const Field: (props: { [k: string]: unknown; children?: Component }) => Component;\ndeclare function required(...args: unknown[]): unknown;\ndeclare function email(...args: unknown[]): unknown;\ndeclare function minLength(...args: unknown[]): unknown;\ndeclare function maxLength(...args: unknown[]): unknown;\ndeclare function pattern(...args: unknown[]): unknown;\ndeclare function custom(...args: unknown[]): unknown;\ndeclare const Link: (props: { [k: string]: unknown; children?: Component }) => Component;\ndeclare const NavLink: (props: { [k: string]: unknown; children?: Component }) => Component;\ndeclare const Outlet: (props: { [k: string]: unknown; children?: Component }) => Component;\ndeclare const Image: (props: { [k: string]: unknown; children?: Component }) => Component;\ndeclare const Portal: (props: { [k: string]: unknown; children?: Component }) => Component;\ndeclare const Experiment: (props: { [k: string]: unknown; children?: Component }) => Component;\ndeclare function useLoadingIndicator(options?: {\n  duration?: number;\n  throttle?: number;\n  hideDelay?: number;\n  resetDelay?: number;\n  estimatedProgress?: (duration: number, elapsed: number) => number;\n}): {\n  progress: Tracked<number>;\n  isLoading: Tracked<boolean>;\n  error: Tracked<boolean>;\n  start(opts?: { force?: boolean }): void;\n  set(value: number, opts?: { force?: boolean }): void;\n  finish(opts?: { force?: boolean; error?: boolean }): void;\n  clear(): void;\n};\ndeclare const LoadingIndicator: (props: {\n  color?: string | false;\n  errorColor?: string;\n  height?: number | string;\n  position?: 'top' | 'bottom';\n  zIndex?: number;\n  duration?: number;\n  throttle?: number;\n  hideDelay?: number;\n  resetDelay?: number;\n  estimatedProgress?: (duration: number, elapsed: number) => number;\n  class?: string;\n  className?: string;\n  style?: string;\n  children?: Component;\n  [k: string]: unknown;\n}) => Component;\ndeclare const JsonLd: (props: { [k: string]: unknown; children?: Component }) => Component;\ndeclare const ArticleSchema: (props: { [k: string]: unknown; children?: Component }) => Component;\ndeclare const ProductSchema: (props: { [k: string]: unknown; children?: Component }) => Component;\ndeclare const FAQPageSchema: (props: { [k: string]: unknown; children?: Component }) => Component;\ndeclare const BreadcrumbListSchema: (props: { [k: string]: unknown; children?: Component }) => Component;\ndeclare const OrganizationSchema: (props: { [k: string]: unknown; children?: Component }) => Component;\ndeclare const LocalBusinessSchema: (props: { [k: string]: unknown; children?: Component }) => Component;\ndeclare const VideoSchema: (props: { [k: string]: unknown; children?: Component }) => Component;\ndeclare function redirect(...args: unknown[]): unknown;\ndeclare function permanentRedirect(...args: unknown[]): unknown;\ndeclare function notFound(...args: unknown[]): never;\ndeclare class NotFoundError extends Error {}\ndeclare function createResource(...args: unknown[]): unknown;\ndeclare function getAction(...args: unknown[]): unknown;\ndeclare function validateActionInput(...args: unknown[]): unknown;\ndeclare function issuesToFieldMap(...args: unknown[]): unknown;\ndeclare function isFormAction(...args: unknown[]): unknown;\n";
+export declare const RUNTIME_OVERRIDE = "\nimport '@vesk/runtime';\ndeclare module '@vesk/runtime' {\n  export function track<T>(initialValue: T): Tracked<T>;\n  export function track<T>(fn: () => T): Derived<T>;\n  export function derived<T>(fn: () => T): Derived<T>;\n}\n";
 export interface TypecheckResult {
     errors: TypecheckError[];
     warnings: TypecheckError[];

package/dist/typecheck.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typecheck.d.ts","sourceRoot":"","sources":["../src/typecheck.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAmQD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE,gBAAqB,GAAG,eAAe,CA0FlG;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,CAItE;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,MAAM,CAI1E"}
+{"version":3,"file":"typecheck.d.ts","sourceRoot":"","sources":["../src/typecheck.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAKD,eAAO,MAAM,OAAO,66kBAmenB,CAAC;AAEF,eAAO,MAAM,gBAAgB,6OAO5B,CAAC;AAyLF,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE,gBAAqB,GAAG,eAAe,CA0FlG;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,CAItE;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,MAAM,CAI1E"}

package/dist/typecheck.js

@@ -5,22 +5,376 @@ import { parse } from '@vesk/compiler/src/parser';
 import { vskToTsx, generateVskDts } from '@vesk/compiler/src/vsk-tsx';
 const SKIP_DIRS = new Set(['node_modules', '.vesk', '.git', 'dist', 'tarballs', '.next']);
 const SKIP_FILES = new Set(['__vesk_ambient.d.ts', '__vesk_runtime_override.d.ts']);
-const AMBIENT = `
+export const AMBIENT = `
 declare namespace JSX {
+  type VeskEventHandler<E extends Event = Event> = (event: E) => void;
+  interface VeskCommonAttributes {
+    key?: string | number;
+    class?: string;
+    id?: string;
+    style?: string;
+    title?: string;
+    hidden?: boolean | string;
+    lang?: string;
+    dir?: 'ltr' | 'rtl' | 'auto';
+    tabIndex?: number;
+    role?: string;
+  }
+  interface VeskEventAttributes {
+    onClick?: VeskEventHandler<MouseEvent>;
+    onDblClick?: VeskEventHandler<MouseEvent>;
+    onMouseDown?: VeskEventHandler<MouseEvent>;
+    onMouseUp?: VeskEventHandler<MouseEvent>;
+    onMouseEnter?: VeskEventHandler<MouseEvent>;
+    onMouseLeave?: VeskEventHandler<MouseEvent>;
+    onMouseMove?: VeskEventHandler<MouseEvent>;
+    onKeyDown?: VeskEventHandler<KeyboardEvent>;
+    onKeyUp?: VeskEventHandler<KeyboardEvent>;
+    onFocus?: VeskEventHandler<FocusEvent>;
+    onBlur?: VeskEventHandler<FocusEvent>;
+    onInput?: VeskEventHandler<InputEvent>;
+    onChange?: VeskEventHandler<Event>;
+    onSubmit?: VeskEventHandler<SubmitEvent>;
+    onScroll?: VeskEventHandler<UIEvent>;
+    onWheel?: VeskEventHandler<WheelEvent>;
+    // Lowercase aliases — HTML attribute names are case-insensitive and real
+    // code writes onclick=/oninput=. Keep in sync with the camelCase members.
+    onclick?: VeskEventHandler<MouseEvent>;
+    ondblclick?: VeskEventHandler<MouseEvent>;
+    onmousedown?: VeskEventHandler<MouseEvent>;
+    onmouseup?: VeskEventHandler<MouseEvent>;
+    onmouseenter?: VeskEventHandler<MouseEvent>;
+    onmouseleave?: VeskEventHandler<MouseEvent>;
+    onmousemove?: VeskEventHandler<MouseEvent>;
+    onkeydown?: VeskEventHandler<KeyboardEvent>;
+    onkeyup?: VeskEventHandler<KeyboardEvent>;
+    onfocus?: VeskEventHandler<FocusEvent>;
+    onblur?: VeskEventHandler<FocusEvent>;
+    oninput?: VeskEventHandler<InputEvent>;
+    onchange?: VeskEventHandler<Event>;
+    onsubmit?: VeskEventHandler<SubmitEvent>;
+  }
+  type Component = string | number | boolean | null | undefined | Component[];
+  interface VeskGlobalAttributes extends VeskCommonAttributes, VeskEventAttributes {
+    children?: Component;
+  }
+  interface VeskAnchorAttributes extends VeskGlobalAttributes {
+    href?: string;
+    target?: string;
+    rel?: string;
+    download?: string | boolean;
+    type?: string;
+    hreflang?: string;
+  }
+  interface VeskMediaAttributes extends VeskGlobalAttributes {
+    src?: string;
+    width?: string | number;
+    height?: string | number;
+  }
+  interface VeskInputAttributes extends VeskGlobalAttributes {
+    type?: string;
+    name?: string;
+    value?: string | number | readonly string[];
+    placeholder?: string;
+    checked?: boolean | string;
+    disabled?: boolean | string;
+    readOnly?: boolean | string;
+    required?: boolean | string;
+    min?: string | number;
+    max?: string | number;
+    step?: string | number;
+    pattern?: string;
+    autoComplete?: string;
+    autoFocus?: boolean | string;
+    multiple?: boolean | string;
+    accept?: string;
+    size?: number;
+    list?: string;
+  }
   interface IntrinsicElements {
+    html?: VeskGlobalAttributes & { manifest?: string };
+    head?: VeskGlobalAttributes;
+    body?: VeskGlobalAttributes;
+    div?: VeskGlobalAttributes;
+    span?: VeskGlobalAttributes;
+    p?: VeskGlobalAttributes;
+    h1?: VeskGlobalAttributes;
+    h2?: VeskGlobalAttributes;
+    h3?: VeskGlobalAttributes;
+    h4?: VeskGlobalAttributes;
+    h5?: VeskGlobalAttributes;
+    h6?: VeskGlobalAttributes;
+    a?: VeskAnchorAttributes;
+    nav?: VeskGlobalAttributes;
+    header?: VeskGlobalAttributes;
+    footer?: VeskGlobalAttributes;
+    main?: VeskGlobalAttributes;
+    section?: VeskGlobalAttributes;
+    article?: VeskGlobalAttributes;
+    aside?: VeskGlobalAttributes;
+    button?: VeskGlobalAttributes & {
+      type?: 'button' | 'submit' | 'reset';
+      disabled?: boolean | string;
+      name?: string;
+      value?: string | number;
+    };
+    form?: VeskGlobalAttributes & {
+      action?: string;
+      method?: 'get' | 'post';
+      target?: string;
+      encType?: string;
+      noValidate?: boolean | string;
+      name?: string;
+      autoComplete?: string;
+    };
+    input?: VeskInputAttributes;
+    textarea?: VeskGlobalAttributes & {
+      rows?: number;
+      cols?: number;
+      placeholder?: string;
+      value?: string | number;
+      disabled?: boolean | string;
+      readOnly?: boolean | string;
+      required?: boolean | string;
+      name?: string;
+    };
+    select?: VeskGlobalAttributes & {
+      name?: string;
+      value?: string | number | readonly string[];
+      disabled?: boolean | string;
+      required?: boolean | string;
+      multiple?: boolean | string;
+      size?: number;
+      autoComplete?: string;
+    };
+    option?: VeskGlobalAttributes & {
+      value?: string | number;
+      selected?: boolean | string;
+      disabled?: boolean | string;
+      label?: string;
+    };
+    optgroup?: VeskGlobalAttributes & { label?: string; disabled?: boolean | string };
+    label?: VeskGlobalAttributes & { htmlFor?: string };
+    fieldset?: VeskGlobalAttributes & { disabled?: boolean | string; name?: string; form?: string };
+    legend?: VeskGlobalAttributes;
+    datalist?: VeskGlobalAttributes;
+    img?: VeskGlobalAttributes & {
+      src?: string;
+      alt?: string;
+      width?: string | number;
+      height?: string | number;
+      srcSet?: string;
+      sizes?: string;
+      loading?: 'eager' | 'lazy';
+      decoding?: 'sync' | 'async' | 'auto';
+    };
+    picture?: VeskGlobalAttributes;
+    source?: VeskGlobalAttributes & { src?: string; srcSet?: string; sizes?: string; media?: string; type?: string };
+    video?: VeskMediaAttributes & {
+      controls?: boolean | string;
+      autoPlay?: boolean | string;
+      loop?: boolean | string;
+      muted?: boolean | string;
+      preload?: 'none' | 'metadata' | 'auto' | '';
+      poster?: string;
+      playsInline?: boolean | string;
+    };
+    audio?: VeskGlobalAttributes & {
+      src?: string;
+      controls?: boolean | string;
+      autoPlay?: boolean | string;
+      loop?: boolean | string;
+      muted?: boolean | string;
+      preload?: 'none' | 'metadata' | 'auto' | '';
+    };
+    track?: VeskGlobalAttributes & {
+      src?: string;
+      kind?: string;
+      srclang?: string;
+      label?: string;
+      default?: boolean | string;
+    };
+    canvas?: VeskGlobalAttributes & { width?: number; height?: number };
+    iframe?: VeskGlobalAttributes & {
+      src?: string;
+      srcDoc?: string;
+      width?: string | number;
+      height?: string | number;
+      allow?: string;
+      loading?: 'eager' | 'lazy';
+      sandbox?: string;
+      allowFullScreen?: boolean | string;
+      referrerPolicy?: string;
+    };
+    embed?: VeskGlobalAttributes & { src?: string; type?: string; width?: string | number; height?: string | number };
+    object?: VeskGlobalAttributes & { data?: string; type?: string; name?: string; width?: string | number; height?: string | number };
+    table?: VeskGlobalAttributes;
+    caption?: VeskGlobalAttributes;
+    thead?: VeskGlobalAttributes;
+    tbody?: VeskGlobalAttributes;
+    tfoot?: VeskGlobalAttributes;
+    tr?: VeskGlobalAttributes;
+    th?: VeskGlobalAttributes & { colSpan?: number; rowSpan?: number; scope?: string; headers?: string };
+    td?: VeskGlobalAttributes & { colSpan?: number; rowSpan?: number; headers?: string };
+    col?: VeskGlobalAttributes & { span?: number };
+    colgroup?: VeskGlobalAttributes & { span?: number };
+    ul?: VeskGlobalAttributes;
+    ol?: VeskGlobalAttributes & { start?: number; reversed?: boolean | string; type?: string };
+    li?: VeskGlobalAttributes & { value?: number };
+    dl?: VeskGlobalAttributes;
+    dt?: VeskGlobalAttributes;
+    dd?: VeskGlobalAttributes;
+    br?: VeskGlobalAttributes;
+    hr?: VeskGlobalAttributes;
+    pre?: VeskGlobalAttributes;
+    code?: VeskGlobalAttributes;
+    blockquote?: VeskGlobalAttributes & { cite?: string };
+    q?: VeskGlobalAttributes & { cite?: string };
+    strong?: VeskGlobalAttributes;
+    em?: VeskGlobalAttributes;
+    small?: VeskGlobalAttributes;
+    s?: VeskGlobalAttributes;
+    cite?: VeskGlobalAttributes;
+    dfn?: VeskGlobalAttributes;
+    abbr?: VeskGlobalAttributes & { title?: string };
+    time?: VeskGlobalAttributes & { dateTime?: string };
+    data?: VeskGlobalAttributes & { value?: string | number };
+    mark?: VeskGlobalAttributes;
+    del?: VeskGlobalAttributes & { cite?: string; dateTime?: string };
+    ins?: VeskGlobalAttributes & { cite?: string; dateTime?: string };
+    sub?: VeskGlobalAttributes;
+    sup?: VeskGlobalAttributes;
+    u?: VeskGlobalAttributes;
+    kbd?: VeskGlobalAttributes;
+    samp?: VeskGlobalAttributes;
+    var?: VeskGlobalAttributes;
+    figure?: VeskGlobalAttributes;
+    figcaption?: VeskGlobalAttributes;
+    details?: VeskGlobalAttributes & { open?: boolean | string };
+    summary?: VeskGlobalAttributes;
+    dialog?: VeskGlobalAttributes & { open?: boolean | string };
+    menu?: VeskGlobalAttributes;
+    address?: VeskGlobalAttributes;
+    b?: VeskGlobalAttributes;
+    i?: VeskGlobalAttributes;
+    ruby?: VeskGlobalAttributes;
+    rt?: VeskGlobalAttributes;
+    rp?: VeskGlobalAttributes;
+    bdi?: VeskGlobalAttributes;
+    bdo?: VeskGlobalAttributes;
+    wbr?: VeskGlobalAttributes;
+    area?: VeskGlobalAttributes & {
+      coords?: string;
+      shape?: string;
+      href?: string;
+      target?: string;
+      alt?: string;
+    };
+    map?: VeskGlobalAttributes & { name?: string };
+    noscript?: VeskGlobalAttributes;
+    template?: VeskGlobalAttributes;
+    slot?: VeskGlobalAttributes & { name?: string };
+    meta?: VeskGlobalAttributes & { name?: string; content?: string; charSet?: string; httpEquiv?: string };
+    title?: VeskGlobalAttributes;
+    base?: VeskGlobalAttributes & { href?: string; target?: string };
+    link?: VeskGlobalAttributes & {
+      rel?: string;
+      href?: string;
+      sizes?: string;
+      media?: string;
+      as?: string;
+      crossOrigin?: string;
+      integrity?: string;
+      type?: string;
+    };
+    style?: VeskGlobalAttributes & { media?: string };
+    script?: VeskGlobalAttributes & {
+      src?: string;
+      async?: boolean | string;
+      defer?: boolean | string;
+      type?: string;
+      crossOrigin?: string;
+      integrity?: string;
+      nonce?: string;
+      noModule?: boolean | string;
+    };
+    svg?: VeskGlobalAttributes & {
+      viewBox?: string;
+      xmlns?: string;
+      width?: string | number;
+      height?: string | number;
+      fill?: string;
+      stroke?: string;
+      strokeWidth?: string | number;
+    };
+    g?: VeskGlobalAttributes & { transform?: string; fill?: string; stroke?: string; strokeWidth?: string | number };
+    path?: VeskGlobalAttributes & {
+      d?: string;
+      fill?: string;
+      stroke?: string;
+      strokeWidth?: string | number;
+      fillRule?: string;
+      clipRule?: string;
+    };
+    circle?: VeskGlobalAttributes & {
+      cx?: string | number;
+      cy?: string | number;
+      r?: string | number;
+      fill?: string;
+      stroke?: string;
+      strokeWidth?: string | number;
+    };
+    ellipse?: VeskGlobalAttributes & {
+      cx?: string | number;
+      cy?: string | number;
+      rx?: string | number;
+      ry?: string | number;
+      fill?: string;
+    };
+    rect?: VeskGlobalAttributes & {
+      x?: string | number;
+      y?: string | number;
+      width?: string | number;
+      height?: string | number;
+      rx?: string | number;
+      ry?: string | number;
+      fill?: string;
+    };
+    line?: VeskGlobalAttributes & {
+      x1?: string | number;
+      y1?: string | number;
+      x2?: string | number;
+      y2?: string | number;
+      stroke?: string;
+      strokeWidth?: string | number;
+    };
+    polyline?: VeskGlobalAttributes & { points?: string; fill?: string; stroke?: string };
+    polygon?: VeskGlobalAttributes & { points?: string; fill?: string; stroke?: string };
+    text?: VeskGlobalAttributes & { x?: string | number; y?: string | number; fill?: string; fontSize?: string | number };
+    defs?: VeskGlobalAttributes;
+    linearGradient?: VeskGlobalAttributes;
+    radialGradient?: VeskGlobalAttributes;
+    stop?: VeskGlobalAttributes & { offset?: string | number; stopColor?: string; stopOpacity?: string | number };
+
+    // Unknown/custom tags stay permissive — components and web components
+    // resolve through the index signature, known tags get the typed members.
     [elemName: string]: unknown;
   }
+  type Component = string | number | boolean | null | undefined | Component[];
 }
-declare const Head: (props: { children?: unknown }) => unknown;
-declare class Cell<T> {
+declare type Component = string | number | boolean | null | undefined | Component[];
+declare const Head: (props: { children?: Component }) => Component;
+interface Tracked<T> {
   get(): T;
-  set(value: T): boolean;
-  peek(): T;
-  update(fn: (current: T) => T): boolean;
-  unsubscribe(effect: unknown): void;
+  set(value: T): void;
 }
-declare function track<T>(initialValue: T): Cell<T>;
-declare function derived<T>(fn: () => T): Cell<T>;
+interface Derived<T> {
+  get(): T;
+  set(value: T): void;
+}
+declare function track<T>(initialValue: T): Tracked<T>;
+declare function track<T>(fn: () => T): Derived<T>;
+declare function derived<T>(fn: () => T): Derived<T>;
 declare function effect(fn: () => void): unknown;
 declare function untrack<T>(fn: () => T): T;
 declare function peek<T>(fn: () => T): T;
@@ -28,35 +382,103 @@ declare function tick(): Promise<void>;
 declare function flushSync(fn: () => void): void;
 declare function on_destroy(fn: () => void): void;
 declare function createContext<T>(defaultValue?: T): { id: symbol; defaultValue: T | undefined };
-declare function useFetch<T = unknown>(...args: unknown[]): T;
+// useFetch returns a THENABLE resource, not the data itself. In async
+// components you must \`await\` it before reading/iterating the payload;
+// passing \`into: <tracked cell>\` writes the payload into the cell and makes
+// awaiting unnecessary (the return value can be ignored).
+interface VeskResource<T> {
+  loading: boolean;
+  error: unknown;
+  data: T | undefined;
+  refresh(): void;
+  abort(): void;
+  then<TResult1 = T, TResult2 = never>(
+    onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | undefined | null,
+    onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | undefined | null,
+  ): PromiseLike<TResult1 | TResult2>;
+}
+interface VeskUseFetchOptions<T> {
+  /** Cache/SSR key — defaults to the URL string. */
+  key?: string;
+  /** Target tracked cell (from track<T>()) — the payload is written into it, so awaiting is unnecessary. */
+  into?: Tracked<T>;
+  staleTime?: number;
+  keepPreviousData?: boolean;
+  retry?: number;
+  retryDelay?: number;
+  timeout?: number;
+  enabled?: boolean;
+  dedupe?: boolean;
+  method?: string;
+  headers?: Record<string, string>;
+  body?: unknown;
+  credentials?: 'omit' | 'same-origin' | 'include';
+  signal?: { readonly aborted: boolean };
+}
+declare function useFetch<T = unknown>(
+  urlOrFn: string | (() => Promise<T>),
+  options?: VeskUseFetchOptions<T>,
+): VeskResource<T>;
 declare function useRouter(): unknown;
 declare function useParams(): Record<string, string>;
 declare function usePathname(): string;
 declare function useSearchParams(): URLSearchParams;
 declare function useNavigate(): (to: string) => void;
 declare function defineAction(...args: unknown[]): unknown;
-declare const Form: (props: { [k: string]: unknown; children?: unknown }) => unknown;
-declare const Field: (props: { [k: string]: unknown; children?: unknown }) => unknown;
+declare const Form: (props: { [k: string]: unknown; children?: Component }) => Component;
+declare const Field: (props: { [k: string]: unknown; children?: Component }) => Component;
 declare function required(...args: unknown[]): unknown;
 declare function email(...args: unknown[]): unknown;
 declare function minLength(...args: unknown[]): unknown;
 declare function maxLength(...args: unknown[]): unknown;
 declare function pattern(...args: unknown[]): unknown;
 declare function custom(...args: unknown[]): unknown;
-declare const Link: (props: { [k: string]: unknown; children?: unknown }) => unknown;
-declare const NavLink: (props: { [k: string]: unknown; children?: unknown }) => unknown;
-declare const Outlet: (props: { [k: string]: unknown; children?: unknown }) => unknown;
-declare const Image: (props: { [k: string]: unknown; children?: unknown }) => unknown;
-declare const Portal: (props: { [k: string]: unknown; children?: unknown }) => unknown;
-declare const Experiment: (props: { [k: string]: unknown; children?: unknown }) => unknown;
-declare const JsonLd: (props: { [k: string]: unknown; children?: unknown }) => unknown;
-declare const ArticleSchema: (props: { [k: string]: unknown; children?: unknown }) => unknown;
-declare const ProductSchema: (props: { [k: string]: unknown; children?: unknown }) => unknown;
-declare const FAQPageSchema: (props: { [k: string]: unknown; children?: unknown }) => unknown;
-declare const BreadcrumbListSchema: (props: { [k: string]: unknown; children?: unknown }) => unknown;
-declare const OrganizationSchema: (props: { [k: string]: unknown; children?: unknown }) => unknown;
-declare const LocalBusinessSchema: (props: { [k: string]: unknown; children?: unknown }) => unknown;
-declare const VideoSchema: (props: { [k: string]: unknown; children?: unknown }) => unknown;
+declare const Link: (props: { [k: string]: unknown; children?: Component }) => Component;
+declare const NavLink: (props: { [k: string]: unknown; children?: Component }) => Component;
+declare const Outlet: (props: { [k: string]: unknown; children?: Component }) => Component;
+declare const Image: (props: { [k: string]: unknown; children?: Component }) => Component;
+declare const Portal: (props: { [k: string]: unknown; children?: Component }) => Component;
+declare const Experiment: (props: { [k: string]: unknown; children?: Component }) => Component;
+declare function useLoadingIndicator(options?: {
+  duration?: number;
+  throttle?: number;
+  hideDelay?: number;
+  resetDelay?: number;
+  estimatedProgress?: (duration: number, elapsed: number) => number;
+}): {
+  progress: Tracked<number>;
+  isLoading: Tracked<boolean>;
+  error: Tracked<boolean>;
+  start(opts?: { force?: boolean }): void;
+  set(value: number, opts?: { force?: boolean }): void;
+  finish(opts?: { force?: boolean; error?: boolean }): void;
+  clear(): void;
+};
+declare const LoadingIndicator: (props: {
+  color?: string | false;
+  errorColor?: string;
+  height?: number | string;
+  position?: 'top' | 'bottom';
+  zIndex?: number;
+  duration?: number;
+  throttle?: number;
+  hideDelay?: number;
+  resetDelay?: number;
+  estimatedProgress?: (duration: number, elapsed: number) => number;
+  class?: string;
+  className?: string;
+  style?: string;
+  children?: Component;
+  [k: string]: unknown;
+}) => Component;
+declare const JsonLd: (props: { [k: string]: unknown; children?: Component }) => Component;
+declare const ArticleSchema: (props: { [k: string]: unknown; children?: Component }) => Component;
+declare const ProductSchema: (props: { [k: string]: unknown; children?: Component }) => Component;
+declare const FAQPageSchema: (props: { [k: string]: unknown; children?: Component }) => Component;
+declare const BreadcrumbListSchema: (props: { [k: string]: unknown; children?: Component }) => Component;
+declare const OrganizationSchema: (props: { [k: string]: unknown; children?: Component }) => Component;
+declare const LocalBusinessSchema: (props: { [k: string]: unknown; children?: Component }) => Component;
+declare const VideoSchema: (props: { [k: string]: unknown; children?: Component }) => Component;
 declare function redirect(...args: unknown[]): unknown;
 declare function permanentRedirect(...args: unknown[]): unknown;
 declare function notFound(...args: unknown[]): never;
@@ -67,11 +489,12 @@ declare function validateActionInput(...args: unknown[]): unknown;
 declare function issuesToFieldMap(...args: unknown[]): unknown;
 declare function isFormAction(...args: unknown[]): unknown;
 `;
-const RUNTIME_OVERRIDE = `
+export const RUNTIME_OVERRIDE = `
 import '@vesk/runtime';
 declare module '@vesk/runtime' {
-  export function track<T>(initialValue: T): Cell<T>;
-  export function derived<T>(fn: () => T): Cell<T>;
+  export function track<T>(initialValue: T): Tracked<T>;
+  export function track<T>(fn: () => T): Derived<T>;
+  export function derived<T>(fn: () => T): Derived<T>;
 }
 `;
 function walkProjectFiles(projectRoot) {