This repository owns its application mappings, generator, tests and committed theme files. It does not depend on a core checkout during normal builds or installation. Requires Node 22.22+ and pnpm 12.9.0 for maintenance only.
pnpm install --frozen-lockfile
pnpm build
pnpm check
pnpm testsrc/generate.mjs: this application's format and semantic-role mappings. The interface isgenerate(flavors), returning{ path, content }records for the four resolved flavors in the pinned snapshot. It performs no writes.palette/theme.json: app-agnostic resolved palette data, pinned to a core Git revision and SHA-256 fingerprint.scripts/color.mjs: vendored core color math used for application-specific mixtures, verified against the pin.scripts/generated.json: this port's explicit managed-file allowlist. Build changes only these files; check reports stale bytes without writing them. Neither command contacts GitHub or reads another repository.test/: deterministic generation, palette adoption, containment and applicable native-format/grammar/semantic role regressions. These are maintained here, not in a central application generator.
README, metadata, marketplace identities, licenses, icons, screenshots, handwritten runtime files and publishing workflows are not generated. Packaging uses committed files and refuses stale generated themes; it does not rebuild.
In a reviewed core checkout, run pnpm build, pnpm check and
pnpm test, then commit the palette/math inputs. In this port:
pnpm palette:update /path/to/core
pnpm build
pnpm check
pnpm testThe update command verifies core's export against its committed palette/resolver/math files, refuses dirty/stale
inputs, and changes only this port's palette pin. It is never run on install or as part of a normal build. If core's
color math changed, review and copy that revision's src/color.mjs into this port's scripts/color.mjs first.
Review the pin and generated diff in this repository's own pull request. Preserve intentional app-specific choices; update expected role contracts only when the policy change is deliberate. Refresh real application screenshots when visible colors change. Publishing and release workflows remain separate maintainer operations.
Refresh this editor’s capture vocabulary deliberately with node scripts/update-captures.mjs. This optional command
fetches only this editor’s upstream queries/docs; review test/fixtures/captures.json and its role contract before committing.