@kodaicoder/shadcn-svelte-daisyui-adapter 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -1,9 +1,15 @@
-# Changelog
-
-## 0.1.0
-
-First release. The CLI writes the header comment, the `@plugin "@kodaicoder/shadcn-svelte-daisyui-adapter";` line, the `daisyui-adapter.overrides.css` file and its import, and the 32 bindings per block; the plugin emits `--daisy-color-*` and `--daisy-radius` from `src/daisyui-theme.css` at build time.
-
-The first install is the only required run. A later `shadcn-svelte init` keeps the header comment and the override import, wipes the bindings, and the next `init` restores them.
-
-A change to the mapping table or to the shape the plugin emits is a minor bump, and it requires a re-run. The header comment names the version that wrote the stylesheet, so a project can tell which one it holds.
+# Changelog
+
+## 0.2.0
+
+The CLI no longer creates `daisyui-adapter.overrides.css` or writes its `@import` line. Overrides are opt-in: the user adds the file and the import, and the README's Overrides section describes how. An existing file and import are left untouched, so a project that installed 0.1.0 keeps both.
+
+A re-run applies the change to a 0.1.0 project, and the header comment updates to 0.2.0.
+
+## 0.1.0
+
+First release. The CLI writes the header comment, the `@plugin "@kodaicoder/shadcn-svelte-daisyui-adapter";` line, the `daisyui-adapter.overrides.css` file and its import, and the 32 bindings per block; the plugin emits `--daisy-color-*` and `--daisy-radius` from `src/daisyui-theme.css` at build time.
+
+The first install is the only required run. A later `shadcn-svelte init` keeps the header comment and the override import, wipes the bindings, and the next `init` restores them.
+
+A change to the mapping table or to the shape the plugin emits is a minor bump, and it requires a re-run. The header comment names the version that wrote the stylesheet, so a project can tell which one it holds.

package/README.md

