@batterai/fields-pure 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,6 @@
+# @batterai/fields-pure
+
+## 0.1.0
+
+- Baseline React-free field helper package for Build tab grouping and reference provider contracts.
+- Ships as Node-compatible ESM with declaration files under `dist/`.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Batterai.eu
+
+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,21 @@
+# @batterai/fields-pure
+
+React-free field helpers for server/runtime packages.
+
+## What It Provides
+
+- Shared field helper types.
+- Scope-stack to inspector-group mapping.
+- Reference-provider helpers without React or TipTap imports.
+
+## Install
+
+```bash
+npm install @batterai/fields-pure
+```
+
+Requires Node.js `>=20.11`.
+
+## Boundary
+
+Use this package from runtime, adapter, and server code that must not pull the React-based editor field package into production bundles.

package/dist/component-keys.d.ts

@@ -0,0 +1,2 @@
+export { MULTILINE_TEXT_COMPONENT } from "@batterai/contract";
+//# sourceMappingURL=component-keys.d.ts.map

package/dist/component-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-keys.d.ts","sourceRoot":"","sources":["../src/component-keys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/component-keys.js

@@ -0,0 +1,2 @@
+export { MULTILINE_TEXT_COMPONENT } from "@batterai/contract";
+//# sourceMappingURL=component-keys.js.map

package/dist/component-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-keys.js","sourceRoot":"","sources":["../src/component-keys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @batterai/fields-pure — React-free field helpers that server/runtime
+ * packages may import without pulling React or TipTap into their bundles.
+ */
+export * from "./types";
+export * from "./component-keys";
+export * from "./scope-stack-to-groups";
+export * from "./reference-provider";
+//# 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;;;GAGG;AACH,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+/**
+ * @batterai/fields-pure — React-free field helpers that server/runtime
+ * packages may import without pulling React or TipTap into their bundles.
+ */
+export * from "./types.js";
+export * from "./component-keys.js";
+export * from "./scope-stack-to-groups.js";
+export * from "./reference-provider.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC"}

package/dist/reference-provider.d.ts

@@ -0,0 +1,23 @@
+/**
+ * ReferenceProvider seam (decision 003 §b). A provider resolves option lists
+ * and labels; vendor vocabularies become adapter-registered providers, never
+ * package-specific concepts.
+ */
+import type { FieldOption, FieldOptionsSource, Locale } from "@batterai/contract";
+export interface ReferenceProvider {
+    readonly id: string;
+    resolveOptions(params: Readonly<Record<string, unknown>> | undefined, locale: Locale): Promise<readonly FieldOption[]> | readonly FieldOption[];
+    resolveLabel(value: string, params: Readonly<Record<string, unknown>> | undefined, locale: Locale): Promise<string> | string;
+}
+export interface ReferenceProviderRegistry {
+    register(provider: ReferenceProvider): void;
+    get(providerId: string): ReferenceProvider | undefined;
+}
+export declare function createReferenceProviderRegistry(): ReferenceProviderRegistry;
+/**
+ * Resolve any options source to items. Static sources return as-is; provider
+ * sources resolve through the registry. Missing providers are visible errors,
+ * never empty option lists.
+ */
+export declare function resolveOptions(source: FieldOptionsSource, registry: ReferenceProviderRegistry, locale: Locale): Promise<readonly FieldOption[]>;
+//# sourceMappingURL=reference-provider.d.ts.map

package/dist/reference-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-provider.d.ts","sourceRoot":"","sources":["../src/reference-provider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAElF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,cAAc,CACZ,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,EACrD,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC,GAAG,SAAS,WAAW,EAAE,CAAC;IAC5D,YAAY,CACV,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,EACrD,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC5C,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAAC;CACxD;AAED,wBAAgB,+BAA+B,IAAI,yBAAyB,CAa3E;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,yBAAyB,EACnC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC,CAOjC"}

package/dist/reference-provider.js

