@synap-core/types 0.3.1 → 0.3.3

package/dist/{chunk-OPLFDITK.js → chunk-RIUK6OEK.js}

@@ -42,6 +42,46 @@ var ENTITY_SCHEMAS = {
     extension: z.string(),
     thumbnailUrl: z.string().url().optional(),
     downloadUrl: z.string().url().optional()
+  }),
+  // NEW: Company/Organization entity
+  company: z.object({
+    website: z.string().url().optional(),
+    industry: z.string().optional(),
+    size: z.enum(["startup", "small", "medium", "large", "enterprise"]).optional(),
+    location: z.string().optional(),
+    linkedInUrl: z.string().url().optional(),
+    description: z.string().optional(),
+    foundedYear: z.number().int().optional(),
+    // Linked employee person entities
+    employees: z.array(z.string().uuid()).default([])
+  }),
+  // NEW: Bookmark/Web clip entity
+  bookmark: z.object({
+    url: z.string().url(),
+    favicon: z.string().url().optional(),
+    excerpt: z.string().optional(),
+    siteName: z.string().optional(),
+    author: z.string().optional(),
+    publishedDate: z.string().datetime().optional(),
+    tags: z.array(z.string()).default([]),
+    // For local archiving
+    archiveUrl: z.string().url().optional(),
+    isRead: z.boolean().default(false)
+  }),
+  // NEW: Code snippet entity
+  code: z.object({
+    language: z.string(),
+    // 'typescript', 'python', 'rust', etc.
+    runtime: z.string().optional(),
+    // 'node', 'browser', 'python3', etc.
+    framework: z.string().optional(),
+    // 'react', 'express', 'django', etc.
+    dependencies: z.array(z.string()).default([]),
+    isExecutable: z.boolean().default(false),
+    sourceUrl: z.string().url().optional(),
+    // GitHub gist, CodeSandbox, etc.
+    version: z.string().optional()
+    // Code version/revision
   })
 };
 function validateEntityMetadata(type, metadata) {

package/dist/entities/index.d.ts

@@ -129,6 +129,90 @@ declare const ENTITY_SCHEMAS: {
         thumbnailUrl?: string | undefined;
         downloadUrl?: string | undefined;
     }>;
+    readonly company: z.ZodObject<{
+        website: z.ZodOptional<z.ZodString>;
+        industry: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodEnum<["startup", "small", "medium", "large", "enterprise"]>>;
+        location: z.ZodOptional<z.ZodString>;
+        linkedInUrl: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        foundedYear: z.ZodOptional<z.ZodNumber>;
+        employees: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        employees: string[];
+        linkedInUrl?: string | undefined;
+        location?: string | undefined;
+        website?: string | undefined;
+        industry?: string | undefined;
+        size?: "medium" | "startup" | "small" | "large" | "enterprise" | undefined;
+        description?: string | undefined;
+        foundedYear?: number | undefined;
+    }, {
+        linkedInUrl?: string | undefined;
+        location?: string | undefined;
+        website?: string | undefined;
+        industry?: string | undefined;
+        size?: "medium" | "startup" | "small" | "large" | "enterprise" | undefined;
+        description?: string | undefined;
+        foundedYear?: number | undefined;
+        employees?: string[] | undefined;
+    }>;
+    readonly bookmark: z.ZodObject<{
+        url: z.ZodString;
+        favicon: z.ZodOptional<z.ZodString>;
+        excerpt: z.ZodOptional<z.ZodString>;
+        siteName: z.ZodOptional<z.ZodString>;
+        author: z.ZodOptional<z.ZodString>;
+        publishedDate: z.ZodOptional<z.ZodString>;
+        tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        archiveUrl: z.ZodOptional<z.ZodString>;
+        isRead: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        tags: string[];
+        url: string;
+        isRead: boolean;
+        favicon?: string | undefined;
+        excerpt?: string | undefined;
+        siteName?: string | undefined;
+        author?: string | undefined;
+        publishedDate?: string | undefined;
+        archiveUrl?: string | undefined;
+    }, {
+        url: string;
+        tags?: string[] | undefined;
+        favicon?: string | undefined;
+        excerpt?: string | undefined;
+        siteName?: string | undefined;
+        author?: string | undefined;
+        publishedDate?: string | undefined;
+        archiveUrl?: string | undefined;
+        isRead?: boolean | undefined;
+    }>;
+    readonly code: z.ZodObject<{
+        language: z.ZodString;
+        runtime: z.ZodOptional<z.ZodString>;
+        framework: z.ZodOptional<z.ZodString>;
+        dependencies: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        isExecutable: z.ZodDefault<z.ZodBoolean>;
+        sourceUrl: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        language: string;
+        dependencies: string[];
+        isExecutable: boolean;
+        runtime?: string | undefined;
+        framework?: string | undefined;
+        sourceUrl?: string | undefined;
+        version?: string | undefined;
+    }, {
+        language: string;
+        runtime?: string | undefined;
+        framework?: string | undefined;
+        dependencies?: string[] | undefined;
+        isExecutable?: boolean | undefined;
+        sourceUrl?: string | undefined;
+        version?: string | undefined;
+    }>;
 };
 /**
  * Entity type enum - auto-generated from schema keys
@@ -220,6 +304,60 @@ declare function safeValidateEntityMetadata<T extends EntityType>(type: T, metad
     extension: string;
     thumbnailUrl?: string | undefined;
     downloadUrl?: string | undefined;
+}> | z.SafeParseReturnType<{
+    linkedInUrl?: string | undefined;
+    location?: string | undefined;
+    website?: string | undefined;
+    industry?: string | undefined;
+    size?: "medium" | "startup" | "small" | "large" | "enterprise" | undefined;
+    description?: string | undefined;
+    foundedYear?: number | undefined;
+    employees?: string[] | undefined;
+}, {
+    employees: string[];
+    linkedInUrl?: string | undefined;
+    location?: string | undefined;
+    website?: string | undefined;
+    industry?: string | undefined;
+    size?: "medium" | "startup" | "small" | "large" | "enterprise" | undefined;
+    description?: string | undefined;
+    foundedYear?: number | undefined;
+}> | z.SafeParseReturnType<{
+    url: string;
+    tags?: string[] | undefined;
+    favicon?: string | undefined;
+    excerpt?: string | undefined;
+    siteName?: string | undefined;
+    author?: string | undefined;
+    publishedDate?: string | undefined;
+    archiveUrl?: string | undefined;
+    isRead?: boolean | undefined;
+}, {
+    tags: string[];
+    url: string;
+    isRead: boolean;
+    favicon?: string | undefined;
+    excerpt?: string | undefined;
+    siteName?: string | undefined;
+    author?: string | undefined;
+    publishedDate?: string | undefined;
+    archiveUrl?: string | undefined;
+}> | z.SafeParseReturnType<{
+    language: string;
+    runtime?: string | undefined;
+    framework?: string | undefined;
+    dependencies?: string[] | undefined;
+    isExecutable?: boolean | undefined;
+    sourceUrl?: string | undefined;
+    version?: string | undefined;
+}, {
+    language: string;
+    dependencies: string[];
+    isExecutable: boolean;
+    runtime?: string | undefined;
+    framework?: string | undefined;
+    sourceUrl?: string | undefined;
+    version?: string | undefined;
 }>;
 
 /**

package/dist/entities/index.js

@@ -8,7 +8,7 @@ import {
   isTask,
   safeValidateEntityMetadata,
   validateEntityMetadata
-} from "../chunk-OPLFDITK.js";
+} from "../chunk-RIUK6OEK.js";
 export {
   ENTITY_SCHEMAS,
   isEntityOfType,

package/dist/index.d.ts

@@ -1,11 +1,12 @@
 export { BaseEntity, ENTITY_SCHEMAS, Entity, EntityMetadata, EntityType, Event, File, NewEntity, Note, Person, Task, UpdateEntity, isEntityOfType, isEvent, isFile, isNote, isPerson, isTask, safeValidateEntityMetadata, validateEntityMetadata } from './entities/index.js';
 export { UpdateDocument } from './documents/index.js';
-export { Entity as DBEntity, InboxItem as DBInboxItem, Document, DocumentSession, DocumentVersion, EntityEnrichment, EntityRelationship, NewDocument, NewDocumentSession, NewDocumentVersion, NewEntity as NewEntityDB, NewEntityEnrichment, NewEntityRelationship, NewInboxItem, NewReasoningTrace, NewUserEntityState, NewUserPreference as NewUserPreferences, NewView, NewWorkspace, NewWorkspaceInvite, NewWorkspaceMember, ReasoningTrace, UserEntityState, UserPreference as UserPreferences, View, Workspace, WorkspaceInvite, WorkspaceMember } from '@synap/database/schema';
+export { Entity as DBEntity, InboxItem as DBInboxItem, Document, DocumentSession, DocumentVersion, EntityEnrichment, EntityRelationship, NewDocument, NewDocumentSession, NewDocumentVersion, NewEntity as NewEntityDB, NewEntityEnrichment, NewEntityRelationship, NewInboxItem, NewReasoningTrace, NewRelation, NewUserEntityState, NewUserPreference as NewUserPreferences, NewView, NewWorkspace, NewWorkspaceInvite, NewWorkspaceMember, ReasoningTrace, Relation, UserEntityState, UserPreference as UserPreferences, View, Workspace, WorkspaceInvite, WorkspaceMember } from '@synap/database/schema';
 export { CalendarInboxItem, EmailInboxItem, INBOX_SCHEMAS, InboxItem, InboxItemType, SlackInboxItem, isCalendarInboxItem, isEmailInboxItem, isSlackInboxItem } from './inbox/index.js';
 export { CreateWorkspaceInput, InviteMemberInput, UpdateWorkspaceInput, WorkspaceRole, WorkspaceType } from './workspaces/index.js';
-export { CreateViewInput, SaveViewInput, UpdateViewInput, ViewType } from './views/index.js';
+export { CalendarConfig, ColumnDefinition, CreateViewInput, FilterRule, GanttConfig, GridConfig, KanbanConfig, ListConfig, SaveViewInput, SortRule, SwitchViewLayoutInput, TableViewConfig, UpdateViewInput, ViewType } from './views/index.js';
+export { CreateRelationInput, RelationType, RelationWithEntities } from './relations/index.js';
 export { Theme, UpdatePreferencesInput } from './preferences/index.js';
-export { CollaborationEvent, CursorUpdate, PresenceInit, PresenceStatus, UserPresence } from './realtime/index.js';
+export { CollaborationEvent, CursorUpdate, PresenceInit, PresenceStatus, UserJoinedEvent, UserLeftEvent, UserPresence } from './realtime/index.js';
 export { AIProposalEvent, AIProposalStatusEvent, ChatMessageEvent, ChatStreamEvent, DocumentUpdatedEvent, DocumentVersionCreatedEvent, DomainClientToServerEvents, DomainEventName, DomainEventNames, DomainServerToClientEvents, EntityCreatedEvent, EntityDeletedEvent, EntityUpdatedEvent } from './events/index.js';
 export { Array as YArray, Doc as YDoc, Map as YMap, Text as YText } from 'yjs';
 import 'zod';

package/dist/index.js

@@ -1,9 +1,12 @@
-import "./chunk-ZTGPGYVX.js";
+import {
+  INBOX_SCHEMAS,
+  isCalendarInboxItem,
+  isEmailInboxItem,
+  isSlackInboxItem
+} from "./chunk-ZFFMXKF2.js";
+import "./chunk-2BEUWD3P.js";
 import "./chunk-IZA3UKBT.js";
 import "./chunk-7LKCNZXD.js";
-import {
-  DomainEventNames
-} from "./chunk-6OHYLFUB.js";
 import {
   ENTITY_SCHEMAS,
   isEntityOfType,
@@ -14,16 +17,14 @@ import {
   isTask,
   safeValidateEntityMetadata,
   validateEntityMetadata
-} from "./chunk-OPLFDITK.js";
+} from "./chunk-RIUK6OEK.js";
 import {
-  INBOX_SCHEMAS,
-  isCalendarInboxItem,
-  isEmailInboxItem,
-  isSlackInboxItem
-} from "./chunk-ZFFMXKF2.js";
-import "./chunk-2BEUWD3P.js";
-import "./chunk-X5L3VJJZ.js";
+  DomainEventNames
+} from "./chunk-6OHYLFUB.js";
+import "./chunk-QAWJ6GM3.js";
 import "./chunk-2N5ZC5EB.js";
+import "./chunk-X5L3VJJZ.js";
+import "./chunk-ZTGPGYVX.js";
 export {
   DomainEventNames,
   ENTITY_SCHEMAS,

package/dist/realtime/index.d.ts

@@ -53,5 +53,25 @@ interface CursorUpdate {
     y: number;
     viewId: string;
 }
+/**
+ * User joined event (emitted when user joins a workspace/document)
+ */
+interface UserJoinedEvent {
+    userId: string;
+    userName: string;
+    workspaceId: string;
+    documentId?: string;
+    color?: string;
+    timestamp: number;
+}
+/**
+ * User left event (emitted when user leaves a workspace/document)
+ */
+interface UserLeftEvent {
+    userId: string;
+    workspaceId: string;
+    documentId?: string;
+    timestamp: number;
+}
 
