@endora-commerce/page-builder-core 0.100.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Endora sp. z o.o. and the Endora Commerce contributors
+
+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,51 @@
+<!-- Generated by `pnpm --filter backend run manifests:generate`. Delete this line to take the file over; a README without it is never regenerated. -->
+
+# @endora-commerce/page-builder-core
+
+Shared Page Builder primitives — responsive props, context filtering, and component definition helpers for CMS, email, and invoice builders.
+
+## What this is
+
+A shared library package of **Endora Commerce**, the modular B2B/B2C commerce platform. It declares no module manifest, so the platform composes nothing from it: what is published here is what the platform and the modules built on it compile against.
+
+## Entry points
+
+- `@endora-commerce/page-builder-core`
+- `@endora-commerce/page-builder-core/*`
+- `@endora-commerce/page-builder-core/client`
+- `@endora-commerce/page-builder-core/editor`
+- `@endora-commerce/page-builder-core/editor/carousel-preview`
+- `@endora-commerce/page-builder-core/editor/puck-guards`
+- `@endora-commerce/page-builder-core/editor/use-page-builder-puck`
+- `@endora-commerce/page-builder-core/fields/hide-on-field`
+- `@endora-commerce/page-builder-core/migration`
+- `@endora-commerce/page-builder-core/tailwind.css`
+- `@endora-commerce/page-builder-core/types/responsive`
+
+## Depends on
+
+Everything below is a **peer** dependency, so the application resolves exactly one copy of each — two copies of a host or of React are a runtime failure rather than a type error. An entry marked *optional* is needed only by the layers that use it.
+
+**Third-party**
+
+- `@measured/puck` * — *optional*
+- `react` ^19.0.0 — *optional*
+
+**Bundled dependencies**
+
+- `@endora-commerce/contracts`
+
+## What the tarball carries
+
+- `dist/` — the compiled JavaScript and its type declarations
+- `tailwind.css` — the Tailwind source declaration
+
+## Install
+
+```bash
+pnpm add @endora-commerce/page-builder-core
+```
+
+## Licence
+
+MIT — the text is in `LICENSE`, beside this file.

package/dist/block-name.d.ts

@@ -0,0 +1,48 @@
+/** A block name split into the two things it states. */
+export interface ParsedBlockName {
+    /** The declaring module's `id` — the segment before the separator. */
+    readonly owner: string;
+    /** The PascalCase local name, unique within that module. */
+    readonly local: string;
+}
+/**
+ * Split a namespaced block name, or answer `null` when the string is not one.
+ *
+ * **Null rather than a throw**, deliberately: the readers that matter are a
+ * migration and an operator report, both of which meet names they do not
+ * recognise as a matter of course. FR-014 requires such a name to be left
+ * byte-identical and reported, and a classification path that throws cannot do
+ * either.
+ */
+export declare function parseBlockName(name: string): ParsedBlockName | null;
+/**
+ * The module that owns a block name, or `null` when the name states no owner.
+ *
+ * This is the question every runtime reader actually asks — which module can
+ * render this node, is that module present, and whose palette does it belong in.
+ */
+export declare function ownerOf(name: string): string | null;
+/**
+ * Whether a name is a well-formed namespaced block name.
+ *
+ * **Stricter than `indexOf('.') !== -1`**, which is how `data-model.md` §3
+ * describes the migration's idempotence test, and the difference is deliberate
+ * and narrow. No entry in the frozen rename map's domain contains a dot, so the
+ * two predicates agree on every name the migration renames. They differ only on
+ * a *malformed* dotted name — a hand-edited `acme.banner`, a fork's own
+ * spelling — which the lax test would classify as "already namespaced" and hide
+ * from the operator's report. Under this one it is unrecognised: reported, left
+ * alone, and degrading to the placeholder, which is the FR-014 path it belongs
+ * on.
+ */
+export declare function isNamespaced(name: string): boolean;
+/**
+ * Build a block name from its two parts.
+ *
+ * **Throws** where {@link parseBlockName} returns `null`, and the asymmetry is
+ * the point: reading meets names from a client's database, where an unknown one
+ * is expected; writing is a developer composing an identifier that will be
+ * persisted forever, where an unparseable one is a row nothing can ever render.
+ */
+export declare function formatBlockName(owner: string, local: string): string;
+//# sourceMappingURL=block-name.d.ts.map

