boss-css 0.0.19 → 0.0.21

package/dist/shared/types.d.cts

@@ -0,0 +1,96 @@
+import { BosswindConfig } from "../prop/bosswind/shared.cjs";
+import { FontConfig } from "../fontsource/types.cjs";
+
+//#region src/shared/types.d.ts
+type DebugValue = boolean | string | undefined;
+type CompileConfig = {
+  spread?: boolean;
+  stats?: false | 'quick' | 'detailed';
+  tempOutDir?: string;
+  classNameStrategy?: false | 'hash' | 'shortest' | 'unicode';
+};
+type RuntimeConfig = {
+  only?: boolean;
+  strategy?: 'inline-first' | 'classname-first' | 'classic';
+  globals?: 'inline' | 'file' | 'none';
+};
+type FrameworkFileType = 'jsx' | 'unknown';
+type FrameworkId = 'react' | 'preact' | 'solid' | 'qwik' | 'stencil' | 'unknown' | 'custom' | 'auto';
+type FrameworkConfig = {
+  name?: FrameworkId | 'auto';
+  className?: string;
+  fileType?: FrameworkFileType;
+  jsx?: {
+    importSource?: string;
+    runtimeModule?: string;
+    typesModule?: string;
+    typesNamespace?: string;
+    elementType?: string;
+    componentProps?: string;
+  };
+};
+type AiConfig = {
+  llms?: {
+    enabled?: boolean;
+    path?: string;
+  };
+  skills?: {
+    enabled?: boolean;
+    outputDir?: string;
+    includeBuiltins?: boolean;
+  };
+};
+type UserConfig = {
+  bosswind?: BosswindConfig;
+  fonts?: FontConfig[];
+  breakpoints?: Record<string, [number | null, number | null]>;
+  compile?: CompileConfig;
+  configDir?: string;
+  debug?: DebugValue;
+  content?: string | string[];
+  ai?: AiConfig;
+  css?: {
+    autoLoad?: boolean;
+    boundaries?: {
+      ignore?: string[];
+      criticality?: number;
+    };
+  };
+  devServer?: {
+    port?: number;
+    autoStart?: boolean;
+  };
+  folder?: string;
+  framework?: FrameworkConfig | FrameworkId;
+  jsx?: {
+    globals?: boolean;
+  };
+  nativeStyleProps?: string[];
+  plugins?: unknown[];
+  runtime?: RuntimeConfig;
+  selectorPrefix?: string;
+  selectorScope?: string;
+  stylesheetPath?: string;
+  tokens?: Record<string, unknown> | ((valueMap: unknown) => Record<string, unknown>);
+  tokenPropGroups?: Record<string, string[]>;
+  unit?: string;
+};
+type DictionaryItem = {
+  property: string;
+  description: string;
+  values?: string[];
+  initial?: string;
+  aliases: string[];
+  isCSSProp?: boolean;
+  usage?: string;
+  csstype?: unknown;
+  single?: boolean;
+  handler?: (options: {
+    value: unknown;
+    output: Record<string, unknown>;
+    contexts: string[];
+  }) => void;
+  descriptor?: any;
+};
+//#endregion
+export { DebugValue, DictionaryItem, FrameworkFileType, FrameworkId, UserConfig };

package/dist/shared/types.d.mts

