@facto-to/design-system 0.1.0-beta.4 → 0.1.0-beta.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/AI.md CHANGED
@@ -13,7 +13,7 @@ All paths below are relative to this installed package directory:
13
13
  5. For fonts/themes, read [integration.md](dist/ai/references/integration.md), [design.md](dist/ai/references/design.md) and only the relevant properties in [tokens.css](dist/tokens.css).
14
14
  6. For composed workflows, read [composition.md](dist/ai/references/composition.md) for state ownership, async guards, layered overlays, focus and Undo behavior. Adapt the [mock recipe](dist/ai/assets/AdoptionDemo.tsx) and [scoped CSS](dist/ai/assets/adoption.css) where useful. Never replace live business data/handlers with mock example state.
15
15
 
16
- Visual baseline: Facto UI Standard rules v1.2, document revision v1.2.5. Read the bundled design.md for the updated button, focus, modal, switch and responsive recipes; old Dashboard snapshots do not override them.
16
+ Visual baseline: Facto UI Standard rules v1.2, document revision v1.2.21. Read the bundled design.md for the updated button, focus, modal, switch and responsive recipes; old Dashboard snapshots do not override them.
17
17
 
18
18
  Quick constraints: React/React DOM 19; styles.css includes tokens; fonts.css registers Inter and must be imported to load it. Legacy HTML is not automatically restyled. SearchField uses native onChange; EnhancedSearchField and Select use onValueChange; Button defaults to type="button"; Toast is composed of provider/root/viewport, not toast.success(). There is no exported data table, chart, date picker or router.
19
19
 
package/README.md CHANGED
@@ -10,11 +10,11 @@ Repository access is controlled separately from the public npm package; installi
10
10
 
11
11
  Coding assistants: start with [AI.md](./AI.md). This package includes the version-matched [Facto UI Skill](./dist/ai/SKILL.md), component catalog, declarations, tokens and tested mock recipe. Use it to create UI or migrate components/styles across existing frontend repositories while preserving business behavior. No MCP, GitHub access or separately downloaded documentation is required after npm installation. The skill can also be installed into Codex or Claude Code; see AI.md.
12
12
 
13
- ## Visual revision: 0.1.0-beta.4
13
+ ## Visual revision: 0.1.0-beta.5
14
14
 
15
- Adopts Facto UI Standard rules v1.2 / document revision v1.2.5. This is a visual migration: existing callbacks, controlled/uncontrolled state, validation and Radix overlay behavior are retained. The payment/connection SDK is unaffected.
15
+ Adopts Facto UI Standard rules v1.2 / document revision v1.2.21. This is a visual migration: existing callbacks, controlled/uncontrolled state, validation and Radix overlay behavior are retained. The payment/connection SDK is unaffected.
16
16
 
17
- Defaults now use pill buttons, dark single-layer field focus, 44px targets, quieter 16px cards, semantic feedback colors and 20px modal padding. DialogContent now defaults to `size="sm"` (maximum 400px); explicit `size="md"` is the 580px wide legacy variant. Review consumers that override dimensions or depend on the old visual defaults. Use shared `Icon`, `ModalHeader` and `ModalFooter` for consistent overlay composition. See the bundled [visual contract](./dist/ai/references/design.md) for exact recipes and acceptance guidance.
17
+ beta.5 updates top-right responsive Toast placement, 32px modal headers, overflowing-title keyboard access, mobile overlay entrance/reduced motion, and Select popper spacing. Earlier defaults continue to use pill buttons, dark single-layer field focus, 44px targets, quieter 16px cards, semantic feedback colors and 20px modal padding. DialogContent now defaults to `size="sm"` (maximum 400px); explicit `size="md"` is the 580px wide legacy variant. Review consumers that override dimensions or depend on the old visual defaults. Use shared `Icon`, `ModalHeader` and `ModalFooter` for consistent overlay composition. See the bundled [visual contract](./dist/ai/references/design.md) for exact recipes and acceptance guidance.
18
18
 
19
19
  ## Requirements
20
20
 
@@ -27,13 +27,13 @@ Defaults now use pill buttons, dark single-layer field focus, 44px targets, quie
27
27
  Install the beta (requires React 19):
28
28
 
29
29
  ```sh
30
- npm install @facto-to/design-system@0.1.0-beta.4 react@^19 react-dom@^19
30
+ npm install @facto-to/design-system@0.1.0-beta.5 react@^19 react-dom@^19
31
31
  ```
32
32
 