package/dist/block-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-name.d.ts","sourceRoot":"","sources":["../src/block-name.ts"],"names":[],"mappings":"AAuBA,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAInE;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEnD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAUpE"}

package/dist/block-name.js

@@ -0,0 +1,79 @@
+// Page Builder block names — feature 096, T104.
+//
+// A block name is `<ownerModuleId>.<LocalName>` and is the persisted identifier
+// of a Puck node: it is written into a `jsonb` column and never rewritten
+// (`specs/096-page-builder-block-ownership/contracts/block-definition.md` §3).
+// These four functions are the **only** readers of that shape; every file that
+// needs an owner, a local name or a "is this namespaced" answer imports them
+// rather than splitting a string itself.
+//
+// That is the `text-normalization.ts` discipline, and this file has the same
+// reason for it. Six authors wrote their own diacritic fold because the shared
+// one existed under a name they did not find, and four of them were wrong; a
+// private `name.split('.')[0]` is the same defect over a string that ends up in
+// a client's database. `check:block-names` (Phase 7) is what will refuse the
+// second copy.
+//
+// The grammar itself is authored once more centrally still — `blockNameRe` in
+// `@endora-commerce/contracts` — because the Zod schema that refuses a bad
+// declaration needs it and this package cannot be the thing `contracts`
+// depends on.
+import { blockNameRe } from '@endora-commerce/contracts/cms';
+/**
+ * Split a namespaced block name, or answer `null` when the string is not one.
+ *
+ * **Null rather than a throw**, deliberately: the readers that matter are a
+ * migration and an operator report, both of which meet names they do not
+ * recognise as a matter of course. FR-014 requires such a name to be left
+ * byte-identical and reported, and a classification path that throws cannot do
+ * either.
+ */
+export function parseBlockName(name) {
+    if (!blockNameRe.test(name))
+        return null;
+    const separator = name.indexOf('.');
+    return { owner: name.slice(0, separator), local: name.slice(separator + 1) };
+}
+/**
+ * The module that owns a block name, or `null` when the name states no owner.
+ *
+ * This is the question every runtime reader actually asks — which module can
+ * render this node, is that module present, and whose palette does it belong in.
+ */
+export function ownerOf(name) {
+    return parseBlockName(name)?.owner ?? null;
+}
+/**
+ * Whether a name is a well-formed namespaced block name.
+ *
+ * **Stricter than `indexOf('.') !== -1`**, which is how `data-model.md` §3
+ * describes the migration's idempotence test, and the difference is deliberate
+ * and narrow. No entry in the frozen rename map's domain contains a dot, so the
+ * two predicates agree on every name the migration renames. They differ only on
+ * a *malformed* dotted name — a hand-edited `acme.banner`, a fork's own
+ * spelling — which the lax test would classify as "already namespaced" and hide
+ * from the operator's report. Under this one it is unrecognised: reported, left
+ * alone, and degrading to the placeholder, which is the FR-014 path it belongs
+ * on.
+ */
+export function isNamespaced(name) {
+    return blockNameRe.test(name);
+}
+/**
+ * Build a block name from its two parts.
+ *
+ * **Throws** where {@link parseBlockName} returns `null`, and the asymmetry is
+ * the point: reading meets names from a client's database, where an unknown one
+ * is expected; writing is a developer composing an identifier that will be
+ * persisted forever, where an unparseable one is a row nothing can ever render.
+ */
+export function formatBlockName(owner, local) {
+    const name = `${owner}.${local}`;
+    if (!blockNameRe.test(name)) {
+        throw new Error(`[page-builder-core] "${name}" is not a valid block name (${String(blockNameRe)}) — ` +
+            'the owner segment is a module id and the local name is PascalCase, and the name ' +
+            'is persisted, so it cannot be corrected later.');
+    }
+    return name;
+}
+//# sourceMappingURL=block-name.js.map

