@pantheon-systems/puck-css 0.4.2 → 0.4.3

package/dist/features/content-type-templates/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Content Type Templates Feature
+ *
+ * Enables site admins to define structural templates for documents
+ * and enforce structural conformance via role-based permissions.
+ *
+ * Feature-gated via enableContentTypeTemplates flag (default: true).
+ */
+export type { ContentRole, TemplateMetadata, TemplateComponent, Template, TemplateBinding, CreateTemplateParams, UpdateTemplateParams, TemplateDocument, } from './types.js';
+export type { TemplateStore } from './stores/index.js';
+export { createInMemoryTemplateStore, createApiTemplateStore } from './stores/index.js';
+export type { ComponentPermissions } from './permissions/role-permissions.js';
+export { getPermissionsForRole, canPerformStructuralAction, canEditProps, canOverrideUrl, mergePermissions, } from './permissions/role-permissions.js';
+export type { UseContentRoleReturn } from './permissions/useContentRole.js';
+export { useContentRole } from './permissions/useContentRole.js';
+export type { UseResolveContentRoleOptions, UseResolveContentRoleReturn } from './permissions/useResolveContentRole.js';
+export { useResolveContentRole, mapCssRoleToContentRole } from './permissions/useResolveContentRole.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/features/content-type-templates/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/content-type-templates/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,QAAQ,EACR,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,2BAA2B,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAExF,YAAY,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,YAAY,EACZ,cAAc,EACd,gBAAgB,GACjB,MAAM,mCAAmC,CAAC;AAC3C,YAAY,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,YAAY,EAAE,4BAA4B,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAC;AACxH,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC"}

package/dist/features/content-type-templates/index.js

@@ -0,0 +1,13 @@
+/**
+ * Content Type Templates Feature
+ *
+ * Enables site admins to define structural templates for documents
+ * and enforce structural conformance via role-based permissions.
+ *
+ * Feature-gated via enableContentTypeTemplates flag (default: true).
+ */
+export { createInMemoryTemplateStore, createApiTemplateStore } from './stores/index.js';
+export { getPermissionsForRole, canPerformStructuralAction, canEditProps, canOverrideUrl, mergePermissions, } from './permissions/role-permissions.js';
+export { useContentRole } from './permissions/useContentRole.js';
+export { useResolveContentRole, mapCssRoleToContentRole } from './permissions/useResolveContentRole.js';
+//# sourceMappingURL=index.js.map

package/dist/features/content-type-templates/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/features/content-type-templates/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAcH,OAAO,EAAE,2BAA2B,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAGxF,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,YAAY,EACZ,cAAc,EACd,gBAAgB,GACjB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEjE,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC"}

package/dist/features/content-type-templates/permissions/createPuckPermissions.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Puck Permissions Resolver
+ *
+ * Creates a resolvePermissions function for Puck that enforces template constraints.
+ */
+import type { Template, ContentRole } from '../types.js';
+/**
+ * Puck permission flags for a component.
+ */
+export interface PuckPermissions {
+    /** Can edit component props */
+    edit: boolean;
+    /** Can drag/reorder component */
+    drag: boolean;
+    /** Can delete component */
+    delete: boolean;
+    /** Can insert new components */
+    insert: boolean;
+    /** Can duplicate component */
+    duplicate: boolean;
+}
+/**
+ * Item passed to resolvePermissions by Puck.
+ */
+export interface PuckItem {
+    type: string;
+}
+/**
+ * App state passed to resolvePermissions by Puck.
+ */
+export interface PuckAppState {
+    [key: string]: unknown;
+}
+/**
+ * Permission resolver function type for Puck.
+ */
+export type PuckPermissionResolver = (item: PuckItem, appState: PuckAppState) => PuckPermissions;
+/**
+ * Create a Puck permissions resolver based on template and user role.
+ *
+ * Permission logic:
+ * - **Pinned components**: drag=false, delete=false for all roles
+ * - **Non-pinned components**:
+ *   - Admin/Editor: full permissions
+ *   - Junior Editor: no structural permissions (drag/delete/insert/duplicate)
+ * - **Blank pages (no template)**:
+ *   - Admin/Editor: full permissions
+ *   - Junior Editor: no structural permissions
+ * - **Historical versions**: all structural permissions false for all roles
+ *
+ * @param template - Template this document is bound to (null for blank pages)
+ * @param role - User's content role
+ * @param isHistoricalVersion - Whether viewing a historical version (read-only)
+ * @returns Permission resolver function for Puck
+ *
+ * @example
+ * ```tsx
+ * const resolvePermissions = createPuckPermissions(template, 'editor', false);
+ *
+ * <Puck
+ *   config={puckConfig}
+ *   data={puckData}
+ *   resolvePermissions={resolvePermissions}
+ * />
+ * ```
+ */
+export declare function createPuckPermissions(template: Template | null, role: ContentRole, isHistoricalVersion: boolean): PuckPermissionResolver;
+//# sourceMappingURL=createPuckPermissions.d.ts.map

