@reddb-io/ui-kit 0.3.4 → 0.3.5

package/vendor/ds/kits/app/src/core/contracts/commandpalette.ts

@@ -0,0 +1,24 @@
+import type { CommandPaletteCommand } from "../../composites/command-palette.behavior";
+
+/** Portable CommandPalette properties shared by native adapters. */
+export interface CommandPaletteContract {
+/** Accessible name and visible fallback for the invoking Button. */
+    triggerLabel: string;
+/** Accessible name for the Popover dialog. */
+    contentLabel: string;
+/** Visible Field label for command search. */
+    label: string;
+/** Caller-owned command names and business actions. */
+    commands?: readonly CommandPaletteCommand[];
+/** Whether the palette is open: `bind:open` (ADR 0026). */
+    open?: boolean;
+/** Disables the trigger Button, so the palette cannot be opened. Defaults to `false`. */
+    disabled?: boolean;
+/**
+     * Extra classes, merged over the content slot's own, onto the Popover surface that holds the
+     * search.
+     */
+    contentClass?: string;
+/** Extra classes merged onto the command search input. */
+    inputClass?: string;
+}

package/vendor/ds/kits/app/src/core/contracts/contextmenu.ts

@@ -0,0 +1,30 @@
+import type { ContextMenuEntry } from "../../composites/command-surfaces.behavior";
+import type { ContextMenuSize } from "../../composites/context-menu.variants";
+
+/** Portable ContextMenu properties shared by native adapters. */
+export interface ContextMenuContract {
+/**
+     * Accessible name for the trigger Button, and its visible text when no `children` are given.
+     */
+    triggerLabel: string;
+/** Accessible name for the opened menu surface. */
+    contentLabel: string;
+/**
+     * Menu rows and groups in display order; a group's `heading` names it and groups are divided by
+     * a separator.
+     */
+    items?: readonly ContextMenuEntry[];
+/** Whether the menu is open: `bind:open` (ADR 0026). */
+    open?: boolean;
+/**
+     * Disables the trigger, so the menu cannot be opened by pointer or keyboard. Defaults to
+     * `false`.
+     */
+    disabled?: boolean;
+/** Size of the trigger and of the menu rows: `sm`, `md` or `lg`. Defaults to `md`. */
+    size?: ContextMenuSize;
+/** Safe distance, in pixels, kept between the menu and the viewport edges. Defaults to `8`. */
+    collisionPadding?: number;
+/** Extra classes merged onto the trigger Button, the element that opens the menu. */
+    targetClass?: string;
+}

package/vendor/ds/kits/app/src/core/contracts/diff.ts

@@ -0,0 +1,18 @@
+import type { DiffRow } from "../diff";
+import type { DiffMode } from "../../composites/diff.variants";
+
+/** Portable Diff properties shared by native adapters. */
+export interface DiffContract {
+/** Accessible name for this comparison. */
+    label?: string;
+/** Caller-computed lines in display order. */
+    rows: readonly DiffRow[];
+/** Unified reading order or aligned resizable panes. */
+    mode?: DiffMode;
+/** Visible and accessible name for the old side. */
+    beforeLabel?: string;
+/** Visible and accessible name for the new side. */
+    afterLabel?: string;
+/** Accessible name for the side-by-side resize control. */
+    separatorLabel?: string;
+}

package/vendor/ds/kits/app/src/core/contracts/entityinspector.ts

@@ -0,0 +1,25 @@
+import type { InspectorEntity } from "../entity-inspector";
+export interface EntityInspectorContract {
+  /** Accessible name of the inspector region. */
+  label: string;
+  /** Entities in navigation order; filtering and selection remain caller-owned. */
+  items: readonly InspectorEntity[];
+  /** Selected entity id; null or a missing id shows the empty state. */
+  selected: string | null;
+  /** Optional visible context path above the title. */
+  context?: string;
+  /** Requests another selection without changing application state. */
+  onselectedchange?: (id: string) => void;
+  /** Optional close action; omitted, no close control is rendered. */
+  ondismiss?: () => void;
+  /** Visible previous-entity action label. */
+  previousLabel?: string;
+  /** Visible next-entity action label. */
+  nextLabel?: string;
+  /** Visible close-action label. */
+  closeLabel?: string;
+  /** Empty-state explanation when no entity is selected. */
+  emptyLabel?: string;
+  /** Heading level within the surrounding document. */
+  headingLevel?: 2 | 3 | 4 | 5 | 6;
+}

