@declarion/react 0.61.1 → 0.63.1

package/dist-lib/types/api.d.ts

@@ -1,579 +0,0 @@
-import type { AccentDef, EntityField, LocalizedString } from "./schema";
-import type { HydratedFile } from "./files";
-import type { FilterNode } from "../lib/filters.d.ts";
-export interface ListMeta {
-    /**
-     * Total matching rows. Present only when the request asked for a count
-     * (`count=with` / `count=only` / `count=exact`). Absent (undefined) on a
-     * window-only response (`count` omitted) - the page of rows arrives
-     * without ever blocking on the count. Treat `count_mode === undefined` as
-     * "no count yet" and ignore `total` then.
-     */
-    total?: number;
-    page: number;
-    per_page: number;
-    /** Present only when a count was computed (see `total`). */
-    total_pages?: number;
-    has_more?: boolean;
-    /**
-     * How `total` was produced: "exact" (an exact COUNT(*)) or "estimated"
-     * (an O(1) query-planner estimate). Absent when no count was computed.
-     * The SDK keys display precision on this, NOT on the entity schema, so a
-     * forced exact count renders precisely even on a `count: estimated`
-     * entity.
-     */
-    count_mode?: "exact" | "estimated";
-}
-export interface ListResponse<T = Record<string, unknown>> {
-    data: T[];
-    meta: ListMeta;
-    $refs?: Refs;
-}
-export interface DataResponse<T = Record<string, unknown>> {
-    data: T;
-    $refs?: Refs;
-}
-/**
- * A failure, in RFC 9457 Problem Details form - the one shape every Declarion
- * carrier sends. `type` is the identifier to branch on; its last path segment is
- * identical in every deployment. `title` is the sentence to SHOW: the server
- * already rendered it in this caller's language, and the browser holds no
- * catalogue to render one itself. A type's declared members are TOP-LEVEL, which
- * is why this is an index signature and not a fixed shape.
- */
-export interface ApiErrorBody {
-    type: string;
-    status?: number;
-    title: string;
-    /** This occurrence. A DIAGNOSTIC, not the headline - and absent for a failure nothing recognised. */
-    detail?: string;
-    instance?: string;
-    retryable: boolean;
-    [member: string]: unknown;
-}
-export declare class ApiError extends Error {
-    status: number;
-    /** The identifier to compare - the type's last path segment, e.g. `entity.not_found`. */
-    code: string;
-    /** The full `type`, e.g. `/errors/entity.not_found`. */
-    type: string;
-    /** Whether the same call can succeed later. From the DECLARATION, never computed from a status. */
-    retryable: boolean;
-    /** The diagnostic for this occurrence. Never the headline a user reads. */
-    detail?: string;
-    /** Bulk operation item index (present on validation errors for array requests). */
-    index?: number;
-    /** The untouched body, so a caller can re-detect a shape this class does not model. */
-    raw?: unknown;
-    constructor(status: number, body: Partial<ApiErrorBody>, raw?: unknown);
-    /**
-     * A declared member of this error's type. ONE accessor, so the six known
-     * consumers (`constraint`, `row_version`, `did_you_mean`, `valid_parameters`,
-     * `threshold`, `width`) do not each invent an access pattern.
-     */
-    ext<T = unknown>(member: string): T | undefined;
-}
-/** The comparable identifier inside a `type`: its last path segment. */
-export declare function errorCodeOf(type: string | undefined): string;
-/** Whether a parsed JSON body is the platform's error object. */
-export declare function isApiErrorBody(body: unknown): body is ApiErrorBody;
-/**
- * Stable error codes for cursor-based list pagination. The server returns
- * these on ValidationError{Field:"after"} when an `after` token cannot be
- * resumed under current request conditions:
- *
- * - CURSOR_SEMANTICS_MISMATCH: the cursor was minted under different sort
- *   semantics (multi-column ordering, NULL placement). Server bumped its
- *   cursor format version since the cursor was issued.
- * - CURSOR_LANGUAGE_CHANGED: the cursor was minted in one language and the
- *   request now reads in another. Issued so multilang sort cannot silently
- *   re-order mid-pagination.
- *
- * UX contract for both: clear the `after` token and refetch page 1 under
- * the current conditions. EntityClient.list does this transparently;
- * direct apiFetch callers can recognise these codes to drive their own
- * retry logic.
- */
-export declare const CURSOR_SEMANTICS_MISMATCH = "cursor.semantics_mismatch";
-export declare const CURSOR_LANGUAGE_CHANGED = "cursor.language_changed";
-/**
- * A cross-store (Postgres-hot / ClickHouse-cold) archive cursor that the server
- * could not decode for this read - a malformed token, a tenant/entity mismatch,
- * or a retired bespoke-archive cursor minted before the native-cursor release.
- * Same recovery contract as the other two: drop `after`, refetch window 1.
- */
-export declare const ARCHIVE_CURSOR_INVALID = "cursor.archive_invalid";
-/** True if the error is a recoverable cursor-stale signal that warrants
- *  refetching page 1 instead of surfacing to the user. */
-export declare function isCursorStaleError(err: unknown): boolean;
-export type TenantEnv = "production" | "staging" | "dev" | (string & {});
-export interface Tenant {
-    id: string;
-    code: string;
-    name: string;
-    role: string;
-    env?: TenantEnv;
-    /**
-     * Whether the caller has a `tenant_users` row for this tenant. Always
-     * true for non-superadmins. For superadmins, `auth.list_tenants` also
-     * returns non-membership tenants reachable via cross-tenant authority;
-     * the switcher splits them into a separate "All tenants" section.
-     */
-    is_member?: boolean;
-}
-export interface AuthUser {
-    id: string;
-    email: string;
-    display_name: string;
-    is_active: boolean;
-    roles: string[];
-    permissions?: string[];
-    tenant?: Tenant;
-    /** Populated only when the request is acting under an impersonation session. */
-    impersonation?: ImpersonationInfo;
-    created_at: string;
-    updated_at: string;
-}
-/**
- * ImpersonationInfo is the read-side projection of the active session
- * surfaced by auth.me. Drives the banner, topbar chip, viewport frame,
- * and the "Exit impersonation" menu item.
- */
-export interface ImpersonationInfo {
-    session_id: string;
-    real_user_id: string;
-    real_user_email?: string;
-    target_user_id: string;
-    target_user_email?: string;
-    reason: string;
-    started_at: string;
-    expires_at: string;
-}
-export interface LoginResponse {
-    expires_at: string;
-    user: AuthUser;
-    tenant?: Tenant;
-}
-export interface CheckSetupResponse {
-    needs_setup: boolean;
-}
-export interface StatusInfo {
-    group_code: string;
-    status_code: string;
-    status_name: LocalizedString;
-    color?: string;
-    set_by?: string;
-    set_at: string;
-    note?: string;
-}
-export interface PropertyValue {
-    property_code: string;
-    name: LocalizedString;
-    type: string;
-    value: unknown;
-}
-export interface PublicParam {
-    code: string;
-    name: LocalizedString;
-    type: string;
-    structure?: string;
-    category: string;
-    description?: LocalizedString;
-    value: unknown;
-}
-/** Per-app legal/support URL set rendered in the auth-shell footer. */
-export interface PublicLegalLinks {
-    security_url?: string;
-    privacy_url?: string;
-    terms_url?: string;
-    docs_url?: string;
-}
-export interface BrandingIdentity {
-    app_name?: string;
-    app_logo?: string;
-    app_initial?: string;
-    ai_name?: string;
-    wordmark?: string;
-    version_label?: string;
-    status_url?: string;
-    auth_tagline?: LocalizedString;
-    auth_subtagline?: LocalizedString;
-    auth_badges?: LocalizedString[];
-    legal_entity?: string;
-    workspace_domain?: string;
-    legal_links?: PublicLegalLinks;
-}
-/**
- * Fourteen brand colors, each named EXACTLY after the CSS custom property it
- * writes, with underscores hyphenated: `surface_2` writes `--surface-2`. A
- * developer who set a field in YAML reaches the same token from their own
- * stylesheet without a lookup table. `branding.colorFields.test.ts` enforces
- * the mapping against the YAML structure, across languages.
- *
- * The shades that hang off these (`--accent-soft`, `--accent-ring`,
- * `--row-selected-bg`) are DERIVED from them and are not settable here: a
- * designer picks an accent, and the tints follow. A brand that wants a bespoke
- * tint sets the custom property in `theme.css_url`, with a plain rule and no
- * `!important`.
- */
-export interface BrandingThemeColors {
-    background?: string;
-    surface?: string;
-    surface_2?: string;
-    surface_3?: string;
-    text?: string;
-    text_2?: string;
-    text_3?: string;
-    border?: string;
-    divider?: string;
-    accent?: string;
-    accent_hover?: string;
-    accent_foreground?: string;
-    sidebar?: string;
-    rail?: string;
-}
-/**
- * Page-title typography. Scheme-independent: a title is the same size in light
- * and dark. Each field is named after the CSS custom property it writes:
- * `page_title_size` writes `--page-title-size`.
- *
- * Three surfaces render an `<h1>` page title at three sizes the designer chose
- * (list 20px, record 19px, page 18px). Declaring `page_title_size` overrides all
- * three at once; omitting it leaves each on its own designed default.
- */
-export interface BrandingTypography {
-    /** e.g. "15px". Overrides every page title's size. */
-    page_title_size?: string;
-    /** e.g. "22.5px" or "1.5". Overrides every page title's line height. */
-    page_title_line_height?: string;
-}
-/**
- * Brand colors keyed by color scheme. A scheme may be omitted entirely, or any
- * field within it omitted; the platform's own token for that scheme applies. A
- * value is NEVER copied from the other scheme - that is the bug this shape
- * exists to make impossible.
- */
-export interface BrandingThemeColorSchemes {
-    light?: BrandingThemeColors;
-    dark?: BrandingThemeColors;
-}
-export interface BrandingTheme {
-    css_url?: string;
-    font_sans?: string;
-    font_mono?: string;
-    typography?: BrandingTypography;
-    colors?: BrandingThemeColorSchemes;
-}
-/**
- * The deployment's DEFAULTS for the controls the Preferences screen renders,
- * and the single durable source of preference state: the browser stores
- * nothing. A user's toggle holds for the SPA session and resets to
- * these on reload.
- *
- * Wire shape is snake_case because it is YAML. `stores/preferences.ts` owns the
- * single translation into the camelCase store; add a field here and there, or
- * it will load, validate, and do nothing.
- */
-export interface BrandingPreferences {
-    color_scheme?: "light" | "dark";
-    accent?: "violet" | "blue" | "teal" | "amber" | "rose";
-    density?: "compact" | "comfortable" | "cozy";
-    sidebar?: "wide" | "collapsed";
-    tabs_position?: "top" | "bottom";
-    tabs_max_open?: number;
-    tabs_persist?: boolean;
-    radius?: number;
-    zebra_rows?: boolean;
-    ai_surface?: "command" | "panel" | "both" | "off";
-    toast_position?: "top-left" | "top-center" | "top-right" | "bottom-left" | "bottom-center" | "bottom-right";
-}
-/**
- * Per-surface chrome flags - mirrors the YAML `branding_surface_flags`
- * structure exactly. Kept distinct from {@link BrandingShellFlags}: the two
- * are different YAML structures, and conflating them let a caller ask a
- * surface for a shell flag that could never be set there.
- */
-export interface BrandingSurfaceFlags {
-    show_title?: boolean;
-    show_actions?: boolean;
-    show_count?: boolean;
-}
-/** Shell chrome flags - mirrors the YAML `branding_chrome_shell` structure. */
-export interface BrandingShellFlags {
-    show_topbar?: boolean;
-    show_rail?: boolean;
-    show_sidebar?: boolean;
-    show_tabs?: boolean;
-    show_breadcrumbs?: boolean;
-    show_tenant_switcher?: boolean;
-    show_command_palette?: boolean;
-    show_theme_toggle?: boolean;
-}
-/**
- * The device class the SDK renders for. `auto` derives it from the measured
- * viewport, which is what the platform has always done and what a deployment
- * that declares nothing keeps.
- */
-export type BrandingViewport = "auto" | "phone" | "tablet" | "desktop";
-/**
- * Where a deployment draws the device-class boundaries. Each key overrides one
- * bound of the SDK's default table; an omitted key keeps the default, so a
- * deployment moves the one boundary its devices need without restating the
- * others. A forced `viewport` bypasses the boundaries entirely and wins.
- */
-export interface BrandingBreakpoints {
-    phone_max?: number;
-    tablet_max?: number;
-    landscape_phone_max_height?: number;
-}
-export interface BrandingChrome {
-    full?: {
-        viewport?: BrandingViewport;
-        breakpoints?: BrandingBreakpoints;
-        shell?: BrandingShellFlags;
-        surfaces?: {
-            list?: BrandingSurfaceFlags;
-            detail?: BrandingSurfaceFlags;
-            record_list?: BrandingSurfaceFlags;
-            custom?: BrandingSurfaceFlags;
-        };
-    };
-    embed?: {
-        viewport?: BrandingViewport;
-        breakpoints?: BrandingBreakpoints;
-        surfaces?: {
-            list?: BrandingSurfaceFlags;
-            detail?: BrandingSurfaceFlags;
-            record_list?: BrandingSurfaceFlags;
-            custom?: BrandingSurfaceFlags;
-        };
-    };
-}
-/** Structured value of the public `branding` parameter. */
-export interface PublicBranding {
-    identity?: BrandingIdentity;
-    theme?: BrandingTheme;
-    preferences?: BrandingPreferences;
-    chrome?: BrandingChrome;
-}
-/**
- * Deploy-time identity exposed pre-login by /api/params/public so the
- * auth shell can render real region/build values (no mockup placeholders).
- * Each field is empty when unconfigured/unset; consumers hide the pill
- * when the entire block is missing or empty.
- */
-export interface PublicMeta {
-    version?: string;
-    revision?: string;
-    build_time?: string;
-    region?: string;
-}
-/** Envelope returned by GET /api/params/public. */
-export interface PublicParamsResponse {
-    parameters: PublicParam[];
-    accents?: Record<string, AccentDef>;
-    meta?: PublicMeta;
-}
-/**
- * Wire envelope for GET /api/params/{code}.
- *
- * The server always responds with HTTP 200. `found:false` means the
- * platform has no value for the code (undeclared, restricted-category,
- * or no value at any resolution layer); the caller substitutes its own
- * default. `found:true` means `value` is authoritative - even if it is
- * null/zero (an explicit nil value is a real value, not absence).
- *
- * The default never crosses the wire; servers don't track caller
- * defaults, so two callers with different defaults always see consistent
- * server state.
- */
-export interface ParamLookup {
-    code: string;
-    found: boolean;
-    value?: unknown;
-    source?: "object" | "user" | "role" | "tenant" | "env" | "yaml";
-    type?: string;
-}
-/**
- * One entry of the bulk `GET /api/params` response (and per-code resolution).
- * Carries the declaration facets the admin UIs need to compute attachment,
- * render structure editors, and render member selects, so the bulk endpoint is
- * self-sufficient without a second schema fetch.
- */
-export interface ResolvedParam {
-    code: string;
-    name: LocalizedString;
-    type: string;
-    category?: string;
-    description?: LocalizedString;
-    value: unknown;
-    source: "object" | "user" | "role" | "tenant" | "env" | "yaml" | "none";
-    /** Override levels the param accepts (reserved words or entity codes). */
-    scopes?: string[];
-    /** Structure code when `type === "structure"`. */
-    structure?: string;
-    /** Members of a closed type - `enum`, or an enum-backed `string_array`.
-     *  Carried whole rather than as bare codes so the editor can show a name. */
-    values?: EntityField["values"];
-    /** Shared enum this parameter names, when it names one rather than listing
-     *  its members inline. Present for display; `values` is what to render. */
-    enum?: string;
-    ref?: EntityField["ref"];
-}
-export interface ParamOverride {
-    param_code: string;
-    value: unknown;
-}
-export interface SSOProvider {
-    name: string;
-    slug: string;
-}
-export interface ListParams {
-    page?: number;
-    per_page?: number;
-    sort?: string;
-    search?: string;
-    /** JSON filter nodes (recursive AND/OR tree). */
-    filters?: FilterNode[];
-    include_deleted?: boolean;
-    expand?: string[];
-    screen?: string;
-    /** Return bounded display previews for fields that declare display.list_preview. */
-    preview?: boolean;
-    /**
-     * Field whitelist. When set, the server returns only these columns plus
-     * primary-key field(s) (auto-injected server-side). Filters/search/sort
-     * still operate against all fields regardless of select. Omit to fetch
-     * every column (default, backwards-compatible).
-     */
-    select?: string[];
-    /**
-     * Row-count strategy for this request. Maps to the `?count=` query param.
-     *   omitted / "window" - rows only, no total (the page-window request;
-     *                        the table never blocks on a count).
-     *   "only"             - total only, no rows (the follow-up count request).
-     *   "with"             - rows + total, using the entity's declared strategy.
-     *   "exact"            - rows + forced exact total.
-     */
-    count?: "window" | "only" | "with" | "exact";
-}
-/** Cursor-based pagination metadata returned by v2 List. */
-export interface V2Meta {
-    total: number;
-    limit: number;
-    has_more: boolean;
-    cursor?: string;
-    /** How `total` was produced: "exact" or "estimated". Absent when no count
-     *  was requested. A cross-store cursor total is always "estimated". */
-    count_mode?: string;
-    /** True when a count WAS requested but abandoned because the cold-tier count
-     *  would exceed the interactive scan bound (BC4b). The data window still
-     *  loaded; render NO total ("~N") - distinct from a real `total: 0`. */
-    count_unknown?: boolean;
-}
-/**
- * Refs map: keyed by entity code (or $-prefixed virtual entity code),
- * then by record ID, then field values.
- * Example: { company: { "uuid-1": { id: "uuid-1", name: "Acme" } } }
- */
-export type Refs = Record<string, Record<string, Record<string, unknown>>>;
-/** Per-row status instance. */
-export interface V2StatusInstance {
-    group_code: string;
-    status_code: string;
-    status_name?: Record<string, string>;
-    color?: string;
-    set_at?: string;
-    set_by?: string;
-    note?: string;
-}
-/** Per-row property instance. */
-export interface V2PropertyInstance {
-    property_code: string;
-    value: unknown;
-    updated_at?: string;
-    updated_by?: string;
-}
-/** Per-row parameter override. */
-/**
- * The last verification verdict of an evidence-covered row, shipped under the
- * row's `$evidence` key (the evidence satellite, mirroring `$statuses`). Read
- * cheaply from the stored verification result - never a live re-verify. Mirrors
- * the Go `evidence.RowVerdict`. `verdict` is one of: `verified`, `unverified`,
- * `tampered`, `indeterminate`, `outside_coverage`.
- */
-export interface EvidenceVerdict {
-    verdict: string;
-    verified_at?: string;
-    reason?: string;
-    seq?: number;
-    generation?: number;
-    covered: boolean;
-}
-export interface V2ParamInstance {
-    param_code: string;
-    value: unknown;
-}
-/** v2 List response with cursor pagination and response-level $refs. */
-export interface V2ListResponse<T = Record<string, unknown>> {
-    data: T[];
-    meta: V2Meta;
-    $refs?: Refs;
-}
-/** v2 List query parameters. */
-export interface V2ListParams {
-    select?: string[];
-    expand?: string[];
-    sort?: string;
-    search?: string;
-    filters?: FilterNode[];
-    limit?: number;
-    after?: string;
-    include_deleted?: boolean;
-    /** Request the (estimated) total alongside the window (`?count=with`). The
-     *  cursor UI sends this on the FIRST window only; later windows omit it. */
-    count?: boolean;
-    /** Screen code, so the server applies that screen's `fixed_filters` (a
-     *  cursor list of a `fixed_filters` view, e.g. the audit auth-log, needs
-     *  the same server-side prefilter the offset list gets). */
-    screen?: string;
-    /** Return display-bounded (truncated) values for list cells, matching the
-     *  offset list's `preview: true`. */
-    preview?: boolean;
-}
-/** Per-field resolved display unit codes. */
-export type Units = Record<string, string>;
-/**
- * A raw entity row: an untyped bag of field values keyed by field code. The
- * single canonical alias for `Record<string, unknown>` rows - import this
- * instead of re-declaring a local `RowData`/`RowData`. `EnrichedRow` is the
- * same bag plus typed `$`-prefixed sub-resources.
- */
-export type RowData = Record<string, unknown>;
-/** A row enriched with $-prefixed sub-resources (as returned by Get or write responses). */
-export interface EnrichedRow extends RowData {
-    $refs?: Refs;
-    $files?: Record<string, HydratedFile | HydratedFile[] | null>;
-    $statuses?: V2StatusInstance[];
-    $properties?: V2PropertyInstance[];
-    $params?: V2ParamInstance[];
-    $children?: Record<string, Record<string, unknown>[]>;
-    $units?: Units;
-    $evidence?: EvidenceVerdict;
-}
-/** readProblem is the ONE way this client reads a failing response.
- *
- *  It always consumes the body, even where only the status is acted on: an
- *  unread body leaves its stream - and the connection under it - open in the
- *  browser until garbage collection, and a page holding one never reaches
- *  network idle. A `/reset` page sat with one open refresh response for exactly
- *  that reason.
- *
- *  `raw` is the untouched body, which the batch re-detection still needs; `body`
- *  is it only when it IS the error object. Two top-level shapes arrive here: a
- *  flat error object HAS a `type`, and a processed batch result
- *  (`{status, success, errors}`) is deliberately not an error. */
-export declare function readProblem(res: Response): Promise<{
-    raw: unknown;
-    body: Partial<ApiErrorBody>;
-}>;

