@tailwindcss/node 0.0.0-insiders.25ec6a3 → 0.0.0-insiders.2666194

package/README.md

@@ -13,10 +13,10 @@
 </p>
 
 <p align="center">
-    <a href="https://github.com/tailwindlabs/tailwindcss/actions"><img src="https://img.shields.io/github/actions/workflow/status/tailwindlabs/tailwindcss/ci.yml?branch=next" alt="Build Status"></a>
+    <a href="https://github.com/tailwindlabs/tailwindcss/actions"><img src="https://img.shields.io/github/actions/workflow/status/tailwindlabs/tailwindcss/ci.yml?branch=main" alt="Build Status"></a>
     <a href="https://www.npmjs.com/package/tailwindcss"><img src="https://img.shields.io/npm/dt/tailwindcss.svg" alt="Total Downloads"></a>
-    <a href="https://github.com/tailwindcss/tailwindcss/releases"><img src="https://img.shields.io/npm/v/tailwindcss.svg" alt="Latest Release"></a>
-    <a href="https://github.com/tailwindcss/tailwindcss/blob/master/LICENSE"><img src="https://img.shields.io/npm/l/tailwindcss.svg" alt="License"></a>
+    <a href="https://github.com/tailwindlabs/tailwindcss/releases"><img src="https://img.shields.io/npm/v/tailwindcss.svg" alt="Latest Release"></a>
+    <a href="https://github.com/tailwindlabs/tailwindcss/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/tailwindcss.svg" alt="License"></a>
 </p>
 
 ---
@@ -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)
+[Discuss Tailwind CSS on GitHub](https://github.com/tailwindlabs/tailwindcss/discussions)
 
 ## 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**.
+If you're interested in contributing to Tailwind CSS, please read our [contributing docs](https://github.com/tailwindlabs/tailwindcss/blob/main/.github/CONTRIBUTING.md) **before submitting a pull request**.

package/dist/esm-cache.loader.d.mts

@@ -1,5 +1,6 @@
-import { ResolveHook } from 'node:module';
+import { ResolveHook, ResolveHookSync } from 'node:module';
 
 declare let resolve: ResolveHook;
+declare let resolveSync: ResolveHookSync;
 
-export { resolve };
+export { resolve, resolveSync };

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 p}from"module";var u=async(r,e,t)=>{let o=await t(r,e);return n(e,o)},a=(r,e,t)=>{let o=t(r,e);return n(e,o)};function n(r,e){if(e.url===import.meta.url||p(e.url)||!r.parentURL)return e;let o=new URL(r.parentURL).searchParams.get("id");if(o===null)return e;let l=new URL(e.url);return l.searchParams.set("id",o),{...e,url:`${l}`}}export{u as resolve,a as resolveSync};

package/dist/index.d.mts

@@ -1,9 +1,11 @@
+import { AstNode as AstNode$1 } from './ast';
 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 +16,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 +31,143 @@ 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)[];
+    candidatesToAst(classes: string[]): AstNode$1[][];
+    storage: Record<symbol, unknown>;
 };
 
+/**
+ * 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,22 +199,30 @@ 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;
 }>;
 
 declare class Instrumentation implements Disposable {
     #private;
+    private shouldReport;
     private defaultFlush;
-    constructor(defaultFlush?: (message: string) => undefined);
+    constructor(shouldReport?: boolean, defaultFlush?: (message: string) => undefined);
     hit(label: string): void;
     start(label: string): void;
     end(label: string): void;
+    track(label: string): {
+        [Symbol.dispose]: () => void;
+        [Symbol.asyncDispose]: () => void;
+    };
+    span<T>(label: string, fn: () => T): T;
     reset(): void;
     report(flush?: (message: string) => undefined): void;
     [Symbol.dispose](): void;
@@ -121,9 +230,33 @@ 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;
+    comment(url: string): 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,11 @@
+import { AstNode as AstNode$1 } from './ast';
 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 +16,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 +31,143 @@ 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)[];
+    candidatesToAst(classes: string[]): AstNode$1[][];
+    storage: Record<symbol, unknown>;
 };
 
+/**
+ * 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,22 +199,30 @@ 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;
 }>;
 
 declare class Instrumentation implements Disposable {
     #private;
+    private shouldReport;
     private defaultFlush;
-    constructor(defaultFlush?: (message: string) => undefined);
+    constructor(shouldReport?: boolean, defaultFlush?: (message: string) => undefined);
     hit(label: string): void;
     start(label: string): void;
     end(label: string): void;
+    track(label: string): {
+        [Symbol.dispose]: () => void;
+        [Symbol.asyncDispose]: () => void;
+    };
+    span<T>(label: string, fn: () => T): T;
     reset(): void;
     report(flush?: (message: string) => undefined): void;
     [Symbol.dispose](): void;
@@ -121,9 +230,33 @@ 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;
+    comment(url: string): 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 };