✦ M2 New Surfaces

Components and patterns added in the M2 milestone.

Segmented Control

Toast Variants

Table States

No results found

Segmented Control experimental

Size variants

Disabled item

Settings Panel experimental

General

Workspace nameDisplay name for your workspace.
Public accessAllow public discovery.

Toast Variants supported

Tone variants (inline preview)

Saved successfully

Your changes have been persisted.

Update available

A new version is ready to install.

Quota at 90%

Upgrade soon to avoid service limits.

Request failed

Check your connection and try again.

Live toast trigger

Toasts appear in the bottom-right corner.

Skeleton Presets supported

Form skeleton

Table skeleton

Card skeleton

Table Empty / Loading / Error States supported

Empty state

No projects yet

Loading state (table[data-loading])

NameStatus
Project AlphaActive
Loading…

Error state

Failed to load data

Input Augmentation supported

Search Box

Inline search with attached action button.

Combobox

Filterable select with keyboard navigation. Use data-active on highlighted option, aria-selected on chosen value.

  • React
  • Vue
  • Svelte
  • Solid
  • Angular

Autocomplete

Free-text input with inline suggestion list. aria-autocomplete="list" on the input; data-active tracks keyboard focus in the list.

  • Turkey
  • Tunisia
  • Turkmenistan

Command Palette

Modal command launcher. Trigger with ⌘K. data-active tracks highlighted item.

Starter Templates & Example Pages

1) Component Surface

Button

Input + Textarea + Select

Focusable input with semantic defaults.

Badge + Alert

Neutral Primary Danger

2) Layout Primitives

`stack` in a settings form

`cluster` in an action toolbar

12 selected

`sidebar` for dashboard split

`container` + `center` + `grid` composition

Card A
Card B
Card C
Card D

`switcher` refinement with fixed card width

Overview
Billing
Security

3) Utility vs Semantic Override (3 examples)

Example C: Input radius

`input` vs `rounded-lg`

4) Light / Dark Theme Preview

5) Recipe Resolver Usage Snapshot

Source: `packages/recipes/button.ts` -> generated resolver output.

Rendered with resolver output

6) Input Validation Surface

`aria-invalid="true"` + `aria-invalid:ring-danger` birlikte kullanılır; disabled ve readonly görünümü ayrıdır.

Kullanıcıya ulaşmak için bu adres kullanılacaktır.

Geçerli bir e-posta adresi girilmelidir.

Bu alan görüntülenir ancak düzenlenmez.

Bu alan etkileşime kapalıdır.

7) Card Composition Surface

Plan: Team

Composition spacing is handled by `data-card-layout="stack"`.

Footer separator is handled by `data-card-slot="footer"` rule.

8) Choice Controls + Range + OTP

Switch visual, checkbox semantics.

Range slider canonical surface.

OTP / Pin Input

Four-slot OTP composition with semantic slot surface.

9) Input Group Surface

@

Prefix addon + input composition.

USD

Price değeri zorunludur.

9.1) Number Input Surface

Canonical number input composition with optional step controls.

Value must be between 0 and 100.

10) Modal Surface

Modal uses `data-open` state and semantic dialog attributes.

11) Toast Surface

Toast items use `data-open` and live region semantics.

12) Tooltip Surface

Tooltip state uses `data-open` and `aria-describedby` relation.

Saves changes as draft. Runs sync action immediately.

13) Popover Surface

Popover uses `data-open` with `aria-expanded` and `aria-controls` on trigger.

14) Dropdown Menu Surface

Dropdown menu uses `data-open` with trigger-controlled `aria-expanded` state.

14.1) Context Menu + Progress + Loading Overlay

Overlay extensions: context actions, progress feedback and in-place loading mask.

Sync progress: 68%

Quarterly report is being prepared.

Rows are temporarily locked during sync.

Loading report...

15) Drawer Surface

Drawer uses `data-open` state and dialog semantics on side panel.

16) Tabs Surface

Tabs use `data-active` on triggers/panels with one active panel at a time.

Profile settings and personal details.

Billing methods and invoice preferences.

Password, sessions and 2FA controls.