package/dist-lib/types/fieldType.d.ts

@@ -1,2 +0,0 @@
-export type FieldType = "uuid" | "string" | "text" | "rich_text" | "int" | "float" | "bool" | "date" | "time" | "timestamp" | "email" | "url" | "phone" | "enum" | "json" | "ref" | "tags" | "multilang" | "multilang_text" | "multilang_array" | "structure" | "secret" | "password" | "decimal" | "string_array" | "int_array" | "uuid_array" | "bytes";
-export declare const FIELD_TYPES: readonly FieldType[];

package/dist-lib/types/files.d.ts

@@ -1,79 +0,0 @@
-import type { LocalizedString } from "./schema";
-export type FileFieldMode = "single" | "array" | "named_map" | "rich_text_inline";
-export interface FileFieldDisplay {
-    widget: string;
-    placeholder?: LocalizedString;
-    initials?: boolean;
-    crop_on_upload?: boolean;
-    aspect_ratio?: string;
-    focal_point?: boolean;
-    is_listable?: boolean;
-    listable_thumbnail?: string;
-    reorderable?: boolean;
-    bulk_upload?: boolean;
-    bulk_download?: boolean;
-    lazy_load?: boolean;
-}
-export interface FileNamedSlotDef {
-    name: LocalizedString;
-    accepts?: string[];
-    max_size_bytes?: number;
-    aspect_ratio?: string;
-    storage_backend?: string;
-}
-export interface FileFieldDef {
-    /** The field's code, populated by the hydrator from the enclosing map key -
-     *  not a label a person reads. `OrderedMap.fromObject` takes bodies as
-     *  `Omit<_, "name">`, so a body cannot state it. */
-    name: string;
-    mode: FileFieldMode;
-    accepts?: string[];
-    max_size_bytes?: number;
-    max_count?: number;
-    max_total_size_bytes?: number;
-    required?: boolean;
-    slots?: Record<string, FileNamedSlotDef>;
-    display?: FileFieldDisplay;
-}
-export interface HydratedFile {
-    id: string;
-    filename: string;
-    content_type: string;
-    size_bytes: number;
-    sha256?: string;
-    width?: number;
-    height?: number;
-    page_count?: number;
-    uploaded_at?: string;
-    uploaded_by?: string;
-    url?: string;
-    presigned_url?: string;
-    derivations?: Record<string, string>;
-    metadata?: Record<string, unknown>;
-    position?: number;
-    slot?: string;
-    version?: {
-        number?: number;
-        is_current?: boolean;
-        supersedes_file_id?: string;
-    };
-}
-export type NamedFileFieldValue = Record<string, HydratedFile | null>;
-export type FileFieldValue = HydratedFile | HydratedFile[] | NamedFileFieldValue | null;
-export interface UploadProgress {
-    loaded: number;
-    total: number;
-    pct: number;
-}
-export interface UploadedFile {
-    id: string;
-    filename: string;
-    content_type: string;
-    size_bytes: number;
-    sha256: string;
-    dedup?: boolean;
-    width?: number;
-    height?: number;
-    url?: string;
-    metadata?: Record<string, unknown>;
-}

