@master/css-tooling 0.0.0-site.1793659883.g69c9aebcf628

package/README.md

@@ -0,0 +1,58 @@
+# @master/css-tooling
+
+Rust-backed extraction and developer tooling for Master CSS.
+
+## Installation
+
+```bash
+npm install @master/css-tooling
+```
+
+The package groups related tooling responsibilities behind explicit subpaths:
+
+```ts
+import { createToolingSession } from '@master/css-tooling'
+import { analyzeClassList } from '@master/css-tooling/lexer'
+import { extractSource } from '@master/css-tooling/source'
+import { validateClassNames } from '@master/css-tooling/validator'
+import { lintClassNames } from '@master/css-tooling/lint'
+import { analyzeDocument } from '@master/css-tooling/language'
+import { MasterCSSScanner } from '@master/css-tooling/scanner/node'
+```
+
+Every semantic operation requires an explicit manifest. Use
+`createToolingSession({ manifest })` to share one binding/cache across validator,
+lint, and language operations. Feature subpaths provide async one-shot APIs; their
+`./node` entries provide native synchronous counterparts with a `Sync` suffix.
+`MasterCSSScanner` is available only from `./scanner/node` and owns filesystem/watch
+graph lifecycle.
+
+Both language sessions and composite tooling sessions expose `tokenFamilies()`.
+The readonly result is `{ version, families }`, derived from the active manifest's
+loaded utilities. Each family has `utility`, `prefix`, `namespace`, `properties`, and
+`argument: 'value' | 'key'`. Definitions are included even without current token
+values; class completions still require tokens. Direct-value families forward a
+CSS value, while string recipes receive a token key. Theme-only manifests must
+load or define utilities explicitly.
+
+`scanner.scanSource(source, content)` uses the same built-in adapters and Rust
+scanner as `scan`, returning a `MasterCSSScannerSourceResult` with `changed` and
+all `candidates` extracted from that input. Candidates include repeated classes,
+cache hits and blocklisted candidates; they are source occurrences, not a list of
+newly generated rules. Use the scanner state for final classification. `scan` and
+`scanModule` continue to return a boolean indicating a scanner change.
+
+For host parsers that decode enclosing HTML before parsing expressions,
+`session.decodeHTMLAttribute(source)` decodes attribute contents without their
+delimiters and returns `{ value, spans }`. Each span maps a decoded UTF-16 `range`
+to its original UTF-16 `sourceRange`; an entire character reference stays one
+indivisible source span. The decoder follows HTML attribute reference rules and
+input newline normalization. `MasterCSSDecodedHTMLAttribute` is available from
+`@master/css-tooling/source`. Both native and tooling-Wasm bindings support this
+operation; older bindings without the mapping response fail explicitly.
+
+Scanner source adapters are first-party implementation details. The package does not
+provide a public third-party adapter registry.
+
+Shiki helpers and the shared TextMate grammar live in
+`@master/css-language-service`.

package/dist/browser.d.ts

@@ -0,0 +1,2 @@
+import { MasterCSSToolingSession, MasterCSSToolingSessionOptions, createToolingSession } from "./tooling-session.js";
+export { MasterCSSToolingSession, type MasterCSSToolingSessionOptions, createToolingSession };

package/dist/browser.js

@@ -0,0 +1 @@
+export { MasterCSSToolingSession, createToolingSession } from "./tooling-session.js";

package/dist/css-tree-version.d.ts

@@ -0,0 +1,2 @@
+declare const cssTreeVersion: string;
+export { cssTreeVersion };

package/dist/css-tree-version.js

@@ -0,0 +1,4 @@
+import * as cssTree from "@eslint/css-tree";
+// src/css-tree-version.ts
+const cssTreeVersion = cssTree.version;
+export { cssTreeVersion };

package/dist/css.d.ts

@@ -0,0 +1,32 @@
+import { SyntaxError } from "./validator/types/syntax-error.js";
+declare function validateCSS(text: string, parseOptions?: {
+  parseAtrulePrelude: boolean;
+  parseRulePrelude: boolean;
+  parseValue: boolean;
+  parseCustomProperty: boolean;
+}): any[];
+declare function parseCSSDeclarations(text: string): Record<string, string>;
+declare function isTargetError(error: SyntaxError | null): SyntaxError | null;
+declare function validateAtrule(node: {
+  name: any;
+  prelude: any;
+  block: {
+    children: any[];
+  };
+}, nestedInRule?: boolean): (SyntaxError & {
+  atrule: any;
+})[];
+declare function validateAtrulePrelude(atrule: string, prelude: any): (SyntaxError & {
+  atrule: string;
+})[];
+declare function validateAtruleDescriptor(atrule: any, descriptor: string, value: any): (SyntaxError & {
+  atrule: any;
+  descriptor: string;
+})[];
+declare function validateDeclaration(property: string, value: any): any[];
+declare function validateRule(node: {
+  block: {
+    children: any[];
+  };
+}): any[];
+export { isTargetError, parseCSSDeclarations, validateAtrule, validateAtruleDescriptor, validateAtrulePrelude, validateCSS, validateDeclaration, validateRule };