@@ -0,0 +1,96 @@
+import { BosswindConfig } from "../prop/bosswind/shared.mjs";
+import { FontConfig } from "../fontsource/types.mjs";
+
+//#region src/shared/types.d.ts
+type DebugValue = boolean | string | undefined;
+type CompileConfig = {
+  spread?: boolean;
+  stats?: false | 'quick' | 'detailed';
+  tempOutDir?: string;
+  classNameStrategy?: false | 'hash' | 'shortest' | 'unicode';
+};
+type RuntimeConfig = {
+  only?: boolean;
+  strategy?: 'inline-first' | 'classname-first' | 'classic';
+  globals?: 'inline' | 'file' | 'none';
+};
+type FrameworkFileType = 'jsx' | 'unknown';
+type FrameworkId = 'react' | 'preact' | 'solid' | 'qwik' | 'stencil' | 'unknown' | 'custom' | 'auto';
+type FrameworkConfig = {
+  name?: FrameworkId | 'auto';
+  className?: string;
+  fileType?: FrameworkFileType;
+  jsx?: {
+    importSource?: string;
+    runtimeModule?: string;
+    typesModule?: string;
+    typesNamespace?: string;
+    elementType?: string;
+    componentProps?: string;
+  };
+};
+type AiConfig = {
+  llms?: {
+    enabled?: boolean;
+    path?: string;
+  };
+  skills?: {
+    enabled?: boolean;
+    outputDir?: string;
+    includeBuiltins?: boolean;
+  };
+};
+type UserConfig = {
+  bosswind?: BosswindConfig;
+  fonts?: FontConfig[];
+  breakpoints?: Record<string, [number | null, number | null]>;
+  compile?: CompileConfig;
+  configDir?: string;
+  debug?: DebugValue;
+  content?: string | string[];
+  ai?: AiConfig;
+  css?: {
+    autoLoad?: boolean;
+    boundaries?: {
+      ignore?: string[];
+      criticality?: number;
+    };
+  };
+  devServer?: {
+    port?: number;
+    autoStart?: boolean;
+  };
+  folder?: string;
+  framework?: FrameworkConfig | FrameworkId;
+  jsx?: {
+    globals?: boolean;
+  };
+  nativeStyleProps?: string[];
+  plugins?: unknown[];
+  runtime?: RuntimeConfig;
+  selectorPrefix?: string;
+  selectorScope?: string;
+  stylesheetPath?: string;
+  tokens?: Record<string, unknown> | ((valueMap: unknown) => Record<string, unknown>);
+  tokenPropGroups?: Record<string, string[]>;
+  unit?: string;
+};
+type DictionaryItem = {
+  property: string;
+  description: string;
+  values?: string[];
+  initial?: string;
+  aliases: string[];
+  isCSSProp?: boolean;
+  usage?: string;
+  csstype?: unknown;
+  single?: boolean;
+  handler?: (options: {
+    value: unknown;
+    output: Record<string, unknown>;
+    contexts: string[];
+  }) => void;
+  descriptor?: any;
+};
+//#endregion
+export { DebugValue, DictionaryItem, FrameworkFileType, FrameworkId, UserConfig };

package/dist/strategy/classic/runtime-only.d.cts

@@ -0,0 +1,7 @@
+import { Plugin } from "../../types/Plugin.cjs";
+
+//#region src/strategy/classic/runtime-only.d.ts
+declare const name = "classic";
+declare const onBrowserObjectStart: Plugin<'onBrowserObjectStart'>;
+//#endregion
+export { name, onBrowserObjectStart };

package/dist/strategy/classic/runtime-only.d.mts

@@ -0,0 +1,7 @@
+import { Plugin } from "../../types/Plugin.mjs";
+
+//#region src/strategy/classic/runtime-only.d.ts
+declare const name = "classic";
+declare const onBrowserObjectStart: Plugin<'onBrowserObjectStart'>;
+//#endregion
+export { name, onBrowserObjectStart };

package/dist/strategy/classname-first/browser.d.cts

@@ -0,0 +1,7 @@
+import { Plugin } from "../../types/Plugin.cjs";
+
+//#region src/strategy/classname-first/browser.d.ts
+declare const name = "classname-first";
+declare const onBrowserObjectStart: Plugin<'onBrowserObjectStart'>;
+//#endregion
+export { name, onBrowserObjectStart };

package/dist/strategy/classname-first/browser.d.mts

@@ -0,0 +1,7 @@
+import { Plugin } from "../../types/Plugin.mjs";
+
+//#region src/strategy/classname-first/browser.d.ts
+declare const name = "classname-first";
+declare const onBrowserObjectStart: Plugin<'onBrowserObjectStart'>;
+//#endregion
+export { name, onBrowserObjectStart };

package/dist/strategy/classname-first/runtime-only.d.cts

