@morphika/andami 0.4.1 → 0.5.0

package/lib/builder/types.ts

@@ -182,231 +182,83 @@ export const DEFAULT_GRID_SETTINGS: GridSettings = {
   gutter_phone: "16",
 };
 
-export interface BuilderState {
-  // Page metadata
-  pageId: string | null;
-  pageTitle: string;
-  pageSlug: string;
-  /** The slug as loaded from Sanity — used for API calls even if slug is edited. */
-  _originalSlug: string;
-  pageType: PageType;
-  metadata: PageMetadata;
-  publishedAt: string | null;
-  draftMode: boolean;
-
-  // Content — V2 sections, custom sections, parallax groups
-  rows: ContentItem[];
-
-  // Selection
-  selectedRowKey: string | null;
-  selectedColumnKey: string | null;
-  selectedBlockKey: string | null;
-  /** Sub-selection: which project card is selected within a ProjectGrid block */
-  selectedProjectCardKey: string | null;
-
-  // UI state
-  isDirty: boolean;
-  isSaving: boolean;
-  saveError: string | null;
-  lastSavedAt: string | null;
-
-  // Editor mode
-  previewMode: boolean;
-
-  // Custom section editor mode (Session 107)
-  editorMode: "page" | "customSection";
-  customSectionSlug: string | null;
-  customSectionTitle: string | null;
-  /** Stashed page state while editing a custom section */
-  savedPageState: { rows: ContentItem[]; selectedKey: string | null } | null;
-
-  // Page-level settings
-  pageSettings: PageSettings;
-
-  // Grid settings (from Customize, ephemeral — NOT saved per page)
-  gridSettings: GridSettings;
-
-  // Canvas state (ephemeral — NOT saved to Sanity)
-  canvasZoom: number;
-  canvasPanX: number;
-  canvasPanY: number;
-  canvasTool: CanvasTool;
-  activeViewport: DeviceViewport;
-
-  // BUG-014 fix: Track whether the Sanity document had page_settings.
-  // When true, applyGlobalStyles() won't overwrite user-chosen colors.
-  _hasDocumentPageSettings: boolean;
-
-  // History (Undo/Redo) — BUG-010 fix: snapshots include pageSettings
-  _history: import("./history").HistorySnapshot[];
-  _future: import("./history").HistorySnapshot[];
-
-  /** Cache of fetched custom section base settings, keyed by custom_section_id.
-   *  Populated by CustomSectionInstanceCard/ReadOnlyCustomSection on fetch.
-   *  Used by SortableRow to merge base settings with per-instance overrides. */
-  _customSectionCache: Record<string, import("../../lib/sanity/types").SectionV2Settings>;
-
-  /** Counter incremented after a custom section is saved via the section editor.
-   *  Used as a useEffect dependency in CustomSectionInstanceCard to trigger refetch. */
-  _customSectionRefetchTick: number;
-
-  /** Live preview overlay from color picker — shown on canvas without persisting to Sanity.
-   *  Set while user is dragging in the color picker; cleared on close. */
-  colorPickerPreview: {
-    blockKey?: string;
-    sectionKey?: string;
-    field: string;
-    value: ColorField;
-  } | null;
-}
+// ============================================
+// BuilderState & BuilderActions — composed from slices
+// ============================================
+// Session 183 (Fase 1 / Nivel A): state and actions are declared as
+// intersections of per-slice types defined in `./types-slices.ts`.
+// The runtime shape is still a flat object — no `state.blocks.rows`
+// indirection. This split is purely a type-level organization that:
+//   1. Documents which slice owns which state field / action
+//   2. Provides a clear template for adding a new slice
+//   3. Prepares for Fase 2 (actual shape split) without forcing it now
+// ============================================
 
