@advantacode/brander 0.2.0 → 0.2.1

package/README.md

@@ -22,7 +22,7 @@ npx --package @advantacode/brander advantacode-brander setup --out src/brander -
 This creates `brand.config.ts`, adds a `brand:generate` script, patches your stylesheet imports, and prepares the token output folder.
 
 During setup, Brander creates `brand.css` next to your main stylesheet, writes token/theme imports there, and adds a single `@import './brand.css';` to your main stylesheet.
-The generated `brand:generate` script uses `advantacode-brander generate` and includes any setup generation flags (`--out`, `--format`, `--theme`, `--prefix`) so repeat runs keep writing to the same target.
+The generated `brand:generate` script preserves the setup generation flags you used, including `--out` and `--style`, so repeat runs keep writing to the same target and refresh the stylesheet wiring when needed.
 
 AdvantaCode Brander generates design tokens and framework adapters from a single brand configuration file. It allows applications, design systems, and design tools to share a consistent source of truth for colors and semantic tokens.
 
@@ -87,6 +87,7 @@ Supported flags:
 * `--format <list>` limits output to specific formats: `all`, `css`, `json`, `typescript` or `ts`, `scss`, `tailwind`, `bootstrap`, `figma`
 * `--theme <value>` limits theme CSS output to `light`, `dark`, or `both`
 * `--prefix <value>` applies a CSS variable prefix like `ac`, producing variables such as `--ac-primary`
+* `--style <path>` refreshes `brand.css` and the main stylesheet import during normal generation so package scripts can keep setup paths aligned
 * `--version`, `-v` prints the installed package version
 * `--help`, `-h` prints the CLI help text
 
@@ -280,6 +281,18 @@ text-danger
 border-secondary
 ```
 
+CommonJS Tailwind config:
+
+```js
+const brandPreset = require("./src/assets/brander/adapters/tailwind.preset");
+
+module.exports = {
+  presets: [brandPreset]
+};
+```
+
+This step should stay documented rather than auto-patched for now. Unlike stylesheet imports, Tailwind config shape varies across projects between CJS, ESM, TS, Vite plugins, and newer Tailwind entrypoints, so automatic mutation is riskier and easier to get wrong.
+
 ## Bootstrap / SCSS Frameworks
 
 Generated file:

package/dist/index.js

@@ -1,6 +1,7 @@
 import fs from 'fs';
+import path from 'path';
 import { generateTokens, supportedFormats } from './generate-tokens.js';
-import { setupProject } from './setup.js';
+import { setupProject, syncStyleImports } from './setup.js';
 export async function runCli(args) {
     try {
         if (args.includes('--version') || args.includes('-v')) {
@@ -14,7 +15,7 @@ export async function runCli(args) {
             return 0;
         }
         if (command === 'generate') {
-            await generateTokens(parseGenerateArgs(commandArgs));
+            await runGenerateCommand(parseGenerateArgs(commandArgs));
             return 0;
         }
         await setupProject(parseSetupArgs(command, commandArgs));
@@ -44,6 +45,12 @@ function resolveCommand(args) {
     }
     throw new Error(`Unknown command "${firstArg}". Use --help to see supported commands.`);
 }
+async function runGenerateCommand(options) {
+    await generateTokens(options);
+    if (options.stylePath) {
+        syncStyleImports(options.stylePath, options.outputDir ?? path.join('dist', 'brander'));
+    }
+}
 function parseGenerateArgs(args) {
     const options = {};
     for (let index = 0; index < args.length; index += 1) {
@@ -74,6 +81,11 @@ function parseGenerateArgs(args) {
             index += 1;
             continue;
         }
+        if (arg === "--style") {
+            options.stylePath = getNextArgValue(arg, args, index);
+            index += 1;
+            continue;
+        }
         if (arg.startsWith("-")) {
             throw new Error(`Unknown option "${arg}". Use --help to see supported flags.`);
         }
@@ -186,10 +198,12 @@ Options:
   --format <list>         Comma-separated formats: all, css, json, typescript|ts, scss, tailwind, bootstrap, figma
   --theme <value>         Theme CSS output: light, dark, or both (default: both)
   --prefix <value>        CSS variable prefix. Use "" or omit for no prefix
+  --style <path>          Main stylesheet file to patch with a brand.css import
 
 Examples:
   advantacode-brander
   advantacode-brander --out src/tokens
+  advantacode-brander --out src/brander --style src/style.css
   advantacode-brander setup --out src/brander --style src/style.css
   advantacode-brander init --out resources/brander --skip-imports
 `;

package/dist/setup.js

@@ -43,6 +43,9 @@ export async function setupProject(options) {
         console.log(`  - ${note}`);
     }
 }
+export function syncStyleImports(stylePath, outputDir) {
+    return ensureStyleImports(stylePath, outputDir);
+}
 function ensureBrandConfig() {
     const configPath = path.resolve(process.cwd(), "brand.config.js");
     if (fs.existsSync(configPath)) {
@@ -149,7 +152,7 @@ function buildImportLine(stylePath, targetPath) {
     return `@import '${normalizedImportPath}';`;
 }
 function buildGenerateCommand(options) {
-    const commandParts = ["advantacode-brander", "generate"];
+    const commandParts = ["advantacode-brander"];
     const outputDir = options.outputDir ?? defaultSetupOutputDir;
     commandParts.push("--out", outputDir);
     if (options.formats && options.formats.length > 0) {
@@ -161,6 +164,9 @@ function buildGenerateCommand(options) {
     if (options.prefix) {
         commandParts.push("--prefix", options.prefix);
     }
+    if (options.stylePath) {
+        commandParts.push("--style", options.stylePath);
+    }
     return commandParts.join(" ");
 }
 function getDefaultBrandConfigTemplate() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@advantacode/brander",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "AdvantaCode Design System Brand Generator",
   "type": "module",
   "files": [