package/dist/css.js

@@ -0,0 +1,120 @@
+import { generate, lexer, parse, property, walk } from "@eslint/css-tree";
+// src/css.ts
+function validateCSS(text, parseOptions = {
+	parseAtrulePrelude: false,
+	parseRulePrelude: false,
+	parseValue: false,
+	parseCustomProperty: false
+}) {
+	const errors = [];
+	const ast = parse(text, {
+		...parseOptions,
+		onParseError(error) {
+			errors.push(error);
+		}
+	});
+	walk(ast, {
+		visit: "Atrule",
+		enter(node) {
+			errors.push(...validateAtrule(node, !!this.rule));
+		}
+	});
+	walk(ast, {
+		visit: "Rule",
+		enter(node) {
+			errors.push(...validateRule(node));
+		}
+	});
+	return errors;
+}
+function parseCSSDeclarations(text) {
+	const declarations = {};
+	const ast = parse(text, { positions: true });
+	walk(ast, {
+		visit: "Declaration",
+		enter(node) {
+			const value = node.value.loc ? text.slice(node.value.loc.start.offset, node.value.loc.end.offset) : generate(node.value);
+			declarations[node.property] = node.important ? `${value}!important` : value;
+		}
+	});
+	return declarations;
+}
+function isTargetError(error) {
+	if (!error) return null;
+	if (error.name === "UnsupportedMatchingTree") return null;
+	if (error.name !== "SyntaxError" && error.name !== "SyntaxMatchError" && error.name !== "SyntaxReferenceError") return null;
+	return error;
+}
+function validateAtrule(node, nestedInRule = false) {
+	const atrule = node.name;
+	const errors = [];
+	let error;
+	if (error = isTargetError(lexer.checkAtruleName(atrule))) {
+		errors.push(Object.assign(error, { atrule }));
+		return errors;
+	}
+	errors.push(...validateAtrulePrelude(atrule, node.prelude));
+	if (node.block && node.block.children) node.block.children.forEach((child) => {
+		if (child.type === "Declaration") errors.push(...nestedInRule && [
+			"media",
+			"supports",
+			"container",
+			"layer",
+			"scope",
+			"starting-style"
+		].includes(atrule.toLowerCase()) ? validateDeclaration(child.property, child.value) : validateAtruleDescriptor(atrule, child.property, child.value));
+	});
+	return errors;
+}
+function validateAtrulePrelude(atrule, prelude) {
+	const errors = [];
+	let error;
+	if (error = isTargetError(lexer.checkAtrulePrelude(atrule, prelude))) errors.push(Object.assign(error, { atrule }));
+	else if (error = isTargetError(lexer.matchAtrulePrelude(atrule, prelude).error)) errors.push(Object.assign(error, {
+		atrule,
+		...error.rawMessage === "Mismatch" && {
+			details: error.message,
+			message: "Invalid value for `@" + atrule + "` prelude"
+		}
+	}));
+	return errors;
+}
+function validateAtruleDescriptor(atrule, descriptor, value) {
+	const errors = [];
+	let error;
+	if (error = isTargetError(lexer.checkAtruleDescriptorName(atrule, descriptor))) errors.push(Object.assign(error, {
+		atrule,
+		descriptor
+	}));
+	else if (error = isTargetError(lexer.matchAtruleDescriptor(atrule, descriptor, value).error)) errors.push(Object.assign(error, {
+		atrule,
+		descriptor,
+		...error.rawMessage === "Mismatch" && {
+			details: error.message,
+			message: "Invalid value for `" + descriptor + "` descriptor"
+		}
+	}));
+	return errors;
+}
+function validateDeclaration(property$1, value) {
+	const errors = [];
+	let error;
+	if (property(property$1).custom) return errors;
+	if (error = isTargetError(lexer.checkPropertyName(property$1))) errors.push(Object.assign(error, { property: property$1 }));
+	else if (error = isTargetError(lexer.matchProperty(property$1, value).error)) errors.push(Object.assign(error, {
+		property: property$1,
+		...error.rawMessage === "Mismatch" && {
+			details: error.message,
+			message: "Invalid value for `" + property$1 + "` property"
+		}
+	}));
+	return errors;
+}
+function validateRule(node) {
+	const errors = [];
+	if (node.block && node.block.children) node.block.children.forEach((child) => {
+		if (child.type === "Declaration") errors.push(...validateDeclaration(child.property, child.value));
+	});
+	return errors;
+}
+export { isTargetError, parseCSSDeclarations, validateAtrule, validateAtruleDescriptor, validateAtrulePrelude, validateCSS, validateDeclaration, validateRule };