-export interface BuilderActions {
-  // Page metadata
-  setPageTitle: (title: string) => void;
-  setPageSlug: (slug: string) => void;
-  setMetadata: (metadata: Partial<PageMetadata>) => void;
-  setDraftMode: (draft: boolean) => void;
-  publishPage: () => void;
-  unpublishPage: () => void;
-
-  // Section operations
-  /** Add a Project Grid section as a V2 section with a full-width column (Session 164) */
-  addSection: (blockType: "projectGridBlock" | "projectCarouselBlock", afterRowKey?: string | null) => void;
-  reorderRows: (fromIndex: number, toIndex: number) => void;
-  /** Delete a section by key */
-  deleteSection: (sectionKey: string) => void;
-  /** Duplicate a section, inserting copy after the original */
-  duplicateSection: (sectionKey: string) => void;
-
-  // Block operations
-  updateBlock: (blockKey: string, updates: Partial<ContentBlock>) => void;
-  deleteBlock: (blockKey: string) => void;
-  /** Duplicate a content block (inserts copy immediately after the original) */
-  duplicateBlock: (blockKey: string) => void;
-  moveBlock: (blockKey: string, targetSectionKey: string, targetColumnKey: string, toIndex: number) => void;
-  reorderBlocks: (sectionKey: string, columnKey: string, fromIndex: number, toIndex: number) => void;
-
-  // Selection
-  selectRow: (key: string | null) => void;
-  selectColumn: (rowKey: string | null, colKey: string | null) => void;
-  selectBlock: (key: string | null) => void;
-  /** Select a specific project card within a ProjectGrid block */
-  selectProjectCard: (key: string | null) => void;
-  clearSelection: () => void;
-
-  // Persistence
-  loadFromDocument: (doc: Page) => void;
-  save: () => Promise<void>;
-  reset: () => void;
-
-  // Dirty tracking
-  markDirty: () => void;
-  markClean: () => void;
-
-  // History (Undo/Redo)
-  undo: () => void;
-  redo: () => void;
-  canUndo: () => boolean;
-  canRedo: () => boolean;
-  /** Push a snapshot before a mutation (called internally). */
-  _pushSnapshot: () => void;
-
-  // ---- V2 Section operations ----
-  /** Add a new V2 grid section with a preset layout */
-  addSectionV2: (preset: import("../../lib/sanity/types").SectionV2Preset, afterRowKey?: string | null) => void;
-  /** Add a column to a V2 section at a specific position */
-  addColumnV2: (sectionKey: string, gridRow: number, gridColumn: number, span: number) => void;
-  /** Delete a column from a V2 section */
-  deleteColumnV2: (sectionKey: string, columnKey: string) => void;
-  /** Resize a column in a V2 section (right edge) */
-  resizeColumnV2: (sectionKey: string, columnKey: string, newSpan: number) => void;
-  /** Resize a column in a V2 section from the left edge */
-  resizeColumnV2Left: (sectionKey: string, columnKey: string, newGridColumn: number) => void;
-  /** Move a column in a V2 section (drag & drop) */
-  moveColumnV2: (sectionKey: string, columnKey: string, targetRow: number, targetColumn: number) => void;
-  /** Swap two columns in a V2 section (exchange positions, blocks stay) */
-  swapColumnV2: (sectionKey: string, draggedKey: string, targetKey: string) => void;
-  /** Move a column to an empty gap, adopting the gap's span */
-  moveColumnToGapV2: (sectionKey: string, columnKey: string, targetRow: number, targetColumn: number, targetSpan: number) => void;
-  /** Apply a layout preset to a V2 section (replaces columns + updates preset atomically) */
-  applyPresetV2: (sectionKey: string, preset: SectionV2Preset) => void;
-  /** Update settings for a V2 section */
-  updateSectionV2Settings: (sectionKey: string, settings: Partial<SectionV2Settings>) => void;
-  /** Update responsive overrides for a V2 section */
-  updateSectionV2Responsive: (sectionKey: string, responsive: PageSectionV2["responsive"]) => void;
-  /** Add a block to a V2 section column, optionally at a specific index */
-  addBlockV2: (sectionKey: string, columnKey: string, blockType: BlockType, insertIndex?: number) => void;
-  /** Select a V2 column */
-  selectColumnV2: (sectionKey: string | null, columnKey: string | null) => void;
-  /** Update enter animation for a V2 column (Session 117) */
-  updateColumnEnterAnimation: (sectionKey: string, colKey: string, config: import("../../lib/animation/enter-types").EnterAnimationConfig | undefined) => void;
-
-  // Debounced update (no snapshot per keystroke)
-  updateBlockDebounced: (blockKey: string, updates: Partial<ContentBlock>) => void;
-
-  // Editor mode
-  togglePreviewMode: () => void;
-  setPreviewMode: (preview: boolean) => void;
-
-  // Custom section editor mode (Session 107)
-  /** Enter section editor mode — stashes current page rows, replaces with a single V2 section */
-  enterSectionEditor: (slug: string | null, title: string | null, sectionData: PageSectionV2 | null) => void;
-  /** Exit section editor mode — restores page rows from stash. Pass wasSaved=true to mark page dirty. */
-  exitSectionEditor: (wasSaved?: boolean) => void;
-  /** Save the custom section being edited, then exit editor mode.
-   *  Returns { id, slug, title } on success (for instance insertion after creation). */
-  saveSectionEditor: (title: string) => Promise<{ id: string; slug: string; title: string } | null>;
-  /** Insert a custom section instance reference into the page rows */
-  addCustomSectionInstance: (id: string, slug: string, title: string, afterRowKey?: string | null) => void;
-  /** Detach a custom section instance — replaces it with a copy of the section data (inline V2 section) */
-  detachCustomSectionInstance: (instanceKey: string, sectionData: PageSectionV2) => void;
-  /** Update the cached title on a custom section instance (cosmetic sync, Session 110) */
-  updateCustomSectionInstanceTitle: (instanceKey: string, newTitle: string) => void;
-  /** Update per-instance section settings overrides (Session 130) */
-  updateCustomSectionInstanceSettings: (instanceKey: string, updates: Partial<SectionV2Settings>) => void;
-  /** Cache base settings from a fetched custom section (for SortableRow merge) */
-  cacheCustomSectionSettings: (sectionId: string, settings: SectionV2Settings) => void;
-
-  // ---- Parallax Group operations (Session 123) ----
-  /** Add a new ParallaxGroup with 1 empty slide */
-  addParallaxGroup: (afterRowKey?: string | null) => void;
-  /** Add a new empty slide to a parallax group */
-  addParallaxSlide: (groupKey: string) => void;
-  /** Remove a slide from a parallax group (minimum 1 enforced) */
-  removeParallaxSlide: (groupKey: string, slideKey: string) => void;
-  /** Reorder a slide up or down within its group */
-  moveParallaxSlide: (groupKey: string, slideKey: string, direction: "up" | "down") => void;
-  /** Update background fields on a parallax slide */
-  updateParallaxSlideBackground: (groupKey: string, slideKey: string, fields: Partial<import("../../lib/sanity/types").ParallaxSlideV2>) => void;
-  /** Update group-level settings (transition effect, snap, etc.) */
-  updateParallaxGroupSettings: (groupKey: string, fields: Partial<Pick<import("../../lib/sanity/types").ParallaxGroup, "transition_effect" | "snap_enabled" | "parallax_intensity">>) => void;
-
-  // ---- Cover Section operations (Session 176) ----
-  addCoverSection: (afterRowKey?: string | null) => void;
-  addCoverRow: (sectionKey: string) => void;
-  removeCoverRow: (sectionKey: string, rowKey: string) => void;
-  resizeCoverRow: (sectionKey: string, handleIndex: number, deltaPercent: number, startAbove: number, startBelow: number) => void;
-  updateCoverRowAlign: (sectionKey: string, rowKey: string, align: CoverRow["vertical_align"]) => void;
-  updateCoverBackground: (sectionKey: string, fields: Partial<Pick<CoverSection, "background_type" | "background_color" | "background_image" | "background_video" | "background_position" | "background_size" | "background_overlay_color" | "background_overlay_opacity" | "nav_color">>) => void;
-  updateCoverSettings: (sectionKey: string, settings: Partial<CoverSectionSettings>) => void;
-  updateCoverHeight: (sectionKey: string, height: CoverSection["height"]) => void;
-
-  // Page-level settings
-  updatePageSettings: (settings: Partial<PageSettings>) => void;
-  applyGlobalStyles: () => Promise<void>;
-
-  // Canvas
-  setCanvasZoom: (zoom: number) => void;
-  setCanvasPan: (x: number, y: number) => void;
-  setCanvasTool: (tool: CanvasTool) => void;
-  setActiveViewport: (viewport: DeviceViewport) => void;
-  zoomToFit: (viewportWidth: number, viewportHeight: number) => void;
-  zoomToPoint: (newZoom: number, cursorX: number, cursorY: number) => void;
-  zoomToFrame: (device: DeviceViewport, viewportWidth: number, viewportHeight: number) => void;
-
-  // Color picker live preview (Phase 4)
-  setColorPickerPreview: (preview: BuilderState["colorPickerPreview"]) => void;
-  clearColorPickerPreview: () => void;
-}
+import type {
+  MetaSlice,
+  MetaSliceState,
+  MetaSliceActions,
+  SectionSlice,
+  SectionSliceState,
+  SectionSliceActions,
+  BlockSlice,
+  BlockSliceActions,
+  CanvasSlice,
+  CanvasSliceState,
+  CanvasSliceActions,
+  CoverSlice,
+  CoverSliceActions,
+  SelectionSlice,
+  SelectionSliceState,
+  SelectionSliceActions,
+  HistorySlice,
+  HistorySliceState,
+  HistorySliceActions,
+} from "./types-slices";
+
+export type {
+  MetaSlice,
+  MetaSliceState,
+  MetaSliceActions,
+  SectionSlice,
+  SectionSliceState,
+  SectionSliceActions,
+  BlockSlice,
+  BlockSliceActions,
+  CanvasSlice,
+  CanvasSliceState,
+  CanvasSliceActions,
+  CoverSlice,
+  CoverSliceActions,
+  SelectionSlice,
+  SelectionSliceState,
+  SelectionSliceActions,
+  HistorySlice,
+  HistorySliceState,
+  HistorySliceActions,
+};
+
+/**
+ * Flat state object composed of all slice states.
+ * Runtime shape is unchanged from pre-Session 183 — a single level
+ * of properties. See `./types-slices.ts` for slice boundaries.
+ */
+export type BuilderState = MetaSliceState &
+  SectionSliceState &
+  CanvasSliceState &
+  SelectionSliceState &
+  HistorySliceState;
+
+/**
+ * All store actions, composed from per-slice action types.
+ * Runtime shape is unchanged. See `./types-slices.ts` for slice owners.
+ */
+export type BuilderActions = MetaSliceActions &
+  SectionSliceActions &
+  BlockSliceActions &
+  CanvasSliceActions &
+  CoverSliceActions &
+  SelectionSliceActions &
+  HistorySliceActions;
 
 export type BuilderStore = BuilderState & BuilderActions;

