@master/css-integration 2.0.0-rc.70

package/README.md

@@ -0,0 +1,40 @@
+# @master/css-integration
+
+Shared Master CSS integration contracts, virtual module protocols, and build helpers.
+
+## Installation
+
+```bash
+npm install @master/css-integration
+```
+
+## Responsibility
+
+`@master/css-integration` is adapter-neutral glue for official build and framework integrations. It owns virtual module IDs, `?master-css-manifest` request helpers, generated manifest and emittedGlobals module source helpers, runtime injection source, ambient client declarations, and explicit Node/build helper subpaths.
+
+It does not implement project manifest discovery, CSS import graph resolution, extraction, runtime hydration, or framework lifecycle behavior.
+
+## Public subpaths
+
+| Subpath | Purpose |
+| --- | --- |
+| `@master/css-integration` | Shared browser-safe contracts. |
+| `@master/css-integration/client` | Ambient TypeScript declarations for virtual modules. |
+| `@master/css-integration/module` | General virtual module helpers. |
+| `@master/css-integration/manifest-module` | Manifest virtual module IDs, query helpers, and JSON helpers. |
+| `@master/css-integration/manifest-facade` | Generated manifest facade source helpers. |
+| `@master/css-integration/style-module` | Generated style module helpers. |
+| `@master/css-integration/emitted-globals-module` | Generated emittedGlobals module helpers. |
+| `@master/css-integration/runtime` | Runtime injection source helpers. |
+| `@master/css-integration/manifest-loader-plugin` | Build-only manifest loader plugin contracts. |
+| `@master/css-integration/node` | Node filesystem/path helpers. |
+
+## Client types
+
+Add the client type reference when TypeScript imports Master CSS virtual modules:
+
+```ts
+/// <reference types="@master/css-integration/client" />
+```
+
+This declares modules such as `virtual:master-css-manifest`, `virtual:master-css-emitted-globals`, generated CSS modules, and `?master-css-manifest` imports.

package/client.d.ts

@@ -0,0 +1,23 @@
+declare module '*?master-css-manifest' {
+    import type { MasterCSSManifest } from '@master/css-engine'
+
+    const manifest: MasterCSSManifest
+    export default manifest
+}
+
+declare module 'virtual:master-utilities.css' {
+}
+
+declare module 'virtual:master-css-manifest' {
+    import type { MasterCSSManifest } from '@master/css-engine'
+
+    const manifest: MasterCSSManifest
+    export default manifest
+}
+
+declare module 'virtual:master-css-emitted-globals' {
+    import type { MasterCSSEmittedGlobals } from '@master/css-engine'
+
+    const emittedGlobals: MasterCSSEmittedGlobals
+    export default emittedGlobals
+}

package/dist/emitted-globals-module.d.ts

@@ -0,0 +1,7 @@
+import type { MasterCSSEmittedGlobals } from '@master/css-engine';
+export type { MasterCSSEmittedGlobals };
+export declare const VIRTUAL_EMITTED_GLOBALS_ID = "virtual:master-css-emitted-globals";
+export declare const VIRTUAL_EMITTED_GLOBALS_FILE = "master-css-emitted-globals.js";
+export declare const EMPTY_EMITTED_GLOBALS_MODULE = "export default { variables: {}, animations: {} };";
+export declare function normalizeEmittedGlobals(emittedGlobals?: MasterCSSEmittedGlobals): Required<MasterCSSEmittedGlobals>;
+export declare function toEmittedGlobalsModule(emittedGlobals: MasterCSSEmittedGlobals): string;

package/dist/emitted-globals-module.mjs