package/dist/immutable.d.ts

@@ -0,0 +1,2 @@
+declare function freezeToolingResult<T>(value: T): Readonly<T>;
+export { freezeToolingResult };

package/dist/immutable.js

@@ -0,0 +1,7 @@
+// src/immutable.ts
+function freezeToolingResult(value) {
+	if (value === null || typeof value !== "object" || Object.isFrozen(value)) return value;
+	for (const nested of Object.values(value)) freezeToolingResult(nested);
+	return Object.freeze(value);
+}
+export { freezeToolingResult };

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import { MasterCSSDocumentAnalysis, MasterCSSDocumentAnalysisRequest, MasterCSSFormatDirectivesRequest, MasterCSSFormatDirectivesResult, MasterCSSLanguageClassListContext, MasterCSSLanguageClassPosition, MasterCSSLanguageTokenFamilies, MasterCSSTokenFamily } from "./language/contracts.js";
+import { MasterCSSToolingSession, MasterCSSToolingSessionOptions, createToolingSession } from "./tooling-session.js";
+export { type MasterCSSDocumentAnalysis, type MasterCSSDocumentAnalysisRequest, type MasterCSSFormatDirectivesRequest, type MasterCSSFormatDirectivesResult, type MasterCSSLanguageClassListContext, type MasterCSSLanguageClassPosition, type MasterCSSLanguageTokenFamilies, type MasterCSSTokenFamily, MasterCSSToolingSession, type MasterCSSToolingSessionOptions, createToolingSession };

package/dist/index.js

@@ -0,0 +1 @@
+export { MasterCSSToolingSession, createToolingSession } from "./tooling-session.js";

package/dist/language/binding-session.d.ts

@@ -0,0 +1,6 @@
+import { LanguageSession, bindLanguageSession } from "./session.js";
+import { MasterCSSManifest } from "@master/css-schema/manifest";
+declare function createLanguageSession(manifest: MasterCSSManifest, options?: {
+  readonly binding?: 'auto' | 'native' | 'wasm';
+}): Promise<LanguageSession>;
+export { type LanguageSession, bindLanguageSession, createLanguageSession };

package/dist/language/binding-session.js

@@ -0,0 +1,8 @@
+import { bindLanguageSession } from "./session.js";
+import { createToolingBinding } from "@master/css-binding/tooling";
+// src/language/binding-session.ts
+async function createLanguageSession(manifest, options = {}) {
+	const tooling = await createToolingBinding({ binding: options.binding });
+	return bindLanguageSession(tooling.binding, await tooling.createLanguageSession(manifest));
+}
+export { bindLanguageSession, createLanguageSession };

package/dist/language/browser.d.ts

@@ -0,0 +1,10 @@
+import { SEMANTIC_TOKENS_LEGEND, SEMANTIC_TOKEN_MODIFIERS, SEMANTIC_TOKEN_TYPES } from "./common.js";
+import { LanguageSession } from "./session.js";
+import { MasterCSSWasmBindingLoadOptions } from "@master/css-binding/tooling";
+import { MasterCSSManifest } from "@master/css-schema/manifest";
+interface BrowserLanguageSessionOptions {
+  manifest: MasterCSSManifest;
+  wasm?: MasterCSSWasmBindingLoadOptions;
+}
+declare function createLanguageSession(options: BrowserLanguageSessionOptions): Promise<LanguageSession>;
+export { BrowserLanguageSessionOptions, type LanguageSession, type MasterCSSWasmBindingLoadOptions, SEMANTIC_TOKENS_LEGEND, SEMANTIC_TOKEN_MODIFIERS, SEMANTIC_TOKEN_TYPES, createLanguageSession };

package/dist/language/browser.js

@@ -0,0 +1,12 @@
+import { bindLanguageSession } from "./session.js";
+import { SEMANTIC_TOKENS_LEGEND, SEMANTIC_TOKEN_MODIFIERS, SEMANTIC_TOKEN_TYPES } from "./common.js";
+import { createToolingBinding } from "@master/css-binding/tooling";
+// src/language/browser.ts
+async function createLanguageSession(options) {
+	const tooling = await createToolingBinding({
+		binding: "wasm",
+		wasm: options.wasm
+	});
+	return bindLanguageSession(tooling.binding, await tooling.createLanguageSession(options.manifest));
+}
+export { SEMANTIC_TOKENS_LEGEND, SEMANTIC_TOKEN_MODIFIERS, SEMANTIC_TOKEN_TYPES, createLanguageSession };

package/dist/language/common.d.ts

