linegauge 0.0.1

package/README.md

@@ -0,0 +1,22 @@
+# linegauge
+
+**Not yet released, and not yet on the roadmap.** This version reserves the name. The layer,
+its incumbents and the measurements behind it are documented in
+[`.sdlc/research/candidate-layers.md`](https://github.com/ofri-peretz/burgee/blob/main/.sdlc/research/candidate-layers.md).
+An intent and a working release follow if and when the roadmap takes it up.
+
+A **line gauge** is the printer's ruler — the steel rule marked in picas and points that a compositor uses to measure a line of type and check it fits the measure it was set to.
+
+That is this package's whole job. Width, wrap, truncate and slice are one problem wearing four names: **cutting styled text without letting the edge come apart** — no dangling escape sequence, no half a grapheme, no severed emoji cluster.
+
+## What it will be
+
+- **One package, not eleven.** `width` · `wrap` · `truncate` · `slice` · `strip` · `widest`. The incumbents split this across `string-width`, `wrap-ansi`, `strip-ansi`, `slice-ansi`, `cli-truncate`, `widest-line`, `string-length`, `wcwidth`, `eastasianwidth` and `get-east-asian-width`.
+- **Grapheme-correct by construction.** ZWJ families, regional-indicator flags, skin-tone modifiers, keycaps, combining marks and East Asian wide characters, over the platform's own `Intl.Segmenter`.
+- **Fast path for ASCII.** A byte scan when the string has no non-ASCII code unit; the segmenter only when it earns its cost.
+- **Drop-in paths** for `string-width`, `wrap-ansi`, `strip-ansi` and `slice-ansi`, graded by their own suites.
+- **Zero external dependencies.**
+
+## Licence
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * linegauge — name reserved, not yet on the roadmap. The layer and the measurements
+ * behind it are documented in .sdlc/research/candidate-layers.md in the burgee
+ * repository. Until an intent is opened this entry exports only its own name, so
+ * that importing it costs nothing and promises nothing.
+ */
+export declare const name: "linegauge";

package/dist/index.js

@@ -0,0 +1,8 @@
+/**
+ * linegauge — name reserved, not yet on the roadmap. The layer and the measurements
+ * behind it are documented in .sdlc/research/candidate-layers.md in the burgee
+ * repository. Until an intent is opened this entry exports only its own name, so
+ * that importing it costs nothing and promises nothing.
+ */
+export const name = 'linegauge';
+//# sourceMappingURL=index.js.map

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "linegauge",
+  "version": "0.0.1",
+  "description": "The width of material a saw removes in a cut. Measuring, wrapping, truncating and slicing styled terminal text without the edge fraying \u2014 grapheme-correct over Intl.Segmenter. Drop-in paths for string-width, wrap-ansi, strip-ansi and slice-ansi. 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/linegauge"
+  },
+  "homepage": "https://github.com/ofri-peretz/burgee/tree/main/packages/linegauge#readme",
+  "bugs": {
+    "url": "https://github.com/ofri-peretz/burgee/issues"
+  },
+  "keywords": [
+    "cli",
+    "terminal",
+    "string-width",
+    "wrap-ansi",
+    "strip-ansi",
+    "slice-ansi",
+    "truncate",
+    "wrap",
+    "width",
+    "grapheme",
+    "ansi",
+    "unicode"
+  ],
+  "devDependencies": {
+    "vitest": "^4.0.0"
+  }
+}