package/dist/block-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-name.js","sourceRoot":"","sources":["../src/block-name.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,EAAE;AACF,gFAAgF;AAChF,0EAA0E;AAC1E,+EAA+E;AAC/E,+EAA+E;AAC/E,6EAA6E;AAC7E,yCAAyC;AACzC,EAAE;AACF,6EAA6E;AAC7E,+EAA+E;AAC/E,6EAA6E;AAC7E,gFAAgF;AAChF,6EAA6E;AAC7E,eAAe;AACf,EAAE;AACF,8EAA8E;AAC9E,2EAA2E;AAC3E,wEAAwE;AACxE,cAAc;AAEd,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAU7D;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACzC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,EAAE,CAAC;AAC/E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,cAAc,CAAC,IAAI,CAAC,EAAE,KAAK,IAAI,IAAI,CAAC;AAC7C,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,KAAa;IAC1D,MAAM,IAAI,GAAG,GAAG,KAAK,IAAI,KAAK,EAAE,CAAC;IACjC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,wBAAwB,IAAI,gCAAgC,MAAM,CAAC,WAAW,CAAC,MAAM;YACnF,kFAAkF;YAClF,gDAAgD,CACnD,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/block-tree.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Decide what happens to one `type` value found in a node position.
+ *
+ * Returning a string replaces the value; returning `undefined` leaves it
+ * byte-identical. The report returns `undefined` for everything, which is what
+ * makes it read-only by construction rather than by discipline.
+ */
+export type BlockNameVisitor = (type: string) => string | undefined;
+export interface BlockNameWalkResult {
+    /** The rewritten document. Structurally identical where nothing was renamed. */
+    readonly value: unknown;
+    /** How many node `type` values the visitor replaced. */
+    readonly renamed: number;
+    /** How many node positions were visited, replaced or not. */
+    readonly visited: number;
+}
+/**
+ * Walk a stored Puck document and offer every node `type` to `visit`.
+ *
+ * The returned `value` shares no mutated structure with the input: objects and
+ * arrays are rebuilt in place order, so a caller may compare the two for
+ * equality to decide whether an `update` is worth issuing.
+ */
+export declare function mapBlockNames(doc: unknown, visit: BlockNameVisitor): BlockNameWalkResult;
+/**
+ * Apply a rename map to a stored document.
+ *
+ * **One branch** (`contracts/block-name-migration.md` §3.3). A `type` the map
+ * holds is replaced; anything else is left byte-identical — an already
+ * namespaced name and an unrecognised one alike, because the map's domain is
+ * bare and its codomain is dotted, so the two sets are disjoint and no dot test
+ * is needed to tell them apart. That is what makes idempotence a property of the
+ * map rather than an outcome a branch has to remember to produce.
+ */
+export declare function renameBlockNames(doc: unknown, renames: Readonly<Record<string, string>>): BlockNameWalkResult;
+/**
+ * Count every node `type` in a document, writing nothing.
+ *
+ * The report's half of the shared walk. It returns occurrences per distinct
+ * name; the caller aggregates rows into the affected-row count, which is a
+ * question about rows and not about nodes.
+ */
+export declare function countBlockNames(doc: unknown): Map<string, number>;
+//# sourceMappingURL=block-tree.d.ts.map

package/dist/block-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-tree.d.ts","sourceRoot":"","sources":["../src/block-tree.ts"],"names":[],"mappings":"AAkDA;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;AAEpE,MAAM,WAAW,mBAAmB;IAClC,gFAAgF;IAChF,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,GAAG,mBAAmB,CAoCxF;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACxC,mBAAmB,CAIrB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAOjE"}

