@kubuild/editor 0.2.0 → 0.3.0

package/dist/components/style-manager/inheritance-indicator.d.ts

@@ -0,0 +1,52 @@
+import React from 'react';
+export type Breakpoint = 'base' | 'desktop' | 'tablet' | 'mobile';
+export interface PropertyInheritanceStatus {
+    isOverridden: boolean;
+    isInherited: boolean;
+    isBase: boolean;
+    inheritedValue?: unknown;
+    activeValue?: unknown;
+}
+/**
+ * Evaluates whether a property in the active viewport/breakpoint is:
+ * - isOverridden: explicitly defined in the active non-base viewport layer.
+ * - isInherited: not defined in the active viewport, but defined in base.
+ * - isBase: active breakpoint is 'base' or 'desktop' (the canonical base style layer).
+ */
+export declare function getPropertyInheritanceStatus(property: string, activeBreakpoint: Breakpoint, activeStyles?: Record<string, unknown>, baseStyles?: Record<string, unknown>): PropertyInheritanceStatus;
+/**
+ * Returns a list of all style properties explicitly overridden in the active viewport.
+ */
+export declare function getOverriddenProperties(activeBreakpoint: Breakpoint, activeStyles?: Record<string, unknown>, _baseStyles?: Record<string, unknown>): string[];
+export interface InheritanceIndicatorProps {
+    property: string;
+    activeBreakpoint: Breakpoint;
+    activeStyles?: Record<string, unknown>;
+    baseStyles?: Record<string, unknown>;
+    onResetToInherited?: (property: string) => void;
+    label?: string;
+    showWatermark?: boolean;
+    compact?: boolean;
+    className?: string;
+}
+/**
+ * Visual Style Inheritance Indicator (STORA-140 & STORA-141)
+ *
+ * Renders:
+ * - Bold blue/orange dot indicator + "Overridden" badge + "Reset to Inherited" button when overridden.
+ * - Subtle watermark & neutral text indicator when inherited from base.
+ * - Nothing or neutral base label when inspecting canonical base styles.
+ */
+export declare const InheritanceIndicator: React.FC<InheritanceIndicatorProps>;
+export interface InheritanceSummaryBarProps {
+    activeBreakpoint: Breakpoint;
+    activeStyles?: Record<string, unknown>;
+    baseStyles?: Record<string, unknown>;
+    onResetAllOverrides?: () => void;
+    className?: string;
+}
+/**
+ * Top summary banner for the Inspector when viewing responsive overrides (STORA-140 & STORA-141).
+ */
+export declare const InheritanceSummaryBar: React.FC<InheritanceSummaryBarProps>;
+//# sourceMappingURL=inheritance-indicator.d.ts.map

package/dist/components/style-manager/inheritance-indicator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inheritance-indicator.d.ts","sourceRoot":"","sources":["../../../src/components/style-manager/inheritance-indicator.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAElE,MAAM,WAAW,yBAAyB;IACxC,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,UAAU,EAC5B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,yBAAyB,CA6C3B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,gBAAgB,EAAE,UAAU,EAC5B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC,MAAM,EAAE,CAQV;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,UAAU,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,kBAAkB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,yBAAyB,CAqFpE,CAAC;AAEF,MAAM,WAAW,0BAA0B;IACzC,gBAAgB,EAAE,UAAU,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,mBAAmB,CAAC,EAAE,MAAM,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,KAAK,CAAC,EAAE,CAAC,0BAA0B,CAmDtE,CAAC"}

package/dist/components/style-manager/style-manager-accordion.d.ts

