flagstaff 0.0.1

package/README.md

@@ -0,0 +1,25 @@
+# flagstaff
+
+**Not yet released.** This version reserves the name; the first working release follows
+[`docs/intents/cli-render/`](https://github.com/ofri-peretz/burgee/tree/main/docs/intents/cli-render).
+
+A **flagstaff** is the staff a flag flies from. It is the simplest part of the whole
+apparatus and the only one that is always in view: a flag is hoisted on it, held there "at the
+dip" or "close up", changed, and lowered when it is done. That is a terminal render loop — the
+place frames are hoisted, held, changed and lowered, in view of whoever is reading.
+
+## What it will be
+
+- **A frame loop with a static projection.** A spinner animates on a TTY, prints one line
+  per state on a pipe, emits one event under `--json`, and is plain text in accessible mode.
+  A component without a static projection is refused at registration.
+- **Plugins as data.** A third-party spinner, progress style or character is a plain object;
+  the built-ins ship in the same shape. A plugin is a flag someone else made, flown from the
+  same staff.
+- **Drop-in paths** for ora, log-update, boxen and cli-table3, graded by their own suites.
+- **No layout engine**, on purpose. Box, columns and a status line are the ceiling.
+- **Zero external dependencies.**
+
+Part of the [burgee](https://github.com/ofri-peretz/burgee) family: a CLI on burgee declares
+what it is, pennon gives it colours, flagstaff flies it, answering is how it replies. Each is
+an independent package; none requires the others.

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * flagstaff — reserved. The first working release follows
+ * docs/intents/cli-render/ 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: "flagstaff";

package/dist/index.js

@@ -0,0 +1,7 @@
+/**
+ * flagstaff — reserved. The first working release follows
+ * docs/intents/cli-render/ 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 = 'flagstaff';
+//# sourceMappingURL=index.js.map

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "flagstaff",
+  "version": "0.0.1",
+  "description": "The staff the flag flies from. A terminal frame loop with a static projection for agents and screen readers, and a plugin host for spinners, progress, boxes and tables. Drop-in paths for ora, log-update, boxen and cli-table3. 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/flagstaff"
+  },
+  "homepage": "https://github.com/ofri-peretz/burgee/tree/main/packages/flagstaff#readme",
+  "bugs": {
+    "url": "https://github.com/ofri-peretz/burgee/issues"
+  },
+  "keywords": [
+    "cli",
+    "terminal",
+    "spinner",
+    "progress",
+    "render",
+    "animation",
+    "ora",
+    "log-update",
+    "boxen",
+    "cli-table3",
+    "plugins"
+  ],
+  "devDependencies": {
+    "vitest": "^4.0.0"
+  }
+}