@knighted/css 1.0.0-rc.1 → 1.0.0-rc.11

package/dist/moduleGraph.js

@@ -0,0 +1,425 @@
+import path from 'node:path';
+import { builtinModules } from 'node:module';
+import { existsSync, promises as fs, statSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { parseSync, Visitor } from 'oxc-parser';
+import { ResolverFactory, } from 'oxc-resolver';
+import { createMatchPath } from 'tsconfig-paths';
+import { getTsconfig } from 'get-tsconfig';
+const SCRIPT_EXTENSIONS = ['.ts', '.tsx', '.mts', '.cts', '.js', '.jsx', '.mjs', '.cjs'];
+const BUILTIN_SPECIFIERS = new Set([
+    ...builtinModules,
+    ...builtinModules.map(mod => `node:${mod}`),
+]);
+const tsconfigResultCache = new Map();
+const tsconfigFsCache = new Map();
+export async function collectStyleImports(entryPath, options) {
+    const { cwd, styleExtensions, filter, resolver, graphOptions } = options;
+    const normalizedStyles = normalizeExtensions(styleExtensions);
+    const scriptExtensions = normalizeExtensions([
+        ...SCRIPT_EXTENSIONS,
+        ...(graphOptions?.extensions ?? []),
+    ]);
+    const resolutionExtensions = dedupeExtensions([
+        ...scriptExtensions,
+        ...normalizedStyles,
+    ]);
+    const tsconfigMatcher = createTsconfigMatcher(graphOptions?.tsConfig, cwd, resolutionExtensions);
+    const seenScripts = new Set();
+    const seenStyles = new Set();
+    const styleOrder = [];
+    const resolutionCache = new Map();
+    const resolverFactory = createResolverFactory(cwd, resolutionExtensions, scriptExtensions, graphOptions);
+    async function walk(filePath) {
+        const absolutePath = path.resolve(filePath);
+        if (seenScripts.has(absolutePath)) {
+            return;
+        }
+        seenScripts.add(absolutePath);
+        const source = await readSourceFile(absolutePath);
+        if (!source) {
+            return;
+        }
+        const specifiers = extractModuleSpecifiers(source, absolutePath);
+        for (const specifier of specifiers) {
+            if (!specifier || isBuiltinSpecifier(specifier)) {
+                continue;
+            }
+            const resolved = await resolveImport(specifier, absolutePath);
+            if (!resolved) {
+                continue;
+            }
+            const normalized = path.resolve(resolved);
+            if (!filter(normalized)) {
+                continue;
+            }
+            if (isStyleExtension(normalized, normalizedStyles)) {
+                if (!seenStyles.has(normalized)) {
+                    seenStyles.add(normalized);
+                    styleOrder.push(normalized);
+                }
+                continue;
+            }
+            if (isScriptExtension(normalized, scriptExtensions)) {
+                await walk(normalized);
+            }
+        }
+    }
+    async function resolveImport(specifier, importer) {
+        const cacheKey = `${importer}::${specifier}`;
+        if (resolutionCache.has(cacheKey)) {
+            return resolutionCache.get(cacheKey);
+        }
+        let resolved;
+        if (resolver) {
+            resolved = normalizeResolverResult(await resolver(specifier, { cwd, from: importer }), cwd);
+        }
+        if (!resolved && tsconfigMatcher) {
+            resolved = tsconfigMatcher(specifier);
+        }
+        if (!resolved) {
+            resolved = resolveWithFactory(resolverFactory, specifier, importer, resolutionExtensions);
+        }
+        resolutionCache.set(cacheKey, resolved);
+        return resolved;
+    }
+    await walk(entryPath);
+    return styleOrder;
+}
+function normalizeExtensions(extensions) {
+    const result = new Set();
+    for (const ext of extensions) {
+        if (!ext)
+            continue;
+        const normalized = ext.startsWith('.') ? ext.toLowerCase() : `.${ext.toLowerCase()}`;
+        result.add(normalized);
+    }
+    return Array.from(result);
+}
+function dedupeExtensions(extensions) {
+    const result = new Set();
+    for (const ext of extensions) {
+        result.add(ext);
+    }
+    return Array.from(result);
+}
+function isBuiltinSpecifier(specifier) {
+    if (BUILTIN_SPECIFIERS.has(specifier)) {
+        return true;
+    }
+    if (specifier.startsWith('node:')) {
+        return true;
+    }
+    return false;
+}
+function isStyleExtension(filePath, extensions) {
+    const lower = filePath.toLowerCase();
+    return extensions.some(ext => lower.endsWith(ext));
+}
+function isScriptExtension(filePath, extensions) {
+    const ext = path.extname(filePath).toLowerCase();
+    return extensions.includes(ext);
+}
+async function readSourceFile(filePath) {
+    try {
+        return await fs.readFile(filePath, 'utf8');
+    }
+    catch {
+        return undefined;
+    }
+}
+function extractModuleSpecifiers(sourceText, filePath) {
+    let program;
+    try {
+        ;
+        ({ program } = parseSync(filePath, sourceText, { sourceType: 'unambiguous' }));
+    }
+    catch {
+        return [];
+    }
+    const specifiers = [];
+    const addSpecifier = (raw) => {
+        if (!raw) {
+            return;
+        }
+        const normalized = normalizeSpecifier(raw);
+        if (normalized) {
+            specifiers.push(normalized);
+        }
+    };
+    const visitor = new Visitor({
+        ImportDeclaration(node) {
+            addSpecifier(node.source?.value);
+        },
+        ExportNamedDeclaration(node) {
+            if (node.source) {
+                addSpecifier(node.source.value);
+            }
+        },
+        ExportAllDeclaration(node) {
+            addSpecifier(node.source?.value);
+        },
+        TSImportEqualsDeclaration(node) {
+            const specifier = extractImportEqualsSpecifier(node);
+            if (specifier) {
+                addSpecifier(specifier);
+            }
+        },
+        ImportExpression(node) {
+            const specifier = getStringFromExpression(node.source);
+            if (specifier) {
+                addSpecifier(specifier);
+            }
+        },
+        CallExpression(node) {
+            if (!isRequireLikeCallee(node.callee)) {
+                return;
+            }
+            const specifier = getStringFromArgument(node.arguments[0]);
+            if (specifier) {
+                addSpecifier(specifier);
+            }
+        },
+    });
+    visitor.visit(program);
+    return specifiers;
+}
+function normalizeSpecifier(raw) {
+    if (!raw)
+        return '';
+    const trimmed = raw.trim();
+    if (!trimmed || trimmed.startsWith('\0')) {
+        return '';
+    }
+    const queryIndex = trimmed.search(/[?#]/);
+    const withoutQuery = queryIndex === -1 ? trimmed : trimmed.slice(0, queryIndex);
+    if (!withoutQuery) {
+        return '';
+    }
+    if (/^[a-z][\w+.-]*:/i.test(withoutQuery) && !withoutQuery.startsWith('file:')) {
+        return '';
+    }
+    return withoutQuery;
+}
+function extractImportEqualsSpecifier(node) {
+    if (node.moduleReference.type === 'TSExternalModuleReference') {
+        return node.moduleReference.expression.value;
+    }
+    return undefined;
+}
+function getStringFromArgument(argument) {
+    if (!argument || argument.type === 'SpreadElement') {
+        return undefined;
+    }
+    return getStringFromExpression(argument);
+}
+function getStringFromExpression(expression) {
+    if (!expression) {
+        return undefined;
+    }
+    if (expression.type === 'Literal') {
+        const literalValue = expression.value;
+        return typeof literalValue === 'string' ? literalValue : undefined;
+    }
+    if (expression.type === 'TemplateLiteral' && expression.expressions.length === 0) {
+        const [first] = expression.quasis;
+        return first?.value.cooked ?? first?.value.raw ?? undefined;
+    }
+    return undefined;
+}
+function isRequireLikeCallee(expression) {
+    const target = unwrapExpression(expression);
+    if (target.type === 'Identifier') {
+        return target.name === 'require';
+    }
+    if (target.type === 'MemberExpression') {
+        const object = target.object;
+        if (object.type === 'Identifier') {
+            return object.name === 'require';
+        }
+    }
+    return false;
+}
+function unwrapExpression(expression) {
+    if (expression.type === 'ChainExpression') {
+        const inner = expression.expression;
+        if (inner.type === 'CallExpression') {
+            return unwrapExpression(inner.callee);
+        }
+        return unwrapExpression(inner);
+    }
+    if (expression.type === 'TSNonNullExpression') {
+        return unwrapExpression(expression.expression);
+    }
+    return expression;
+}
+function normalizeResolverResult(result, cwd) {
+    if (!result) {
+        return undefined;
+    }
+    if (result.startsWith('file://')) {
+        try {
+            return fileURLToPath(new URL(result));
+        }
+        catch {
+            return undefined;
+        }
+    }
+    return path.isAbsolute(result) ? result : path.resolve(cwd, result);
+}
+function resolveWithFactory(factory, specifier, importer, extensions) {
+    if (specifier.startsWith('file://')) {
+        try {
+            return findExistingFile(fileURLToPath(new URL(specifier)), extensions);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    if (/^[a-z][\w+.-]*:/i.test(specifier)) {
+        return undefined;
+    }
+    try {
+        const result = factory.resolveFileSync(importer, specifier);
+        return result?.path;
+    }
+    catch {
+        return undefined;
+    }
+}
+function createResolverFactory(cwd, extensions, scriptExtensions, graphOptions) {
+    const options = {
+        extensions,
+        conditionNames: graphOptions?.conditions,
+    };
+    const extensionAlias = buildExtensionAlias(scriptExtensions);
+    if (extensionAlias) {
+        options.extensionAlias = extensionAlias;
+    }
+    const tsconfigOption = resolveResolverTsconfig(graphOptions?.tsConfig, cwd);
+    if (tsconfigOption) {
+        options.tsconfig = tsconfigOption;
+    }
+    return new ResolverFactory(options);
+}
+function buildExtensionAlias(scriptExtensions) {
+    const alias = {};
+    const jsTargets = dedupeExtensions(scriptExtensions.filter(ext => ['.js', '.ts', '.tsx', '.mjs', '.cjs', '.mts', '.cts'].includes(ext)));
+    if (jsTargets.length > 0) {
+        for (const key of ['.js', '.mjs', '.cjs']) {
+            alias[key] = jsTargets;
+        }
+    }
+    const jsxTargets = dedupeExtensions(scriptExtensions.filter(ext => ext === '.jsx' || ext === '.tsx'));
+    if (jsxTargets.length > 0) {
+        alias['.jsx'] = jsxTargets;
+    }
+    return Object.keys(alias).length > 0 ? alias : undefined;
+}
+function resolveResolverTsconfig(input, cwd) {
+    if (!input || typeof input !== 'string') {
+        return undefined;
+    }
+    const resolved = resolveTsconfigPath(input, cwd);
+    if (!resolved) {
+        return undefined;
+    }
+    return { configFile: resolved };
+}
+function createTsconfigMatcher(input, cwd, extensions) {
+    const config = loadTsconfigPaths(input, cwd);
+    if (!config) {
+        return undefined;
+    }
+    const matchPath = createMatchPath(config.absoluteBaseUrl, config.paths);
+    return (specifier) => {
+        const matched = matchPath(specifier, undefined, undefined, extensions);
+        if (!matched) {
+            return undefined;
+        }
+        return findExistingFile(matched, extensions) ?? matched;
+    };
+}
+function loadTsconfigPaths(input, cwd) {
+    if (!input) {
+        return undefined;
+    }
+    if (typeof input === 'string') {
+        const target = path.isAbsolute(input) ? input : path.resolve(cwd, input);
+        const cached = tsconfigResultCache.get(target);
+        if (cached !== undefined) {
+            return cached ?? undefined;
+        }
+        const result = getTsconfig(target, undefined, tsconfigFsCache);
+        if (!result) {
+            tsconfigResultCache.set(target, null);
+            return undefined;
+        }
+        const normalized = normalizeTsconfigCompilerOptions(result.config.compilerOptions, path.dirname(result.path));
+        tsconfigResultCache.set(target, normalized ?? null);
+        return normalized;
+    }
+    const compilerOptions = input.compilerOptions;
+    return normalizeTsconfigCompilerOptions(compilerOptions, cwd);
+}
+function normalizeTsconfigCompilerOptions(compilerOptions, configDir) {
+    if (!compilerOptions?.baseUrl || !compilerOptions.paths) {
+        return undefined;
+    }
+    const normalizedPaths = {};
+    for (const [pattern, replacements] of Object.entries(compilerOptions.paths)) {
+        if (!replacements || replacements.length === 0) {
+            continue;
+        }
+        normalizedPaths[pattern] = Array.isArray(replacements)
+            ? [...replacements]
+            : [replacements];
+    }
+    if (Object.keys(normalizedPaths).length === 0) {
+        return undefined;
+    }
+    const absoluteBaseUrl = path.isAbsolute(compilerOptions.baseUrl)
+        ? compilerOptions.baseUrl
+        : path.resolve(configDir, compilerOptions.baseUrl);
+    return { absoluteBaseUrl, paths: normalizedPaths };
+}
+function resolveTsconfigPath(tsconfigPath, cwd) {
+    const absolute = path.isAbsolute(tsconfigPath)
+        ? tsconfigPath
+        : path.resolve(cwd, tsconfigPath);
+    if (!existsSync(absolute)) {
+        return undefined;
+    }
+    const stats = statSync(absolute);
+    if (stats.isDirectory()) {
+        const candidate = path.join(absolute, 'tsconfig.json');
+        return existsSync(candidate) ? candidate : undefined;
+    }
+    return absolute;
+}
+function findExistingFile(candidate, extensions) {
+    const candidateHasExt = hasExtension(candidate);
+    if (candidateHasExt && existsSync(candidate)) {
+        return candidate;
+    }
+    if (!candidateHasExt) {
+        for (const ext of extensions) {
+            const withExt = `${candidate}${ext}`;
+            if (existsSync(withExt)) {
+                return withExt;
+            }
+        }
+    }
+    if (existsSync(candidate) && statSync(candidate).isDirectory()) {
+        for (const ext of extensions) {
+            const indexPath = path.join(candidate, `index${ext}`);
+            if (existsSync(indexPath)) {
+                return indexPath;
+            }
+        }
+    }
+    return undefined;
+}
+function hasExtension(filePath) {
+    return Boolean(path.extname(filePath));
+}

package/dist/moduleInfo.d.ts

@@ -0,0 +1,10 @@
+import { parse } from 'es-module-lexer';
+export type ModuleDefaultSignal = 'has-default' | 'no-default' | 'unknown';
+type LexerOverrides = {
+    parse?: typeof parse;
+};
+export declare function detectModuleDefaultExport(filePath: string): Promise<ModuleDefaultSignal>;
+export declare const __moduleInfoInternals: {
+    setLexerOverrides(overrides?: LexerOverrides): void;
+};
+export {};

package/dist/moduleInfo.js

@@ -0,0 +1,55 @@
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { init, parse } from 'es-module-lexer';
+const DETECTABLE_EXTENSIONS = new Set([
+    '.js',
+    '.jsx',
+    '.ts',
+    '.tsx',
+    '.mjs',
+    '.mts',
+    '.cjs',
+    '.cts',
+]);
+let lexerInit;
+let lexerOverrides;
+function ensureLexerInitialized() {
+    if (!lexerInit) {
+        lexerInit = init;
+    }
+    return lexerInit;
+}
+export async function detectModuleDefaultExport(filePath) {
+    if (!DETECTABLE_EXTENSIONS.has(path.extname(filePath))) {
+        return 'unknown';
+    }
+    let source;
+    try {
+        source = await readFile(filePath, 'utf8');
+    }
+    catch {
+        return 'unknown';
+    }
+    try {
+        await ensureLexerInitialized();
+        const [, exports] = (lexerOverrides?.parse ?? parse)(source, filePath);
+        if (exports.some(entry => entry.n === 'default')) {
+            return 'has-default';
+        }
+        if (exports.length === 0) {
+            return 'unknown';
+        }
+        return 'no-default';
+    }
+    catch {
+        return 'unknown';
+    }
+}
+export const __moduleInfoInternals = {
+    setLexerOverrides(overrides) {
+        lexerOverrides = overrides;
+        if (!overrides) {
+            lexerInit = undefined;
+        }
+    },
+};

package/dist/sassInternals.d.ts

@@ -0,0 +1,25 @@
+import type { CssResolver } from './types.js';
+export type { CssResolver } from './types.js';
+export declare function createSassImporter({ cwd, resolver, }: {
+    cwd: string;
+    resolver?: CssResolver;
+}): {
+    canonicalize(url: string, context?: {
+        containingUrl?: URL | null;
+    }): Promise<import("node:url").URL | null>;
+    load(canonicalUrl: URL): Promise<{
+        contents: string;
+        syntax: "scss" | "indented";
+    }>;
+} | undefined;
+export declare function resolveAliasSpecifier(specifier: string, resolver: CssResolver, cwd: string, from?: string): Promise<string | undefined>;
+export declare function shouldNormalizeSpecifier(specifier: string): boolean;
+export declare function ensureSassPath(filePath: string): string | undefined;
+export declare function resolveRelativeSpecifier(specifier: string, containingUrl?: URL | null): string | undefined;
+export declare const __sassInternals: {
+    createSassImporter: typeof createSassImporter;
+    resolveAliasSpecifier: typeof resolveAliasSpecifier;
+    shouldNormalizeSpecifier: typeof shouldNormalizeSpecifier;
+    ensureSassPath: typeof ensureSassPath;
+    resolveRelativeSpecifier: typeof resolveRelativeSpecifier;
+};

package/dist/sassInternals.js

@@ -0,0 +1,124 @@
+import path from 'node:path';
+import { existsSync, promises as fs } from 'node:fs';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+export function createSassImporter({ cwd, resolver, }) {
+    if (!resolver)
+        return undefined;
+    const debug = process.env.KNIGHTED_CSS_DEBUG_SASS === '1';
+    return {
+        async canonicalize(url, context) {
+            if (debug) {
+                console.error('[knighted-css:sass] canonicalize request:', url);
+                if (context?.containingUrl) {
+                    console.error('[knighted-css:sass] containing url:', context.containingUrl.href);
+                }
+            }
+            const containingPath = context?.containingUrl
+                ? fileURLToPath(context.containingUrl)
+                : undefined;
+            if (shouldNormalizeSpecifier(url)) {
+                const resolvedPath = await resolveAliasSpecifier(url, resolver, cwd, containingPath);
+                if (!resolvedPath) {
+                    if (debug) {
+                        console.error('[knighted-css:sass] resolver returned no result for', url);
+                    }
+                    return null;
+                }
+                const fileUrl = pathToFileURL(resolvedPath);
+                if (debug) {
+                    console.error('[knighted-css:sass] canonical url:', fileUrl.href);
+                }
+                return fileUrl;
+            }
+            const relativePath = resolveRelativeSpecifier(url, context?.containingUrl);
+            if (relativePath) {
+                const fileUrl = pathToFileURL(relativePath);
+                if (debug) {
+                    console.error('[knighted-css:sass] canonical url:', fileUrl.href);
+                }
+                return fileUrl;
+            }
+            return null;
+        },
+        async load(canonicalUrl) {
+            if (debug) {
+                console.error('[knighted-css:sass] load request:', canonicalUrl.href);
+            }
+            const filePath = fileURLToPath(canonicalUrl);
+            const contents = await fs.readFile(filePath, 'utf8');
+            return {
+                contents,
+                syntax: inferSassSyntax(filePath),
+            };
+        },
+    };
+}
+export async function resolveAliasSpecifier(specifier, resolver, cwd, from) {
+    const resolved = await resolver(specifier, { cwd, from });
+    if (!resolved) {
+        return undefined;
+    }
+    if (resolved.startsWith('file://')) {
+        return ensureSassPath(fileURLToPath(new URL(resolved)));
+    }
+    const normalized = path.isAbsolute(resolved) ? resolved : path.resolve(cwd, resolved);
+    return ensureSassPath(normalized);
+}
+export function shouldNormalizeSpecifier(specifier) {
+    const schemeMatch = specifier.match(/^([a-z][\w+.-]*):/i);
+    if (!schemeMatch) {
+        return false;
+    }
+    const scheme = schemeMatch[1].toLowerCase();
+    if (scheme === 'file' ||
+        scheme === 'http' ||
+        scheme === 'https' ||
+        scheme === 'data' ||
+        scheme === 'sass') {
+        return false;
+    }
+    return true;
+}
+function inferSassSyntax(filePath) {
+    return filePath.endsWith('.sass') ? 'indented' : 'scss';
+}
+export function ensureSassPath(filePath) {
+    if (existsSync(filePath)) {
+        return filePath;
+    }
+    const ext = path.extname(filePath);
+    const dir = path.dirname(filePath);
+    const base = path.basename(filePath, ext);
+    const partialCandidate = path.join(dir, `_${base}${ext}`);
+    if (ext && existsSync(partialCandidate)) {
+        return partialCandidate;
+    }
+    const indexCandidate = path.join(dir, base, `index${ext}`);
+    if (ext && existsSync(indexCandidate)) {
+        return indexCandidate;
+    }
+    const partialIndexCandidate = path.join(dir, base, `_index${ext}`);
+    if (ext && existsSync(partialIndexCandidate)) {
+        return partialIndexCandidate;
+    }
+    return undefined;
+}
+export function resolveRelativeSpecifier(specifier, containingUrl) {
+    if (!containingUrl || containingUrl.protocol !== 'file:') {
+        return undefined;
+    }
+    if (/^[a-z][\w+.-]*:/i.test(specifier)) {
+        return undefined;
+    }
+    const containingPath = fileURLToPath(containingUrl);
+    const baseDir = path.dirname(containingPath);
+    const candidate = path.resolve(baseDir, specifier);
+    return ensureSassPath(candidate);
+}
+export const __sassInternals = {
+    createSassImporter,
+    resolveAliasSpecifier,
+    shouldNormalizeSpecifier,
+    ensureSassPath,
+    resolveRelativeSpecifier,
+};

package/dist/stableNamespace.d.ts

@@ -0,0 +1,3 @@
+declare const DEFAULT_STABLE_NAMESPACE = "knighted";
+export declare function resolveStableNamespace(optionNamespace?: string): string;
+export { DEFAULT_STABLE_NAMESPACE };

package/dist/stableNamespace.js

@@ -0,0 +1,8 @@
+const DEFAULT_STABLE_NAMESPACE = 'knighted';
+export function resolveStableNamespace(optionNamespace) {
+    if (typeof optionNamespace === 'string') {
+        return optionNamespace;
+    }
+    return DEFAULT_STABLE_NAMESPACE;
+}
+export { DEFAULT_STABLE_NAMESPACE };

package/dist/stableSelectors.d.ts

@@ -0,0 +1,13 @@
+export interface StableSelectorOptions {
+    namespace?: string;
+}
+export interface StableClassNameOptions extends StableSelectorOptions {
+    token?: string;
+    join?: (values: string[]) => string;
+}
+export declare function stableToken(token: string, options?: StableSelectorOptions): string;
+export declare function stableClass(token: string, options?: StableSelectorOptions): string;
+export declare function stableSelector(token: string, options?: StableSelectorOptions): string;
+export declare function createStableClassFactory(options?: StableSelectorOptions): (token: string) => string;
+export declare function stableClassName<T extends Record<string, string>>(styles: T, key: keyof T | string, options?: StableClassNameOptions): string;
+export declare const stableClassFromModule: typeof stableClassName;