package/vendor/ds/kits/app/src/core/contracts/entityjourney.ts

@@ -0,0 +1,14 @@
+import type { JourneyStage } from "../entity-journey";
+/** Portable execution trail with caller-owned state and selection. */
+export interface EntityJourneyContract {
+  /** Accessible name for the ordered trail. */
+  label: string;
+  /** Ordered observed stages; no overall completion is inferred. */
+  items: readonly JourneyStage[];
+  /** Inspected stage, independent of current execution state. */
+  selected?: string | null;
+  /** Requests inspection; omitted, the trail is read-only. */
+  onselectedchange?: (id: string) => void;
+  /** Explanation when no stages are present. */
+  emptyLabel?: string;
+}

package/vendor/ds/kits/app/src/core/contracts/filter.ts

@@ -0,0 +1,22 @@
+import type { FilterOption } from "../../composites/filter.variants";
+
+/** Portable Filter properties shared by native adapters. */
+export interface FilterContract {
+/** Visible name for the related filter choices. */
+    legend: string;
+/** Caller-owned choices; exactly one is announced as pressed. */
+    options: readonly FilterOption[];
+/** Active value; an absent value selects the first enabled option. */
+    value?: string;
+/** Optional native form name for the active value. */
+    name?: string;
+/** Disables the whole group and every option. Defaults to `false`. */
+    disabled?: boolean;
+/**
+     * Extra classes, merged over the list slot's own, onto the element that wraps the option
+     * buttons.
+     */
+    listClass?: string;
+/** Extra classes merged onto each option button. */
+    optionClass?: string;
+}

package/vendor/ds/kits/app/src/core/contracts/incentive.ts

@@ -0,0 +1,11 @@
+import type { SectionHeadingLevel } from "@reddb-io/design-system/base";
+
+/** Portable Incentive properties shared by native adapters. */
+export interface IncentiveContract {
+/** Heading text for the proposition; it is also the region's accessible name. */
+    title: string;
+/** Supporting line under the title. Nothing is rendered when omitted. */
+    description?: string;
+/** Outline depth of the heading, `1` to `6`. Defaults to `2`. */
+    level?: SectionHeadingLevel;
+}

package/vendor/ds/kits/app/src/core/contracts/listrow.ts

@@ -0,0 +1,15 @@
+import type { ListRowSize } from "../../primitives/list-row.variants";
+
+/** Portable ListRow properties shared by native adapters. */
+export interface ListRowContract {
+/** The row's primary line. Ignored when a `children` snippet is given. */
+    title?: string;
+/** The secondary line under the title. */
+    description?: string;
+/** Renders the row as a link to here. */
+    href?: string;
+/** Row height and inset: `md` (the default) or `sm`. */
+    size?: ListRowSize;
+/** Mark the row as the one the list is currently about. */
+    selected?: boolean;
+}

package/vendor/ds/kits/app/src/core/contracts/menubar.ts

@@ -0,0 +1,28 @@
+import type { MenubarMenu } from "../../composites/command-surfaces.behavior";
+import type { MenubarSize } from "../../composites/menubar.variants";
+
+/** Portable Menubar properties shared by native adapters. */
+export interface MenubarContract {
+/** Accessible name for the menubar. */
+    label: string;
+/**
+     * Top-level menus in order; each has an `id`, a trigger `label` and its `items`, and may be
+     * `disabled`.
+     */
+    menus?: readonly MenubarMenu[];
+/** The open menu's id, `""` when none is open: `bind:value` (ADR 0026). */
+    value?: string;
+/** Size of the trigger buttons and the menu rows: `sm`, `md` or `lg`. Defaults to `md`. */
+    size?: MenubarSize;
+/**
+     * Whether arrow-key focus wraps from the last menu back to the first, and the reverse. Defaults
+     * to `true`.
+     */
+    loop?: boolean;
+/** Distance, in pixels, between an open menu and its trigger. Defaults to `8`. */
+    sideOffset?: number;
+/**
+     * Safe distance, in pixels, kept between an open menu and the viewport edges. Defaults to `8`.
+     */
+    collisionPadding?: number;
+}