package/dist/features/content-type-templates/permissions/createPuckPermissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createPuckPermissions.d.ts","sourceRoot":"","sources":["../../../../src/features/content-type-templates/permissions/createPuckPermissions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,+BAA+B;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,iCAAiC;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,2BAA2B;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,gCAAgC;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,8BAA8B;IAC9B,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAE3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,CACnC,IAAI,EAAE,QAAQ,EACd,QAAQ,EAAE,YAAY,KACnB,eAAe,CAAC;AAErB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,QAAQ,GAAG,IAAI,EACzB,IAAI,EAAE,WAAW,EACjB,mBAAmB,EAAE,OAAO,GAC3B,sBAAsB,CA4DxB"}

package/dist/features/content-type-templates/permissions/createPuckPermissions.js

@@ -0,0 +1,90 @@
+/**
+ * Puck Permissions Resolver
+ *
+ * Creates a resolvePermissions function for Puck that enforces template constraints.
+ */
+/**
+ * Create a Puck permissions resolver based on template and user role.
+ *
+ * Permission logic:
+ * - **Pinned components**: drag=false, delete=false for all roles
+ * - **Non-pinned components**:
+ *   - Admin/Editor: full permissions
+ *   - Junior Editor: no structural permissions (drag/delete/insert/duplicate)
+ * - **Blank pages (no template)**:
+ *   - Admin/Editor: full permissions
+ *   - Junior Editor: no structural permissions
+ * - **Historical versions**: all structural permissions false for all roles
+ *
+ * @param template - Template this document is bound to (null for blank pages)
+ * @param role - User's content role
+ * @param isHistoricalVersion - Whether viewing a historical version (read-only)
+ * @returns Permission resolver function for Puck
+ *
+ * @example
+ * ```tsx
+ * const resolvePermissions = createPuckPermissions(template, 'editor', false);
+ *
+ * <Puck
+ *   config={puckConfig}
+ *   data={puckData}
+ *   resolvePermissions={resolvePermissions}
+ * />
+ * ```
+ */
+export function createPuckPermissions(template, role, isHistoricalVersion) {
+    return (item) => {
+        // Historical versions: all structural permissions false
+        if (isHistoricalVersion) {
+            return {
+                edit: true, // Can still view props in read-only mode
+                drag: false,
+                delete: false,
+                insert: false,
+                duplicate: false,
+            };
+        }
+        const juniorEditorRestricted = role === 'junior-editor';
+        // No template or template without components
+        if (!template || !template.components) {
+            return {
+                edit: true,
+                drag: !juniorEditorRestricted,
+                delete: !juniorEditorRestricted,
+                insert: !juniorEditorRestricted,
+                duplicate: !juniorEditorRestricted,
+            };
+        }
+        // Find component in template
+        const templateComponent = template.components.find((c) => c.type === item.type);
+        // Component not in template (user added it)
+        if (!templateComponent) {
+            return {
+                edit: true,
+                drag: !juniorEditorRestricted,
+                delete: !juniorEditorRestricted,
+                insert: !juniorEditorRestricted,
+                duplicate: !juniorEditorRestricted,
+            };
+        }
+        // Pinned component: locked for all roles
+        if (templateComponent.pinned) {
+            return {
+                edit: true,
+                drag: false,
+                delete: false,
+                insert: juniorEditorRestricted ? false : true,
+                duplicate: juniorEditorRestricted ? false : true,
+            };
+        }
+        // Non-pinned component in template
+        return {
+            edit: true,
+            drag: !juniorEditorRestricted,
+            delete: !juniorEditorRestricted,
+            insert: !juniorEditorRestricted,
+            duplicate: !juniorEditorRestricted,
+        };
+    };
+}
+//# sourceMappingURL=createPuckPermissions.js.map