package/dist/block-tree.js

@@ -0,0 +1,120 @@
+// The structural block-name walk — feature 096, T403, moved out of
+// `src/migration/` by T602.
+//
+// **One implementation, used by the five rename migrations, by the operator's
+// pre-flight report, and by the admin editor's degradation merge**
+// (`contracts/block-name-migration.md` §3). The three differ in what they do
+// with a name and agree on how a name is found; two walks would be two answers
+// waiting to disagree about the one thing that must not disagree — which nodes
+// exist.
+//
+// The third reader is why the file sits here rather than under `src/migration/`.
+// That subpath is not a runtime path, because the frozen rename map is in it and
+// a resolver that could reach the map would make this feature the permanent
+// alias map the owner rejected. The **walk** carries no such hazard: it knows
+// nothing about any correspondence and only says which node `type` values a
+// document holds, which is what FR-019's placeholder merge has to ask.
+//
+// ## It is structural, never textual
+//
+// Twelve of the 74 renamed names are ordinary English words that occur
+// throughout shop content: `Row`, `Text`, `Image`, `Map`, `Button`, `Stats`,
+// `Social`, `Column`, `Video`, `Icons`, `Tabs`, `Slide`. A `RawHtml` block's
+// `html` prop, a `Text` block's `text` prop, a heading and every `alt` attribute
+// in the shop are free text that may contain any of them, so a
+// `replace('"Row"', '"cms.Row"')` over the serialised column corrupts content.
+// The walk replaces the value of a `type` property **in a node position** and
+// nothing else.
+//
+// ## What a node is, and what the walk descends into
+//
+// A JSON object is a node when it has a `type` property whose value is a string.
+// `props` is **not** required — a legacy or hand-written node may lack it, and
+// skipping such a node is a silent miss. (`check:block-names` requires the
+// `props` sibling for the opposite reason: its subject is *source text*, where
+// `{ type: 'text', label: 'Gap' }` is a Puck field descriptor and appears
+// hundreds of times. The asymmetry is deliberate and is stated in
+// `contracts/block-name-check.md` §2.1.)
+//
+// The walk descends into **every** value of every object and **every** element
+// of every array. It does not key on `content` and `zones`: both envelope types
+// are declared `& Record<string, unknown>` and round-tripped verbatim, and
+// Puck's slot mechanism places node arrays under arbitrary prop keys — so a walk
+// keyed on two known keys silently misses every slotted child, which in the CMS
+// palette is `Column` inside `Row` and `Slide` inside `ContentSlider`, i.e. most
+// of the tree.
+//
+// Everything that is not a node's `type` is copied through unchanged: prop
+// values, key order within an object, array order, an envelope's `languages`
+// keys and the deprecated `schema_version` key.
+/**
+ * Walk a stored Puck document and offer every node `type` to `visit`.
+ *
+ * The returned `value` shares no mutated structure with the input: objects and
+ * arrays are rebuilt in place order, so a caller may compare the two for
+ * equality to decide whether an `update` is worth issuing.
+ */
+export function mapBlockNames(doc, visit) {
+    let renamed = 0;
+    let visited = 0;
+    const descend = (node) => {
+        if (Array.isArray(node)) {
+            return node.map(descend);
+        }
+        if (node === null || typeof node !== 'object') {
+            return node;
+        }
+        const source = node;
+        const out = {};
+        // Key order is preserved because `Object.entries` yields insertion order and
+        // the output is built in that order. `jsonb` does not preserve key order at
+        // all, but the report also runs over parsed JS objects and the migration's
+        // fallback path re-serialises, so the walk keeps the property rather than
+        // relying on the column type to make it moot.
+        for (const [key, value] of Object.entries(source)) {
+            if (key === 'type' && typeof value === 'string') {
+                visited += 1;
+                const replacement = visit(value);
+                if (replacement !== undefined && replacement !== value) {
+                    renamed += 1;
+                    out[key] = replacement;
+                    continue;
+                }
+                out[key] = value;
+                continue;
+            }
+            out[key] = descend(value);
+        }
+        return out;
+    };
+    return { value: descend(doc), renamed, visited };
+}
+/**
+ * Apply a rename map to a stored document.
+ *
+ * **One branch** (`contracts/block-name-migration.md` §3.3). A `type` the map
+ * holds is replaced; anything else is left byte-identical — an already
+ * namespaced name and an unrecognised one alike, because the map's domain is
+ * bare and its codomain is dotted, so the two sets are disjoint and no dot test
+ * is needed to tell them apart. That is what makes idempotence a property of the
+ * map rather than an outcome a branch has to remember to produce.
+ */
+export function renameBlockNames(doc, renames) {
+    return mapBlockNames(doc, (type) => Object.prototype.hasOwnProperty.call(renames, type) ? renames[type] : undefined);
+}
+/**
+ * Count every node `type` in a document, writing nothing.
+ *
+ * The report's half of the shared walk. It returns occurrences per distinct
+ * name; the caller aggregates rows into the affected-row count, which is a
+ * question about rows and not about nodes.
+ */
+export function countBlockNames(doc) {
+    const counts = new Map();
+    mapBlockNames(doc, (type) => {
+        counts.set(type, (counts.get(type) ?? 0) + 1);
+        return undefined;
+    });
+    return counts;
+}
+//# sourceMappingURL=block-tree.js.map

