@luna_ui/luna 0.3.4 → 0.4.0

package/dist/css/index.d.ts

@@ -0,0 +1,194 @@
+//#region src/css/extract.d.ts
+/**
+ * Static CSS Extractor for Luna CSS Module
+ *
+ * Extracts all CSS declarations from .mbt files at build time.
+ * This ensures all styles are collected regardless of runtime branches.
+ */
+interface Warning {
+  file: string;
+  line: number;
+  func: string;
+  code: string;
+  reason: string;
+}
+interface ExtractedStyles {
+  base: Set<string>;
+  pseudo: Array<{
+    pseudo: string;
+    property: string;
+    value: string;
+  }>;
+  media: Array<{
+    condition: string;
+    property: string;
+    value: string;
+  }>;
+}
+interface ExtractOptions {
+  pretty?: boolean;
+  json?: boolean;
+  verbose?: boolean;
+  warn?: boolean;
+  strict?: boolean;
+  splitMode?: "file" | "dir" | null;
+}
+interface ExtractResult {
+  css: string;
+  mapping: Record<string, string>;
+  stats: {
+    base: number;
+    pseudo: number;
+    media: number;
+  };
+  warnings?: Warning[];
+}
+interface SplitExtractResult {
+  /** Per-file or per-dir CSS */
+  chunks: Map<string, {
+    css: string;
+    styles: ExtractedStyles;
+  }>;
+  /** Shared CSS (declarations used in 3+ files/dirs) */
+  shared: {
+    css: string;
+    styles: ExtractedStyles;
+  };
+  /** All CSS combined (for comparison) */
+  combined: string;
+  /** Class name mapping */
+  mapping: Record<string, string>;
+  /** Statistics per chunk */
+  stats: Map<string, {
+    base: number;
+    pseudo: number;
+    media: number;
+  }>;
+  warnings?: Warning[];
+}
+declare function detectWarnings(content: string, filePath: string): Warning[];
+declare function extractFromContent(content: string): ExtractedStyles;
+declare function findMbtFiles(dir: string): string[];
+declare function generateCSS(styles: ExtractedStyles, options?: {
+  pretty?: boolean;
+}): {
+  css: string;
+  mapping: Record<string, string>;
+};
+declare function extract(dir: string, options?: ExtractOptions): ExtractResult;
+interface SplitExtractOptions extends ExtractOptions {
+  /** Minimum usage count to be considered "shared" (default: 3) */
+  sharedThreshold?: number;
+}
+/**
+ * Extract CSS with split output by file or directory.
+ * Shared CSS (used in 3+ files/dirs) is separated into a shared chunk.
+ */
+declare function extractSplit(dir: string, mode: "file" | "dir", options?: SplitExtractOptions): SplitExtractResult;
+//#endregion
+//#region src/css/minify.d.ts
+/**
+ * Simple CSS Minifier
+ *
+ * Minifies CSS without changing class names.
+ * Safe for use with existing templates.
+ */
+interface MinifyOptions {
+  verbose?: boolean;
+}
+interface MinifyResult {
+  minified: string;
+  originalSize: number;
+  minifiedSize: number;
+  reduction: number;
+}
+/**
+ * Minify CSS content
+ */
+declare function minifyCSS(css: string): string;
+/**
+ * Format file size
+ */
+declare function formatSize(bytes: number): string;
+/**
+ * Minify CSS and return result with stats
+ */
+declare function minify(css: string, options?: MinifyOptions): MinifyResult;
+//#endregion
+//#region src/css/inline.d.ts
+/**
+ * CSS Class Name Inliner
+ *
+ * Replaces CSS utility function calls with pre-computed class names.
+ * This enables true zero-runtime CSS by eliminating runtime style registration.
+ */
+interface InlineOptions {
+  verbose?: boolean;
+  dryRun?: boolean;
+  removeRegistry?: boolean;
+}
+interface Replacement {
+  type: "base" | "pseudo" | "media";
+  from: string;
+  to: string;
+  key?: string;
+  decl?: string;
+}
+interface InlineResult {
+  code: string;
+  replacements: Replacement[];
+  originalSize: number;
+  finalSize: number;
+}
+/**
+ * Replace CSS function calls with pre-computed class names
+ */
+declare function inlineCSS(code: string, mapping: Record<string, string>, options?: InlineOptions): InlineResult;
+/**
+ * Remove CSS registry code (dead code after inlining)
+ */
+declare function removeRegistryCode(code: string): string;
+/**
+ * Inline CSS with mapping extracted from source directory
+ */
+declare function inlineFromSource(code: string, srcDir: string, options?: InlineOptions): InlineResult;
+//#endregion
+//#region src/css/inject.d.ts
+/**
+ * CSS Injection into HTML files
+ *
+ * Replaces CSS between markers in HTML files with extracted CSS.
+ * Supports inline embedding or external file generation.
+ */
+type OutputMode = "inline" | "external" | "auto";
+interface InjectHtmlOptions {
+  srcDir: string;
+  htmlFile: string;
+  outputFile?: string;
+  /** Output mode: "inline" embeds CSS in HTML, "external" creates separate .css file, "auto" chooses based on threshold */
+  mode?: OutputMode;
+  /** Size threshold in bytes for "auto" mode (default: 4096) */
+  threshold?: number;
+  /** CSS filename for external mode (default: "luna.css") */
+  cssFileName?: string;
+  verbose?: boolean;
+}
+interface InjectHtmlResult {
+  html: string;
+  css: string;
+  replaced: boolean;
+  /** Path to external CSS file if created */
+  cssFile?: string;
+  /** Actual mode used */
+  mode: OutputMode;
+}
+/**
+ * Inject extracted CSS into HTML file between markers
+ */
+declare function injectCssToHtml(options: InjectHtmlOptions): InjectHtmlResult;
+/**
+ * Inject CSS and write to file(s)
+ */
+declare function injectAndWrite(options: InjectHtmlOptions): InjectHtmlResult;
+//#endregion
+export { ExtractOptions, ExtractResult, ExtractedStyles, InjectHtmlOptions, InjectHtmlResult, InlineOptions, InlineResult, MinifyOptions, MinifyResult, OutputMode, Replacement, SplitExtractResult, Warning, detectWarnings, extract, extractFromContent, extractSplit, findMbtFiles, formatSize, generateCSS, injectAndWrite, injectCssToHtml, inlineCSS, inlineFromSource, minify, minifyCSS, removeRegistryCode };