roundel 0.0.1

package/README.md

@@ -0,0 +1,24 @@
+# roundel
+
+**Not yet released.** This version reserves the name; the first working release follows
+[`docs/intents/cli-style/`](https://github.com/ofri-peretz/burgee/tree/main/docs/intents/cli-style).
+
+A **roundel** is a flag's colours carried onto another surface — the rings on an aircraft's
+wing, the London Underground sign. Identity, expressed purely in colour, on something that is
+not a flag. That is what this package is for a command-line program: not `red` and `blue`,
+but `error`, `hint`, `command` and `flag`, the colours that mean *you*, carried onto the
+terminal as a theme.
+
+## What it will be
+
+- **One output policy**, decided once from the runtime: `tty`, `pipe`, `json`, `accessible`
+  or `ci`. Every component reads it; none detects the terminal on its own.
+- **Semantic tokens** over `util.styleText`, silent under every mode but `tty`.
+- **A theme** that changes every token at once, contrast-checked when it emits truecolor.
+- **`roundel/chalk`** — chalk's API over Node natives, graded by chalk's own test suite, so a
+  migration is one import and your tests are unchanged.
+- **Zero dependencies**, and every subpath measured against the lightest incumbent it replaces.
+
+Part of the [burgee](https://github.com/ofri-peretz/burgee) family: a CLI on burgee declares
+what it is, roundel carries its colours, flagstaff flies it, answerback replies. Each is
+an independent package; none requires the others.

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * roundel — reserved. The first working release follows
+ * docs/intents/cli-style/ in the burgee repository. Until then this entry
+ * exports only its own name, so that importing it costs nothing and promises nothing.
+ */
+export declare const name: "roundel";

package/dist/index.js

@@ -0,0 +1,7 @@
+/**
+ * roundel — reserved. The first working release follows
+ * docs/intents/cli-style/ in the burgee repository. Until then this entry
+ * exports only its own name, so that importing it costs nothing and promises nothing.
+ */
+export const name = 'roundel';
+//# sourceMappingURL=index.js.map

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "roundel",
+  "version": "0.0.1",
+  "description": "The colours a CLI carries. One output policy, semantic tokens, a theme, and a chalk migration path lighter than chalk. Zero dependencies.",
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=24"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.map",
+    "!dist/**/*.test.*"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "lint": "eslint src"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ofri-peretz/burgee.git",
+    "directory": "packages/roundel"
+  },
+  "homepage": "https://github.com/ofri-peretz/burgee/tree/main/packages/roundel#readme",
+  "bugs": {
+    "url": "https://github.com/ofri-peretz/burgee/issues"
+  },
+  "keywords": [
+    "cli",
+    "terminal",
+    "color",
+    "colour",
+    "ansi",
+    "style",
+    "theme",
+    "chalk",
+    "picocolors",
+    "styleText"
+  ],
+  "devDependencies": {
+    "vitest": "^4.0.0"
+  }
+}