-export type { CollaborationEvent, CursorUpdate, PresenceInit, PresenceStatus, UserPresence };
+export type { CollaborationEvent, CursorUpdate, PresenceInit, PresenceStatus, UserJoinedEvent, UserLeftEvent, UserPresence };

package/dist/relations/index.d.ts

@@ -0,0 +1,36 @@
+export { NewRelation, Relation } from '@synap/database/schema';
+
+/**
+ * Relation Types
+ *
+ * Re-exports relation types from database schema (single source of truth).
+ *
+ * @see {@link file:///.../packages/database/src/schema/relations.ts}
+ */
+
+type RelationType = 'related_to' | 'parent_of' | 'child_of' | 'blocks' | 'mentioned_in' | 'linked_to';
+interface CreateRelationInput {
+    sourceEntityId: string;
+    targetEntityId: string;
+    type: RelationType;
+    metadata?: Record<string, unknown>;
+}
+interface RelationWithEntities {
+    id: string;
+    sourceEntityId: string;
+    targetEntityId: string;
+    type: RelationType;
+    createdAt: Date;
+    sourceEntity?: {
+        id: string;
+        title: string | null;
+        type: string;
+    };
+    targetEntity?: {
+        id: string;
+        title: string | null;
+        type: string;
+    };
+}
+
+export type { CreateRelationInput, RelationType, RelationWithEntities };