@@ -1,103 +1,110 @@
-# @kodaicoder/shadcn-svelte-daisyui-adapter
-
-Generate a shadcn-svelte token set from a daisyUI v5 theme, at build time, with no daisyUI runtime dependency.
-
-The CLI reads your stylesheet and your `src/daisyui-theme.css`, then rewrites each `:root` and `.dark` block so every shadcn token reads a daisyUI value, with the value that was already in the file as the fallback. It also writes the `@plugin` line and the chart ramp. The plugin then emits `--daisy-color-*` and `--daisy-radius` from the theme while Tailwind builds, so a theme change takes one rebuild and no re-run.
-
-This package is not affiliated with shadcn-svelte or daisyUI. Both names are used only to say what it reads and what it writes.
-
-## Prerequisites
-
-- A SvelteKit project with `shadcn-svelte` set up through step 4 of its guide.
-- `components.json` at the project root, with `tailwind.css` pointing at the project's global stylesheet (`src/routes/layout.css` on SvelteKit 3, `src/app.css` on older projects). The CLI reads that path on every run and never hardcodes it.
-- That stylesheet imported by the root layout.
-- `src/daisyui-theme.css` holding one light and one dark block from the [daisyUI theme generator](https://daisyui.com/theme-generator/). Copy the blocks as they are, including the `@plugin "daisyui/theme"` prelude.
-
-## Usage
-
-```bash
-# 1. paste one light and one dark block from the theme generator
-#    into src/daisyui-theme.css
-
-# 2. shadcn-svelte, as its guide says
-pnpm dlx shadcn-svelte@latest init
-
-# 3. the adapter, at an exact version
-pnpm dlx @kodaicoder/shadcn-svelte-daisyui-adapter@0.1.0 init
-
-# 4. the gate
-pnpm build
-```
-
-The CLI adds the package as a devDependency at its own version, because the `@plugin` specifier resolves through `node_modules` at build time. Run it from the project root.
-
-## What the CLI prints
-
-```
-[daisyui-adapter] theme ok: light + dark
-[daisyui-adapter] wrote src/routes/layout.css
-[daisyui-adapter] 32 light, 32 dark
-[daisyui-adapter] created src/routes/daisyui-adapter.overrides.css
-[daisyui-adapter] installed @kodaicoder/shadcn-svelte-daisyui-adapter@0.1.0
-```
-
-The declaration count comes back from the file it wrote, so a stylesheet missing a row the adapter expects shows a number below 32. A second run prints `already installed` instead of installing again. A run on an older stylesheet prints `upgrading 0.0.9 -> 0.1.0` before the rest.
-
-A missing theme file is a warning, not a failure. The CLI prints `E1`, writes the bindings with your own values as fallbacks, and the build renders the project's palette. A malformed theme file exits non-zero with `E2` or `E3`, because a wrong pair would render wrong colours silently.
-
-## The header comment
-
-The first line of the stylesheet is the version marker:
-
-```
-/* @kodaicoder/shadcn-svelte-daisyui-adapter 0.1.0 | re-run `pnpm dlx @kodaicoder/shadcn-svelte-daisyui-adapter@0.1.0 init` after `shadcn-svelte init` */
-```
-
-`shadcn-svelte init` keeps this line and the override import, wipes the bindings, and the next adapter run restores them. Re-run when:
-
-- `shadcn-svelte init` or a large `add` changed the stylesheet;
-- you moved to a newer CLI and want the header to name it;
-- the changelog says the mapping table or the emitted shape changed.
-
-The CLI refuses to run when the header names a newer version than the CLI. It prints `E4`, exits non-zero and writes nothing, because an older CLI would undo bindings a newer one wrote. Run the version the header names, or upgrade the CLI.
-
-## The override file
-
-The CLI creates `daisyui-adapter.overrides.css` beside the stylesheet, empty, plus its `@import` line. It never writes that file again, so a user edit survives every later run.
-
-The import comes before the generated blocks, so a plain `:root` there loses on source order. Raise the specificity and keep the light block out of dark mode:
-
-```css
-html:not(.dark) {
-	--daisy-derived-chart-1: oklch(0.62 0.08 250);
-}
-
-html.dark {
-	--daisy-derived-chart-1: oklch(0.72 0.08 250);
-}
-```
-
-Both selectors beat the generated `:root` and `.dark`, and the light one does not leak into dark. Write the pair when you need both schemes.
-
-## Version policy
-
-The header records one exact version, and that number is what a project holds. A patch release fixes the CLI or the parser without moving a key or changing a shape, and does not need a re-run. A change to the mapping table, to a token's shape or to what the plugin emits is a minor bump, and it requires a re-run. The changelog names each one.
-
-## Checking the result
-
-`pnpm build` is the gate. The plugin reads `src/daisyui-theme.css` while Tailwind builds, so a malformed theme block fails there. With the theme removed, the build still passes and the page renders the pre-adapter palette.
-
-## Testing a tarball before publish
-
-`pnpm pack` writes `kodaicoder-shadcn-svelte-daisyui-adapter-0.1.0.tgz`. Set `DAISYUI_ADAPTER_INSTALL_SPEC` to that file and the CLI installs it instead of the registry copy. Pack from the package directory, then run the CLI from the app's root:
-
-```bash
-# in packages/daisyui-adapter, writing into the app's root
-pnpm pack --pack-destination <app>
-
-# in the app's root
-DAISYUI_ADAPTER_INSTALL_SPEC=./kodaicoder-shadcn-svelte-daisyui-adapter-0.1.0.tgz \
-  node <repo>/packages/daisyui-adapter/cli/init.mjs
-```
-
-The CLI prints `installed ./kodaicoder-shadcn-svelte-daisyui-adapter-0.1.0.tgz`. Without the variable it installs `@kodaicoder/shadcn-svelte-daisyui-adapter@0.1.0` from the registry.
+# @kodaicoder/shadcn-svelte-daisyui-adapter
+
+Generate a shadcn-svelte token set from a daisyUI v5 theme, at build time, with no daisyUI runtime dependency.
+
+The CLI reads your stylesheet and your `src/daisyui-theme.css`, then rewrites each `:root` and `.dark` block so every shadcn token reads a daisyUI value, with the value that was already in the file as the fallback. It also writes the `@plugin` line and the chart ramp. The plugin then emits `--daisy-color-*` and `--daisy-radius` from the theme while Tailwind builds, so a theme change takes one rebuild and no re-run.
+
+This package is not affiliated with shadcn-svelte or daisyUI. Both names are used only to say what it reads and what it writes.
+
+## Prerequisites
+
+- A SvelteKit project with `shadcn-svelte` set up through step 4 of its guide.
+- `components.json` at the project root, with `tailwind.css` pointing at the project's global stylesheet (`src/routes/layout.css` on SvelteKit 3, `src/app.css` on older projects). The CLI reads that path on every run and never hardcodes it.
+- That stylesheet imported by the root layout.
+- `src/daisyui-theme.css` holding one light and one dark block from the [daisyUI theme generator](https://daisyui.com/theme-generator/). Copy the blocks as they are, including the `@plugin "daisyui/theme"` prelude.
+
+## Usage
+
+```bash
+# 1. paste one light and one dark block from the theme generator
+#    into src/daisyui-theme.css
+
+# 2. shadcn-svelte, as its guide says
+pnpm dlx shadcn-svelte@latest init
+
+# 3. the adapter, at an exact version
+pnpm dlx @kodaicoder/shadcn-svelte-daisyui-adapter@0.2.0 init
+
+# 4. the gate
+pnpm build
+```
+
+The CLI adds the package as a devDependency at its own version, because the `@plugin` specifier resolves through `node_modules` at build time. Run it from the project root.
+
+## What the CLI prints
+
+```
+[daisyui-adapter] theme ok: light + dark
+[daisyui-adapter] wrote src/routes/layout.css
+[daisyui-adapter] 32 light, 32 dark
+[daisyui-adapter] installed @kodaicoder/shadcn-svelte-daisyui-adapter@0.2.0
+```
+
+The declaration count comes back from the file it wrote, so a stylesheet missing a row the adapter expects shows a number below 32. A second run prints `already installed` instead of installing again. A run on a stylesheet from 0.1.0 prints `upgrading 0.1.0 -> 0.2.0` before the rest.
+
+A missing theme file is a warning, not a failure. The CLI prints `E1`, writes the bindings with your own values as fallbacks, and the build renders the project's palette. A malformed theme file exits non-zero with `E2` or `E3`, because a wrong pair would render wrong colours silently.
+
+## The header comment
+
+The first line of the stylesheet is the version marker:
+
+```
+/* @kodaicoder/shadcn-svelte-daisyui-adapter 0.2.0 | re-run `pnpm dlx @kodaicoder/shadcn-svelte-daisyui-adapter@0.2.0 init` after `shadcn-svelte init` */
+```
+
+`shadcn-svelte init` keeps the header comment, wipes the bindings, and the next adapter run restores them. If the project has an override import, that import is kept too, but the CLI does not create it. Re-run when:
+
+- `shadcn-svelte init` or a large `add` changed the stylesheet;
+- you moved to a newer CLI and want the header to name it;
+- the changelog says the mapping table or the emitted shape changed.
+
+The CLI refuses to run when the header names a newer version than the CLI. It prints `E4`, exits non-zero and writes nothing, because an older CLI would undo bindings a newer one wrote. Run the version the header names, or upgrade the CLI.
+
+## Overrides (optional)
+
+The CLI does not create `daisyui-adapter.overrides.css` and does not write its import. Overrides are opt-in: you add both yourself.
+
+To use overrides, create `daisyui-adapter.overrides.css` beside the global stylesheet, then add this line after the other `@import` lines and before the generated `:root` and `.dark` blocks:
+
+```css
+@import "./daisyui-adapter.overrides.css";
+```
+
+The CLI never writes or deletes the file. If the project installed 0.1.0, the file and the import already exist. Keep them if you use them, or delete both if you do not.
+
+The import comes before the generated blocks, so a plain `:root` there loses on source order. Raise the specificity and keep the light block out of dark mode. Use `html:not(.dark)` for light and `html.dark` for dark:
+
+```css
+html:not(.dark) {
+	--daisy-derived-chart-1: oklch(0.62 0.08 250);
+}
+
+html.dark {
+	--daisy-derived-chart-1: oklch(0.72 0.08 250);
+}
+```
+
+Both selectors beat the generated `:root` and `.dark`, and the light one does not leak into dark. Write the pair when you need both schemes.
+
+## Version policy
+
+The header records one exact version, and that number is what a project holds. A patch release fixes the CLI or the parser without moving a key or changing a shape, and does not need a re-run. A change to the mapping table, to a token's shape or to what the plugin emits is a minor bump, and it requires a re-run. The changelog names each one.
+
+## Checking the result
+
+`pnpm build` is the gate. The plugin reads `src/daisyui-theme.css` while Tailwind builds, so a malformed theme block fails there. With the theme removed, the build still passes and the page renders the pre-adapter palette.
+
+## Testing a tarball before publish
+
+`pnpm pack` writes `kodaicoder-shadcn-svelte-daisyui-adapter-0.2.0.tgz`. Set `DAISYUI_ADAPTER_INSTALL_SPEC` to that file and the CLI installs it instead of the registry copy. Pack from the package directory, then run the CLI from the app's root:
+
+```bash
+# in packages/daisyui-adapter, writing into the app's root
+pnpm pack --pack-destination <app>
+
+# in the app's root
+DAISYUI_ADAPTER_INSTALL_SPEC=./kodaicoder-shadcn-svelte-daisyui-adapter-0.2.0.tgz \
+  node <repo>/packages/daisyui-adapter/cli/init.mjs
+```
+
+The CLI prints `installed ./kodaicoder-shadcn-svelte-daisyui-adapter-0.2.0.tgz`. Without the variable it installs `@kodaicoder/shadcn-svelte-daisyui-adapter@0.2.0` from the registry.

package/cli/init.mjs

@@ -1,7 +1,8 @@
 #!/usr/bin/env node
 // The adapter CLI. It reads components.json and the stylesheet, validates the theme, then writes the
-// header comment, the plugin line, the override import, the empty override file, the bindings for
-// both blocks, and the five chart values. Re-running it is byte-identical.
+// header comment, the plugin line, the bindings for both blocks, and the five chart values. Re-running
+// it is byte-identical. The override file and its import are the project's to add; this CLI never
+// creates, deletes or rewrites either one.
 //
 // It never writes a raw `--color-*` name (ticket 14: that forms a cycle with `@theme inline`, and
 // the fallback is then silently ignored), and it writes the chart ramp itself rather than leaving it
@@ -13,7 +14,7 @@
 // that ran an older CLI must end up with exactly one line naming its version.
 import { execSync } from 'node:child_process';
 import { existsSync, readFileSync, writeFileSync } from 'node:fs';
-import { dirname, relative, resolve } from 'node:path';
+import { resolve } from 'node:path';
 
 import { BINDING_KEYS, SINGLE, mixValue } from '../dist/map.mjs';
 import { chartTokens, solveScheme } from '../dist/ramp.mjs';
@@ -26,7 +27,6 @@ const BIN = Object.keys(manifest.bin)[0];
 const HEADER = `/* ${PKG} ${VERSION} | re-run \`pnpm dlx ${PKG}@${VERSION} init\` after \`shadcn-svelte init\` */`;
 const HEADER_PATTERN = /^\/\* (\S+) (\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?) \| re-run [^\n]*\*\/\r?\n?/;
 const OVERRIDE = 'daisyui-adapter.overrides.css';
-const OVERRIDE_IMPORT = `@import "./${OVERRIDE}";`;
 const BORDER_ENTRY = '--default-border-width: var(--daisy-border, 1px);';
 const PLUGIN = `@plugin "${PKG}";`;
 const PNPM = process.platform === 'win32' ? 'pnpm.cmd' : 'pnpm';
@@ -110,8 +110,8 @@ const warnBareRamp = (key) => {
 	rampWarned = true;
 	console.warn(
 		`[daisyui-adapter] --${key} holds a ramp written by an older CLI with no fallback. Its original ` +
-			`value is gone; restore the stylesheet from version control or set --daisyui-derived-${key} ` +
-			`in ${OVERRIDE}.`
+			`value is gone; restore the stylesheet from version control, or set --daisyui-derived-${key} ` +
+			`in the optional ${OVERRIDE} file, which the README's Overrides section describes.`
 	);
 };
 
@@ -266,7 +266,6 @@ const main = () => {
 	);
 	if (!css) throw new Error(`[daisyui-adapter] ${where} has no :root block`);
 
-	css = insertAfterLastImport(css, OVERRIDE_IMPORT);
 	if (themes) {
 		css = insertAfterLastImport(css, PLUGIN);
 		css = insertThemeEntries(css);
@@ -275,10 +274,6 @@ const main = () => {
 
 	writeFileSync(cssPath, css);
 
-	const overridePath = resolve(dirname(cssPath), OVERRIDE);
-	const created = !existsSync(overridePath);
-	if (created) writeFileSync(overridePath, '');
-
 	// Read back what was written: a block the CLI matched but could not fill has to show a count
 	// below 32 rather than a number from the data it meant to write.
 	const written = readFileSync(cssPath, 'utf8');
@@ -291,10 +286,6 @@ const main = () => {
 	if (themes) console.log('[daisyui-adapter] theme ok: light + dark');
 	console.log(`[daisyui-adapter] wrote ${where}`);
 	console.log(`[daisyui-adapter] ${lightCount} light, ${darkCount} dark`);
-	const overrideRel = relative(process.cwd(), overridePath).replaceAll('\\', '/');
-	console.log(
-		`[daisyui-adapter] ${created ? `created ${overrideRel}` : `left ${overrideRel} untouched`}`
-	);
 
 	// The install is last, after the lines that describe what was written, so a failed install
 	// still tells the user the stylesheet is in place.

package/package.json

@@ -1,40 +1,40 @@
-{
-	"name": "@kodaicoder/shadcn-svelte-daisyui-adapter",
-	"version": "0.1.0",
-	"description": "Generate a shadcn-svelte token set from a daisyUI v5 theme, at build time, with no daisyUI runtime dependency.",
-	"license": "MIT",
-	"type": "module",
-	"bin": {
-		"daisyui-adapter": "cli/init.mjs"
-	},
-	"exports": {
-		".": {
-			"default": "./dist/index.mjs"
-		},
-		"./map": "./dist/map.mjs",
-		"./ramp": "./dist/ramp.mjs"
-	},
-	"files": [
-		"dist",
-		"cli",
-		"CHANGELOG.md"
-	],
-	"keywords": [
-		"daisyui",
-		"shadcn-svelte",
-		"sveltekit",
-		"tailwindcss",
-		"theme"
-	],
-	"repository": {
-		"type": "git",
-		"url": "git+https://github.com/kodaicoder/shadcn-svelte-daisyui-adapter.git",
-		"directory": "packages/daisyui-adapter"
-	},
-	"engines": {
-		"node": ">=20"
-	},
-	"publishConfig": {
-		"access": "public"
-	}
-}
+{
+	"name": "@kodaicoder/shadcn-svelte-daisyui-adapter",
+	"version": "0.2.0",
+	"description": "Generate a shadcn-svelte token set from a daisyUI v5 theme, at build time, with no daisyUI runtime dependency.",
+	"license": "MIT",
+	"type": "module",
+	"bin": {
+		"daisyui-adapter": "cli/init.mjs"
+	},
+	"exports": {
+		".": {
+			"default": "./dist/index.mjs"
+		},
+		"./map": "./dist/map.mjs",
+		"./ramp": "./dist/ramp.mjs"
+	},
+	"files": [
+		"dist",
+		"cli",
+		"CHANGELOG.md"
+	],
+	"keywords": [
+		"daisyui",
+		"shadcn-svelte",
+		"sveltekit",
+		"tailwindcss",
+		"theme"
+	],
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/kodaicoder/shadcn-svelte-daisyui-adapter.git",
+		"directory": "packages/daisyui-adapter"
+	},
+	"engines": {
+		"node": ">=20"
+	},
+	"publishConfig": {
+		"access": "public"
+	}
+}