next-style 2.0.0 → 2.0.2

package/dist/index.cjs

@@ -0,0 +1,31 @@
+"use strict";var U=Object.create;var x=Object.defineProperty;var V=Object.getOwnPropertyDescriptor;var X=Object.getOwnPropertyNames;var Y=Object.getPrototypeOf,q=Object.prototype.hasOwnProperty;var ee=(r,e)=>{for(var t in e)x(r,t,{get:e[t],enumerable:!0})},N=(r,e,t,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let s of X(e))!q.call(r,s)&&s!==t&&x(r,s,{get:()=>e[s],enumerable:!(n=V(e,s))||n.enumerable});return r};var g=(r,e,t)=>(t=r!=null?U(Y(r)):{},N(e||!r||!r.__esModule?x(t,"default",{value:r,enumerable:!0}):t,r)),te=r=>N(x({},"__esModule",{value:!0}),r);var ne={};ee(ne,{BREAKPOINTS:()=>S,StyleCollector:()=>m,camelToKebab:()=>P,createTransformer:()=>z,css:()=>G,deduplicateStyles:()=>T,generateClassHash:()=>h,global:()=>J,normalizeMediaQuery:()=>O,plugin:()=>k,postcssPlugin:()=>_,styleCollector:()=>u,validateCSSProperty:()=>Q});module.exports=te(ne);var F=g(require("fs"),1),I=g(require("os"),1),K=g(require("path"),1);function P(r){return r.replace(/[A-Z]/g,e=>`-${e.toLowerCase()}`)}function h(r){let e=typeof r=="string"?r:JSON.stringify(r),t=0;for(let n=0;n<e.length;n++){let s=e.charCodeAt(n);t=(t<<5)-t+s,t=t&t}return Math.abs(t).toString(36)}var S={"@sm":"@media (min-width: 640px)","@md":"@media (min-width: 768px)","@lg":"@media (min-width: 1024px)","@xl":"@media (min-width: 1280px)","@2xl":"@media (min-width: 1536px)"};function O(r){return S[r]??r}function Q(r,e){return typeof e=="string"||typeof e=="number"||typeof e=="object"&&!Array.isArray(e)}function T(r){let e=new Map,t=new Set;return r.forEach((n,s)=>{let o=JSON.stringify(n);t.has(o)||(t.add(o),e.set(s,n))}),e}var m=class{constructor(){this.styles=new Map}addStyle(e){let n=`ns-${h(e)}`;if(this.styles.has(n))return n;let s=this.compileStyle(e);return this.styles.set(n,s),n}addGlobalStyle(e,t){let n=`global:${e}`;if(this.styles.has(n))return;let s=this.buildDeclarations(t);s&&this.styles.set(n,{className:n,css:`${e} {
+${s}}`,mediaQueries:{},pseudoClasses:{},keyframes:"",supports:{},layers:{}})}compileStyle(e){let{mediaQueries:t,pseudoClasses:n,normalStyles:s,keyframes:o,supports:d,container:y,layer:C}=this.parseStyles(e),a=`ns-${h(e)}`,E=this.buildDeclarations(s),v=`.${a} {
+${E}}`,f={};Object.entries(t).forEach(([l,p])=>{let c=O(l),$=this.buildDeclarations(p,"    ");if(f[c]){let Z=f[c].split(`
+`).slice(2,-2).join(`
+`);f[c]=`${c} {
+  .${a} {
+${Z}
+${$}  }
+}`}else f[c]=`${c} {
+  .${a} {
+${$}  }
+}`}),Object.entries(y).forEach(([l,p])=>{let c=this.buildDeclarations(p,"    ");f[l]=`${l} {
+  .${a} {
+${c}  }
+}`});let w={};Object.entries(n).forEach(([l,p])=>{let c=this.buildDeclarations(p);w[l]=`.${a}${l} {
+${c}}`});let b="";Object.entries(o).forEach(([l,p])=>{b+=`@keyframes ${l} {
+`,Object.entries(p).forEach(([c,$])=>{let D=this.buildDeclarations($,"    ");b+=`  ${c} {
+${D}  }
+`}),b+=`}
+`});let A={};Object.entries(d).forEach(([l,p])=>{let c=this.buildDeclarations(p,"    ");A[l]=`@supports ${l} {
+  .${a} {
+${c}  }
+}`});let W={};return Object.entries(C).forEach(([l,p])=>{let c=this.buildDeclarations(p,"  ");W[l]=`@layer ${l} {
+${c}}`}),{className:a,css:v,mediaQueries:f,pseudoClasses:w,keyframes:b,supports:A,layers:W}}parseStyles(e){let t={},n={},s={},o={},d={},y={},C={};return Object.entries(e).forEach(([i,a])=>{if(i.startsWith("@keyframes "))o[i.slice(11)]=a;else if(i==="@keyframes"&&typeof a=="object")Object.assign(o,a);else if(i.startsWith("@supports")){let E=i.slice(0,9)==="@supports"?i.slice(9).trim():i;d[E]=a}else i.startsWith("@container")?y[i]=a:i.startsWith("@layer")?C[i.slice(7)||"default"]=a:i in S||i.startsWith("@media")?n[i]=a:i.startsWith(":")||i.startsWith("::")?s[i]=a:t[i]=a}),{normalStyles:t,mediaQueries:n,pseudoClasses:s,keyframes:o,supports:d,container:y,layer:C}}buildDeclarations(e,t="  "){let n="";return Object.entries(e).forEach(([s,o])=>{(typeof o=="string"||typeof o=="number")&&(n+=`${t}${P(s)}: ${o};
+`)}),n}getAllStyles(){let e="";return this.styles.forEach(t=>{t.keyframes&&(e+=`${t.keyframes}
+`),t.css&&(e+=`${t.css}
+`),Object.values(t.pseudoClasses).forEach(s=>{e+=`${s}
+`}),Object.values(t.layers).forEach(s=>{e+=`${s}
+`}),Object.values(t.supports).forEach(s=>{e+=`${s}
+`}),Object.entries(t.mediaQueries).sort(([s],[o])=>this.extractMinWidth(s)-this.extractMinWidth(o)).forEach(([,s])=>{e+=`${s}
+`})}),e}extractMinWidth(e){let t=e.match(/min-width:\s*(\d+)px/);return t?parseInt(t[1],10):0}flush(e){try{let t=e??K.default.join(I.default.tmpdir(),"next-style.css");F.default.writeFileSync(t,this.getAllStyles(),"utf-8")}catch(t){console.error("Failed to flush styles to cache file:",t)}}getStyleMap(){return new Map(this.styles)}};function z(){let r=new m;return{collector:r,transformCssCall(e){return r.addStyle(e)}}}var H=g(require("fs"),1),B=g(require("os"),1),L=g(require("path"),1),j=g(require("postcss"),1),se=/^next-style$/,re=L.default.join(B.default.tmpdir(),"next-style.css");function M(r={}){let e=r.cacheFile??re;return{postcssPlugin:"next-style",Once(n){let s="";try{s=H.default.readFileSync(e,"utf-8")}catch{}let o=!1;n.walkAtRules("import",d=>{let y=d.params.replace(/['"]/g,"").trim();se.test(y)&&(s.trim()?d.replaceWith(j.default.parse(s)):d.remove(),o=!0)}),!o&&s.trim()&&n.prepend(j.default.parse(s))}}}M.postcss=!0;var _=M,k=M;function G(r){let e=u.addStyle(r);return u.flush(),e}function J(r){Object.entries(r).forEach(([e,t])=>{u.addGlobalStyle(e,t)}),u.flush()}var u=new m;0&&(module.exports={BREAKPOINTS,StyleCollector,camelToKebab,createTransformer,css,deduplicateStyles,generateClassHash,global,normalizeMediaQuery,plugin,postcssPlugin,styleCollector,validateCSSProperty});

package/dist/index.d.cts

@@ -0,0 +1,259 @@
+export { plugin, default as postcssPlugin } from './postcss-plugin/index.cjs';
+import { Properties, Pseudos } from 'csstype';
+import 'postcss';
+
+/**
+ * The compiled representation of a single `css({})` call.
+ * Produced by `StyleCollector` and consumed by the PostCSS plugin.
+ */
+interface CompiledStyle {
+    /** Scoped class name, e.g. `"ns-1x2y3z"`. */
+    className: string;
+    /** Base CSS rule block for this class. */
+    css: string;
+    /** Map of normalized media query string → CSS rule block. */
+    mediaQueries: Record<string, string>;
+    /** Map of pseudo selector (e.g. `":hover"`) → CSS rule block. */
+    pseudoClasses: Record<string, string>;
+    /** Concatenated `@keyframes` blocks referenced by this style. */
+    keyframes: string;
+    /** Map of `@supports` condition → CSS rule block. */
+    supports: Record<string, string>;
+    /** Map of `@layer` name → CSS rule block. */
+    layers: Record<string, string>;
+}
+/**
+ * Collects, compiles, and deduplicates styles registered via `css()` and `global()`.
+ *
+ * A single shared instance is held by the runtime module. The PostCSS plugin
+ * calls `getAllStyles()` at build time to drain the collected CSS.
+ *
+ * @example
+ * const collector = new StyleCollector()
+ * const className = collector.addStyle({ color: 'red' }) // "ns-abc123"
+ * const css = collector.getAllStyles() // ".ns-abc123 { color: red; }"
+ */
+declare class StyleCollector {
+    private styles;
+    /**
+     * Compiles a style object and registers it in the collector.
+     * Returns the same class name for identical style objects (deduplication).
+     *
+     * @param styleObj - Raw style object from a `css({})` call.
+     * @returns Scoped class name string.
+     */
+    addStyle(styleObj: any): string;
+    /**
+     * Registers a global style rule (no scoped class).
+     * Subsequent calls with the same selector are ignored (idempotent).
+     *
+     * @param selector - CSS selector string, e.g. `"body"` or `"h1, h2"`.
+     * @param styleObj - Style properties to apply to the selector.
+     */
+    addGlobalStyle(selector: string, styleObj: any): void;
+    private compileStyle;
+    private parseStyles;
+    private buildDeclarations;
+    /**
+     * Serialises all collected styles into a single CSS string.
+     *
+     * Output order:
+     * 1. `@keyframes` blocks
+     * 2. Base class rules
+     * 3. Pseudo-class/element rules
+     * 4. `@layer` blocks
+     * 5. `@supports` blocks
+     * 6. Media queries (ascending `min-width`, mobile-first)
+     *
+     * @returns Full CSS string ready to be injected or written to a file.
+     */
+    getAllStyles(): string;
+    private extractMinWidth;
+    /**
+     * Writes all collected styles to a temp file so the PostCSS plugin
+     * (which runs in a separate process) can read them.
+     *
+     * Call this after all `css()` / `global()` calls have been evaluated,
+     * e.g. at the end of a build-time entry point.
+     *
+     * @param filePath - Destination file path. Defaults to `os.tmpdir()/next-style.css`.
+     */
+    flush(filePath?: string): void;
+    /**
+     * Returns a snapshot of the internal style map.
+     * Intended for inspection and testing — not for direct mutation.
+     */
+    getStyleMap(): Map<string, CompiledStyle>;
+}
+/**
+ * Creates an isolated `StyleCollector` paired with a transform helper.
+ *
+ * Primarily used by SWC/Babel transforms and test harnesses that need
+ * a fresh collector per file or per test, independent of the shared
+ * runtime instance.
+ *
+ * @example
+ * const { collector, transformCssCall } = createTransformer()
+ * const className = transformCssCall({ color: 'red' })
+ * const css = collector.getAllStyles()
+ */
+declare function createTransformer(): {
+    collector: StyleCollector;
+    /**
+     * Equivalent to calling `css()` against this transformer's isolated collector.
+     * @param styleObj - Raw style object.
+     * @returns Scoped class name string.
+     */
+    transformCssCall(styleObj: any): string;
+};
+
+/**
+ * CSS properties with full type safety and autocomplete via csstype.
+ * Accepts both string and number values (e.g. `fontSize: 16` or `fontSize: '16px'`).
+ */
+type CSSProperties = Properties<string | number>;
+/** @internal Mapped type for pseudo-classes/elements — avoids index signature limitation */
+type PseudoStyles = {
+    [P in Pseudos]?: CSSProperties;
+};
+/** @internal At-rule keys (@media, @container, @supports, @layer, @keyframes) */
+type AtRuleStyles = {
+    '@sm'?: CSSProperties;
+    '@md'?: CSSProperties;
+    '@lg'?: CSSProperties;
+    '@xl'?: CSSProperties;
+    '@2xl'?: CSSProperties;
+    [media: `@media ${string}`]: CSSProperties;
+    [container: `@container ${string}`]: CSSProperties;
+    [supports: `@supports ${string}`]: CSSProperties;
+    [layer: `@layer ${string}`]: CSSProperties;
+    [keyframes: `@keyframes ${string}`]: Record<string, CSSProperties>;
+};
+/**
+ * Style object passed to `css()` and `global()`.
+ *
+ * Supports:
+ * - All CSS properties (typed via csstype)
+ * - Responsive breakpoints: `'@sm'`, `'@md'`, `'@lg'`, `'@xl'`, `'@2xl'`
+ * - Arbitrary media queries: `'@media (min-width: 900px)'`
+ * - Pseudo-classes and pseudo-elements: `':hover'`, `'::before'`, etc.
+ * - Container queries: `'@container sidebar (min-width: 300px)'`
+ * - Feature queries: `'@supports (display: grid)'`
+ * - Keyframe animations: `'@keyframes fadeIn'`
+ * - Cascade layers: `'@layer utilities'`
+ *
+ * @example
+ * const style: CSSObject = {
+ *   fontSize: '16px',
+ *   '@md': { fontSize: '20px' },
+ *   ':hover': { color: 'blue' },
+ *   '@keyframes spin': { to: { transform: 'rotate(360deg)' } },
+ * }
+ */
+type CSSObject = CSSProperties & PseudoStyles & AtRuleStyles & {
+    [key: string]: any;
+};
+/**
+ * Converts a style object into a unique CSS class name.
+ *
+ * Styles are collected at build time by the PostCSS plugin and emitted as
+ * a single static CSS file — there is zero runtime overhead in production.
+ * Identical style objects always return the same class name (deduplication).
+ *
+ * @param styles - A `CSSObject` describing the styles for this element.
+ * @returns A stable class name string (e.g. `"ns-1x2y3z"`).
+ *
+ * @example
+ * const button = css({
+ *   padding: '8px 16px',
+ *   borderRadius: '6px',
+ *   backgroundColor: '#7F77DD',
+ *   ':hover': { backgroundColor: '#534AB7' },
+ *   '@md': { padding: '10px 20px' },
+ * })
+ *
+ * export function Button() {
+ *   return <button className={button}>Click me</button>
+ * }
+ */
+declare function css(styles: CSSObject): string;
+/**
+ * Registers global CSS styles applied directly to selectors (no scoped class).
+ *
+ * Useful for CSS resets, base typography, and third-party element overrides.
+ * Like `css()`, styles are extracted at build time — no runtime cost.
+ *
+ * @param styles - A record mapping CSS selectors to `CSSObject` style definitions.
+ *
+ * @example
+ * global({
+ *   '*': { boxSizing: 'border-box', margin: '0' },
+ *   'body': { fontFamily: 'Inter, sans-serif', lineHeight: '1.6' },
+ *   'h1, h2, h3': { fontWeight: 500 },
+ * })
+ */
+declare function global(styles: Record<string, CSSObject>): void;
+
+declare const collector: StyleCollector;
+
+/**
+ * Converts a camelCase CSS property name to kebab-case.
+ *
+ * @param str - camelCase string, e.g. `"backgroundColor"`.
+ * @returns kebab-case string, e.g. `"background-color"`.
+ *
+ * @example
+ * camelToKebab('fontSize')        // "font-size"
+ * camelToKebab('borderTopWidth')  // "border-top-width"
+ */
+declare function camelToKebab(str: string): string;
+/**
+ * Generates a short, stable hash string from a style object or string.
+ * Used to produce unique class name suffixes (e.g. `"ns-1x2y3z"`).
+ *
+ * @param styles - Style object or pre-serialised string.
+ * @returns Base-36 hash string.
+ */
+declare function generateClassHash(styles: any): string;
+/**
+ * Shorthand breakpoint aliases mapped to their full `@media` query strings.
+ *
+ * | Key    | Expands to                          |
+ * |--------|-------------------------------------|
+ * | `@sm`  | `@media (min-width: 640px)`  |
+ * | `@md`  | `@media (min-width: 768px)`  |
+ * | `@lg`  | `@media (min-width: 1024px)` |
+ * | `@xl`  | `@media (min-width: 1280px)` |
+ * | `@2xl` | `@media (min-width: 1536px)` |
+ */
+declare const BREAKPOINTS: Record<string, string>;
+/**
+ * Resolves a breakpoint shorthand to its full `@media` query string.
+ * Passes through unrecognised strings unchanged.
+ *
+ * @param query - Shorthand key (e.g. `"@md"`) or an arbitrary media query.
+ * @returns Full media query string (e.g. `"@media (min-width: 768px)"`).
+ *
+ * @example
+ * normalizeMediaQuery('@md')                        // "@media (min-width: 768px)"
+ * normalizeMediaQuery('@media (max-width: 600px)')  // "@media (max-width: 600px)"
+ */
+declare function normalizeMediaQuery(query: string): string;
+/**
+ * Returns `true` if the value is a valid CSS property value that can be
+ * serialised to a declaration (string, number, or nested object).
+ *
+ * @param _key - CSS property name (unused, reserved for future validation).
+ * @param value - Value to check.
+ */
+declare function validateCSSProperty(_key: string, value: any): boolean;
+/**
+ * Removes duplicate entries from a style map, keeping the first occurrence.
+ * Two entries are considered duplicates when their serialised values are identical.
+ *
+ * @param styles - Map of class name → style data.
+ * @returns New map with duplicates removed.
+ */
+declare function deduplicateStyles(styles: Map<string, any>): Map<string, any>;
+
+export { BREAKPOINTS, type CSSObject, type CSSProperties, type CompiledStyle, StyleCollector, camelToKebab, createTransformer, css, deduplicateStyles, generateClassHash, global, normalizeMediaQuery, collector as styleCollector, validateCSSProperty };

package/dist/index.d.ts

@@ -1,5 +1,259 @@
-export { type CompiledStyle, createTransformer, StyleCollector } from './compiler';
-export { default as postcssPlugin, plugin } from './postcss-plugin';
-export { type CSSObject, type CSSProperties, css, global, styleCollector } from './runtime';
-export { BREAKPOINTS, camelToKebab, deduplicateStyles, generateClassHash, normalizeMediaQuery, validateCSSProperty } from './utils';
-//# sourceMappingURL=index.d.ts.map
+export { plugin, default as postcssPlugin } from './postcss-plugin/index.js';
+import { Properties, Pseudos } from 'csstype';
+import 'postcss';
+
+/**
+ * The compiled representation of a single `css({})` call.
+ * Produced by `StyleCollector` and consumed by the PostCSS plugin.
+ */
+interface CompiledStyle {
+    /** Scoped class name, e.g. `"ns-1x2y3z"`. */
+    className: string;
+    /** Base CSS rule block for this class. */
+    css: string;
+    /** Map of normalized media query string → CSS rule block. */
+    mediaQueries: Record<string, string>;
+    /** Map of pseudo selector (e.g. `":hover"`) → CSS rule block. */
+    pseudoClasses: Record<string, string>;
+    /** Concatenated `@keyframes` blocks referenced by this style. */
+    keyframes: string;
+    /** Map of `@supports` condition → CSS rule block. */
+    supports: Record<string, string>;
+    /** Map of `@layer` name → CSS rule block. */
+    layers: Record<string, string>;
+}
+/**
+ * Collects, compiles, and deduplicates styles registered via `css()` and `global()`.
+ *
+ * A single shared instance is held by the runtime module. The PostCSS plugin
+ * calls `getAllStyles()` at build time to drain the collected CSS.
+ *
+ * @example
+ * const collector = new StyleCollector()
+ * const className = collector.addStyle({ color: 'red' }) // "ns-abc123"
+ * const css = collector.getAllStyles() // ".ns-abc123 { color: red; }"
+ */
+declare class StyleCollector {
+    private styles;
+    /**
+     * Compiles a style object and registers it in the collector.
+     * Returns the same class name for identical style objects (deduplication).
+     *
+     * @param styleObj - Raw style object from a `css({})` call.
+     * @returns Scoped class name string.
+     */
+    addStyle(styleObj: any): string;
+    /**
+     * Registers a global style rule (no scoped class).
+     * Subsequent calls with the same selector are ignored (idempotent).
+     *
+     * @param selector - CSS selector string, e.g. `"body"` or `"h1, h2"`.
+     * @param styleObj - Style properties to apply to the selector.
+     */
+    addGlobalStyle(selector: string, styleObj: any): void;
+    private compileStyle;
+    private parseStyles;
+    private buildDeclarations;
+    /**
+     * Serialises all collected styles into a single CSS string.
+     *
+     * Output order:
+     * 1. `@keyframes` blocks
+     * 2. Base class rules
+     * 3. Pseudo-class/element rules
+     * 4. `@layer` blocks
+     * 5. `@supports` blocks
+     * 6. Media queries (ascending `min-width`, mobile-first)
+     *
+     * @returns Full CSS string ready to be injected or written to a file.
+     */
+    getAllStyles(): string;
+    private extractMinWidth;
+    /**
+     * Writes all collected styles to a temp file so the PostCSS plugin
+     * (which runs in a separate process) can read them.
+     *
+     * Call this after all `css()` / `global()` calls have been evaluated,
+     * e.g. at the end of a build-time entry point.
+     *
+     * @param filePath - Destination file path. Defaults to `os.tmpdir()/next-style.css`.
+     */
+    flush(filePath?: string): void;
+    /**
+     * Returns a snapshot of the internal style map.
+     * Intended for inspection and testing — not for direct mutation.
+     */
+    getStyleMap(): Map<string, CompiledStyle>;
+}
+/**
+ * Creates an isolated `StyleCollector` paired with a transform helper.
+ *
+ * Primarily used by SWC/Babel transforms and test harnesses that need
+ * a fresh collector per file or per test, independent of the shared
+ * runtime instance.
+ *
+ * @example
+ * const { collector, transformCssCall } = createTransformer()
+ * const className = transformCssCall({ color: 'red' })
+ * const css = collector.getAllStyles()
+ */
+declare function createTransformer(): {
+    collector: StyleCollector;
+    /**
+     * Equivalent to calling `css()` against this transformer's isolated collector.
+     * @param styleObj - Raw style object.
+     * @returns Scoped class name string.
+     */
+    transformCssCall(styleObj: any): string;
+};
+
+/**
+ * CSS properties with full type safety and autocomplete via csstype.
+ * Accepts both string and number values (e.g. `fontSize: 16` or `fontSize: '16px'`).
+ */
+type CSSProperties = Properties<string | number>;
+/** @internal Mapped type for pseudo-classes/elements — avoids index signature limitation */
+type PseudoStyles = {
+    [P in Pseudos]?: CSSProperties;
+};
+/** @internal At-rule keys (@media, @container, @supports, @layer, @keyframes) */
+type AtRuleStyles = {
+    '@sm'?: CSSProperties;
+    '@md'?: CSSProperties;
+    '@lg'?: CSSProperties;
+    '@xl'?: CSSProperties;
+    '@2xl'?: CSSProperties;
+    [media: `@media ${string}`]: CSSProperties;
+    [container: `@container ${string}`]: CSSProperties;
+    [supports: `@supports ${string}`]: CSSProperties;
+    [layer: `@layer ${string}`]: CSSProperties;
+    [keyframes: `@keyframes ${string}`]: Record<string, CSSProperties>;
+};
+/**
+ * Style object passed to `css()` and `global()`.
+ *
+ * Supports:
+ * - All CSS properties (typed via csstype)
+ * - Responsive breakpoints: `'@sm'`, `'@md'`, `'@lg'`, `'@xl'`, `'@2xl'`
+ * - Arbitrary media queries: `'@media (min-width: 900px)'`
+ * - Pseudo-classes and pseudo-elements: `':hover'`, `'::before'`, etc.
+ * - Container queries: `'@container sidebar (min-width: 300px)'`
+ * - Feature queries: `'@supports (display: grid)'`
+ * - Keyframe animations: `'@keyframes fadeIn'`
+ * - Cascade layers: `'@layer utilities'`
+ *
+ * @example
+ * const style: CSSObject = {
+ *   fontSize: '16px',
+ *   '@md': { fontSize: '20px' },
+ *   ':hover': { color: 'blue' },
+ *   '@keyframes spin': { to: { transform: 'rotate(360deg)' } },
+ * }
+ */
+type CSSObject = CSSProperties & PseudoStyles & AtRuleStyles & {
+    [key: string]: any;
+};
+/**
+ * Converts a style object into a unique CSS class name.
+ *
+ * Styles are collected at build time by the PostCSS plugin and emitted as
+ * a single static CSS file — there is zero runtime overhead in production.
+ * Identical style objects always return the same class name (deduplication).
+ *
+ * @param styles - A `CSSObject` describing the styles for this element.
+ * @returns A stable class name string (e.g. `"ns-1x2y3z"`).
+ *
+ * @example
+ * const button = css({
+ *   padding: '8px 16px',
+ *   borderRadius: '6px',
+ *   backgroundColor: '#7F77DD',
+ *   ':hover': { backgroundColor: '#534AB7' },
+ *   '@md': { padding: '10px 20px' },
+ * })
+ *
+ * export function Button() {
+ *   return <button className={button}>Click me</button>
+ * }
+ */
+declare function css(styles: CSSObject): string;
+/**
+ * Registers global CSS styles applied directly to selectors (no scoped class).
+ *
+ * Useful for CSS resets, base typography, and third-party element overrides.
+ * Like `css()`, styles are extracted at build time — no runtime cost.
+ *
+ * @param styles - A record mapping CSS selectors to `CSSObject` style definitions.
+ *
+ * @example
+ * global({
+ *   '*': { boxSizing: 'border-box', margin: '0' },
+ *   'body': { fontFamily: 'Inter, sans-serif', lineHeight: '1.6' },
+ *   'h1, h2, h3': { fontWeight: 500 },
+ * })
+ */
+declare function global(styles: Record<string, CSSObject>): void;
+
+declare const collector: StyleCollector;
+
+/**
+ * Converts a camelCase CSS property name to kebab-case.
+ *
+ * @param str - camelCase string, e.g. `"backgroundColor"`.
+ * @returns kebab-case string, e.g. `"background-color"`.
+ *
+ * @example
+ * camelToKebab('fontSize')        // "font-size"
+ * camelToKebab('borderTopWidth')  // "border-top-width"
+ */
+declare function camelToKebab(str: string): string;
+/**
+ * Generates a short, stable hash string from a style object or string.
+ * Used to produce unique class name suffixes (e.g. `"ns-1x2y3z"`).
+ *
+ * @param styles - Style object or pre-serialised string.
+ * @returns Base-36 hash string.
+ */
+declare function generateClassHash(styles: any): string;
+/**
+ * Shorthand breakpoint aliases mapped to their full `@media` query strings.
+ *
+ * | Key    | Expands to                          |
+ * |--------|-------------------------------------|
+ * | `@sm`  | `@media (min-width: 640px)`  |
+ * | `@md`  | `@media (min-width: 768px)`  |
+ * | `@lg`  | `@media (min-width: 1024px)` |
+ * | `@xl`  | `@media (min-width: 1280px)` |
+ * | `@2xl` | `@media (min-width: 1536px)` |
+ */
+declare const BREAKPOINTS: Record<string, string>;
+/**
+ * Resolves a breakpoint shorthand to its full `@media` query string.
+ * Passes through unrecognised strings unchanged.
+ *
+ * @param query - Shorthand key (e.g. `"@md"`) or an arbitrary media query.
+ * @returns Full media query string (e.g. `"@media (min-width: 768px)"`).
+ *
+ * @example
+ * normalizeMediaQuery('@md')                        // "@media (min-width: 768px)"
+ * normalizeMediaQuery('@media (max-width: 600px)')  // "@media (max-width: 600px)"
+ */
+declare function normalizeMediaQuery(query: string): string;
+/**
+ * Returns `true` if the value is a valid CSS property value that can be
+ * serialised to a declaration (string, number, or nested object).
+ *
+ * @param _key - CSS property name (unused, reserved for future validation).
+ * @param value - Value to check.
+ */
+declare function validateCSSProperty(_key: string, value: any): boolean;
+/**
+ * Removes duplicate entries from a style map, keeping the first occurrence.
+ * Two entries are considered duplicates when their serialised values are identical.
+ *
+ * @param styles - Map of class name → style data.
+ * @returns New map with duplicates removed.
+ */
+declare function deduplicateStyles(styles: Map<string, any>): Map<string, any>;
+
+export { BREAKPOINTS, type CSSObject, type CSSProperties, type CompiledStyle, StyleCollector, camelToKebab, createTransformer, css, deduplicateStyles, generateClassHash, global, normalizeMediaQuery, collector as styleCollector, validateCSSProperty };

package/dist/index.js

@@ -1,4 +1,31 @@
-export { createTransformer, StyleCollector } from './compiler';
-export { default as postcssPlugin, plugin } from './postcss-plugin';
-export { css, global, styleCollector } from './runtime';
-export { BREAKPOINTS, camelToKebab, deduplicateStyles, generateClassHash, normalizeMediaQuery, validateCSSProperty } from './utils';
+import F from"fs";import I from"os";import K from"path";function P(n){return n.replace(/[A-Z]/g,e=>`-${e.toLowerCase()}`)}function $(n){let e=typeof n=="string"?n:JSON.stringify(n),t=0;for(let r=0;r<e.length;r++){let s=e.charCodeAt(r);t=(t<<5)-t+s,t=t&t}return Math.abs(t).toString(36)}var x={"@sm":"@media (min-width: 640px)","@md":"@media (min-width: 768px)","@lg":"@media (min-width: 1024px)","@xl":"@media (min-width: 1280px)","@2xl":"@media (min-width: 1536px)"};function O(n){return x[n]??n}function Q(n,e){return typeof e=="string"||typeof e=="number"||typeof e=="object"&&!Array.isArray(e)}function T(n){let e=new Map,t=new Set;return n.forEach((r,s)=>{let o=JSON.stringify(r);t.has(o)||(t.add(o),e.set(s,r))}),e}var y=class{constructor(){this.styles=new Map}addStyle(e){let r=`ns-${$(e)}`;if(this.styles.has(r))return r;let s=this.compileStyle(e);return this.styles.set(r,s),r}addGlobalStyle(e,t){let r=`global:${e}`;if(this.styles.has(r))return;let s=this.buildDeclarations(t);s&&this.styles.set(r,{className:r,css:`${e} {
+${s}}`,mediaQueries:{},pseudoClasses:{},keyframes:"",supports:{},layers:{}})}compileStyle(e){let{mediaQueries:t,pseudoClasses:r,normalStyles:s,keyframes:o,supports:d,container:g,layer:u}=this.parseStyles(e),a=`ns-${$(e)}`,R=this.buildDeclarations(s),D=`.${a} {
+${R}}`,m={};Object.entries(t).forEach(([l,p])=>{let c=O(l),S=this.buildDeclarations(p,"    ");if(m[c]){let N=m[c].split(`
+`).slice(2,-2).join(`
+`);m[c]=`${c} {
+  .${a} {
+${N}
+${S}  }
+}`}else m[c]=`${c} {
+  .${a} {
+${S}  }
+}`}),Object.entries(g).forEach(([l,p])=>{let c=this.buildDeclarations(p,"    ");m[l]=`${l} {
+  .${a} {
+${c}  }
+}`});let j={};Object.entries(r).forEach(([l,p])=>{let c=this.buildDeclarations(p);j[l]=`.${a}${l} {
+${c}}`});let h="";Object.entries(o).forEach(([l,p])=>{h+=`@keyframes ${l} {
+`,Object.entries(p).forEach(([c,S])=>{let A=this.buildDeclarations(S,"    ");h+=`  ${c} {
+${A}  }
+`}),h+=`}
+`});let M={};Object.entries(d).forEach(([l,p])=>{let c=this.buildDeclarations(p,"    ");M[l]=`@supports ${l} {
+  .${a} {
+${c}  }
+}`});let w={};return Object.entries(u).forEach(([l,p])=>{let c=this.buildDeclarations(p,"  ");w[l]=`@layer ${l} {
+${c}}`}),{className:a,css:D,mediaQueries:m,pseudoClasses:j,keyframes:h,supports:M,layers:w}}parseStyles(e){let t={},r={},s={},o={},d={},g={},u={};return Object.entries(e).forEach(([i,a])=>{if(i.startsWith("@keyframes "))o[i.slice(11)]=a;else if(i==="@keyframes"&&typeof a=="object")Object.assign(o,a);else if(i.startsWith("@supports")){let R=i.slice(0,9)==="@supports"?i.slice(9).trim():i;d[R]=a}else i.startsWith("@container")?g[i]=a:i.startsWith("@layer")?u[i.slice(7)||"default"]=a:i in x||i.startsWith("@media")?r[i]=a:i.startsWith(":")||i.startsWith("::")?s[i]=a:t[i]=a}),{normalStyles:t,mediaQueries:r,pseudoClasses:s,keyframes:o,supports:d,container:g,layer:u}}buildDeclarations(e,t="  "){let r="";return Object.entries(e).forEach(([s,o])=>{(typeof o=="string"||typeof o=="number")&&(r+=`${t}${P(s)}: ${o};
+`)}),r}getAllStyles(){let e="";return this.styles.forEach(t=>{t.keyframes&&(e+=`${t.keyframes}
+`),t.css&&(e+=`${t.css}
+`),Object.values(t.pseudoClasses).forEach(s=>{e+=`${s}
+`}),Object.values(t.layers).forEach(s=>{e+=`${s}
+`}),Object.values(t.supports).forEach(s=>{e+=`${s}
+`}),Object.entries(t.mediaQueries).sort(([s],[o])=>this.extractMinWidth(s)-this.extractMinWidth(o)).forEach(([,s])=>{e+=`${s}
+`})}),e}extractMinWidth(e){let t=e.match(/min-width:\s*(\d+)px/);return t?parseInt(t[1],10):0}flush(e){try{let t=e??K.join(I.tmpdir(),"next-style.css");F.writeFileSync(t,this.getAllStyles(),"utf-8")}catch(t){console.error("Failed to flush styles to cache file:",t)}}getStyleMap(){return new Map(this.styles)}};function z(){let n=new y;return{collector:n,transformCssCall(e){return n.addStyle(e)}}}import H from"fs";import B from"os";import L from"path";import W from"postcss";var _=/^next-style$/,k=L.join(B.tmpdir(),"next-style.css");function E(n={}){let e=n.cacheFile??k;return{postcssPlugin:"next-style",Once(r){let s="";try{s=H.readFileSync(e,"utf-8")}catch{}let o=!1;r.walkAtRules("import",d=>{let g=d.params.replace(/['"]/g,"").trim();_.test(g)&&(s.trim()?d.replaceWith(W.parse(s)):d.remove(),o=!0)}),!o&&s.trim()&&r.prepend(W.parse(s))}}}E.postcss=!0;var G=E,J=E;function v(n){let e=f.addStyle(n);return f.flush(),e}function Z(n){Object.entries(n).forEach(([e,t])=>{f.addGlobalStyle(e,t)}),f.flush()}var f=new y;export{x as BREAKPOINTS,y as StyleCollector,P as camelToKebab,z as createTransformer,v as css,T as deduplicateStyles,$ as generateClassHash,Z as global,O as normalizeMediaQuery,J as plugin,G as postcssPlugin,f as styleCollector,Q as validateCSSProperty};

package/dist/postcss-plugin/index.cjs

@@ -0,0 +1 @@
+"use strict";var y=Object.create;var i=Object.defineProperty;var P=Object.getOwnPropertyDescriptor;var d=Object.getOwnPropertyNames;var F=Object.getPrototypeOf,O=Object.prototype.hasOwnProperty;var C=(t,e)=>{for(var r in e)i(t,r,{get:e[r],enumerable:!0})},m=(t,e,r,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let s of d(e))!O.call(t,s)&&s!==r&&i(t,s,{get:()=>e[s],enumerable:!(n=P(e,s))||n.enumerable});return t};var c=(t,e,r)=>(r=t!=null?y(F(t)):{},m(e||!t||!t.__esModule?i(r,"default",{value:t,enumerable:!0}):r,t)),E=t=>m(i({},"__esModule",{value:!0}),t);var S={};C(S,{CACHE_FILE:()=>x,default:()=>A,plugin:()=>I});module.exports=E(S);var u=c(require("fs"),1),f=c(require("os"),1),g=c(require("path"),1),p=c(require("postcss"),1),v=/^next-style$/,x=g.default.join(f.default.tmpdir(),"next-style.css");function l(t={}){let e=t.cacheFile??x;return{postcssPlugin:"next-style",Once(n){let s="";try{s=u.default.readFileSync(e,"utf-8")}catch{}let a=!1;n.walkAtRules("import",o=>{let h=o.params.replace(/['"]/g,"").trim();v.test(h)&&(s.trim()?o.replaceWith(p.default.parse(s)):o.remove(),a=!0)}),!a&&s.trim()&&n.prepend(p.default.parse(s))}}}l.postcss=!0;var A=l,I=l;0&&(module.exports={CACHE_FILE,plugin});

package/dist/postcss-plugin/index.d.cts

@@ -0,0 +1,19 @@
+import postcss from 'postcss';
+
+/** Path to the temp file used as IPC bridge between runtime and PostCSS. */
+declare const CACHE_FILE: string;
+interface PluginOptions {
+    /**
+     * Override the cache file path.
+     * Defaults to `os.tmpdir()/next-style.css`.
+     */
+    cacheFile?: string;
+}
+declare function nextStylePlugin(opts?: PluginOptions): postcss.Plugin;
+declare namespace nextStylePlugin {
+    var postcss: boolean;
+}
+
+declare const plugin: typeof nextStylePlugin;
+
+export { CACHE_FILE, nextStylePlugin as default, plugin };

package/dist/postcss-plugin/index.d.ts

@@ -1,28 +1,19 @@
 import postcss from 'postcss';
-import type { StyleCollector } from '../compiler';
-/**
- * PostCSS plugin for next-style.
- *
- * Replaces `@import "next-style";` (or `@import 'next-style';`) in CSS files
- * with the compiled CSS collected by the StyleCollector.
- *
- * The collector is populated by the runtime `css()` / `global()` calls that
- * run during the build-time module evaluation (SWC / tsc transform pass).
- * At that point all `css({})` calls have been executed and their styles are
- * sitting in the collector — the PostCSS plugin just needs to drain it.
- *
- * Usage in postcss.config.js:
- *   import nextStylePlugin from 'next-style/plugin'
- *   export default { plugins: { 'next-style/plugin': {} } }
- */
+
+/** Path to the temp file used as IPC bridge between runtime and PostCSS. */
+declare const CACHE_FILE: string;
 interface PluginOptions {
-    /** Provide a custom collector (useful for testing / server integration). */
-    collector?: StyleCollector;
+    /**
+     * Override the cache file path.
+     * Defaults to `os.tmpdir()/next-style.css`.
+     */
+    cacheFile?: string;
 }
 declare function nextStylePlugin(opts?: PluginOptions): postcss.Plugin;
 declare namespace nextStylePlugin {
     var postcss: boolean;
 }
-export default nextStylePlugin;
-export declare const plugin: typeof nextStylePlugin;
-//# sourceMappingURL=index.d.ts.map
+
+declare const plugin: typeof nextStylePlugin;
+
+export { CACHE_FILE, nextStylePlugin as default, plugin };