package/dist/features/content-type-templates/permissions/createPuckPermissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createPuckPermissions.js","sourceRoot":"","sources":["../../../../src/features/content-type-templates/permissions/createPuckPermissions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA2CH;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAyB,EACzB,IAAiB,EACjB,mBAA4B;IAE5B,OAAO,CAAC,IAAc,EAAmB,EAAE;QACzC,wDAAwD;QACxD,IAAI,mBAAmB,EAAE,CAAC;YACxB,OAAO;gBACL,IAAI,EAAE,IAAI,EAAE,yCAAyC;gBACrD,IAAI,EAAE,KAAK;gBACX,MAAM,EAAE,KAAK;gBACb,MAAM,EAAE,KAAK;gBACb,SAAS,EAAE,KAAK;aACjB,CAAC;QACJ,CAAC;QAED,MAAM,sBAAsB,GAAG,IAAI,KAAK,eAAe,CAAC;QAExD,6CAA6C;QAC7C,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;YACtC,OAAO;gBACL,IAAI,EAAE,IAAI;gBACV,IAAI,EAAE,CAAC,sBAAsB;gBAC7B,MAAM,EAAE,CAAC,sBAAsB;gBAC/B,MAAM,EAAE,CAAC,sBAAsB;gBAC/B,SAAS,EAAE,CAAC,sBAAsB;aACnC,CAAC;QACJ,CAAC;QAED,6BAA6B;QAC7B,MAAM,iBAAiB,GAAG,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC;QAEhF,4CAA4C;QAC5C,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACvB,OAAO;gBACL,IAAI,EAAE,IAAI;gBACV,IAAI,EAAE,CAAC,sBAAsB;gBAC7B,MAAM,EAAE,CAAC,sBAAsB;gBAC/B,MAAM,EAAE,CAAC,sBAAsB;gBAC/B,SAAS,EAAE,CAAC,sBAAsB;aACnC,CAAC;QACJ,CAAC;QAED,yCAAyC;QACzC,IAAI,iBAAiB,CAAC,MAAM,EAAE,CAAC;YAC7B,OAAO;gBACL,IAAI,EAAE,IAAI;gBACV,IAAI,EAAE,KAAK;gBACX,MAAM,EAAE,KAAK;gBACb,MAAM,EAAE,sBAAsB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;gBAC7C,SAAS,EAAE,sBAAsB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;aACjD,CAAC;QACJ,CAAC;QAED,mCAAmC;QACnC,OAAO;YACL,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,CAAC,sBAAsB;YAC7B,MAAM,EAAE,CAAC,sBAAsB;YAC/B,MAAM,EAAE,CAAC,sBAAsB;YAC/B,SAAS,EAAE,CAAC,sBAAsB;SACnC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/features/content-type-templates/permissions/role-permissions.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Role-Based Permissions
+ *
+ * Permission calculations for content editing roles.
+ */
+import type { ContentRole } from '../types.js';
+/**
+ * Component-level permissions.
+ */
+export interface ComponentPermissions {
+    /** Can add new components */
+    canAddComponents: boolean;
+    /** Can remove components */
+    canRemoveComponents: boolean;
+    /** Can move/reorder components */
+    canMoveComponents: boolean;
+    /** Can edit component props */
+    canEditProps: boolean;
+    /** Can override default URL pattern */
+    canOverrideUrl: boolean;
+}
+/**
+ * Get permissions for a content role.
+ *
+ * - admin: Full access - can create/edit templates, full structural control
+ * - editor: Pinned components locked (cannot move/delete), can add/remove non-pinned
+ * - junior-editor: View/edit props only, no structural changes
+ */
+export declare function getPermissionsForRole(role: ContentRole): ComponentPermissions;
+/**
+ * Check if a role can perform structural actions (add/remove/move components).
+ */
+export declare function canPerformStructuralAction(role: ContentRole): boolean;
+/**
+ * Check if a role can edit component props.
+ */
+export declare function canEditProps(role: ContentRole): boolean;
+/**
+ * Check if a role can override default URL pattern.
+ */
+export declare function canOverrideUrl(role: ContentRole): boolean;
+/**
+ * Merge template-based permissions with historical version lock.
+ *
+ * When viewing a historical version, all editing is disabled.
+ * This combines with role-based permissions to enforce the most restrictive policy.
+ */
+export declare function mergePermissions(templatePerms: ComponentPermissions, isHistoricalVersion: boolean): ComponentPermissions;
+//# sourceMappingURL=role-permissions.d.ts.map