package/vendor/ds/kits/app/src/core/contracts/multicolumnlayout.ts

@@ -0,0 +1,7 @@
+import type { StackGap } from "@reddb-io/design-system/base";
+
+/** Portable MultiColumnLayout properties shared by native adapters. */
+export interface MultiColumnLayoutContract {
+/** Vertical rhythm inside every column. Defaults to the layout tier's `layout-md`. */
+    gap?: StackGap;
+}

package/vendor/ds/kits/app/src/core/contracts/navitem.ts

@@ -0,0 +1,17 @@
+
+type CurrentToken = "page" | "step" | "location" | "date" | "time" | "true";
+/** Portable NavItem properties shared by native adapters. */
+export interface NavItemContract {
+/** The item's text. Ignored when a `children` snippet is given. */
+    label?: string;
+/** Where the item goes. Absent, the item is a <button>. */
+    href?: string;
+/**
+     * Is this the current destination (ADR 0026)? `true` announces it as the
+     * current `page`; a token names what it is current within — `step`
+     * inside a wizard, `location` inside a breadcrumb trail. Defaults to false.
+     */
+    current?: boolean | CurrentToken;
+/** Unavailable for now: dimmed, and out of the tab order. */
+    disabled?: boolean;
+}

package/vendor/ds/kits/app/src/core/contracts/nodebadge.ts

@@ -0,0 +1,11 @@
+import type { NodeStatus } from "../../primitives/node-badge.variants";
+
+/** Portable NodeBadge properties shared by native adapters. */
+export interface NodeBadgeContract {
+/** The node's name, as the cluster knows it. */
+    name: string;
+/** Reachability. Defaults to `unknown` — no reading is not a good reading. */
+    status?: NodeStatus;
+/** Draw the status word beside the name. Defaults to true. */
+    showStatus?: boolean;
+}

package/vendor/ds/kits/app/src/core/contracts/orderhistory.ts

@@ -0,0 +1,25 @@
+import type { SectionHeadingLevel } from "@reddb-io/design-system/base";
+import type { OrderHistoryEntry, OrderHistoryLabels } from "../../composites/order-history.variants";
+
+/** Portable OrderHistory properties shared by native adapters. */
+export interface OrderHistoryContract {
+/**
+     * Heading text for the history; it is also the section's accessible name unless `aria-label` is
+     * given.
+     */
+    title: string;
+/** Outline depth of the heading, `1` to `6`. Defaults to `2`. */
+    level?: SectionHeadingLevel;
+/** Caption of the order table, shown above it and used as the table's accessible name. */
+    caption: string;
+/**
+     * Caller-owned orders in display order, one row each: `id`, `placed`, `placedAt`, `status` and
+     * `total`.
+     */
+    orders: readonly OrderHistoryEntry[];
+/**
+     * Overrides for the column headers (`order`, `placed`, `status`, `total`); omitted keys keep
+     * their defaults.
+     */
+    labels?: Partial<OrderHistoryLabels>;
+}

package/vendor/ds/kits/app/src/core/contracts/ordersummary.ts

@@ -0,0 +1,19 @@
+import type { SectionHeadingLevel } from "@reddb-io/design-system/base";
+import type { OrderSummaryLine } from "../../composites/order-summary.variants";
+
+/** Portable OrderSummary properties shared by native adapters. */
+export interface OrderSummaryContract {
+/**
+     * Heading text for the summary; it is also the region's accessible name unless `aria-label` is
+     * given.
+     */
+    title: string;
+/** Outline depth of the heading, `1` to `6`. Defaults to `2`. */
+    level?: SectionHeadingLevel;
+/** Caller-owned amounts or facts shown as label and value pairs above the total, in order. */
+    lines: readonly OrderSummaryLine[];
+/** Visible label of the total row. */
+    totalLabel: string;
+/** Caller-formatted total amount, announced politely whenever it changes. */
+    total: string;
+}

