@pantheon-systems/puck-css 0.4.0

package/dist/core/featureConfig.d.ts

@@ -0,0 +1,56 @@
+/**
+ * P1 Feature Configuration
+ *
+ * Configuration-driven feature enablement for the P1 Puck integration.
+ * Features can be toggled via config flags instead of manual code wiring.
+ */
+/**
+ * Feature flags for P1 Puck integration UI features.
+ *
+ * These flags control which UI panels and behaviors are enabled.
+ * They extend the existing P1PuckConfig props (enableRealtime,
+ * presenceEnabled, agentModeEnabled) with flags for UI-specific features.
+ */
+export interface P1FeatureConfig {
+    /** Enable real-time collaborative editing */
+    enableRealtime?: boolean;
+    /** Enable presence tracking */
+    presenceEnabled?: boolean;
+    /** Enable agent mode features */
+    agentModeEnabled?: boolean;
+    /** Show document list in plugin panel (default: true) */
+    enableDocumentBrowser?: boolean;
+    /** Show branch selector in plugin panel (default: true) */
+    enableBranchSelector?: boolean;
+    /** Show version list in plugin panel (default: true) */
+    enableVersionHistory?: boolean;
+    /** Show merge controls in plugin panel (default: true) */
+    enableMergeControl?: boolean;
+    /** Enable auto-save indicator (default: true) */
+    enableAutoSave?: boolean;
+    /** Show publish/checkpoint button (default: true) */
+    enablePublishButton?: boolean;
+    /** Show collaborator avatars in header (default: follows presenceEnabled) */
+    enableCollaboratorAvatars?: boolean;
+    /** Show agent activity banner (default: follows agentModeEnabled) */
+    enableAgentBanner?: boolean;
+    /** Enable focus region highlighting (default: follows presenceEnabled) */
+    enableFocusHighlighting?: boolean;
+}
+/**
+ * Preset configurations for common setups.
+ */
+export declare const P1_PRESETS: Record<'basic' | 'collaborative' | 'full', P1FeatureConfig>;
+/**
+ * Resolves feature flags with defaults.
+ *
+ * Some flags have defaults that follow other flags:
+ * - enableCollaboratorAvatars defaults to presenceEnabled
+ * - enableAgentBanner defaults to agentModeEnabled
+ * - enableFocusHighlighting defaults to presenceEnabled
+ *
+ * @param config - Feature config with optional flags
+ * @returns Resolved config with all flags set
+ */
+export declare function resolveFeatureConfig(config: P1FeatureConfig): Required<P1FeatureConfig>;
+//# sourceMappingURL=featureConfig.d.ts.map

package/dist/core/featureConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"featureConfig.d.ts","sourceRoot":"","sources":["../../src/core/featureConfig.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAK9B,6CAA6C;IAC7C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,+BAA+B;IAC/B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iCAAiC;IACjC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAM3B,yDAAyD;IACzD,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,2DAA2D;IAC3D,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,wDAAwD;IACxD,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,0DAA0D;IAC1D,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,iDAAiD;IACjD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,qDAAqD;IACrD,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,6EAA6E;IAC7E,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,qEAAqE;IACrE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,0EAA0E;IAC1E,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,OAAO,GAAG,eAAe,GAAG,MAAM,EAAE,eAAe,CAyClF,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,QAAQ,CAAC,eAAe,CAAC,CAevF"}

package/dist/core/featureConfig.js