@@ -33,6 +33,16 @@ export interface StyleManagerAccordionProps {
     initialState?: Partial<Record<StyleSectorId, boolean>>;
     /** Optional filter for allowed style sectors. If omitted, all sectors are displayed. */
     allowedSectors?: StyleSectorId[];
+    /** Type of the node currently inspected (e.g. 'flex', 'grid', 'container') */
+    nodeType?: string;
+    /** Whether the parent of the currently selected node is a grid container */
+    isParentGrid?: boolean;
+    /** Base styles layer for evaluating inheritance indicators (STORA-140) */
+    baseStyles?: Record<string, unknown>;
+    /** Reset callback for a single style property override (STORA-141) */
+    onResetProperty?: (property: string) => void;
+    /** Reset callback for all overrides in active viewport */
+    onResetAllOverrides?: () => void;
 }
 export declare const StyleManagerAccordion: React.FC<StyleManagerAccordionProps>;
 //# sourceMappingURL=style-manager-accordion.d.ts.map

package/dist/components/style-manager/style-manager-accordion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"style-manager-accordion.d.ts","sourceRoot":"","sources":["../../../src/components/style-manager/style-manager-accordion.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA2C,MAAM,OAAO,CAAC;AAChE,OAAO,EAAE,eAAe,EAA4B,MAAM,iBAAiB,CAAC;AAO5E,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,SAAS,GAAG,YAAY,GAAG,aAAa,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEvG,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,aAAa,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,eAAO,MAAM,aAAa,EAAE,qBAAqB,EAwDhD,CAAC;AAEF,eAAO,MAAM,qBAAqB,oCAAoC,CAAC;AAEvE,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,aAAa,EAAE,OAAO,CAOlE,CAAC;AAIF,wBAAgB,UAAU,IAAI;IAC5B,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IACxC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC,CAoBA;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,CAanE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,GAAG,IAAI,CAO9E;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACrC,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACzD,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,eAAe,CAAC,KAAK,IAAI,CAAC;IAClE,aAAa,CAAC,EAAE,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAChD,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IACvC,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC;IACvD,wFAAwF;IACxF,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;CAClC;AAED,eAAO,MAAM,qBAAqB,EAAE,KAAK,CAAC,EAAE,CAAC,0BAA0B,CAqctE,CAAC"}
+{"version":3,"file":"style-manager-accordion.d.ts","sourceRoot":"","sources":["../../../src/components/style-manager/style-manager-accordion.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA2C,MAAM,OAAO,CAAC;AAChE,OAAO,EAAE,eAAe,EAA4B,MAAM,iBAAiB,CAAC;AAa5E,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,SAAS,GAAG,YAAY,GAAG,aAAa,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEvG,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,aAAa,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,eAAO,MAAM,aAAa,EAAE,qBAAqB,EAiFhD,CAAC;AAEF,eAAO,MAAM,qBAAqB,oCAAoC,CAAC;AAEvE,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,aAAa,EAAE,OAAO,CAOlE,CAAC;AAIF,wBAAgB,UAAU,IAAI;IAC5B,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IACxC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC,CAoBA;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,CAanE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,GAAG,IAAI,CAO9E;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACrC,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACzD,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,eAAe,CAAC,KAAK,IAAI,CAAC;IAClE,aAAa,CAAC,EAAE,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAChD,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IACvC,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC;IACvD,wFAAwF;IACxF,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;IACjC,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,sEAAsE;IACtE,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,0DAA0D;IAC1D,mBAAmB,CAAC,EAAE,MAAM,IAAI,CAAC;CAClC;AAED,eAAO,MAAM,qBAAqB,EAAE,KAAK,CAAC,EAAE,CAAC,0BAA0B,CAietE,CAAC"}

package/dist/components/style-manager/typography-sector-controls.d.ts

@@ -1,4 +1,5 @@
 import React from 'react';
+import { Breakpoint } from './inheritance-indicator';
 export interface FontOption {
     label: string;
     value: string;
@@ -12,6 +13,9 @@ export interface TypographySectorControlsProps {
     onChange: (property: string, value: string) => void;
     disabled?: boolean;
     className?: string;
+    baseStyles?: Record<string, unknown>;
+    breakpoint?: Breakpoint;
+    onResetProperty?: (property: string) => void;
 }
 export declare const TypographySectorControls: React.FC<TypographySectorControlsProps>;
 //# sourceMappingURL=typography-sector-controls.d.ts.map

package/dist/components/style-manager/typography-sector-controls.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typography-sector-controls.d.ts","sourceRoot":"","sources":["../../../src/components/style-manager/typography-sector-controls.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAC;AAInD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,YAAY,EAAE,UAAU,EAmEpC,CAAC;AAEF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAWrD;AAED,MAAM,WAAW,6BAA6B;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,wBAAwB,EAAE,KAAK,CAAC,EAAE,CAAC,6BAA6B,CAgT5E,CAAC"}
+{"version":3,"file":"typography-sector-controls.d.ts","sourceRoot":"","sources":["../../../src/components/style-manager/typography-sector-controls.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAC;AAEnD,OAAO,EAAwB,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAG3E,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,YAAY,EAAE,UAAU,EAwEpC,CAAC;AAEF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAWrD;AAED,MAAM,WAAW,6BAA6B;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAED,eAAO,MAAM,wBAAwB,EAAE,KAAK,CAAC,EAAE,CAAC,6BAA6B,CAmW5E,CAAC"}

package/dist/components/ui/icons.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../../src/components/ui/icons.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAiUtD,CAAC"}
+{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../../src/components/ui/icons.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAkVtD,CAAC"}

package/dist/config/ai-config.d.ts

@@ -0,0 +1,69 @@
+import type { AiProviderAdapter } from '@kubuild/ai';
+/**
+ * AI provider configuration for `KubuildEditorProps.ai` (STORA-501).
+ *
+ * Consistent with the `registry` / `context` / `config` opt-in pattern already used by
+ * `KubuildEditorProps`: AI is always opt-in — without this prop, `KubuildEditor` renders
+ * with zero AI UI and zero behavioral difference from today. The host (consumer) always
+ * supplies the provider/API key; the editor never hardcodes or defaults to any provider.
+ */
+export interface AiEditorConfig {
+    /** Adapter provider AI, or an HTTP endpoint pointing at the host's own `createAiHandler`. */
+    provider: AiProviderAdapter | {
+        endpoint: string;
+        headers?: Record<string, string>;
+    };
+    /** Per-capability feature flags. All default to `false` when `ai` config is not provided. */
+    features?: {
+        chat?: boolean;
+        generate?: boolean;
+        enhance?: boolean;
+    };
+    /** Default panel mode when the editor first mounts. Default: `'hidden'`. */
+    defaultPanelMode?: 'docked' | 'floating' | 'hidden';
+    /** Extra host-specific system prompt prefix (branding, tone, etc). */
+    systemPromptPrefix?: string;
+}
+export interface ResolvedAiEditorConfig {
+    enabled: boolean;
+    provider: AiProviderAdapter | {
+        endpoint: string;
+        headers?: Record<string, string>;
+    } | null;
+    features: {
+        chat: boolean;
+        generate: boolean;
+        enhance: boolean;
+    };
+    defaultPanelMode: 'docked' | 'floating' | 'hidden';
+    systemPromptPrefix?: string;
+}
+/**
+ * Resolves an optional `AiEditorConfig` into a fully-populated `ResolvedAiEditorConfig`.
+ *
+ * Without a config given, every feature resolves to disabled/false and `provider` is `null` —
+ * `KubuildEditor` must render with zero AI UI, exactly as it does today.
+ */
+export declare function resolveAiEditorConfig(config?: AiEditorConfig): ResolvedAiEditorConfig;
+/**
+ * Whether any AI capability is actually turned on (STORA-504's "atau fitur AI nonaktif di
+ * AiEditorConfig" check). `resolved.enabled` alone only means an `ai` config object was
+ * given — a host can supply `provider` with every `features.*` flag left `false`/omitted,
+ * which must still be treated as "AI disabled" for UI gating (toolbar toggle, chat panel).
+ */
+export declare function isAnyAiFeatureEnabled(resolved: ResolvedAiEditorConfig): boolean;
+/**
+ * Pure gating logic (STORA-503) for whether `KubuildEditor` should mount the AI Chat Panel
+ * in a given layout slot (`'docked'` or `'floating'`). Factored out of the JSX conditional
+ * in `editor.tsx` so it has a single, directly-unit-testable source of truth — the panel
+ * mode itself lives in Zustand store state, which `react-dom/server`'s SSR snapshot
+ * (`getServerSnapshot` → `store.getInitialState()`) can't reflect post-mutation in tests,
+ * so this function is exercised with plain boolean/string inputs instead.
+ */
+export declare function shouldRenderAiChatPanel(aiFeatureEnabled: boolean, aiChatMode: 'docked' | 'floating' | 'hidden', targetMode: 'docked' | 'floating'): boolean;
+/**
+ * Whether the AI Chat toolbar toggle (STORA-504) should render in its "active/highlighted"
+ * visual state — i.e. the panel is open in some form (docked or floating), not hidden.
+ */
+export declare function isAiChatPanelActive(aiChatMode: 'docked' | 'floating' | 'hidden'): boolean;
+//# sourceMappingURL=ai-config.d.ts.map

package/dist/config/ai-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-config.d.ts","sourceRoot":"","sources":["../../src/config/ai-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,6FAA6F;IAC7F,QAAQ,EAAE,iBAAiB,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;IACrF,6FAA6F;IAC7F,QAAQ,CAAC,EAAE;QACT,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;IACF,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;IACpD,sEAAsE;IACtE,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,iBAAiB,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IAC5F,QAAQ,EAAE;QACR,IAAI,EAAE,OAAO,CAAC;QACd,QAAQ,EAAE,OAAO,CAAC;QAClB,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC;IACF,gBAAgB,EAAE,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;IACnD,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,sBAAsB,CA4BrF;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,OAAO,CAK/E;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,gBAAgB,EAAE,OAAO,EACzB,UAAU,EAAE,QAAQ,GAAG,UAAU,GAAG,QAAQ,EAC5C,UAAU,EAAE,QAAQ,GAAG,UAAU,GAChC,OAAO,CAET;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,CAEzF"}

package/dist/config/config.d.ts

@@ -1,11 +1,27 @@
 import React from 'react';
+import { ComponentCategory, CoreComponentType } from '@kubuild/components';
 import { StyleSectorId } from '../components/style-manager/style-manager-accordion';
 export type LeftSidebarTab = 'components' | 'blocks' | 'layers';
+export type { CoreComponentType, ComponentCategory };
+/**
+ * Built-in component types or custom component string identifier.
+ * Autocompletes standard component types in IDE IntelliSense while supporting custom registered components.
+ */
+export type ComponentTypeFilter = CoreComponentType | (string & {});
+/**
+ * Built-in component categories or custom category string identifier.
+ * Autocompletes standard categories ('layout' | 'typography' | 'media' | 'form' | 'interactive' | 'data' | 'custom').
+ */
+export type ComponentCategoryFilter = ComponentCategory | (string & {});
 export interface EditorToolbarConfig {
     /** Display page title & status badge in toolbar. Default: true */
     showTitle?: boolean;
-    /** Display Navigator (element tree) toggle button. Default: true */
-    showNavigatorToggle?: boolean;
+    /**
+     * Display the AI Chat toggle button (STORA-504). Default: true.
+     * The button is still hidden when AI is disabled entirely in `AiEditorConfig`
+     * (no `ai` prop given, or every `features.*` flag is false) regardless of this flag.
+     */
+    showAiChatToggle?: boolean;
     /** Display Undo and Redo buttons. Default: true */
     showHistory?: boolean;
     /** Display Copy, Paste, Duplicate, and Delete buttons. Default: true */
@@ -32,6 +48,48 @@ export interface EditorSidebarConfig {
     defaultTab?: LeftSidebarTab;
     /** List of tabs available for user navigation. Default: ['components', 'blocks', 'layers'] */
     availableTabs?: LeftSidebarTab[];
+    /**
+     * Whitelist of component types to display in the Components panel.
+     * If specified, only components matching these types will be shown.
+     *
+     * Built-in component types:
+     * `'page'` | `'section'` | `'container'` | `'columns'` | `'heading'` | `'text'` |
+     * `'paragraph'` | `'link'` | `'blockquote'` | `'badge'` | `'code-block'` | `'image'` |
+     * `'video'` | `'icon'` | `'html-embed'` | `'button'` | `'button-submit'` | `'form'` |
+     * `'input'` | `'textarea'` | `'select'` | `'checkbox'` | `'switch'` | `'radio-group'` |
+     * `'radio'` | `'radio-item'` | `'file-upload'` | `'collection'` | `'list'` | `'list-item'` |
+     * `'table'` | `'table-row'` | `'table-cell'`
+     */
+    allowedComponents?: ComponentTypeFilter[];
+    /**
+     * Blacklist of component types to hide from the Components panel.
+     * Components matching these types will not be displayed in the sidebar.
+     *
+     * Built-in component types:
+     * `'page'` | `'section'` | `'container'` | `'columns'` | `'heading'` | `'text'` |
+     * `'paragraph'` | `'link'` | `'blockquote'` | `'badge'` | `'code-block'` | `'image'` |
+     * `'video'` | `'icon'` | `'html-embed'` | `'button'` | `'button-submit'` | `'form'` |
+     * `'input'` | `'textarea'` | `'select'` | `'checkbox'` | `'switch'` | `'radio-group'` |
+     * `'radio'` | `'radio-item'` | `'file-upload'` | `'collection'` | `'list'` | `'list-item'` |
+     * `'table'` | `'table-row'` | `'table-cell'`
+     */
+    hiddenComponents?: ComponentTypeFilter[];
+    /**
+     * Whitelist of component categories to display in the Components panel.
+     * If specified, only categories in this list will be shown.
+     *
+     * Standard categories:
+     * `'layout'` | `'typography'` | `'media'` | `'form'` | `'interactive'` | `'data'` | `'custom'`
+     */
+    allowedCategories?: ComponentCategoryFilter[];
+    /**
+     * Blacklist of component categories to hide from the Components panel.
+     * Categories matching this list will not be displayed.
+     *
+     * Standard categories:
+     * `'layout'` | `'typography'` | `'media'` | `'form'` | `'interactive'` | `'data'` | `'custom'`
+     */
+    hiddenCategories?: ComponentCategoryFilter[];
 }
 export interface EditorCanvasConfig {
     /** Display hierarchy breadcrumbs bar below the canvas. Default: true */
@@ -70,7 +128,7 @@ export interface ResolvedEditorConfig {
     toolbar: {
         enabled: boolean;
         showTitle: boolean;
-        showNavigatorToggle: boolean;
+        showAiChatToggle: boolean;
         showHistory: boolean;
         showClipboard: boolean;
         showCodeViewer: boolean;
@@ -85,6 +143,10 @@ export interface ResolvedEditorConfig {
         enabled: boolean;
         defaultTab: LeftSidebarTab;
         availableTabs: LeftSidebarTab[];
+        allowedComponents?: ComponentTypeFilter[];
+        hiddenComponents?: ComponentTypeFilter[];
+        allowedCategories?: ComponentCategoryFilter[];
+        hiddenCategories?: ComponentCategoryFilter[];
     };
     canvas: {
         showBreadcrumbs: boolean;

package/dist/config/config.d.ts.map

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

package/dist/config/index.d.ts

@@ -1,2 +1,3 @@
 export * from './config';
+export * from './ai-config';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC"}