@seyuna/postcss 1.0.0-canary.29 → 1.0.0-canary.30

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+# [1.0.0-canary.30](https://github.com/seyuna-corp/seyuna-postcss/compare/v1.0.0-canary.29...v1.0.0-canary.30) (2026-01-21)
+
+
+### Bug Fixes
+
+* remove strict mode usage in errors and cleanup tests ([cdbfa50](https://github.com/seyuna-corp/seyuna-postcss/commit/cdbfa50537c216bb8afc46b22e7391233eacb105))
+
+
+### Features
+
+* simplify plugin by removing configurable options and hardcoding modeAttribute ([f5033d6](https://github.com/seyuna-corp/seyuna-postcss/commit/f5033d6a32f3fd1c98a9c2759f6bfcbffcc9a2be))
+
 # [1.0.0-canary.29](https://github.com/seyuna-corp/seyuna-postcss/compare/v1.0.0-canary.28...v1.0.0-canary.29) (2026-01-21)
 
 

package/README.md

@@ -53,7 +53,7 @@ CSS shouldn't be bloated with repetitive color definitions and hardcoded values.
 }
 ```
 
-Your color palette lives in `seyuna.json`. Your stylesheets reference it by name. Change the primary color once, and it updates everywhere.
+Your color palette is defined directly in your CSS. Your stylesheets reference colors by name. Change a value once in `@config`, and it updates everywhere.
 
 ### 4. Seamless Color Functions
 
@@ -82,7 +82,7 @@ These functions compile to pure CSS using `calc()` and CSS custom properties. No
 ### Installation
 
 ```bash
-npm install @seyuna/postcss postcss --save-dev
+npm install @seyuna/postcss postcss-import postcss-advanced-variables postcss-preset-env --save-dev
 ```
 
 ### PostCSS Configuration
@@ -90,11 +90,20 @@ npm install @seyuna/postcss postcss --save-dev
 ```javascript
 // postcss.config.js
 import seyunaPostcss from "@seyuna/postcss";
+import postcssImport from "postcss-import";
+import postcssAdvancedVariables from "postcss-advanced-variables";
+import postcssPresetEnv from "postcss-preset-env";
 
 export default {
   plugins: [
-    seyunaPostcss({
-      modeAttribute: "data-mode",
+    seyunaPostcss(),
+    postcssImport,
+    postcssAdvancedVariables,
+    postcssPresetEnv({
+      stage: 3,
+      features: {
+        "nesting-rules": true,
+      },
     }),
   ],
 };
@@ -160,16 +169,22 @@ Standard colors define only a hue angle in the config and inherit theme lightnes
 
 ### Fixed Colors
 
-Fixed colors have explicit lightness, chroma, and hue values.
+Fixed colors have explicit lightness, chroma, and hue values. They can also be overridden per theme mode.
 
 ```css
 @config "seyuna" {
   --color-white: 1 0 0;
+  --color-brand: 0.5 0.2 100; /* Global value */
+  --light-color-brand: 1 0 100; /* Light mode override */
 }
 
 .logo {
   color: SeyunaFixedColor(white);
 }
+
+.highlight {
+  background: SeyunaFixedColor(brand);
+}
 ```
 
 ---
@@ -271,32 +286,22 @@ Generate utility classes by iterating over your color configuration:
 
 Within the `@config "seyuna"` block, you can use the following property prefixes:
 
-| Prefix      | Description                                                      | Example                       |
-| :---------- | :--------------------------------------------------------------- | :---------------------------- |
-| `--hue-*`   | Defines a hue angle for a standard color                         | `--hue-primary: 240;`         |
-| `--color-*` | Defines a fixed color (L C H)                                    | `--color-brand: 0.6 0.2 120;` |
-| `--light-*` | Configures the light theme (lightness, chroma, background, text) | `--light-lightness: 0.8;`     |
-| `--dark-*`  | Configures the dark theme                                        | `--dark-background: 0 0 0;`   |
+| Prefix            | Description                                                      | Example                             |
+| :---------------- | :--------------------------------------------------------------- | :---------------------------------- |
+| `--hue-*`         | Defines a hue angle for a standard color                         | `--hue-primary: 240;`               |
+| `--color-*`       | Defines a global fixed color (L C H)                             | `--color-brand: 0.6 0.2 120;`       |
+| `--light-color-*` | Overrides a fixed color for light mode                           | `--light-color-brand: 0.8 0.1 120;` |
+| `--light-*`       | Configures the light theme (lightness, chroma, background, text) | `--light-lightness: 0.8;`           |
+| `--dark-color-*`  | Overrides a fixed color for dark mode                            | `--dark-color-brand: 0.4 0.1 120;`  |
+| `--dark-*`        | Configures the dark theme                                        | `--dark-background: 0 0 0;`         |
 
 For colors and background/text, use a space-separated list of values: `lightness chroma hue`.
 
 ---
 
-## Plugin Options
-
-```javascript
-seyunaPostcss({
-  configPath: "seyuna.json", // Path to your config file
-  modeAttribute: "data-mode", // Attribute for theme switching
-  strict: false, // Throw errors for missing colors
-});
-```
-
----
-
 ## Accessing Config Values
 
-Use `SeyunaTheme()` to access any value from your configuration:
+Use `SeyunaTheme()` to access any value from your design tokens:
 
 ```css
 .container {

package/dist/config.d.ts

@@ -2,9 +2,13 @@ import { SeyunaConfig, PluginOptions } from "./types.js";
 export type { PluginOptions, PluginContext, FunctionMap } from "./types.js";
 export declare function loadConfig(options?: PluginOptions): {
     config: SeyunaConfig;
-    options: Required<PluginOptions>;
+    options: Required<PluginOptions> & {
+        modeAttribute: string;
+    };
 };
 export declare function loadConfigAsync(options?: PluginOptions): Promise<{
     config: SeyunaConfig;
-    options: Required<PluginOptions>;
+    options: Required<PluginOptions> & {
+        modeAttribute: string;
+    };
 }>;

package/dist/config.js

@@ -1,14 +1,14 @@
 const DEFAULT_OPTIONS = {
-    configPath: "seyuna.json",
-    modeAttribute: "data-mode",
-    strict: false,
     config: undefined,
     functions: undefined,
 };
 export function loadConfig(options = {}) {
     const mergedOptions = { ...DEFAULT_OPTIONS, ...options };
     if (mergedOptions.config) {
-        return { config: mergedOptions.config, options: mergedOptions };
+        return {
+            config: mergedOptions.config,
+            options: { ...mergedOptions, modeAttribute: "data-mode" },
+        };
     }
     // Return base empty config - we'll populate it from CSS
     return {
@@ -34,7 +34,7 @@ export function loadConfig(options = {}) {
                 },
             },
         },
-        options: mergedOptions,
+        options: { ...mergedOptions, modeAttribute: "data-mode" },
     };
 }
 export async function loadConfigAsync(options = {}) {

package/dist/errors.d.ts

@@ -1,4 +1,4 @@
-import { PluginContext } from './types.js';
+import { PluginContext } from "./types.js";
 export declare function reportError(message: string, node: any, context: PluginContext, options?: {
     word?: string;
     index?: number;

package/dist/errors.js

@@ -1,12 +1,7 @@
 export function reportError(message, node, context, options = {}) {
     const { options: pluginOptions } = context;
     const formattedMessage = `[Seyuna PostCSS] ${message}`;
-    if (pluginOptions.strict) {
-        throw node.error(formattedMessage, options);
-    }
-    else {
-        reportWarning(formattedMessage, node, context);
-    }
+    reportWarning(formattedMessage, node, context);
 }
 export function reportWarning(message, node, context) {
     if (context?.result) {

package/dist/types.d.ts

@@ -44,15 +44,14 @@ export interface SeyunaConfig {
 }
 export type FunctionMap = Record<string, (context: PluginContext, ...args: string[]) => string>;
 export interface PluginOptions {
-    configPath?: string;
-    modeAttribute?: string;
-    strict?: boolean;
     config?: SeyunaConfig;
     functions?: FunctionMap;
 }
 export interface PluginContext {
     config: SeyunaConfig;
-    options: Required<PluginOptions>;
+    options: Required<PluginOptions> & {
+        modeAttribute: string;
+    };
     functions: FunctionMap;
     result?: any;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seyuna/postcss",
-  "version": "1.0.0-canary.29",
+  "version": "1.0.0-canary.30",
   "description": "Seyuna UI's postcss plugin",
   "type": "module",
   "main": "dist/index.js",

package/src/config.ts

@@ -11,21 +11,21 @@ import {
 export type { PluginOptions, PluginContext, FunctionMap } from "./types.js";
 
 const DEFAULT_OPTIONS: Required<PluginOptions> = {
-  configPath: "seyuna.json",
-  modeAttribute: "data-mode",
-  strict: false,
   config: undefined as any,
   functions: undefined as any,
 };
 
 export function loadConfig(options: PluginOptions = {}): {
   config: SeyunaConfig;
-  options: Required<PluginOptions>;
+  options: Required<PluginOptions> & { modeAttribute: string };
 } {
   const mergedOptions = { ...DEFAULT_OPTIONS, ...options };
 
   if (mergedOptions.config) {
-    return { config: mergedOptions.config, options: mergedOptions };
+    return {
+      config: mergedOptions.config,
+      options: { ...mergedOptions, modeAttribute: "data-mode" },
+    };
   }
 
   // Return base empty config - we'll populate it from CSS
@@ -52,12 +52,13 @@ export function loadConfig(options: PluginOptions = {}): {
         },
       },
     } as any,
-    options: mergedOptions,
+    options: { ...mergedOptions, modeAttribute: "data-mode" },
   };
 }
 
-export async function loadConfigAsync(
-  options: PluginOptions = {},
-): Promise<{ config: SeyunaConfig; options: Required<PluginOptions> }> {
+export async function loadConfigAsync(options: PluginOptions = {}): Promise<{
+  config: SeyunaConfig;
+  options: Required<PluginOptions> & { modeAttribute: string };
+}> {
   return loadConfig(options);
 }

package/src/errors.ts

@@ -1,23 +1,23 @@
 // import type { Node } from 'postcss';
-import { PluginContext } from './types.js';
+import { PluginContext } from "./types.js";
 
 export function reportError(
   message: string,
   node: any,
   context: PluginContext,
-  options: { word?: string; index?: number } = {}
+  options: { word?: string; index?: number } = {},
 ) {
   const { options: pluginOptions } = context;
   const formattedMessage = `[Seyuna PostCSS] ${message}`;
 
-  if (pluginOptions.strict) {
-    throw node.error(formattedMessage, options);
-  } else {
-    reportWarning(formattedMessage, node, context);
-  }
+  reportWarning(formattedMessage, node, context);
 }
 
-export function reportWarning(message: string, node: any, context?: PluginContext) {
+export function reportWarning(
+  message: string,
+  node: any,
+  context?: PluginContext,
+) {
   if (context?.result) {
     node.warn(context.result, `[Seyuna PostCSS] ${message}`);
   } else {

package/src/types.ts

@@ -53,19 +53,19 @@ export interface SeyunaConfig {
 
 // Shared types to avoid circular dependencies between config.ts and parser.ts
 
-export type FunctionMap = Record<string, (context: PluginContext, ...args: string[]) => string>;
+export type FunctionMap = Record<
+  string,
+  (context: PluginContext, ...args: string[]) => string
+>;
 
 export interface PluginOptions {
-  configPath?: string;
-  modeAttribute?: string;
-  strict?: boolean;
   config?: SeyunaConfig;
   functions?: FunctionMap;
 }
 
 export interface PluginContext {
   config: SeyunaConfig;
-  options: Required<PluginOptions>;
+  options: Required<PluginOptions> & { modeAttribute: string };
   functions: FunctionMap;
   result?: any; // PostCSS Result
-}
+}

package/tests/plugin.test.ts

@@ -132,27 +132,6 @@ describe("Seyuna PostCSS Plugin", () => {
     expect(result.css).toContain(output);
   });
 
-  it("throws error for unknown standard color in strict mode", async () => {
-    const input = ".test { color: SeyunaStandardColor(unknown); }";
-    await expect(
-      run(input, { config: mockConfig, strict: true }),
-    ).rejects.toThrow(/Standard color 'unknown' not found/);
-  });
-
-  it("throws error for unknown fixed color in strict mode", async () => {
-    const input = ".test { color: SeyunaFixedColor(unknown); }";
-    await expect(
-      run(input, { config: mockConfig, strict: true }),
-    ).rejects.toThrow(/Fixed color 'unknown' not found/);
-  });
-
-  it("throws error for unknown color in SeyunaAlpha() in strict mode", async () => {
-    const input = ".test { color: SeyunaAlpha(unknown, 0.5); }";
-    await expect(
-      run(input, { config: mockConfig, strict: true }),
-    ).rejects.toThrow(/Color 'unknown' not found in seyuna.json/);
-  });
-
   it('processes @import "seyuna"', async () => {
     const input = '@import "seyuna";';
     const result = await run(input, { config: mockConfig });