@@ -0,0 +1,29 @@
+export function createReferenceProviderRegistry() {
+    const providers = new Map();
+    return {
+        register(provider) {
+            if (providers.has(provider.id)) {
+                throw new Error(`ReferenceProviderRegistry: duplicate provider id "${provider.id}"`);
+            }
+            providers.set(provider.id, provider);
+        },
+        get(providerId) {
+            return providers.get(providerId);
+        },
+    };
+}
+/**
+ * Resolve any options source to items. Static sources return as-is; provider
+ * sources resolve through the registry. Missing providers are visible errors,
+ * never empty option lists.
+ */
+export async function resolveOptions(source, registry, locale) {
+    if (source.kind === "static")
+        return source.items;
+    const provider = registry.get(source.providerId);
+    if (!provider) {
+        throw new Error(`resolveOptions: no ReferenceProvider registered for "${source.providerId}"`);
+    }
+    return provider.resolveOptions(source.params, locale);
+}
+//# sourceMappingURL=reference-provider.js.map

package/dist/reference-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-provider.js","sourceRoot":"","sources":["../src/reference-provider.ts"],"names":[],"mappings":"AAyBA,MAAM,UAAU,+BAA+B;IAC7C,MAAM,SAAS,GAAG,IAAI,GAAG,EAA6B,CAAC;IACvD,OAAO;QACL,QAAQ,CAAC,QAAQ;YACf,IAAI,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,KAAK,CAAC,qDAAqD,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC;YACvF,CAAC;YACD,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QACvC,CAAC;QACD,GAAG,CAAC,UAAU;YACZ,OAAO,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACnC,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAA0B,EAC1B,QAAmC,EACnC,MAAc;IAEd,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC;IAClD,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACjD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,wDAAwD,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC;IAChG,CAAC;IACD,OAAO,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACxD,CAAC"}

package/dist/scope-stack-to-groups.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Pure ScopeStack -> BuildTabGroup[] (decision 003 §e). The host supplies the
+ * viewer-filtered ContentType per instance frame; this function only shapes
+ * data and performs no I/O or authorization.
+ */
+import { type ScopeStack } from "@batterai/bind-core";
+import type { BuildTabGroup } from "./types";
+export declare function scopeStackToGroups(stack: ScopeStack): BuildTabGroup[];
+//# sourceMappingURL=scope-stack-to-groups.d.ts.map

package/dist/scope-stack-to-groups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-stack-to-groups.d.ts","sourceRoot":"","sources":["../src/scope-stack-to-groups.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAiB,aAAa,EAAE,MAAM,SAAS,CAAC;AAW5D,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,aAAa,EAAE,CAiCrE"}

package/dist/scope-stack-to-groups.js

@@ -0,0 +1,66 @@
+/**
+ * Pure ScopeStack -> BuildTabGroup[] (decision 003 §e). The host supplies the
+ * viewer-filtered ContentType per instance frame; this function only shapes
+ * data and performs no I/O or authorization.
+ */
+import { CURRENT_SCHEMA_VERSION, fieldName, } from "@batterai/bind-core";
+/** Synthetic structural fields for repeater/page frames. */
+const REPEATER_FIELDS = [
+    { name: fieldName("index"), valueType: "number", cardinality: "one", label: "Positie in lijst" },
+];
+const PAGE_FIELDS = [
+    { name: fieldName("path"), valueType: "string", cardinality: "one", label: "Paginapad" },
+    { name: fieldName("id"), valueType: "string", cardinality: "one", label: "Pagina-id" },
+];
+export function scopeStackToGroups(stack) {
+    const groups = [];
+    // Innermost first: the nearest scope is what an author usually binds.
+    for (let i = stack.length - 1; i >= 0; i--) {
+        const frame = stack[i];
+        if (frame.kind === "instance") {
+            const entries = [];
+            for (const f of frame.contentType.fields) {
+                entries.push(entry(frame.scopeId, "instance", f, [f.name]));
+            }
+            groups.push({
+                scopeId: frame.scopeId,
+                frameKind: "instance",
+                groupLabel: frame.contentType.name,
+                entries,
+            });
+        }
+        else if (frame.kind === "repeater") {
+            groups.push({
+                scopeId: frame.scopeId,
+                frameKind: "repeater",
+                groupLabel: "Lijstitem",
+                entries: REPEATER_FIELDS.map((f) => entry(frame.scopeId, "repeater", f, [f.name])),
+            });
+        }
+        else {
+            groups.push({
+                scopeId: frame.scopeId,
+                frameKind: "page",
+                groupLabel: "Pagina",
+                entries: PAGE_FIELDS.map((f) => entry(frame.scopeId, "page", f, [f.name])),
+            });
+        }
+    }
+    return groups;
+}
+function entry(scopeId, scope, fieldSchema, path) {
+    return {
+        key: `${scopeId}:${path.join(".")}`,
+        label: fieldSchema.label,
+        fieldSchema,
+        expr: {
+            v: CURRENT_SCHEMA_VERSION,
+            k: "ref",
+            scope,
+            scopeId,
+            path,
+            ...(fieldSchema.valueType === "date" ? { format: { kind: "date", style: "long" } } : {}),
+        },
+    };
+}
+//# sourceMappingURL=scope-stack-to-groups.js.map