package/dist/features/content-type-templates/permissions/role-permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-permissions.d.ts","sourceRoot":"","sources":["../../../../src/features/content-type-templates/permissions/role-permissions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,6BAA6B;IAC7B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,4BAA4B;IAC5B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,kCAAkC;IAClC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,+BAA+B;IAC/B,YAAY,EAAE,OAAO,CAAC;IACtB,uCAAuC;IACvC,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,WAAW,GAAG,oBAAoB,CA2B7E;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAGrE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAEvD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAEzD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,oBAAoB,EACnC,mBAAmB,EAAE,OAAO,GAC3B,oBAAoB,CAatB"}

package/dist/features/content-type-templates/permissions/role-permissions.js

@@ -0,0 +1,79 @@
+/**
+ * Role-Based Permissions
+ *
+ * Permission calculations for content editing roles.
+ */
+/**
+ * Get permissions for a content role.
+ *
+ * - admin: Full access - can create/edit templates, full structural control
+ * - editor: Pinned components locked (cannot move/delete), can add/remove non-pinned
+ * - junior-editor: View/edit props only, no structural changes
+ */
+export function getPermissionsForRole(role) {
+    switch (role) {
+        case 'admin':
+            return {
+                canAddComponents: true,
+                canRemoveComponents: true,
+                canMoveComponents: true,
+                canEditProps: true,
+                canOverrideUrl: true,
+            };
+        case 'editor':
+            return {
+                canAddComponents: true,
+                canRemoveComponents: true,
+                canMoveComponents: true,
+                canEditProps: true,
+                canOverrideUrl: true,
+            };
+        case 'junior-editor':
+            return {
+                canAddComponents: false,
+                canRemoveComponents: false,
+                canMoveComponents: false,
+                canEditProps: true,
+                canOverrideUrl: false,
+            };
+    }
+}
+/**
+ * Check if a role can perform structural actions (add/remove/move components).
+ */
+export function canPerformStructuralAction(role) {
+    const perms = getPermissionsForRole(role);
+    return perms.canAddComponents || perms.canRemoveComponents || perms.canMoveComponents;
+}
+/**
+ * Check if a role can edit component props.
+ */
+export function canEditProps(role) {
+    return getPermissionsForRole(role).canEditProps;
+}
+/**
+ * Check if a role can override default URL pattern.
+ */
+export function canOverrideUrl(role) {
+    return getPermissionsForRole(role).canOverrideUrl;
+}
+/**
+ * Merge template-based permissions with historical version lock.
+ *
+ * When viewing a historical version, all editing is disabled.
+ * This combines with role-based permissions to enforce the most restrictive policy.
+ */
+export function mergePermissions(templatePerms, isHistoricalVersion) {
+    if (isHistoricalVersion) {
+        // Historical versions are read-only
+        return {
+            canAddComponents: false,
+            canRemoveComponents: false,
+            canMoveComponents: false,
+            canEditProps: false,
+            canOverrideUrl: false,
+        };
+    }
+    return templatePerms;
+}
+//# sourceMappingURL=role-permissions.js.map