33
33
  For local development, you can also install a generated archive:
34
34
 
35
35
  ```sh
36
- npm install /path/to/facto-to-design-system-0.1.0-beta.4.tgz
36
+ npm install /path/to/facto-to-design-system-0.1.0-beta.5.tgz
37
37
  ```
38
38
 
39
39
  ## Usage
@@ -146,7 +146,7 @@ Both examples assume the named components are imported from `@facto-to/design-sy
146
146
 
147
147
  ## Source fidelity and library extensions
148
148
 
149
- - Toast uses the v1.2 feedback recipe: semantic status colors, 12px radius, 12px × 16px padding and 14/20 copy. Existing 2600ms duration and bottom-center placement remain unchanged; desktop offset is 24px, mobile 16px.
149
+ - Toast uses the v1.2 feedback recipe: semantic status colors, 12px radius, 12px × 16px padding and 14/20 copy. Duration remains 2600ms. Placement is now top-right: desktop top/right 24px, maximum width 420px; mobile top 16px and full available width with 16px side gutters and safe-area insets.
150
150
  - The source notification API displays one entry at a time. This library retains composable Radix roots instead of exporting the source's global `toast.success()` store. Optional close/action buttons, multiple notifications, swipe, and pause behavior are extensions. Use `ToastAction` for a dedicated accessible action; the default toast surface is not a click target.
151
151
  - Tooltip defaults follow the shared compact dark tooltip, without an arrow. `variant="content"` follows the white merchant-detail tooltip override. Provider delay defaults to 300ms. The source's utility-based entrance/exit animations are not reproduced.
152
152
  - SearchField uses the shared 44px minimum-height neutral input recipe and native events. EnhancedSearchField is an optional richer control, not a source-exact Dashboard widget.
@@ -17,7 +17,7 @@ export interface FactoThemeProps extends Omit<HTMLAttributes<HTMLDivElement>, 's
17
17
  /** Scoped token container. Inline `--facto-*` values are forwarded to portalled overlays. */
18
18
  export declare function FactoTheme({ className, tokens, style, ...props }: FactoThemeProps): import("react").JSX.Element;
19
19
  /** Shared decorative symbols; name the containing control, not the glyph. */
20
- export type IconName = 'close' | 'arrowLeft' | 'check' | 'chevronDown' | 'info' | 'warning';
20
+ export type IconName = 'close' | 'arrowLeft' | 'check' | 'chevronDown' | 'chevronRight' | 'info' | 'warning';
21
21
  export interface IconProps extends SVGProps<SVGSVGElement> {
22
22
  name: IconName;
23
23
  size?: number;
@@ -139,7 +139,7 @@ export declare function TabsContent({ className, ...props }: ComponentPropsWitho
139
139
  export declare const Dialog: import("react").FC<DialogPrimitive.DialogProps>;
140
140
  export declare const DialogTrigger: import("react").ForwardRefExoticComponent<DialogPrimitive.DialogTriggerProps & import("react").RefAttributes<HTMLButtonElement>>;
141
141
  export declare const DialogClose: import("react").ForwardRefExoticComponent<DialogPrimitive.DialogCloseProps & import("react").RefAttributes<HTMLButtonElement>>;
142
- export declare const DialogTitle: typeof DialogPrimitive.Title;
142
+ export declare const DialogTitle: import("react").ForwardRefExoticComponent<Omit<DialogPrimitive.DialogTitleProps & import("react").RefAttributes<HTMLHeadingElement>, "ref"> & import("react").RefAttributes<HTMLHeadingElement>>;
143
143
  export declare const DialogDescription: typeof DialogPrimitive.Description;
144
144
  export interface DialogContentProps extends ComponentPropsWithoutRef<typeof DialogPrimitive.Content> {
145
145
  size?: 'sm' | 'md';
@@ -149,7 +149,7 @@ export declare function DialogContent({ size, className, style, children, ...pro
149
149
  export declare const Sheet: import("react").FC<DialogPrimitive.DialogProps>;
150
150
  export declare const SheetTrigger: import("react").ForwardRefExoticComponent<DialogPrimitive.DialogTriggerProps & import("react").RefAttributes<HTMLButtonElement>>;
151
151
  export declare const SheetClose: import("react").ForwardRefExoticComponent<DialogPrimitive.DialogCloseProps & import("react").RefAttributes<HTMLButtonElement>>;
152
- export declare const SheetTitle: import("react").ForwardRefExoticComponent<DialogPrimitive.DialogTitleProps & import("react").RefAttributes<HTMLHeadingElement>>;
152
+ export declare const SheetTitle: import("react").ForwardRefExoticComponent<Omit<DialogPrimitive.DialogTitleProps & import("react").RefAttributes<HTMLHeadingElement>, "ref"> & import("react").RefAttributes<HTMLHeadingElement>>;
153
153
  export declare const SheetDescription: import("react").ForwardRefExoticComponent<DialogPrimitive.DialogDescriptionProps & import("react").RefAttributes<HTMLParagraphElement>>;
154
154
  export interface SheetContentProps extends ComponentPropsWithoutRef<typeof DialogPrimitive.Content> {
155
155
  side?: 'center' | 'right' | 'bottom';
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "schemaVersion": 1,
3
3
  "package": "@facto-to/design-system",
4
- "packageVersion": "0.1.0-beta.4",
4
+ "packageVersion": "0.1.0-beta.5",
5
5
  "exports": [
6
6
  "Badge",
7
7
  "Button",
@@ -130,6 +130,9 @@
130
130
  "--facto-line-height-heading-md",
131
131
  "--facto-line-height-heading-sm",
132
132
  "--facto-line-height-label",
133
+ "--facto-motion-overlay-backdrop-enter",
134
+ "--facto-motion-overlay-enter-easing",
135
+ "--facto-motion-overlay-mobile-enter",
133
136
  "--facto-muted",
134
137
  "--facto-muted-on-subtle",
135
138
  "--facto-notice-danger-border",
@@ -175,11 +178,13 @@
175
178
  "--facto-text",
176
179
  "--facto-toast-default-description",
177
180
  "--facto-toast-default-foreground",
181
+ "--facto-toast-desktop-reserve",
178
182
  "--facto-toast-error-accent",
179
183
  "--facto-toast-error-description",
180
184
  "--facto-toast-error-shadow",
181
185
  "--facto-toast-gap",
182
186
  "--facto-toast-max-width",
187
+ "--facto-toast-mobile-reserve",
183
188
  "--facto-toast-offset",
184
189
  "--facto-toast-offset-mobile",
185
190
  "--facto-toast-padding",
@@ -9,7 +9,7 @@ See catalog.json for the exact runtime exports and api.d.ts for types. The catal
9
9
  - Tabs: Tabs, TabsList, TabsTrigger, TabsContent; matching value strings, keep accessible tab labels.
10
10
  - Dialog: Dialog, DialogTrigger, DialogContent, DialogTitle, DialogDescription, DialogClose. Sheet has corresponding six parts. ModalHeader/ModalFooter are optional stateless layout slots. DialogContent defaults to sm=400px; explicit md=580px is the wide legacy variant. Use trigger/close asChild to wrap a Button; supply title and description in content.
11
11
  - Tooltip: TooltipProvider, Tooltip, TooltipTrigger, TooltipContent. Trigger asChild with a focusable control; default compact dark tooltip, variant="content" for white expanded content. Provider delay 300ms.
12
- - Toast: ToastProvider, Toast, ToastTitle, ToastDescription, ToastAction, ToastClose, ToastViewport. App controls open/onOpenChange. Default duration 2600ms, bottom center, semantic status surface and matching text/icon. One viewport per group. ToastAction requires altText. No imperative global notification store is exported.
12
+ - Toast: ToastProvider, Toast, ToastTitle, ToastDescription, ToastAction, ToastClose, ToastViewport. App controls open/onOpenChange. Default duration 2600ms; desktop top/right 24px with maximum width 420px, mobile top 16px and full available width with 16px side gutters and safe-area insets; semantic status surface and matching text/icon. One viewport per group. ToastAction requires altText. No imperative global notification store is exported.
13
13
  - Theme: FactoTheme and FactoThemeTokens type. Defaults work without custom values; inline token overrides are forwarded to portals.
14
14
 
15
15
  There is no exported Table, DataTable, DatePicker, Chart, Sidebar, Form controller or router. Keep host implementations for these and apply scoped tokens, or choose a separate dependency only when the task needs it. Do not import internal dist files, copy source modules or claim shadcn-compatible props merely because the implementation uses Radix.
@@ -1,6 +1,6 @@
1
1
  # Facto UI visual contract
2
2
 
3
- This SDK release adopts **Facto UI Standard design rules v1.2, document revision v1.2.5 (2026-09-26)**. The default is the Dashboard light palette. Do not add a theme switch or persistence when adopting it. Existing scoped token overrides remain supported; test their contrast and portalled surfaces separately.
3
+ This SDK release adopts **Facto UI Standard design rules v1.2, document revision v1.2.21 (2026-09-28)**. The default is the Dashboard light palette. Do not add a theme switch or persistence when adopting it. Existing scoped token overrides remain supported; test their contrast and portalled surfaces separately.
4
4
 
5
5
  Use the installed `tokens.css` and component declarations. UI migration changes presentation only: preserve data, authentication, validation, disabled conditions, events, state, API calls and persistence. Dashboard business components and the payment/connection SDK are outside this package.
6
6
 
@@ -49,3 +49,15 @@ Import `fonts.css` and verify Inter actually loads. Test desktop 1440, tablet 83
49
49
  ## Upgrading older visual overrides
50
50
 
51
51
  This beta intentionally changes visual defaults. `--facto-radius-control` remains the general 12px control radius; buttons now use `--facto-button-radius` (pill). Older button-specific `--facto-radius-control-sm`, `--facto-radius-control-lg` and `--facto-radius-danger` entries are retained only for migration discovery and have no styling effect; move button overrides to `--facto-button-radius`. `--facto-icon-button-size` controls the ordinary visible circle; the interactive target remains at least 44px. Prefer `--facto-icon-button-visual-size` for new adapters. `--facto-input-focus-width` still controls the inset edge (default 2px). Consumer DOM selectors targeting a direct child SVG/thumb should be reviewed: visible icon, switch and checkbox surfaces now use inner presentation spans.
52
+
53
+ ## beta.5 responsive overlay changes
54
+
55
+ Single-line ModalHeader has a 32px layout baseline; its 44px close target extends 6px vertically without enlarging the header. A genuinely overflowing title gains keyboard scrolling; ordinary titles do not add a tab stop. Keep descriptions outside the header when a compact title row is intended.
56
+
57
+ At widths up to 700px, newly opened Dialog/Sheet panels slide upward for 320ms with cubic-bezier(.22,1,.36,1); the full-screen scrim fades for 200ms. Reduced motion disables entry animations. Step changes inside the same open panel must not remount the overlay.
58
+
59
+ Toast placement is a Facto decision, not a claim about Link: top/right 24px on desktop, max-width 420px; mobile top16 and full available width minus16px side gutters and safe-area insets. Long messages scroll within a bounded surface. Test active modal actions and focused controls together with notifications, rather than auditing these surfaces separately.
60
+
61
+ Select uses a portalled popper menu with an 8px gap, collision handling and at least148px width where space permits. It retains the Radix modal keyboard contract (arrows/typeahead, Enter selection, Escape and focus return). Dashboard's separate pagination control and its Tab-to-neighbor behavior are not exported by this SDK.
62
+
63
+ Dashboard mobile routes, browser-back/scroll restoration, feature visibility, OTP auto-submit and payment/authentication requests remain application-owned. This release updates shared primitives; it does not export those product flows or automatically upgrade consumers.
@@ -7,7 +7,7 @@ Read version.json for the version used to generate this skill. Check the target
7
7
  For a new compatible project with no installed package:
8
8
 
9
9
  ```sh
