@cwcss/crosswind 0.1.4 → 0.1.6

package/dist/parser.d.ts

@@ -0,0 +1,42 @@
+import type { AttributifyConfig, BracketSyntaxConfig, ParsedClass } from './types';
+/**
+ * Expand bracket/grouped syntax into individual class names
+ * e.g., flex[col jc-center ai-center] -> ['flex-col', 'justify-center', 'items-center']
+ * e.g., text[white 2rem 700] -> ['text-white', 'text-[2rem]', 'font-bold']
+ * e.g., h[min 100vh] -> ['min-h-[100vh]']
+ * e.g., hover:flex[col] -> ['hover:flex-col']
+ * e.g., flex[md:col lg:row] -> ['md:flex-col', 'lg:flex-row']
+ * e.g., -m[4] or m[-4] -> ['-m-4']
+*/
+export declare function expandBracketSyntax(className: string, config?: BracketSyntaxConfig): string[];
+/**
+ * Extract classes from attributify syntax
+ * e.g., <div hw-flex hw-items-center hw-bg="blue-500" hw-p="4">
+ * Returns classes like: flex, items-center, bg-blue-500, p-4
+ *
+ * Also supports variant attributes:
+ * e.g., <div hw-hover:bg="blue-600" hw-dark:text="white">
+ * Returns classes like: hover:bg-blue-600, dark:text-white
+*/
+export declare function extractAttributifyClasses(content: string, config?: AttributifyConfig): Set<string>;
+/**
+ * Parses a utility class string into its components
+ * Examples: "p-4" -> {raw: "p-4", variants: [], utility: "p", value: "4", important: false, arbitrary: false}
+ *          "hover:bg-blue-500" -> {raw: "hover:bg-blue-500", variants: ["hover"], utility: "bg", value: "blue-500", important: false, arbitrary: false}
+ *          "!p-4" -> {raw: "!p-4", variants: [], utility: "p", value: "4", important: true, arbitrary: false}
+ *          "w-[100px]" -> {raw: "w-[100px]", variants: [], utility: "w", value: "100px", important: false, arbitrary: true}
+*/
+export declare function parseClass(className: string): ParsedClass;
+/**
+ * Extracts all utility classes from content
+ * Matches class patterns in HTML/JSX attributes and template strings
+ * Supports bracket syntax (e.g., flex[col jc-center]) and attributify mode
+*/
+export declare function extractClasses(content: string, options?: ExtractClassesOptions): Set<string>;
+/**
+ * Options for class extraction
+*/
+export declare interface ExtractClassesOptions {
+  attributify?: AttributifyConfig
+  bracketSyntax?: BracketSyntaxConfig
+}

package/dist/plugin.d.ts

@@ -0,0 +1,22 @@
+import type { BunPlugin } from 'bun';
+import type { CrosswindOptions } from './types';
+/**
+ * Crosswind Bun plugin for processing HTML files
+ *
+ * @example
+ * ```typescript
+ * import { plugin } from '@cwcss/crosswind'
+ *
+ * await Bun.build({
+ *   entrypoints: ['./src/index.ts'],
+ *   outdir: './dist',
+ *   plugins: [plugin()],
+ * })
+ * ```
+*/
+export declare function plugin(options?: CrosswindPluginOptions): BunPlugin;
+export declare interface CrosswindPluginOptions {
+  config?: CrosswindOptions
+  includePreflight?: boolean
+}
+export default plugin;

package/dist/preflight-forms.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tailwind Forms preflight styles
+ * Provides default styling for form elements to make them easy to customize with utilities
+*/
+export declare const tailwindFormsPreflight: Preflight;

package/dist/preflight.d.ts

@@ -0,0 +1,2 @@
+export declare const modernNormalize: Preflight;
+export declare const tailwindPreflight: Preflight;

package/dist/rules-advanced.d.ts