@@ -0,0 +1,12 @@
+declare const INVOKED_TRIGGER_CHARACTERS: string[];
+declare const VALUE_TRIGGER_CHARACTERS: string[];
+declare const SELECTOR_TRIGGER_CHARACTERS: string[];
+declare const AT_TRIGGER_CHARACTER = "@";
+declare const QUERY_TRIGGER_CHARACTERS: string[];
+declare const SEMANTIC_TOKEN_TYPES: readonly ['class', 'enumMember', 'property', 'variable', 'function', 'number', 'string', 'keyword', 'modifier', 'operator', 'type'];
+declare const SEMANTIC_TOKEN_MODIFIERS: readonly ['declaration', 'defaultLibrary', 'component', 'directive', 'important', 'pseudoClass', 'pseudoElement', 'query', 'quoted', 'selector', 'unit', 'blockBrace', 'declarationSeparator', 'declarationTerminator', 'directiveTerminator', 'functionPunctuation', 'valueSeparator', 'valueOperator', 'queryOperator', 'queryPunctuation', 'selectorCombinator', 'selectorPunctuation', 'pseudoClassDelimiter', 'pseudoElementDelimiter'];
+declare const SEMANTIC_TOKENS_LEGEND: {
+  tokenTypes: ("class" | "enumMember" | "function" | "keyword" | "modifier" | "number" | "operator" | "property" | "string" | "type" | "variable")[];
+  tokenModifiers: ("blockBrace" | "component" | "declaration" | "declarationSeparator" | "declarationTerminator" | "defaultLibrary" | "directive" | "directiveTerminator" | "functionPunctuation" | "important" | "pseudoClass" | "pseudoClassDelimiter" | "pseudoElement" | "pseudoElementDelimiter" | "query" | "queryOperator" | "queryPunctuation" | "quoted" | "selector" | "selectorCombinator" | "selectorPunctuation" | "unit" | "valueOperator" | "valueSeparator")[];
+};
+export { AT_TRIGGER_CHARACTER, INVOKED_TRIGGER_CHARACTERS, QUERY_TRIGGER_CHARACTERS, SELECTOR_TRIGGER_CHARACTERS, SEMANTIC_TOKENS_LEGEND, SEMANTIC_TOKEN_MODIFIERS, SEMANTIC_TOKEN_TYPES, VALUE_TRIGGER_CHARACTERS };

package/dist/language/common.js

@@ -0,0 +1,55 @@
+import { QUERY_COMPARISON_OPERATORS, QUERY_LOGICAL_OPERATORS, SELECTOR_SIGNS } from "./master-css.js";
+// src/language/common.ts
+const INVOKED_TRIGGER_CHARACTERS = [
+	"\"",
+	" ",
+	"'"
+];
+const VALUE_TRIGGER_CHARACTERS = [",", "|"];
+const SELECTOR_TRIGGER_CHARACTERS = SELECTOR_SIGNS;
+const AT_TRIGGER_CHARACTER = "@";
+const QUERY_TRIGGER_CHARACTERS = [...QUERY_COMPARISON_OPERATORS, ...QUERY_LOGICAL_OPERATORS];
+const SEMANTIC_TOKEN_TYPES = [
+	"class",
+	"enumMember",
+	"property",
+	"variable",
+	"function",
+	"number",
+	"string",
+	"keyword",
+	"modifier",
+	"operator",
+	"type"
+];
+const SEMANTIC_TOKEN_MODIFIERS = [
+	"declaration",
+	"defaultLibrary",
+	"component",
+	"directive",
+	"important",
+	"pseudoClass",
+	"pseudoElement",
+	"query",
+	"quoted",
+	"selector",
+	"unit",
+	"blockBrace",
+	"declarationSeparator",
+	"declarationTerminator",
+	"directiveTerminator",
+	"functionPunctuation",
+	"valueSeparator",
+	"valueOperator",
+	"queryOperator",
+	"queryPunctuation",
+	"selectorCombinator",
+	"selectorPunctuation",
+	"pseudoClassDelimiter",
+	"pseudoElementDelimiter"
+];
+const SEMANTIC_TOKENS_LEGEND = {
+	tokenTypes: [...SEMANTIC_TOKEN_TYPES],
+	tokenModifiers: [...SEMANTIC_TOKEN_MODIFIERS]
+};
+export { AT_TRIGGER_CHARACTER, INVOKED_TRIGGER_CHARACTERS, QUERY_TRIGGER_CHARACTERS, SELECTOR_TRIGGER_CHARACTERS, SEMANTIC_TOKENS_LEGEND, SEMANTIC_TOKEN_MODIFIERS, SEMANTIC_TOKEN_TYPES, VALUE_TRIGGER_CHARACTERS };

package/dist/language/contracts.d.ts