package/dist/features/content-type-templates/permissions/role-permissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-permissions.js","sourceRoot":"","sources":["../../../../src/features/content-type-templates/permissions/role-permissions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAiB;IACrD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,OAAO;YACV,OAAO;gBACL,gBAAgB,EAAE,IAAI;gBACtB,mBAAmB,EAAE,IAAI;gBACzB,iBAAiB,EAAE,IAAI;gBACvB,YAAY,EAAE,IAAI;gBAClB,cAAc,EAAE,IAAI;aACrB,CAAC;QACJ,KAAK,QAAQ;YACX,OAAO;gBACL,gBAAgB,EAAE,IAAI;gBACtB,mBAAmB,EAAE,IAAI;gBACzB,iBAAiB,EAAE,IAAI;gBACvB,YAAY,EAAE,IAAI;gBAClB,cAAc,EAAE,IAAI;aACrB,CAAC;QACJ,KAAK,eAAe;YAClB,OAAO;gBACL,gBAAgB,EAAE,KAAK;gBACvB,mBAAmB,EAAE,KAAK;gBAC1B,iBAAiB,EAAE,KAAK;gBACxB,YAAY,EAAE,IAAI;gBAClB,cAAc,EAAE,KAAK;aACtB,CAAC;IACN,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAAiB;IAC1D,MAAM,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAC1C,OAAO,KAAK,CAAC,gBAAgB,IAAI,KAAK,CAAC,mBAAmB,IAAI,KAAK,CAAC,iBAAiB,CAAC;AACxF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAiB;IAC5C,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAiB;IAC9C,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC,cAAc,CAAC;AACpD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,aAAmC,EACnC,mBAA4B;IAE5B,IAAI,mBAAmB,EAAE,CAAC;QACxB,oCAAoC;QACpC,OAAO;YACL,gBAAgB,EAAE,KAAK;YACvB,mBAAmB,EAAE,KAAK;YAC1B,iBAAiB,EAAE,KAAK;YACxB,YAAY,EAAE,KAAK;YACnB,cAAc,EAAE,KAAK;SACtB,CAAC;IACJ,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/dist/features/content-type-templates/permissions/useContentRole.d.ts

@@ -0,0 +1,37 @@
+/**
+ * useContentRole Hook
+ *
+ * React hook for managing content editing role and permissions.
+ */
+import type { ContentRole } from '../types.js';
+import { type ComponentPermissions } from './role-permissions.js';
+/**
+ * Return value from useContentRole hook.
+ */
+export interface UseContentRoleReturn {
+    /** Current content editing role */
+    role: ContentRole;
+    /** Computed permissions for the role */
+    permissions: ComponentPermissions;
+}
+/**
+ * Hook for managing content editing role and permissions.
+ *
+ * @param role - Content editing role (defaults to 'admin')
+ * @returns Current role and computed permissions
+ *
+ * @example
+ * ```tsx
+ * function Editor() {
+ *   const { role, permissions } = useContentRole('editor');
+ *
+ *   if (!permissions.canAddComponents) {
+ *     return <div>Read-only mode</div>;
+ *   }
+ *
+ *   return <PuckEditor />;
+ * }
+ * ```
+ */
+export declare function useContentRole(role?: ContentRole): UseContentRoleReturn;
+//# sourceMappingURL=useContentRole.d.ts.map

