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

package/dist/cjs/moduleGraph.cjs

@@ -0,0 +1,431 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectStyleImports = collectStyleImports;
+const node_path_1 = __importDefault(require("node:path"));
+const node_module_1 = require("node:module");
+const node_fs_1 = require("node:fs");
+const node_url_1 = require("node:url");
+const oxc_parser_1 = require("oxc-parser");
+const oxc_resolver_1 = require("oxc-resolver");
+const tsconfig_paths_1 = require("tsconfig-paths");
+const get_tsconfig_1 = require("get-tsconfig");
+const SCRIPT_EXTENSIONS = ['.ts', '.tsx', '.mts', '.cts', '.js', '.jsx', '.mjs', '.cjs'];
+const BUILTIN_SPECIFIERS = new Set([
+    ...node_module_1.builtinModules,
+    ...node_module_1.builtinModules.map(mod => `node:${mod}`),
+]);
+const tsconfigResultCache = new Map();
+const tsconfigFsCache = new Map();
+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 = node_path_1.default.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 = node_path_1.default.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 = node_path_1.default.extname(filePath).toLowerCase();
+    return extensions.includes(ext);
+}
+async function readSourceFile(filePath) {
+    try {
+        return await node_fs_1.promises.readFile(filePath, 'utf8');
+    }
+    catch {
+        return undefined;
+    }
+}
+function extractModuleSpecifiers(sourceText, filePath) {
+    let program;
+    try {
+        ;
+        ({ program } = (0, oxc_parser_1.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 oxc_parser_1.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 (0, node_url_1.fileURLToPath)(new URL(result));
+        }
+        catch {
+            return undefined;
+        }
+    }
+    return node_path_1.default.isAbsolute(result) ? result : node_path_1.default.resolve(cwd, result);
+}
+function resolveWithFactory(factory, specifier, importer, extensions) {
+    if (specifier.startsWith('file://')) {
+        try {
+            return findExistingFile((0, node_url_1.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 oxc_resolver_1.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 = (0, tsconfig_paths_1.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 = node_path_1.default.isAbsolute(input) ? input : node_path_1.default.resolve(cwd, input);
+        const cached = tsconfigResultCache.get(target);
+        if (cached !== undefined) {
+            return cached ?? undefined;
+        }
+        const result = (0, get_tsconfig_1.getTsconfig)(target, undefined, tsconfigFsCache);
+        if (!result) {
+            tsconfigResultCache.set(target, null);
+            return undefined;
+        }
+        const normalized = normalizeTsconfigCompilerOptions(result.config.compilerOptions, node_path_1.default.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 = node_path_1.default.isAbsolute(compilerOptions.baseUrl)
+        ? compilerOptions.baseUrl
+        : node_path_1.default.resolve(configDir, compilerOptions.baseUrl);
+    return { absoluteBaseUrl, paths: normalizedPaths };
+}
+function resolveTsconfigPath(tsconfigPath, cwd) {
+    const absolute = node_path_1.default.isAbsolute(tsconfigPath)
+        ? tsconfigPath
+        : node_path_1.default.resolve(cwd, tsconfigPath);
+    if (!(0, node_fs_1.existsSync)(absolute)) {
+        return undefined;
+    }
+    const stats = (0, node_fs_1.statSync)(absolute);
+    if (stats.isDirectory()) {
+        const candidate = node_path_1.default.join(absolute, 'tsconfig.json');
+        return (0, node_fs_1.existsSync)(candidate) ? candidate : undefined;
+    }
+    return absolute;
+}
+function findExistingFile(candidate, extensions) {
+    const candidateHasExt = hasExtension(candidate);
+    if (candidateHasExt && (0, node_fs_1.existsSync)(candidate)) {
+        return candidate;
+    }
+    if (!candidateHasExt) {
+        for (const ext of extensions) {
+            const withExt = `${candidate}${ext}`;
+            if ((0, node_fs_1.existsSync)(withExt)) {
+                return withExt;
+            }
+        }
+    }
+    if ((0, node_fs_1.existsSync)(candidate) && (0, node_fs_1.statSync)(candidate).isDirectory()) {
+        for (const ext of extensions) {
+            const indexPath = node_path_1.default.join(candidate, `index${ext}`);
+            if ((0, node_fs_1.existsSync)(indexPath)) {
+                return indexPath;
+            }
+        }
+    }
+    return undefined;
+}
+function hasExtension(filePath) {
+    return Boolean(node_path_1.default.extname(filePath));
+}

package/dist/cjs/moduleGraph.d.cts

@@ -0,0 +1,15 @@
+import type { CssResolver } from './types.cjs';
+export interface ModuleGraphOptions {
+    tsConfig?: string | Record<string, unknown>;
+    extensions?: string[];
+    conditions?: string[];
+}
+interface CollectOptions {
+    cwd: string;
+    styleExtensions: string[];
+    filter: (filePath: string) => boolean;
+    resolver?: CssResolver;
+    graphOptions?: ModuleGraphOptions;
+}
+export declare function collectStyleImports(entryPath: string, options: CollectOptions): Promise<string[]>;
+export {};

package/dist/cjs/moduleInfo.cjs

@@ -0,0 +1,62 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.__moduleInfoInternals = void 0;
+exports.detectModuleDefaultExport = detectModuleDefaultExport;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = __importDefault(require("node:path"));
+const es_module_lexer_1 = require("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 = es_module_lexer_1.init;
+    }
+    return lexerInit;
+}
+async function detectModuleDefaultExport(filePath) {
+    if (!DETECTABLE_EXTENSIONS.has(node_path_1.default.extname(filePath))) {
+        return 'unknown';
+    }
+    let source;
+    try {
+        source = await (0, promises_1.readFile)(filePath, 'utf8');
+    }
+    catch {
+        return 'unknown';
+    }
+    try {
+        await ensureLexerInitialized();
+        const [, exports] = (lexerOverrides?.parse ?? es_module_lexer_1.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';
+    }
+}
+exports.__moduleInfoInternals = {
+    setLexerOverrides(overrides) {
+        lexerOverrides = overrides;
+        if (!overrides) {
+            lexerInit = undefined;
+        }
+    },
+};

package/dist/cjs/moduleInfo.d.cts

@@ -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/cjs/sassInternals.cjs

@@ -0,0 +1,135 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.__sassInternals = void 0;
+exports.createSassImporter = createSassImporter;
+exports.resolveAliasSpecifier = resolveAliasSpecifier;
+exports.shouldNormalizeSpecifier = shouldNormalizeSpecifier;
+exports.ensureSassPath = ensureSassPath;
+exports.resolveRelativeSpecifier = resolveRelativeSpecifier;
+const node_path_1 = __importDefault(require("node:path"));
+const node_fs_1 = require("node:fs");
+const node_url_1 = require("node:url");
+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
+                ? (0, node_url_1.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 = (0, node_url_1.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 = (0, node_url_1.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 = (0, node_url_1.fileURLToPath)(canonicalUrl);
+            const contents = await node_fs_1.promises.readFile(filePath, 'utf8');
+            return {
+                contents,
+                syntax: inferSassSyntax(filePath),
+            };
+        },
+    };
+}
+async function resolveAliasSpecifier(specifier, resolver, cwd, from) {
+    const resolved = await resolver(specifier, { cwd, from });
+    if (!resolved) {
+        return undefined;
+    }
+    if (resolved.startsWith('file://')) {
+        return ensureSassPath((0, node_url_1.fileURLToPath)(new URL(resolved)));
+    }
+    const normalized = node_path_1.default.isAbsolute(resolved) ? resolved : node_path_1.default.resolve(cwd, resolved);
+    return ensureSassPath(normalized);
+}
+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';
+}
+function ensureSassPath(filePath) {
+    if ((0, node_fs_1.existsSync)(filePath)) {
+        return filePath;
+    }
+    const ext = node_path_1.default.extname(filePath);
+    const dir = node_path_1.default.dirname(filePath);
+    const base = node_path_1.default.basename(filePath, ext);
+    const partialCandidate = node_path_1.default.join(dir, `_${base}${ext}`);
+    if (ext && (0, node_fs_1.existsSync)(partialCandidate)) {
+        return partialCandidate;
+    }
+    const indexCandidate = node_path_1.default.join(dir, base, `index${ext}`);
+    if (ext && (0, node_fs_1.existsSync)(indexCandidate)) {
+        return indexCandidate;
+    }
+    const partialIndexCandidate = node_path_1.default.join(dir, base, `_index${ext}`);
+    if (ext && (0, node_fs_1.existsSync)(partialIndexCandidate)) {
+        return partialIndexCandidate;
+    }
+    return undefined;
+}
+function resolveRelativeSpecifier(specifier, containingUrl) {
+    if (!containingUrl || containingUrl.protocol !== 'file:') {
+        return undefined;
+    }
+    if (/^[a-z][\w+.-]*:/i.test(specifier)) {
+        return undefined;
+    }
+    const containingPath = (0, node_url_1.fileURLToPath)(containingUrl);
+    const baseDir = node_path_1.default.dirname(containingPath);
+    const candidate = node_path_1.default.resolve(baseDir, specifier);
+    return ensureSassPath(candidate);
+}
+exports.__sassInternals = {
+    createSassImporter,
+    resolveAliasSpecifier,
+    shouldNormalizeSpecifier,
+    ensureSassPath,
+    resolveRelativeSpecifier,
+};

package/dist/cjs/sassInternals.d.cts

@@ -0,0 +1,25 @@
+import type { CssResolver } from './types.cjs';
+export type { CssResolver } from './types.cjs';
+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/cjs/stableNamespace.cjs

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_STABLE_NAMESPACE = void 0;
+exports.resolveStableNamespace = resolveStableNamespace;
+const DEFAULT_STABLE_NAMESPACE = 'knighted';
+exports.DEFAULT_STABLE_NAMESPACE = DEFAULT_STABLE_NAMESPACE;
+function resolveStableNamespace(optionNamespace) {
+    if (typeof optionNamespace === 'string') {
+        return optionNamespace;
+    }
+    return DEFAULT_STABLE_NAMESPACE;
+}

package/dist/cjs/stableNamespace.d.cts

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