streetui 2.5.0 → 2.7.0

package/dist/{hydration-diagnostics-j2ged4cF.d.cts → hydration-diagnostics-Bh0-5vdC.d.cts}

@@ -7,7 +7,7 @@
  * (`streetui --version`) — the consolidated test-suite pins all three to the
  * same coordinated release so they can never silently drift apart.
  */
-declare const VERSION = "2.5.0";
+declare const VERSION = "2.7.0";
 
 /**
  * StreetUI reactive signals — framework-owned reactivity, no external libraries.
@@ -275,7 +275,7 @@ declare function formatDiagnostic(d: Diagnostic): string;
  * in the Semantic Application Graph.
  */
 
-type SemanticNodeType = 'application' | 'page' | 'section' | 'container' | 'heading' | 'text' | 'button' | 'input' | 'form' | 'list' | 'list-item' | 'image' | 'link' | 'component' | 'slot' | 'fragment' | 'reactive-list' | 'conditional' | 'portal' | 'head';
+type SemanticNodeType = 'application' | 'page' | 'section' | 'container' | 'heading' | 'text' | 'button' | 'input' | 'form' | 'list' | 'list-item' | 'image' | 'link' | 'code' | 'component' | 'slot' | 'fragment' | 'reactive-list' | 'conditional' | 'portal' | 'head';
 interface NodeMetadata {
     readonly createdAt: number;
     readonly [key: string]: unknown;
@@ -759,60 +759,60 @@ type BindableText = TextValue | ReadonlySignal<TextValue>;
  */
 interface A11yOptions {
     /** ARIA role (e.g. 'dialog', 'alert', 'status', 'navigation'). */
-    readonly role?: string;
+    readonly role?: string | undefined;
     /** tabindex value. Use 0 to make an element focusable, -1 to remove from tab order. */
-    readonly tabIndex?: number;
+    readonly tabIndex?: number | undefined;
     /** aria-label — an accessible name when no visible label element exists. */
-    readonly ariaLabel?: string;
+    readonly ariaLabel?: string | undefined;
     /** aria-labelledby — id(s) of the element(s) that label this one. */
-    readonly ariaLabelledBy?: string;
+    readonly ariaLabelledBy?: string | undefined;
     /** aria-describedby — id(s) of the element(s) that describe this one. */
-    readonly ariaDescribedBy?: string;
+    readonly ariaDescribedBy?: string | undefined;
     /** aria-expanded — for disclosure widgets (rendered as the string "true"/"false"). */
-    readonly ariaExpanded?: boolean;
+    readonly ariaExpanded?: boolean | undefined;
     /** aria-controls — id of the element this one controls. */
-    readonly ariaControls?: string;
+    readonly ariaControls?: string | undefined;
     /** aria-hidden — hide decorative content from assistive tech. */
-    readonly ariaHidden?: boolean;
+    readonly ariaHidden?: boolean | undefined;
     /** aria-live — announce dynamic changes ('polite' | 'assertive' | 'off'). */
-    readonly ariaLive?: 'off' | 'polite' | 'assertive';
+    readonly ariaLive?: 'off' | 'polite' | 'assertive' | undefined;
     /** aria-current — mark the current item in a set (e.g. 'page' for active nav). */
-    readonly ariaCurrent?: boolean | 'page' | 'step' | 'location' | 'date' | 'time';
+    readonly ariaCurrent?: boolean | 'page' | 'step' | 'location' | 'date' | 'time' | undefined;
     /** aria-invalid — mark a form field as failing validation. */
-    readonly ariaInvalid?: boolean;
+    readonly ariaInvalid?: boolean | undefined;
     /** aria-required — mark a form field as required. */
-    readonly ariaRequired?: boolean;
+    readonly ariaRequired?: boolean | undefined;
     /** aria-modal — mark a dialog as modal (content outside is inert to AT). */
-    readonly ariaModal?: boolean;
+    readonly ariaModal?: boolean | undefined;
     /** aria-owns — id(s) of elements owned by this one when the DOM can't express it. */
-    readonly ariaOwns?: string;
+    readonly ariaOwns?: string | undefined;
     /** aria-activedescendant — id of the active option in a composite widget (menu/listbox/combobox). */
-    readonly ariaActiveDescendant?: string;
+    readonly ariaActiveDescendant?: string | undefined;
     /** aria-haspopup — the element opens a popup ('menu' | 'listbox' | 'dialog' | 'grid' | 'tree' | true). */
-    readonly ariaHasPopup?: boolean | 'menu' | 'listbox' | 'tree' | 'grid' | 'dialog';
+    readonly ariaHasPopup?: boolean | 'menu' | 'listbox' | 'tree' | 'grid' | 'dialog' | undefined;
     /** aria-selected — selection state within a composite widget. */
-    readonly ariaSelected?: boolean;
+    readonly ariaSelected?: boolean | undefined;
 }
 interface TextOptions extends A11yOptions {
-    readonly class?: string;
-    readonly id?: string;
+    readonly class?: string | undefined;
+    readonly id?: string | undefined;
 }
 interface HeadingOptions extends TextOptions {
-    readonly level?: 1 | 2 | 3 | 4 | 5 | 6;
+    readonly level?: 1 | 2 | 3 | 4 | 5 | 6 | undefined;
 }
 interface ButtonOptions extends A11yOptions {
-    readonly class?: string;
-    readonly id?: string;
-    readonly disabled?: Bindable<boolean>;
-    readonly onClick?: () => void;
+    readonly class?: string | undefined;
+    readonly id?: string | undefined;
+    readonly disabled?: Bindable<boolean> | undefined;
+    readonly onClick?: (() => void) | undefined;
 }
 interface InputOptionsBase extends A11yOptions {
-    readonly class?: string;
-    readonly id?: string;
-    readonly type?: 'text' | 'email' | 'password' | 'number' | 'tel' | 'url' | 'search';
-    readonly placeholder?: string;
-    readonly disabled?: Bindable<boolean>;
-    readonly onChange?: (value: string) => void;
+    readonly class?: string | undefined;
+    readonly id?: string | undefined;
+    readonly type?: 'text' | 'email' | 'password' | 'number' | 'tel' | 'url' | 'search' | undefined;
+    readonly placeholder?: string | undefined;
+    readonly disabled?: Bindable<boolean> | undefined;
+    readonly onChange?: ((value: string) => void) | undefined;
 }
 /**
  * Explicitly-controlled input: supply `value` and/or `onInput` yourself.
@@ -821,8 +821,8 @@ interface InputOptionsBase extends A11yOptions {
  * the type checker rather than resolved silently at runtime.
  */
 interface ControlledInputOptions extends InputOptionsBase {
-    readonly value?: Bindable<string>;
-    readonly onInput?: (value: string) => void;
+    readonly value?: Bindable<string> | undefined;
+    readonly onInput?: ((value: string) => void) | undefined;
     readonly bind?: never;
 }
 /**
@@ -837,24 +837,37 @@ interface BoundInputOptions extends InputOptionsBase {
 }
 type InputOptions = ControlledInputOptions | BoundInputOptions;
 interface LinkOptions extends A11yOptions {
-    readonly class?: string;
-    readonly id?: string;
+    readonly class?: string | undefined;
+    readonly id?: string | undefined;
     readonly href: string;
-    readonly external?: boolean;
-    readonly onClick?: () => void;
+    readonly external?: boolean | undefined;
+    readonly onClick?: (() => void) | undefined;
 }
 interface ImageOptions extends A11yOptions {
-    readonly class?: string;
-    readonly id?: string;
+    readonly class?: string | undefined;
+    readonly id?: string | undefined;
     readonly src: string;
     readonly alt: string;
-    readonly width?: number;
-    readonly height?: number;
+    readonly width?: number | undefined;
+    readonly height?: number | undefined;
+}
+/**
+ * Options for the `code` leaf — a semantic preformatted code block that renders
+ * as `<pre><code>…</code></pre>` with the source escaped at the renderer
+ * boundary (no raw-HTML injection). An optional `language` hint is emitted as a
+ * `data-language` attribute on the outer `<pre>` for styling / highlighting
+ * hooks; it is purely declarative and never parsed or executed by the
+ * framework.
+ */
+interface CodeOptions extends A11yOptions {
+    readonly class?: string | undefined;
+    readonly id?: string | undefined;
+    readonly language?: string | undefined;
 }
 interface ContainerOptions extends A11yOptions {
-    readonly class?: string;
-    readonly id?: string;
-    readonly key?: string;
+    readonly class?: string | undefined;
+    readonly id?: string | undefined;
+    readonly key?: string | undefined;
     /**
      * Enter/leave transition for this element (§2). CSS class-based and
      * browser-only: on the server it is ignored (deterministic SSR output). The
@@ -863,12 +876,12 @@ interface ContainerOptions extends A11yOptions {
      * before the element is removed and disposed — the reconciler defers teardown
      * until the transition completes.
      */
-    readonly transition?: TransitionConfig;
+    readonly transition?: TransitionConfig | undefined;
 }
 interface SectionOptions extends ContainerOptions {
 }
 interface FormOptions extends ContainerOptions {
-    readonly onSubmit?: (e: Event) => void;
+    readonly onSubmit?: ((e: Event) => void) | undefined;
 }
 interface ListOptions extends ContainerOptions {
     /**
@@ -878,14 +891,14 @@ interface ListOptions extends ContainerOptions {
      * reclaimed (leave→enter). `transition` (inherited) applies to the list
      * container itself; `itemTransition` applies to its rows.
      */
-    readonly itemTransition?: TransitionConfig;
+    readonly itemTransition?: TransitionConfig | undefined;
 }
 /** Options for `when()` (§2 conditional transitions). */
 interface WhenOptions {
     /** Transition applied to the active branch as it mounts/unmounts. */
-    readonly transition?: TransitionConfig;
+    readonly transition?: TransitionConfig | undefined;
     /** Also animate the branch present on the initial mount (appear). */
-    readonly appear?: boolean;
+    readonly appear?: boolean | undefined;
 }
 /** Options for a plain portal (mount children into `document.body`). */
 interface PortalOptions extends ContainerOptions {
@@ -903,13 +916,13 @@ interface OverlayOptions extends ContainerOptions {
     /** Reactive open/visibility state. When it flips, the panel mounts/unmounts. */
     readonly open: Bindable<boolean>;
     /** Requested-close callback (fired on Escape when `closeOnEscape`). Flip `open` here. */
-    readonly onClose?: () => void;
+    readonly onClose?: (() => void) | undefined;
     /** Restore focus to the previously-focused element on close. Default: per-kind. */
-    readonly restoreFocus?: boolean;
+    readonly restoreFocus?: boolean | undefined;
     /** id of the element to focus first when the overlay opens (else first focusable). */
-    readonly initialFocusId?: string;
+    readonly initialFocusId?: string | undefined;
     /** Escape key invokes `onClose`. Default: per-kind. */
-    readonly closeOnEscape?: boolean;
+    readonly closeOnEscape?: boolean | undefined;
 }
 type SectionBuilder = (section: SectionDSL) => void;
 type ContainerBuilder = (container: ContainerDSL) => void;
@@ -927,9 +940,9 @@ interface ErrorBoundaryOptions {
      * Reactive error source(s) to observe — typically a resource's `error` signal.
      * When any becomes non-null, the fallback replaces the body.
      */
-    readonly source?: ErrorSource | ReadonlyArray<ErrorSource>;
+    readonly source?: ErrorSource | ReadonlyArray<ErrorSource> | undefined;
     /** Invoked by the fallback's `retry()`, before the body is re-attempted (e.g. `resource.refetch`). */
-    readonly onRetry?: () => void;
+    readonly onRetry?: (() => void) | undefined;
     /**
      * Error-reporting hook (§6/§7). Called with the current error each time the
      * boundary ENTERS its error state (i.e. when the fallback mounts), including
@@ -938,7 +951,7 @@ interface ErrorBoundaryOptions {
      * boundary's behavior, and receives the same `unknown` error the fallback
      * sees (no sensitive framework internals are injected).
      */
-    readonly onError?: (error: unknown) => void;
+    readonly onError?: ((error: unknown) => void) | undefined;
 }
 /**
  * Branch builders for {@link ContainerDSL.asyncBoundary} — the loading / error /
@@ -952,12 +965,12 @@ interface ErrorBoundaryOptions {
  */
 interface AsyncBoundaryBranches<T> {
     /** Shown while the resource is idle or performing its first load (no data yet). */
-    readonly loading?: (content: ContainerDSL) => void;
+    readonly loading?: ((content: ContainerDSL) => void) | undefined;
     /**
      * Shown while the resource is in its error state. Receives the current error
      * and a `retry()` that re-runs the loader (a thin wrapper over `refetch`).
      */
-    readonly error?: (content: ContainerDSL, error: unknown, retry: () => void) => void;
+    readonly error?: ((content: ContainerDSL, error: unknown, retry: () => void) => void) | undefined;
     /**
      * Shown once the resource has data (including while a refetch keeps the old
      * value visible). Receives the data as a `ReadonlySignal<T>` so the branch can
@@ -972,6 +985,14 @@ interface ContentDSL {
     input(options?: InputOptions): void;
     image(options: ImageOptions): void;
     link(label: BindableText, options: LinkOptions): void;
+    /**
+     * Preformatted code block rendering as `<pre><code>…</code></pre>`. The source
+     * is escaped at the renderer boundary (never injected as raw HTML), whitespace
+     * is preserved by the semantic `<pre>`, and an optional `language` hint is
+     * emitted as `data-language` on the `<pre>`. SSR- and hydration-safe; reuses
+     * the same text binding/escaping machinery as `text`.
+     */
+    code(source: BindableText, options?: CodeOptions): void;
 }
 interface ContainerDSL extends ContentDSL {
     section(key: string, builder: SectionBuilder, options?: SectionOptions): void;
@@ -1133,6 +1154,7 @@ declare class ContentBuilderBase implements ContentDSL {
     input(options?: InputOptions): void;
     image(options: ImageOptions): void;
     link(label: BindableText, options: LinkOptions): void;
+    code(source: BindableText, options?: CodeOptions): void;
 }
 declare class ContainerBuilderBase extends ContentBuilderBase implements ContainerDSL {
     section(key: string, builder: SectionBuilder, options?: SectionOptions): void;
@@ -1346,4 +1368,4 @@ declare function consoleHydrationDiagnosticSink(logger?: {
     warn(message: string): void;
 }): HydrationDiagnosticSink;
 
-export { type FormBuilder as $, type ApplicationId as A, BaseNode as B, type CompiledApplication as C, DiagnosticCollector as D, type ComponentRender as E, type ComponentSetup as F, GraphNode as G, type HydrationDiagnostic as H, ContainerBuilderImpl as I, type ContainerOptions as J, type ContentDSL as K, type ControlledInputOptions as L, DerivedSignal as M, type Diagnostic as N, DiagnosticError as O, type PageDSL as P, type DiagnosticLocation as Q, type ReadonlySignal as R, StreetApp as S, type TransitionConfig as T, type Unsubscribe as U, VERSION as V, type DiagnosticSeverity as W, type ErrorBoundaryOptions as X, type ErrorFallbackBuilder as Y, type ErrorSource as Z, type EventDescriptor as _, type ComponentDefinition as a, observerCount as a$, FormBuilderImpl as a0, type FormDSL as a1, type FormOptions as a2, type GraphNodeData as a3, type HandlerFn as a4, type HeadContribution as a5, type HeadEntry as a6, type HeadMetadata as a7, type HeadingOptions as a8, type HydrationMismatchType as a9, type SectionOptions as aA, type SerializedGraph as aB, type SerializedNode as aC, type StateRef as aD, type StreetUI as aE, type TextOptions as aF, type TextValue as aG, type WhenOptions as aH, batch as aI, compile as aJ, compileGraph as aK, component as aL, consoleHydrationDiagnosticSink as aM, createHydrationDiagnosticCollector as aN, createNodeId as aO, derived as aP, effect as aQ, formatDiagnostic as aR, formatHydrationDiagnostic as aS, generateApplicationId as aT, generateNodeId as aU, isBatching as aV, isComponentDefinition as aW, isHeadContribution as aX, isTransitionConfig as aY, nextId as aZ, nodeIdPrefix as a_, type ImageOptions as aa, type InputOptions as ab, type InputOptionsBase as ac, type LinkDescriptor as ad, type LinkOptions as ae, type ListBuilder as af, ListBuilderImpl as ag, type ListDSL as ah, type ListOptions as ai, type ListPlanEntry as aj, type MetaDescriptor as ak, type NodeId as al, type NodeMetadata as am, type OverlayOptions as an, type PageBuilder as ao, PageBuilderImpl as ap, type PortalOptions as aq, type PropValue as ar, type Props as as, type ReactiveConsumer as at, type ReactiveSource as au, type ResolvedTransition as av, type ResourceLoader as aw, type SectionBuilder as ax, SectionBuilderImpl as ay, type SectionDSL as az, type ContainerBuilder as b, reactiveListItemKey as b0, reactiveListItemSignature as b1, resetIdCounter as b2, resolveHead as b3, resolveTransition as b4, resource as b5, signal as b6, signalKind as b7, streetui as b8, Signal as c, type Subscriber as d, type ResourceStatus as e, type ResourceOptions as f, type Resource as g, type ResourceLoaderContext as h, ApplicationGraph as i, type HydrationDiagnosticSink as j, type SemanticNodeType as k, type ContainerDSL as l, type SignalKind as m, type A11yOptions as n, AppBuilder as o, type AppDSL as p, type AppOptions as q, type ApplicationGraphOptions as r, type AsyncBoundaryBranches as s, type Bindable as t, type BindableString as u, type BindableText as v, type BoundInputOptions as w, type ButtonOptions as x, type CompileOptions as y, type ComponentContext as z };
+export { type EventDescriptor as $, type ApplicationId as A, BaseNode as B, type CompiledApplication as C, DiagnosticCollector as D, type ComponentContext as E, type ComponentRender as F, GraphNode as G, type HydrationDiagnostic as H, type ComponentSetup as I, ContainerBuilderImpl as J, type ContainerOptions as K, type ContentDSL as L, type ControlledInputOptions as M, DerivedSignal as N, type Diagnostic as O, type PageDSL as P, DiagnosticError as Q, type ReadonlySignal as R, StreetApp as S, type TransitionConfig as T, type Unsubscribe as U, VERSION as V, type DiagnosticLocation as W, type DiagnosticSeverity as X, type ErrorBoundaryOptions as Y, type ErrorFallbackBuilder as Z, type ErrorSource as _, type ComponentDefinition as a, nodeIdPrefix as a$, type FormBuilder as a0, FormBuilderImpl as a1, type FormDSL as a2, type FormOptions as a3, type GraphNodeData as a4, type HandlerFn as a5, type HeadContribution as a6, type HeadEntry as a7, type HeadMetadata as a8, type HeadingOptions as a9, type SectionDSL as aA, type SectionOptions as aB, type SerializedGraph as aC, type SerializedNode as aD, type StateRef as aE, type StreetUI as aF, type TextOptions as aG, type TextValue as aH, type WhenOptions as aI, batch as aJ, compile as aK, compileGraph as aL, component as aM, consoleHydrationDiagnosticSink as aN, createHydrationDiagnosticCollector as aO, createNodeId as aP, derived as aQ, effect as aR, formatDiagnostic as aS, formatHydrationDiagnostic as aT, generateApplicationId as aU, generateNodeId as aV, isBatching as aW, isComponentDefinition as aX, isHeadContribution as aY, isTransitionConfig as aZ, nextId as a_, type HydrationMismatchType as aa, type ImageOptions as ab, type InputOptions as ac, type InputOptionsBase as ad, type LinkDescriptor as ae, type LinkOptions as af, type ListBuilder as ag, ListBuilderImpl as ah, type ListDSL as ai, type ListOptions as aj, type ListPlanEntry as ak, type MetaDescriptor as al, type NodeId as am, type NodeMetadata as an, type OverlayOptions as ao, type PageBuilder as ap, PageBuilderImpl as aq, type PortalOptions as ar, type PropValue as as, type Props as at, type ReactiveConsumer as au, type ReactiveSource as av, type ResolvedTransition as aw, type ResourceLoader as ax, type SectionBuilder as ay, SectionBuilderImpl as az, type ContainerBuilder as b, observerCount as b0, reactiveListItemKey as b1, reactiveListItemSignature as b2, resetIdCounter as b3, resolveHead as b4, resolveTransition as b5, resource as b6, signal as b7, signalKind as b8, streetui as b9, Signal as c, type Subscriber as d, type ResourceStatus as e, type ResourceOptions as f, type Resource as g, type ResourceLoaderContext as h, ApplicationGraph as i, type HydrationDiagnosticSink as j, type SemanticNodeType as k, type ContainerDSL as l, type SignalKind as m, type A11yOptions as n, AppBuilder as o, type AppDSL as p, type AppOptions as q, type ApplicationGraphOptions as r, type AsyncBoundaryBranches as s, type Bindable as t, type BindableString as u, type BindableText as v, type BoundInputOptions as w, type ButtonOptions as x, type CodeOptions as y, type CompileOptions as z };

package/dist/{hydration-diagnostics-j2ged4cF.d.ts → hydration-diagnostics-Bh0-5vdC.d.ts}

@@ -7,7 +7,7 @@
  * (`streetui --version`) — the consolidated test-suite pins all three to the
  * same coordinated release so they can never silently drift apart.
  */
-declare const VERSION = "2.5.0";
+declare const VERSION = "2.7.0";
 
 /**
  * StreetUI reactive signals — framework-owned reactivity, no external libraries.
@@ -275,7 +275,7 @@ declare function formatDiagnostic(d: Diagnostic): string;
  * in the Semantic Application Graph.
  */
 
-type SemanticNodeType = 'application' | 'page' | 'section' | 'container' | 'heading' | 'text' | 'button' | 'input' | 'form' | 'list' | 'list-item' | 'image' | 'link' | 'component' | 'slot' | 'fragment' | 'reactive-list' | 'conditional' | 'portal' | 'head';
+type SemanticNodeType = 'application' | 'page' | 'section' | 'container' | 'heading' | 'text' | 'button' | 'input' | 'form' | 'list' | 'list-item' | 'image' | 'link' | 'code' | 'component' | 'slot' | 'fragment' | 'reactive-list' | 'conditional' | 'portal' | 'head';
 interface NodeMetadata {
     readonly createdAt: number;
     readonly [key: string]: unknown;
@@ -759,60 +759,60 @@ type BindableText = TextValue | ReadonlySignal<TextValue>;
  */
 interface A11yOptions {
     /** ARIA role (e.g. 'dialog', 'alert', 'status', 'navigation'). */
-    readonly role?: string;
+    readonly role?: string | undefined;
     /** tabindex value. Use 0 to make an element focusable, -1 to remove from tab order. */
-    readonly tabIndex?: number;
+    readonly tabIndex?: number | undefined;
     /** aria-label — an accessible name when no visible label element exists. */
-    readonly ariaLabel?: string;
+    readonly ariaLabel?: string | undefined;
     /** aria-labelledby — id(s) of the element(s) that label this one. */
-    readonly ariaLabelledBy?: string;
+    readonly ariaLabelledBy?: string | undefined;
     /** aria-describedby — id(s) of the element(s) that describe this one. */
-    readonly ariaDescribedBy?: string;
+    readonly ariaDescribedBy?: string | undefined;
     /** aria-expanded — for disclosure widgets (rendered as the string "true"/"false"). */
-    readonly ariaExpanded?: boolean;
+    readonly ariaExpanded?: boolean | undefined;
     /** aria-controls — id of the element this one controls. */
-    readonly ariaControls?: string;
+    readonly ariaControls?: string | undefined;
     /** aria-hidden — hide decorative content from assistive tech. */
-    readonly ariaHidden?: boolean;
+    readonly ariaHidden?: boolean | undefined;
     /** aria-live — announce dynamic changes ('polite' | 'assertive' | 'off'). */
-    readonly ariaLive?: 'off' | 'polite' | 'assertive';
+    readonly ariaLive?: 'off' | 'polite' | 'assertive' | undefined;
     /** aria-current — mark the current item in a set (e.g. 'page' for active nav). */
-    readonly ariaCurrent?: boolean | 'page' | 'step' | 'location' | 'date' | 'time';
+    readonly ariaCurrent?: boolean | 'page' | 'step' | 'location' | 'date' | 'time' | undefined;
     /** aria-invalid — mark a form field as failing validation. */
-    readonly ariaInvalid?: boolean;
+    readonly ariaInvalid?: boolean | undefined;
     /** aria-required — mark a form field as required. */
-    readonly ariaRequired?: boolean;
+    readonly ariaRequired?: boolean | undefined;
     /** aria-modal — mark a dialog as modal (content outside is inert to AT). */
-    readonly ariaModal?: boolean;
+    readonly ariaModal?: boolean | undefined;
     /** aria-owns — id(s) of elements owned by this one when the DOM can't express it. */
-    readonly ariaOwns?: string;
+    readonly ariaOwns?: string | undefined;
     /** aria-activedescendant — id of the active option in a composite widget (menu/listbox/combobox). */
-    readonly ariaActiveDescendant?: string;
+    readonly ariaActiveDescendant?: string | undefined;
     /** aria-haspopup — the element opens a popup ('menu' | 'listbox' | 'dialog' | 'grid' | 'tree' | true). */
-    readonly ariaHasPopup?: boolean | 'menu' | 'listbox' | 'tree' | 'grid' | 'dialog';
+    readonly ariaHasPopup?: boolean | 'menu' | 'listbox' | 'tree' | 'grid' | 'dialog' | undefined;
     /** aria-selected — selection state within a composite widget. */
-    readonly ariaSelected?: boolean;
+    readonly ariaSelected?: boolean | undefined;
 }
 interface TextOptions extends A11yOptions {
-    readonly class?: string;
-    readonly id?: string;
+    readonly class?: string | undefined;
+    readonly id?: string | undefined;
 }
 interface HeadingOptions extends TextOptions {
-    readonly level?: 1 | 2 | 3 | 4 | 5 | 6;
+    readonly level?: 1 | 2 | 3 | 4 | 5 | 6 | undefined;
 }
 interface ButtonOptions extends A11yOptions {
-    readonly class?: string;
-    readonly id?: string;
-    readonly disabled?: Bindable<boolean>;
-    readonly onClick?: () => void;
+    readonly class?: string | undefined;
+    readonly id?: string | undefined;
+    readonly disabled?: Bindable<boolean> | undefined;
+    readonly onClick?: (() => void) | undefined;
 }
 interface InputOptionsBase extends A11yOptions {
-    readonly class?: string;
-    readonly id?: string;
-    readonly type?: 'text' | 'email' | 'password' | 'number' | 'tel' | 'url' | 'search';
-    readonly placeholder?: string;
-    readonly disabled?: Bindable<boolean>;
-    readonly onChange?: (value: string) => void;
+    readonly class?: string | undefined;
+    readonly id?: string | undefined;
+    readonly type?: 'text' | 'email' | 'password' | 'number' | 'tel' | 'url' | 'search' | undefined;
+    readonly placeholder?: string | undefined;
+    readonly disabled?: Bindable<boolean> | undefined;
+    readonly onChange?: ((value: string) => void) | undefined;
 }
 /**
  * Explicitly-controlled input: supply `value` and/or `onInput` yourself.
@@ -821,8 +821,8 @@ interface InputOptionsBase extends A11yOptions {
  * the type checker rather than resolved silently at runtime.
  */
 interface ControlledInputOptions extends InputOptionsBase {
-    readonly value?: Bindable<string>;
-    readonly onInput?: (value: string) => void;
+    readonly value?: Bindable<string> | undefined;
+    readonly onInput?: ((value: string) => void) | undefined;
     readonly bind?: never;
 }
 /**
@@ -837,24 +837,37 @@ interface BoundInputOptions extends InputOptionsBase {
 }
 type InputOptions = ControlledInputOptions | BoundInputOptions;
 interface LinkOptions extends A11yOptions {
-    readonly class?: string;
-    readonly id?: string;
+    readonly class?: string | undefined;
+    readonly id?: string | undefined;
     readonly href: string;
-    readonly external?: boolean;
-    readonly onClick?: () => void;
+    readonly external?: boolean | undefined;
+    readonly onClick?: (() => void) | undefined;
 }
 interface ImageOptions extends A11yOptions {
-    readonly class?: string;
-    readonly id?: string;
+    readonly class?: string | undefined;
+    readonly id?: string | undefined;
     readonly src: string;
     readonly alt: string;
-    readonly width?: number;
-    readonly height?: number;
+    readonly width?: number | undefined;
+    readonly height?: number | undefined;
+}
+/**
+ * Options for the `code` leaf — a semantic preformatted code block that renders
+ * as `<pre><code>…</code></pre>` with the source escaped at the renderer
+ * boundary (no raw-HTML injection). An optional `language` hint is emitted as a
+ * `data-language` attribute on the outer `<pre>` for styling / highlighting
+ * hooks; it is purely declarative and never parsed or executed by the
+ * framework.
+ */
+interface CodeOptions extends A11yOptions {
+    readonly class?: string | undefined;
+    readonly id?: string | undefined;
+    readonly language?: string | undefined;
 }
 interface ContainerOptions extends A11yOptions {
-    readonly class?: string;
-    readonly id?: string;
-    readonly key?: string;
+    readonly class?: string | undefined;
+    readonly id?: string | undefined;
+    readonly key?: string | undefined;
     /**
      * Enter/leave transition for this element (§2). CSS class-based and
      * browser-only: on the server it is ignored (deterministic SSR output). The
@@ -863,12 +876,12 @@ interface ContainerOptions extends A11yOptions {
      * before the element is removed and disposed — the reconciler defers teardown
      * until the transition completes.
      */
-    readonly transition?: TransitionConfig;
+    readonly transition?: TransitionConfig | undefined;
 }
 interface SectionOptions extends ContainerOptions {
 }
 interface FormOptions extends ContainerOptions {
-    readonly onSubmit?: (e: Event) => void;
+    readonly onSubmit?: ((e: Event) => void) | undefined;
 }
 interface ListOptions extends ContainerOptions {
     /**
@@ -878,14 +891,14 @@ interface ListOptions extends ContainerOptions {
      * reclaimed (leave→enter). `transition` (inherited) applies to the list
      * container itself; `itemTransition` applies to its rows.
      */
-    readonly itemTransition?: TransitionConfig;
+    readonly itemTransition?: TransitionConfig | undefined;
 }
 /** Options for `when()` (§2 conditional transitions). */
 interface WhenOptions {
     /** Transition applied to the active branch as it mounts/unmounts. */
-    readonly transition?: TransitionConfig;
+    readonly transition?: TransitionConfig | undefined;
     /** Also animate the branch present on the initial mount (appear). */
-    readonly appear?: boolean;
+    readonly appear?: boolean | undefined;
 }
 /** Options for a plain portal (mount children into `document.body`). */
 interface PortalOptions extends ContainerOptions {
@@ -903,13 +916,13 @@ interface OverlayOptions extends ContainerOptions {
     /** Reactive open/visibility state. When it flips, the panel mounts/unmounts. */
     readonly open: Bindable<boolean>;
     /** Requested-close callback (fired on Escape when `closeOnEscape`). Flip `open` here. */
-    readonly onClose?: () => void;
+    readonly onClose?: (() => void) | undefined;
     /** Restore focus to the previously-focused element on close. Default: per-kind. */
-    readonly restoreFocus?: boolean;
+    readonly restoreFocus?: boolean | undefined;
     /** id of the element to focus first when the overlay opens (else first focusable). */
-    readonly initialFocusId?: string;
+    readonly initialFocusId?: string | undefined;
     /** Escape key invokes `onClose`. Default: per-kind. */
-    readonly closeOnEscape?: boolean;
+    readonly closeOnEscape?: boolean | undefined;
 }
 type SectionBuilder = (section: SectionDSL) => void;
 type ContainerBuilder = (container: ContainerDSL) => void;
@@ -927,9 +940,9 @@ interface ErrorBoundaryOptions {
      * Reactive error source(s) to observe — typically a resource's `error` signal.
      * When any becomes non-null, the fallback replaces the body.
      */
-    readonly source?: ErrorSource | ReadonlyArray<ErrorSource>;
+    readonly source?: ErrorSource | ReadonlyArray<ErrorSource> | undefined;
     /** Invoked by the fallback's `retry()`, before the body is re-attempted (e.g. `resource.refetch`). */
-    readonly onRetry?: () => void;
+    readonly onRetry?: (() => void) | undefined;
     /**
      * Error-reporting hook (§6/§7). Called with the current error each time the
      * boundary ENTERS its error state (i.e. when the fallback mounts), including
@@ -938,7 +951,7 @@ interface ErrorBoundaryOptions {
      * boundary's behavior, and receives the same `unknown` error the fallback
      * sees (no sensitive framework internals are injected).
      */
-    readonly onError?: (error: unknown) => void;
+    readonly onError?: ((error: unknown) => void) | undefined;
 }
 /**
  * Branch builders for {@link ContainerDSL.asyncBoundary} — the loading / error /
@@ -952,12 +965,12 @@ interface ErrorBoundaryOptions {
  */
 interface AsyncBoundaryBranches<T> {
     /** Shown while the resource is idle or performing its first load (no data yet). */
-    readonly loading?: (content: ContainerDSL) => void;
+    readonly loading?: ((content: ContainerDSL) => void) | undefined;
     /**
      * Shown while the resource is in its error state. Receives the current error
      * and a `retry()` that re-runs the loader (a thin wrapper over `refetch`).
      */
-    readonly error?: (content: ContainerDSL, error: unknown, retry: () => void) => void;
+    readonly error?: ((content: ContainerDSL, error: unknown, retry: () => void) => void) | undefined;
     /**
      * Shown once the resource has data (including while a refetch keeps the old
      * value visible). Receives the data as a `ReadonlySignal<T>` so the branch can
@@ -972,6 +985,14 @@ interface ContentDSL {
     input(options?: InputOptions): void;
     image(options: ImageOptions): void;
     link(label: BindableText, options: LinkOptions): void;
+    /**
+     * Preformatted code block rendering as `<pre><code>…</code></pre>`. The source
+     * is escaped at the renderer boundary (never injected as raw HTML), whitespace
+     * is preserved by the semantic `<pre>`, and an optional `language` hint is
+     * emitted as `data-language` on the `<pre>`. SSR- and hydration-safe; reuses
+     * the same text binding/escaping machinery as `text`.
+     */
+    code(source: BindableText, options?: CodeOptions): void;
 }
 interface ContainerDSL extends ContentDSL {
     section(key: string, builder: SectionBuilder, options?: SectionOptions): void;
@@ -1133,6 +1154,7 @@ declare class ContentBuilderBase implements ContentDSL {
     input(options?: InputOptions): void;
     image(options: ImageOptions): void;
     link(label: BindableText, options: LinkOptions): void;
+    code(source: BindableText, options?: CodeOptions): void;
 }
 declare class ContainerBuilderBase extends ContentBuilderBase implements ContainerDSL {
     section(key: string, builder: SectionBuilder, options?: SectionOptions): void;
@@ -1346,4 +1368,4 @@ declare function consoleHydrationDiagnosticSink(logger?: {
     warn(message: string): void;
 }): HydrationDiagnosticSink;
 
-export { type FormBuilder as $, type ApplicationId as A, BaseNode as B, type CompiledApplication as C, DiagnosticCollector as D, type ComponentRender as E, type ComponentSetup as F, GraphNode as G, type HydrationDiagnostic as H, ContainerBuilderImpl as I, type ContainerOptions as J, type ContentDSL as K, type ControlledInputOptions as L, DerivedSignal as M, type Diagnostic as N, DiagnosticError as O, type PageDSL as P, type DiagnosticLocation as Q, type ReadonlySignal as R, StreetApp as S, type TransitionConfig as T, type Unsubscribe as U, VERSION as V, type DiagnosticSeverity as W, type ErrorBoundaryOptions as X, type ErrorFallbackBuilder as Y, type ErrorSource as Z, type EventDescriptor as _, type ComponentDefinition as a, observerCount as a$, FormBuilderImpl as a0, type FormDSL as a1, type FormOptions as a2, type GraphNodeData as a3, type HandlerFn as a4, type HeadContribution as a5, type HeadEntry as a6, type HeadMetadata as a7, type HeadingOptions as a8, type HydrationMismatchType as a9, type SectionOptions as aA, type SerializedGraph as aB, type SerializedNode as aC, type StateRef as aD, type StreetUI as aE, type TextOptions as aF, type TextValue as aG, type WhenOptions as aH, batch as aI, compile as aJ, compileGraph as aK, component as aL, consoleHydrationDiagnosticSink as aM, createHydrationDiagnosticCollector as aN, createNodeId as aO, derived as aP, effect as aQ, formatDiagnostic as aR, formatHydrationDiagnostic as aS, generateApplicationId as aT, generateNodeId as aU, isBatching as aV, isComponentDefinition as aW, isHeadContribution as aX, isTransitionConfig as aY, nextId as aZ, nodeIdPrefix as a_, type ImageOptions as aa, type InputOptions as ab, type InputOptionsBase as ac, type LinkDescriptor as ad, type LinkOptions as ae, type ListBuilder as af, ListBuilderImpl as ag, type ListDSL as ah, type ListOptions as ai, type ListPlanEntry as aj, type MetaDescriptor as ak, type NodeId as al, type NodeMetadata as am, type OverlayOptions as an, type PageBuilder as ao, PageBuilderImpl as ap, type PortalOptions as aq, type PropValue as ar, type Props as as, type ReactiveConsumer as at, type ReactiveSource as au, type ResolvedTransition as av, type ResourceLoader as aw, type SectionBuilder as ax, SectionBuilderImpl as ay, type SectionDSL as az, type ContainerBuilder as b, reactiveListItemKey as b0, reactiveListItemSignature as b1, resetIdCounter as b2, resolveHead as b3, resolveTransition as b4, resource as b5, signal as b6, signalKind as b7, streetui as b8, Signal as c, type Subscriber as d, type ResourceStatus as e, type ResourceOptions as f, type Resource as g, type ResourceLoaderContext as h, ApplicationGraph as i, type HydrationDiagnosticSink as j, type SemanticNodeType as k, type ContainerDSL as l, type SignalKind as m, type A11yOptions as n, AppBuilder as o, type AppDSL as p, type AppOptions as q, type ApplicationGraphOptions as r, type AsyncBoundaryBranches as s, type Bindable as t, type BindableString as u, type BindableText as v, type BoundInputOptions as w, type ButtonOptions as x, type CompileOptions as y, type ComponentContext as z };
+export { type EventDescriptor as $, type ApplicationId as A, BaseNode as B, type CompiledApplication as C, DiagnosticCollector as D, type ComponentContext as E, type ComponentRender as F, GraphNode as G, type HydrationDiagnostic as H, type ComponentSetup as I, ContainerBuilderImpl as J, type ContainerOptions as K, type ContentDSL as L, type ControlledInputOptions as M, DerivedSignal as N, type Diagnostic as O, type PageDSL as P, DiagnosticError as Q, type ReadonlySignal as R, StreetApp as S, type TransitionConfig as T, type Unsubscribe as U, VERSION as V, type DiagnosticLocation as W, type DiagnosticSeverity as X, type ErrorBoundaryOptions as Y, type ErrorFallbackBuilder as Z, type ErrorSource as _, type ComponentDefinition as a, nodeIdPrefix as a$, type FormBuilder as a0, FormBuilderImpl as a1, type FormDSL as a2, type FormOptions as a3, type GraphNodeData as a4, type HandlerFn as a5, type HeadContribution as a6, type HeadEntry as a7, type HeadMetadata as a8, type HeadingOptions as a9, type SectionDSL as aA, type SectionOptions as aB, type SerializedGraph as aC, type SerializedNode as aD, type StateRef as aE, type StreetUI as aF, type TextOptions as aG, type TextValue as aH, type WhenOptions as aI, batch as aJ, compile as aK, compileGraph as aL, component as aM, consoleHydrationDiagnosticSink as aN, createHydrationDiagnosticCollector as aO, createNodeId as aP, derived as aQ, effect as aR, formatDiagnostic as aS, formatHydrationDiagnostic as aT, generateApplicationId as aU, generateNodeId as aV, isBatching as aW, isComponentDefinition as aX, isHeadContribution as aY, isTransitionConfig as aZ, nextId as a_, type HydrationMismatchType as aa, type ImageOptions as ab, type InputOptions as ac, type InputOptionsBase as ad, type LinkDescriptor as ae, type LinkOptions as af, type ListBuilder as ag, ListBuilderImpl as ah, type ListDSL as ai, type ListOptions as aj, type ListPlanEntry as ak, type MetaDescriptor as al, type NodeId as am, type NodeMetadata as an, type OverlayOptions as ao, type PageBuilder as ap, PageBuilderImpl as aq, type PortalOptions as ar, type PropValue as as, type Props as at, type ReactiveConsumer as au, type ReactiveSource as av, type ResolvedTransition as aw, type ResourceLoader as ax, type SectionBuilder as ay, SectionBuilderImpl as az, type ContainerBuilder as b, observerCount as b0, reactiveListItemKey as b1, reactiveListItemSignature as b2, resetIdCounter as b3, resolveHead as b4, resolveTransition as b5, resource as b6, signal as b7, signalKind as b8, streetui as b9, Signal as c, type Subscriber as d, type ResourceStatus as e, type ResourceOptions as f, type Resource as g, type ResourceLoaderContext as h, ApplicationGraph as i, type HydrationDiagnosticSink as j, type SemanticNodeType as k, type ContainerDSL as l, type SignalKind as m, type A11yOptions as n, AppBuilder as o, type AppDSL as p, type AppOptions as q, type ApplicationGraphOptions as r, type AsyncBoundaryBranches as s, type Bindable as t, type BindableString as u, type BindableText as v, type BoundInputOptions as w, type ButtonOptions as x, type CodeOptions as y, type CompileOptions as z };