@astryxdesign/cli 0.1.3-canary.48b6f42 → 0.1.3-canary.4aed50d
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.
|
@@ -15,11 +15,11 @@ export const docs = {
|
|
|
15
15
|
content: [
|
|
16
16
|
{
|
|
17
17
|
type: 'prose',
|
|
18
|
-
text: 'Astryx is built on modern web platform features
|
|
18
|
+
text: 'Astryx is built on modern web platform features: the Popover API, CSS anchor positioning, and CSS `light-dark()`. These let components stay small, accessible, and dependency-free, but they also set a floor on which browsers render everything correctly.',
|
|
19
19
|
},
|
|
20
20
|
{
|
|
21
21
|
type: 'prose',
|
|
22
|
-
text: 'A design system does not own its traffic
|
|
22
|
+
text: 'A design system does not own its traffic; the products built on it do. Their audiences range from evergreen-Chrome-only internal tools to public sites with meaningful older-Safari share. So Astryx does not declare a single hard browser floor the way an app would. Instead it defines tiers that describe what works at each level, and hands the final decision to you. Pick the tier that matches your audience.',
|
|
23
23
|
},
|
|
24
24
|
],
|
|
25
25
|
},
|
|
@@ -35,19 +35,19 @@ export const docs = {
|
|
|
35
35
|
headers: ['Tier', 'Baseline', 'Representative versions', 'What your users experience'],
|
|
36
36
|
rows: [
|
|
37
37
|
[
|
|
38
|
-
'Tier 1
|
|
38
|
+
'Tier 1: Full fidelity',
|
|
39
39
|
'Current Baseline (2026)',
|
|
40
40
|
'Chrome 125+, Edge 125+, Safari 26+, Firefox 147+',
|
|
41
41
|
'Everything works, including CSS anchor positioning. This is the reference target.',
|
|
42
42
|
],
|
|
43
43
|
[
|
|
44
|
-
'Tier 2
|
|
44
|
+
'Tier 2: Functional',
|
|
45
45
|
'Baseline − 2 years (2024)',
|
|
46
46
|
'Chrome 114+, Edge 114+, Safari 17+, Firefox 125+',
|
|
47
47
|
'Components open, dismiss, and are fully usable. Only anchor positioning is missing, so layered surfaces (tooltips, menus, popovers) may not be positioned next to their trigger.',
|
|
48
48
|
],
|
|
49
49
|
[
|
|
50
|
-
'Tier 3
|
|
50
|
+
'Tier 3: Below Tier 2',
|
|
51
51
|
'Older than Baseline − 2',
|
|
52
52
|
'Anything older',
|
|
53
53
|
'Best-effort. The only guarantee is "does not crash." `light-dark()` is unavailable, so theme colors may fall back to defaults.',
|
|
@@ -70,7 +70,7 @@ export const docs = {
|
|
|
70
70
|
[
|
|
71
71
|
'CSS Anchor Positioning',
|
|
72
72
|
'Positions layered surfaces relative to their trigger (tooltips, menus, popovers, dropdowns).',
|
|
73
|
-
'Baseline 2026
|
|
73
|
+
'Baseline 2026: the tightest requirement.',
|
|
74
74
|
],
|
|
75
75
|
[
|
|
76
76
|
'Popover API',
|
|
@@ -86,7 +86,7 @@ export const docs = {
|
|
|
86
86
|
},
|
|
87
87
|
{
|
|
88
88
|
type: 'prose',
|
|
89
|
-
text: 'The gap that matters is between Tier 1 and Tier 2: the Popover API and `light-dark()` reached wide availability well before anchor positioning. So in Tier 2 browsers, layered surfaces open and dismiss correctly
|
|
89
|
+
text: 'The gap that matters is between Tier 1 and Tier 2: the Popover API and `light-dark()` reached wide availability well before anchor positioning. So in Tier 2 browsers, layered surfaces open and dismiss correctly; they just are not positioned. This is the one feature most consumers will need to reason about.',
|
|
90
90
|
},
|
|
91
91
|
],
|
|
92
92
|
},
|
|
@@ -95,7 +95,7 @@ export const docs = {
|
|
|
95
95
|
content: [
|
|
96
96
|
{
|
|
97
97
|
type: 'prose',
|
|
98
|
-
text: 'The browser requirement is concentrated in the layered-surface components
|
|
98
|
+
text: 'The browser requirement is concentrated in the layered-surface components: anything that renders content in an overlay positioned against a trigger:',
|
|
99
99
|
},
|
|
100
100
|
{
|
|
101
101
|
type: 'list',
|
|
@@ -112,7 +112,7 @@ export const docs = {
|
|
|
112
112
|
},
|
|
113
113
|
{
|
|
114
114
|
type: 'prose',
|
|
115
|
-
text: 'If your product does not use any of these, it has no anchor-positioning requirement at all
|
|
115
|
+
text: 'If your product does not use any of these, it has no anchor-positioning requirement at all; it needs only `light-dark()` (Tier 2 and up) for correct theme colors. Layout, typography, forms, buttons, cards, tables, and navigation all work down to Tier 2 with no special handling.',
|
|
116
116
|
},
|
|
117
117
|
],
|
|
118
118
|
},
|
|
@@ -132,7 +132,7 @@ export const docs = {
|
|
|
132
132
|
type: 'list',
|
|
133
133
|
style: 'dont',
|
|
134
134
|
items: [
|
|
135
|
-
'Astryx does not guarantee correct layer positioning below Tier 1 (anchor positioning). Closing that gap for a Tier 2 audience is a consumer choice
|
|
135
|
+
'Astryx does not guarantee correct layer positioning below Tier 1 (anchor positioning). Closing that gap for a Tier 2 audience is a consumer choice; see below.',
|
|
136
136
|
'Astryx does not ship a `light-dark()` fallback, so theme colors are not guaranteed below Tier 2.',
|
|
137
137
|
],
|
|
138
138
|
},
|
|
@@ -143,7 +143,7 @@ export const docs = {
|
|
|
143
143
|
content: [
|
|
144
144
|
{
|
|
145
145
|
type: 'prose',
|
|
146
|
-
text: 'If your audience includes Tier 2 browsers and you need correct layer positioning, you have three options, cheapest first. All of them are decisions you make for your audience
|
|
146
|
+
text: 'If your audience includes Tier 2 browsers and you need correct layer positioning, you have three options, cheapest first. All of them are decisions you make for your audience; Astryx does not impose one.',
|
|
147
147
|
},
|
|
148
148
|
{
|
|
149
149
|
type: 'list',
|
|
@@ -192,7 +192,7 @@ const hasLightDark = CSS.supports('color', 'light-dark(#000, #fff)');`,
|
|
|
192
192
|
},
|
|
193
193
|
{
|
|
194
194
|
type: 'prose',
|
|
195
|
-
text: 'This is not an arbitrary window: Baseline − 2 is close to where anchor positioning stops being available while the Popover API and `light-dark()` still are
|
|
195
|
+
text: 'This is not an arbitrary window: Baseline − 2 is close to where anchor positioning stops being available while the Popover API and `light-dark()` still are, so the tier boundary tracks a real capability edge, not a guessed date. The version floors above are reviewed and advanced roughly once a year as new Baseline years land. Always feature-detect rather than hardcoding version numbers, so your app adapts automatically as the platform moves.',
|
|
196
196
|
},
|
|
197
197
|
],
|
|
198
198
|
},
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@astryxdesign/cli",
|
|
3
|
-
"version": "0.1.3-canary.
|
|
3
|
+
"version": "0.1.3-canary.4aed50d",
|
|
4
4
|
"displayName": "CLI",
|
|
5
5
|
"description": "Scaffold projects, browse templates, generate themes, and get agent-ready docs from the command line.",
|
|
6
6
|
"author": "Meta Open Source",
|
|
@@ -75,9 +75,9 @@
|
|
|
75
75
|
"zod": "^4.4.3"
|
|
76
76
|
},
|
|
77
77
|
"peerDependencies": {
|
|
78
|
-
"@astryxdesign/core": "0.1.3-canary.
|
|
79
|
-
"@astryxdesign/lab": "0.1.3-canary.
|
|
80
|
-
"@astryxdesign/theme-neutral": "0.1.3-canary.
|
|
78
|
+
"@astryxdesign/core": "0.1.3-canary.4aed50d",
|
|
79
|
+
"@astryxdesign/lab": "0.1.3-canary.4aed50d",
|
|
80
|
+
"@astryxdesign/theme-neutral": "0.1.3-canary.4aed50d",
|
|
81
81
|
"gpt-tokenizer": "^2.0.0"
|
|
82
82
|
},
|
|
83
83
|
"peerDependenciesMeta": {
|
|
@@ -92,9 +92,9 @@
|
|
|
92
92
|
}
|
|
93
93
|
},
|
|
94
94
|
"devDependencies": {
|
|
95
|
-
"@astryxdesign/core": "0.1.3-canary.
|
|
96
|
-
"@astryxdesign/lab": "0.1.3-canary.
|
|
97
|
-
"@astryxdesign/theme-neutral": "0.1.3-canary.
|
|
95
|
+
"@astryxdesign/core": "0.1.3-canary.4aed50d",
|
|
96
|
+
"@astryxdesign/lab": "0.1.3-canary.4aed50d",
|
|
97
|
+
"@astryxdesign/theme-neutral": "0.1.3-canary.4aed50d",
|
|
98
98
|
"gpt-tokenizer": "^2.0.0"
|
|
99
99
|
},
|
|
100
100
|
"scripts": {
|
package/src/utils/paths.test.mjs
CHANGED
|
@@ -97,7 +97,7 @@ describe('discoverExternalPackages', () => {
|
|
|
97
97
|
fs.writeFileSync(
|
|
98
98
|
path.join(scopedDir, 'package.json'),
|
|
99
99
|
JSON.stringify({
|
|
100
|
-
name: '@acme/
|
|
100
|
+
name: '@acme/astryx-widgets',
|
|
101
101
|
astryx: {docs: './lib', category: 'Widgets'},
|
|
102
102
|
}),
|
|
103
103
|
);
|
|
@@ -105,7 +105,7 @@ describe('discoverExternalPackages', () => {
|
|
|
105
105
|
const result = discoverExternalPackages(tmpDir);
|
|
106
106
|
expect(result).toEqual([
|
|
107
107
|
{
|
|
108
|
-
name: '@acme/
|
|
108
|
+
name: '@acme/astryx-widgets',
|
|
109
109
|
category: 'Widgets',
|
|
110
110
|
docsDir: path.join(scopedDir, 'lib'),
|
|
111
111
|
blocksDir: null,
|
|
@@ -7,7 +7,7 @@ export const doc = {
|
|
|
7
7
|
name: 'TabList — With Actions',
|
|
8
8
|
displayName: 'TabList — With Actions',
|
|
9
9
|
description:
|
|
10
|
-
'Page header pattern with tabs on the left and action buttons pushed to the right. When hasDivider is true, pair with a smaller button size (sm) so actions don\
|
|
10
|
+
'Page header pattern with tabs on the left and action buttons pushed to the right. When hasDivider is true, pair with a smaller button size (sm) so actions don\'t overpower the tab row.',
|
|
11
11
|
isReady: true,
|
|
12
12
|
aspectRatio: 4 / 3,
|
|
13
13
|
componentsUsed: ['TabList', 'Tab', 'Button'],
|
|
@@ -94,13 +94,13 @@ export const stoneTheme = defineTheme({
|
|
|
94
94
|
// Core semantic — all neutrals H=291
|
|
95
95
|
// Stone 900 T=16 C=1.4, Stone 500 T=55 C=4, Stone 300 T=86 C=1.6, Stone 100 T=96 C=1
|
|
96
96
|
'--color-accent': ['#25252a', '#f3f3f5'], // light: Stone Neutral T15
|
|
97
|
-
'--color-accent-muted': ['#25252a14', '#
|
|
97
|
+
'--color-accent-muted': ['#25252a14', '#f3f3f520'], // light: Stone Neutral T15 · 8% / dark: T96 · 12.5%
|
|
98
98
|
'--color-neutral': ['#25252a0f', '#f3f3f51a'], // light: Stone Neutral T15 · 6% / dark: T96 · 10%
|
|
99
99
|
'--color-background-surface': ['#ffffff', '#1b1b1f'], // dark: Stone Neutral T10
|
|
100
100
|
'--color-background-body': ['#f3f3f5', '#111015'], // dark: Stone Neutral T5
|
|
101
101
|
'--color-overlay': ['#25252a80', '#28282a'], // light: Stone Neutral T15 · 50%
|
|
102
|
-
'--color-overlay-hover': ['#25252a0d', '#
|
|
103
|
-
'--color-overlay-pressed': ['#25252a1a', '#
|
|
102
|
+
'--color-overlay-hover': ['#25252a0d', '#f3f3f50d'], // light: Stone Neutral T15 · 5% / dark: T96 · 5%
|
|
103
|
+
'--color-overlay-pressed': ['#25252a1a', '#f3f3f51a'], // light: Stone Neutral T15 · 10% / dark: T96 · 10%
|
|
104
104
|
'--color-background-muted': ['#e2e2e8', '#3b3b3f'], // light: Stone Neutral T90
|
|
105
105
|
|
|
106
106
|
// Text — H=291
|