@tailwindcss/node 0.0.0-insiders.f8b9aa9 → 0.0.0-insiders.f945c3d

package/README.md

@@ -27,14 +27,10 @@ For full documentation, visit [tailwindcss.com](https://tailwindcss.com).
 
 ## Community
 
-For help, discussion about best practices, or any other conversation that would benefit from being searchable:
+For help, discussion about best practices, or feature ideas:
 
 [Discuss Tailwind CSS on GitHub](https://github.com/tailwindcss/tailwindcss/discussions)
 
-For chatting with others using the framework:
-
-[Join the Tailwind CSS Discord Server](https://discord.gg/7NF8GNe)
-
 ## Contributing
 
 If you're interested in contributing to Tailwind CSS, please read our [contributing docs](https://github.com/tailwindcss/tailwindcss/blob/next/.github/CONTRIBUTING.md) **before submitting a pull request**.

package/dist/esm-cache.loader.mjs

@@ -1 +1 @@
-import{isBuiltin as i}from"node:module";var o=async(a,e,u)=>{let r=await u(a,e);if(r.url===import.meta.url||i(r.url)||!e.parentURL)return r;let t=new URL(e.parentURL).searchParams.get("id");if(t===null)return r;let l=new URL(r.url);return l.searchParams.set("id",t),{...r,url:`${l}`}};export{o as resolve};
+import{isBuiltin as i}from"module";var o=async(a,e,u)=>{let r=await u(a,e);if(r.url===import.meta.url||i(r.url)||!e.parentURL)return r;let t=new URL(e.parentURL).searchParams.get("id");if(t===null)return r;let l=new URL(r.url);return l.searchParams.set("id",t),{...r,url:`${l}`}};export{o as resolve};

package/dist/index.d.mts

@@ -1,9 +1,10 @@
 import { Candidate, Variant } from './candidate';
 import { compileAstNodes } from './compile';
-import { ClassEntry, VariantEntry } from './intellisense';
+import { ClassEntry, VariantEntry, CanonicalizeOptions } from './intellisense';
 import { Theme } from './theme';
 import { Utilities } from './utilities';
 import { Variants } from './variants';
+import * as tailwindcss from 'tailwindcss';
 import { Polyfills, Features } from 'tailwindcss';
 export { Features, Polyfills } from 'tailwindcss';
 
@@ -14,6 +15,10 @@ declare namespace env {
   export { env_DEBUG as DEBUG };
 }
 
+declare const enum CompileAstFlags {
+    None = 0,
+    RespectImportant = 1
+}
 type DesignSystem = {
     theme: Theme;
     utilities: Utilities;
@@ -25,48 +30,141 @@ type DesignSystem = {
     getVariants(): VariantEntry[];
     parseCandidate(candidate: string): Readonly<Candidate>[];
     parseVariant(variant: string): Readonly<Variant> | null;
-    compileAstNodes(candidate: Candidate): ReturnType<typeof compileAstNodes>;
+    compileAstNodes(candidate: Candidate, flags?: CompileAstFlags): ReturnType<typeof compileAstNodes>;
+    printCandidate(candidate: Candidate): string;
+    printVariant(variant: Variant): string;
     getVariantOrder(): Map<Variant, number>;
     resolveThemeValue(path: string, forceInline?: boolean): string | undefined;
     trackUsedVariables(raw: string): void;
+    canonicalizeCandidates(candidates: string[], options?: CanonicalizeOptions): string[];
     candidatesToCss(classes: string[]): (string | null)[];
 };
 
+/**
+ * The source code for one or more nodes in the AST
+ *
+ * This generally corresponds to a stylesheet
+ */
+interface Source {
+    /**
+     * The path to the file that contains the referenced source code
+     *
+     * If this references the *output* source code, this is `null`.
+     */
+    file: string | null;
+    /**
+     * The referenced source code
+     */
+    code: string;
+}
+/**
+ * The file and offsets within it that this node covers
+ *
+ * This can represent either:
+ * - A location in the original CSS which caused this node to be created
+ * - A location in the output CSS where this node resides
+ */
+type SourceLocation = [source: Source, start: number, end: number];
+
+/**
+ * Line offset tables are the key to generating our source maps. They allow us
+ * to store indexes with our AST nodes and later convert them into positions as
+ * when given the source that the indexes refer to.
+ */
+/**
+ * A position in source code
+ *
+ * https://tc39.es/ecma426/#sec-position-record-type
+ */
+interface Position {
+    /** The line number, one-based */
+    line: number;
+    /** The column/character number, one-based */
+    column: number;
+}
+
+interface OriginalPosition extends Position {
+    source: DecodedSource;
+}
+/**
+ * A "decoded" sourcemap
+ *
+ * @see https://tc39.es/ecma426/#decoded-source-map-record
+ */
+interface DecodedSourceMap {
+    file: string | null;
+    sources: DecodedSource[];
+    mappings: DecodedMapping[];
+}
+/**
+ * A "decoded" source
+ *
+ * @see https://tc39.es/ecma426/#decoded-source-record
+ */
+interface DecodedSource {
+    url: string | null;
+    content: string | null;
+    ignore: boolean;
+}
+/**
+ * A "decoded" mapping
+ *
+ * @see https://tc39.es/ecma426/#decoded-mapping-record
+ */
+interface DecodedMapping {
+    originalPosition: OriginalPosition | null;
+    generatedPosition: Position;
+    name: string | null;
+}
+
 type StyleRule = {
     kind: 'rule';
     selector: string;
     nodes: AstNode[];
+    src?: SourceLocation;
+    dst?: SourceLocation;
 };
 type AtRule = {
     kind: 'at-rule';
     name: string;
     params: string;
     nodes: AstNode[];
+    src?: SourceLocation;
+    dst?: SourceLocation;
 };
 type Declaration = {
     kind: 'declaration';
     property: string;
     value: string | undefined;
     important: boolean;
+    src?: SourceLocation;
+    dst?: SourceLocation;
 };
 type Comment = {
     kind: 'comment';
     value: string;
+    src?: SourceLocation;
+    dst?: SourceLocation;
 };
 type Context = {
     kind: 'context';
     context: Record<string, string | boolean>;
     nodes: AstNode[];
+    src?: undefined;
+    dst?: undefined;
 };
 type AtRoot = {
     kind: 'at-root';
     nodes: AstNode[];
+    src?: undefined;
+    dst?: undefined;
 };
 type AstNode = StyleRule | AtRule | Declaration | Comment | Context | AtRoot;
 
 type Resolver = (id: string, base: string) => Promise<string | false | undefined>;
 interface CompileOptions {
     base: string;
+    from?: string;
     onDependency: (path: string) => void;
     shouldRewriteUrls?: boolean;
     polyfills?: Polyfills;
@@ -98,11 +196,13 @@ declare function compile(css: string, options: CompileOptions): Promise<{
     } | null;
     features: Features;
     build(candidates: string[]): string;
+    buildSourceMap(): tailwindcss.DecodedSourceMap;
 }>;
 declare function __unstable__loadDesignSystem(css: string, { base }: {
     base: string;
 }): Promise<DesignSystem>;
 declare function loadModule(id: string, base: string, onDependency: (path: string) => void, customJsResolver?: Resolver): Promise<{
+    path: string;
     base: string;
     module: any;
 }>;
@@ -121,9 +221,32 @@ declare class Instrumentation implements Disposable {
 
 declare function normalizePath(originalPath: string): string;
 
-declare function optimize(input: string, { file, minify }?: {
+interface OptimizeOptions {
+    /**
+     * The file being transformed
+     */
     file?: string;
+    /**
+     * Enabled minified output
+     */
     minify?: boolean;
-}): string;
+    /**
+     * The output source map before optimization
+     *
+     * If omitted a resulting source map will not be available
+     */
+    map?: string;
+}
+interface TransformResult {
+    code: string;
+    map: string | undefined;
+}
+declare function optimize(input: string, { file, minify, map }?: OptimizeOptions): TransformResult;
+
+interface SourceMap {
+    readonly raw: string;
+    readonly inline: string;
+}
+declare function toSourceMap(map: DecodedSourceMap | string): SourceMap;
 
-export { type CompileOptions, Instrumentation, type Resolver, __unstable__loadDesignSystem, compile, compileAst, env, loadModule, normalizePath, optimize };
+export { type CompileOptions, type DecodedSource, type DecodedSourceMap, Instrumentation, type OptimizeOptions, type Resolver, type SourceMap, type TransformResult, __unstable__loadDesignSystem, compile, compileAst, env, loadModule, normalizePath, optimize, toSourceMap };

package/dist/index.d.ts

@@ -1,9 +1,10 @@
 import { Candidate, Variant } from './candidate';
 import { compileAstNodes } from './compile';
-import { ClassEntry, VariantEntry } from './intellisense';
+import { ClassEntry, VariantEntry, CanonicalizeOptions } from './intellisense';
 import { Theme } from './theme';
 import { Utilities } from './utilities';
 import { Variants } from './variants';
+import * as tailwindcss from 'tailwindcss';
 import { Polyfills, Features } from 'tailwindcss';
 export { Features, Polyfills } from 'tailwindcss';
 
@@ -14,6 +15,10 @@ declare namespace env {
   export { env_DEBUG as DEBUG };
 }
 
+declare const enum CompileAstFlags {
+    None = 0,
+    RespectImportant = 1
+}
 type DesignSystem = {
     theme: Theme;
     utilities: Utilities;
@@ -25,48 +30,141 @@ type DesignSystem = {
     getVariants(): VariantEntry[];
     parseCandidate(candidate: string): Readonly<Candidate>[];
     parseVariant(variant: string): Readonly<Variant> | null;
-    compileAstNodes(candidate: Candidate): ReturnType<typeof compileAstNodes>;
+    compileAstNodes(candidate: Candidate, flags?: CompileAstFlags): ReturnType<typeof compileAstNodes>;
+    printCandidate(candidate: Candidate): string;
+    printVariant(variant: Variant): string;
     getVariantOrder(): Map<Variant, number>;
     resolveThemeValue(path: string, forceInline?: boolean): string | undefined;
     trackUsedVariables(raw: string): void;
+    canonicalizeCandidates(candidates: string[], options?: CanonicalizeOptions): string[];
     candidatesToCss(classes: string[]): (string | null)[];
 };
 
+/**
+ * The source code for one or more nodes in the AST
+ *
+ * This generally corresponds to a stylesheet
+ */
+interface Source {
+    /**
+     * The path to the file that contains the referenced source code
+     *
+     * If this references the *output* source code, this is `null`.
+     */
+    file: string | null;
+    /**
+     * The referenced source code
+     */
+    code: string;
+}
+/**
+ * The file and offsets within it that this node covers
+ *
+ * This can represent either:
+ * - A location in the original CSS which caused this node to be created
+ * - A location in the output CSS where this node resides
+ */
+type SourceLocation = [source: Source, start: number, end: number];
+
+/**
+ * Line offset tables are the key to generating our source maps. They allow us
+ * to store indexes with our AST nodes and later convert them into positions as
+ * when given the source that the indexes refer to.
+ */
+/**
+ * A position in source code
+ *
+ * https://tc39.es/ecma426/#sec-position-record-type
+ */
+interface Position {
+    /** The line number, one-based */
+    line: number;
+    /** The column/character number, one-based */
+    column: number;
+}
+
+interface OriginalPosition extends Position {
+    source: DecodedSource;
+}
+/**
+ * A "decoded" sourcemap
+ *
+ * @see https://tc39.es/ecma426/#decoded-source-map-record
+ */
+interface DecodedSourceMap {
+    file: string | null;
+    sources: DecodedSource[];
+    mappings: DecodedMapping[];
+}
+/**
+ * A "decoded" source
+ *
+ * @see https://tc39.es/ecma426/#decoded-source-record
+ */
+interface DecodedSource {
+    url: string | null;
+    content: string | null;
+    ignore: boolean;
+}
+/**
+ * A "decoded" mapping
+ *
+ * @see https://tc39.es/ecma426/#decoded-mapping-record
+ */
+interface DecodedMapping {
+    originalPosition: OriginalPosition | null;
+    generatedPosition: Position;
+    name: string | null;
+}
+
 type StyleRule = {
     kind: 'rule';
     selector: string;
     nodes: AstNode[];
+    src?: SourceLocation;
+    dst?: SourceLocation;
 };
 type AtRule = {
     kind: 'at-rule';
     name: string;
     params: string;
     nodes: AstNode[];
+    src?: SourceLocation;
+    dst?: SourceLocation;
 };
 type Declaration = {
     kind: 'declaration';
     property: string;
     value: string | undefined;
     important: boolean;
+    src?: SourceLocation;
+    dst?: SourceLocation;
 };
 type Comment = {
     kind: 'comment';
     value: string;
+    src?: SourceLocation;
+    dst?: SourceLocation;
 };
 type Context = {
     kind: 'context';
     context: Record<string, string | boolean>;
     nodes: AstNode[];
+    src?: undefined;
+    dst?: undefined;
 };
 type AtRoot = {
     kind: 'at-root';
     nodes: AstNode[];
+    src?: undefined;
+    dst?: undefined;
 };
 type AstNode = StyleRule | AtRule | Declaration | Comment | Context | AtRoot;
 
 type Resolver = (id: string, base: string) => Promise<string | false | undefined>;
 interface CompileOptions {
     base: string;
+    from?: string;
     onDependency: (path: string) => void;
     shouldRewriteUrls?: boolean;
     polyfills?: Polyfills;
@@ -98,11 +196,13 @@ declare function compile(css: string, options: CompileOptions): Promise<{
     } | null;
     features: Features;
     build(candidates: string[]): string;
+    buildSourceMap(): tailwindcss.DecodedSourceMap;
 }>;
 declare function __unstable__loadDesignSystem(css: string, { base }: {
     base: string;
 }): Promise<DesignSystem>;
 declare function loadModule(id: string, base: string, onDependency: (path: string) => void, customJsResolver?: Resolver): Promise<{
+    path: string;
     base: string;
     module: any;
 }>;
@@ -121,9 +221,32 @@ declare class Instrumentation implements Disposable {
 
 declare function normalizePath(originalPath: string): string;
 
-declare function optimize(input: string, { file, minify }?: {
+interface OptimizeOptions {
+    /**
+     * The file being transformed
+     */
     file?: string;
+    /**
+     * Enabled minified output
+     */
     minify?: boolean;
-}): string;
+    /**
+     * The output source map before optimization
+     *
+     * If omitted a resulting source map will not be available
+     */
+    map?: string;
+}
+interface TransformResult {
+    code: string;
+    map: string | undefined;
+}
+declare function optimize(input: string, { file, minify, map }?: OptimizeOptions): TransformResult;
+
+interface SourceMap {
+    readonly raw: string;
+    readonly inline: string;
+}
+declare function toSourceMap(map: DecodedSourceMap | string): SourceMap;
 
-export { type CompileOptions, Instrumentation, type Resolver, __unstable__loadDesignSystem, compile, compileAst, env, loadModule, normalizePath, optimize };
+export { type CompileOptions, type DecodedSource, type DecodedSourceMap, Instrumentation, type OptimizeOptions, type Resolver, type SourceMap, type TransformResult, __unstable__loadDesignSystem, compile, compileAst, env, loadModule, normalizePath, optimize, toSourceMap };