@texuli/spec 0.8.0 → 0.10.0

package/dist/generated/typescript/design-system.d.ts

@@ -0,0 +1,1110 @@
+/** Accessibility targets: contrast, minimum target size and the focus style. */
+export interface DesignSystemAccessibility {
+    contrast?: 'AA' | 'AAA';
+    focus?: 'ring' | 'outline' | 'glow' | 'inset';
+    focusOffset?: number;
+    focusWidth?: number;
+    targetMin?: number;
+}
+/** At most 32768 bytes inline; data URLs need developer trust. */
+export type DesignSystemAsset = string;
+/** Brand assets: logos and the favicon. */
+export interface DesignSystemAssets {
+    /** At most 8192 bytes inline; data URLs need developer trust. */
+    favicon?: string;
+    logo?: DesignSystemAssetsLogo;
+}
+export interface DesignSystemAssetsLogo {
+    dark?: DesignSystemAsset;
+    light?: DesignSystemAsset;
+    mark?: DesignSystemAsset;
+    wordmark?: DesignSystemAsset;
+}
+/** A border width step. */
+export type DesignSystemBorderStep = 'none' | 'thin' | 'thick';
+/**
+ * Color: brand seeds, exact pins, explicit role pins per mode, modes, data viz per mode and status
+ * colors.
+ */
+export interface DesignSystemColor {
+    brand?: DesignSystemColorBrand;
+    dataViz?: DesignSystemColorDataViz;
+    /** Unique items. */
+    modes?: readonly ('light' | 'dark')[];
+    pin?: DesignSystemColorPin;
+    roles?: DesignSystemColorRoles;
+    status?: DesignSystemColorStatus;
+}
+export interface DesignSystemColorBrand {
+    accent?: DesignSystemColorValue;
+    neutral?: 'zinc' | 'slate' | 'stone' | 'gray' | 'warm' | 'cool' | 'tinted';
+    secondary?: DesignSystemColorValue;
+    seed: DesignSystemColorValue;
+}
+export interface DesignSystemColorDataViz {
+    cvdSafe?: boolean;
+    dark?: DesignSystemDataVizPalette;
+    light?: DesignSystemDataVizPalette;
+}
+export interface DesignSystemColorPin {
+    accent?: DesignSystemColorValue;
+    destructive?: DesignSystemColorValue;
+    info?: DesignSystemColorValue;
+    primary?: DesignSystemColorValue;
+    secondary?: DesignSystemColorValue;
+    success?: DesignSystemColorValue;
+    warning?: DesignSystemColorValue;
+}
+export interface DesignSystemColorRoles {
+    dark?: DesignSystemRoleMap;
+    light?: DesignSystemRoleMap;
+}
+export interface DesignSystemColorStatus {
+    danger?: DesignSystemColorValue;
+    info?: DesignSystemColorValue;
+    neutral?: DesignSystemColorValue;
+    success?: DesignSystemColorValue;
+    warning?: DesignSystemColorValue;
+}
+/** A color: #rgb, #rrggbb, #rrggbbaa or a numeric oklch(L C H[ / A]). */
+export type DesignSystemColorValue = string;
+/**
+ * Component tokens (the token registry, z-index left out) and defaults (variant and size), per
+ * component.
+ */
+export interface DesignSystemComponents {
+    accordion?: DesignSystemComponentsAccordion;
+    alert?: DesignSystemComponentsAlert;
+    'aspect-ratio'?: DesignSystemComponentsAspectRatio;
+    avatar?: DesignSystemComponentsAvatar;
+    badge?: DesignSystemComponentsBadge;
+    board?: DesignSystemComponentsBoard;
+    breadcrumb?: DesignSystemComponentsBreadcrumb;
+    button?: DesignSystemComponentsButton;
+    'canvas-toolbar'?: DesignSystemComponentsCanvasToolbar;
+    card?: DesignSystemComponentsCard;
+    carousel?: DesignSystemComponentsCarousel;
+    'chart-frame'?: DesignSystemComponentsChartFrame;
+    'chat-bubble'?: DesignSystemComponentsChatBubble;
+    'chat-composer'?: DesignSystemComponentsChatComposer;
+    chip?: DesignSystemComponentsChip;
+    choice?: DesignSystemComponentsChoice;
+    code?: DesignSystemComponentsCode;
+    'color-picker'?: DesignSystemComponentsColorPicker;
+    combobox?: DesignSystemComponentsCombobox;
+    command?: DesignSystemComponentsCommand;
+    'copy-button'?: DesignSystemComponentsCopyButton;
+    'data-grid'?: DesignSystemComponentsDataGrid;
+    date?: DesignSystemComponentsDate;
+    dialog?: DesignSystemComponentsDialog;
+    empty?: DesignSystemComponentsEmpty;
+    field?: DesignSystemComponentsField;
+    'file-upload'?: DesignSystemComponentsFileUpload;
+    forms?: DesignSystemComponentsForms;
+    icon?: DesignSystemComponentsIcon;
+    'icon-button'?: DesignSystemComponentsIconButton;
+    input?: DesignSystemComponentsInput;
+    kbd?: DesignSystemComponentsKbd;
+    label?: DesignSystemComponentsLabel;
+    menu?: DesignSystemComponentsMenu;
+    navigation?: DesignSystemComponentsNavigation;
+    'number-field'?: DesignSystemComponentsNumberField;
+    pagination?: DesignSystemComponentsPagination;
+    'pin-input'?: DesignSystemComponentsPinInput;
+    popover?: DesignSystemComponentsPopover;
+    progress?: DesignSystemComponentsProgress;
+    'radio-group'?: DesignSystemComponentsRadioGroup;
+    rating?: DesignSystemComponentsRating;
+    resizable?: DesignSystemComponentsResizable;
+    'resizable-handle'?: DesignSystemComponentsResizableHandle;
+    'scroll-area'?: DesignSystemComponentsScrollArea;
+    select?: DesignSystemComponentsSelect;
+    separator?: DesignSystemComponentsSeparator;
+    sheet?: DesignSystemComponentsSheet;
+    sidebar?: DesignSystemComponentsSidebar;
+    skeleton?: DesignSystemComponentsSkeleton;
+    slider?: DesignSystemComponentsSlider;
+    spinner?: DesignSystemComponentsSpinner;
+    spreadsheet?: DesignSystemComponentsSpreadsheet;
+    stat?: DesignSystemComponentsStat;
+    stepper?: DesignSystemComponentsStepper;
+    table?: DesignSystemComponentsTable;
+    tabs?: DesignSystemComponentsTabs;
+    tag?: DesignSystemComponentsTag;
+    'tags-input'?: DesignSystemComponentsTagsInput;
+    timeline?: DesignSystemComponentsTimeline;
+    toast?: DesignSystemComponentsToast;
+    toggle?: DesignSystemComponentsToggle;
+    'toggle-group'?: DesignSystemComponentsToggleGroup;
+    toolbar?: DesignSystemComponentsToolbar;
+    tooltip?: DesignSystemComponentsTooltip;
+    tree?: DesignSystemComponentsTree;
+    'workflow-node'?: DesignSystemComponentsWorkflowNode;
+}
+export interface DesignSystemComponentsAccordion {
+    defaults?: DesignSystemComponentsAccordionDefaults;
+    'disabled-opacity'?: DesignSystemOpacityStep;
+    'trigger-font-size'?: DesignSystemTypeRoleName;
+    'trigger-font-weight'?: DesignSystemTypeRoleName;
+    'trigger-gap'?: DesignSystemDimension;
+    'trigger-padding-block'?: DesignSystemDimension;
+}
+export interface DesignSystemComponentsAccordionDefaults {
+    variant?: 'default' | 'bordered';
+}
+export interface DesignSystemComponentsAlert {
+    'border-width'?: DesignSystemBorderStep;
+    'font-size'?: DesignSystemTypeRoleName;
+    gap?: DesignSystemDimension;
+    'icon-size'?: DesignSystemDimension;
+    'padding-block'?: DesignSystemDimension;
+    'padding-inline'?: DesignSystemDimension;
+    radius?: DesignSystemRadiusStep;
+}
+export interface DesignSystemComponentsAspectRatio {
+    radius?: DesignSystemRadiusStep;
+}
+export interface DesignSystemComponentsAvatar {
+    defaults?: DesignSystemComponentsAvatarDefaults;
+    'font-weight'?: DesignSystemTypeRoleName;
+    radius?: DesignSystemRadiusStep;
+    'size-lg'?: DesignSystemDimension;
+    'size-md'?: DesignSystemDimension;
+    'size-sm'?: DesignSystemDimension;
+    'size-xs'?: DesignSystemDimension;
+}
+export interface DesignSystemComponentsAvatarDefaults {
+    size?: 'xs' | 'sm' | 'md' | 'lg';
+}
+export interface DesignSystemComponentsBadge {
+    'border-width'?: DesignSystemBorderStep;
+    defaults?: DesignSystemComponentsBadgeDefaults;
+    'font-size'?: DesignSystemTypeRoleName;
+    'font-weight'?: DesignSystemTypeRoleName;
+    gap?: DesignSystemDimension;
+    'line-height'?: DesignSystemTypeRoleName;
+    'padding-block'?: DesignSystemDimension;
+    'padding-inline'?: DesignSystemDimension;
+    radius?: DesignSystemRadiusStep;
+}
+export interface DesignSystemComponentsBadgeDefaults {
+    variant?: 'default' | 'secondary' | 'outline' | 'success' | 'warning' | 'destructive' | 'info' | 'neutral';
+}
+export interface DesignSystemComponentsBoard {
+    'card-elevation'?: DesignSystemElevationLevel;
+    'card-radius'?: DesignSystemRadiusStep;
+    'column-gap'?: DesignSystemDimension;
+    'column-padding'?: DesignSystemDimension;
+    'column-radius'?: DesignSystemRadiusStep;
+}
+export interface DesignSystemComponentsBreadcrumb {
+    defaults?: DesignSystemComponentsBreadcrumbDefaults;
+}
+export interface DesignSystemComponentsBreadcrumbDefaults {
+    size?: 'sm' | 'md' | 'lg';
+}
+export interface DesignSystemComponentsButton {
+    'border-width'?: DesignSystemBorderStep;
+    defaults?: DesignSystemComponentsButtonDefaults;
+    'disabled-opacity'?: DesignSystemOpacityStep;
+    elevation?: DesignSystemElevationLevel;
+    'font-size'?: DesignSystemTypeRoleName;
+    'font-size-lg'?: DesignSystemTypeRoleName;
+    'font-size-sm'?: DesignSystemTypeRoleName;
+    'font-weight'?: DesignSystemTypeRoleName;
+    gap?: DesignSystemDimension;
+    'height-lg'?: DesignSystemDimension;
+    'height-md'?: DesignSystemDimension;
+    'height-sm'?: DesignSystemDimension;
+    'height-touch'?: DesignSystemDimension;
+    'icon-size'?: DesignSystemDimension;
+    'line-height'?: DesignSystemTypeRoleName;
+    'padding-inline-lg'?: DesignSystemDimension;
+    'padding-inline-md'?: DesignSystemDimension;
+    'padding-inline-sm'?: DesignSystemDimension;
+    radius?: DesignSystemRadiusStep;
+}
+export interface DesignSystemComponentsButtonDefaults {
+    size?: 'sm' | 'md' | 'lg' | 'icon';
+    variant?: 'default' | 'secondary' | 'outline' | 'ghost' | 'destructive' | 'link';
+}
+export interface DesignSystemComponentsCanvasToolbar {
+    'button-font-size'?: DesignSystemTypeRoleName;
+    'button-radius'?: DesignSystemRadiusStep;
+    gap?: DesignSystemDimension;
+    padding?: DesignSystemDimension;
+}
+export interface DesignSystemComponentsCard {
+    background?: DesignSystemRoleName;
+    'border-width'?: DesignSystemBorderStep;
+    defaults?: DesignSystemComponentsCardDefaults;
+    'description-font-size'?: DesignSystemTypeRoleName;
+    elevation?: DesignSystemElevationLevel;
+    'padding-block'?: DesignSystemDimension;
+    'padding-inline'?: DesignSystemDimension;
+    radius?: DesignSystemRadiusStep;
+    'title-font-size'?: DesignSystemTypeRoleName;
+    'title-font-weight'?: DesignSystemTypeRoleName;
+    'title-line-height'?: DesignSystemTypeRoleName;
+}
+export interface DesignSystemComponentsCardDefaults {
+    variant?: 'elevated' | 'flat';
+}
+export interface DesignSystemComponentsCarousel {
+    'fallback-padding'?: DesignSystemDimension;
+    radius?: DesignSystemRadiusStep;
+}
+export interface DesignSystemComponentsChartFrame {
+    'title-font-size'?: DesignSystemTypeRoleName;
+}
+export interface DesignSystemComponentsChatBubble {
+    'padding-block'?: DesignSystemDimension;
+    'padding-inline'?: DesignSystemDimension;
+    radius?: DesignSystemRadiusStep;
+    'tail-radius'?: DesignSystemRadiusStep;
+}
+export interface DesignSystemComponentsChatComposer {
+    gap?: DesignSystemDimension;
+    padding?: DesignSystemDimension;
+    radius?: DesignSystemRadiusStep;
+}
+export interface DesignSystemComponentsChip {
+    defaults?: DesignSystemComponentsChipDefaults;
+}
+export interface DesignSystemComponentsChipDefaults {
+    variant?: 'default' | 'secondary' | 'outline' | 'success' | 'warning' | 'destructive' | 'info' | 'neutral';
+}
+export interface DesignSystemComponentsChoice {
+    defaults?: DesignSystemComponentsChoiceDefaults;
+    'description-font-size'?: DesignSystemTypeRoleName;
+    'disabled-opacity'?: DesignSystemOpacityStep;
+    gap?: DesignSystemDimension;
+    'label-font-size'?: DesignSystemTypeRoleName;
+    'label-font-weight'?: DesignSystemTypeRoleName;
+    'switch-gap'?: DesignSystemDimension;
+}
+export interface DesignSystemComponentsChoiceDefaults {
+    size?: 'sm' | 'md';
+}
+export interface DesignSystemComponentsCode {
+    'block-border-width'?: DesignSystemBorderStep;
+    'block-line-height'?: DesignSystemTypeRoleName;
+    'block-padding-block'?: DesignSystemDimension;
+    'block-padding-inline'?: DesignSystemDimension;
+    'block-radius'?: DesignSystemRadiusStep;
+    defaults?: DesignSystemComponentsCodeDefaults;
+    'font-size'?: DesignSystemTypeRoleName;
+    'font-weight'?: DesignSystemTypeRoleName;
+}
+export interface DesignSystemComponentsCodeDefaults {
+    variant?: 'inline' | 'block';
+}
+export interface DesignSystemComponentsColorPicker {
+    gap?: DesignSystemDimension;
+    'swatch-radius'?: DesignSystemRadiusStep;
+    'swatch-size'?: DesignSystemDimension;
+}
+export interface DesignSystemComponentsCombobox {
+    'border-width'?: DesignSystemBorderStep;
+    defaults?: DesignSystemComponentsComboboxDefaults;
+    'font-size-lg'?: DesignSystemTypeRoleName;
+    'font-size-md'?: DesignSystemTypeRoleName;
+    'font-size-sm'?: DesignSystemTypeRoleName;
+    'height-lg'?: DesignSystemDimension;
+    'height-md'?: DesignSystemDimension;
+    'height-sm'?: DesignSystemDimension;
+    radius?: DesignSystemRadiusStep;
+}
+export interface DesignSystemComponentsComboboxDefaults {
+    size?: 'sm' | 'md' | 'lg';
+    variant?: 'outline' | 'soft';
+}
+export interface DesignSystemComponentsCommand {
+    'border-width'?: DesignSystemBorderStep;
+    defaults?: DesignSystemComponentsCommandDefaults;
+    'font-size-lg'?: DesignSystemTypeRoleName;
+    'font-size-md'?: DesignSystemTypeRoleName;
+    'font-size-sm'?: DesignSystemTypeRoleName;
+    'input-gap'?: DesignSystemDimension;
+    'input-padding-inline'?: DesignSystemDimension;
+    radius?: DesignSystemRadiusStep;
+}
+export interface DesignSystemComponentsCommandDefaults {
+    size?: 'sm' | 'md' | 'lg';
+    variant?: 'outline' | 'soft';
+}
+export interface DesignSystemComponentsCopyButton {
+    defaults?: DesignSystemComponentsCopyButtonDefaults;
+}
+export interface DesignSystemComponentsCopyButtonDefaults {
+    size?: 'sm' | 'md';
+}
+export interface DesignSystemComponentsDataGrid {
+    gap?: DesignSystemDimension;
+    'pager-font-size'?: DesignSystemTypeRoleName;
+    radius?: DesignSystemRadiusStep;
+}
+export interface DesignSystemComponentsDate {
+    'control-border-width'?: DesignSystemBorderStep;
+    'control-radius'?: DesignSystemRadiusStep;
+    defaults?: DesignSystemComponentsDateDefaults;
+    'description-font-size'?: DesignSystemTypeRoleName;
+    'font-size'?: DesignSystemTypeRoleName;
+    'label-font-weight'?: DesignSystemTypeRoleName;
+    'panel-elevation'?: DesignSystemElevationLevel;
+    'panel-padding'?: DesignSystemDimension;
+    'panel-radius'?: DesignSystemRadiusStep;
+}
+export interface DesignSystemComponentsDateDefaults {
+    size?: 'sm' | 'md';
+}
+export interface DesignSystemComponentsDialog {
+    'alert-padding'?: DesignSystemDimension;
+    'border-width'?: DesignSystemBorderStep;
+    defaults?: DesignSystemComponentsDialogDefaults;
+    elevation?: DesignSystemElevationLevel;
+    'font-size'?: DesignSystemTypeRoleName;
+    'line-height'?: DesignSystemTypeRoleName;
+    radius?: DesignSystemRadiusStep;
+    'scrim-opacity'?: DesignSystemOpacityStep;
+    'title-font-size'?: DesignSystemTypeRoleName;
+    'title-font-weight'?: DesignSystemTypeRoleName;
+    'title-line-height'?: DesignSystemTypeRoleName;
+}
+export interface DesignSystemComponentsDialogDefaults {
+    size?: 'sm' | 'md' | 'lg' | 'xl';
+}
+export interface DesignSystemComponentsEmpty {
+    defaults?: DesignSystemComponentsEmptyDefaults;
+    'description-font-size'?: DesignSystemTypeRoleName;
+    gap?: DesignSystemDimension;
+    'padding-block'?: DesignSystemDimension;
+    'padding-inline'?: DesignSystemDimension;
+    'title-font-size'?: DesignSystemTypeRoleName;
+    'title-font-weight'?: DesignSystemTypeRoleName;
+}
+export interface DesignSystemComponentsEmptyDefaults {
+    size?: 'sm' | 'md';
+}
+export interface DesignSystemComponentsField {
+    'description-font-size'?: DesignSystemTypeRoleName;
+    'description-line-height'?: DesignSystemTypeRoleName;
+    gap?: DesignSystemDimension;
+    'label-font-size'?: DesignSystemTypeRoleName;
+    'label-font-weight'?: DesignSystemTypeRoleName;
+    'label-line-height'?: DesignSystemTypeRoleName;
+}
+export interface DesignSystemComponentsFileUpload {
+    'browse-height'?: DesignSystemDimension;
+    defaults?: DesignSystemComponentsFileUploadDefaults;
+    gap?: DesignSystemDimension;
+    'zone-border-width'?: DesignSystemBorderStep;
+    'zone-padding-block'?: DesignSystemDimension;
+    'zone-padding-inline'?: DesignSystemDimension;
+    'zone-radius'?: DesignSystemRadiusStep;
+}
+export interface DesignSystemComponentsFileUploadDefaults {
+    variant?: 'default' | 'compact';
+}
+export interface DesignSystemComponentsForms {
+    gap?: DesignSystemDimension;
+}
+export interface DesignSystemComponentsIcon {
+    defaults?: DesignSystemComponentsIconDefaults;
+    'size-lg'?: DesignSystemDimension;
+    'size-md'?: DesignSystemDimension;
+    'size-sm'?: DesignSystemDimension;
+    'size-xs'?: DesignSystemDimension;
+    'stroke-width'?: DesignSystemStrokeWidth;
+}
+export interface DesignSystemComponentsIconButton {
+    defaults?: DesignSystemComponentsIconButtonDefaults;
+}
+export interface DesignSystemComponentsIconButtonDefaults {
+    size?: 'sm' | 'md' | 'lg' | 'icon';
+    variant?: 'default' | 'secondary' | 'outline' | 'ghost' | 'destructive' | 'link';
+}
+export interface DesignSystemComponentsIconDefaults {
+    size?: 'xs' | 'sm' | 'md' | 'lg';
+}
+export interface DesignSystemComponentsInput {
+    'border-width'?: DesignSystemBorderStep;
+    'disabled-opacity'?: DesignSystemOpacityStep;
+    elevation?: DesignSystemElevationLevel;
+    'font-size'?: DesignSystemTypeRoleName;
+    'font-size-touch'?: DesignSystemTypeRoleName;
+    'font-weight'?: DesignSystemTypeRoleName;
+    height?: DesignSystemDimension;
+    'height-touch'?: DesignSystemDimension;
+    'padding-block'?: DesignSystemDimension;
+    'padding-inline'?: DesignSystemDimension;
+    radius?: DesignSystemRadiusStep;
+    'textarea-padding-block'?: DesignSystemDimension;
+}
+export interface DesignSystemComponentsKbd {
+    'border-width'?: DesignSystemBorderStep;
+    'font-weight'?: DesignSystemTypeRoleName;
+    'min-size'?: DesignSystemDimension;
+    'padding-block'?: DesignSystemDimension;
+    radius?: DesignSystemRadiusStep;
+}
+export interface DesignSystemComponentsLabel {
+    defaults?: DesignSystemComponentsLabelDefaults;
+}
+export interface DesignSystemComponentsLabelDefaults {
+    size?: 'sm' | 'md';
+}
+export interface DesignSystemComponentsMenu {
+    'content-elevation'?: DesignSystemElevationLevel;
+    'content-font-size'?: DesignSystemTypeRoleName;
+    'content-padding-block'?: DesignSystemDimension;
+    'content-radius'?: DesignSystemRadiusStep;
+    defaults?: DesignSystemComponentsMenuDefaults;
+    'trigger-border-width'?: DesignSystemBorderStep;
+    'trigger-font-size'?: DesignSystemTypeRoleName;
+    'trigger-font-weight'?: DesignSystemTypeRoleName;
+    'trigger-height-lg'?: DesignSystemDimension;
+    'trigger-height-md'?: DesignSystemDimension;
+    'trigger-height-sm'?: DesignSystemDimension;
+    'trigger-radius'?: DesignSystemRadiusStep;
+}
+export interface DesignSystemComponentsMenuDefaults {
+    size?: 'sm' | 'md' | 'lg';
+    variant?: 'default' | 'soft';
+}
+export interface DesignSystemComponentsNavigation {
+    'chevron-opacity'?: DesignSystemOpacityStep;
+    defaults?: DesignSystemComponentsNavigationDefaults;
+    'font-size'?: DesignSystemTypeRoleName;
+    'list-gap'?: DesignSystemDimension;
+    'trigger-radius'?: DesignSystemRadiusStep;
+}
+export interface DesignSystemComponentsNavigationDefaults {
+    size?: 'sm' | 'md' | 'lg';
+}
+export interface DesignSystemComponentsNumberField {
+    'border-width'?: DesignSystemBorderStep;
+    defaults?: DesignSystemComponentsNumberFieldDefaults;
+    'padding-block'?: DesignSystemDimension;
+    'padding-inline'?: DesignSystemDimension;
+    radius?: DesignSystemRadiusStep;
+    'stepper-size'?: DesignSystemDimension;
+}
+export interface DesignSystemComponentsNumberFieldDefaults {
+    size?: 'sm' | 'md' | 'lg';
+}
+export interface DesignSystemComponentsPagination {
+    defaults?: DesignSystemComponentsPaginationDefaults;
+}
+export interface DesignSystemComponentsPaginationDefaults {
+    size?: 'sm' | 'md' | 'lg';
+    variant?: 'outline' | 'soft';
+}
+export interface DesignSystemComponentsPinInput {
+    'cell-block-size'?: DesignSystemDimension;
+    'cell-font-size'?: DesignSystemTypeRoleName;
+    'cell-inline-size'?: DesignSystemDimension;
+    'cell-radius'?: DesignSystemRadiusStep;
+    defaults?: DesignSystemComponentsPinInputDefaults;
+    gap?: DesignSystemDimension;
+}
+export interface DesignSystemComponentsPinInputDefaults {
+    size?: 'sm' | 'md' | 'lg';
+}
+export interface DesignSystemComponentsPopover {
+    'border-width'?: DesignSystemBorderStep;
+    defaults?: DesignSystemComponentsPopoverDefaults;
+    elevation?: DesignSystemElevationLevel;
+    'font-size'?: DesignSystemTypeRoleName;
+    'padding-block'?: DesignSystemDimension;
+    'padding-inline'?: DesignSystemDimension;
+    radius?: DesignSystemRadiusStep;
+    'title-font-size'?: DesignSystemTypeRoleName;
+    'title-font-weight'?: DesignSystemTypeRoleName;
+    'title-line-height'?: DesignSystemTypeRoleName;
+}
+export interface DesignSystemComponentsPopoverDefaults {
+    size?: 'sm' | 'md' | 'lg';
+    variant?: 'elevated' | 'flat';
+}
+export interface DesignSystemComponentsProgress {
+    defaults?: DesignSystemComponentsProgressDefaults;
+    'font-size'?: DesignSystemTypeRoleName;
+    gap?: DesignSystemDimension;
+    radius?: DesignSystemRadiusStep;
+    'track-height-lg'?: DesignSystemDimension;
+    'track-height-md'?: DesignSystemDimension;
+    'track-height-sm'?: DesignSystemDimension;
+}
+export interface DesignSystemComponentsProgressDefaults {
+    size?: 'sm' | 'md' | 'lg';
+}
+export interface DesignSystemComponentsRadioGroup {
+    defaults?: DesignSystemComponentsRadioGroupDefaults;
+}
+export interface DesignSystemComponentsRadioGroupDefaults {
+    size?: 'sm' | 'md';
+    variant?: 'default' | 'card';
+}
+export interface DesignSystemComponentsRating {
+    defaults?: DesignSystemComponentsRatingDefaults;
+    'label-font-size'?: DesignSystemTypeRoleName;
+    'label-font-weight'?: DesignSystemTypeRoleName;
+    'star-radius'?: DesignSystemRadiusStep;
+    'stars-gap'?: DesignSystemDimension;
+}
+export interface DesignSystemComponentsRatingDefaults {
+    size?: 'sm' | 'md' | 'lg';
+}
+export interface DesignSystemComponentsResizable {
+    'border-width'?: DesignSystemBorderStep;
+    defaults?: DesignSystemComponentsResizableDefaults;
+    radius?: DesignSystemRadiusStep;
+}
+export interface DesignSystemComponentsResizableDefaults {
+    variant?: 'plain' | 'bordered';
+}
+export interface DesignSystemComponentsResizableHandle {
+    defaults?: DesignSystemComponentsResizableHandleDefaults;
+}
+export interface DesignSystemComponentsResizableHandleDefaults {
+    size?: 'sm' | 'md';
+}
+export interface DesignSystemComponentsScrollArea {
+    'border-width'?: DesignSystemBorderStep;
+    defaults?: DesignSystemComponentsScrollAreaDefaults;
+    padding?: DesignSystemDimension;
+    radius?: DesignSystemRadiusStep;
+    'scrollbar-radius'?: DesignSystemRadiusStep;
+    'scrollbar-size'?: DesignSystemDimension;
+    'thumb-min-size'?: DesignSystemDimension;
+}
+export interface DesignSystemComponentsScrollAreaDefaults {
+    size?: 'sm' | 'md' | 'lg';
+}
+export interface DesignSystemComponentsSelect {
+    'border-width'?: DesignSystemBorderStep;
+    'chevron-opacity'?: DesignSystemOpacityStep;
+    'chevron-size'?: DesignSystemDimension;
+    defaults?: DesignSystemComponentsSelectDefaults;
+    'font-size-lg'?: DesignSystemTypeRoleName;
+    'font-size-md'?: DesignSystemTypeRoleName;
+    'font-size-sm'?: DesignSystemTypeRoleName;
+    'font-weight'?: DesignSystemTypeRoleName;
+    gap?: DesignSystemDimension;
+    'height-lg'?: DesignSystemDimension;
+    'height-md'?: DesignSystemDimension;
+    'height-sm'?: DesignSystemDimension;
+    'padding-inline-lg'?: DesignSystemDimension;
+    'padding-inline-md'?: DesignSystemDimension;
+    'padding-inline-sm'?: DesignSystemDimension;
+    radius?: DesignSystemRadiusStep;
+}
+export interface DesignSystemComponentsSelectDefaults {
+    size?: 'sm' | 'md' | 'lg';
+    variant?: 'outline' | 'soft';
+}
+export interface DesignSystemComponentsSeparator {
+    defaults?: DesignSystemComponentsSeparatorDefaults;
+    thickness?: DesignSystemBorderStep;
+}
+export interface DesignSystemComponentsSeparatorDefaults {
+    variant?: 'default' | 'subtle' | 'strong';
+}
+export interface DesignSystemComponentsSheet {
+    'border-width'?: DesignSystemBorderStep;
+    defaults?: DesignSystemComponentsSheetDefaults;
+    elevation?: DesignSystemElevationLevel;
+    'font-size'?: DesignSystemTypeRoleName;
+    gap?: DesignSystemDimension;
+    'line-height'?: DesignSystemTypeRoleName;
+    padding?: DesignSystemDimension;
+    'scrim-opacity'?: DesignSystemOpacityStep;
+    'title-font-size'?: DesignSystemTypeRoleName;
+    'title-font-weight'?: DesignSystemTypeRoleName;
+    'title-line-height'?: DesignSystemTypeRoleName;
+}
+export interface DesignSystemComponentsSheetDefaults {
+    size?: 'sm' | 'md' | 'lg' | 'xl';
+}
+export interface DesignSystemComponentsSidebar {
+    'body-gap'?: DesignSystemDimension;
+    'body-padding-block'?: DesignSystemDimension;
+    'body-padding-inline'?: DesignSystemDimension;
+    defaults?: DesignSystemComponentsSidebarDefaults;
+    'font-size'?: DesignSystemTypeRoleName;
+    'header-gap'?: DesignSystemDimension;
+    'header-padding-inline'?: DesignSystemDimension;
+    'inset-radius'?: DesignSystemRadiusStep;
+}
+export interface DesignSystemComponentsSidebarDefaults {
+    variant?: 'default' | 'inset';
+}
+export interface DesignSystemComponentsSkeleton {
+    'circle-size'?: DesignSystemDimension;
+    defaults?: DesignSystemComponentsSkeletonDefaults;
+    'height-lg'?: DesignSystemDimension;
+    'height-md'?: DesignSystemDimension;
+    'height-sm'?: DesignSystemDimension;
+    radius?: DesignSystemRadiusStep;
+}
+export interface DesignSystemComponentsSkeletonDefaults {
+    size?: 'sm' | 'md' | 'lg';
+}
+export interface DesignSystemComponentsSlider {
+    defaults?: DesignSystemComponentsSliderDefaults;
+    'disabled-opacity'?: DesignSystemOpacityStep;
+    'thumb-border-width'?: DesignSystemBorderStep;
+    'thumb-elevation'?: DesignSystemElevationLevel;
+}
+export interface DesignSystemComponentsSliderDefaults {
+    size?: 'sm' | 'md' | 'lg';
+}
+export interface DesignSystemComponentsSpinner {
+    defaults?: DesignSystemComponentsSpinnerDefaults;
+    radius?: DesignSystemRadiusStep;
+}
+export interface DesignSystemComponentsSpinnerDefaults {
+    size?: 'sm' | 'md' | 'lg';
+}
+export interface DesignSystemComponentsSpreadsheet {
+    'bar-radius'?: DesignSystemRadiusStep;
+    gap?: DesignSystemDimension;
+    'tab-padding-inline'?: DesignSystemDimension;
+    'tab-radius'?: DesignSystemRadiusStep;
+}
+export interface DesignSystemComponentsStat {
+    'border-width'?: DesignSystemBorderStep;
+    defaults?: DesignSystemComponentsStatDefaults;
+    elevation?: DesignSystemElevationLevel;
+    gap?: DesignSystemDimension;
+    'icon-radius'?: DesignSystemRadiusStep;
+    'icon-size'?: DesignSystemDimension;
+    'label-font-size'?: DesignSystemTypeRoleName;
+    'label-font-weight'?: DesignSystemTypeRoleName;
+    padding?: DesignSystemDimension;
+    radius?: DesignSystemRadiusStep;
+    'value-font-size'?: DesignSystemTypeRoleName;
+    'value-font-weight'?: DesignSystemTypeRoleName;
+}
+export interface DesignSystemComponentsStatDefaults {
+    variant?: 'elevated' | 'flat';
+}
+export interface DesignSystemComponentsStepper {
+    'check-size'?: DesignSystemDimension;
+    gap?: DesignSystemDimension;
+    'marker-border-width'?: DesignSystemBorderStep;
+    'marker-font-size'?: DesignSystemTypeRoleName;
+    'marker-font-weight'?: DesignSystemTypeRoleName;
+    'marker-radius'?: DesignSystemRadiusStep;
+    'marker-size'?: DesignSystemDimension;
+    'trigger-radius'?: DesignSystemRadiusStep;
+}
+export interface DesignSystemComponentsTable {
+    'border-width'?: DesignSystemBorderStep;
+    'font-size'?: DesignSystemTypeRoleName;
+    'head-font-size'?: DesignSystemTypeRoleName;
+    'head-font-weight'?: DesignSystemTypeRoleName;
+    radius?: DesignSystemRadiusStep;
+}
+export interface DesignSystemComponentsTabs {
+    defaults?: DesignSystemComponentsTabsDefaults;
+    'disabled-opacity'?: DesignSystemOpacityStep;
+    gap?: DesignSystemDimension;
+    'list-gap'?: DesignSystemDimension;
+    'list-radius'?: DesignSystemRadiusStep;
+    'trigger-font-size'?: DesignSystemTypeRoleName;
+    'trigger-font-weight'?: DesignSystemTypeRoleName;
+    'trigger-gap'?: DesignSystemDimension;
+    'trigger-height-touch'?: DesignSystemDimension;
+}
+export interface DesignSystemComponentsTabsDefaults {
+    variant?: 'line' | 'pills' | 'enclosed';
+}
+export interface DesignSystemComponentsTag {
+    defaults?: DesignSystemComponentsTagDefaults;
+}
+export interface DesignSystemComponentsTagDefaults {
+    variant?: 'default' | 'secondary' | 'outline' | 'success' | 'warning' | 'destructive' | 'info' | 'neutral';
+}
+export interface DesignSystemComponentsTagsInput {
+    'border-width'?: DesignSystemBorderStep;
+    'disabled-opacity'?: DesignSystemOpacityStep;
+    elevation?: DesignSystemElevationLevel;
+    gap?: DesignSystemDimension;
+    height?: DesignSystemDimension;
+    'height-touch'?: DesignSystemDimension;
+    'padding-inline'?: DesignSystemDimension;
+    radius?: DesignSystemRadiusStep;
+    'tag-font-size'?: DesignSystemTypeRoleName;
+    'tag-radius'?: DesignSystemRadiusStep;
+}
+export interface DesignSystemComponentsTimeline {
+    'marker-radius'?: DesignSystemRadiusStep;
+    'marker-size'?: DesignSystemDimension;
+    'time-font-size'?: DesignSystemTypeRoleName;
+    'time-font-weight'?: DesignSystemTypeRoleName;
+}
+export interface DesignSystemComponentsToast {
+    'border-width'?: DesignSystemBorderStep;
+    elevation?: DesignSystemElevationLevel;
+    gap?: DesignSystemDimension;
+    'icon-size'?: DesignSystemDimension;
+    'padding-block'?: DesignSystemDimension;
+    radius?: DesignSystemRadiusStep;
+    'title-font-size'?: DesignSystemTypeRoleName;
+    'title-font-weight'?: DesignSystemTypeRoleName;
+}
+export interface DesignSystemComponentsToggle {
+    'border-width'?: DesignSystemBorderStep;
+    defaults?: DesignSystemComponentsToggleDefaults;
+    'disabled-opacity'?: DesignSystemOpacityStep;
+    'font-size'?: DesignSystemTypeRoleName;
+    'font-weight'?: DesignSystemTypeRoleName;
+    gap?: DesignSystemDimension;
+    'height-lg'?: DesignSystemDimension;
+    'height-md'?: DesignSystemDimension;
+    'height-sm'?: DesignSystemDimension;
+    'line-height'?: DesignSystemTypeRoleName;
+    'padding-inline-lg'?: DesignSystemDimension;
+    'padding-inline-md'?: DesignSystemDimension;
+    'padding-inline-sm'?: DesignSystemDimension;
+    radius?: DesignSystemRadiusStep;
+}
+export interface DesignSystemComponentsToggleDefaults {
+    size?: 'sm' | 'md' | 'lg';
+    variant?: 'default' | 'outline';
+}
+export interface DesignSystemComponentsToggleGroup {
+    defaults?: DesignSystemComponentsToggleGroupDefaults;
+}
+export interface DesignSystemComponentsToggleGroupDefaults {
+    size?: 'sm' | 'md' | 'lg';
+    variant?: 'default' | 'outline';
+}
+export interface DesignSystemComponentsToolbar {
+    'border-width'?: DesignSystemBorderStep;
+    defaults?: DesignSystemComponentsToolbarDefaults;
+    'disabled-opacity'?: DesignSystemOpacityStep;
+    gap?: DesignSystemDimension;
+    'item-font-size'?: DesignSystemTypeRoleName;
+    'item-font-weight'?: DesignSystemTypeRoleName;
+    'item-height-sm'?: DesignSystemDimension;
+    padding?: DesignSystemDimension;
+    radius?: DesignSystemRadiusStep;
+}
+export interface DesignSystemComponentsToolbarDefaults {
+    size?: 'sm' | 'md';
+    variant?: 'default' | 'outline' | 'ghost';
+}
+export interface DesignSystemComponentsTooltip {
+    elevation?: DesignSystemElevationLevel;
+    'font-size'?: DesignSystemTypeRoleName;
+    'font-weight'?: DesignSystemTypeRoleName;
+    'line-height'?: DesignSystemTypeRoleName;
+    radius?: DesignSystemRadiusStep;
+}
+export interface DesignSystemComponentsTree {
+    'checkbox-radius'?: DesignSystemRadiusStep;
+    'checkbox-size'?: DesignSystemDimension;
+    defaults?: DesignSystemComponentsTreeDefaults;
+    gap?: DesignSystemDimension;
+    padding?: DesignSystemDimension;
+    radius?: DesignSystemRadiusStep;
+    'row-gap'?: DesignSystemDimension;
+    'row-padding-block'?: DesignSystemDimension;
+}
+export interface DesignSystemComponentsTreeDefaults {
+    variant?: 'default' | 'bordered';
+}
+export interface DesignSystemComponentsWorkflowNode {
+    elevation?: DesignSystemElevationLevel;
+    'padding-block'?: DesignSystemDimension;
+    'padding-inline'?: DesignSystemDimension;
+    radius?: DesignSystemRadiusStep;
+}
+/** One mode’s chart palette: 8 categorical, 9 sequential and 9 diverging colors. */
+export interface DesignSystemDataVizPalette {
+    axis?: DesignSystemColorValue;
+    categorical?: readonly DesignSystemColorValue[];
+    diverging?: readonly DesignSystemColorValue[];
+    grid?: DesignSystemColorValue;
+    sequential?: readonly DesignSystemColorValue[];
+}
+/** A space, control, icon or target size step. */
+export type DesignSystemDimension = 'space-0' | 'space-1' | 'space-2' | 'space-3' | 'space-4' | 'space-5' | 'space-6' | 'space-7' | 'space-8' | 'space-9' | 'space-10' | 'space-11' | 'space-12' | 'control-xs' | 'control-sm' | 'control-md' | 'control-lg' | 'icon-xs' | 'icon-sm' | 'icon-md' | 'icon-lg' | 'target-min' | 'target-touch';
+/** Elevation style. */
+export interface DesignSystemElevation {
+    style?: 'flat' | 'soft' | 'crisp' | 'glow' | 'layered';
+}
+/** An elevation level. */
+export type DesignSystemElevationLevel = number;
+/** A family stack (1 to 8 names, quoted by the compiler) and its font files. */
+export interface DesignSystemFontFamily {
+    files?: readonly DesignSystemFontFile[];
+    stack: readonly string[];
+}
+/**
+ * A self-hosted font file: a same-origin relative path (.woff2, .woff, .ttf, .otf), or at developer
+ * trust a base64 data:font URL of at most 131072 bytes.
+ */
+export interface DesignSystemFontFile {
+    display?: 'swap' | 'fallback' | 'optional' | 'block' | 'auto';
+    preload?: boolean;
+    /** At most 131072 bytes inline; data URLs need developer trust. */
+    src: string;
+    style?: 'normal' | 'italic';
+    weight?: string;
+}
+/** Icon style, stroke and sizes (px). */
+export interface DesignSystemIcons {
+    size?: DesignSystemIconsSize;
+    stroke?: number;
+    style?: 'outline' | 'filled';
+}
+export interface DesignSystemIconsSize {
+    lg?: number;
+    md?: number;
+    sm?: number;
+}
+/** One design-system issue: a stable code, a JSON path from $, a message and an optional hint. */
+export interface DesignSystemIssue {
+    code: DesignSystemIssueCode;
+    hint?: string;
+    message: string;
+    path: string;
+}
+/**
+ * Every stable design-system code; aa-text, aa-focus and target-size are raised by the compiler.
+ */
+export type DesignSystemIssueCode = 'unknown-key' | 'invalid-type' | 'invalid-value' | 'required' | 'format-version' | 'extends-range' | 'extends-cycle' | 'extends-depth' | 'url-refused' | 'inline-bytes' | 'aa-text' | 'aa-focus' | 'target-size';
+/** Layout widths, breakpoints and the grid (px). */
+export interface DesignSystemLayout {
+    breakpoints?: DesignSystemLayoutBreakpoints;
+    contentMax?: number;
+    grid?: DesignSystemLayoutGrid;
+    wideMax?: number;
+}
+export interface DesignSystemLayoutBreakpoints {
+    lg?: number;
+    md?: number;
+    sm?: number;
+}
+export interface DesignSystemLayoutGrid {
+    columns?: DesignSystemLayoutGridColumns;
+    gutter?: DesignSystemLayoutGridGutter;
+}
+export interface DesignSystemLayoutGridColumns {
+    base?: number;
+    lg?: number;
+    md?: number;
+    sm?: number;
+}
+export interface DesignSystemLayoutGridGutter {
+    base?: DesignSystemSpaceStep;
+    lg?: DesignSystemSpaceStep;
+    md?: DesignSystemSpaceStep;
+    sm?: DesignSystemSpaceStep;
+}
+/** Motion personality, durations (ms) and a named easing. */
+export interface DesignSystemMotion {
+    durations?: DesignSystemMotionDurations;
+    easing?: 'standard' | 'emphasized' | 'enter' | 'exit' | 'linear';
+    personality?: 'none' | 'subtle' | 'standard' | 'expressive';
+}
+export interface DesignSystemMotionDurations {
+    base?: number;
+    fast?: number;
+    slow?: number;
+}
+/** An opacity step. */
+export type DesignSystemOpacityStep = 'disabled' | 'muted' | 'scrim';
+/** A shape radius step. */
+export type DesignSystemRadiusStep = 'none' | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'full';
+/** Explicit role pins for one mode: checked by the compiler, never moved (ADR-022). */
+export interface DesignSystemRoleMap {
+    accent?: DesignSystemColorValue;
+    accentForeground?: DesignSystemColorValue;
+    background?: DesignSystemColorValue;
+    border?: DesignSystemColorValue;
+    borderStrong?: DesignSystemColorValue;
+    canvas?: DesignSystemColorValue;
+    destructive?: DesignSystemColorValue;
+    destructiveForeground?: DesignSystemColorValue;
+    destructiveSoft?: DesignSystemColorValue;
+    destructiveSoftForeground?: DesignSystemColorValue;
+    elevated?: DesignSystemColorValue;
+    elevatedForeground?: DesignSystemColorValue;
+    foreground?: DesignSystemColorValue;
+    info?: DesignSystemColorValue;
+    infoForeground?: DesignSystemColorValue;
+    infoSoft?: DesignSystemColorValue;
+    infoSoftForeground?: DesignSystemColorValue;
+    input?: DesignSystemColorValue;
+    link?: DesignSystemColorValue;
+    linkVisited?: DesignSystemColorValue;
+    muted?: DesignSystemColorValue;
+    mutedForeground?: DesignSystemColorValue;
+    overlay?: DesignSystemColorValue;
+    primary?: DesignSystemColorValue;
+    primaryForeground?: DesignSystemColorValue;
+    primarySoft?: DesignSystemColorValue;
+    primarySoftForeground?: DesignSystemColorValue;
+    ring?: DesignSystemColorValue;
+    scrim?: DesignSystemColorValue;
+    secondary?: DesignSystemColorValue;
+    secondaryForeground?: DesignSystemColorValue;
+    selection?: DesignSystemColorValue;
+    selectionForeground?: DesignSystemColorValue;
+    shadow?: DesignSystemColorValue;
+    sidebar?: DesignSystemColorValue;
+    sidebarBorder?: DesignSystemColorValue;
+    sidebarForeground?: DesignSystemColorValue;
+    sidebarPrimary?: DesignSystemColorValue;
+    subtle?: DesignSystemColorValue;
+    subtleForeground?: DesignSystemColorValue;
+    success?: DesignSystemColorValue;
+    successForeground?: DesignSystemColorValue;
+    successSoft?: DesignSystemColorValue;
+    successSoftForeground?: DesignSystemColorValue;
+    surface?: DesignSystemColorValue;
+    surfaceForeground?: DesignSystemColorValue;
+    warning?: DesignSystemColorValue;
+    warningForeground?: DesignSystemColorValue;
+    warningSoft?: DesignSystemColorValue;
+    warningSoftForeground?: DesignSystemColorValue;
+}
+/** A semantic color role of the token contract. */
+export type DesignSystemRoleName = 'background' | 'foreground' | 'surface' | 'surfaceForeground' | 'elevated' | 'elevatedForeground' | 'muted' | 'mutedForeground' | 'subtle' | 'subtleForeground' | 'border' | 'borderStrong' | 'input' | 'ring' | 'primary' | 'primaryForeground' | 'primarySoft' | 'primarySoftForeground' | 'secondary' | 'secondaryForeground' | 'accent' | 'accentForeground' | 'destructive' | 'destructiveForeground' | 'destructiveSoft' | 'destructiveSoftForeground' | 'success' | 'successForeground' | 'successSoft' | 'successSoftForeground' | 'warning' | 'warningForeground' | 'warningSoft' | 'warningSoftForeground' | 'info' | 'infoForeground' | 'infoSoft' | 'infoSoftForeground' | 'sidebar' | 'sidebarForeground' | 'sidebarBorder' | 'sidebarPrimary' | 'overlay' | 'scrim' | 'shadow' | 'link' | 'linkVisited' | 'selection' | 'selectionForeground' | 'canvas';
+/** Shape: radius (px), radius scale and border width (px). */
+export interface DesignSystemShape {
+    borderWidth?: number;
+    radius?: number;
+    radiusScale?: number;
+}
+/** Space: the base unit (px) and the density multiplier. */
+export interface DesignSystemSpace {
+    base?: number;
+    density?: number;
+}
+/** A space step. */
+export type DesignSystemSpaceStep = 'space-0' | 'space-1' | 'space-2' | 'space-3' | 'space-4' | 'space-5' | 'space-6' | 'space-7' | 'space-8' | 'space-9' | 'space-10' | 'space-11' | 'space-12';
+/** A stroke width in px. */
+export type DesignSystemStrokeWidth = number;
+/** Surface style and glass settings. */
+export interface DesignSystemSurface {
+    glass?: DesignSystemSurfaceGlass;
+    style?: 'solid' | 'glass';
+}
+export interface DesignSystemSurfaceGlass {
+    alpha?: number;
+    blur?: number;
+}
+/** A type role: family, size (px), weight, line height and tracking (em). */
+export interface DesignSystemTypeRole {
+    family?: 'sans' | 'heading' | 'mono' | 'serif';
+    line?: number;
+    size?: number;
+    tracking?: number;
+    weight?: number;
+}
+/** A type role name. */
+export type DesignSystemTypeRoleName = 'display' | 'title' | 'heading' | 'body' | 'label' | 'caption' | 'code';
+/** Typography: family stacks with font files, the scale and the type roles. */
+export interface DesignSystemTypography {
+    families?: DesignSystemTypographyFamilies;
+    roles?: DesignSystemTypographyRoles;
+    scale?: DesignSystemTypographyScale;
+}
+export interface DesignSystemTypographyFamilies {
+    heading?: DesignSystemFontFamily;
+    mono?: DesignSystemFontFamily;
+    sans?: DesignSystemFontFamily;
+    serif?: DesignSystemFontFamily;
+}
+export interface DesignSystemTypographyRoles {
+    body?: DesignSystemTypeRole;
+    caption?: DesignSystemTypeRole;
+    code?: DesignSystemTypeRole;
+    display?: DesignSystemTypeRole;
+    heading?: DesignSystemTypeRole;
+    label?: DesignSystemTypeRole;
+    title?: DesignSystemTypeRole;
+}
+export interface DesignSystemTypographyScale {
+    base?: number;
+    ratio?: number;
+}
+/**
+ * A named variant (high-contrast, compact, seasonal): a closed partial document of sections,
+ * orthogonal to mode.
+ */
+export interface DesignSystemVariant {
+    accessibility?: DesignSystemAccessibility;
+    assets?: DesignSystemAssets;
+    color?: DesignSystemColor;
+    components?: DesignSystemComponents;
+    elevation?: DesignSystemElevation;
+    icons?: DesignSystemIcons;
+    layout?: DesignSystemLayout;
+    motion?: DesignSystemMotion;
+    shape?: DesignSystemShape;
+    space?: DesignSystemSpace;
+    surface?: DesignSystemSurface;
+    typography?: DesignSystemTypography;
+    voice?: DesignSystemVoice;
+}
+/** Voice data: tone words, a lexicon (at most 200 entries) and guidelines. */
+export interface DesignSystemVoice {
+    guidelines?: readonly string[];
+    /**
+     * At most 200 entries; keys match ^[a-z][a-z0-9-]{0,47}$ and are never __proto__, constructor or
+     * prototype.
+     */
+    lexicon?: Readonly<Record<string, string>>;
+    /** Unique items. */
+    tone?: readonly string[];
+}
+/**
+ * A Texuli design system (ADR-021, formatVersion 1): one closed JSON document a company or an agent
+ * writes once and every Texuli surface follows. Data only: colors are hex or numeric oklch, lengths
+ * are numbers in px, fonts and assets are same-origin relative paths or capped data URLs, and
+ * nothing reaches CSS that the token contract’s css-safe checks would refuse. Generated from
+ * @texuli/spec/design-system’s vocabulary by scripts/design-system-schema.ts; validateDesignSystem
+ * enforces the rules the dialect cannot express.
+ */
+export interface DesignSystem {
+    accessibility?: DesignSystemAccessibility;
+    assets?: DesignSystemAssets;
+    color?: DesignSystemColor;
+    components?: DesignSystemComponents;
+    description?: string;
+    elevation?: DesignSystemElevation;
+    /**
+     * texuli:<theme> or an exact id@x.y.z; never a range, a URL or a path. Cycles and chains deeper
+     * than 4 are refused.
+     */
+    extends?: string;
+    format: 'texuli/design-system';
+    formatVersion: 1;
+    icons?: DesignSystemIcons;
+    id: string;
+    layout?: DesignSystemLayout;
+    license?: string;
+    motion?: DesignSystemMotion;
+    name: string;
+    owner?: string;
+    shape?: DesignSystemShape;
+    space?: DesignSystemSpace;
+    surface?: DesignSystemSurface;
+    /** Unique items. */
+    tags?: readonly string[];
+    typography?: DesignSystemTypography;
+    /**
+     * At most 16 entries; keys match ^[a-z][a-z0-9-]{0,47}$ and are never __proto__, constructor or
+     * prototype.
+     */
+    variants?: Readonly<Record<string, DesignSystemVariant>>;
+    version: string;
+    voice?: DesignSystemVoice;
+}