package/dist/relations/index.js

@@ -0,0 +1 @@
+import "../chunk-QAWJ6GM3.js";

package/dist/views/index.d.ts

@@ -1,31 +1,135 @@
-import { View } from '@synap/database/schema';
 export { NewView, View } from '@synap/database/schema';
 
 /**
  * View Types
  *
  * Re-exports view types from database schema (single source of truth).
+ * Extended with Table Inversion System configuration types.
  *
  * @see {@link file:///.../packages/database/src/schema/views.ts}
  */
 
-type ViewType = View['type'];
+/**
+ * View types - categorized by rendering approach
+ *
+ * Canvas-based: Freeform positioning (e.g., whiteboard)
+ * Table-based: Data-driven with layout variations (Table Inversion System)
+ * Specialized: Unique rendering logic
+ */
+type ViewType = 'whiteboard' | 'table' | 'kanban' | 'list' | 'grid' | 'gallery' | 'calendar' | 'gantt' | 'timeline' | 'mindmap' | 'graph';
+/**
+ * Column definition for table-based views
+ */
+interface ColumnDefinition {
+    id: string;
+    name: string;
+    type: 'text' | 'number' | 'date' | 'select' | 'multi-select' | 'checkbox' | 'url' | 'email' | 'phone' | 'person' | 'relation' | 'formula' | 'rollup';
+    options?: string[];
+    relationTableId?: string;
+    formula?: string;
+    width?: number;
+    isHidden?: boolean;
+}
+/**
+ * Filter rule for views
+ */
+interface FilterRule {
+    columnId: string;
+    operator: 'equals' | 'not_equals' | 'contains' | 'not_contains' | 'is_empty' | 'is_not_empty' | 'greater_than' | 'less_than' | 'date_is' | 'date_before' | 'date_after';
+    value?: unknown;
+}
+/**
+ * Sort rule for views
+ */
+interface SortRule {
+    columnId: string;
+    direction: 'asc' | 'desc';
+}
+/**
+ * Kanban-specific configuration
+ */
+interface KanbanConfig {
+    groupByColumnId: string;
+    swimlaneColumnId?: string;
+    cardDisplayColumns: string[];
+    hideEmptyGroups?: boolean;
+}
+/**
+ * Calendar-specific configuration
+ */
+interface CalendarConfig {
+    dateColumnId: string;
+    endDateColumnId?: string;
+    titleColumnId: string;
+    showWeekends?: boolean;
+}
+/**
+ * Grid/Gallery-specific configuration
+ */
+interface GridConfig {
+    itemsPerRow: number;
+    cardSize: 'compact' | 'normal' | 'large';
+    thumbnailColumnId?: string;
+    showTitle?: boolean;
+}
+/**
+ * List-specific configuration
+ */
+interface ListConfig {
+    primaryColumnId: string;
+    secondaryColumnIds?: string[];
+    showCheckboxes?: boolean;
+}
+/**
+ * Gantt/Timeline-specific configuration
+ */
+interface GanttConfig {
+    startDateColumnId: string;
+    endDateColumnId: string;
+    dependencyColumnId?: string;
+    progressColumnId?: string;
+    milestoneColumnId?: string;
+}
+/**
+ * Table View Configuration (Table Inversion System)
+ *
+ * Stores the configuration for any table-based view.
+ * The same data can be displayed in different layouts by changing the `layout` property.
+ */
+interface TableViewConfig {
+    layout: 'table' | 'kanban' | 'list' | 'grid' | 'gallery' | 'calendar' | 'gantt' | 'timeline';
+    columns: ColumnDefinition[];
+    filters?: FilterRule[];
+    sorts?: SortRule[];
+    groupByColumnId?: string;
+    kanbanConfig?: KanbanConfig;
+    calendarConfig?: CalendarConfig;
+    gridConfig?: GridConfig;
+    listConfig?: ListConfig;
+    ganttConfig?: GanttConfig;
+}
 interface CreateViewInput {
     workspaceId?: string;
     type: ViewType;
     name: string;
     description?: string;
     initialContent?: unknown;
+    tableConfig?: TableViewConfig;
 }
 interface UpdateViewInput {
     name?: string;
     description?: string;
     metadata?: Record<string, unknown>;
+    tableConfig?: Partial<TableViewConfig>;
 }
 interface SaveViewInput {
     viewId: string;
     content: unknown;
     saveType?: 'auto' | 'manual' | 'publish';
 }
