@shadow-garden/bapbong-headless 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Le Phuoc Minh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,56 @@
+# @shadow-garden/bapbong-headless
+
+The **backend façade** for bapbong. One install that re-exports the entire
+*isomorphic tier* — no DOM, no canvas, no `prosemirror-view` — so a server can
+read, edit, and write `.docx` with zero browser dependencies.
+
+It re-exports:
+
+| Package | What you get |
+| --- | --- |
+| `@shadow-garden/bapbong-contracts` | Shared types — `PageConfig`, `Align`, `Command`, `Collection`, … |
+| `@shadow-garden/bapbong-model` | The ProseMirror `schema` (+ `numbering`) |
+| `@shadow-garden/bapbong-docx` | `importDocx` / `exportDocx` round-trip |
+| `@shadow-garden/bapbong-commands` | Headless editor ops — `toggleMarkCommand`, `setAlign`, `insertRow`, `defaultCommands()`, … |
+
+## Install
+
+```sh
+pnpm add @shadow-garden/bapbong-headless prosemirror-state
+```
+
+`prosemirror-state` is a peer of the workflow below — the commands operate on an
+`EditorState`, which you construct yourself (the same one the editor UI uses).
+
+## Backend round-trip
+
+```ts
+import {
+  importDocx,
+  exportDocx,
+  toggleMarkCommand,
+  setAlign,
+} from '@shadow-garden/bapbong-headless';
+import { EditorState, TextSelection } from 'prosemirror-state';
+
+// 1. Read a .docx (ArrayBuffer | Uint8Array | Blob).
+const imported = await importDocx(bytes);
+
+// 2. Drive the SAME commands the editor UI uses, on a Node EditorState.
+let state = EditorState.create({ doc: imported.doc });
+state = state.apply(state.tr.setSelection(TextSelection.create(state.doc, 1, 12)));
+toggleMarkCommand('bold', 'strong').run(state, (tr) => (state = state.apply(tr)));
+setAlign('center').run(state, (tr) => (state = state.apply(tr)));
+
+// 3. Write it back. `carry` keeps parts bapbong doesn't model yet (styles,
+//    numbering, headers/footers, …) instead of dropping them.
+const out = await exportDocx(state.doc, { carry: imported.raw });
+```
+
+## Boundary
+
+This package is tagged `scope:headless` and lint-guarded against DOM globals
+(`document`, `window`, `Image`, `DOMParser`, …). **Do not** add
+`bapbong-editor` or `bapbong-view` to it — they pull in canvas/DOM and would
+break Node usage. For an in-browser preview use `@shadow-garden/bapbong-view`;
+for a full editor use `@shadow-garden/bapbong-editor`.

package/dist/index.cjs

@@ -0,0 +1,54 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// packages/headless/src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  FontRegistry: () => import_bapbong_measuring.FontRegistry,
+  createApproxMeasurer: () => import_bapbong_measuring.createApproxMeasurer,
+  createApproxMetrics: () => import_bapbong_measuring.createApproxMetrics,
+  createFontRegistryMeasurer: () => import_bapbong_measuring.createFontRegistryMeasurer,
+  createFontRegistryMetrics: () => import_bapbong_measuring.createFontRegistryMetrics,
+  createLayoutCache: () => import_bapbong_layout_engine.createLayoutCache,
+  fontToCss: () => import_bapbong_measuring.fontToCss,
+  layout: () => import_bapbong_layout_engine.layout
+});
+module.exports = __toCommonJS(index_exports);
+__reExport(index_exports, require("@shadow-garden/bapbong-contracts"), module.exports);
+__reExport(index_exports, require("@shadow-garden/bapbong-model"), module.exports);
+__reExport(index_exports, require("@shadow-garden/bapbong-docx"), module.exports);
+__reExport(index_exports, require("@shadow-garden/bapbong-commands"), module.exports);
+var import_bapbong_layout_engine = require("@shadow-garden/bapbong-layout-engine");
+var import_bapbong_measuring = require("@shadow-garden/bapbong-measuring");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FontRegistry,
+  createApproxMeasurer,
+  createApproxMetrics,
+  createFontRegistryMeasurer,
+  createFontRegistryMetrics,
+  createLayoutCache,
+  fontToCss,
+  layout,
+  ...require("@shadow-garden/bapbong-contracts"),
+  ...require("@shadow-garden/bapbong-model"),
+  ...require("@shadow-garden/bapbong-docx"),
+  ...require("@shadow-garden/bapbong-commands")
+});

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * `@shadow-garden/bapbong-headless` — the backend façade.
+ *
+ * One install that re-exports the whole **isomorphic tier** (no DOM, no canvas):
+ *   - `bapbong-contracts` — shared types (PageConfig, Align, Command, …)
+ *   - `bapbong-model`      — the ProseMirror `schema` + numbering
+ *   - `bapbong-docx`       — `importDocx` / `exportDocx`
+ *   - `bapbong-commands`   — headless editor ops (toggleMark, setAlign, …)
+ *
+ * The whole surface runs on Node/server. A backend imports a `.docx`, builds a
+ * ProseMirror `EditorState` from the doc, mutates it through the same `commands`
+ * the editor UI uses, then exports a `.docx` back — with zero browser deps.
+ *
+ *   import { importDocx, exportDocx, setAlign } from '@shadow-garden/bapbong-headless';
+ *   import { EditorState } from 'prosemirror-state';
+ *
+ * Layout/pagination is included too: font-file metrics made it DOM-free, so a
+ * backend can paginate (e.g. server-side PDF) with the SAME pure `layout` engine
+ * and measurers the editor uses — identical measurer + doc ⇒ identical page
+ * breaks (client↔server parity). Only the DOM-free measuring surface is
+ * re-exported; the canvas measurers stay out (they need a browser).
+ *
+ * Do NOT add `bapbong-editor` or `bapbong-view` here — they drag in canvas/DOM
+ * and would break Node usage. The `scope:headless` lint boundary enforces this.
+ */
+export * from '@shadow-garden/bapbong-contracts';
+export * from '@shadow-garden/bapbong-model';
+export * from '@shadow-garden/bapbong-docx';
+export * from '@shadow-garden/bapbong-commands';
+export { layout, createLayoutCache } from '@shadow-garden/bapbong-layout-engine';
+export { FontRegistry, createFontRegistryMeasurer, createFontRegistryMetrics, createApproxMeasurer, createApproxMetrics, fontToCss, type FontVariant, } from '@shadow-garden/bapbong-measuring';
+export type { Align, PageConfig, CommentData } from '@shadow-garden/bapbong-contracts';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,cAAc,kCAAkC,CAAC;AACjD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AACjF,OAAO,EACL,YAAY,EACZ,0BAA0B,EAC1B,yBAAyB,EACzB,oBAAoB,EACpB,mBAAmB,EACnB,SAAS,EACT,KAAK,WAAW,GACjB,MAAM,kCAAkC,CAAC;AAM1C,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/index.js