@@ -0,0 +1,14 @@
+const VIRTUAL_EMITTED_GLOBALS_ID = 'virtual:master-css-emitted-globals';
+const VIRTUAL_EMITTED_GLOBALS_FILE = 'master-css-emitted-globals.js';
+const EMPTY_EMITTED_GLOBALS_MODULE = 'export default { variables: {}, animations: {} };';
+function normalizeEmittedGlobals(emittedGlobals = {}) {
+    return {
+        variables: emittedGlobals.variables || {},
+        animations: emittedGlobals.animations || {}
+    };
+}
+function toEmittedGlobalsModule(emittedGlobals) {
+    return `export default ${JSON.stringify(normalizeEmittedGlobals(emittedGlobals))};`;
+}
+
+export { EMPTY_EMITTED_GLOBALS_MODULE, VIRTUAL_EMITTED_GLOBALS_FILE, VIRTUAL_EMITTED_GLOBALS_ID, normalizeEmittedGlobals, toEmittedGlobalsModule };

package/dist/index.d.ts

@@ -0,0 +1 @@
+export * from './module';

package/dist/index.mjs

@@ -0,0 +1,5 @@
+export { CSS_RUNTIME_INJECTION, MASTER_CSS_RUNTIME_INJECTED_MARKER } from './runtime.mjs';
+export { EMPTY_EMITTED_GLOBALS_MODULE, VIRTUAL_EMITTED_GLOBALS_FILE, VIRTUAL_EMITTED_GLOBALS_ID, normalizeEmittedGlobals, toEmittedGlobalsModule } from './emitted-globals-module.mjs';
+export { EMPTY_MANIFEST_JSON, MASTER_CSS_MANIFEST_QUERY, VIRTUAL_MANIFEST_ASSET_FILE, VIRTUAL_MANIFEST_FILE, VIRTUAL_MANIFEST_ID, isMasterCSSManifestRequest, stripMasterCSSManifestQuery, stripResourceQuery, toManifestJSON, toManifestJSONResult } from './manifest-module.mjs';
+export { MANIFEST_ASSET_FILE, MANIFEST_MODULE_FILE, MASTER_CSS_MANIFEST_PRELOAD_AS, MASTER_CSS_MANIFEST_PRELOAD_REL, MASTER_CSS_MANIFEST_PRELOAD_TYPE, toBrowserManifestFacadeModule, toInlineManifestModule, toManifestPreloadLinkAttrs, toManifestPreloadLinkTag, toNodeManifestFacadeModule, toUniversalManifestFacadeModule } from './manifest-facade.mjs';
+export { VIRTUAL_CSS_ID } from './style-module.mjs';

package/dist/manifest-facade.d.ts

@@ -0,0 +1,18 @@
+export declare const MANIFEST_MODULE_FILE = "master-css-manifest.js";
+export declare const MANIFEST_ASSET_FILE = "master-css-manifest.json";
+export declare const MASTER_CSS_MANIFEST_PRELOAD_REL = "preload";
+export declare const MASTER_CSS_MANIFEST_PRELOAD_AS = "fetch";
+export declare const MASTER_CSS_MANIFEST_PRELOAD_TYPE = "application/json";
+export interface ManifestPreloadLinkAttrs {
+    rel: typeof MASTER_CSS_MANIFEST_PRELOAD_REL;
+    as: typeof MASTER_CSS_MANIFEST_PRELOAD_AS;
+    type: typeof MASTER_CSS_MANIFEST_PRELOAD_TYPE;
+    crossorigin: '';
+    href: string;
+}
+export declare function toInlineManifestModule(json: string): string;
+export declare function toManifestPreloadLinkAttrs(href: string): ManifestPreloadLinkAttrs;
+export declare function toManifestPreloadLinkTag(href: string): string;
+export declare function toBrowserManifestFacadeModule(urlExpression: string): string;
+export declare function toNodeManifestFacadeModule(urlExpression: string): string;
+export declare function toUniversalManifestFacadeModule(urlExpression: string): string;

package/dist/manifest-facade.mjs