@@ -0,0 +1,197 @@
+import { CSS_VALUE_CHECK, DeclarationValidation } from "../value-validation.js";
+import { CSS_SYNTAX_CHECK } from "../syntax-validation.js";
+import { SemanticTokenItem } from "./semantic/types.js";
+import { MasterCSSLanguageInspection as MasterCSSLanguageInspection$1, MasterCSSLanguageTokenFamilies, MasterCSSTokenFamily } from "@master/css-binding/tooling";
+import { MasterCSSScopedThemeValue } from "@master/css-schema/manifest";
+import { MasterCSSHydrationRule } from "@master/css-schema/hydration-manifest";
+type MasterCSSLanguageClassKind = 'unknown' | 'component' | 'semantic' | 'utility' | 'declaration' | 'token';
+interface MasterCSSLanguageClassListContext {
+  readonly start: number;
+  readonly end: number;
+  readonly unescape?: readonly string[];
+}
+interface MasterCSSLanguageClassPosition {
+  readonly range: Readonly<{
+    start: number;
+    end: number;
+  }>;
+  readonly contextRange: Readonly<{
+    start: number;
+    end: number;
+  }>;
+  readonly raw: string;
+  readonly token: string;
+}
+interface MasterCSSDocumentAnalysisRequest {
+  readonly source: string;
+  readonly languageId: string;
+  readonly hostRanges?: readonly MasterCSSLanguageClassListContext[];
+  readonly settings?: Readonly<{
+    classAttributes?: readonly string[];
+    classFunctions?: readonly string[];
+    classDeclarations?: readonly string[];
+  }>;
+}
+interface MasterCSSDocumentAnalysis {
+  readonly version: 6;
+  readonly classPositions: readonly MasterCSSLanguageClassPosition[];
+  readonly keyframePositions: readonly MasterCSSLanguageClassPosition[];
+  readonly diagnostics: readonly import('@master/css-binding/tooling').MasterCSSDiagnostic[];
+  readonly semanticTokens: readonly SemanticTokenItem[];
+  readonly semanticTokenData: readonly number[];
+}
+interface MasterCSSNativeDeclarationCompletionRequest extends MasterCSSDocumentAnalysisRequest {
+  /** The UTF-16 cursor offset in the source. */
+  readonly offset: number;
+}
+/** The completion context of a cursor inside a `(property:value)` class head. */
+interface MasterCSSNativeDeclarationCompletion {
+  readonly version: number;
+  /** `none` is a string, comment, URL or nested function or block, where nothing completes. */
+  readonly kind: 'property' | 'value' | 'none';
+  /** The property of a value context. */
+  readonly property?: string;
+  /** The class text of the component before the cursor. */
+  readonly prefix: string;
+  /** The source range a completion replaces, including the component's rest after the cursor. */
+  readonly range?: Readonly<{
+    start: number;
+    end: number;
+  }>;
+  /** Text a completion must end with, such as the `)` an unclosed head lacks. */
+  readonly suffix?: string;
+}
+interface MasterCSSFormatDirectivesRequest {
+  readonly source: string;
+  readonly range?: Readonly<{
+    start: number;
+    end: number;
+  }>;
+  readonly styleRanges?: readonly Readonly<{
+    start: number;
+    end: number;
+  }>[];
+}
+interface MasterCSSFormatDirectivesResult {
+  readonly version: 6;
+  readonly edits: readonly Readonly<{
+    range: Readonly<{
+      start: number;
+      end: number;
+    }>;
+    text: string;
+  }>[];
+}
+interface MasterCSSLanguageClass {
+  readonly className: string;
+  readonly kind: MasterCSSLanguageClassKind;
+  readonly matcherTypes: readonly ('static' | 'key' | 'token' | 'function')[];
+  readonly keyToken?: string;
+  readonly valueToken?: string;
+  readonly stateToken?: string;
+  readonly important: boolean;
+}
+interface MasterCSSLanguageClassifications {
+  readonly version: 6;
+  readonly variableNames: readonly string[];
+  readonly classes: readonly MasterCSSLanguageClass[];
+}
+interface MasterCSSLanguageVariable {
+  readonly namespace?: string;
+  readonly name: string;
+  readonly key: string;
+  readonly type: string;
+  readonly values: readonly MasterCSSScopedThemeValue[];
+  readonly dependencies?: readonly string[];
+}
+interface MasterCSSLanguageClassVariable {
+  readonly key: string;
+  readonly variable: MasterCSSLanguageVariable;
+}
+interface MasterCSSLanguageInspection {
+  readonly version: 6;
+  readonly className: string;
+  readonly definitionSource?: MasterCSSLanguageInspection$1['definitionSource'];
+  readonly matchStatus: MasterCSSLanguageInspection$1['matchStatus'];
+  readonly declarations: readonly DeclarationValidation[];
+  readonly checks: readonly (typeof CSS_VALUE_CHECK | typeof CSS_SYNTAX_CHECK)[];
+  readonly cssSyntaxStatus: MasterCSSLanguageInspection$1['cssSyntaxStatus'];
+  readonly cssValueStatus: MasterCSSLanguageInspection$1['cssValueStatus'];
+  readonly browserSupport: MasterCSSLanguageInspection$1['browserSupport'];
+  readonly kind: MasterCSSLanguageClassKind;
+  readonly base: string;
+  readonly suffix: string;
+  readonly key?: string;
+  readonly value?: string;
+  readonly keyToken?: string;
+  readonly valueToken?: string;
+  readonly stateToken?: string;
+  readonly important: boolean;
+  readonly matcherTypes: readonly ('static' | 'key' | 'token' | 'function')[];
+  readonly variables: readonly MasterCSSLanguageClassVariable[];
+  readonly rules: readonly MasterCSSHydrationRule[];
+  readonly diagnostics?: MasterCSSLanguageInspection$1['diagnostics'];
+  readonly text: string;
+}
+type MasterCSSLanguageCompletionKind = 'property' | 'value' | 'function';
+interface MasterCSSLanguageCompletionEntry {
+  readonly label: string;
+  readonly kind: MasterCSSLanguageCompletionKind;
+  readonly detail?: string;
+  readonly documentationText?: string;
+  readonly sortText?: string;
+  readonly insertText?: string;
+  readonly triggerSuggest: boolean;
+}
+interface MasterCSSLanguageCompletionIndex {
+  readonly version: 6;
+  readonly classEntries: readonly MasterCSSLanguageCompletionEntry[];
+  readonly keyframes: readonly Readonly<{
+    name: string;
+    insertText: string;
+    text: string;
+    sources: readonly NonNullable<MasterCSSLanguageInspection$1['definitionSource']>[];
+  }>[];
+}
+interface MasterCSSLanguageColorPresentation {
+  readonly version: 6;
+  readonly editable: boolean;
+  readonly replacementPrefix?: string;
+  /** Text after the color, such as the `)` closing a `(property:` replacement prefix. */
+  readonly replacementSuffix?: string;
+  readonly colorToken: string;
+  readonly sourceFormat?: MasterCSSLanguageColorFormat;
+}
+interface MasterCSSLanguageColorFormat {
+  readonly syntax: string;
+  readonly space?: string;
+}
+interface MasterCSSLanguageColorCandidate {
+  readonly className: string;
+  readonly start: number;
+}
+interface MasterCSSLanguageColorToken {
+  readonly range: Readonly<{
+    start: number;
+    end: number;
+  }>;
+  readonly expression: MasterCSSLanguageColorExpression;
+}
+type MasterCSSLanguageColorExpression = Readonly<{
+  kind: 'literal';
+  value: string;
+  alpha?: number;
+}> | Readonly<{
+  kind: 'mix';
+  space: string;
+  hue?: string;
+  left: MasterCSSLanguageColorExpression;
+  right: MasterCSSLanguageColorExpression;
+  progress: number;
+  alphaMultiplier: number;
+}>;
+interface MasterCSSLanguageColorTokens {
+  readonly version: 6;
+  readonly tokens: readonly MasterCSSLanguageColorToken[];
+}
+export { MasterCSSDocumentAnalysis, MasterCSSDocumentAnalysisRequest, MasterCSSFormatDirectivesRequest, MasterCSSFormatDirectivesResult, MasterCSSLanguageClass, MasterCSSLanguageClassKind, MasterCSSLanguageClassListContext, MasterCSSLanguageClassPosition, MasterCSSLanguageClassVariable, MasterCSSLanguageClassifications, MasterCSSLanguageColorCandidate, MasterCSSLanguageColorExpression, MasterCSSLanguageColorFormat, MasterCSSLanguageColorPresentation, MasterCSSLanguageColorToken, MasterCSSLanguageColorTokens, MasterCSSLanguageCompletionEntry, MasterCSSLanguageCompletionIndex, MasterCSSLanguageCompletionKind, MasterCSSLanguageInspection, type MasterCSSLanguageTokenFamilies, MasterCSSLanguageVariable, MasterCSSNativeDeclarationCompletion, MasterCSSNativeDeclarationCompletionRequest, type MasterCSSTokenFamily };