package/dist-lib/types/ordmap.d.ts

@@ -1,39 +0,0 @@
-/**
- * OrderedMap preserves the insertion order of a string-keyed map while
- * keeping O(1) lookup. It mirrors the Go `ordmap.OrderedMap[T]` container
- * on the server side. Use it for schema sub-maps (entity fields, handler
- * params, resolved_params) where YAML/JSON declaration order is part of
- * the UI contract.
- *
- * JS objects already preserve insertion order for string keys (ES2015+),
- * but the Go side emits JSON that is parsed into a plain object by
- * default — this class wraps the hydrated object so call sites get a
- * consistent API (`get`, `has`, iteration as `[name, value]` tuples) and
- * the type system enforces read-only access.
- */
-export declare class OrderedMap<T extends {
-    name?: string;
-}> implements Iterable<[string, T]> {
-    #private;
-    constructor(items: readonly T[]);
-    /** Build from a `{ name: body }` object written in code: the key supplies
-     * `name`, insertion order is the JS property order, and bodies are
-     * type-checked. The wire equivalent, whose bodies cannot be, is `fromWire`. */
-    static fromObject<T extends {
-        name?: string;
-    }>(raw: Readonly<Record<string, Omit<T, "name">>> | null | undefined): OrderedMap<T>;
-    /** Build from a `{ name: body }` object decoded from JSON. Bodies are
-     * `unknown` and the cast to T is a claim about the server's envelope, not a
-     * check; anything written in code goes through `fromObject`, which checks. */
-    static fromWire<T extends {
-        name?: string;
-    }>(raw: Readonly<Record<string, unknown>> | null | undefined): OrderedMap<T>;
-    get length(): number;
-    has(name: string): boolean;
-    get(name: string): T | undefined;
-    /** Read-only items in declaration order. */
-    items(): readonly T[];
-    /** Names in declaration order. */
-    names(): readonly string[];
-    [Symbol.iterator](): IterableIterator<[string, T]>;
-}