package/lib/sanity/types.ts

@@ -596,6 +596,23 @@ export function isCoverSection(item: ContentItem): item is CoverSection {
   return (item as CoverSection)._type === "coverSection";
 }
 
+/**
+ * Type guard: check if a content item supports column drag-and-drop as a
+ * source or target — i.e. it has a top-level `columns` array with the same
+ * V2 grid semantics. Used by cross-section column DnD (Session 183).
+ *
+ * Eligible:  PageSectionV2, CoverSection
+ * NOT eligible:
+ *   - ParallaxGroup (columns live per-slide, cross-slide DnD not supported)
+ *   - CustomSectionInstance (references an external document, mutating it
+ *     from the page would break the reference contract)
+ */
+export function isColumnarSection(
+  item: ContentItem,
+): item is PageSectionV2 | CoverSection {
+  return isPageSectionV2(item) || isCoverSection(item);
+}
+
 // ============================================
 // Shared references
 // ============================================

package/lib/version.ts

@@ -6,4 +6,4 @@
  * Exposed as a plain constant so it can be imported without reading
  * package.json at runtime.
  */
-export const ANDAMI_VERSION = "0.4.1";
+export const ANDAMI_VERSION = "0.5.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@morphika/andami",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "Visual Page Builder — core library. A reusable website builder with visual editing, CMS integration, and asset management.",
   "type": "module",
   "license": "MIT",