package/dist/language/contracts.js

@@ -0,0 +1 @@
+export {};

package/dist/language/index.d.ts

@@ -0,0 +1,29 @@
+import { AT_TRIGGER_CHARACTER, INVOKED_TRIGGER_CHARACTERS, QUERY_TRIGGER_CHARACTERS, SELECTOR_TRIGGER_CHARACTERS, SEMANTIC_TOKENS_LEGEND, SEMANTIC_TOKEN_MODIFIERS, SEMANTIC_TOKEN_TYPES, VALUE_TRIGGER_CHARACTERS } from "./common.js";
+import { HighlightTokenRole, SemanticTokenItem, SemanticTokenModifier, SemanticTokenType } from "./semantic/types.js";
+import { MasterCSSDocumentAnalysis, MasterCSSDocumentAnalysisRequest, MasterCSSFormatDirectivesRequest, MasterCSSFormatDirectivesResult, MasterCSSLanguageClass, MasterCSSLanguageClassKind, MasterCSSLanguageClassListContext, MasterCSSLanguageClassPosition, MasterCSSLanguageClassVariable, MasterCSSLanguageClassifications, MasterCSSLanguageColorCandidate, MasterCSSLanguageColorExpression, MasterCSSLanguageColorFormat, MasterCSSLanguageColorPresentation, MasterCSSLanguageColorToken, MasterCSSLanguageColorTokens, MasterCSSLanguageCompletionEntry, MasterCSSLanguageCompletionIndex, MasterCSSLanguageCompletionKind, MasterCSSLanguageInspection, MasterCSSLanguageTokenFamilies, MasterCSSLanguageVariable, MasterCSSNativeDeclarationCompletion, MasterCSSNativeDeclarationCompletionRequest, MasterCSSTokenFamily } from "./contracts.js";
+import { LanguageSession } from "./session.js";
+import { AT_SIGN, CLASS_ATTRIBUTES, CLASS_DECLARATIONS, CLASS_FUNCTIONS, DELIMITER_SIGN, QUERY_COMPARISON_OPERATORS, QUERY_LOGICAL_OPERATORS, SELECTOR_SIGNS, SEPARATOR_SIGN, matchesLanguageServiceNativeDeclaration } from "./master-css.js";
+import { MASTER_CSS_SEMANTIC_TOKEN_SCOPE_MAP, getMasterCSSSemanticTokenScopeKeys } from "./semantic/scopes.js";
+import { MasterCSSBinding } from "@master/css-binding";
+import { MasterCSSManifest } from "@master/css-schema/manifest";
+/**
+ * Create a reusable language-only session using a native or Wasm binding.
+ * Results are immutable snapshots. Dispose the session when its owner is finished.
+ */
+declare function createLanguageSession(options: {
+  readonly manifest: MasterCSSManifest;
+  readonly binding?: MasterCSSBinding;
+}): Promise<LanguageSession>;
+declare function analyzeDocument(request: MasterCSSDocumentAnalysisRequest, options: {
+  readonly manifest: MasterCSSManifest;
+  readonly binding?: MasterCSSBinding;
+}): Promise<MasterCSSDocumentAnalysis>;
+declare function inspectClassName(className: string, options: {
+  readonly manifest: MasterCSSManifest;
+  readonly binding?: MasterCSSBinding;
+}): Promise<MasterCSSLanguageInspection>;
+declare function formatDirectives(request: MasterCSSFormatDirectivesRequest, options: {
+  readonly manifest: MasterCSSManifest;
+  readonly binding?: MasterCSSBinding;
+}): Promise<MasterCSSFormatDirectivesResult>;
+export { AT_SIGN, AT_TRIGGER_CHARACTER, CLASS_ATTRIBUTES, CLASS_DECLARATIONS, CLASS_FUNCTIONS, DELIMITER_SIGN, type HighlightTokenRole, INVOKED_TRIGGER_CHARACTERS, MASTER_CSS_SEMANTIC_TOKEN_SCOPE_MAP, type MasterCSSDocumentAnalysis, type MasterCSSDocumentAnalysisRequest, type MasterCSSFormatDirectivesRequest, type MasterCSSFormatDirectivesResult, type MasterCSSLanguageClass, type MasterCSSLanguageClassKind, type MasterCSSLanguageClassListContext, type MasterCSSLanguageClassPosition, type MasterCSSLanguageClassVariable, type MasterCSSLanguageClassifications, type MasterCSSLanguageColorCandidate, type MasterCSSLanguageColorExpression, type MasterCSSLanguageColorFormat, type MasterCSSLanguageColorPresentation, type MasterCSSLanguageColorToken, type MasterCSSLanguageColorTokens, type MasterCSSLanguageCompletionEntry, type MasterCSSLanguageCompletionIndex, type MasterCSSLanguageCompletionKind, type MasterCSSLanguageInspection, type LanguageSession as MasterCSSLanguageSession, type MasterCSSLanguageTokenFamilies, type MasterCSSLanguageVariable, type MasterCSSNativeDeclarationCompletion, type MasterCSSNativeDeclarationCompletionRequest, type MasterCSSTokenFamily, QUERY_COMPARISON_OPERATORS, QUERY_LOGICAL_OPERATORS, QUERY_TRIGGER_CHARACTERS, SELECTOR_SIGNS, SELECTOR_TRIGGER_CHARACTERS, SEMANTIC_TOKENS_LEGEND, SEMANTIC_TOKEN_MODIFIERS, SEMANTIC_TOKEN_TYPES, SEPARATOR_SIGN, type SemanticTokenItem, type SemanticTokenModifier, type SemanticTokenType, VALUE_TRIGGER_CHARACTERS, analyzeDocument, createLanguageSession, formatDirectives, getMasterCSSSemanticTokenScopeKeys, inspectClassName, matchesLanguageServiceNativeDeclaration };

