@mason-ds/vue 0.2.0 → 0.2.1

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/llms.txt ADDED
@@ -0,0 +1,57 @@
1
+ # @mason-ds/vue
2
+
3
+ > Vue components for mason-ds. Consume **semantic** tokens only (`@mason-ds/tokens/tokens.css`). Palette-first: identity comes from tokens, not hardcoded brand colors. API mirrors `@mason-ds/react`.
4
+
5
+ ## Peer / deps
6
+
7
+ - `vue` ^3
8
+ - `@mason-ds/tokens` (workspace / same major on npm)
9
+
10
+ ## Setup
11
+
12
+ ```vue
13
+ <script setup lang="ts">
14
+ import '@mason-ds/tokens/tokens.css'
15
+ import { MasonProvider, Button } from '@mason-ds/vue'
16
+ </script>
17
+
18
+ <template>
19
+ <MasonProvider>
20
+ <Button variant="primary">Save</Button>
21
+ </MasonProvider>
22
+ </template>
23
+ ```
24
+
25
+ Wrap the tree in `MasonProvider`. Import `tokens.css` (or a `mason-tokens build` output) once at the app root.
26
+
27
+ ## Components
28
+
29
+ Provider: `MasonProvider`
30
+
31
+ Primitives: `Text` · `Stack` · `Card` · `Divider` · `Link`
32
+
33
+ Actions / status: `Button` · `Spinner` · `Badge` · `Callout`
34
+
35
+ Forms: `TextField` · `Select` · `Checkbox` · `Radio`
36
+
37
+ Size / spacing / radius levels: **sm / md / lg** only.
38
+
39
+ ## Notable APIs
40
+
41
+ - `Button`: `variant` primary|secondary|ghost|danger · `size` sm|md|lg · `loading` · `disabled` · slots `leading` / `trailing` / default · icon-only needs `aria-label`
42
+ - Forms: `v-model` supported; `label` · `description` · `error` as props or slots
43
+ - `Checkbox` / `Radio`: drawn indicators; native input kept for a11y
44
+ - `Radio`: use `name` + `value` + `v-model` for groups
45
+
46
+ ## Do / don't
47
+
48
+ - Do: reference semantic CSS variables / token helpers from styles
49
+ - Don't: import `palette*` inside components
50
+ - React parity: `@mason-ds/react` — same set; uses `leadingSlot` / `trailingSlot` props instead of slots
51
+
52
+ ## Links
53
+
54
+ - npm: https://www.npmjs.com/package/@mason-ds/vue
55
+ - Repo: https://github.com/FE-HyunSu/mason-ds/tree/main/packages/vue
56
+ - Tokens: `@mason-ds/tokens`
57
+ - License: Apache-2.0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mason-ds/vue",
3
- "version": "0.2.0",
3
+ "version": "0.2.1",
4
4
  "description": "Vue components for mason-ds",
5
5
  "type": "module",
6
6
  "exports": {
@@ -23,10 +23,11 @@
23
23
  "dist",
24
24
  "README.md",
25
25
  "LICENSE",
26
- "NOTICE"
26
+ "NOTICE",
27
+ "llms.txt"
27
28
  ],
28
29
  "dependencies": {
29
- "@mason-ds/tokens": "0.2.0"
30
+ "@mason-ds/tokens": "0.2.1"
30
31
  },
31
32
  "peerDependencies": {
32
33
  "vue": "^3.4.0"