@kazee-ds/init 0.1.6 → 0.1.7

package/README.md

@@ -1,8 +1,8 @@
 # @kazee-ds/init
 
-Preview-first setup for an existing standalone React or Vue application. Published CLI 0.1.6 pins React/Vue/styles at 0.5.3 and consumer lint at 0.4.2. Verify the available npm versions before installing. Earlier CLI releases targeted private GitLab.
+Preview-first setup for an existing standalone React or Vue application. Published CLI 0.1.7 pins React/Vue/styles at 0.5.4 and consumer lint at 0.4.2. Verify the available npm versions before installing. Earlier CLI releases targeted private GitLab.
 
-From an existing application, preview with `npm exec --yes --package=@kazee-ds/init@0.1.6 -- kazee-init`; append `--apply` after reviewing the plan.
+From an existing application, preview with `npm exec --yes --package=@kazee-ds/init@0.1.7 -- kazee-init`; append `--apply` after reviewing the plan.
 
 From the design-system checkout, run:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kazee-ds/init",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "Preview-first setup for Kazee Design System consumers",
   "type": "module",
   "bin": {

package/src/content.mjs

@@ -1,43 +1,43 @@
-import { readFileSync } from 'node:fs';
-
-export const RELEASE = Object.freeze({ framework: '0.5.3', styles: '0.5.3', lint: '0.4.2' });
-export const REGISTRY = 'https://registry.npmjs.org/';
-const INIT_VERSION = JSON.parse(
-  readFileSync(new URL('../package.json', import.meta.url), 'utf8'),
-).version;
-export const START = '<!-- kazee-ds:init:start -->';
-export const END = '<!-- kazee-ds:init:end -->';
-
-export function managedRules(framework) {
-  const template = readFileSync(
-    new URL('../templates/AGENTS.md', import.meta.url),
-    'utf8',
-  ).replaceAll('\r\n', '\n');
-  const other = framework === 'react' ? 'Vue' : 'React';
-  const filtered = template.replace(new RegExp(`## ${other} API\\n[\\s\\S]*?(?=\\n## |$)`), '');
-  return `${START}\n<!-- Template revision: 2026-10-28; init ${INIT_VERSION}; ${framework} -->\n${filtered.trim()}\n${END}`;
-}
-
-export function installCommand(manager, framework) {
-  const runtime = `@kazee-ds/${framework}@${RELEASE.framework} @kazee-ds/styles@${RELEASE.styles}`;
-  const lint = `@kazee-ds/eslint-config@${RELEASE.lint}`;
-  if (manager === 'npm')
-    return `npm install --save-exact ${runtime}\nnpm install --save-dev --save-exact ${lint}`;
-  if (manager === 'pnpm')
-    return `pnpm add --save-exact ${runtime}\npnpm add --save-dev --save-exact ${lint}`;
-  return `yarn add --exact ${runtime}\nyarn add --dev --exact ${lint}`;
-}
-
-export function setupGuide(framework, manager) {
-  const lintGuide = readFileSync(
-    new URL('../templates/consumer-lint.md', import.meta.url),
-    'utf8',
-  ).replaceAll('\r\n', '\n');
-  const heading =
-    framework === 'react'
-      ? '### Complete React/TypeScript example'
-      : '### Complete Vue/TypeScript example';
-  const section = lintGuide.slice(lintGuide.indexOf(heading));
-  const example = section.match(/```js\n([\s\S]*?)```/)[1];
-  return `# Kazee setup — ${framework}\n\nGenerated by @kazee-ds/init ${INIT_VERSION}. These are supported pinned versions, not a latest-version query.\n\n## Install dependencies\n\nPackages are distributed on public npm. No read token or login is required. Confirm the pinned versions exist on npm before installation.\n\n\`\`\`sh\n${installCommand(manager, framework)}\n\`\`\`\n\nCommit the updated package manifest and the application's existing lockfile after installation. Init does not install dependencies or update lockfiles.\n\n${manager === 'yarn' ? 'Yarn guidance is limited to Yarn Classic. Init does not create modern Yarn .yarnrc.yml authentication settings.\n\n' : ''}## Manual step: import shared CSS\n\nAdd this once to the application's existing global entry point:\n\n\`\`\`js\nimport '@kazee-ds/styles/index.css';\n\`\`\`\n\nIt includes the tokens. Keep the application's existing stylesheet imports. This step has not been performed by init.\n\n## Manual step: enable lint\n\nUse ESLint 10 with the application's existing parsers. This example assumes typescript-eslint${framework === 'vue' ? ' and eslint-plugin-vue' : ''} are installed. Adapt source globs to the application, preserve existing checks, and include consumerConfig in the exported flat config after parser setup.\n\n\`\`\`js\n${example}\`\`\`\n\nInit has not modified ESLint config or CI. Run lint in the application's CI; installing the package alone does not activate its rules.\n\n## Optional MCP reference\n\nConnect the Kazee MCP server using the client-specific configuration in the MCP guide. Start with get_catalog_versions and pass the exact installed framework package version to docs/examples tools. Init has not edited MCP client configuration or enabled a server.\n\n## Verify\n\nRun the application's existing lint, typecheck, and build scripts. Check Button activation/disabled behavior, Select keyboard selection, and shared styling. Report missing scripts instead of claiming they passed.\n\n- [Public Storybook](https://kazee-design-system-023417.gitlab.io)\n- [Installation guide](https://gitlab.com/kazee.indonesia/kazee-design-system/-/blob/main/docs/installation.md)\n- [Consumer lint guide](https://gitlab.com/kazee.indonesia/kazee-design-system/-/blob/main/docs/consumer-lint.md)\n\nThe source repository may remain private; published npm packages and Storybook are public.\n`;
-}
+import { readFileSync } from 'node:fs';
+
+export const RELEASE = Object.freeze({ framework: '0.5.4', styles: '0.5.4', lint: '0.4.2' });
+export const REGISTRY = 'https://registry.npmjs.org/';
+const INIT_VERSION = JSON.parse(
+  readFileSync(new URL('../package.json', import.meta.url), 'utf8'),
+).version;
+export const START = '<!-- kazee-ds:init:start -->';
+export const END = '<!-- kazee-ds:init:end -->';
+
+export function managedRules(framework) {
+  const template = readFileSync(
+    new URL('../templates/AGENTS.md', import.meta.url),
+    'utf8',
+  ).replaceAll('\r\n', '\n');
+  const other = framework === 'react' ? 'Vue' : 'React';
+  const filtered = template.replace(new RegExp(`## ${other} API\\n[\\s\\S]*?(?=\\n## |$)`), '');
+  return `${START}\n<!-- Template revision: 2026-10-28; init ${INIT_VERSION}; ${framework} -->\n${filtered.trim()}\n${END}`;
+}
+
+export function installCommand(manager, framework) {
+  const runtime = `@kazee-ds/${framework}@${RELEASE.framework} @kazee-ds/styles@${RELEASE.styles}`;
+  const lint = `@kazee-ds/eslint-config@${RELEASE.lint}`;
+  if (manager === 'npm')
+    return `npm install --save-exact ${runtime}\nnpm install --save-dev --save-exact ${lint}`;
+  if (manager === 'pnpm')
+    return `pnpm add --save-exact ${runtime}\npnpm add --save-dev --save-exact ${lint}`;
+  return `yarn add --exact ${runtime}\nyarn add --dev --exact ${lint}`;
+}
+
+export function setupGuide(framework, manager) {
+  const lintGuide = readFileSync(
+    new URL('../templates/consumer-lint.md', import.meta.url),
+    'utf8',
+  ).replaceAll('\r\n', '\n');
+  const heading =
+    framework === 'react'
+      ? '### Complete React/TypeScript example'
+      : '### Complete Vue/TypeScript example';
+  const section = lintGuide.slice(lintGuide.indexOf(heading));
+  const example = section.match(/```js\n([\s\S]*?)```/)[1];
+  return `# Kazee setup — ${framework}\n\nGenerated by @kazee-ds/init ${INIT_VERSION}. These are supported pinned versions, not a latest-version query.\n\n## Install dependencies\n\nPackages are distributed on public npm. No read token or login is required. Confirm the pinned versions exist on npm before installation.\n\n\`\`\`sh\n${installCommand(manager, framework)}\n\`\`\`\n\nCommit the updated package manifest and the application's existing lockfile after installation. Init does not install dependencies or update lockfiles.\n\n${manager === 'yarn' ? 'Yarn guidance is limited to Yarn Classic. Init does not create modern Yarn .yarnrc.yml authentication settings.\n\n' : ''}## Manual step: import shared CSS\n\nAdd this once to the application's existing global entry point:\n\n\`\`\`js\nimport '@kazee-ds/styles/index.css';\n\`\`\`\n\nIt includes the tokens. Keep the application's existing stylesheet imports. This step has not been performed by init.\n\n## Manual step: enable lint\n\nUse ESLint 10 with the application's existing parsers. This example assumes typescript-eslint${framework === 'vue' ? ' and eslint-plugin-vue' : ''} are installed. Adapt source globs to the application, preserve existing checks, and include consumerConfig in the exported flat config after parser setup.\n\n\`\`\`js\n${example}\`\`\`\n\nInit has not modified ESLint config or CI. Run lint in the application's CI; installing the package alone does not activate its rules.\n\n## Optional MCP reference\n\nConnect the Kazee MCP server using the client-specific configuration in the MCP guide. Start with get_catalog_versions and pass the exact installed framework package version to docs/examples tools. Init has not edited MCP client configuration or enabled a server.\n\n## Verify\n\nRun the application's existing lint, typecheck, and build scripts. Check Button activation/disabled behavior, Select keyboard selection, and shared styling. Report missing scripts instead of claiming they passed.\n\n- [Public Storybook](https://kazee-design-system-023417.gitlab.io)\n- [Installation guide](https://gitlab.com/kazee.indonesia/kazee-design-system/-/blob/main/docs/installation.md)\n- [Consumer lint guide](https://gitlab.com/kazee.indonesia/kazee-design-system/-/blob/main/docs/consumer-lint.md)\n\nThe source repository may remain private; published npm packages and Storybook are public.\n`;
+}

package/templates/AGENTS.md

@@ -5,7 +5,7 @@ Apply these rules to UI work in this application alongside its existing project
 ## Check the installed contract first
 
 - Read this application's `package.json` and lockfile before changing UI. Use its installed package version as the API contract.
-- Use the installed version's public catalog. Framework/styles 0.5.3 include the Toast keyboard guard; tokens/lint are 0.4.2. MCP 0.1.6 retains verified 0.5.1, 0.5.2 and 0.5.3 catalogs; confirm that exact MCP patch is published before pinning it. Older MCP 0.1.4 labels 0.5.1 as a workspace candidate. Use installed public types if the matching verified catalog is unavailable. Do not assume a component exists in an older version.
+- Use the installed version's public catalog. Framework/styles 0.5.4 include the Toast keyboard guard and shared subtle borders; tokens are 0.4.3 and lint is 0.4.2. MCP 0.1.7 retains verified 0.5.1, 0.5.2, 0.5.3 and 0.5.4 catalogs; confirm that exact MCP patch is published before pinning it. Older MCP 0.1.4 labels 0.5.1 as a workspace candidate. Use installed public types if the matching verified catalog is unavailable. Do not assume a component exists in an older version.
 - When Kazee MCP is connected, read `get_catalog_versions`, then `list_components`, `get_component_docs`, and `get_component_examples` using this framework and exact installed version. Otherwise inspect the installed package's public types when uncertain. A prop accepted by React Aria, Reka UI, or another UI library is not automatically supported by Kazee components.
 - Start file discovery in application source, manifests, and the installed Kazee package's public entry points/types. Do not recursively list all of `node_modules` or investigate React Aria/Reka UI internals for routine component usage.
 - Investigate dependency internals only when a concrete type, build, or runtime failure remains unexplained by the public contract. Identify that failure and the relevant file before expanding the search. When the requested behavior, build, and typecheck pass, report the result and any unrun checks instead of continuing speculative API research.

package/templates/consumer-lint.md

@@ -1,6 +1,6 @@
 # Consumer lint rules
 
-[`@kazee-ds/eslint-config`](../packages/eslint-config) provides a reusable ESLint flat configuration. Published version `0.4.2` implements public-import boundaries and selected component API checks, including Input and extended Button variants. Current React/Vue/styles are `0.5.3`; tokens remain `0.4.2`. See the [version matrix](versions.md). It is an ESM package for ESLint 10 and Node 22.16 or later, with TypeScript declarations and no runtime dependencies. Adding `AGENTS.md` alone does not enable these checks.
+[`@kazee-ds/eslint-config`](../packages/eslint-config) provides a reusable ESLint flat configuration. Published version `0.4.2` implements public-import boundaries and selected component API checks, including Input and extended Button variants. Current React/Vue/styles are `0.5.4`; tokens are `0.4.3`. See the [version matrix](versions.md). It is an ESM package for ESLint 10 and Node 22.16 or later, with TypeScript declarations and no runtime dependencies. Adding `AGENTS.md` alone does not enable these checks.
 
 ## Rules