@@ -0,0 +1,7 @@
+import { Plugin } from "../../types/Plugin.cjs";
+
+//#region src/strategy/classname-first/runtime-only.d.ts
+declare const name = "classname-first";
+declare const onBrowserObjectStart: Plugin<'onBrowserObjectStart'>;
+//#endregion
+export { name, onBrowserObjectStart };

package/dist/strategy/classname-first/runtime-only.d.mts

@@ -0,0 +1,7 @@
+import { Plugin } from "../../types/Plugin.mjs";
+
+//#region src/strategy/classname-first/runtime-only.d.ts
+declare const name = "classname-first";
+declare const onBrowserObjectStart: Plugin<'onBrowserObjectStart'>;
+//#endregion
+export { name, onBrowserObjectStart };

package/dist/strategy/classname-first/server.d.cts

@@ -0,0 +1,9 @@
+import { Plugin } from "../../types/Plugin.cjs";
+
+//#region src/strategy/classname-first/server.d.ts
+declare const settings: Map<string, unknown>;
+declare const onBoot: Plugin<'onBoot'>;
+declare const onPropTree: Plugin<'onPropTree'>;
+declare const name = "classname-first";
+//#endregion
+export { name, onBoot, onPropTree, settings };

package/dist/strategy/classname-first/server.d.mts

@@ -0,0 +1,9 @@
+import { Plugin } from "../../types/Plugin.mjs";
+
+//#region src/strategy/classname-first/server.d.ts
+declare const settings: Map<string, unknown>;
+declare const onBoot: Plugin<'onBoot'>;
+declare const onPropTree: Plugin<'onPropTree'>;
+declare const name = "classname-first";
+//#endregion
+export { name, onBoot, onPropTree, settings };

package/dist/strategy/classname-only/server.d.cts

@@ -0,0 +1,8 @@
+import { Plugin } from "../../types/Plugin.cjs";
+
+//#region src/strategy/classname-only/server.d.ts
+declare const onBoot: Plugin<'onBoot'>;
+declare const onPropTree: Plugin<'onPropTree'>;
+declare const name = "classname-only";
+//#endregion
+export { name, onBoot, onPropTree };

package/dist/strategy/classname-only/server.d.mts

@@ -0,0 +1,8 @@
+import { Plugin } from "../../types/Plugin.mjs";
+
+//#region src/strategy/classname-only/server.d.ts
+declare const onBoot: Plugin<'onBoot'>;
+declare const onPropTree: Plugin<'onPropTree'>;
+declare const name = "classname-only";
+//#endregion
+export { name, onBoot, onPropTree };

package/dist/strategy/inline-first/browser.d.cts

@@ -0,0 +1,7 @@
+import { Plugin } from "../../types/Plugin.cjs";
+
+//#region src/strategy/inline-first/browser.d.ts
+declare const name = "inline-first";
+declare const onBrowserObjectStart: Plugin<'onBrowserObjectStart'>;
+//#endregion
+export { name, onBrowserObjectStart };

package/dist/strategy/inline-first/browser.d.mts

@@ -0,0 +1,7 @@
+import { Plugin } from "../../types/Plugin.mjs";
+
+//#region src/strategy/inline-first/browser.d.ts
+declare const name = "inline-first";
+declare const onBrowserObjectStart: Plugin<'onBrowserObjectStart'>;
+//#endregion
+export { name, onBrowserObjectStart };

package/dist/strategy/inline-first/runtime-only.d.cts

@@ -0,0 +1,7 @@
+import { Plugin } from "../../types/Plugin.cjs";
+
+//#region src/strategy/inline-first/runtime-only.d.ts
+declare const name = "inline-first";
+declare const onBrowserObjectStart: Plugin<'onBrowserObjectStart'>;
+//#endregion
+export { name, onBrowserObjectStart };

package/dist/strategy/inline-first/runtime-only.d.mts

@@ -0,0 +1,7 @@
+import { Plugin } from "../../types/Plugin.mjs";
+
+//#region src/strategy/inline-first/runtime-only.d.ts
+declare const name = "inline-first";
+declare const onBrowserObjectStart: Plugin<'onBrowserObjectStart'>;
+//#endregion
+export { name, onBrowserObjectStart };

package/dist/strategy/inline-first/server.d.cts