+interface SwitchViewLayoutInput {
+    viewId: string;
+    newLayout: TableViewConfig['layout'];
+}
 
-export type { CreateViewInput, SaveViewInput, UpdateViewInput, ViewType };
+export type { CalendarConfig, ColumnDefinition, CreateViewInput, FilterRule, GanttConfig, GridConfig, KanbanConfig, ListConfig, SaveViewInput, SortRule, SwitchViewLayoutInput, TableViewConfig, UpdateViewInput, ViewType };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synap-core/types",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -36,6 +36,10 @@
       "types": "./dist/views/index.d.ts",
       "import": "./dist/views/index.js"
     },
+    "./relations": {
+      "types": "./dist/relations/index.d.ts",
+      "import": "./dist/relations/index.js"
+    },
     "./preferences": {
       "types": "./dist/preferences/index.d.ts",
       "import": "./dist/preferences/index.js"

package/src/entities/schemas.ts

@@ -60,6 +60,44 @@ export const ENTITY_SCHEMAS = {
     thumbnailUrl: z.string().url().optional(),
     downloadUrl: z.string().url().optional(),
   }),
+  
+  // NEW: Company/Organization entity
+  company: z.object({
+    website: z.string().url().optional(),
+    industry: z.string().optional(),
+    size: z.enum(['startup', 'small', 'medium', 'large', 'enterprise']).optional(),
+    location: z.string().optional(),
+    linkedInUrl: z.string().url().optional(),
+    description: z.string().optional(),
+    foundedYear: z.number().int().optional(),
+    // Linked employee person entities
+    employees: z.array(z.string().uuid()).default([]),
+  }),
+  
+  // NEW: Bookmark/Web clip entity
+  bookmark: z.object({
+    url: z.string().url(),
+    favicon: z.string().url().optional(),
+    excerpt: z.string().optional(),
+    siteName: z.string().optional(),
+    author: z.string().optional(),
+    publishedDate: z.string().datetime().optional(),
+    tags: z.array(z.string()).default([]),
+    // For local archiving
+    archiveUrl: z.string().url().optional(),
+    isRead: z.boolean().default(false),
+  }),
+  
+  // NEW: Code snippet entity
+  code: z.object({
+    language: z.string(),                    // 'typescript', 'python', 'rust', etc.
+    runtime: z.string().optional(),          // 'node', 'browser', 'python3', etc.
+    framework: z.string().optional(),        // 'react', 'express', 'django', etc.
+    dependencies: z.array(z.string()).default([]),
+    isExecutable: z.boolean().default(false),
+    sourceUrl: z.string().url().optional(),  // GitHub gist, CodeSandbox, etc.
+    version: z.string().optional(),          // Code version/revision
+  }),
 } as const;
 
 /**

package/src/index.ts

@@ -22,9 +22,12 @@ export * from './inbox/index.js';
 // Workspace types (V3.0)
 export * from './workspaces/index.js';
 
-// View types (V3.0)
+// View types (V3.0) - Extended with Table Inversion System
 export * from './views/index.js';
 
+// Relation types (V3.1) - Knowledge graph edges
+export * from './relations/index.js';
+
 // Preferences types (V3.0)
 export * from './preferences/index.js';
 
@@ -33,3 +36,4 @@ export * from './realtime/index.js';
 
 // Domain event types for Socket.IO (V3.0)
 export * from './events/index.js';
+

package/src/realtime/index.ts

@@ -58,3 +58,25 @@ export interface CursorUpdate {
   y: number;
   viewId: string;
 }
+
+/**
+ * User joined event (emitted when user joins a workspace/document)
+ */
+export interface UserJoinedEvent {
+  userId: string;
+  userName: string;
+  workspaceId: string;
+  documentId?: string;
+  color?: string;
+  timestamp: number;
+}
+
+/**
+ * User left event (emitted when user leaves a workspace/document)
+ */
+export interface UserLeftEvent {
+  userId: string;
+  workspaceId: string;
+  documentId?: string;
+  timestamp: number;
+}