package/dist/block-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-tree.js","sourceRoot":"","sources":["../src/block-tree.ts"],"names":[],"mappings":"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"}

package/dist/client.d.ts

@@ -0,0 +1,3 @@
+export { usePreviewBreakpointTier } from './editor/use-preview-breakpoint-tier.js';
+export { ColorPaletteProvider, useColorPalette, type ColorPaletteEntry, type ColorPaletteContextValue, } from './color-palette/context.js';
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AACnF,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,GAC9B,MAAM,4BAA4B,CAAC"}

package/dist/client.js

@@ -0,0 +1,4 @@
+'use client';
+export { usePreviewBreakpointTier } from './editor/use-preview-breakpoint-tier.js';
+export { ColorPaletteProvider, useColorPalette, } from './color-palette/context.js';
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AACnF,OAAO,EACL,oBAAoB,EACpB,eAAe,GAGhB,MAAM,4BAA4B,CAAC"}

package/dist/color-palette/context.d.ts

@@ -0,0 +1,18 @@
+import { type ReactNode } from 'react';
+export interface ColorPaletteEntry {
+    id: string;
+    name: string;
+    hex: string;
+}
+export interface ColorPaletteContextValue {
+    entries: ColorPaletteEntry[];
+    openPalette: (onSelect: (hex: string) => void) => void;
+    refreshPalette: () => Promise<void>;
+    savePalette: (entries: ColorPaletteEntry[]) => Promise<void>;
+}
+export declare function ColorPaletteProvider({ value, children, }: {
+    value: ColorPaletteContextValue;
+    children: ReactNode;
+}): ReactNode;
+export declare function useColorPalette(): ColorPaletteContextValue | null;
+//# sourceMappingURL=context.d.ts.map

package/dist/color-palette/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/color-palette/context.tsx"],"names":[],"mappings":"AAEA,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAElE,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,KAAK,IAAI,CAAC;IACvD,cAAc,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,WAAW,EAAE,CAAC,OAAO,EAAE,iBAAiB,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9D;AAID,wBAAgB,oBAAoB,CAAC,EACnC,KAAK,EACL,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,wBAAwB,CAAC;IAChC,QAAQ,EAAE,SAAS,CAAC;CACrB,GAAG,SAAS,CAEZ;AAED,wBAAgB,eAAe,IAAI,wBAAwB,GAAG,IAAI,CAEjE"}

package/dist/color-palette/context.js

