@master/css 0.0.0-site.1793659883.g69c9aebcf628

package/README.md

@@ -0,0 +1,80 @@
+<br>
+<div align="center">
+
+<p align="center">
+  <a href="https://css.master.co">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://user-images.githubusercontent.com/33840671/201701649-3bb7d698-abec-4d5f-ac30-ccc4d7bafcd4.svg">
+      <source media="(prefers-color-scheme: light)" srcset="https://user-images.githubusercontent.com/33840671/201703010-77bf2373-9899-40cc-98f5-30cf9b546941.svg">
+      <img alt="Master CSS" src="https://user-images.githubusercontent.com/33840671/201703010-77bf2373-9899-40cc-98f5-30cf9b546941.svg" width="100%">
+    </picture>
+  </a>
+</p>
+<p align="center">Compose CSS and project design rules in markup, with tools to trace changes and verify generated styles.</p>
+
+<p align="center">
+  <a aria-label="GitHub release (latest by date including pre-releases)" href="https://github.com/master-co/css/releases">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/github/v/release/master-co/css?include_prereleases&color=212022&label=&style=for-the-badge&logo=github&logoColor=fff">
+      <source media="(prefers-color-scheme: light)" srcset="https://img.shields.io/github/v/release/master-co/css?include_prereleases&color=f6f7f8&label=&style=for-the-badge&logo=github&logoColor=%23000">
+      <img alt="NPM Version" src="https://img.shields.io/github/v/release/master-co/css?include_prereleases&color=f6f7f8&label=&style=for-the-badge&logo=github">
+    </picture>
+  </a>
+  <a aria-label="NPM Package" href="https://www.npmjs.com/package/@master/css">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/npm/dm/@master/css?color=212022&label=%20&logo=npm&style=for-the-badge">
+      <source media="(prefers-color-scheme: light)" srcset="https://img.shields.io/npm/dm/@master/css?color=f6f7f8&label=%20&logo=npm&style=for-the-badge">
+      <img alt="NPM package ( download / month )" src="https://img.shields.io/npm/dm/@master/css?color=f6f7f8&label=%20&logo=npm&style=for-the-badge">
+    </picture>
+  </a>
+  <a aria-label="JSDelivr" href="https://www.jsdelivr.com/package/npm/@master/css">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/jsdelivr/npm/hm/@master/css?color=212022&label=%20&logo=jsdelivr&style=for-the-badge">
+      <source media="(prefers-color-scheme: light)" srcset="https://img.shields.io/jsdelivr/npm/hm/@master/css?color=f6f7f8&label=%20&logo=jsdelivr&style=for-the-badge">
+      <img alt="JSDelivr hits (npm scoped)" src="https://img.shields.io/jsdelivr/npm/hm/@master/css?color=f6f7f8&label=%20&logo=jsdelivr&style=for-the-badge">
+    </picture>
+  </a>
+  <a aria-label="Discord Community" href="https://discord.gg/sZNKpAAAw6">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/discord/917780624314613760?color=212022&label=%20&logo=discord&style=for-the-badge">
+      <source media="(prefers-color-scheme: light)" srcset="https://img.shields.io/discord/917780624314613760?color=f6f7f8&label=%20&logo=discord&style=for-the-badge">
+      <img alt="Discord online" src="https://img.shields.io/discord/917780624314613760?color=f6f7f8&label=%20&logo=discord&style=for-the-badge">
+    </picture>
+  </a>
+  <a aria-label="Follow @mastercorg" href="https://twitter.com/mastercorg">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/static/v1?label=%20&message=twitter&color=212022&logo=twitter&style=for-the-badge">
+      <source media="(prefers-color-scheme: light)" srcset="https://img.shields.io/static/v1?label=%20&message=twitter&color=f6f7f8&logo=twitter&style=for-the-badge">
+      <img alt="Follow @mastercorg" src="https://img.shields.io/static/v1?label=%20&message=twitter&color=f6f7f8&logo=twitter&style=for-the-badge">
+    </picture>
+  </a>
+  <a aria-label="Github Actions" href="https://github.com/master-co/css/actions/workflows/ci-release.yml">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/github/actions/workflow/status/master-co/css/ci-release.yml?branch=rc&label=%20&message=twitter&color=212022&logo=githubactions&style=for-the-badge">
+      <source media="(prefers-color-scheme: light)" srcset="https://img.shields.io/github/actions/workflow/status/master-co/css/ci-release.yml?branch=rc&label=%20&message=twitter&color=f6f7f8&logo=githubactions&style=for-the-badge&logoColor=%23000">
+      <img alt="Github release actions" src="https://img.shields.io/github/actions/workflow/status/master-co/css/ci-release.yml?branch=rc&label=%20&message=twitter&color=f6f7f8&logo=githubactions&style=for-the-badge&logoColor=%23000">
+    </picture>
+  </a>
+</p>
+
+</div>
+
+## Getting started
+
+Read the [installation guide](https://rc.css.master.co/guide/installation) to set up Master CSS for an application.
+
+## Community
+The Master CSS community can be found here:
+
+- [Discuss on GitHub](https://github.com/master-co/css/discussions) - Ask questions, voice ideas, and do any other discussion
+- [Join our Discord Server](https://discord.com/invite/sZNKpAAAw6) - Casually chat with other people using the language <sup><sub>✓ 中文</sub></sup>
+
+<sub>Our [《 Code of Conduct 》](https://github.com/master-co/css/blob/main/CODE_OF_CONDUCT.md) applies to all Master CSS community channels.</sub>
+
+## Contributing
+Please see our [CONTRIBUTING](https://github.com/master-co/css/blob/rc/.github/CONTRIBUTING.md) for workflow.
+
+## Inspiration
+Some of the core concepts and designs are inspired by these giants.
+- The concept of enhanced syntax is inspired by [SASS](https://sass-lang.com/) and [TypeScript](https://www.typescriptlang.org/)
+- The concept of Virtual CSS is inspired by the [Virtual DOM](https://reactjs.org/docs/faq-internals.html)

package/client.d.ts

@@ -0,0 +1,38 @@
+declare module '*?master-css-manifest' {
+  import type { MasterCSSManifest } from '@master/css-schema/manifest'
+
+  const manifest: MasterCSSManifest
+  export default manifest
+}
+
+declare module '*?master-css-program' {
+  /** The CSS entry's manifest compiled into the runtime program browsers execute. */
+  const program: Uint8Array
+  export default program
+}
+
+declare module 'virtual:master-utilities.css' {
+}
+
+declare module 'virtual:master-css-runtime' {
+}
+
+declare module 'virtual:master-css-manifest' {
+  import type { MasterCSSManifest } from '@master/css-schema/manifest'
+
+  const manifest: MasterCSSManifest
+  export default manifest
+}
+
+declare module 'virtual:master-css-program' {
+  /** The project manifest compiled into the runtime program browsers execute. */
+  const program: Uint8Array
+  export default program
+}
+
+declare module 'virtual:master-css-emitted-globals' {
+  import type { MasterCSSEmittedGlobals } from '@master/css-schema/emitted-globals'
+
+  const emittedGlobals: MasterCSSEmittedGlobals
+  export default emittedGlobals
+}

package/dist/engine/binding.d.ts

@@ -0,0 +1,128 @@
+import { MasterCSSEngineBindingSession } from "@master/css-binding/engine";
+import { MasterCSSError } from "@master/css-schema";
+import { MasterCSSBinding, MasterCSSEngineResolvedBinding } from "@master/css-binding";
+import { MasterCSSEmittedGlobals } from "@master/css-schema/emitted-globals";
+import { MasterCSSHydrationRule } from "@master/css-schema/hydration-manifest";
+import { MasterCSSKeyframeDefinition, MasterCSSManifest, MasterCSSManifestUtilityLayerName } from "@master/css-schema/manifest";
+type BindingEngineInspection = ReturnType<MasterCSSEngineBindingSession['inspect']>;
+type MasterCSSRuleTarget = 'keyframes' | 'theme' | 'base' | 'defaults' | 'components' | 'utilities';
+interface MasterCSSEngineInsertMutation {
+  readonly op: 'insert';
+  readonly target: MasterCSSRuleTarget;
+  readonly index: number;
+  readonly key: string;
+  readonly text: string;
+  readonly rule?: MasterCSSHydrationRule;
+}
+interface MasterCSSEngineDeleteMutation {
+  readonly op: 'delete';
+  readonly target: MasterCSSRuleTarget;
+  readonly index: number;
+  readonly key: string;
+}
+type MasterCSSEngineMutation = MasterCSSEngineInsertMutation | MasterCSSEngineDeleteMutation;
+interface MasterCSSEngineTransition {
+  readonly version: 5;
+  readonly mutations: readonly MasterCSSEngineMutation[];
+}
+interface MasterCSSEngineVariableResource {
+  readonly name: string;
+  readonly refCount: number;
+  readonly dependencies: readonly string[];
+}
+interface MasterCSSEngineResources {
+  readonly themeText?: string;
+  readonly variables: readonly MasterCSSEngineVariableResource[];
+  readonly keyframes: readonly (MasterCSSEngineVariableResource & {
+    readonly id: string;
+    readonly text: string;
+    readonly containers?: readonly {
+      readonly id: string;
+      readonly prelude: string;
+    }[];
+  })[];
+}
+interface MasterCSSEngineExecutionState {
+  readonly classes: readonly {
+    readonly className: string;
+    readonly references: readonly {
+      readonly layer: MasterCSSManifestUtilityLayerName;
+      readonly key: string;
+    }[];
+  }[];
+  readonly resources: MasterCSSEngineResources;
+}
+interface MasterCSSEngineSnapshot {
+  readonly version: 5;
+  readonly rules: readonly MasterCSSHydrationRule[];
+  readonly resources: MasterCSSEngineResources;
+  readonly text: string;
+  readonly stylesheets?: readonly string[];
+}
+interface MasterCSSEngineInspection {
+  readonly version: 2;
+  readonly className: string;
+  readonly matchStatus: 'matched' | 'unmatched' | 'ambiguous' | 'syntax-error';
+  readonly cssSyntaxStatus: BindingEngineInspection['cssSyntaxStatus'];
+  readonly cssValueStatus: 'valid' | 'invalid' | 'unknown' | 'not-checked';
+  readonly browserSupport: 'supported' | 'unsupported' | 'unknown' | 'not-checked';
+  readonly rules: readonly MasterCSSHydrationRule[];
+  readonly diagnostics?: Readonly<BindingEngineInspection['diagnostics']>;
+}
+/**
+ * What an engine executes: a runtime program that `compileRuntimeProgram()` from
+ * `@master/css/node` compiled, or a manifest, which only Node hosts compile.
+ */
+type MasterCSSEngineSource = {
+  readonly program: Uint8Array;
+  readonly manifest?: never;
+} | {
+  readonly manifest: MasterCSSManifest;
+  readonly program?: never;
+};
+type MasterCSSEngineBindingOptions = MasterCSSEngineSource & {
+  readonly emittedGlobals?: MasterCSSEmittedGlobals;
+};
+interface MasterCSSEngineBinding {
+  readonly kind: MasterCSSEngineResolvedBinding;
+  createEngine(options: MasterCSSEngineBindingOptions): Promise<MasterCSSEngine>;
+  createEngineSync?(options: MasterCSSEngineBindingOptions): MasterCSSEngine;
+}
+type MasterCSSEngineOptions = MasterCSSEngineBindingOptions & {
+  readonly binding?: MasterCSSBinding | MasterCSSEngineBinding;
+};
+interface MasterCSSEngine extends Disposable {
+  readonly binding: MasterCSSEngineResolvedBinding;
+  ensureClassRules(classNames: readonly string[]): MasterCSSEngineTransition;
+  deleteClassRules(classNames: readonly string[]): MasterCSSEngineTransition;
+  /**
+   * Adds host-owned variable counts to the active engine session.
+   * Counts are cumulative for the lifetime of the session and cannot be unregistered.
+   */
+  registerEmittedGlobals(emittedGlobals: MasterCSSEmittedGlobals): MasterCSSEngineTransition;
+  replaceEmittedGlobals(emittedGlobals: MasterCSSEmittedGlobals): MasterCSSEngineTransition;
+  /** Executes another program or, in Node, manifest; the source kind may change. */
+  refresh(source: Uint8Array | MasterCSSManifest, emittedGlobals?: MasterCSSEmittedGlobals): MasterCSSEngineTransition;
+  /** The keyframe definitions of the executed program, in program order. */
+  keyframeDefinitions(): readonly MasterCSSKeyframeDefinition[];
+  executionState(classNames: readonly string[]): MasterCSSEngineExecutionState;
+  inspect(className: string): MasterCSSEngineInspection;
+  snapshot(): MasterCSSEngineSnapshot;
+  dispose(): void;
+}
+interface BindingEngineSession {
+  ensureClassRules(classNames: readonly string[]): MasterCSSEngineTransition;
+  deleteClassRules(classNames: readonly string[]): MasterCSSEngineTransition;
+  registerEmittedGlobals(emittedGlobals: MasterCSSEmittedGlobals): MasterCSSEngineTransition;
+  replaceEmittedGlobals(emittedGlobals: MasterCSSEmittedGlobals): MasterCSSEngineTransition;
+  refresh(source: Uint8Array | MasterCSSManifest, emittedGlobals?: MasterCSSEmittedGlobals): MasterCSSEngineTransition;
+  keyframeDefinitions(): readonly MasterCSSKeyframeDefinition[];
+  executionState(classNames: readonly string[]): MasterCSSEngineExecutionState;
+  inspect(className: string): MasterCSSEngineInspection;
+  snapshot(): MasterCSSEngineSnapshot;
+  dispose(): void;
+}
+declare function normalizeEngineError(cause: unknown, fallbackCode?: string, fallbackMessage?: string): MasterCSSError;
+/** The binding options of engine options, without the binding choice. */
+declare function engineSource(options: MasterCSSEngineOptions): MasterCSSEngineBindingOptions;
+export { BindingEngineSession, MasterCSSEngine, MasterCSSEngineBinding, MasterCSSEngineBindingOptions, MasterCSSEngineDeleteMutation, MasterCSSEngineExecutionState, MasterCSSEngineInsertMutation, MasterCSSEngineInspection, MasterCSSEngineMutation, MasterCSSEngineOptions, MasterCSSEngineResources, MasterCSSEngineSnapshot, MasterCSSEngineSource, MasterCSSEngineTransition, MasterCSSEngineVariableResource, MasterCSSRuleTarget, engineSource, normalizeEngineError };

package/dist/engine/binding.js

@@ -0,0 +1,21 @@
+import { MasterCSSError } from "@master/css-schema";
+// src/engine/binding.ts
+function normalizeEngineError(cause, fallbackCode = "INTERNAL", fallbackMessage = "Master CSS engine operation failed.") {
+	if (cause instanceof MasterCSSError) return cause;
+	return new MasterCSSError({
+		code: fallbackCode,
+		domain: "engine",
+		message: cause instanceof Error ? cause.message : fallbackMessage
+	}, { cause });
+}
+/** The binding options of engine options, without the binding choice. */
+function engineSource(options) {
+	return options.program ? {
+		program: options.program,
+		emittedGlobals: options.emittedGlobals
+	} : {
+		manifest: options.manifest,
+		emittedGlobals: options.emittedGlobals
+	};
+}
+export { engineSource, normalizeEngineError };

package/dist/engine/bound-engine.d.ts

@@ -0,0 +1,24 @@
+import { MasterCSSEngineResolvedBinding } from "@master/css-binding";
+import { MasterCSSEmittedGlobals } from "@master/css-schema/emitted-globals";
+import { MasterCSSManifest } from "@master/css-schema/manifest";
+import { BindingEngineSession, MasterCSSEngine, MasterCSSEngineExecutionState, MasterCSSEngineInspection, MasterCSSEngineSnapshot, MasterCSSEngineTransition } from "./binding.js";
+declare class BoundEngine implements MasterCSSEngine {
+  readonly binding: MasterCSSEngineResolvedBinding;
+  private readonly session;
+  private disposed;
+  constructor(binding: MasterCSSEngineResolvedBinding, session: BindingEngineSession);
+  ensureClassRules(classNames: readonly string[]): MasterCSSEngineTransition;
+  deleteClassRules(classNames: readonly string[]): MasterCSSEngineTransition;
+  registerEmittedGlobals(emittedGlobals: MasterCSSEmittedGlobals): MasterCSSEngineTransition;
+  replaceEmittedGlobals(emittedGlobals: MasterCSSEmittedGlobals): MasterCSSEngineTransition;
+  refresh(source: Uint8Array | MasterCSSManifest, emittedGlobals?: MasterCSSEmittedGlobals): MasterCSSEngineTransition;
+  keyframeDefinitions(): readonly import("@master/css-schema/manifest").MasterCSSKeyframeDefinition[];
+  executionState(classNames: readonly string[]): MasterCSSEngineExecutionState;
+  inspect(className: string): MasterCSSEngineInspection;
+  snapshot(): MasterCSSEngineSnapshot;
+  dispose(): void;
+  [Symbol.dispose](): void;
+  private assertActive;
+  private invoke;
+}
+export { BoundEngine as default };

package/dist/engine/bound-engine.js

@@ -0,0 +1,76 @@
+import { normalizeEngineError } from "./binding.js";
+import { MasterCSSError } from "@master/css-schema";
+// src/engine/bound-engine.ts
+var BoundEngine = class {
+	binding;
+	session;
+	disposed = false;
+	constructor(binding, session) {
+		this.binding = binding;
+		this.session = session;
+	}
+	ensureClassRules(classNames) {
+		this.assertActive();
+		return this.invoke(() => freezeResult(this.session.ensureClassRules([...classNames])));
+	}
+	deleteClassRules(classNames) {
+		this.assertActive();
+		return this.invoke(() => freezeResult(this.session.deleteClassRules([...classNames])));
+	}
+	registerEmittedGlobals(emittedGlobals) {
+		this.assertActive();
+		return this.invoke(() => freezeResult(this.session.registerEmittedGlobals(emittedGlobals)));
+	}
+	replaceEmittedGlobals(emittedGlobals) {
+		this.assertActive();
+		return this.invoke(() => freezeResult(this.session.replaceEmittedGlobals(emittedGlobals)));
+	}
+	refresh(source, emittedGlobals) {
+		this.assertActive();
+		return this.invoke(() => freezeResult(this.session.refresh(source, emittedGlobals)));
+	}
+	keyframeDefinitions() {
+		this.assertActive();
+		return this.invoke(() => freezeResult(this.session.keyframeDefinitions()));
+	}
+	executionState(classNames) {
+		this.assertActive();
+		return this.invoke(() => freezeResult(this.session.executionState(classNames)));
+	}
+	inspect(className) {
+		this.assertActive();
+		return this.invoke(() => freezeResult(this.session.inspect(className)));
+	}
+	snapshot() {
+		this.assertActive();
+		return this.invoke(() => freezeResult(this.session.snapshot()));
+	}
+	dispose() {
+		if (this.disposed) return;
+		this.session.dispose();
+		this.disposed = true;
+	}
+	[Symbol.dispose]() {
+		this.dispose();
+	}
+	assertActive() {
+		if (this.disposed) throw new MasterCSSError({
+			code: "SESSION_DISPOSED",
+			domain: "engine",
+			message: "Master CSS engine session has been disposed."
+		});
+	}
+	invoke(operation) {
+		try {
+			return operation();
+		} catch (cause) {
+			throw normalizeEngineError(cause);
+		}
+	}
+};
+function freezeResult(value) {
+	if (!value || typeof value !== "object" || Object.isFrozen(value)) return value;
+	for (const child of Object.values(value)) freezeResult(child);
+	return Object.freeze(value);
+}
+export { BoundEngine as default };

package/dist/engine/create-engine.d.ts

@@ -0,0 +1,3 @@
+import { MasterCSSEngine, MasterCSSEngineOptions } from "./binding.js";
+declare function createEngine(options: MasterCSSEngineOptions): Promise<MasterCSSEngine>;
+export { createEngine as default };

package/dist/engine/create-engine.js

@@ -0,0 +1,10 @@
+import { engineSource } from "./binding.js";
+import BoundEngine from "./bound-engine.js";
+import { createEngineBindingSession } from "@master/css-binding/engine";
+// src/engine/create-engine.ts
+async function createEngine(options) {
+	if (options.binding && typeof options.binding === "object") return await options.binding.createEngine(engineSource(options));
+	const session = await createEngineBindingSession(options, { binding: options.binding });
+	return new BoundEngine(session.binding, session);
+}
+export { createEngine as default };

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import { MasterCSSEngine, MasterCSSEngineBinding, MasterCSSEngineBindingOptions, MasterCSSEngineDeleteMutation, MasterCSSEngineExecutionState, MasterCSSEngineInsertMutation, MasterCSSEngineInspection, MasterCSSEngineMutation, MasterCSSEngineOptions, MasterCSSEngineResources, MasterCSSEngineSnapshot, MasterCSSEngineSource, MasterCSSEngineTransition, MasterCSSEngineVariableResource, MasterCSSRuleTarget } from "./engine/binding.js";
+import createEngine from "./engine/create-engine.js";
+import { renderClassNames } from "./render-class-names.js";
+import { MasterCSSNativeDeclaration, MasterCSSRenderSessionOptions, MasterCSSRenderSnapshot } from "./render-session.js";
+export { type MasterCSSEngine, type MasterCSSEngineBinding, type MasterCSSEngineBindingOptions, type MasterCSSEngineDeleteMutation, type MasterCSSEngineExecutionState, type MasterCSSEngineInsertMutation, type MasterCSSEngineInspection, type MasterCSSEngineMutation, type MasterCSSEngineOptions, type MasterCSSEngineResources, type MasterCSSEngineSnapshot, type MasterCSSEngineSource, type MasterCSSEngineTransition, type MasterCSSEngineVariableResource, type MasterCSSNativeDeclaration, type MasterCSSRenderSessionOptions, type MasterCSSRenderSnapshot, type MasterCSSRuleTarget, createEngine, renderClassNames };

package/dist/index.js

@@ -0,0 +1,3 @@
+import { renderClassNames } from "./render-class-names.js";
+import createEngine from "./engine/create-engine.js";
+export { createEngine, renderClassNames };

package/dist/node.d.ts

@@ -0,0 +1,19 @@
+import { MasterCSSBinding } from "@master/css-binding";
+import { MasterCSSManifest } from "@master/css-schema/manifest";
+import { MasterCSSEngine, MasterCSSEngine as MasterCSSEngine$1, MasterCSSEngineBinding, MasterCSSEngineBinding as MasterCSSEngineBinding$1, MasterCSSEngineBindingOptions, MasterCSSEngineOptions, MasterCSSEngineOptions as MasterCSSEngineOptions$1, MasterCSSEngineSource } from "./engine/binding.js";
+import { MasterCSSNativeDeclaration, MasterCSSRenderSession, MasterCSSRenderSession as MasterCSSRenderSession$1, MasterCSSRenderSessionOptions, MasterCSSRenderSessionOptions as MasterCSSRenderSessionOptions$1, MasterCSSRenderSnapshot } from "./render-session.js";
+declare function createNativeEngineBinding(): MasterCSSEngineBinding$1;
+declare function createEngineSync(options: MasterCSSEngineOptions$1): MasterCSSEngine$1;
+interface MasterCSSCompileRuntimeProgramOptions {
+  readonly binding?: MasterCSSBinding;
+}
+/**
+ * Compiles a manifest into the runtime program that browser engines execute, with
+ * the native binding or, when it is unavailable, the Wasm one.
+ */
+declare function compileRuntimeProgram(manifest: MasterCSSManifest, options?: MasterCSSCompileRuntimeProgramOptions): Promise<Uint8Array>;
+/** Compiles a runtime program with the native binding. */
+declare function compileRuntimeProgramSync(manifest: MasterCSSManifest): Uint8Array;
+declare function createRenderSessionSync(options: MasterCSSRenderSessionOptions$1): MasterCSSRenderSession$1;
+declare function renderClassNamesSync(classNames: readonly string[], options: MasterCSSRenderSessionOptions$1): import("./render-session.js").MasterCSSRenderSnapshot;
+export { MasterCSSCompileRuntimeProgramOptions, type MasterCSSEngine, type MasterCSSEngineBinding, type MasterCSSEngineBindingOptions, type MasterCSSEngineOptions, type MasterCSSEngineSource, type MasterCSSNativeDeclaration, MasterCSSRenderSession, type MasterCSSRenderSessionOptions, type MasterCSSRenderSnapshot, compileRuntimeProgram, compileRuntimeProgramSync, createEngineSync, createNativeEngineBinding, createRenderSessionSync, renderClassNamesSync };

package/dist/node.js

@@ -0,0 +1,87 @@
+import { MasterCSSRenderSession, bindRenderSessionInternal } from "./render-session.js";
+import { engineSource, normalizeEngineError } from "./engine/binding.js";
+import BoundEngine from "./engine/bound-engine.js";
+import { compileRuntimeProgram as compileRuntimeProgram$1 } from "@master/css-binding/engine";
+import { compileRuntimeProgramSync as compileRuntimeProgramSync$1, createEngineBindingSessionSync, createRenderBindingSessionSync } from "@master/css-binding/engine/node";
+import { MasterCSSError } from "@master/css-schema";
+// src/node.ts
+function createNativeEngine(options) {
+	const session = createEngineBindingSessionSync(options);
+	return new BoundEngine("native", session);
+}
+function createNativeEngineBinding() {
+	return Object.freeze({
+		kind: "native",
+		async createEngine(options) {
+			return createNativeEngine(options);
+		},
+		createEngineSync(options) {
+			return createNativeEngine(options);
+		}
+	});
+}
+function createEngineSync(options) {
+	if (options.binding && typeof options.binding === "object") {
+		if (!options.binding.createEngineSync) throw new MasterCSSError({
+			code: "NATIVE_UNAVAILABLE",
+			domain: "engine",
+			message: "The injected Master CSS binding does not support synchronous engine creation."
+		});
+		return options.binding.createEngineSync(engineSource(options));
+	}
+	if (options.binding === "wasm") throw new MasterCSSError({
+		code: "NATIVE_UNAVAILABLE",
+		domain: "engine",
+		message: "createEngineSync() only supports the native binding. Use createEngine() for Wasm."
+	});
+	try {
+		return createNativeEngine(options);
+	} catch (cause) {
+		if (cause instanceof MasterCSSError && cause.domain === "binding") throw new MasterCSSError({
+			code: cause.code,
+			domain: "engine",
+			message: cause.message
+		}, { cause });
+		throw normalizeEngineError(cause);
+	}
+}
+/**
+* Compiles a manifest into the runtime program that browser engines execute, with
+* the native binding or, when it is unavailable, the Wasm one.
+*/
+async function compileRuntimeProgram(manifest, options = {}) {
+	try {
+		return await compileRuntimeProgram$1(manifest, { binding: options.binding });
+	} catch (cause) {
+		throw normalizeEngineError(cause);
+	}
+}
+/** Compiles a runtime program with the native binding. */
+function compileRuntimeProgramSync(manifest) {
+	try {
+		return compileRuntimeProgramSync$1(manifest);
+	} catch (cause) {
+		throw normalizeEngineError(cause);
+	}
+}
+function createRenderSessionSync(options) {
+	const native = createRenderBindingSessionSync(options);
+	return bindRenderSessionInternal({
+		nativeDeclarationCandidates: (classNames) => native.nativeDeclarationCandidates(classNames),
+		ensureClasses: (classNames) => native.ensureClassRules(classNames),
+		ensureStylesheetResources: (nativeCSS) => native.ensureStylesheetResources(nativeCSS),
+		emittedGlobals: () => native.emittedGlobals(),
+		snapshot: () => native.snapshot(),
+		snapshotForClasses: (classNames) => native.snapshotForClassNames(classNames),
+		dispose: () => native.dispose()
+	});
+}
+function renderClassNamesSync(classNames, options) {
+	const session = createRenderSessionSync(options);
+	try {
+		return session.ensureClassRules(classNames);
+	} finally {
+		session.dispose();
+	}
+}
+export { MasterCSSRenderSession, compileRuntimeProgram, compileRuntimeProgramSync, createEngineSync, createNativeEngineBinding, createRenderSessionSync, renderClassNamesSync };

package/dist/render-class-names.d.ts

@@ -0,0 +1,3 @@
+import { MasterCSSRenderSessionOptions } from "./render-session.js";
+declare function renderClassNames(classNames: readonly string[], options: MasterCSSRenderSessionOptions): Promise<import("./render-session.js").MasterCSSRenderSnapshot>;
+export { renderClassNames };

package/dist/render-class-names.js

@@ -0,0 +1,21 @@
+import { bindRenderSessionInternal } from "./render-session.js";
+import { createRenderBindingSession } from "@master/css-binding/engine";
+// src/render-class-names.ts
+async function renderClassNames(classNames, options) {
+	const binding = await createRenderBindingSession(options);
+	const session = bindRenderSessionInternal({
+		nativeDeclarationCandidates: (classNames) => binding.nativeDeclarationCandidates(classNames),
+		ensureClasses: (classNames) => binding.ensureClassRules(classNames),
+		ensureStylesheetResources: (nativeCSS) => binding.ensureStylesheetResources(nativeCSS),
+		emittedGlobals: () => binding.emittedGlobals(),
+		snapshot: () => binding.snapshot(),
+		snapshotForClasses: (classNames) => binding.snapshotForClassNames(classNames),
+		dispose: () => binding.dispose()
+	});
+	try {
+		return session.ensureClassRules(classNames);
+	} finally {
+		session.dispose();
+	}
+}
+export { renderClassNames };

package/dist/render-session.d.ts

@@ -0,0 +1,51 @@
+import { MasterCSSEmittedGlobals } from "@master/css-schema/emitted-globals";
+import { MasterCSSHydrationManifest, MasterCSSHydrationRule } from "@master/css-schema/hydration-manifest";
+import { MasterCSSManifest } from "@master/css-schema/manifest";
+import { MasterCSSEngineSnapshot } from "./engine/binding.js";
+interface MasterCSSNativeDeclaration {
+  readonly className: string;
+  readonly property: string;
+  readonly value: string;
+}
+interface MasterCSSRenderSessionOptions {
+  readonly manifest: MasterCSSManifest;
+  readonly emittedGlobals?: MasterCSSEmittedGlobals;
+}
+interface MasterCSSRenderSnapshot {
+  readonly classNames: readonly string[];
+  readonly invalidClassNames: readonly string[];
+  readonly cssText: string;
+  readonly rules: readonly MasterCSSHydrationRule[];
+  readonly classRules: Readonly<Record<string, readonly MasterCSSHydrationRule[]>>;
+  readonly engine: MasterCSSEngineSnapshot;
+  readonly emittedGlobals: MasterCSSEmittedGlobals;
+  readonly hydrationManifest: MasterCSSHydrationManifest;
+}
+interface BindingRenderResult {
+  classes: string[];
+  snapshot: MasterCSSEngineSnapshot;
+  hydrationManifest: MasterCSSHydrationManifest;
+}
+interface BindingRenderSession {
+  nativeDeclarationCandidates(classNames: readonly string[]): readonly MasterCSSNativeDeclaration[];
+  ensureClasses(classNames: readonly string[]): void;
+  ensureStylesheetResources(nativeCSS: string): void;
+  emittedGlobals(): MasterCSSEmittedGlobals;
+  snapshot(): BindingRenderResult;
+  snapshotForClasses(classNames: readonly string[]): BindingRenderResult;
+  dispose(): void;
+}
+declare class MasterCSSRenderSession implements Disposable {
+  #private;
+  private constructor();
+  ensureClassRules(classNames: readonly string[]): MasterCSSRenderSnapshot;
+  ensureStylesheetResources(nativeCSS: string): this;
+  snapshot(): MasterCSSRenderSnapshot;
+  snapshotForClassNames(classNames: readonly string[]): MasterCSSRenderSnapshot;
+  dispose(): void;
+  [Symbol.dispose](): void;
+  private assertActive;
+}
+/** @internal */
+declare function bindRenderSessionInternal(session: BindingRenderSession): MasterCSSRenderSession;
+export { BindingRenderSession, MasterCSSNativeDeclaration, MasterCSSRenderSession, MasterCSSRenderSessionOptions, MasterCSSRenderSnapshot, bindRenderSessionInternal };

package/dist/render-session.js

@@ -0,0 +1,80 @@
+import { MasterCSSError } from "@master/css-schema";
+// src/render-session.ts
+function freezeArray(values) {
+	return Object.freeze([...values]);
+}
+function toSnapshot(rendered, emittedGlobals) {
+	const classRules = Object.create(null);
+	for (const rule of rendered.snapshot.rules) (classRules[rule.className] ||= []).push(rule);
+	for (const rules of Object.values(classRules)) Object.freeze(rules);
+	const classNames = freezeArray(rendered.classes);
+	return Object.freeze({
+		classNames,
+		invalidClassNames: freezeArray(classNames.filter((className) => !Object.hasOwn(classRules, className))),
+		cssText: rendered.snapshot.text,
+		rules: freezeArray(rendered.snapshot.rules),
+		classRules: Object.freeze(classRules),
+		engine: Object.freeze(rendered.snapshot),
+		emittedGlobals: Object.freeze({ ...emittedGlobals }),
+		hydrationManifest: Object.freeze({
+			...rendered.hydrationManifest,
+			classNames: freezeArray(rendered.hydrationManifest.classNames),
+			resourceOrder: Object.freeze({
+				variables: freezeArray(rendered.hydrationManifest.resourceOrder.variables),
+				keyframes: freezeArray(rendered.hydrationManifest.resourceOrder.keyframes)
+			})
+		})
+	});
+}
+let bindRenderSession;
+var MasterCSSRenderSession = class MasterCSSRenderSession {
+	#session;
+	#disposed = false;
+	constructor() {}
+	ensureClassRules(classNames) {
+		this.assertActive();
+		const classes = [...classNames];
+		this.#session.ensureClasses(classes);
+		return this.snapshot();
+	}
+	ensureStylesheetResources(nativeCSS) {
+		this.assertActive();
+		this.#session.ensureStylesheetResources(nativeCSS);
+		return this;
+	}
+	snapshot() {
+		this.assertActive();
+		return toSnapshot(this.#session.snapshot(), this.#session.emittedGlobals());
+	}
+	snapshotForClassNames(classNames) {
+		this.assertActive();
+		return toSnapshot(this.#session.snapshotForClasses([...classNames]), this.#session.emittedGlobals());
+	}
+	dispose() {
+		if (this.#disposed) return;
+		this.#session.dispose();
+		this.#disposed = true;
+	}
+	[Symbol.dispose]() {
+		this.dispose();
+	}
+	assertActive() {
+		if (this.#disposed) throw new MasterCSSError({
+			code: "SESSION_DISPOSED",
+			domain: "engine",
+			message: "The Master CSS render session has been disposed."
+		});
+	}
+	static {
+		bindRenderSession = (session) => {
+			const renderer = new MasterCSSRenderSession();
+			renderer.#session = session;
+			return renderer;
+		};
+	}
+};
+/** @internal */
+function bindRenderSessionInternal(session) {
+	return bindRenderSession(session);
+}
+export { MasterCSSRenderSession, bindRenderSessionInternal };

package/package.json

@@ -0,0 +1,82 @@
+{
+    "name": "@master/css",
+    "type": "module",
+    "engines": {
+        "node": "^24"
+    },
+    "license": "MIT",
+    "description": "The CSS language and framework for rapidly building modern and high-performance websites",
+    "author": "Aoyue Design LLC.",
+    "homepage": "https://css.master.co",
+    "bugs": {
+        "url": "https://github.com/master-co/css/issues"
+    },
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/master-co/css.git",
+        "directory": "packages/css"
+    },
+    "keywords": [
+        "style",
+        "styles",
+        "html",
+        "variants",
+        "virtual",
+        "virtual-css",
+        "utility",
+        "css",
+        "ui",
+        "lightweight",
+        "class",
+        "webpack",
+        "plugin",
+        "integration",
+        "vite",
+        "parcel",
+        "build-tools",
+        "mastercss"
+    ],
+    "sideEffects": [
+        "./src/*.css"
+    ],
+    "style": "./src/index.css",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "style": "./src/index.css",
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js",
+            "default": "./dist/index.js"
+        },
+        "./node": {
+            "types": "./dist/node.d.ts",
+            "import": "./dist/node.js",
+            "default": "./dist/node.js"
+        },
+        "./client": {
+            "types": "./client.d.ts"
+        },
+        "./index.css": "./src/index.css",
+        "./base.css": "./src/base.css",
+        "./theme.css": "./src/theme.css",
+        "./media.css": "./src/media.css",
+        "./container.css": "./src/container.css",
+        "./utilities.css": "./src/utilities.css"
+    },
+    "files": [
+        "client.d.ts",
+        "dist",
+        "src/*.css"
+    ],
+    "publishConfig": {
+        "access": "public",
+        "provenance": true
+    },
+    "dependencies": {
+        "@master/css-binding": "0.0.0-site.1793659883.g69c9aebcf628",
+        "@master/css-schema": "0.0.0-site.1793659883.g69c9aebcf628",
+        "@master/css-preset": "0.0.0-site.1793659883.g69c9aebcf628"
+    },
+    "version": "0.0.0-site.1793659883.g69c9aebcf628",
+    "gitHead": "69c9aebcf628eb529001b9fa1b3536306f1b139e"
+}

package/src/base.css

@@ -0,0 +1 @@
+@import "@master/css-preset/base.css";

package/src/container.css

@@ -0,0 +1 @@
+@import "@master/css-preset/container.css";

package/src/index.css

@@ -0,0 +1 @@
+@import "@master/css-preset";

package/src/media.css

@@ -0,0 +1 @@
+@import "@master/css-preset/media.css";

package/src/theme.css

@@ -0,0 +1 @@
+@import "@master/css-preset/theme.css";

package/src/utilities.css

@@ -0,0 +1 @@
+@import "@master/css-preset/utilities.css";