@master/css-project

Installation

npm install @master/css-project

@master/css-project is the shared project manifest boundary for CLI commands, ESLint, language tooling, and build integrations such as Vite, Next.js, Webpack, and Nuxt.

It discovers project CSS entries and Master CSS workspace roots, then delegates CSS parsing, import graph resolution, and manifest compilation to @master/css-compiler. JavaScript and TypeScript config files are intentionally unsupported.

Project entry discovery only treats CSS files with top-level @master; or @import '@master/css' as entries. Imported @settings, @theme, and @custom-variant directives participate in the entry graph, but they are not independent project entries.

Load project manifest

Use loadProjectManifest() when a tool should load the canonical project-level manifest for a directory.

import { loadProjectManifest, loadProjectManifestJSON } from '@master/css-project/manifest'

const result = await loadProjectManifest('/project')
const jsonResult = await loadProjectManifestJSON('/project')

loadProjectManifest() discovers project CSS entries unless explicit entries are passed. It returns the compiled manifest and dependency list. loadProjectManifestJSON() returns JSON source for virtual JSON modules and loader output.

import { loadProjectManifestSync, loadProjectManifestJSONSync } from '@master/css-project/manifest-sync'

const result = loadProjectManifestSync('/project')
const jsonResult = loadProjectManifestJSONSync('/project')

Load explicit CSS resources

Use loadManifest() when the CSS resource path is already known and should be compiled directly.

import { loadManifest, loadManifestJSON } from '@master/css-project/manifest'

const result = await loadManifest('/project/src/index.css')
const jsonResult = await loadManifestJSON('/project/src/index.css')

loadManifest() and loadManifestJSON() only accept CSS resources. They do not search the workspace and do not load JavaScript or TypeScript config files.

import { loadManifestSync, loadManifestJSONSync } from '@master/css-project/manifest-sync'

const result = loadManifestSync('/project/src/index.css')
const jsonResult = loadManifestJSONSync('/project/src/index.css')

Discover entries and workspaces

Use @master/css-project/entries when tooling needs the same project entry and workspace discovery rules without loading a manifest.

import {
    findCSSManifestEntryFiles,
    findMasterCSSWorkspaceDirectories,
    hasMasterCSSManifestEntrypoint,
} from '@master/css-project/entries'

findCSSManifestEntryFiles(projectDir) searches CSS files for entry markers. findMasterCSSWorkspaceDirectories(rootDir) creates workspace roots from discovered CSS entries and package.json files that declare Master CSS package dependencies.

Manifest modules

The module utilities define the manifest import contract used by official integrations. They live in @master/css-integration; @master/css-project owns loading and discovery.

Use virtual:master-css-manifest and virtual:master-css-emitted-globals when application code should receive an integration's canonical project-level runtime inputs. Use ./index.css?master-css-manifest only when the code intentionally compiles one explicit CSS resource through the active integration.