package/dist/features/content-type-templates/permissions/useContentRole.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useContentRole.d.ts","sourceRoot":"","sources":["../../../../src/features/content-type-templates/permissions/useContentRole.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAyB,KAAK,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAEzF;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,mCAAmC;IACnC,IAAI,EAAE,WAAW,CAAC;IAClB,wCAAwC;IACxC,WAAW,EAAE,oBAAoB,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAAC,IAAI,GAAE,WAAqB,GAAG,oBAAoB,CAOhF"}

package/dist/features/content-type-templates/permissions/useContentRole.js

@@ -0,0 +1,34 @@
+/**
+ * useContentRole Hook
+ *
+ * React hook for managing content editing role and permissions.
+ */
+import { useMemo } from 'react';
+import { getPermissionsForRole } from './role-permissions.js';
+/**
+ * Hook for managing content editing role and permissions.
+ *
+ * @param role - Content editing role (defaults to 'admin')
+ * @returns Current role and computed permissions
+ *
+ * @example
+ * ```tsx
+ * function Editor() {
+ *   const { role, permissions } = useContentRole('editor');
+ *
+ *   if (!permissions.canAddComponents) {
+ *     return <div>Read-only mode</div>;
+ *   }
+ *
+ *   return <PuckEditor />;
+ * }
+ * ```
+ */
+export function useContentRole(role = 'admin') {
+    const permissions = useMemo(() => getPermissionsForRole(role), [role]);
+    return {
+        role,
+        permissions,
+    };
+}
+//# sourceMappingURL=useContentRole.js.map

package/dist/features/content-type-templates/permissions/useContentRole.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useContentRole.js","sourceRoot":"","sources":["../../../../src/features/content-type-templates/permissions/useContentRole.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,EAAE,qBAAqB,EAA6B,MAAM,uBAAuB,CAAC;AAYzF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,cAAc,CAAC,OAAoB,OAAO;IACxD,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAEvE,OAAO;QACL,IAAI;QACJ,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/dist/features/content-type-templates/permissions/useResolveContentRole.d.ts

@@ -0,0 +1,38 @@
+/**
+ * useResolveContentRole Hook
+ *
+ * Auto-detects the user's ContentRole by querying the CSS backend's
+ * auth/me endpoint with site context. Falls back to the provided
+ * default role if the backend doesn't return role info.
+ *
+ * CSS backend role mapping:
+ * - ADMIN → 'admin'
+ * - EDITOR → 'editor'
+ * - VIEWER → 'junior-editor' (read-only structural access)
+ * - NO_ACCESS → 'junior-editor' (most restrictive)
+ */
+import type { ContentRole } from '../types.js';
+type CssRoleName = 'ADMIN' | 'EDITOR' | 'VIEWER' | 'NO_ACCESS';
+declare function mapCssRoleToContentRole(cssRole: CssRoleName): ContentRole;
+export interface UseResolveContentRoleOptions {
+    baseUrl: string;
+    siteId: string;
+    branchId: string;
+    token: string | null;
+    fallbackRole?: ContentRole;
+}
+export interface UseResolveContentRoleReturn {
+    role: ContentRole;
+    loading: boolean;
+    resolved: boolean;
+}
+/**
+ * Hook to auto-resolve the user's ContentRole from the CSS backend.
+ *
+ * Calls GET /api/sites/{siteId}/auth/role (when available) to determine
+ * the user's effective role. Falls back to the provided fallbackRole
+ * if the endpoint is unavailable or returns an error.
+ */
+export declare function useResolveContentRole({ baseUrl, siteId, branchId, token, fallbackRole, }: UseResolveContentRoleOptions): UseResolveContentRoleReturn;
+export { mapCssRoleToContentRole };
+//# sourceMappingURL=useResolveContentRole.d.ts.map