@@ -0,0 +1,11 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext } from 'react';
+const ColorPaletteContext = createContext(null);
+export function ColorPaletteProvider({ value, children, }) {
+    return _jsx(ColorPaletteContext.Provider, { value: value, children: children });
+}
+export function useColorPalette() {
+    return useContext(ColorPaletteContext);
+}
+//# sourceMappingURL=context.js.map

package/dist/color-palette/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/color-palette/context.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,aAAa,EAAE,UAAU,EAAkB,MAAM,OAAO,CAAC;AAelE,MAAM,mBAAmB,GAAG,aAAa,CAAkC,IAAI,CAAC,CAAC;AAEjF,MAAM,UAAU,oBAAoB,CAAC,EACnC,KAAK,EACL,QAAQ,GAIT;IACC,OAAO,KAAC,mBAAmB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAgC,CAAC;AAC/F,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,UAAU,CAAC,mBAAmB,CAAC,CAAC;AACzC,CAAC"}

package/dist/define-component.d.ts

@@ -0,0 +1,47 @@
+import type { ComponentConfig, Config } from '@measured/puck';
+import type { PageBuilderContext } from './types/responsive.js';
+export type ComponentContextMeta = {
+    /** Contexts where this component is available. Defaults to `['cms']`. */
+    contexts?: readonly PageBuilderContext[];
+    /** Prop keys that support per-breakpoint overrides in the CMS editor. */
+    responsiveFields?: readonly string[];
+};
+export type PageBuilderComponentDefinition = ComponentConfig & ComponentContextMeta;
+/**
+ * Attach Page Builder metadata to a Puck component config. Metadata is stored
+ * on the config object for palette filtering; it does not affect Puck runtime.
+ */
+export declare function definePageBuilderComponent(definition: PageBuilderComponentDefinition): PageBuilderComponentDefinition;
+export declare function getComponentContexts(config: ComponentConfig): PageBuilderContext[];
+export declare function getResponsiveFields(config: ComponentConfig): string[];
+/** Filter a Puck config palette to components allowed in the given context. */
+/**
+ * Does a block declared for `declared` appear in the `target` palette?
+ *
+ * **`contexts` states what a block is *authored for*; appearance is derived**
+ * (feature 096, D-10, normative in
+ * `specs/096-page-builder-block-ownership/contracts/block-definition.md` §4.1.1).
+ * The one admission the platform grants is `email -> newsletter`: every e-mail
+ * block is offered in the newsletter palette, and **no block in the tree
+ * declares `newsletter`** — that member of `PageBuilderContext` has never had a
+ * block of its own.
+ *
+ * Extracted because the rule was written **twice in this file** and T305's
+ * derived palette would have been the third copy — the `text-normalization.ts`
+ * discipline, where a rule with two implementations is a rule with two answers
+ * waiting to disagree. The two spellings were proved equivalent before the
+ * extraction rather than assumed to be: over all 16 subsets of
+ * `PageBuilderContext` against all 4 contexts, 64 combinations, **zero
+ * divergences** — including `['newsletter']` alone, which the task note
+ * predicted would diverge and does not.
+ *
+ * It is load-bearing on four live editor surfaces — `newsletter`'s `BlocksPage`
+ * (twice), `CampaignEditor` and `AutomationBuilder`, all reaching
+ * `EmailEditorPane` — so removing the admission empties the palette every
+ * campaign, block and automation step is authored against.
+ */
+export declare function contextAdmits(declared: readonly PageBuilderContext[], target: PageBuilderContext): boolean;
+export declare function filterConfigByContext(config: Config, context: PageBuilderContext): Config;
+/** Component names disallowed in a context (for slot `disallow` props). */
+export declare function getDisallowedComponentNames(config: Config, context: PageBuilderContext): string[];
+//# sourceMappingURL=define-component.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"define-component.d.ts","sourceRoot":"","sources":["../src/define-component.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAGhE,MAAM,MAAM,oBAAoB,GAAG;IACjC,yEAAyE;IACzE,QAAQ,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACzC,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG,eAAe,GAAG,oBAAoB,CAAC;AAEpF;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,8BAA8B,GACzC,8BAA8B,CAKhC;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,kBAAkB,EAAE,CAGlF;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,EAAE,CAGrE;AAED,+EAA+E;AAC/E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,SAAS,kBAAkB,EAAE,EACvC,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAGT;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAiBzF;AAED,2EAA2E;AAC3E,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,MAAM,EAAE,CAKjG"}