@@ -0,0 +1,27 @@
+// Advanced utilities
+// Min/Max sizing
+export declare const minMaxSizingRule: UtilityRule;
+// Ring utilities
+export declare const ringRule: UtilityRule;
+// Border opacity utility
+export declare const borderOpacityRule: UtilityRule;
+// Space utilities (child spacing)
+export declare const spaceRule: UtilityRule;
+// Border style utilities
+export declare const borderStyleRule: UtilityRule;
+// Divide utilities (borders between children)
+export declare const divideRule: UtilityRule;
+// Gradient color stops
+export declare const gradientStopsRule: UtilityRule;
+// Flex order
+export declare const flexOrderRule: UtilityRule;
+// Flex basis
+export declare const flexBasisRule: UtilityRule;
+// Justify/Align self
+export declare const justifySelfRule: UtilityRule;
+export declare const alignSelfRule: UtilityRule;
+// Container utility with responsive max-widths
+export declare const containerRule: UtilityRule;
+// Arbitrary properties
+export declare const arbitraryPropertyRule: UtilityRule;
+export declare const advancedRules: UtilityRule[];

package/dist/rules-effects.d.ts

@@ -0,0 +1,25 @@
+// =============================================================================
+// Backgrounds, Borders, Effects utilities
+// =============================================================================
+// Background utilities
+export declare const backgroundAttachmentRule: UtilityRule;
+export declare const backgroundClipRule: UtilityRule;
+export declare const backgroundImageRule: UtilityRule;
+export declare const backgroundOriginRule: UtilityRule;
+export declare const backgroundPositionRule: UtilityRule;
+export declare const backgroundRepeatRule: UtilityRule;
+export declare const backgroundSizeRule: UtilityRule;
+// Border utilities
+export declare const borderStyleRule: UtilityRule;
+export declare const outlineRule: UtilityRule;
+// Effect utilities
+export declare const boxShadowThemeRule: UtilityRule;
+// Shadow color utilities (shadow-{color}, shadow-{color}/{opacity})
+export declare const shadowColorRule: UtilityRule;
+export declare const textShadowRule: UtilityRule;
+export declare const opacityRule: UtilityRule;
+export declare const mixBlendModeRule: UtilityRule;
+export declare const backgroundBlendModeRule: UtilityRule;
+// Mask utilities
+export declare const maskRule: UtilityRule;
+export declare const effectsRules: UtilityRule[];

package/dist/rules-forms.d.ts

@@ -0,0 +1,7 @@
+export declare const formInputRule: UtilityRule;
+export declare const formTextareaRule: UtilityRule;
+export declare const formSelectRule: UtilityRule;
+export declare const formMultiselectRule: UtilityRule;
+export declare const formCheckboxRule: UtilityRule;
+export declare const formRadioRule: UtilityRule;
+export declare const formsRules: UtilityRule[];

package/dist/rules-grid.d.ts

@@ -0,0 +1,13 @@
+// Grid utilities
+export declare const gridTemplateColumnsRule: UtilityRule;
+export declare const gridColumnRule: UtilityRule;
+export declare const gridTemplateRowsRule: UtilityRule;
+export declare const gridRowRule: UtilityRule;
+export declare const gridAutoFlowRule: UtilityRule;
+export declare const gridAutoColumnsRule: UtilityRule;
+export declare const gridAutoRowsRule: UtilityRule;
+export declare const gapRule: UtilityRule;
+export declare const placeContentRule: UtilityRule;
+export declare const placeItemsRule: UtilityRule;
+export declare const placeSelfRule: UtilityRule;
+export declare const gridRules: UtilityRule[];

package/dist/rules-interactivity.d.ts