package/dist/features/content-type-templates/permissions/useResolveContentRole.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useResolveContentRole.d.ts","sourceRoot":"","sources":["../../../../src/features/content-type-templates/permissions/useResolveContentRole.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,KAAK,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE/D,iBAAS,uBAAuB,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW,CAWlE;AAED,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,YAAY,CAAC,EAAE,WAAW,CAAC;CAC5B;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,OAAO,EACP,MAAM,EACN,QAAQ,EACR,KAAK,EACL,YAA8B,GAC/B,EAAE,4BAA4B,GAAG,2BAA2B,CAkD5D;AAED,OAAO,EAAE,uBAAuB,EAAE,CAAC"}

package/dist/features/content-type-templates/permissions/useResolveContentRole.js

@@ -0,0 +1,83 @@
+/**
+ * useResolveContentRole Hook
+ *
+ * Auto-detects the user's ContentRole by querying the CSS backend's
+ * auth/me endpoint with site context. Falls back to the provided
+ * default role if the backend doesn't return role info.
+ *
+ * CSS backend role mapping:
+ * - ADMIN → 'admin'
+ * - EDITOR → 'editor'
+ * - VIEWER → 'junior-editor' (read-only structural access)
+ * - NO_ACCESS → 'junior-editor' (most restrictive)
+ */
+import { useState, useEffect } from 'react';
+function mapCssRoleToContentRole(cssRole) {
+    switch (cssRole) {
+        case 'ADMIN':
+            return 'admin';
+        case 'EDITOR':
+            return 'editor';
+        case 'VIEWER':
+        case 'NO_ACCESS':
+        default:
+            return 'junior-editor';
+    }
+}
+/**
+ * Hook to auto-resolve the user's ContentRole from the CSS backend.
+ *
+ * Calls GET /api/sites/{siteId}/auth/role (when available) to determine
+ * the user's effective role. Falls back to the provided fallbackRole
+ * if the endpoint is unavailable or returns an error.
+ */
+export function useResolveContentRole({ baseUrl, siteId, branchId, token, fallbackRole = 'junior-editor', }) {
+    const [role, setRole] = useState(fallbackRole);
+    const [loading, setLoading] = useState(true);
+    const [resolved, setResolved] = useState(false);
+    useEffect(() => {
+        if (!baseUrl || !siteId || !token) {
+            setRole(fallbackRole);
+            setLoading(false);
+            return;
+        }
+        let cancelled = false;
+        (async () => {
+            try {
+                const headers = {
+                    Authorization: `Bearer ${token}`,
+                };
+                const res = await fetch(`${baseUrl}/api/sites/${encodeURIComponent(siteId)}/branches/${encodeURIComponent(branchId)}/auth/role`, { method: 'GET', headers });
+                if (cancelled)
+                    return;
+                if (res.ok) {
+                    const data = (await res.json());
+                    if (data.roleName) {
+                        setRole(mapCssRoleToContentRole(data.roleName));
+                        setResolved(true);
+                    }
+                    else {
+                        setRole(fallbackRole);
+                    }
+                }
+                else {
+                    setRole(fallbackRole);
+                }
+            }
+            catch {
+                if (!cancelled)
+                    setRole(fallbackRole);
+            }
+            finally {
+                if (!cancelled)
+                    setLoading(false);
+            }
+        })();
+        return () => {
+            cancelled = true;
+        };
+    }, [baseUrl, siteId, branchId, token, fallbackRole]);
+    return { role, loading, resolved };
+}
+export { mapCssRoleToContentRole };
+//# sourceMappingURL=useResolveContentRole.js.map

