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

package/README.md

@@ -1,58 +1,3 @@
-# @master/css-tooling
+# Temporary Holding Version
 
-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`.
+This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.

package/package.json

@@ -1,127 +1,6 @@
 {
-    "name": "@master/css-tooling",
-    "type": "module",
-    "engines": {
-        "node": "^24"
-    },
-    "license": "MIT",
-    "description": "Rust-backed extraction, scanning, linting, language, validation, and diagnostics sessions for Master CSS",
-    "author": "Aoyue Design LLC.",
-    "homepage": "https://css.master.co",
-    "bugs": {
-        "url": "https://github.com/master-co/css/issues"
-    },
-    "repository": {
-        "type": "git",
-        "url": "https://github.com/master-co/css.git",
-        "directory": "packages/tooling"
-    },
-    "keywords": [
-        "tooling",
-        "scanner",
-        "lint",
-        "language-service",
-        "css",
-        "mastercss"
-    ],
-    "sideEffects": false,
-    "types": "./dist/index.d.ts",
-    "exports": {
-        ".": {
-            "types": "./dist/index.d.ts",
-            "import": "./dist/index.js",
-            "default": "./dist/index.js"
-        },
-        "./node": {
-            "types": "./dist/node.d.ts",
-            "import": "./dist/node.js",
-            "default": "./dist/node.js"
-        },
-        "./lexer": {
-            "types": "./dist/lexer/index.d.ts",
-            "import": "./dist/lexer/index.js",
-            "default": "./dist/lexer/index.js"
-        },
-        "./lexer/node": {
-            "types": "./dist/lexer/node.d.ts",
-            "import": "./dist/lexer/node.js",
-            "default": "./dist/lexer/node.js"
-        },
-        "./source": {
-            "types": "./dist/source/index.d.ts",
-            "import": "./dist/source/index.js",
-            "default": "./dist/source/index.js"
-        },
-        "./source/node": {
-            "types": "./dist/source/node.d.ts",
-            "import": "./dist/source/node.js",
-            "default": "./dist/source/node.js"
-        },
-        "./scanner/node": {
-            "types": "./dist/scanner/node.d.ts",
-            "import": "./dist/scanner/node.js",
-            "default": "./dist/scanner/node.js"
-        },
-        "./validator": {
-            "types": "./dist/validator/index.d.ts",
-            "import": "./dist/validator/index.js",
-            "default": "./dist/validator/index.js"
-        },
-        "./validator/node": {
-            "types": "./dist/validator/node.d.ts",
-            "import": "./dist/validator/node.js",
-            "default": "./dist/validator/node.js"
-        },
-        "./lint": {
-            "types": "./dist/lint/index.d.ts",
-            "import": "./dist/lint/index.js",
-            "default": "./dist/lint/index.js"
-        },
-        "./lint/node": {
-            "types": "./dist/lint/node.d.ts",
-            "import": "./dist/lint/node.js",
-            "default": "./dist/lint/node.js"
-        },
-        "./language": {
-            "types": "./dist/language/index.d.ts",
-            "import": "./dist/language/index.js",
-            "default": "./dist/language/index.js"
-        },
-        "./language/node": {
-            "types": "./dist/language/node.d.ts",
-            "import": "./dist/language/node.js",
-            "default": "./dist/language/node.js"
-        }
-    },
-    "files": [
-        "dist"
-    ],
-    "publishConfig": {
-        "access": "public",
-        "provenance": true
-    },
-    "dependencies": {
-        "@eslint/css-tree": "^4.1.2",
-        "@master/css-binding": "0.0.0-site.1793659883.g69c9aebcf628",
-        "@master/css-schema": "0.0.0-site.1793659883.g69c9aebcf628",
-        "consola": "^3.4.2",
-        "defu": "^6.1.7",
-        "ignore": "^7.0.14",
-        "mdn-data": "^2.37.2",
-        "minimatch": "^10.2.6"
-    },
-    "peerDependencies": {
-        "svelte": ">=4",
-        "vue": ">=3"
-    },
-    "peerDependenciesMeta": {
-        "svelte": {
-            "optional": true
-        },
-        "vue": {
-            "optional": true
-        }
-    },
-    "version": "0.0.0-site.1793659883.g69c9aebcf628",
-    "gitHead": "69c9aebcf628eb529001b9fa1b3536306f1b139e"
-}
+  "name": "@master/css-tooling",
+  "version": "0.0.0-stage",
+  "stub": true,
+  "description": "Temporary package placeholder for staged publishing"
+}

package/dist/browser.d.ts

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

package/dist/browser.js

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

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

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

package/dist/css-tree-version.js

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

package/dist/css.d.ts

@@ -1,32 +0,0 @@
-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

@@ -1,120 +0,0 @@
-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

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

package/dist/immutable.js

@@ -1,7 +0,0 @@
-// 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

@@ -1,3 +0,0 @@
-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

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

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

@@ -1,6 +0,0 @@
-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

@@ -1,8 +0,0 @@
-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

@@ -1,10 +0,0 @@
-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

@@ -1,12 +0,0 @@
-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

@@ -1,12 +0,0 @@
-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

@@ -1,55 +0,0 @@
-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 };