package/vendor/ds/kits/app/src/core/contracts/pageheading.ts

@@ -0,0 +1,9 @@
+
+
+/** Portable PageHeading properties shared by native adapters. */
+export interface PageHeadingContract {
+/** The page's title, rendered as the page's one level-1 heading. */
+    title: string;
+/** Supporting line under the title. Nothing is rendered when omitted. */
+    description?: string;
+}

package/vendor/ds/kits/app/src/core/contracts/phasesummary.ts

@@ -0,0 +1,9 @@
+import type { PhaseGate } from "../operational";
+export interface PhaseSummaryContract {
+  /** Name of this independently verified phase collection. */
+  label: string;
+  /** Caller-owned execution, verification and approval gates. */
+  gates: readonly PhaseGate[];
+  /** Overall reading supplied by the caller; never inferred from a percentage. */
+  description?: string;
+}

package/vendor/ds/kits/app/src/core/contracts/pill.ts

@@ -0,0 +1,17 @@
+import type { Tone } from "@reddb-io/design-system/base";
+import type { DeprecatedPillVariant, PillSize, PillVariant } from "../../primitives/pill.variants";
+
+/** Portable Pill properties shared by native adapters. */
+export interface PillContract {
+/** What the Pill means: the shared tone vocabulary (ADR 0026). Defaults to `neutral`. */
+    tone?: Tone;
+/**
+     * How strongly the tone is drawn: `tinted` (default), `filled` or
+     * `outline`. `neutral` and `primary` are deprecated for one release.
+     */
+    variant?: PillVariant | DeprecatedPillVariant;
+/** Defaults to `md`. */
+    size?: PillSize;
+/** Accessible name for the dismiss affordance. */
+    dismissLabel?: string;
+}

package/vendor/ds/kits/app/src/core/contracts/playbackcontrols.ts

@@ -0,0 +1,20 @@
+export interface PlaybackControlsContract {
+  /** Accessible name of the replay controls. */
+  label: string;
+  /** Caller-owned running state; this component never starts a timer. */
+  playing: boolean;
+  /** Caller-owned position in the same unit as duration. */
+  position: number;
+  /** End of the replay range. */
+  duration: number;
+  /** Current playback multiplier. */
+  speed?: number;
+  /** Reports play/pause intent; omitted, the action is disabled. */
+  onplayingchange?: (playing: boolean) => void;
+  /** Reports a requested position; omitted, seeking is disabled. */
+  onpositionchange?: (position: number) => void;
+  /** Reports a speed request; omitted, speed selection is disabled. */
+  onspeedchange?: (speed: number) => void;
+  /** Requests one next step; omitted, the action is disabled. */
+  onstep?: () => void;
+}

package/vendor/ds/kits/app/src/core/contracts/productfeature.ts

@@ -0,0 +1,14 @@
+import type { SectionHeadingLevel } from "@reddb-io/design-system/base";
+import type { ProductFeatureMediaSide } from "../../composites/product-feature.variants";
+
+/** Portable ProductFeature properties shared by native adapters. */
+export interface ProductFeatureContract {
+/** Heading text for the feature; it is also the region's accessible name. */
+    title: string;
+/** Supporting line under the title. Nothing is rendered when omitted. */
+    description?: string;
+/** Outline depth of the heading, `1` to `6`. Defaults to `2`. */
+    level?: SectionHeadingLevel;
+/** Which side of the content the media sits on: `start` or `end`. Defaults to `start`. */
+    mediaSide?: ProductFeatureMediaSide;
+}

package/vendor/ds/kits/app/src/core/contracts/productlist.ts

@@ -0,0 +1,17 @@
+import type { GridListColumn } from "@reddb-io/design-system/base";
+import type { ProductListItem } from "../product-list";
+
+/** Portable ProductList properties shared by native adapters. */
+export interface ProductListContract {
+/** Required accessible name for the product collection. */
+    label: string;
+/** Product content remains consumer-owned and is rendered in the given order. */
+    items: readonly ProductListItem[];
+/** Number of grid columns for the products: `1`, `2`, `3` or `4`. Defaults to `2`. */
+    columns?: GridListColumn;
+/**
+     * Outline level of each product name, `2` to `6` (default `3`). Set it one below the
+     * heading that introduces the collection so the page outline never skips a level.
+     */
+    headingLevel?: 2 | 3 | 4 | 5 | 6;
+}