@@ -0,0 +1,77 @@
+/**
+ * P1 Feature Configuration
+ *
+ * Configuration-driven feature enablement for the P1 Puck integration.
+ * Features can be toggled via config flags instead of manual code wiring.
+ */
+/**
+ * Preset configurations for common setups.
+ */
+export const P1_PRESETS = {
+    /**
+     * Basic preset: auto-save and publish only.
+     * Suitable for single-user editing without collaboration.
+     */
+    basic: {
+        enableAutoSave: true,
+        enablePublishButton: true,
+    },
+    /**
+     * Collaborative preset: adds real-time editing, presence, and focus highlighting.
+     * Suitable for multi-user editing scenarios.
+     */
+    collaborative: {
+        enableRealtime: true,
+        presenceEnabled: true,
+        enableAutoSave: true,
+        enablePublishButton: true,
+        enableCollaboratorAvatars: true,
+        enableFocusHighlighting: true,
+    },
+    /**
+     * Full preset: all features enabled.
+     * Suitable for power-user or admin scenarios.
+     */
+    full: {
+        enableRealtime: true,
+        presenceEnabled: true,
+        agentModeEnabled: true,
+        enableDocumentBrowser: true,
+        enableBranchSelector: true,
+        enableVersionHistory: true,
+        enableMergeControl: true,
+        enableAutoSave: true,
+        enablePublishButton: true,
+        enableCollaboratorAvatars: true,
+        enableAgentBanner: true,
+        enableFocusHighlighting: true,
+    },
+};
+/**
+ * Resolves feature flags with defaults.
+ *
+ * Some flags have defaults that follow other flags:
+ * - enableCollaboratorAvatars defaults to presenceEnabled
+ * - enableAgentBanner defaults to agentModeEnabled
+ * - enableFocusHighlighting defaults to presenceEnabled
+ *
+ * @param config - Feature config with optional flags
+ * @returns Resolved config with all flags set
+ */
+export function resolveFeatureConfig(config) {
+    return {
+        enableRealtime: config.enableRealtime ?? true,
+        presenceEnabled: config.presenceEnabled ?? true,
+        agentModeEnabled: config.agentModeEnabled ?? false,
+        enableDocumentBrowser: config.enableDocumentBrowser ?? true,
+        enableBranchSelector: config.enableBranchSelector ?? true,
+        enableVersionHistory: config.enableVersionHistory ?? true,
+        enableMergeControl: config.enableMergeControl ?? true,
+        enableAutoSave: config.enableAutoSave ?? true,
+        enablePublishButton: config.enablePublishButton ?? true,
+        enableCollaboratorAvatars: config.enableCollaboratorAvatars ?? config.presenceEnabled ?? false,
+        enableAgentBanner: config.enableAgentBanner ?? config.agentModeEnabled ?? false,
+        enableFocusHighlighting: config.enableFocusHighlighting ?? config.presenceEnabled ?? false,
+    };
+}
+//# sourceMappingURL=featureConfig.js.map

