division-ds 0.8.0 → 0.9.0

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/AGENTS.md CHANGED
@@ -51,7 +51,7 @@ installs these rules into that project's `AGENTS.md`, `GEMINI.md` and Cursor rul
51
51
  `.claude/skills/` (Claude Code).
52
52
 
53
53
  An agent that supports MCP can have the docs and the same checks as tools instead:
54
- `claude mcp add division-ds -- npx -y division-ds@0.7.1 mcp` (`list_components`, `get_component`,
54
+ `claude mcp add division-ds -- npx -y division-ds@0.8.0 mcp` (`list_components`, `get_component`,
55
55
  `search`, `get_tokens`, `validate_code`, `check_contrast`, `get_add_command`,
56
56
  `get_review_checklist`, and two that report back: `request_change` and `report_drift`, which open
57
57
  an issue on the public repository instead of patching the installed copy).
package/package.json CHANGED
@@ -1,10 +1,10 @@
1
1
  {
2
2
  "name": "division-ds",
3
- "version": "0.8.0",
3
+ "version": "0.9.0",
4
4
  "description": "Checks a project that uses Division DS components (raw colours, invented tokens, touching buttons, unknown props), and serves the docs and the same checks to agents over MCP.",
5
5
  "license": "MIT",
6
6
  "author": "Victor Ilioiu",
7
- "homepage": "https://victor-ilioiu.vercel.app/systems/division-ds/",
7
+ "homepage": "https://victorilioiu.com/systems/division-ds/",
8
8
  "repository": {
9
9
  "type": "git",
10
10
  "url": "git+https://github.com/Victor-Ilioiu/division-ds.git"
@@ -31,6 +31,7 @@ Paths are from the Division DS repository root. Installed with shadcn they start
31
31
  | `placeholder` | `string` | `'Select…'` | Shown while nothing is chosen. |
32
32
  | `emptyMessage` | `string` | `'No matches'` | Shown in the panel when the typed text matches no option. |
33
33
  | `creatable` | `boolean` | `false` | Adds one last row, `Create "<text>"`, when the typed text matches no option (ignoring case). It is never shown for empty text or for text that is already an option. It is an ordinary option in the list: the arrows reach it, Enter or a click chooses it, and screen readers read its label. |
34
+ | `createHint` | `string \| null` | `'Type to find an option, or to create a new one.'` | creatable only. A line of secondary text at the top of the panel while the text field is empty, so people discover that typing a new name creates it. It is not an option: the arrows skip it. Pass a domain wording (e.g. "Type to find a label, or to create a new one.") or `null` to hide it. |
34
35
  | `onCreate` | `(text: string) => void` | | Runs with the typed text, trimmed, when the create row is chosen. The text field is then cleared. The component does not add anything itself: add the new option to options and its value to value here. |
35
36
  | `createLabel` | `(text: string) => string` | `(text) => `Create "${text}"`` | The create row's label, for other wording or another language. |
36
37
  | `inputSize` | `'sm' \| 'md' \| 'lg'` | `'md'` | Matches Input and Select: a minimum height of 32, 40 or 48px (pixels), with text at size xs, sm or base. It also sets the size of the typed text and of the option rows in the list (28, 32 or 40px). The tags come in one size, so sm fits a single row of them snugly, and md and lg add room around it. The field grows past the minimum as tags wrap. |
@@ -6333,6 +6333,12 @@
6333
6333
  "default": "false",
6334
6334
  "description": "Adds one last row, `Create \"<text>\"`, when the typed text matches no option (ignoring case). It is never shown for empty text or for text that is already an option. It is an ordinary option in the list: the arrows reach it, Enter or a click chooses it, and screen readers read its label."
6335
6335
  },
6336
+ {
6337
+ "name": "createHint",
6338
+ "type": "string | null",
6339
+ "default": "'Type to find an option, or to create a new one.'",
6340
+ "description": "creatable only. A line of secondary text at the top of the panel while the text field is empty, so people discover that typing a new name creates it. It is not an option: the arrows skip it. Pass a domain wording (e.g. \"Type to find a label, or to create a new one.\") or `null` to hide it."
6341
+ },
6336
6342
  {
6337
6343
  "name": "onCreate",
6338
6344
  "type": "(text: string) => void",
@@ -5,7 +5,7 @@ const TIER_NOUN = { atoms: 'Atom', molecules: 'Molecule', organisms: 'Organism'
5
5
 
6
6
  /** Where the docs site is hosted. The skill names it so an assistant outside this repository can
7
7
  * still read the component pages; src/links.ts holds the same address for the site itself. */
8
- export const DOCS_SITE = 'https://victor-ilioiu.vercel.app/systems/division-ds/'
8
+ export const DOCS_SITE = 'https://victorilioiu.com/systems/division-ds/'
9
9
  /** Where shadcn downloads the components from: public/r/ in the public GitHub repository. */
10
10
  export const REGISTRY = 'https://raw.githubusercontent.com/Victor-Ilioiu/division-ds/main/public/r'
11
11
  /** The skill's files in the public repository, for a reader who has the package but not the skill. */
@@ -13,7 +13,7 @@ export const PROTOCOL_VERSIONS = ['2025-11-25', '2025-06-18', '2025-03-26', '202
13
13
  const INSTRUCTIONS = `Division DS: a React 19, Tailwind 4 and Radix design system.
14
14
  Before writing a component, call get_component for its props and examples. Use only tokens from get_tokens or search, as var(--name).
15
15
  Before saying a screen is done, call validate_code on each file you wrote (.css too) and fix every finding, then go through get_review_checklist.
16
- Shared helpers (theme toggle, form errors, money, links): https://victor-ilioiu.vercel.app/systems/division-ds/docs/helpers.md`
16
+ Shared helpers (theme toggle, form errors, money, links): https://victorilioiu.com/systems/division-ds/docs/helpers.md`
17
17
 
18
18
  /** A JSON-RPC error reply. */
19
19
  const failure = (id, code, message) => ({ jsonrpc: '2.0', id, error: { code, message } })
@@ -23,7 +23,7 @@ Before writing a screen, list its regions and, for each, its states: empty, load
23
23
  | Shared helpers: form errors, money, links, theme, streamed text | `public/docs/helpers.md` |
24
24
  | The same as data | `public/manifest/components.json`, `public/manifest/tokens.json` |
25
25
 
26
- Outside this repository, read the same files online: `https://victor-ilioiu.vercel.app/systems/division-ds/llms.txt`, `https://victor-ilioiu.vercel.app/systems/division-ds/docs/components/<slug>.md`, and so on. Add a component to a project with `npx shadcn@latest add https://raw.githubusercontent.com/Victor-Ilioiu/division-ds/main/public/r/<slug>.json`, or every component with `division-ds-all` as the slug. The setup steps, in plain text: `https://victor-ilioiu.vercel.app/systems/division-ds/install.md`.
26
+ Outside this repository, read the same files online: `https://victorilioiu.com/systems/division-ds/llms.txt`, `https://victorilioiu.com/systems/division-ds/docs/components/<slug>.md`, and so on. Add a component to a project with `npx shadcn@latest add https://raw.githubusercontent.com/Victor-Ilioiu/division-ds/main/public/r/<slug>.json`, or every component with `division-ds-all` as the slug. The setup steps, in plain text: `https://victorilioiu.com/systems/division-ds/install.md`.
27
27
 
28
28
  ## Check your work
29
29
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  > Load when adding one component to a screen that already exists. Generated by `npm run agent-docs`; the procedure lives in scripts/lib/agent-docs.mjs.
4
4
 
5
- Paths starting `public/` are in the Division DS repository. In a project that uses the components, read them online: `public/llms.txt` is `https://victor-ilioiu.vercel.app/systems/division-ds/llms.txt`, and so on. The other procedures named here (`commands/build.md` and the rest) are in the skill: `https://github.com/Victor-Ilioiu/division-ds/blob/main/skills/division-ds/commands/<name>.md`, or `npx division-ds skill` to install them.
5
+ Paths starting `public/` are in the Division DS repository. In a project that uses the components, read them online: `public/llms.txt` is `https://victorilioiu.com/systems/division-ds/llms.txt`, and so on. The other procedures named here (`commands/build.md` and the rest) are in the skill: `https://github.com/Victor-Ilioiu/division-ds/blob/main/skills/division-ds/commands/<name>.md`, or `npx division-ds skill` to install them.
6
6
 
7
7
  1. Find it in `public/llms.txt`. Its "Best for" should describe your case and its "Not for"
8
8
  should not; if "Not for" names your case, use the component it names instead.
@@ -2,7 +2,7 @@
2
2
 
3
3
  > Load when building a new screen or page. Plans the regions and their states before any code. Generated by `npm run agent-docs`; the procedure lives in scripts/lib/agent-docs.mjs.
4
4
 
5
- Paths starting `public/` are in the Division DS repository. In a project that uses the components, read them online: `public/llms.txt` is `https://victor-ilioiu.vercel.app/systems/division-ds/llms.txt`, and so on. The other procedures named here (`commands/build.md` and the rest) are in the skill: `https://github.com/Victor-Ilioiu/division-ds/blob/main/skills/division-ds/commands/<name>.md`, or `npx division-ds skill` to install them.
5
+ Paths starting `public/` are in the Division DS repository. In a project that uses the components, read them online: `public/llms.txt` is `https://victorilioiu.com/systems/division-ds/llms.txt`, and so on. The other procedures named here (`commands/build.md` and the rest) are in the skill: `https://github.com/Victor-Ilioiu/division-ds/blob/main/skills/division-ds/commands/<name>.md`, or `npx division-ds skill` to install them.
6
6
 
7
7
  Plan before code. The states a screen gets wrong are the ones nobody planned: an empty list
8
8
  with no message, a load that fails into a blank panel, a button that is disabled with no reason.
@@ -2,7 +2,7 @@
2
2
 
3
3
  > Load when a gate, `division-ds check` or a test has failed and named a rule. What each message means and the fix. Generated by `npm run agent-docs`; the procedure lives in scripts/lib/agent-docs.mjs.
4
4
 
5
- Paths starting `public/` are in the Division DS repository. In a project that uses the components, read them online: `public/llms.txt` is `https://victor-ilioiu.vercel.app/systems/division-ds/llms.txt`, and so on. The other procedures named here (`commands/build.md` and the rest) are in the skill: `https://github.com/Victor-Ilioiu/division-ds/blob/main/skills/division-ds/commands/<name>.md`, or `npx division-ds skill` to install them.
5
+ Paths starting `public/` are in the Division DS repository. In a project that uses the components, read them online: `public/llms.txt` is `https://victorilioiu.com/systems/division-ds/llms.txt`, and so on. The other procedures named here (`commands/build.md` and the rest) are in the skill: `https://github.com/Victor-Ilioiu/division-ds/blob/main/skills/division-ds/commands/<name>.md`, or `npx division-ds skill` to install them.
6
6
 
7
7
  Every finding prints `path:line [rule] what was found` and a line saying what to write instead.
8
8
  Do what that line says. Never silence a gate: no new EXEMPT entry, no `token-discipline: allow`
@@ -2,7 +2,7 @@
2
2
 
3
3
  > Load when a screen is written and you are about to say it is done. The checklist to run over it. Generated by `npm run agent-docs`; the procedure lives in scripts/lib/agent-docs.mjs.
4
4
 
5
- Paths starting `public/` are in the Division DS repository. In a project that uses the components, read them online: `public/llms.txt` is `https://victor-ilioiu.vercel.app/systems/division-ds/llms.txt`, and so on. The other procedures named here (`commands/build.md` and the rest) are in the skill: `https://github.com/Victor-Ilioiu/division-ds/blob/main/skills/division-ds/commands/<name>.md`, or `npx division-ds skill` to install them.
5
+ Paths starting `public/` are in the Division DS repository. In a project that uses the components, read them online: `public/llms.txt` is `https://victorilioiu.com/systems/division-ds/llms.txt`, and so on. The other procedures named here (`commands/build.md` and the rest) are in the skill: `https://github.com/Victor-Ilioiu/division-ds/blob/main/skills/division-ds/commands/<name>.md`, or `npx division-ds skill` to install them.
6
6
 
7
7
  Go through every line. A line that does not hold is a change to make, not a note to leave.
8
8