@@ -0,0 +1,9 @@
+import { Plugin } from "../../types/Plugin.cjs";
+
+//#region src/strategy/inline-first/server.d.ts
+declare const settings: Map<string, unknown>;
+declare const onBoot: Plugin<'onBoot'>;
+declare const onPropTree: Plugin<'onPropTree'>;
+declare const name = "inline-first";
+//#endregion
+export { name, onBoot, onPropTree, settings };

package/dist/strategy/inline-first/server.d.mts

@@ -0,0 +1,9 @@
+import { Plugin } from "../../types/Plugin.mjs";
+
+//#region src/strategy/inline-first/server.d.ts
+declare const settings: Map<string, unknown>;
+declare const onBoot: Plugin<'onBoot'>;
+declare const onPropTree: Plugin<'onPropTree'>;
+declare const name = "inline-first";
+//#endregion
+export { name, onBoot, onPropTree, settings };

package/dist/strategy/runtime/runtime-only.d.cts

@@ -0,0 +1,9 @@
+import { Plugin } from "../../types/Plugin.cjs";
+import { applyGlobals } from "../runtime-only/css.cjs";
+
+//#region src/strategy/runtime/runtime-only.d.ts
+declare const name = "runtime";
+declare const onInit: Plugin<'onInit'>;
+declare const onBrowserObjectStart: Plugin<'onBrowserObjectStart'>;
+//#endregion
+export { applyGlobals, name, onBrowserObjectStart, onInit };

package/dist/strategy/runtime/runtime-only.d.mts

@@ -0,0 +1,9 @@
+import { Plugin } from "../../types/Plugin.mjs";
+import { applyGlobals } from "../runtime-only/css.mjs";
+
+//#region src/strategy/runtime/runtime-only.d.ts
+declare const name = "runtime";
+declare const onInit: Plugin<'onInit'>;
+declare const onBrowserObjectStart: Plugin<'onBrowserObjectStart'>;
+//#endregion
+export { applyGlobals, name, onBrowserObjectStart, onInit };

package/dist/strategy/runtime/server.d.cts

@@ -0,0 +1,9 @@
+import { Plugin } from "../../types/Plugin.cjs";
+
+//#region src/strategy/runtime/server.d.ts
+declare const name = "runtime";
+declare const settings: Map<string, unknown>;
+declare const onBoot: Plugin<'onBoot'>;
+declare const onPropTree: Plugin<'onPropTree'>;
+//#endregion
+export { name, onBoot, onPropTree, settings };

package/dist/strategy/runtime/server.d.mts

@@ -0,0 +1,9 @@
+import { Plugin } from "../../types/Plugin.mjs";
+
+//#region src/strategy/runtime/server.d.ts
+declare const name = "runtime";
+declare const settings: Map<string, unknown>;
+declare const onBoot: Plugin<'onBoot'>;
+declare const onPropTree: Plugin<'onPropTree'>;
+//#endregion
+export { name, onBoot, onPropTree, settings };

package/dist/strategy/runtime-only/css.d.cts

@@ -0,0 +1,43 @@
+import { BossBrowserApi, Plugin } from "../../types/Plugin.cjs";
+
+//#region src/strategy/runtime-only/css.d.ts
+declare const applyGlobals: (payload?: {
+  cssText?: string;
+} | string | null) => void;
+declare class RuntimeCSS {
+  api: BossBrowserApi;
+  current: {
+    className: string | null;
+    selector: string | null;
+    pseudos: string[];
+    values: Set<string>;
+    query: string | null;
+  } | null;
+  root: Set<string>;
+  imports: Set<string>;
+  constructor(api: BossBrowserApi);
+  get text(): string;
+  addImport(_url?: string): void;
+  addRoot(value?: string, _source?: string | null): void;
+  removeSource(_source?: string | null): void;
+  reset(): void;
+  selector({
+    className,
+    selector,
+    pseudos,
+    query
+  }: {
+    className?: string | null;
+    selector?: string | null;
+    pseudos?: string[];
+    query?: string | null;
+  }): void;
+  rule(property: string, value: unknown, options?: {
+    important?: boolean;
+  }): void;
+  addRule(rule: string, query?: string | null, _source?: string | null): void;
+  write(): void;
+}
+declare const onInit: Plugin<'onInit'>;
+//#endregion
+export { RuntimeCSS, applyGlobals, onInit };