package/dist/define-component.js

@@ -0,0 +1,74 @@
+import { enhancePageBuilderComponent } from './editor/enhance-component-config.js';
+/**
+ * Attach Page Builder metadata to a Puck component config. Metadata is stored
+ * on the config object for palette filtering; it does not affect Puck runtime.
+ */
+export function definePageBuilderComponent(definition) {
+    return enhancePageBuilderComponent({
+        contexts: ['cms'],
+        ...definition,
+    });
+}
+export function getComponentContexts(config) {
+    const meta = config;
+    return [...(meta.contexts ?? ['cms'])];
+}
+export function getResponsiveFields(config) {
+    const meta = config;
+    return [...(meta.responsiveFields ?? [])];
+}
+/** Filter a Puck config palette to components allowed in the given context. */
+/**
+ * Does a block declared for `declared` appear in the `target` palette?
+ *
+ * **`contexts` states what a block is *authored for*; appearance is derived**
+ * (feature 096, D-10, normative in
+ * `specs/096-page-builder-block-ownership/contracts/block-definition.md` §4.1.1).
+ * The one admission the platform grants is `email -> newsletter`: every e-mail
+ * block is offered in the newsletter palette, and **no block in the tree
+ * declares `newsletter`** — that member of `PageBuilderContext` has never had a
+ * block of its own.
+ *
+ * Extracted because the rule was written **twice in this file** and T305's
+ * derived palette would have been the third copy — the `text-normalization.ts`
+ * discipline, where a rule with two implementations is a rule with two answers
+ * waiting to disagree. The two spellings were proved equivalent before the
+ * extraction rather than assumed to be: over all 16 subsets of
+ * `PageBuilderContext` against all 4 contexts, 64 combinations, **zero
+ * divergences** — including `['newsletter']` alone, which the task note
+ * predicted would diverge and does not.
+ *
+ * It is load-bearing on four live editor surfaces — `newsletter`'s `BlocksPage`
+ * (twice), `CampaignEditor` and `AutomationBuilder`, all reaching
+ * `EmailEditorPane` — so removing the admission empties the palette every
+ * campaign, block and automation step is authored against.
+ */
+export function contextAdmits(declared, target) {
+    if (declared.includes(target))
+        return true;
+    return target === 'newsletter' && declared.includes('email');
+}
+export function filterConfigByContext(config, context) {
+    const components = {};
+    for (const [name, component] of Object.entries(config.components ?? {})) {
+        if (contextAdmits(getComponentContexts(component), context)) {
+            components[name] = component;
+        }
+    }
+    const categories = {};
+    for (const [key, category] of Object.entries(config.categories ?? {})) {
+        const filteredComponents = (category.components ?? []).filter((name) => name in components);
+        if (filteredComponents.length > 0) {
+            categories[key] = { ...category, components: filteredComponents };
+        }
+    }
+    return { ...config, components, categories };
+}
+/** Component names disallowed in a context (for slot `disallow` props). */
+export function getDisallowedComponentNames(config, context) {
+    return Object.keys(config.components ?? {}).filter((name) => {
+        const component = config.components[name];
+        return !contextAdmits(getComponentContexts(component), context);
+    });
+}
+//# sourceMappingURL=define-component.js.map