@@ -0,0 +1,24 @@
+// packages/headless/src/index.ts
+export * from "@shadow-garden/bapbong-contracts";
+export * from "@shadow-garden/bapbong-model";
+export * from "@shadow-garden/bapbong-docx";
+export * from "@shadow-garden/bapbong-commands";
+import { layout, createLayoutCache } from "@shadow-garden/bapbong-layout-engine";
+import {
+  FontRegistry,
+  createFontRegistryMeasurer,
+  createFontRegistryMetrics,
+  createApproxMeasurer,
+  createApproxMetrics,
+  fontToCss
+} from "@shadow-garden/bapbong-measuring";
+export {
+  FontRegistry,
+  createApproxMeasurer,
+  createApproxMetrics,
+  createFontRegistryMeasurer,
+  createFontRegistryMetrics,
+  createLayoutCache,
+  fontToCss,
+  layout
+};

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@shadow-garden/bapbong-headless",
+  "version": "0.1.0",
+  "description": "bapbong — headless backend façade: one install re-exporting contracts + model + docx + commands (isomorphic, no DOM). Import .docx → edit via commands on an EditorState → export .docx, server-side.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shadowgarden-app/bapbong.git",
+    "directory": "packages/headless"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "@shadow-garden/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!**/*.tsbuildinfo"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "nx": {
+    "tags": [
+      "scope:headless"
+    ],
+    "targets": {
+      "build": {
+        "executor": "@nx/esbuild:esbuild",
+        "outputs": [
+          "{options.outputPath}"
+        ],
+        "options": {
+          "outputPath": "packages/headless/dist",
+          "main": "packages/headless/src/index.ts",
+          "tsConfig": "packages/headless/tsconfig.lib.json",
+          "format": [
+            "esm",
+            "cjs"
+          ],
+          "declarationRootDir": "packages/headless/src",
+          "external": [
+            "@shadow-garden/bapbong-contracts",
+            "@shadow-garden/bapbong-model",
+            "@shadow-garden/bapbong-docx",
+            "@shadow-garden/bapbong-commands",
+            "@shadow-garden/bapbong-layout-engine",
+            "@shadow-garden/bapbong-measuring"
+          ]
+        }
+      }
+    }
+  },
+  "dependencies": {
+    "@shadow-garden/bapbong-contracts": "^0.1.0",
+    "@shadow-garden/bapbong-commands": "^0.1.0",
+    "@shadow-garden/bapbong-docx": "^0.1.0",
+    "@shadow-garden/bapbong-layout-engine": "^0.1.0",
+    "@shadow-garden/bapbong-measuring": "^0.1.0",
+    "@shadow-garden/bapbong-model": "^0.1.0"
+  },
+  "devDependencies": {
+    "prosemirror-state": "^1.4.4",
+    "opentype.js": "^2.0.0"
+  }
+}