17) Accordion Surface

Accordion item open state is represented with `data-open` on each item.

Manage language, timezone and notification defaults.

Manage visibility and data sharing options.

18) Pagination Surface

Pagination uses semantic links/buttons; current page is marked with `aria-current`.

19) Breadcrumb Surface

Breadcrumb uses semantic nav/list markup with `aria-current` on current node.

20) Navbar Surface

20.1) Menu Bar Surface

21) Sidebar Navigation Surface

22) Stepper Surface

Stepper uses `data-state` (`complete|active|upcoming`) on each item.

1 Account verified
2 Payment details
3 Review and submit

23) Page Header Surface

Page header groups title/meta and action area.

24) Section Block Surface

Section block creates heading/body structure for product pages.

Security

Two-factor authentication is enabled for all admins.

Last review completed on 2026-04-02.

25) App Shell Surface

App shell combines topbar, sidebar area and main content area.

Analytics Workspace Admin
Overview

Main content area grows while sidebar stays structured.

25.1) Split Pane Surface

Split pane creates responsive dual-region product layouts.

Editor

Main content/editing region with larger width.

26) Table + Empty State Surface

Table surface for dense data rows with selected row state.

Project Owner Status MRR
Atlas CRM Ada Healthy $12,400
Pulse Ops Grace At risk $7,980
Nova Billing Linus Healthy $4,200

When rows are empty, pair table workflows with empty-state fallback.

No records found

There is no matching result for the current filters. Reset filters or create a new record.

26.1) Data Grid Surface

Minimal data-grid surface with role-based semantics and selected row state.

Account
Owner
Plan
MRR
Atlas CRM
Ada
Pro
$12,400
Pulse Ops
Grace
Enterprise
$22,900

27) Avatar + Stat Surface

27.1) Avatar Group + Tag Chip Surface

Avatar group overlaps members while preserving per-avatar semantics.

A L G
status: active owner: platform tier: enterprise

28) Timeline + KPI Card Surface

29) List + Description List Surface

30) Combobox + Search Box Surface

31) Autocomplete + Command Palette Surface

32) Command Bar + Filter Bar Composite

Command bar: arama + hızlı aksiyon birleşimi.

workspace: core

Filter bar implementation: mevcut controls ile filtre kompozisyonu.

Search + filter composite summary.

status: active priority: high 12 results
  • Issue #241 — Input validation doc update
  • Issue #248 — Naming contract checks

33) Data Table Toolbar Pattern

Data table toolbar: search + filter + bulk action kompozisyonu.

status: open 3 selected
Issue Owner State
#248 Naming contract checks Core Team Open
#251 Input validation docs Design Ops Open
#260 Build pipeline polish Platform Closed

34) Date Picker Surface

35) Date Range Picker Surface

36) Calendar Surface

37) File Upload Surface

38) Dropzone Surface

39) Editable Field Surface

40) Hover Card Surface

41) Content / Rich UI Surface

Release Notes

Foundation package refinements completed for navigation, data and content surfaces.

  • Contract checks passed.
  • Playground examples updated.
  • Build pipeline remains green.
npm run build

42) Fluid Token Pilot (`clamp`) Comparison

Pilot only: compare fixed values vs fluid `clamp()` values for type and spacing rhythm.

Fixed Title Scale

Uses a fixed title size and fixed top spacing baseline.

Spacing remains static across viewport widths.

Fluid Clamp Title Scale

Uses `clamp()` for responsive title sizing and spacing progression.

Spacing scales within controlled min/max boundaries.

43) Rating Surface

Rating surface with active state, readonly and disabled examples.

Interactive rating

Use active marker on selected items and semantic group labeling.

Disabled rating

44) Result / Status Surface

45) Tree View Surface

Tree-view surface for nested navigation/data hierarchies.

46) Tags Input Surface

Tags input surface with removable items and inline entry field.

urgent backend
archived

This project cannot accept more tags.

Saved

Profile changes were saved.

Failed

Request failed. Try again.

Saved successfully

Your changes have been persisted.

Quota at 90%

Upgrade to avoid service limits.

Request failed

Check your connection and try again.