package/dist/scope-stack-to-groups.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-stack-to-groups.js","sourceRoot":"","sources":["../src/scope-stack-to-groups.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,sBAAsB,EACtB,SAAS,GAGV,MAAM,qBAAqB,CAAC;AAG7B,4DAA4D;AAC5D,MAAM,eAAe,GAA2B;IAC9C,EAAE,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,kBAAkB,EAAE;CACjG,CAAC;AACF,MAAM,WAAW,GAA2B;IAC1C,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE;IACxF,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE;CACvF,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAAC,KAAiB;IAClD,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,sEAAsE;IACtE,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACxB,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAoB,EAAE,CAAC;YACpC,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;gBACzC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAc,CAAC,CAAC,CAAC,CAAC;YACxE,CAAC;YACD,MAAM,CAAC,IAAI,CAAC;gBACV,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,SAAS,EAAE,UAAU;gBACrB,UAAU,EAAE,KAAK,CAAC,WAAW,CAAC,IAAI;gBAClC,OAAO;aACR,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACrC,MAAM,CAAC,IAAI,CAAC;gBACV,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,SAAS,EAAE,UAAU;gBACrB,UAAU,EAAE,WAAW;gBACvB,OAAO,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAc,CAAC,CAAC,CAAC;aAC7F,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC;gBACV,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,SAAS,EAAE,MAAM;gBACjB,UAAU,EAAE,QAAQ;gBACpB,OAAO,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAc,CAAC,CAAC,CAAC;aACrF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,KAAK,CACZ,OAAiC,EACjC,KAAuC,EACvC,WAAwB,EACxB,IAAc;IAEd,OAAO;QACL,GAAG,EAAE,GAAG,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;QACnC,KAAK,EAAE,WAAW,CAAC,KAAK;QACxB,WAAW;QACX,IAAI,EAAE;YACJ,CAAC,EAAE,sBAAsB;YACzB,CAAC,EAAE,KAAK;YACR,KAAK;YACL,OAAO;YACP,IAAI;YACJ,GAAG,CAAC,WAAW,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAClG;KACF,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Build-tab shapes (decision 003 §e). One entry = one bindable property with a
+ * ready-to-insert BindingExpr; controls render what they are given, and the
+ * host computes groups from viewer-filtered CMS schema plus the active scope.
+ */
+import type { BindingExpr, FieldSchema, ScopeId } from "@batterai/bind-core";
+export interface BuildTabEntry {
+    readonly key: string;
+    readonly label: string;
+    readonly fieldSchema: FieldSchema;
+    /** Fully formed RefExpr — scope + scopeId + path resolved for this frame. */
+    readonly expr: BindingExpr;
+}
+export interface BuildTabGroup {
+    readonly scopeId: ScopeId;
+    readonly frameKind: "instance" | "repeater" | "page";
+    readonly groupLabel: string;
+    /**
+     * Invariant E: unreadable fields are omitted upstream, never shown disabled,
+     * because field existence must not leak.
+     */
+    readonly entries: readonly BuildTabEntry[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE7E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;IACrD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;CAC5C"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@batterai/fields-pure",
+  "version": "0.1.0",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "check": "tsc --noEmit",
+    "build": "node ../../scripts/build-package.mjs",
+    "prepack": "bun run build"
+  },
+  "dependencies": {
+    "@batterai/bind-core": "^0.1.0",
+    "@batterai/contract": "^0.1.0"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "engines": {
+    "node": ">=20.11"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}