package/vendor/ds/kits/app/src/core/contracts/productoverview.ts

@@ -0,0 +1,20 @@
+import type { ImageAsset, SectionHeadingLevel } from "@reddb-io/design-system/base";
+
+/** Portable ProductOverview properties shared by native adapters. */
+export interface ProductOverviewContract {
+/** Heading text for the product; it is also the section's accessible name. */
+    title: string;
+/** Supporting line under the title. Nothing is rendered when omitted. */
+    description?: string;
+/** Caller-formatted price, shown under the heading. Nothing is rendered when omitted. */
+    price?: string;
+/** Outline depth of the heading, `1` to `6`. Defaults to `2`. */
+    level?: SectionHeadingLevel;
+/**
+     * The product imagery as an image the app's pipeline produced, rendered through the Base Image; ignored
+     * when a `media` snippet is given.
+     */
+    image?: ImageAsset;
+/** The `image` is the page's Largest Contentful Paint: fetched eagerly at high priority. */
+    priority?: boolean;
+}

package/vendor/ds/kits/app/src/core/contracts/productquickview.ts

@@ -0,0 +1,16 @@
+
+
+/** Portable ProductQuickview properties shared by native adapters. */
+export interface ProductQuickviewContract {
+/**
+     * Accessible name for the Button that opens the dialog, and its visible text when no `trigger`
+     * is given.
+     */
+    triggerLabel: string;
+/** Visible dialog title and the dialog's accessible name. */
+    title: string;
+/** Supporting line under the title, associated with the dialog as its description. */
+    description?: string;
+/** Extra classes, merged over the dialog slot's own, onto the modal surface. */
+    dialogClass?: string;
+}

package/vendor/ds/kits/app/src/core/contracts/propertypanel.ts

@@ -0,0 +1,9 @@
+import type { PropertyItem } from "../operational";
+export interface PropertyPanelContract {
+  /** Visible and accessible panel name. */
+  title: string;
+  /** Read-only properties, already formatted by the caller. */
+  items: readonly PropertyItem[];
+  /** Additional context below the title. */
+  description?: string;
+}

package/vendor/ds/kits/app/src/core/contracts/review.ts

@@ -0,0 +1,22 @@
+
+
+/** Portable Review properties shared by native adapters. */
+export interface ReviewContract {
+/** Visible and accessible reviewer name. */
+    author: string;
+/**
+     * Image source for the reviewer's avatar. When omitted or unloadable, `avatarFallback` is shown
+     * instead.
+     */
+    avatarSrc?: string;
+/** Visible fallback when the reviewer's image is unavailable. */
+    avatarFallback: string;
+/** Read-only score shown through native state, symbols, and text. */
+    rating: number;
+/** Highest possible score, which sets how many rating stops are drawn. Defaults to `5`. */
+    maxRating?: number;
+/** Optional machine-readable review date or time. */
+    datetime?: string;
+/** Caller-owned visible rendering of the review date or time. */
+    time?: string;
+}

package/vendor/ds/kits/app/src/core/contracts/settingsrow.ts

@@ -0,0 +1,13 @@
+/** Shared content and native association contract for a settings row. */
+export interface SettingsRowContract {
+  /** Visible setting name, used to label the field when a control snippet is supplied. */
+  label: string;
+  /** Supporting text, associated as a description rather than included in the control name. */
+  description?: string;
+  /** Validation message associated with the field and announced as an alert. */
+  error?: string;
+  /** Marks the field as required, visually and through native attributes. */
+  required?: boolean;
+  /** Stable control id. Generated by the native adapter when omitted. */
+  id?: string;
+}

package/vendor/ds/kits/app/src/core/contracts/shoppingcart.ts