package/dist/features/content-type-templates/permissions/useResolveContentRole.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useResolveContentRole.js","sourceRoot":"","sources":["../../../../src/features/content-type-templates/permissions/useResolveContentRole.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAK5C,SAAS,uBAAuB,CAAC,OAAoB;IACnD,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,OAAO;YACV,OAAO,OAAO,CAAC;QACjB,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB,KAAK,QAAQ,CAAC;QACd,KAAK,WAAW,CAAC;QACjB;YACE,OAAO,eAAe,CAAC;IAC3B,CAAC;AACH,CAAC;AAgBD;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,EACpC,OAAO,EACP,MAAM,EACN,QAAQ,EACR,KAAK,EACL,YAAY,GAAG,eAAe,GACD;IAC7B,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAc,YAAY,CAAC,CAAC;IAC5D,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAEhD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;YAClC,OAAO,CAAC,YAAY,CAAC,CAAC;YACtB,UAAU,CAAC,KAAK,CAAC,CAAC;YAClB,OAAO;QACT,CAAC;QAED,IAAI,SAAS,GAAG,KAAK,CAAC;QAEtB,CAAC,KAAK,IAAI,EAAE;YACV,IAAI,CAAC;gBACH,MAAM,OAAO,GAA2B;oBACtC,aAAa,EAAE,UAAU,KAAK,EAAE;iBACjC,CAAC;gBACF,MAAM,GAAG,GAAG,MAAM,KAAK,CACrB,GAAG,OAAO,cAAc,kBAAkB,CAAC,MAAM,CAAC,aAAa,kBAAkB,CAAC,QAAQ,CAAC,YAAY,EACvG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAC3B,CAAC;gBAEF,IAAI,SAAS;oBAAE,OAAO;gBAEtB,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;oBACX,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA+B,CAAC;oBAC9D,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;wBAClB,OAAO,CAAC,uBAAuB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;wBAChD,WAAW,CAAC,IAAI,CAAC,CAAC;oBACpB,CAAC;yBAAM,CAAC;wBACN,OAAO,CAAC,YAAY,CAAC,CAAC;oBACxB,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,YAAY,CAAC,CAAC;gBACxB,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,CAAC,SAAS;oBAAE,OAAO,CAAC,YAAY,CAAC,CAAC;YACxC,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,SAAS;oBAAE,UAAU,CAAC,KAAK,CAAC,CAAC;YACpC,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QAEL,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC;IAErD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AACrC,CAAC;AAED,OAAO,EAAE,uBAAuB,EAAE,CAAC"}

package/dist/features/content-type-templates/stores/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Template Stores
+ *
+ * Store implementations for template persistence.
+ */
+export type { TemplateStore } from './template-store.js';
+export { createInMemoryTemplateStore } from './template-store.js';
+export { createApiTemplateStore } from './template-store-api.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/features/content-type-templates/stores/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/features/content-type-templates/stores/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/features/content-type-templates/stores/index.js

@@ -0,0 +1,8 @@
+/**
+ * Template Stores
+ *
+ * Store implementations for template persistence.
+ */
+export { createInMemoryTemplateStore } from './template-store.js';
+export { createApiTemplateStore } from './template-store-api.js';
+//# sourceMappingURL=index.js.map

package/dist/features/content-type-templates/stores/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/features/content-type-templates/stores/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/features/content-type-templates/stores/template-store-api.d.ts

@@ -0,0 +1,17 @@
+/**
+ * API-Backed Template Store
+ *
+ * Production template store implementation using the backend API.
+ */
+import type { P1Client } from '@pantheon-systems/css-client';
+import type { TemplateStore } from './template-store.js';
+/**
+ * Create a template store backed by the P1 API.
+ *
+ * @param client - P1Client instance
+ * @param siteId - Site ID
+ * @param branchId - Branch ID
+ * @returns TemplateStore instance
+ */
+export declare function createApiTemplateStore(client: P1Client, siteId: string, branchId: string): TemplateStore;
+//# sourceMappingURL=template-store-api.d.ts.map

package/dist/features/content-type-templates/stores/template-store-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-store-api.d.ts","sourceRoot":"","sources":["../../../../src/features/content-type-templates/stores/template-store-api.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,aAAa,CAoDf"}