@@ -0,0 +1,41 @@
+// Filters, Tables, Interactivity, SVG, Accessibility utilities
+// Filter utilities
+export declare const filterRule: UtilityRule;
+export declare const backdropFilterRule: UtilityRule;
+// Table utilities
+export declare const borderCollapseRule: UtilityRule;
+export declare const borderSpacingRule: UtilityRule;
+export declare const tableLayoutRule: UtilityRule;
+export declare const captionSideRule: UtilityRule;
+// Interactivity utilities
+export declare const accentColorRule: UtilityRule;
+export declare const appearanceRule: UtilityRule;
+export declare const caretColorRule: UtilityRule;
+export declare const colorSchemeRule: UtilityRule;
+export declare const fieldSizingRule: UtilityRule;
+export declare const cursorRule: UtilityRule;
+export declare const pointerEventsRule: UtilityRule;
+export declare const resizeRule: UtilityRule;
+export declare const scrollBehaviorRule: UtilityRule;
+export declare const scrollMarginRule: UtilityRule;
+export declare const scrollPaddingRule: UtilityRule;
+export declare const scrollSnapRule: UtilityRule;
+export declare const touchActionRule: UtilityRule;
+export declare const userSelectRule: UtilityRule;
+export declare const willChangeRule: UtilityRule;
+// SVG utilities
+export declare const fillRule: UtilityRule;
+export declare const strokeRule: UtilityRule;
+export declare const strokeWidthRule: UtilityRule;
+// SVG stroke-dasharray
+export declare const strokeDasharrayRule: UtilityRule;
+// SVG stroke-dashoffset
+export declare const strokeDashoffsetRule: UtilityRule;
+// SVG stroke-linecap
+export declare const strokeLinecapRule: UtilityRule;
+// SVG stroke-linejoin
+export declare const strokeLinejoinRule: UtilityRule;
+// Accessibility
+export declare const screenReaderRule: UtilityRule;
+export declare const forcedColorAdjustRule: UtilityRule;
+export declare const interactivityRules: UtilityRule[];

package/dist/rules-layout.d.ts

@@ -0,0 +1,26 @@
+// Layout utilities
+export declare const aspectRatioRule: UtilityRule;
+export declare const columnsRule: UtilityRule;
+// Column fill
+export declare const columnFillRule: UtilityRule;
+// Column gap (different from grid gap)
+export declare const columnGapRule: UtilityRule;
+// Column rule (border between columns)
+export declare const columnRuleRule: UtilityRule;
+// Column span
+export declare const columnSpanRule: UtilityRule;
+export declare const breakRule: UtilityRule;
+export declare const boxDecorationRule: UtilityRule;
+export declare const boxSizingRule: UtilityRule;
+export declare const floatRule: UtilityRule;
+export declare const clearRule: UtilityRule;
+export declare const isolationRule: UtilityRule;
+export declare const objectFitRule: UtilityRule;
+export declare const objectPositionRule: UtilityRule;
+export declare const overflowRule: UtilityRule;
+export declare const overscrollRule: UtilityRule;
+export declare const positionRule: UtilityRule;
+export declare const insetRule: UtilityRule;
+export declare const visibilityRule: UtilityRule;
+export declare const zIndexRule: UtilityRule;
+export declare const layoutRules: UtilityRule[];

package/dist/rules-transforms.d.ts

@@ -0,0 +1,33 @@
+// Transform, Transition, Animation utilities
+export declare const transformRule: UtilityRule;
+export declare const scaleRule: UtilityRule;
+export declare const rotateRule: UtilityRule;
+export declare const translateRule: UtilityRule;
+export declare const skewRule: UtilityRule;
+export declare const transformOriginRule: UtilityRule;
+export declare const perspectiveRule: UtilityRule;
+export declare const perspectiveOriginRule: UtilityRule;
+export declare const backfaceVisibilityRule: UtilityRule;
+export declare const transformStyleRule: UtilityRule;
+// Transition utilities
+export declare const transitionPropertyRule: UtilityRule;
+export declare const transitionDurationRule: UtilityRule;
+export declare const transitionTimingRule: UtilityRule;
+export declare const transitionDelayRule: UtilityRule;
+export declare const transitionBehaviorRule: UtilityRule;
+export declare const animationRule: UtilityRule;
+// Animation play state
+export declare const animationPlayStateRule: UtilityRule;
+// Animation direction
+export declare const animationDirectionRule: UtilityRule;
+// Animation fill mode
+export declare const animationFillModeRule: UtilityRule;
+// Animation iteration count
+export declare const animationIterationRule: UtilityRule;
+// Animation duration
+export declare const animationDurationRule: UtilityRule;
+// Animation delay
+export declare const animationDelayRule: UtilityRule;
+// Animation timing function
+export declare const animationTimingRule: UtilityRule;
+export declare const transformsRules: UtilityRule[];

package/dist/rules-typography.d.ts