@@ -0,0 +1,29 @@
+import type { SectionHeadingLevel } from "@reddb-io/design-system/base";
+import type { ShoppingCartItem } from "../shopping-cart";
+
+/** Portable ShoppingCart properties shared by native adapters. */
+export interface ShoppingCartContract {
+/**
+     * Heading text for the cart; it is also the form's accessible name unless `aria-label` is
+     * given.
+     */
+    title: string;
+/**
+     * Outline depth of the cart heading, `1` to `6`; item names sit one level lower. Defaults to
+     * `2`.
+     */
+    level?: SectionHeadingLevel;
+/**
+     * Caller-owned cart rows in display order, each with name, price, quantity and optional media.
+     * When empty, `empty` is shown.
+     */
+    items: readonly ShoppingCartItem[];
+/** Visible label of the total row. */
+    totalLabel: string;
+/** Caller-formatted total amount, announced politely whenever it changes. */
+    total: string;
+/** Extra classes, merged over the item slot's own, onto each cart row. */
+    itemClass?: string;
+/** Extra classes, merged over the quantity slot's own, onto each row's quantity input. */
+    quantityClass?: string;
+}

package/vendor/ds/kits/app/src/core/contracts/sidebarlayout.ts

@@ -0,0 +1,40 @@
+import type { StackGap } from "@reddb-io/design-system/base";
+import type { SidebarSide } from "../../composites/sidebar-layout.variants";
+import type { PrimaryNavigationItem } from "../../composites/navigation.behavior";
+
+/** Portable SidebarLayout properties shared by native adapters. */
+export interface SidebarLayoutContract {
+/** Logical edge occupied by the complementary landmark. */
+    side?: SidebarSide;
+/** Accessible name that distinguishes this complementary landmark. */
+    sidebarLabel?: string;
+/**
+     * Id of the main region, the skip link's focus target. Defaults to `main-content` while the
+     * region is the page's `<main>`; a region inside an ApplicationShell takes no id unless given
+     * one, so it never duplicates the shell's.
+     */
+    mainId?: string;
+/**
+     * Whether the main region renders the page's `<main>` landmark. Defaults to `true`, or to
+     * `false` inside an ApplicationShell, which owns `<main>`; the region is then a plain `div`.
+     */
+    main?: boolean;
+/** Allow primary navigation to become a mobile bottom dock. Defaults to true in navigation mode; false keeps the rail vertical. Workspace rail snippets are unaffected. */
+    dockable?: boolean;
+/** Primary page sections: href entries navigate, entries without href open sidebar. On wide screens renders a rail, on mobile a bottom bar. Workspace rails can keep using the rail snippet. */
+    navigation?: readonly PrimaryNavigationItem[];
+/** Current primary destination, owned by the application. Required and unique when navigation is supplied; opening a section never changes it. */
+    currentId?: string;
+/** Accessible name of the primary navigation. Defaults to Main navigation. */
+    navigationLabel?: string;
+/** Show each primary rail destination label below its icon or initials. Mobile dock labels remain visible independently. */
+    showRailLabels?: boolean;
+/** Visible name of the overflow menu when more than five primary items are supplied. Defaults to More. */
+    moreLabel?: string;
+/** Externally bindable visibility of the compact navigation rail. */
+    railOpen?: boolean;
+/** Externally bindable visibility of the sidebar panel on mobile. */
+    panelOpen?: boolean;
+/** Vertical rhythm inside both landmarks. Defaults to the layout tier's `layout-md`. */
+    gap?: StackGap;
+}

package/vendor/ds/kits/app/src/core/contracts/sidebarnavigation.ts

@@ -0,0 +1,16 @@
+import type { ApplicationNavigationItem } from "../../composites/navigation.behavior";
+
+/** Portable SidebarNavigation properties shared by native adapters. */
+export interface SidebarNavigationContract {
+/** Accessible name for the `nav` landmark. */
+    label: string;
+/** Destinations, one link per entry in the given order; each `id` must be unique. */
+    items: readonly ApplicationNavigationItem[];
+/**
+     * The `id` of the item for the current page. It must match exactly one entry in `items`, or the
+     * component throws.
+     */
+    currentId: string;
+/** Accessible name for the contextual action group. */
+    toolbarLabel?: string;
+}

package/vendor/ds/kits/app/src/core/contracts/sidebarpanel.ts