10
- npm install --save-exact @facto-to/design-system@0.1.0-beta.4
10
+ npm install --save-exact @facto-to/design-system@0.1.0-beta.5
11
11
  ```
12
12
 
13
13
  React 19 and React DOM 19 must already be compatible with the host; do not reinstall or upgrade them blindly. No Tailwind, backend SDK, API key or runtime environment variable is required.
@@ -100,7 +100,12 @@
100
100
  --facto-toast-gap: 8px;
101
101
  --facto-toast-offset: 24px;
102
102
  --facto-toast-offset-mobile: 16px;
103
- --facto-toast-max-width: 520px;
103
+ --facto-toast-max-width: 420px;
104
+ --facto-toast-mobile-reserve: min(max(192px, calc(env(safe-area-inset-top) + 176px)), 50dvh);
105
+ --facto-toast-desktop-reserve: min(200px, calc(50dvh + 16px));
106
+ --facto-motion-overlay-mobile-enter: 320ms;
107
+ --facto-motion-overlay-backdrop-enter: 200ms;
108
+ --facto-motion-overlay-enter-easing: cubic-bezier(.22, 1, .36, 1);
104
109
  --facto-toast-default-foreground: #fff;
105
110
  --facto-toast-default-description: rgba(255, 255, 255, 0.76);
106
111
  --facto-toast-error-accent: #9f2333;
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "schemaVersion": 1,
3
3
  "package": "@facto-to/design-system",
4
- "packageVersion": "0.1.0-beta.4",
4
+ "packageVersion": "0.1.0-beta.5",
5
5
  "peerDependencies": {
6
6
  "react": "^19.0.0",
7
7
  "react-dom": "^19.0.0"
8
8
  },
9
- "apiSha256": "76ff61c915697125f0c12ef4d73eb64888dfcf7f5d4565a6709879459050481a",
10
- "tokensSha256": "3cb6cc86d5adf10a757416b9e1b5c2b9fa702d548f0aac432b72919d77839200"
9
+ "apiSha256": "1c733734a81bdf4f7e9485066efdeea0f3a6a1522779e097c04641c0177800f1",
10
+ "tokensSha256": "608e66be5ca0ceff89714a2c2bd5f6ae5cb451b14888889fd9ff3179d6c4d2cd"
11
11
  }
package/dist/index.d.ts CHANGED
@@ -17,7 +17,7 @@ export interface FactoThemeProps extends Omit<HTMLAttributes<HTMLDivElement>, 's
17
17
  /** Scoped token container. Inline `--facto-*` values are forwarded to portalled overlays. */
18
18
  export declare function FactoTheme({ className, tokens, style, ...props }: FactoThemeProps): import("react").JSX.Element;
19
19
  /** Shared decorative symbols; name the containing control, not the glyph. */
20
- export type IconName = 'close' | 'arrowLeft' | 'check' | 'chevronDown' | 'info' | 'warning';
20
+ export type IconName = 'close' | 'arrowLeft' | 'check' | 'chevronDown' | 'chevronRight' | 'info' | 'warning';
21
21
  export interface IconProps extends SVGProps<SVGSVGElement> {
22
22
  name: IconName;
23
23
  size?: number;
@@ -139,7 +139,7 @@ export declare function TabsContent({ className, ...props }: ComponentPropsWitho
139
139
  export declare const Dialog: import("react").FC<DialogPrimitive.DialogProps>;
140
140
  export declare const DialogTrigger: import("react").ForwardRefExoticComponent<DialogPrimitive.DialogTriggerProps & import("react").RefAttributes<HTMLButtonElement>>;
141
141
  export declare const DialogClose: import("react").ForwardRefExoticComponent<DialogPrimitive.DialogCloseProps & import("react").RefAttributes<HTMLButtonElement>>;
142
- export declare const DialogTitle: typeof DialogPrimitive.Title;
142
+ export declare const DialogTitle: import("react").ForwardRefExoticComponent<Omit<DialogPrimitive.DialogTitleProps & import("react").RefAttributes<HTMLHeadingElement>, "ref"> & import("react").RefAttributes<HTMLHeadingElement>>;
143
143
  export declare const DialogDescription: typeof DialogPrimitive.Description;
144
144
  export interface DialogContentProps extends ComponentPropsWithoutRef<typeof DialogPrimitive.Content> {
145
145
  size?: 'sm' | 'md';
@@ -149,7 +149,7 @@ export declare function DialogContent({ size, className, style, children, ...pro
149
149
  export declare const Sheet: import("react").FC<DialogPrimitive.DialogProps>;
150
150
  export declare const SheetTrigger: import("react").ForwardRefExoticComponent<DialogPrimitive.DialogTriggerProps & import("react").RefAttributes<HTMLButtonElement>>;
151
151
  export declare const SheetClose: import("react").ForwardRefExoticComponent<DialogPrimitive.DialogCloseProps & import("react").RefAttributes<HTMLButtonElement>>;
152
- export declare const SheetTitle: import("react").ForwardRefExoticComponent<DialogPrimitive.DialogTitleProps & import("react").RefAttributes<HTMLHeadingElement>>;
152
+ export declare const SheetTitle: import("react").ForwardRefExoticComponent<Omit<DialogPrimitive.DialogTitleProps & import("react").RefAttributes<HTMLHeadingElement>, "ref"> & import("react").RefAttributes<HTMLHeadingElement>>;
153
153
  export declare const SheetDescription: import("react").ForwardRefExoticComponent<DialogPrimitive.DialogDescriptionProps & import("react").RefAttributes<HTMLParagraphElement>>;
154
154
  export interface SheetContentProps extends ComponentPropsWithoutRef<typeof DialogPrimitive.Content> {
155
155
  side?: 'center' | 'right' | 'bottom';