@@ -0,0 +1,41 @@
+// Typography utilities
+export declare const fontFamilyRule: UtilityRule;
+export declare const fontSmoothingRule: UtilityRule;
+export declare const fontStyleRule: UtilityRule;
+export declare const fontStretchRule: UtilityRule;
+export declare const fontVariantNumericRule: UtilityRule;
+export declare const letterSpacingRule: UtilityRule;
+export declare const lineClampRule: UtilityRule;
+export declare const listStyleImageRule: UtilityRule;
+export declare const listStylePositionRule: UtilityRule;
+export declare const listStyleTypeRule: UtilityRule;
+export declare const textDecorationRule: UtilityRule;
+export declare const underlineOffsetRule: UtilityRule;
+export declare const textTransformRule: UtilityRule;
+export declare const textOverflowRule: UtilityRule;
+export declare const textWrapRule: UtilityRule;
+export declare const textIndentRule: UtilityRule;
+export declare const verticalAlignRule: UtilityRule;
+export declare const whiteSpaceRule: UtilityRule;
+export declare const wordBreakRule: UtilityRule;
+export declare const overflowWrapRule: UtilityRule;
+export declare const hyphensRule: UtilityRule;
+export declare const contentRule: UtilityRule;
+export declare const lineHeightRule: UtilityRule;
+// Writing mode
+export declare const writingModeRule: UtilityRule;
+// Text orientation
+export declare const textOrientationRule: UtilityRule;
+// Direction (ltr/rtl)
+export declare const directionRule: UtilityRule;
+// Text emphasis
+export declare const textEmphasisRule: UtilityRule;
+// Text emphasis color
+export declare const textEmphasisColorRule: UtilityRule;
+// Word spacing
+export declare const wordSpacingRule: UtilityRule;
+// Font variant caps
+export declare const fontVariantCapsRule: UtilityRule;
+// Font variant ligatures
+export declare const fontVariantLigaturesRule: UtilityRule;
+export declare const typographyRules: UtilityRule[];

package/dist/rules.d.ts

@@ -0,0 +1,39 @@
+import type { CrosswindConfig, ParsedClass, UtilityRuleResult } from './types';
+/**
+ * Built-in utility rules
+ * Each rule checks if it matches the parsed class and returns CSS properties
+*/
+// Display utilities
+export declare const displayRule: UtilityRule;
+// Container utilities (for container queries)
+export declare const containerRule: UtilityRule;
+// Flexbox utilities
+export declare const flexDirectionRule: UtilityRule;
+export declare const flexWrapRule: UtilityRule;
+export declare const flexRule: UtilityRule;
+export declare const flexGrowRule: UtilityRule;
+export declare const flexShrinkRule: UtilityRule;
+export declare const justifyContentRule: UtilityRule;
+export declare const alignItemsRule: UtilityRule;
+export declare const justifyItemsRule: UtilityRule;
+export declare const alignContentRule: UtilityRule;
+// Spacing utilities (margin, padding)
+export declare const spacingRule: UtilityRule;
+// Width and height utilities
+export declare const sizingRule: UtilityRule;
+export declare const colorRule: UtilityRule;
+// Placeholder color utilities (placeholder-{color})
+export declare const placeholderColorRule: UtilityRule;
+// Typography utilities
+export declare const fontSizeRule: UtilityRule;
+export declare const fontWeightRule: UtilityRule;
+export declare const leadingRule: UtilityRule;
+export declare const textAlignRule: UtilityRule;
+// Border utilities
+export declare const borderWidthRule: UtilityRule;
+// Border side width utilities (border-t-0, border-r-2, border-x-4, etc.)
+export declare const borderSideWidthRule: UtilityRule;
+export declare const borderRadiusRule: UtilityRule;
+// Export all rules (order matters - more specific rules first)
+export declare const builtInRules: UtilityRule[];
+export type UtilityRule = (parsed: ParsedClass, config: CrosswindConfig) => Record<string, string> | UtilityRuleResult | undefined

package/dist/scanner.d.ts