package/dist/language/index.js

@@ -0,0 +1,39 @@
+import { bindLanguageSession } from "./session.js";
+import { AT_SIGN, CLASS_ATTRIBUTES, CLASS_DECLARATIONS, CLASS_FUNCTIONS, DELIMITER_SIGN, QUERY_COMPARISON_OPERATORS, QUERY_LOGICAL_OPERATORS, SELECTOR_SIGNS, SEPARATOR_SIGN, matchesLanguageServiceNativeDeclaration } from "./master-css.js";
+import { AT_TRIGGER_CHARACTER, INVOKED_TRIGGER_CHARACTERS, QUERY_TRIGGER_CHARACTERS, SELECTOR_TRIGGER_CHARACTERS, SEMANTIC_TOKENS_LEGEND, SEMANTIC_TOKEN_MODIFIERS, SEMANTIC_TOKEN_TYPES, VALUE_TRIGGER_CHARACTERS } from "./common.js";
+import { MASTER_CSS_SEMANTIC_TOKEN_SCOPE_MAP, getMasterCSSSemanticTokenScopeKeys } from "./semantic/scopes.js";
+import { createToolingBinding } from "@master/css-binding/tooling";
+// src/language/index.ts
+/**
+* Create a reusable language-only session using a native or Wasm binding.
+* Results are immutable snapshots. Dispose the session when its owner is finished.
+*/
+async function createLanguageSession(options) {
+	const binding = await createToolingBinding({ binding: options.binding });
+	return bindLanguageSession(binding.binding, await binding.createLanguageSession(options.manifest));
+}
+async function analyzeDocument(request, options) {
+	const session = await createLanguageSession(options);
+	try {
+		return session.analyzeDocument(request);
+	} finally {
+		session.dispose();
+	}
+}
+async function inspectClassName(className, options) {
+	const session = await createLanguageSession(options);
+	try {
+		return session.inspectClassName(className);
+	} finally {
+		session.dispose();
+	}
+}
+async function formatDirectives(request, options) {
+	const session = await createLanguageSession(options);
+	try {
+		return session.formatDirectives(request);
+	} finally {
+		session.dispose();
+	}
+}
+export { AT_SIGN, AT_TRIGGER_CHARACTER, CLASS_ATTRIBUTES, CLASS_DECLARATIONS, CLASS_FUNCTIONS, DELIMITER_SIGN, INVOKED_TRIGGER_CHARACTERS, MASTER_CSS_SEMANTIC_TOKEN_SCOPE_MAP, QUERY_COMPARISON_OPERATORS, QUERY_LOGICAL_OPERATORS, QUERY_TRIGGER_CHARACTERS, SELECTOR_SIGNS, SELECTOR_TRIGGER_CHARACTERS, SEMANTIC_TOKENS_LEGEND, SEMANTIC_TOKEN_MODIFIERS, SEMANTIC_TOKEN_TYPES, SEPARATOR_SIGN, VALUE_TRIGGER_CHARACTERS, analyzeDocument, createLanguageSession, formatDirectives, getMasterCSSSemanticTokenScopeKeys, inspectClassName, matchesLanguageServiceNativeDeclaration };

package/dist/language/master-css.d.ts

@@ -0,0 +1,13 @@
+declare function matchesLanguageServiceNativeDeclaration({ property }: {
+  property: string;
+}): boolean;
+declare const SELECTOR_SIGNS: string[];
+declare const QUERY_COMPARISON_OPERATORS: string[];
+declare const QUERY_LOGICAL_OPERATORS: string[];
+declare const DELIMITER_SIGN = "|";
+declare const SEPARATOR_SIGN = ",";
+declare const AT_SIGN = "@";
+declare const CLASS_ATTRIBUTES: string[];
+declare const CLASS_DECLARATIONS: string[];
+declare const CLASS_FUNCTIONS: string[];
+export { AT_SIGN, CLASS_ATTRIBUTES, CLASS_DECLARATIONS, CLASS_FUNCTIONS, DELIMITER_SIGN, QUERY_COMPARISON_OPERATORS, QUERY_LOGICAL_OPERATORS, SELECTOR_SIGNS, SEPARATOR_SIGN, matchesLanguageServiceNativeDeclaration };