@@ -0,0 +1,95 @@
+const MANIFEST_MODULE_FILE = 'master-css-manifest.js';
+const MANIFEST_ASSET_FILE = 'master-css-manifest.json';
+const MASTER_CSS_MANIFEST_PRELOAD_REL = 'preload';
+const MASTER_CSS_MANIFEST_PRELOAD_AS = 'fetch';
+const MASTER_CSS_MANIFEST_PRELOAD_TYPE = 'application/json';
+function escapeAttributeValue(value) {
+    return value.replace(/&/g, '&').replace(/"/g, '"');
+}
+function toInlineManifestModule(json) {
+    return `export default ${json};`;
+}
+function toManifestPreloadLinkAttrs(href) {
+    return {
+        rel: MASTER_CSS_MANIFEST_PRELOAD_REL,
+        as: MASTER_CSS_MANIFEST_PRELOAD_AS,
+        type: MASTER_CSS_MANIFEST_PRELOAD_TYPE,
+        crossorigin: '',
+        href
+    };
+}
+function toManifestPreloadLinkTag(href) {
+    const attrs = toManifestPreloadLinkAttrs(href);
+    return [
+        '<link',
+        `rel="${attrs.rel}"`,
+        `as="${attrs.as}"`,
+        `type="${attrs.type}"`,
+        'crossorigin',
+        `href="${escapeAttributeValue(attrs.href)}">`
+    ].join(' ');
+}
+function toBrowserManifestFacadeModule(urlExpression) {
+    return [
+        `const masterCSSManifestURL = ${urlExpression};`,
+        `const masterCSSManifestResponse = await fetch(masterCSSManifestURL);`,
+        `if (!masterCSSManifestResponse.ok) {`,
+        `    throw new Error(\`Failed to load Master CSS manifest JSON: \${masterCSSManifestResponse.status} \${masterCSSManifestResponse.statusText}\`);`,
+        `}`,
+        `export default await masterCSSManifestResponse.json();`,
+        ``
+    ].join('\n');
+}
+function toNodeManifestFacadeModule(urlExpression) {
+    return [
+        `import { readFile } from 'node:fs/promises';`,
+        `import { fileURLToPath } from 'node:url';`,
+        ``,
+        `const masterCSSManifestURL = ${urlExpression};`,
+        `export default JSON.parse(await readFile(fileURLToPath(new URL(masterCSSManifestURL, import.meta.url).href), 'utf8'));`,
+        ``
+    ].join('\n');
+}
+function toUniversalManifestFacadeModule(urlExpression) {
+    return [
+        `const masterCSSManifestURL = ${urlExpression};`,
+        ``,
+        `async function loadMasterCSSManifestFromFile(url) {`,
+        `    const load = new Function('specifier', 'return import(specifier)');`,
+        `    const { readFile } = await load('node:fs/promises');`,
+        `    const { fileURLToPath } = await load('node:url');`,
+        `    const { join } = await load('node:path');`,
+        `    const value = typeof url === 'string' ? url : url.href;`,
+        `    const files = value.startsWith('/_next/')`,
+        `        ? [`,
+        `            join(process.cwd(), '.next', value.slice('/_next/'.length)),`,
+        `            join(process.cwd(), '.next', 'dev', value.slice('/_next/'.length))`,
+        `        ]`,
+        `        : [fileURLToPath(value)];`,
+        `    let lastError;`,
+        `    for (const file of files) {`,
+        `        try {`,
+        `            return JSON.parse(await readFile(file, 'utf8'));`,
+        `        } catch (error) {`,
+        `            lastError = error;`,
+        `        }`,
+        `    }`,
+        `    throw lastError;`,
+        `}`,
+        ``,
+        `async function loadMasterCSSManifestFromFetch(url) {`,
+        `    const response = await fetch(url);`,
+        `    if (!response.ok) {`,
+        `        throw new Error(\`Failed to load Master CSS manifest JSON: \${response.status} \${response.statusText}\`);`,
+        `    }`,
+        `    return response.json();`,
+        `}`,
+        ``,
+        `export default typeof window === 'undefined'`,
+        `    ? await loadMasterCSSManifestFromFile(masterCSSManifestURL)`,
+        `    : await loadMasterCSSManifestFromFetch(masterCSSManifestURL);`,
+        ``
+    ].join('\n');
+}
+
+export { MANIFEST_ASSET_FILE, MANIFEST_MODULE_FILE, MASTER_CSS_MANIFEST_PRELOAD_AS, MASTER_CSS_MANIFEST_PRELOAD_REL, MASTER_CSS_MANIFEST_PRELOAD_TYPE, toBrowserManifestFacadeModule, toInlineManifestModule, toManifestPreloadLinkAttrs, toManifestPreloadLinkTag, toNodeManifestFacadeModule, toUniversalManifestFacadeModule };

package/dist/manifest-loader-plugin.d.ts

@@ -0,0 +1,38 @@
+import { type CSSManifestJSONResult } from './manifest-module';
+type MaybePromise<T> = T | Promise<T>;
+export interface MasterCSSManifestLoaderPluginContext {
+    addWatchFile?: (id: string) => void;
+    emitFile?: (asset: {
+        type: 'asset';
+        name: string;
+        source: string;
+    }) => string;
+}
+export interface MasterCSSManifestLoaderPluginOptions {
+    cwd?: string;
+    resolveUnresolved?: boolean;
+    loadManifestJSON: (path: string) => MaybePromise<CSSManifestJSONResult>;
+    toManifestModule?: (payload: {
+        manifestPath: string;
+        result: CSSManifestJSONResult;
+        pluginContext: MasterCSSManifestLoaderPluginContext;
+    }) => MaybePromise<string>;
+    onLoadManifestJSON?: (payload: {
+        manifestPath: string;
+        result: CSSManifestJSONResult;
+        pluginContext: MasterCSSManifestLoaderPluginContext;
+    }) => void;
+}
+export declare function createMasterCSSManifestLoaderPlugin(options: MasterCSSManifestLoaderPluginOptions): {
+    name: string;
+    enforce: "pre";
+    resolveId(this: {
+        resolve?: (id: string, importer?: string, options?: {
+            skipSelf?: boolean;
+        }) => Promise<{
+            id: string;
+        } | null | undefined>;
+    }, id: string, importer?: string): Promise<string | undefined>;
+    load(this: MasterCSSManifestLoaderPluginContext, id: string): Promise<string | undefined>;
+};
+export {};

package/dist/manifest-loader-plugin.mjs

@@ -0,0 +1,43 @@
+import { dirname, isAbsolute, resolve } from 'node:path';
+import { isMasterCSSManifestRequest, stripMasterCSSManifestQuery, stripResourceQuery } from './manifest-module.mjs';
+import { toInlineManifestModule } from './manifest-facade.mjs';
+import { fromResolvedMasterCSSManifestId, toResolvedMasterCSSManifestId } from './node.mjs';
+
+function createMasterCSSManifestLoaderPlugin(options) {
+    return {
+        name: 'master-css:manifest-loader',
+        enforce: 'pre',
+        async resolveId (id, importer) {
+            if (!isMasterCSSManifestRequest(id)) return;
+            const sourceId = stripMasterCSSManifestQuery(id);
+            const resolved = await this.resolve?.(sourceId, importer, {
+                skipSelf: true
+            });
+            if (resolved) return toResolvedMasterCSSManifestId(resolved.id);
+            if (options.resolveUnresolved === false) return;
+            const baseDir = importer ? dirname(stripResourceQuery(importer)) : options.cwd || process.cwd();
+            const file = isAbsolute(sourceId) ? sourceId : resolve(baseDir, sourceId);
+            return toResolvedMasterCSSManifestId(file);
+        },
+        async load (id) {
+            const manifestPath = fromResolvedMasterCSSManifestId(id);
+            if (!manifestPath) return;
+            const result = await options.loadManifestJSON(manifestPath);
+            for (const dependency of result.dependencies){
+                this.addWatchFile?.(dependency);
+            }
+            options.onLoadManifestJSON?.({
+                manifestPath,
+                result,
+                pluginContext: this
+            });
+            return options.toManifestModule ? options.toManifestModule({
+                manifestPath,
+                result,
+                pluginContext: this
+            }) : toInlineManifestModule(result.json);
+        }
+    };
+}
+
+export { createMasterCSSManifestLoaderPlugin };

package/dist/manifest-module.d.ts

@@ -0,0 +1,27 @@
+import type { MasterCSSManifest } from '@master/css-schema/manifest';
+export type { MasterCSSManifest };
+export declare const VIRTUAL_MANIFEST_ID = "virtual:master-css-manifest";
+export declare const MASTER_CSS_MANIFEST_QUERY = "?master-css-manifest";
+export declare const VIRTUAL_MANIFEST_FILE = "master-css-manifest.js";
+export declare const VIRTUAL_MANIFEST_ASSET_FILE = "master-css-manifest.json";
+export declare const EMPTY_MANIFEST_JSON = "{\"version\":1}";
+export interface CSSManifestLoadResult {
+    manifest: MasterCSSManifest;
+    dependencies: string[];
+    classNames?: string[];
+    nativeClassNames?: string[];
+    nativeCSS?: string;
+    css?: string;
+    generatedCSS?: string;
+    warnings?: string[];
+}
+export type CSSManifestJSONResult = CSSManifestLoadResult & {
+    json: string;
+};
+export declare function isMasterCSSManifestRequest(id: string): boolean;
+export declare function stripMasterCSSManifestQuery(id: string): string;
+export declare function stripResourceQuery(resourcePath: string): string;
+export declare function toManifestJSON(manifest: MasterCSSManifest): string;
+export declare function toManifestJSONResult<T extends CSSManifestLoadResult>(result: T): T & {
+    json: string;
+};

package/dist/manifest-module.mjs

@@ -0,0 +1,28 @@
+import { stringifyMasterCSSManifestJSON } from '@master/css-schema/manifest-json';
+import { MANIFEST_ASSET_FILE, MANIFEST_MODULE_FILE } from './manifest-facade.mjs';
+
+const VIRTUAL_MANIFEST_ID = 'virtual:master-css-manifest';
+const MASTER_CSS_MANIFEST_QUERY = '?master-css-manifest';
+const VIRTUAL_MANIFEST_FILE = MANIFEST_MODULE_FILE;
+const VIRTUAL_MANIFEST_ASSET_FILE = MANIFEST_ASSET_FILE;
+const EMPTY_MANIFEST_JSON = '{"version":1}';
+function isMasterCSSManifestRequest(id) {
+    return id.endsWith(MASTER_CSS_MANIFEST_QUERY);
+}
+function stripMasterCSSManifestQuery(id) {
+    return isMasterCSSManifestRequest(id) ? id.slice(0, -MASTER_CSS_MANIFEST_QUERY.length) : id;
+}
+function stripResourceQuery(resourcePath) {
+    return resourcePath.replace(/[?#].*$/, '');
+}
+function toManifestJSON(manifest) {
+    return stringifyMasterCSSManifestJSON(manifest);
+}
+function toManifestJSONResult(result) {
+    return {
+        ...result,
+        json: toManifestJSON(result.manifest)
+    };
+}
+
+export { EMPTY_MANIFEST_JSON, MASTER_CSS_MANIFEST_QUERY, VIRTUAL_MANIFEST_ASSET_FILE, VIRTUAL_MANIFEST_FILE, VIRTUAL_MANIFEST_ID, isMasterCSSManifestRequest, stripMasterCSSManifestQuery, stripResourceQuery, toManifestJSON, toManifestJSONResult };

package/dist/module.d.ts

@@ -0,0 +1,5 @@
+export * from './manifest-module';
+export * from './manifest-facade';
+export * from './style-module';
+export * from './emitted-globals-module';
+export * from './runtime';

package/dist/module.mjs

@@ -0,0 +1,5 @@
+export { EMPTY_MANIFEST_JSON, MASTER_CSS_MANIFEST_QUERY, VIRTUAL_MANIFEST_ASSET_FILE, VIRTUAL_MANIFEST_FILE, VIRTUAL_MANIFEST_ID, isMasterCSSManifestRequest, stripMasterCSSManifestQuery, stripResourceQuery, toManifestJSON, toManifestJSONResult } from './manifest-module.mjs';
+export { MANIFEST_ASSET_FILE, MANIFEST_MODULE_FILE, MASTER_CSS_MANIFEST_PRELOAD_AS, MASTER_CSS_MANIFEST_PRELOAD_REL, MASTER_CSS_MANIFEST_PRELOAD_TYPE, toBrowserManifestFacadeModule, toInlineManifestModule, toManifestPreloadLinkAttrs, toManifestPreloadLinkTag, toNodeManifestFacadeModule, toUniversalManifestFacadeModule } from './manifest-facade.mjs';
+export { VIRTUAL_CSS_ID } from './style-module.mjs';
+export { EMPTY_EMITTED_GLOBALS_MODULE, VIRTUAL_EMITTED_GLOBALS_FILE, VIRTUAL_EMITTED_GLOBALS_ID, normalizeEmittedGlobals, toEmittedGlobalsModule } from './emitted-globals-module.mjs';
+export { CSS_RUNTIME_INJECTION, MASTER_CSS_RUNTIME_INJECTED_MARKER } from './runtime.mjs';

package/dist/node.d.ts

@@ -0,0 +1,15 @@
+export declare const RESOLVED_MASTER_CSS_MANIFEST_QUERY_PREFIX = "\0master-css-manifest:";
+export declare const VIRTUAL_MODULE_DIR = "node_modules/.master-css";
+export declare function toHashedManifestAssetFileName(json: string, basename?: string): string;
+export declare function toHashedHydrationManifestAssetFileName(json: string): string;
+export declare function toResolvedMasterCSSManifestId(file: string): string;
+export declare function fromResolvedMasterCSSManifestId(id: string): string | undefined;
+export declare function toVirtualDefaultManifestModulePath(context: string): string;
+export declare function toVirtualCSSManifestModulePath(context: string, file: string): string;
+export declare function toVirtualCSSManifestAssetPath(context: string, file: string): string;
+export declare function toVirtualCSSModulePath(context: string): string;
+export declare function toVirtualEmittedGlobalsModulePath(context: string): string;
+export declare function createVirtualDefaultManifestModulePathPattern(): RegExp;
+export declare function ensureVirtualModuleFile(file: string, source: string): string;
+export declare function ensureVirtualManifestModulePath(projectDir?: string): string;
+export declare function ensureVirtualEmittedGlobalsModulePath(projectDir?: string): string;

package/dist/node.mjs

@@ -0,0 +1,75 @@
+import { createHash } from 'node:crypto';
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { VIRTUAL_MANIFEST_FILE, EMPTY_MANIFEST_JSON } from './manifest-module.mjs';
+import { toInlineManifestModule } from './manifest-facade.mjs';
+import { VIRTUAL_EMITTED_GLOBALS_FILE, EMPTY_EMITTED_GLOBALS_MODULE } from './emitted-globals-module.mjs';
+import { MASTER_CSS_HYDRATION_MANIFEST_FILE_BASENAME } from '@master/css-schema/hydration-manifest';
+
+const RESOLVED_MASTER_CSS_MANIFEST_QUERY_PREFIX = '\0master-css-manifest:';
+const VIRTUAL_MODULE_DIR = 'node_modules/.master-css';
+const VIRTUAL_MODULE_DIR_SEGMENTS = [
+    'node_modules',
+    '.master-css'
+];
+function toHashedManifestAssetFileName(json, basename = 'master-css-manifest') {
+    const hash = createHash('sha256').update(json).digest('hex').slice(0, 8);
+    return `${basename}.${hash}.json`;
+}
+function toHashedHydrationManifestAssetFileName(json) {
+    return toHashedManifestAssetFileName(json, MASTER_CSS_HYDRATION_MANIFEST_FILE_BASENAME);
+}
+function toResolvedMasterCSSManifestId(file) {
+    return RESOLVED_MASTER_CSS_MANIFEST_QUERY_PREFIX + Buffer.from(file).toString('base64url');
+}
+function fromResolvedMasterCSSManifestId(id) {
+    return id.startsWith(RESOLVED_MASTER_CSS_MANIFEST_QUERY_PREFIX) ? Buffer.from(id.slice(RESOLVED_MASTER_CSS_MANIFEST_QUERY_PREFIX.length), 'base64url').toString() : undefined;
+}
+function toVirtualDefaultManifestModulePath(context) {
+    return join(context, ...VIRTUAL_MODULE_DIR_SEGMENTS, VIRTUAL_MANIFEST_FILE);
+}
+function encodeVirtualFilename(id) {
+    return Buffer.from(id).toString('base64url');
+}
+function toVirtualCSSManifestModulePath(context, file) {
+    return join(context, ...VIRTUAL_MODULE_DIR_SEGMENTS, `${encodeVirtualFilename(file)}.manifest.js`);
+}
+function toVirtualCSSManifestAssetPath(context, file) {
+    return join(context, ...VIRTUAL_MODULE_DIR_SEGMENTS, `${encodeVirtualFilename(file)}.manifest.json`);
+}
+function toVirtualCSSModulePath(context) {
+    return join(context, ...VIRTUAL_MODULE_DIR_SEGMENTS, 'master-utilities.css');
+}
+function toVirtualEmittedGlobalsModulePath(context) {
+    return join(context, ...VIRTUAL_MODULE_DIR_SEGMENTS, VIRTUAL_EMITTED_GLOBALS_FILE);
+}
+function escapeRegExp(source) {
+    return source.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+function createVirtualDefaultManifestModulePathPattern() {
+    const source = [
+        ...VIRTUAL_MODULE_DIR_SEGMENTS,
+        VIRTUAL_MANIFEST_FILE
+    ].map(escapeRegExp).join(String.raw`[/\\]`);
+    return new RegExp(String.raw`(?:^|[/\\])${source}$`);
+}
+function ensureVirtualModuleFile(file, source) {
+    mkdirSync(dirname(file), {
+        recursive: true
+    });
+    try {
+        if (readFileSync(file, 'utf8') === source) return file;
+    } catch  {
+    // Create the file below when it does not exist or cannot be read.
+    }
+    writeFileSync(file, source);
+    return file;
+}
+function ensureVirtualManifestModulePath(projectDir = process.cwd()) {
+    return ensureVirtualModuleFile(toVirtualDefaultManifestModulePath(projectDir), toInlineManifestModule(EMPTY_MANIFEST_JSON));
+}
+function ensureVirtualEmittedGlobalsModulePath(projectDir = process.cwd()) {
+    return ensureVirtualModuleFile(toVirtualEmittedGlobalsModulePath(projectDir), EMPTY_EMITTED_GLOBALS_MODULE);
+}
+
+export { RESOLVED_MASTER_CSS_MANIFEST_QUERY_PREFIX, VIRTUAL_MODULE_DIR, createVirtualDefaultManifestModulePathPattern, ensureVirtualEmittedGlobalsModulePath, ensureVirtualManifestModulePath, ensureVirtualModuleFile, fromResolvedMasterCSSManifestId, toHashedHydrationManifestAssetFileName, toHashedManifestAssetFileName, toResolvedMasterCSSManifestId, toVirtualCSSManifestAssetPath, toVirtualCSSManifestModulePath, toVirtualCSSModulePath, toVirtualDefaultManifestModulePath, toVirtualEmittedGlobalsModulePath };

package/dist/runtime.d.ts

@@ -0,0 +1,2 @@
+export declare const MASTER_CSS_RUNTIME_INJECTED_MARKER = "/*__MASTER_CSS_RUNTIME_INJECTED__*/";
+export declare const CSS_RUNTIME_INJECTION: string;

package/dist/runtime.mjs

@@ -0,0 +1,19 @@
+import { VIRTUAL_MANIFEST_ID } from './manifest-module.mjs';
+import { VIRTUAL_EMITTED_GLOBALS_ID } from './emitted-globals-module.mjs';
+
+const MASTER_CSS_RUNTIME_INJECTED_MARKER = '/*__MASTER_CSS_RUNTIME_INJECTED__*/';
+const CSS_RUNTIME_INJECTION = [
+    `import { CSSRuntime } from '@master/css-runtime';`,
+    `import masterCSSManifest from '${VIRTUAL_MANIFEST_ID}';`,
+    `import masterCSSEmittedGlobals from '${VIRTUAL_EMITTED_GLOBALS_ID}';`,
+    `if (typeof document !== 'undefined') {`,
+    `const masterCSSRuntime = CSSRuntime.create({ manifest: masterCSSManifest, emittedGlobals: masterCSSEmittedGlobals });`,
+    `if (masterCSSRuntime.needsHydrationManifest()) {`,
+    `void masterCSSRuntime.loadHydrationManifest().then(() => masterCSSRuntime.observe());`,
+    `} else {`,
+    `masterCSSRuntime.observe();`,
+    `}`,
+    `}`
+].join('\n');
+
+export { CSS_RUNTIME_INJECTION, MASTER_CSS_RUNTIME_INJECTED_MARKER };

package/dist/style-module.d.ts

@@ -0,0 +1 @@
+export declare const VIRTUAL_CSS_ID = "virtual:master-utilities.css";

package/dist/style-module.mjs

@@ -0,0 +1,3 @@
+const VIRTUAL_CSS_ID = 'virtual:master-utilities.css';
+
+export { VIRTUAL_CSS_ID };

package/package.json

@@ -0,0 +1 @@
+{"name":"@master/css-integration","type":"module","scripts":{"build":"techor build \"src/**/*.ts\" --formats esm","dev":"pnpm build --watch","type-check":"tsc --noEmit","lint":"eslint","test":"vitest"},"license":"MIT","description":"Shared Master CSS integration contracts, virtual module protocols, and build helpers.","author":"Aoyue Design LLC.","funding":"https://rc.css.master.co/sponsor","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/integration"},"keywords":["integration","virtual-module","css","mastercss"],"sideEffects":false,"main":"./dist/index.mjs","module":"./dist/index.mjs","jsnext:main":"./dist/index.mjs","esnext":"./dist/index.mjs","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","default":"./dist/index.mjs"},"./client":{"types":"./client.d.ts"},"./module":{"types":"./dist/module.d.ts","import":"./dist/module.mjs","default":"./dist/module.mjs"},"./manifest-module":{"types":"./dist/manifest-module.d.ts","import":"./dist/manifest-module.mjs","default":"./dist/manifest-module.mjs"},"./manifest-facade":{"types":"./dist/manifest-facade.d.ts","import":"./dist/manifest-facade.mjs","default":"./dist/manifest-facade.mjs"},"./style-module":{"types":"./dist/style-module.d.ts","import":"./dist/style-module.mjs","default":"./dist/style-module.mjs"},"./emitted-globals-module":{"types":"./dist/emitted-globals-module.d.ts","import":"./dist/emitted-globals-module.mjs","default":"./dist/emitted-globals-module.mjs"},"./manifest-loader-plugin":{"types":"./dist/manifest-loader-plugin.d.ts","import":"./dist/manifest-loader-plugin.mjs","default":"./dist/manifest-loader-plugin.mjs"},"./runtime":{"types":"./dist/runtime.d.ts","import":"./dist/runtime.mjs","default":"./dist/runtime.mjs"},"./node":{"types":"./dist/node.d.ts","import":"./dist/node.mjs","default":"./dist/node.mjs"}},"files":["client.d.ts","dist"],"publishConfig":{"access":"public","provenance":true},"dependencies":{"@master/css-engine":"^2.0.0-rc.70","@master/css-schema":"^2.0.0-rc.70"},"version":"2.0.0-rc.70"}