package/dist/core/featureConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"featureConfig.js","sourceRoot":"","sources":["../../src/core/featureConfig.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA6CH;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAgE;IACrF;;;OAGG;IACH,KAAK,EAAE;QACL,cAAc,EAAE,IAAI;QACpB,mBAAmB,EAAE,IAAI;KAC1B;IAED;;;OAGG;IACH,aAAa,EAAE;QACb,cAAc,EAAE,IAAI;QACpB,eAAe,EAAE,IAAI;QACrB,cAAc,EAAE,IAAI;QACpB,mBAAmB,EAAE,IAAI;QACzB,yBAAyB,EAAE,IAAI;QAC/B,uBAAuB,EAAE,IAAI;KAC9B;IAED;;;OAGG;IACH,IAAI,EAAE;QACJ,cAAc,EAAE,IAAI;QACpB,eAAe,EAAE,IAAI;QACrB,gBAAgB,EAAE,IAAI;QACtB,qBAAqB,EAAE,IAAI;QAC3B,oBAAoB,EAAE,IAAI;QAC1B,oBAAoB,EAAE,IAAI;QAC1B,kBAAkB,EAAE,IAAI;QACxB,cAAc,EAAE,IAAI;QACpB,mBAAmB,EAAE,IAAI;QACzB,yBAAyB,EAAE,IAAI;QAC/B,iBAAiB,EAAE,IAAI;QACvB,uBAAuB,EAAE,IAAI;KAC9B;CACF,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAuB;IAC1D,OAAO;QACL,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,IAAI;QAC7C,eAAe,EAAE,MAAM,CAAC,eAAe,IAAI,IAAI;QAC/C,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,IAAI,KAAK;QAClD,qBAAqB,EAAE,MAAM,CAAC,qBAAqB,IAAI,IAAI;QAC3D,oBAAoB,EAAE,MAAM,CAAC,oBAAoB,IAAI,IAAI;QACzD,oBAAoB,EAAE,MAAM,CAAC,oBAAoB,IAAI,IAAI;QACzD,kBAAkB,EAAE,MAAM,CAAC,kBAAkB,IAAI,IAAI;QACrD,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,IAAI;QAC7C,mBAAmB,EAAE,MAAM,CAAC,mBAAmB,IAAI,IAAI;QACvD,yBAAyB,EAAE,MAAM,CAAC,yBAAyB,IAAI,MAAM,CAAC,eAAe,IAAI,KAAK;QAC9F,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,IAAI,MAAM,CAAC,gBAAgB,IAAI,KAAK;QAC/E,uBAAuB,EAAE,MAAM,CAAC,uBAAuB,IAAI,MAAM,CAAC,eAAe,IAAI,KAAK;KAC3F,CAAC;AACJ,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,17 @@
+export * from './types.js';
+export type * from './types.js';
+export { P1PuckContext, useP1Puck, useP1PuckOptional } from './P1PuckContext.js';
+export { PresenceContext, usePresenceContext, useOptionalPresenceContext, } from './PresenceContext.js';
+export type { PresenceContextValue, PresenceEventCallback, PresenceUnsubscribe, } from './PresenceContext.js';
+export { NotificationProvider, NotificationContext, useNotifications } from './NotificationContext.js';
+export { FocusHighlightContext, FocusHighlightProvider, useFocusHighlight, useFocusHighlightForComponent, } from './FocusHighlightContext.js';
+export type { FocusHighlightContextValue, FocusHighlightProviderProps, } from './FocusHighlightContext.js';
+export { P1_PRESETS, resolveFeatureConfig } from './featureConfig.js';
+export type { P1FeatureConfig } from './featureConfig.js';
+export { createP1Config, createNextConfig, createNextContentClient } from './config.js';
+export type { P1Config } from './config.js';
+export type { P1FeaturePlugin, P1FeaturePluginDeps, PuckPluginDef } from './plugin-types.js';
+export { debounce } from './utils/debounce.js';
+export { throttle } from './utils/throttle.js';
+export { withRetry } from './utils/retry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,mBAAmB,YAAY,CAAC;AAEhC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEjF,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,0BAA0B,GAC3B,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEvG,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,6BAA6B,GAC9B,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,0BAA0B,EAC1B,2BAA2B,GAC5B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AACtE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACxF,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAE7F,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,11 @@
+export * from './types.js';
+export { P1PuckContext, useP1Puck, useP1PuckOptional } from './P1PuckContext.js';
+export { PresenceContext, usePresenceContext, useOptionalPresenceContext, } from './PresenceContext.js';
+export { NotificationProvider, NotificationContext, useNotifications } from './NotificationContext.js';
+export { FocusHighlightContext, FocusHighlightProvider, useFocusHighlight, useFocusHighlightForComponent, } from './FocusHighlightContext.js';
+export { P1_PRESETS, resolveFeatureConfig } from './featureConfig.js';
+export { createP1Config, createNextConfig, createNextContentClient } from './config.js';
+export { debounce } from './utils/debounce.js';
+export { throttle } from './utils/throttle.js';
+export { withRetry } from './utils/retry.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAG3B,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEjF,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,0BAA0B,GAC3B,MAAM,sBAAsB,CAAC;AAO9B,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEvG,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,6BAA6B,GAC9B,MAAM,4BAA4B,CAAC;AAMpC,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAGtE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAKxF,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/core/plugin-types.d.ts

@@ -0,0 +1,30 @@
+import type React from 'react';
+import type { P1Client } from '@pantheon-systems/css-client';
+import type { P1FeatureConfig } from './featureConfig.js';
+export interface P1FeaturePluginDeps {
+    client: P1Client;
+    siteId: string;
+    branchId: string;
+    userId: string;
+    config: Required<P1FeatureConfig>;
+}
+export interface PuckPluginDef {
+    name: string;
+    label: string;
+    icon: React.ReactNode;
+    render: () => React.ReactElement;
+    overrides?: Record<string, unknown>;
+}
+export interface P1FeaturePlugin {
+    name: string;
+    featureFlags?: (keyof P1FeatureConfig)[];
+    priority?: number;
+    provider?: React.ComponentType<{
+        children: React.ReactNode;
+        config: Required<P1FeatureConfig>;
+        deps: P1FeaturePluginDeps;
+    }>;
+    puckPlugins?: (deps: P1FeaturePluginDeps) => PuckPluginDef[];
+    puckOverrides?: (deps: P1FeaturePluginDeps) => Record<string, unknown>;
+}
+//# sourceMappingURL=plugin-types.d.ts.map

package/dist/core/plugin-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-types.d.ts","sourceRoot":"","sources":["../../src/core/plugin-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,QAAQ,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC;IACtB,MAAM,EAAE,MAAM,KAAK,CAAC,YAAY,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,CAAC,MAAM,eAAe,CAAC,EAAE,CAAC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;QAC7B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;QAC1B,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;QAClC,IAAI,EAAE,mBAAmB,CAAC;KAC3B,CAAC,CAAC;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,aAAa,EAAE,CAAC;IAC7D,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxE"}

package/dist/core/plugin-types.js

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

package/dist/core/plugin-types.js.map

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