@@ -0,0 +1,18 @@
+import type { CompileClassTransformer } from './transformer-compile-class';
+import type { ExtractClassesOptions } from './parser';
+export declare interface ScanResult {
+  classes: Set<string>
+  transformedFiles: Map<string, string>
+}
+/**
+ * Scans files for utility classes using Bun's fast Glob API
+*/
+export declare class Scanner {
+  private patterns: string[];
+  private transformer?: CompileClassTransformer | null | undefined;
+  private extractOptions?: ExtractClassesOptions | undefined;
+  constructor(patterns: string[], transformer?: CompileClassTransformer | null | undefined, extractOptions?: ExtractClassesOptions | undefined);
+  scan(): Promise<ScanResult>;
+  scanFile(filePath: string): Promise<Set<string>>;
+  scanContent(content: string): Set<string>;
+}

package/dist/transformer-compile-class.d.ts

@@ -0,0 +1,37 @@
+import type { CrosswindConfig } from './types';
+/**
+ * Extract compile class markers from content
+*/
+export declare function extractCompileClasses(content: string, options?: CompileClassOptions): Map<string, string[]>;
+/**
+ * Transform content by replacing compile markers with generated class names
+*/
+export declare function transformContent(content: string, compiledClassMap: Map<string, string>, options?: CompileClassOptions): string;
+/**
+ * Generate class names for compiled classes
+*/
+export declare function generateCompiledClassNames(compiledClasses: Map<string, string[]>, options?: CompileClassOptions): Map<string, string>;
+export declare interface CompileClassOptions {
+  trigger?: string
+  classPrefix?: string
+  hashFn?: (content: string) => string
+  layer?: string
+}
+/**
+ * Main transformer class
+*/
+export declare class CompileClassTransformer {
+  private compiledClasses: any;
+  private classNameMap: any;
+  private options: CompileClassOptions;
+  constructor(options?: CompileClassOptions);
+  processFile(content: string): { content: string, hasChanges: boolean };
+  getCompiledClasses(): Map<string, { className: string, utilities: string[] }>;
+  generateCSS(config: CrosswindConfig, generator: any): string;
+  reset(): void;
+  getStats(): {
+    totalGroups: number
+    totalUtilities: number
+    averageUtilitiesPerGroup: number
+  };
+}

package/{src/types.ts → dist/types.d.ts}