package/src/relations/index.ts

@@ -0,0 +1,49 @@
+/**
+ * Relation Types
+ * 
+ * Re-exports relation types from database schema (single source of truth).
+ * 
+ * @see {@link file:///.../packages/database/src/schema/relations.ts}
+ */
+
+// Direct re-exports from database
+export type { 
+  Relation,
+  NewRelation,
+} from '@synap/database/schema';
+
+// Relation type definitions
+export type RelationType = 
+  | 'related_to'      // Generic relationship
+  | 'parent_of'       // Hierarchy (parent → child)
+  | 'child_of'        // Inverse hierarchy (child → parent)
+  | 'blocks'          // Dependencies (X blocks Y)
+  | 'mentioned_in'    // Content references
+  | 'linked_to';      // User-created links
+
+// Input types for API operations
+export interface CreateRelationInput {
+  sourceEntityId: string;
+  targetEntityId: string;
+  type: RelationType;
+  metadata?: Record<string, unknown>;
+}
+
+export interface RelationWithEntities {
+  id: string;
+  sourceEntityId: string;
+  targetEntityId: string;
+  type: RelationType;
+  createdAt: Date;
+  // Populated fields
+  sourceEntity?: {
+    id: string;
+    title: string | null;
+    type: string;
+  };
+  targetEntity?: {
+    id: string;
+    title: string | null;
+    type: string;
+  };
+}