package/dist/strategy/runtime-only/css.d.mts

@@ -0,0 +1,43 @@
+import { BossBrowserApi, Plugin } from "../../types/Plugin.mjs";
+
+//#region src/strategy/runtime-only/css.d.ts
+declare const applyGlobals: (payload?: {
+  cssText?: string;
+} | string | null) => void;
+declare class RuntimeCSS {
+  api: BossBrowserApi;
+  current: {
+    className: string | null;
+    selector: string | null;
+    pseudos: string[];
+    values: Set<string>;
+    query: string | null;
+  } | null;
+  root: Set<string>;
+  imports: Set<string>;
+  constructor(api: BossBrowserApi);
+  get text(): string;
+  addImport(_url?: string): void;
+  addRoot(value?: string, _source?: string | null): void;
+  removeSource(_source?: string | null): void;
+  reset(): void;
+  selector({
+    className,
+    selector,
+    pseudos,
+    query
+  }: {
+    className?: string | null;
+    selector?: string | null;
+    pseudos?: string[];
+    query?: string | null;
+  }): void;
+  rule(property: string, value: unknown, options?: {
+    important?: boolean;
+  }): void;
+  addRule(rule: string, query?: string | null, _source?: string | null): void;
+  write(): void;
+}
+declare const onInit: Plugin<'onInit'>;
+//#endregion
+export { RuntimeCSS, applyGlobals, onInit };

package/dist/tasks/build.d.cts

@@ -0,0 +1,23 @@
+import { UserConfig } from "../shared/types.cjs";
+
+//#region src/tasks/build.d.ts
+type BuildResult = {
+  filesParsed: number;
+  cssPath: string | null;
+  cssBytes: number;
+  durationMs: number;
+  boundaryPaths?: string[];
+};
+type ResolvedBuildConfig = {
+  config: UserConfig;
+  folderPath: string;
+  stylesheetPath: string;
+  runtimeOnly: boolean;
+  runtimeGlobals: 'inline' | 'file' | 'none';
+};
+declare const resolveBuildConfig: (userConfig: UserConfig, baseDir?: string) => ResolvedBuildConfig;
+declare const runBuild: (userConfig: UserConfig, options?: {
+  baseDir?: string;
+}) => Promise<BuildResult>;
+//#endregion
+export { BuildResult, ResolvedBuildConfig, resolveBuildConfig, runBuild };

package/dist/tasks/build.d.mts

@@ -0,0 +1,23 @@
+import { UserConfig } from "../shared/types.mjs";
+
+//#region src/tasks/build.d.ts
+type BuildResult = {
+  filesParsed: number;
+  cssPath: string | null;
+  cssBytes: number;
+  durationMs: number;
+  boundaryPaths?: string[];
+};
+type ResolvedBuildConfig = {
+  config: UserConfig;
+  folderPath: string;
+  stylesheetPath: string;
+  runtimeOnly: boolean;
+  runtimeGlobals: 'inline' | 'file' | 'none';
+};
+declare const resolveBuildConfig: (userConfig: UserConfig, baseDir?: string) => ResolvedBuildConfig;
+declare const runBuild: (userConfig: UserConfig, options?: {
+  baseDir?: string;
+}) => Promise<BuildResult>;
+//#endregion
+export { BuildResult, ResolvedBuildConfig, resolveBuildConfig, runBuild };

package/dist/tasks/compile.d.cts