@@ -1,68 +1,20 @@
-export interface CompileClassConfig {
-  /**
-   * Enable compile class transformer
-   * @default false
-   */
+export declare interface CompileClassConfig {
   enabled?: boolean
-  /**
-   * Trigger string to mark classes for compilation
-   * @default ':hw:'
-   */
   trigger?: string
-  /**
-   * Prefix for generated class names
-   * @default 'hw-'
-   */
   classPrefix?: string
-  /**
-   * Layer name for compiled classes
-   * @default 'shortcuts'
-   */
   layer?: string
 }
-
-export interface AttributifyConfig {
-  /**
-   * Enable attributify mode
-   * Allows using HTML attributes instead of class names
-   * e.g., <div hw-flex hw-bg="blue-500">
-   * @default false
-   */
+export declare interface AttributifyConfig {
   enabled?: boolean
-  /**
-   * Prefix for attributify attributes (to avoid conflicts with HTML attributes)
-   * e.g., with prefix 'hw-': <div hw-flex hw-bg="blue-500">
-   * @default 'hw-'
-   */
   prefix?: string
-  /**
-   * Attributes to ignore (won't be treated as utilities)
-   * @default ['class', 'className', 'style', 'id', ...]
-   */
   ignoreAttributes?: string[]
 }
-
-export interface BracketSyntaxConfig {
-  /**
-   * Enable bracket/grouped syntax
-   * Allows grouping utilities like: flex[col jc-center ai-center] or text[white 2rem 700]
-   * @default false
-   */
+export declare interface BracketSyntaxConfig {
   enabled?: boolean
-  /**
-   * Enable colon syntax for simple values
-   * e.g., bg:black, w:100%, text:white
-   * @default false
-   */
   colonSyntax?: boolean
-  /**
-   * Mapping of shorthand abbreviations to full utility names
-   * e.g., { 'jc': 'justify', 'ai': 'items', 'col': 'col' }
-   */
   aliases?: Record<string, string>
 }
-
-export interface CrosswindConfig {
+export declare interface CrosswindConfig {
   content: string[]
   output: string
   minify: boolean
@@ -79,11 +31,9 @@ export interface CrosswindConfig {
   compileClass?: CompileClassConfig
   attributify?: AttributifyConfig
   bracketSyntax?: BracketSyntaxConfig
-  /** Generate :root CSS variables from theme colors (e.g., --monokai-bg: #2d2a2e) */
   cssVariables?: boolean
 }
-
-export interface Theme {
+export declare interface Theme {
   colors: Record<string, string | Record<string, string>>
   spacing: Record<string, string>
   fontSize: Record<string, [string, { lineHeight: string }]>
@@ -91,25 +41,20 @@ export interface Theme {
   screens: Record<string, string>
   borderRadius: Record<string, string>
   boxShadow: Record<string, string>
-  /** Extend theme values without replacing defaults */
   extend?: Partial<Omit<Theme, 'extend'>>
 }
-
-export interface VariantConfig {
+export declare interface VariantConfig {
   'responsive': boolean
   'hover': boolean
   'focus': boolean
   'active': boolean
   'disabled': boolean
   'dark': boolean
-  // Group/Peer
   'group': boolean
   'peer': boolean
-  // Pseudo-elements
   'before': boolean
   'after': boolean
   'marker': boolean
-  // Pseudo-classes - Basic
   'first': boolean
   'last': boolean
   'odd': boolean
@@ -120,7 +65,6 @@ export interface VariantConfig {
   'checked': boolean
   'focus-within': boolean
   'focus-visible': boolean
-  // Pseudo-classes - Form states
   'placeholder': boolean
   'selection': boolean
   'file': boolean
@@ -129,7 +73,6 @@ export interface VariantConfig {
   'invalid': boolean
   'read-only': boolean
   'autofill': boolean
-  // Pseudo-classes - Additional states
   'open': boolean
   'closed': boolean
   'empty': boolean
@@ -139,49 +82,38 @@ export interface VariantConfig {
   'indeterminate': boolean
   'default': boolean
   'optional': boolean
-  // Media
   'print': boolean
-  // Direction
   'rtl': boolean
   'ltr': boolean
-  // Motion
   'motion-safe': boolean
   'motion-reduce': boolean
-  // Contrast
   'contrast-more': boolean
   'contrast-less': boolean
 }
-
-export interface ParsedClass {
+export declare interface ParsedClass {
   raw: string
   variants: string[]
   utility: string
   value?: string
   important: boolean
   arbitrary: boolean
-  typeHint?: string // Type hint for arbitrary values, e.g., 'color' in text-[color:var(--muted)]
+  typeHint?: string
 }
-
-export interface CSSRule {
+export declare interface CSSRule {
   selector: string
   properties: Record<string, string>
   mediaQuery?: string
-  childSelector?: string // For utilities like space-x that need child selectors
+  childSelector?: string
 }
-
-export interface UtilityRuleResult {
+export declare interface UtilityRuleResult {
   properties: Record<string, string>
   childSelector?: string
-  pseudoElement?: string // e.g., '::placeholder' — appended to selector without space
+  pseudoElement?: string
 }
-
-export type CustomRule = [RegExp, (match: RegExpMatchArray) => Record<string, string> | undefined]
-
-export interface Preflight {
+export declare interface Preflight {
   getCSS: () => string
 }
-
-export interface Preset {
+export declare interface Preset {
   name: string
   theme?: Partial<Theme>
   rules?: CustomRule[]
@@ -189,9 +121,8 @@ export interface Preset {
   variants?: Partial<VariantConfig>
   preflights?: Preflight[]
 }
-
-type DeepPartial<T> = {
+export type CustomRule = [RegExp, (match: RegExpMatchArray) => Record<string, string> | undefined]
+declare type DeepPartial<T> = {
   [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P]
 }
-
-export type CrosswindOptions = DeepPartial<CrosswindConfig>
+export type CrosswindOptions = DeepPartial<CrosswindConfig>

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cwcss/crosswind",
   "type": "module",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "A performant Utility-First CSS framework. Similar to Tailwind or UnoCSS.",
   "author": "Chris Breuer <chris@stacksjs.org>",
   "license": "MIT",