@@ -0,0 +1,22 @@
+import type { Tone } from "@reddb-io/design-system/base";
+import type { NavigationStatus } from "../../composites/navigation.behavior";
+
+/** Portable SidebarPanel properties shared by native adapters. */
+export interface SidebarPanelContract {
+/** Visible panel heading and accessible region name. */
+    title: string;
+/** Optional header notification count or short text. Numeric counts above 99 display 99+ while retaining the exact accessible count. */
+    badge?: number | string;
+/** Complete accessible notification description. */
+    badgeLabel?: string;
+/** Semantic notification tone. Defaults to neutral. */
+    badgeTone?: Tone;
+/** Application-owned presence or health shown beside the heading. */
+    status?: NavigationStatus;
+/** Heading outline depth, independent of its compact visual size. */
+    headingLevel?: 2 | 3 | 4 | 5 | 6;
+/** Optional contextual back destination. No back control is rendered without it. */
+    backHref?: string;
+/** Visible name for the contextual back link. */
+    backLabel?: string;
+}

package/vendor/ds/kits/app/src/core/contracts/sidebarrail.ts

@@ -0,0 +1,13 @@
+import type { SidebarRailItem } from "../sidebar-rail";
+
+/** Portable SidebarRail properties shared by native adapters. */
+export interface SidebarRailContract {
+/** Accessible name for this navigation landmark. */
+    label: string;
+/** Caller-owned actions, organizations, and optional add affordance. */
+    items: readonly SidebarRailItem[];
+/** Caller-owned current identity (ADR 0026); SidebarRail never changes it. */
+    currentId?: string;
+/** Show the destination label below its icon or initials. The rail widens and long labels wrap; defaults to icon-only. */
+    showLabels?: boolean;
+}

package/vendor/ds/kits/app/src/core/contracts/speeddial.ts

@@ -0,0 +1,32 @@
+import type { SpeedDialAction } from "../../composites/command-surfaces.behavior";
+import type { SpeedDialSize } from "../../composites/speed-dial.variants";
+type Side = "top" | "right" | "bottom" | "left";
+type Align = "start" | "center" | "end";
+/** Portable SpeedDial properties shared by native adapters. */
+export interface SpeedDialContract {
+/** Accessible name for the trigger Button, and its visible text when no `trigger` is given. */
+    triggerLabel: string;
+/** Accessible name for the revealed actions surface. */
+    contentLabel: string;
+/** Actions revealed in order; each renders as a button, or as a link when it has an `href`. */
+    actions?: readonly SpeedDialAction[];
+/** Whether the actions are revealed: `bind:open` (ADR 0026). */
+    open?: boolean;
+/** Disables the trigger, so the actions cannot be revealed. Defaults to `false`. */
+    disabled?: boolean;
+/** Size of the trigger and of the action buttons: `sm`, `md` or `lg`. Defaults to `md`. */
+    size?: SpeedDialSize;
+/**
+     * Preferred side of the trigger the actions open on; collision handling may flip it. Defaults
+     * to `top`.
+     */
+    side?: Side;
+/** Preferred alignment along the chosen side: `start`, `center` or `end`. Defaults to `end`. */
+    align?: Align;
+/** Distance, in pixels, between the trigger and the revealed actions. Defaults to `8`. */
+    sideOffset?: number;
+/**
+     * Safe distance, in pixels, kept between the actions and the viewport edges. Defaults to `8`.
+     */
+    collisionPadding?: number;
+}

package/vendor/ds/kits/app/src/core/contracts/splitview.ts

@@ -0,0 +1,15 @@
+import type { SplitOrientation } from "../../primitives/split-view.behavior";
+
+/** Portable SplitView properties shared by native adapters. */
+export interface SplitViewContract {
+/** Axis the panes are laid out along. Defaults to `horizontal`. */
+    orientation?: SplitOrientation;
+/** How much of the container the start pane takes, 0–1. Bindable. */
+    fraction?: number;
+/** Smallest fraction the start pane may shrink to. */
+    min?: number;
+/** Largest fraction it may grow to. */
+    max?: number;
+/** Accessible name for the divider. */
+    label?: string;
+}