@@ -0,0 +1,31 @@
+import { UserConfig } from "../shared/types.cjs";
+
+//#region src/tasks/compile.d.ts
+type CompileOptions = {
+  config: UserConfig;
+  prod?: boolean;
+};
+declare const runCompile: ({
+  config,
+  prod
+}: CompileOptions) => Promise<{
+  statsMode: false | "quick" | "detailed";
+  stats: {
+    outputMode: "prod" | "temp";
+    outputDir: string;
+    runtimeFree: boolean;
+    runtimeFiles: string[];
+    valueHelperFiles: string[];
+    filesProcessed: number;
+    filesCopied: number;
+    filesSkipped: number;
+    filesTotal: number;
+    elementsReplaced: number;
+    durationMs: number;
+    cssBytes: number;
+    cssWritten: boolean;
+    stylesheetPath: string | null;
+  };
+}>;
+//#endregion
+export { CompileOptions, runCompile };

package/dist/tasks/compile.d.mts

@@ -0,0 +1,31 @@
+import { UserConfig } from "../shared/types.mjs";
+
+//#region src/tasks/compile.d.ts
+type CompileOptions = {
+  config: UserConfig;
+  prod?: boolean;
+};
+declare const runCompile: ({
+  config,
+  prod
+}: CompileOptions) => Promise<{
+  statsMode: false | "quick" | "detailed";
+  stats: {
+    outputMode: "prod" | "temp";
+    outputDir: string;
+    runtimeFree: boolean;
+    runtimeFiles: string[];
+    valueHelperFiles: string[];
+    filesProcessed: number;
+    filesCopied: number;
+    filesSkipped: number;
+    filesTotal: number;
+    elementsReplaced: number;
+    durationMs: number;
+    cssBytes: number;
+    cssWritten: boolean;
+    stylesheetPath: string | null;
+  };
+}>;
+//#endregion
+export { CompileOptions, runCompile };

package/dist/tasks/postcss.d.cts

@@ -0,0 +1,10 @@
+import postcss from "postcss";
+
+//#region src/tasks/postcss.d.ts
+type BossPostcssOptions = {
+  baseDir?: string;
+  dirDependencies?: boolean;
+};
+declare const runPostcss: (root: postcss.Root, result: postcss.Result, options?: BossPostcssOptions) => Promise<void>;
+//#endregion
+export { BossPostcssOptions, runPostcss };

package/dist/tasks/postcss.d.mts

@@ -0,0 +1,10 @@
+import postcss from "postcss";
+
+//#region src/tasks/postcss.d.ts
+type BossPostcssOptions = {
+  baseDir?: string;
+  dirDependencies?: boolean;
+};
+declare const runPostcss: (root: postcss.Root, result: postcss.Result, options?: BossPostcssOptions) => Promise<void>;
+//#endregion
+export { BossPostcssOptions, runPostcss };

package/dist/tasks/session.d.cts

@@ -0,0 +1,12 @@
+//#region src/tasks/session.d.ts
+type SessionPhase = 'start' | 'run' | 'stop';
+type SessionKind = 'watch' | 'postcss' | 'build' | 'compile' | 'custom';
+type SessionPayload = {
+  phase: SessionPhase;
+  kind: SessionKind;
+  baseDir: string;
+  configPath: string | null;
+  runtimePath: string | null;
+};
+//#endregion
+export { SessionPayload };

package/dist/tasks/session.d.mts

@@ -0,0 +1,12 @@
+//#region src/tasks/session.d.ts
+type SessionPhase = 'start' | 'run' | 'stop';
+type SessionKind = 'watch' | 'postcss' | 'build' | 'compile' | 'custom';
+type SessionPayload = {
+  phase: SessionPhase;
+  kind: SessionKind;
+  baseDir: string;
+  configPath: string | null;
+  runtimePath: string | null;
+};
+//#endregion
+export { SessionPayload };

package/dist/tasks/watch.d.cts

@@ -0,0 +1,17 @@
+import { UserConfig } from "../shared/types.cjs";
+import { BuildResult } from "./build.cjs";
+
+//#region src/tasks/watch.d.ts
+type WatchResult = {
+  close: () => Promise<void>;
+};
+type WatchOptions = {
+  baseDir?: string;
+  debounceMs?: number;
+  onBuild?: (result: BuildResult) => void;
+  onError?: (error: Error) => void;
+  onReady?: () => void;
+};
+declare const runWatch: (userConfig: UserConfig, options?: WatchOptions) => Promise<WatchResult>;
+//#endregion
+export { WatchOptions, WatchResult, runWatch };