package/dist/define-component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-component.js","sourceRoot":"","sources":["../src/define-component.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AAWnF;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CACxC,UAA0C;IAE1C,OAAO,2BAA2B,CAAC;QACjC,QAAQ,EAAE,CAAC,KAAK,CAAC;QACjB,GAAG,UAAU;KACd,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAuB;IAC1D,MAAM,IAAI,GAAG,MAA8B,CAAC;IAC5C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAuB;IACzD,MAAM,IAAI,GAAG,MAA8B,CAAC;IAC5C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,+EAA+E;AAC/E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAuC,EACvC,MAA0B;IAE1B,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,OAAO,MAAM,KAAK,YAAY,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MAAc,EAAE,OAA2B;IAC/E,MAAM,UAAU,GAAyB,EAAE,CAAC;IAC5C,KAAK,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,CAAC;QACxE,IAAI,aAAa,CAAC,oBAAoB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC;YAC5D,UAAU,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAyB,EAAE,CAAC;IAC5C,KAAK,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,CAAC;QACtE,MAAM,kBAAkB,GAAG,CAAC,QAAQ,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,UAAU,CAAC,CAAC;QAC5F,IAAI,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClC,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,UAAU,EAAE,kBAAkB,EAAE,CAAC;QACpE,CAAC;IACH,CAAC;IAED,OAAO,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC;AAC/C,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,2BAA2B,CAAC,MAAc,EAAE,OAA2B;IACrF,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QAC1D,MAAM,SAAS,GAAG,MAAM,CAAC,UAAW,CAAC,IAAI,CAAE,CAAC;QAC5C,OAAO,CAAC,aAAa,CAAC,oBAAoB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/editor/editor-carousel-preview-ui.d.ts

@@ -0,0 +1,7 @@
+export type EditorCarouselPreviewUi = {
+    carouselPreviewPages?: Record<string, number>;
+};
+export declare function readEditorCarouselPages(ui: EditorCarouselPreviewUi | undefined): Record<string, number>;
+export declare function getEditorCarouselPageFromUi(ui: EditorCarouselPreviewUi | undefined, carouselId: string): number;
+export declare function carouselEditorPageCount(slideCount: number, slidesPerView: number): number;
+//# sourceMappingURL=editor-carousel-preview-ui.d.ts.map

package/dist/editor/editor-carousel-preview-ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-carousel-preview-ui.d.ts","sourceRoot":"","sources":["../../src/editor/editor-carousel-preview-ui.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,uBAAuB,GAAG;IACpC,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/C,CAAC;AAEF,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,uBAAuB,GAAG,SAAS,GACtC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAExB;AAED,wBAAgB,2BAA2B,CACzC,EAAE,EAAE,uBAAuB,GAAG,SAAS,EACvC,UAAU,EAAE,MAAM,GACjB,MAAM,CAER;AAED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAGzF"}

package/dist/editor/editor-carousel-preview-ui.js

@@ -0,0 +1,11 @@
+export function readEditorCarouselPages(ui) {
+    return ui?.carouselPreviewPages ?? {};
+}
+export function getEditorCarouselPageFromUi(ui, carouselId) {
+    return readEditorCarouselPages(ui)[carouselId] ?? 0;
+}
+export function carouselEditorPageCount(slideCount, slidesPerView) {
+    const perView = Math.max(1, Math.round(slidesPerView));
+    return Math.max(1, Math.ceil(Math.max(0, slideCount) / perView));
+}
+//# sourceMappingURL=editor-carousel-preview-ui.js.map

package/dist/editor/editor-carousel-preview-ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-carousel-preview-ui.js","sourceRoot":"","sources":["../../src/editor/editor-carousel-preview-ui.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,uBAAuB,CACrC,EAAuC;IAEvC,OAAO,EAAE,EAAE,oBAAoB,IAAI,EAAE,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,EAAuC,EACvC,UAAkB;IAElB,OAAO,uBAAuB,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,UAAkB,EAAE,aAAqB;IAC/E,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;IACvD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;AACnE,CAAC"}