package/src/views/index.ts

@@ -2,6 +2,7 @@
  * View Types
  * 
  * Re-exports view types from database schema (single source of truth).
+ * Extended with Table Inversion System configuration types.
  * 
  * @see {@link file:///.../packages/database/src/schema/views.ts}
  */
@@ -12,24 +13,162 @@ export type {
   NewView,
 } from '@synap/database/schema';
 
-// Derived types
-import type { View } from '@synap/database/schema';
+// =============================================================================
+// View Type Enum
+// =============================================================================
 
-export type ViewType = View['type'];
+/**
+ * View types - categorized by rendering approach
+ * 
+ * Canvas-based: Freeform positioning (e.g., whiteboard)
+ * Table-based: Data-driven with layout variations (Table Inversion System)
+ * Specialized: Unique rendering logic
+ */
+export type ViewType = 
+  // Canvas-based (freeform)
+  | 'whiteboard'     // Freeform canvas (Tldraw) - merges former 'board'
+  
+  // Table-based (single data, different layouts - Table Inversion System)
+  | 'table'          // Spreadsheet view (base layout)
+  | 'kanban'         // Grouped columns (inverted table)
+  | 'list'           // Simple list (inverted table)
+  | 'grid'           // Card grid (inverted table)
+  | 'gallery'        // Image-focused grid (inverted table)
+  | 'calendar'       // Date-based placement (inverted table)
+  | 'gantt'          // Timeline with dependencies (inverted table)
+  | 'timeline'       // Chronological view (inverted table)
+  
+  // Specialized
+  | 'mindmap'        // Hierarchical tree visualization
+  | 'graph';         // Knowledge graph visualization
+
+// =============================================================================
+// Table Inversion System Configuration
+// =============================================================================
+
+/**
+ * Column definition for table-based views
+ */
+export interface ColumnDefinition {
+  id: string;
+  name: string;
+  type: 'text' | 'number' | 'date' | 'select' | 'multi-select' | 'checkbox' | 'url' | 'email' | 'phone' | 'person' | 'relation' | 'formula' | 'rollup';
+  options?: string[];           // For select/multi-select
+  relationTableId?: string;     // For relation columns
+  formula?: string;             // For formula columns
+  width?: number;               // Column width in pixels
+  isHidden?: boolean;           // Hidden from current view
+}
+
+/**
+ * Filter rule for views
+ */
+export interface FilterRule {
+  columnId: string;
+  operator: 'equals' | 'not_equals' | 'contains' | 'not_contains' | 'is_empty' | 'is_not_empty' | 'greater_than' | 'less_than' | 'date_is' | 'date_before' | 'date_after';
+  value?: unknown;
+}
+
+/**
+ * Sort rule for views
+ */
+export interface SortRule {
+  columnId: string;
+  direction: 'asc' | 'desc';
+}
+
+/**
+ * Kanban-specific configuration
+ */
+export interface KanbanConfig {
+  groupByColumnId: string;        // Column to group cards by (must be select type)
+  swimlaneColumnId?: string;      // Optional horizontal grouping
+  cardDisplayColumns: string[];   // Which columns to show on cards
+  hideEmptyGroups?: boolean;      // Hide columns with no cards
+}
+
+/**
+ * Calendar-specific configuration
+ */
+export interface CalendarConfig {
+  dateColumnId: string;           // Column for date placement
+  endDateColumnId?: string;       // For multi-day events
+  titleColumnId: string;          // Column for event title
+  showWeekends?: boolean;         // Show weekend days
+}
+
+/**
+ * Grid/Gallery-specific configuration
+ */
+export interface GridConfig {
+  itemsPerRow: number;            // Cards per row
+  cardSize: 'compact' | 'normal' | 'large';
+  thumbnailColumnId?: string;     // Column for preview image
+  showTitle?: boolean;
+}
+
+/**
+ * List-specific configuration
+ */
+export interface ListConfig {
+  primaryColumnId: string;        // Main display column
+  secondaryColumnIds?: string[];  // Additional columns to show
+  showCheckboxes?: boolean;       // Show selection checkboxes
+}
+
+/**
+ * Gantt/Timeline-specific configuration
+ */
+export interface GanttConfig {
+  startDateColumnId: string;
+  endDateColumnId: string;
+  dependencyColumnId?: string;    // Relation column for dependencies
+  progressColumnId?: string;      // Number column for % complete
+  milestoneColumnId?: string;     // Checkbox column for milestones
+}
+
+/**
+ * Table View Configuration (Table Inversion System)
+ * 
+ * Stores the configuration for any table-based view.
+ * The same data can be displayed in different layouts by changing the `layout` property.
+ */
+export interface TableViewConfig {
+  // Current layout mode
+  layout: 'table' | 'kanban' | 'list' | 'grid' | 'gallery' | 'calendar' | 'gantt' | 'timeline';
+  
+  // Universal settings (apply to all layouts)
+  columns: ColumnDefinition[];
+  filters?: FilterRule[];
+  sorts?: SortRule[];
+  groupByColumnId?: string;       // Universal grouping (layout determines rendering)
+  
+  // Layout-specific configurations
+  kanbanConfig?: KanbanConfig;
+  calendarConfig?: CalendarConfig;
+  gridConfig?: GridConfig;
+  listConfig?: ListConfig;
+  ganttConfig?: GanttConfig;
+}
+
+// =============================================================================
+// API Input Types
+// =============================================================================
 
-// Input types for API operations
 export interface CreateViewInput {
   workspaceId?: string;
   type: ViewType;
   name: string;
   description?: string;
   initialContent?: unknown;
+  tableConfig?: TableViewConfig;  // For table-based views
 }
 
 export interface UpdateViewInput {
   name?: string;
   description?: string;
   metadata?: Record<string, unknown>;
+  tableConfig?: Partial<TableViewConfig>;
 }
 
 export interface SaveViewInput {
@@ -37,3 +176,8 @@ export interface SaveViewInput {
   content: unknown;
   saveType?: 'auto' | 'manual' | 'publish';
 }
+
+export interface SwitchViewLayoutInput {
+  viewId: string;
+  newLayout: TableViewConfig['layout'];
+}

package/tsup.config.ts

@@ -9,6 +9,7 @@ export default defineConfig({
     'src/inbox/index.ts',
     'src/workspaces/index.ts',
     'src/views/index.ts',
+    'src/relations/index.ts',   // NEW: Knowledge graph edges
     'src/preferences/index.ts',
     'src/realtime/index.ts',
     'src/events/index.ts',