@schalkneethling/css-property-type-validator-core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Schalk Neethling
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { validateFiles } from "./validate.js";
+export type { RegisteredProperty, SourceLocation, SourcePosition, ValidationDiagnostic, ValidationInput, ValidationResult, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { validateFiles } from "./validate.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,6 @@
+import type { RegisteredProperty, ValidationDiagnostic, ValidationInput } from "./types.js";
+export declare function collectRegistry(inputs: ValidationInput[]): {
+    diagnostics: ValidationDiagnostic[];
+    registry: RegisteredProperty[];
+};
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAoD5F,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG;IAC1D,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACpC,QAAQ,EAAE,kBAAkB,EAAE,CAAC;CAChC,CAyFA"}

package/dist/registry.js

@@ -0,0 +1,121 @@
+import * as cssTree from "css-tree";
+function toBoolean(value) {
+    if (value === "true") {
+        return true;
+    }
+    if (value === "false") {
+        return false;
+    }
+    return undefined;
+}
+function toLocation(loc) {
+    return loc
+        ? {
+            source: loc.source,
+            start: { ...loc.start },
+            end: { ...loc.end },
+        }
+        : null;
+}
+function descriptorMap(block) {
+    const descriptors = new Map();
+    for (const declaration of block?.children ?? []) {
+        descriptors.set(declaration.property, declaration);
+    }
+    return descriptors;
+}
+function getStringDescriptor(declaration) {
+    const firstNode = declaration?.value?.children?.first ?? declaration?.value?.children?.[0];
+    if (firstNode?.type === "String") {
+        return firstNode.value;
+    }
+    return undefined;
+}
+function getRawDescriptor(declaration) {
+    if (!declaration?.value) {
+        return undefined;
+    }
+    return cssTree.generate(declaration.value).trim();
+}
+export function collectRegistry(inputs) {
+    const diagnostics = [];
+    const registry = new Map();
+    for (const input of inputs) {
+        let ast;
+        try {
+            ast = cssTree.parse(input.css, {
+                filename: input.path,
+                positions: true,
+            });
+        }
+        catch (error) {
+            diagnostics.push({
+                code: "unparseable-stylesheet",
+                filePath: input.path,
+                loc: null,
+                message: `Could not parse stylesheet: ${error.message}`,
+            });
+            continue;
+        }
+        cssTree.walk(ast, {
+            visit: "Atrule",
+            enter(node) {
+                if (node.name !== "property") {
+                    return;
+                }
+                const propertyName = node.prelude?.children?.first?.name ?? node.prelude?.children?.[0]?.name;
+                if (!propertyName) {
+                    diagnostics.push({
+                        code: "invalid-property-registration",
+                        filePath: input.path,
+                        loc: toLocation(node.loc),
+                        message: "Found an @property rule without a custom property name.",
+                    });
+                    return;
+                }
+                const descriptors = descriptorMap(node.block);
+                const syntaxDeclaration = descriptors.get("syntax");
+                const syntax = getStringDescriptor(syntaxDeclaration);
+                if (!syntax) {
+                    diagnostics.push({
+                        code: "invalid-property-registration",
+                        filePath: input.path,
+                        loc: toLocation(node.loc),
+                        message: `@property ${propertyName} is missing a valid string-valued syntax descriptor.`,
+                        propertyName,
+                    });
+                    return;
+                }
+                try {
+                    if (syntax !== "*") {
+                        cssTree.definitionSyntax.parse(syntax);
+                    }
+                }
+                catch (error) {
+                    diagnostics.push({
+                        code: "invalid-property-registration",
+                        filePath: input.path,
+                        loc: toLocation(node.loc),
+                        message: `@property ${propertyName} has an invalid syntax descriptor "${syntax}": ${error.message}`,
+                        propertyName,
+                        registeredSyntax: syntax,
+                    });
+                    return;
+                }
+                registry.set(propertyName, {
+                    filePath: input.path,
+                    inherits: toBoolean(getRawDescriptor(descriptors.get("inherits"))),
+                    initialValue: getRawDescriptor(descriptors.get("initial-value")),
+                    loc: toLocation(node.loc),
+                    name: propertyName,
+                    syntax,
+                });
+            },
+        });
+    }
+    return {
+        diagnostics,
+        registry: [...registry.values()],
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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"}

package/dist/syntax-samples.d.ts

@@ -0,0 +1,2 @@
+export declare function buildRepresentativeSamples(syntax: string, definitionSyntax: any): string[];
+//# sourceMappingURL=syntax-samples.d.ts.map

package/dist/syntax-samples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syntax-samples.d.ts","sourceRoot":"","sources":["../src/syntax-samples.ts"],"names":[],"mappings":"AAsGA,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,GAAG,GAAG,MAAM,EAAE,CAO1F"}

package/dist/syntax-samples.js

@@ -0,0 +1,88 @@
+const SIMPLE_TYPE_SAMPLES = {
+    "alpha-value": ["0.5"],
+    angle: ["45deg"],
+    color: ["red"],
+    "custom-ident": ["brand-token"],
+    "custom-property-name": ["--brand-token"],
+    "dashed-ident": ["--brand-token"],
+    flex: ["1"],
+    "font-family": ["serif"],
+    ident: ["token"],
+    image: ['url("image.png")'],
+    integer: ["1"],
+    length: ["1px"],
+    "length-percentage": ["1px", "50%"],
+    number: ["1"],
+    percentage: ["50%"],
+    position: ["center"],
+    ratio: ["16/9"],
+    resolution: ["96dpi"],
+    shadow: ["0 0 1px red"],
+    string: ['"value"'],
+    time: ["1s"],
+    transform: ["translateX(1px)"],
+    "transform-function": ["translateX(1px)"],
+    "transform-list": ["translateX(1px)"],
+    url: ['url("https://example.com/example.png")'],
+};
+function dedupe(values) {
+    return [...new Set(values)];
+}
+function combineTerms(parts, separator) {
+    const samples = parts.map((options) => options[0]).filter(Boolean);
+    return samples.length === parts.length ? [samples.join(separator)] : [];
+}
+function fromFunctionName(name) {
+    if (name === "calc()") {
+        return ["calc(1px + 1px)"];
+    }
+    if (name === "transform-function") {
+        return ["translateX(1px)"];
+    }
+    return [];
+}
+function fromNode(node) {
+    if (!node) {
+        return [];
+    }
+    switch (node.type) {
+        case "Group": {
+            const terms = Array.isArray(node.terms) ? node.terms : [];
+            if (node.combinator === "|") {
+                return dedupe(terms.flatMap(fromNode));
+            }
+            return combineTerms(terms.map(fromNode), node.combinator === "," ? ", " : " ");
+        }
+        case "Multiplier": {
+            const baseSamples = fromNode(node.term);
+            const count = Math.max(node.min ?? 1, 1);
+            if (baseSamples.length === 0) {
+                return [];
+            }
+            // Expand repeatable syntaxes like `<length>{1,4}` into a concrete sample value.
+            // For example: With a baseSample of ["1px"], count of 3, and comma false:
+            // ["1px", "1px", "1px"]
+            return baseSamples.map((sample) => Array.from({ length: count }, () => sample).join(node.comma ? ", " : " "));
+        }
+        case "Keyword":
+            return [node.name];
+        case "Type":
+            return SIMPLE_TYPE_SAMPLES[node.name] ?? fromFunctionName(node.name);
+        case "Property":
+            return SIMPLE_TYPE_SAMPLES[node.name] ?? [];
+        case "Function":
+            return fromFunctionName(node.name);
+        case "String":
+            return [`"${node.value ?? "value"}"`];
+        default:
+            return [];
+    }
+}
+export function buildRepresentativeSamples(syntax, definitionSyntax) {
+    if (syntax === "*") {
+        return ["0"];
+    }
+    const syntaxAst = definitionSyntax.parse(syntax);
+    return dedupe(fromNode(syntaxAst)).slice(0, 8);
+}
+//# sourceMappingURL=syntax-samples.js.map

package/dist/syntax-samples.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syntax-samples.js","sourceRoot":"","sources":["../src/syntax-samples.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,40 @@
+export interface SourcePosition {
+    offset: number;
+    line: number;
+    column: number;
+}
+export interface SourceLocation {
+    source?: string;
+    start: SourcePosition;
+    end: SourcePosition;
+}
+export interface ValidationInput {
+    path: string;
+    css: string;
+}
+export interface RegisteredProperty {
+    filePath: string;
+    inherits?: boolean;
+    initialValue?: string;
+    loc: SourceLocation | null;
+    name: string;
+    syntax: string;
+}
+export type DiagnosticCode = "invalid-property-registration" | "incompatible-var-usage" | "unparseable-stylesheet";
+export interface ValidationDiagnostic {
+    code: DiagnosticCode;
+    filePath: string;
+    loc: SourceLocation | null;
+    message: string;
+    propertyName?: string;
+    registeredSyntax?: string;
+    expectedProperty?: string;
+    snippet?: string;
+}
+export interface ValidationResult {
+    diagnostics: ValidationDiagnostic[];
+    registry: RegisteredProperty[];
+    skippedDeclarations: number;
+    validatedDeclarations: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,cAAc,CAAC;IACtB,GAAG,EAAE,cAAc,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,cAAc,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,cAAc,GACtB,+BAA+B,GAC/B,wBAAwB,GACxB,wBAAwB,CAAC;AAE7B,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,cAAc,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,cAAc,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACpC,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qBAAqB,EAAE,MAAM,CAAC;CAC/B"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/validate.d.ts

@@ -0,0 +1,3 @@
+import type { ValidationInput, ValidationResult } from "./types.js";
+export declare function validateFiles(inputs: ValidationInput[]): ValidationResult;
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAGV,eAAe,EACf,gBAAgB,EACjB,MAAM,YAAY,CAAC;AA+HpB,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,gBAAgB,CAoCzE"}

package/dist/validate.js

@@ -0,0 +1,136 @@
+import * as cssTree from "css-tree";
+import { buildRepresentativeSamples } from "./syntax-samples.js";
+import { collectRegistry } from "./registry.js";
+function toLocation(loc) {
+    return loc
+        ? {
+            source: loc.source,
+            start: { ...loc.start },
+            end: { ...loc.end },
+        }
+        : null;
+}
+function registryMap(registry) {
+    return new Map(registry.map((entry) => [entry.name, entry]));
+}
+function collectVarFunctions(value) {
+    const functions = [];
+    cssTree.walk(value, {
+        visit: "Function",
+        enter(node) {
+            if (node.name === "var") {
+                functions.push(node);
+            }
+        },
+    });
+    return functions;
+}
+function getVarPropertyName(node) {
+    const firstNode = node.children?.first ?? node.children?.[0];
+    return firstNode?.type === "Identifier" ? firstNode.name : undefined;
+}
+function parseValue(value) {
+    try {
+        return cssTree.parse(value, { context: "value" });
+    }
+    catch {
+        return null;
+    }
+}
+function declarationMatchesSample(declaration, varNode, sample) {
+    const valueSource = cssTree.generate(declaration.value);
+    const replacementTarget = cssTree.generate(varNode);
+    const replacedSource = valueSource.replace(replacementTarget, sample);
+    const replacedAst = parseValue(replacedSource);
+    if (!replacedAst) {
+        return false;
+    }
+    const match = cssTree.lexer.matchProperty(declaration.property, replacedAst);
+    return Boolean(match?.matched);
+}
+function validateDeclaration(filePath, declaration, registry) {
+    const diagnostics = [];
+    const varFunctions = collectVarFunctions(declaration.value);
+    // v1 only validates var() consumption sites, not authored values assigned to custom properties.
+    if (varFunctions.length === 0 || declaration.property.startsWith("--")) {
+        return { diagnostics, skipped: 0, validated: 0 };
+    }
+    // Multiple var() usages need coordinated substitution, so we track them as skipped for now.
+    if (varFunctions.length > 1) {
+        return { diagnostics, skipped: 1, validated: 0 };
+    }
+    const varNode = varFunctions[0];
+    const propertyName = getVarPropertyName(varNode);
+    // If the first var() argument is not a custom property name, we cannot resolve it reliably.
+    if (!propertyName) {
+        return { diagnostics, skipped: 1, validated: 0 };
+    }
+    const registration = registry.get(propertyName);
+    // Unregistered custom properties are intentionally ignored in this first version.
+    if (!registration) {
+        return { diagnostics, skipped: 0, validated: 0 };
+    }
+    let samples;
+    try {
+        samples = buildRepresentativeSamples(registration.syntax, cssTree.definitionSyntax);
+    }
+    catch {
+        return { diagnostics, skipped: 1, validated: 0 };
+    }
+    // If we cannot materialize any valid sample values for the registered syntax,
+    // we skip the check.
+    if (samples.length === 0) {
+        return { diagnostics, skipped: 1, validated: 0 };
+    }
+    // A declaration is considered compatible if at least one representative
+    // sample fits the consumer property.
+    const isCompatible = samples.some((sample) => declarationMatchesSample(declaration, varNode, sample));
+    if (!isCompatible) {
+        diagnostics.push({
+            code: "incompatible-var-usage",
+            filePath,
+            loc: toLocation(varNode.loc),
+            message: `Registered property ${propertyName} uses syntax "${registration.syntax}" which is incompatible with ${declaration.property} at this var() usage.`,
+            propertyName,
+            registeredSyntax: registration.syntax,
+            expectedProperty: declaration.property,
+            snippet: cssTree.generate(declaration),
+        });
+    }
+    return { diagnostics, skipped: 0, validated: 1 };
+}
+export function validateFiles(inputs) {
+    const registryResult = collectRegistry(inputs);
+    const diagnostics = [...registryResult.diagnostics];
+    const registry = registryMap(registryResult.registry);
+    let skippedDeclarations = 0;
+    let validatedDeclarations = 0;
+    for (const input of inputs) {
+        let ast;
+        try {
+            ast = cssTree.parse(input.css, {
+                filename: input.path,
+                positions: true,
+            });
+        }
+        catch {
+            continue;
+        }
+        cssTree.walk(ast, {
+            visit: "Declaration",
+            enter(node) {
+                const result = validateDeclaration(input.path, node, registry);
+                diagnostics.push(...result.diagnostics);
+                skippedDeclarations += result.skipped;
+                validatedDeclarations += result.validated;
+            },
+        });
+    }
+    return {
+        diagnostics,
+        registry: registryResult.registry,
+        skippedDeclarations,
+        validatedDeclarations,
+    };
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@schalkneethling/css-property-type-validator-core",
+  "version": "0.1.0",
+  "description": "Standalone CSS custom property type validator core.",
+  "keywords": [
+    "css",
+    "custom-properties",
+    "property",
+    "validator",
+    "design-tokens"
+  ],
+  "license": "MIT",
+  "author": "Schalk Neethling",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/schalkneethling/css-property-type-validator.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/schalkneethling/css-property-type-validator#readme",
+  "bugs": {
+    "url": "https://github.com/schalkneethling/css-property-type-validator/issues"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "css-tree": "^3.2.1"
+  },
+  "devDependencies": {
+    "vitest": "^4.1.2"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json"
+  }
+}