digital-tools 2.0.2 → 2.1.1

package/src/entities/presentation.js

@@ -0,0 +1,1274 @@
+/**
+ * Presentation Entity Types (Nouns)
+ *
+ * Semantic type definitions for presentations that support
+ * Google Slides, Microsoft PowerPoint/PPTX, and Reveal.js/MDX formats.
+ * Each entity defines:
+ * - Properties: The data fields
+ * - Actions: Operations that can be performed (Verbs)
+ * - Events: State changes that occur
+ *
+ * @packageDocumentation
+ */
+// =============================================================================
+// Presentation
+// =============================================================================
+/**
+ * Presentation entity
+ *
+ * Represents a slide presentation for creating and delivering visual content.
+ * Supports Google Slides, PowerPoint/PPTX, and Reveal.js/MDX formats.
+ */
+export const Presentation = {
+    singular: 'presentation',
+    plural: 'presentations',
+    description: 'A slide presentation for creating and delivering visual content',
+    properties: {
+        // Identity
+        title: {
+            type: 'string',
+            description: 'Presentation title',
+        },
+        slug: {
+            type: 'string',
+            optional: true,
+            description: 'URL-friendly identifier',
+        },
+        description: {
+            type: 'string',
+            optional: true,
+            description: 'Presentation description or summary',
+        },
+        subtitle: {
+            type: 'string',
+            optional: true,
+            description: 'Presentation subtitle',
+        },
+        // Format
+        format: {
+            type: 'string',
+            description: 'Presentation format: pptx, gslides, revealjs, mdx, pdf',
+            examples: ['pptx', 'gslides', 'revealjs', 'mdx', 'pdf', 'keynote'],
+        },
+        aspectRatio: {
+            type: 'string',
+            optional: true,
+            description: 'Slide aspect ratio: 16:9, 4:3, 16:10',
+            examples: ['16:9', '4:3', '16:10'],
+        },
+        slideSize: {
+            type: 'json',
+            optional: true,
+            description: 'Custom slide dimensions',
+        },
+        // Status
+        status: {
+            type: 'string',
+            description: 'Presentation status: draft, in-review, ready, presented, archived',
+            examples: ['draft', 'in-review', 'ready', 'presented', 'archived'],
+        },
+        visibility: {
+            type: 'string',
+            description: 'Visibility: private, internal, public',
+            examples: ['private', 'internal', 'public'],
+        },
+        // Structure
+        slideCount: {
+            type: 'number',
+            optional: true,
+            description: 'Total number of slides',
+        },
+        duration: {
+            type: 'number',
+            optional: true,
+            description: 'Estimated presentation duration in minutes',
+        },
+        // Theme and styling
+        theme: {
+            type: 'string',
+            optional: true,
+            description: 'Presentation theme name',
+        },
+        themeConfig: {
+            type: 'json',
+            optional: true,
+            description: 'Theme configuration and customization',
+        },
+        masterSlides: {
+            type: 'json',
+            optional: true,
+            description: 'Master slide layouts',
+        },
+        colorScheme: {
+            type: 'json',
+            optional: true,
+            description: 'Color scheme configuration',
+        },
+        fontScheme: {
+            type: 'json',
+            optional: true,
+            description: 'Font scheme configuration',
+        },
+        // Transitions and animations
+        defaultTransition: {
+            type: 'string',
+            optional: true,
+            description: 'Default slide transition effect',
+            examples: ['none', 'fade', 'slide', 'zoom', 'flip', 'cube', 'wipe'],
+        },
+        transitionSpeed: {
+            type: 'string',
+            optional: true,
+            description: 'Transition speed: slow, default, fast',
+            examples: ['slow', 'default', 'fast'],
+        },
+        // Presenter features
+        hasNotes: {
+            type: 'boolean',
+            optional: true,
+            description: 'Whether presentation includes speaker notes',
+        },
+        hasTimings: {
+            type: 'boolean',
+            optional: true,
+            description: 'Whether slides have timing information',
+        },
+        autoAdvance: {
+            type: 'boolean',
+            optional: true,
+            description: 'Whether slides auto-advance',
+        },
+        autoAdvanceDelay: {
+            type: 'number',
+            optional: true,
+            description: 'Auto-advance delay in seconds',
+        },
+        loop: {
+            type: 'boolean',
+            optional: true,
+            description: 'Whether presentation loops',
+        },
+        // Collaboration
+        allowComments: {
+            type: 'boolean',
+            optional: true,
+            description: 'Whether comments are enabled',
+        },
+        shareMode: {
+            type: 'string',
+            optional: true,
+            description: 'Sharing mode: view, comment, edit, present',
+            examples: ['view', 'comment', 'edit', 'present'],
+        },
+        allowDownload: {
+            type: 'boolean',
+            optional: true,
+            description: 'Whether download is allowed',
+        },
+        // Templates
+        isTemplate: {
+            type: 'boolean',
+            optional: true,
+            description: 'Whether this is a template',
+        },
+        templateId: {
+            type: 'string',
+            optional: true,
+            description: 'ID of template this was created from',
+        },
+        templateCategory: {
+            type: 'string',
+            optional: true,
+            description: 'Template category',
+            examples: ['business', 'education', 'pitch-deck', 'report', 'training'],
+        },
+        // Publishing
+        published: {
+            type: 'boolean',
+            optional: true,
+            description: 'Whether presentation is published',
+        },
+        publishedUrl: {
+            type: 'url',
+            optional: true,
+            description: 'Published presentation URL',
+        },
+        publishedAt: {
+            type: 'datetime',
+            optional: true,
+            description: 'Publication timestamp',
+        },
+        embedCode: {
+            type: 'string',
+            optional: true,
+            description: 'HTML embed code',
+        },
+        // Presentation sessions
+        lastPresentedAt: {
+            type: 'datetime',
+            optional: true,
+            description: 'Last presentation timestamp',
+        },
+        presentationCount: {
+            type: 'number',
+            optional: true,
+            description: 'Number of times presented',
+        },
+        // Integration
+        externalId: {
+            type: 'string',
+            optional: true,
+            description: 'External system ID (Google Slides ID, OneDrive ID, etc.)',
+        },
+        externalUrl: {
+            type: 'url',
+            optional: true,
+            description: 'URL in external system',
+        },
+        syncEnabled: {
+            type: 'boolean',
+            optional: true,
+            description: 'Whether sync is enabled',
+        },
+        lastSyncedAt: {
+            type: 'datetime',
+            optional: true,
+            description: 'Last sync timestamp',
+        },
+        // Metadata
+        language: {
+            type: 'string',
+            optional: true,
+            description: 'Presentation language code',
+        },
+        author: {
+            type: 'string',
+            optional: true,
+            description: 'Presentation author name',
+        },
+        company: {
+            type: 'string',
+            optional: true,
+            description: 'Company or organization',
+        },
+        tags: {
+            type: 'string',
+            array: true,
+            optional: true,
+            description: 'Tags for categorization',
+        },
+        category: {
+            type: 'string',
+            optional: true,
+            description: 'Presentation category',
+        },
+        folder: {
+            type: 'string',
+            optional: true,
+            description: 'Folder or workspace path',
+        },
+        customMetadata: {
+            type: 'json',
+            optional: true,
+            description: 'Custom metadata fields',
+        },
+        // Analytics
+        viewCount: {
+            type: 'number',
+            optional: true,
+            description: 'Number of views',
+        },
+        downloadCount: {
+            type: 'number',
+            optional: true,
+            description: 'Number of downloads',
+        },
+        lastViewedAt: {
+            type: 'datetime',
+            optional: true,
+            description: 'Last view timestamp',
+        },
+        lastEditedAt: {
+            type: 'datetime',
+            optional: true,
+            description: 'Last edit timestamp',
+        },
+    },
+    relationships: {
+        owner: {
+            type: 'Contact',
+            description: 'Presentation owner',
+        },
+        creator: {
+            type: 'Contact',
+            description: 'User who created the presentation',
+        },
+        lastEditor: {
+            type: 'Contact',
+            required: false,
+            description: 'User who last edited',
+        },
+        slides: {
+            type: 'Slide[]',
+            backref: 'presentation',
+            description: 'Slides in this presentation',
+        },
+        collaborators: {
+            type: 'Contact[]',
+            description: 'Users with access',
+        },
+    },
+    actions: [
+        'create',
+        'open',
+        'edit',
+        'save',
+        'saveAs',
+        'duplicate',
+        'rename',
+        'delete',
+        'restore',
+        'export',
+        'download',
+        'print',
+        'share',
+        'unshare',
+        'publish',
+        'unpublish',
+        'archive',
+        'unarchive',
+        'move',
+        'copy',
+        'present',
+        'startPresentation',
+        'endPresentation',
+        'addSlide',
+        'removeSlide',
+        'reorderSlides',
+        'duplicateSlide',
+        'makeTemplate',
+        'createFromTemplate',
+        'applyTheme',
+        'changeAspectRatio',
+        'setTransitions',
+        'addAnimation',
+        'recordPresentation',
+        'embedPresentation',
+    ],
+    events: [
+        'created',
+        'opened',
+        'edited',
+        'saved',
+        'renamed',
+        'deleted',
+        'restored',
+        'exported',
+        'downloaded',
+        'printed',
+        'shared',
+        'unshared',
+        'published',
+        'unpublished',
+        'archived',
+        'unarchived',
+        'moved',
+        'copied',
+        'presented',
+        'presentationStarted',
+        'presentationEnded',
+        'slideAdded',
+        'slideRemoved',
+        'slidesReordered',
+        'slideDuplicated',
+        'themeApplied',
+        'aspectRatioChanged',
+        'transitionsSet',
+        'animationAdded',
+        'recorded',
+        'embedded',
+        'collaboratorAdded',
+        'collaboratorRemoved',
+        'permissionChanged',
+        'synced',
+        'viewed',
+    ],
+};
+// =============================================================================
+// Slide
+// =============================================================================
+/**
+ * Slide entity
+ *
+ * Represents a single slide within a presentation.
+ */
+export const Slide = {
+    singular: 'slide',
+    plural: 'slides',
+    description: 'A single slide within a presentation',
+    properties: {
+        // Identity
+        title: {
+            type: 'string',
+            optional: true,
+            description: 'Slide title',
+        },
+        index: {
+            type: 'number',
+            description: 'Slide position in presentation (0-based)',
+        },
+        slideId: {
+            type: 'string',
+            optional: true,
+            description: 'Internal slide identifier',
+        },
+        // Layout
+        layout: {
+            type: 'string',
+            optional: true,
+            description: 'Slide layout type',
+            examples: [
+                'title',
+                'title-content',
+                'section-header',
+                'two-column',
+                'comparison',
+                'blank',
+                'content',
+                'title-only',
+                'picture',
+            ],
+        },
+        masterSlideId: {
+            type: 'string',
+            optional: true,
+            description: 'Master slide/layout reference',
+        },
+        // Background
+        backgroundColor: {
+            type: 'string',
+            optional: true,
+            description: 'Background color (hex)',
+        },
+        backgroundImage: {
+            type: 'url',
+            optional: true,
+            description: 'Background image URL',
+        },
+        backgroundType: {
+            type: 'string',
+            optional: true,
+            description: 'Background type: solid, gradient, image, video',
+            examples: ['solid', 'gradient', 'image', 'video'],
+        },
+        backgroundGradient: {
+            type: 'json',
+            optional: true,
+            description: 'Gradient configuration',
+        },
+        // Transition
+        transition: {
+            type: 'string',
+            optional: true,
+            description: 'Slide transition effect',
+            examples: ['none', 'fade', 'slide', 'zoom', 'flip', 'cube', 'wipe', 'dissolve'],
+        },
+        transitionDuration: {
+            type: 'number',
+            optional: true,
+            description: 'Transition duration in milliseconds',
+        },
+        transitionDirection: {
+            type: 'string',
+            optional: true,
+            description: 'Transition direction',
+            examples: ['left', 'right', 'up', 'down'],
+        },
+        // Timing
+        duration: {
+            type: 'number',
+            optional: true,
+            description: 'Slide display duration in seconds',
+        },
+        autoAdvance: {
+            type: 'boolean',
+            optional: true,
+            description: 'Whether slide auto-advances',
+        },
+        advanceAfter: {
+            type: 'number',
+            optional: true,
+            description: 'Seconds before auto-advance',
+        },
+        // Content
+        hasContent: {
+            type: 'boolean',
+            optional: true,
+            description: 'Whether slide has content elements',
+        },
+        elementCount: {
+            type: 'number',
+            optional: true,
+            description: 'Number of elements on slide',
+        },
+        // Notes
+        notes: {
+            type: 'string',
+            optional: true,
+            description: 'Speaker notes for this slide',
+        },
+        hasNotes: {
+            type: 'boolean',
+            optional: true,
+            description: 'Whether slide has speaker notes',
+        },
+        // Visibility
+        hidden: {
+            type: 'boolean',
+            optional: true,
+            description: 'Whether slide is hidden',
+        },
+        // Section
+        sectionTitle: {
+            type: 'string',
+            optional: true,
+            description: 'Section this slide belongs to',
+        },
+        isSection: {
+            type: 'boolean',
+            optional: true,
+            description: 'Whether this is a section divider',
+        },
+        // Animations
+        hasAnimations: {
+            type: 'boolean',
+            optional: true,
+            description: 'Whether slide has animations',
+        },
+        animationCount: {
+            type: 'number',
+            optional: true,
+            description: 'Number of animations',
+        },
+        // Thumbnail
+        thumbnail: {
+            type: 'url',
+            optional: true,
+            description: 'Slide thumbnail URL',
+        },
+        // Metadata
+        metadata: {
+            type: 'json',
+            optional: true,
+            description: 'Custom metadata',
+        },
+    },
+    relationships: {
+        presentation: {
+            type: 'Presentation',
+            backref: 'slides',
+            description: 'Parent presentation',
+        },
+        elements: {
+            type: 'SlideElement[]',
+            backref: 'slide',
+            description: 'Elements on this slide',
+        },
+        speakerNotes: {
+            type: 'SpeakerNotes',
+            required: false,
+            description: 'Detailed speaker notes',
+        },
+        animations: {
+            type: 'Animation[]',
+            backref: 'slide',
+            description: 'Animations on this slide',
+        },
+    },
+    actions: [
+        'create',
+        'edit',
+        'delete',
+        'duplicate',
+        'move',
+        'hide',
+        'unhide',
+        'setLayout',
+        'setBackground',
+        'setTransition',
+        'addElement',
+        'removeElement',
+        'reorderElements',
+        'addNotes',
+        'editNotes',
+        'addAnimation',
+        'preview',
+        'present',
+        'export',
+        'generateThumbnail',
+        'createSection',
+    ],
+    events: [
+        'created',
+        'edited',
+        'deleted',
+        'duplicated',
+        'moved',
+        'hidden',
+        'unhidden',
+        'layoutSet',
+        'backgroundSet',
+        'transitionSet',
+        'elementAdded',
+        'elementRemoved',
+        'elementsReordered',
+        'notesAdded',
+        'notesEdited',
+        'animationAdded',
+        'presented',
+        'exported',
+        'thumbnailGenerated',
+        'sectionCreated',
+    ],
+};
+// =============================================================================
+// SlideElement
+// =============================================================================
+/**
+ * SlideElement entity
+ *
+ * Represents a content element on a slide (text, image, shape, chart, etc.).
+ */
+export const SlideElement = {
+    singular: 'slide element',
+    plural: 'slide elements',
+    description: 'A content element on a slide (text, image, shape, chart, video, etc.)',
+    properties: {
+        // Identity
+        elementId: {
+            type: 'string',
+            optional: true,
+            description: 'Unique element identifier',
+        },
+        name: {
+            type: 'string',
+            optional: true,
+            description: 'Element name or label',
+        },
+        // Type
+        type: {
+            type: 'string',
+            description: 'Element type',
+            examples: [
+                'text',
+                'textbox',
+                'image',
+                'shape',
+                'chart',
+                'table',
+                'video',
+                'audio',
+                'embed',
+                'line',
+                'arrow',
+                'group',
+                'smartart',
+            ],
+        },
+        subtype: {
+            type: 'string',
+            optional: true,
+            description: 'Element subtype (shape type, chart type, etc.)',
+        },
+        // Position and size
+        x: {
+            type: 'number',
+            description: 'X position in slide coordinates',
+        },
+        y: {
+            type: 'number',
+            description: 'Y position in slide coordinates',
+        },
+        width: {
+            type: 'number',
+            description: 'Element width',
+        },
+        height: {
+            type: 'number',
+            description: 'Element height',
+        },
+        rotation: {
+            type: 'number',
+            optional: true,
+            description: 'Rotation angle in degrees',
+        },
+        zIndex: {
+            type: 'number',
+            optional: true,
+            description: 'Z-index for layering',
+        },
+        // Content (varies by type)
+        content: {
+            type: 'string',
+            optional: true,
+            description: 'Element content (text, URL, etc.)',
+        },
+        richContent: {
+            type: 'json',
+            optional: true,
+            description: 'Rich formatted content',
+        },
+        // Text-specific
+        text: {
+            type: 'string',
+            optional: true,
+            description: 'Text content',
+        },
+        fontFamily: {
+            type: 'string',
+            optional: true,
+            description: 'Font family',
+        },
+        fontSize: {
+            type: 'number',
+            optional: true,
+            description: 'Font size in points',
+        },
+        fontWeight: {
+            type: 'string',
+            optional: true,
+            description: 'Font weight: normal, bold',
+            examples: ['normal', 'bold'],
+        },
+        fontStyle: {
+            type: 'string',
+            optional: true,
+            description: 'Font style: normal, italic',
+            examples: ['normal', 'italic'],
+        },
+        textAlign: {
+            type: 'string',
+            optional: true,
+            description: 'Text alignment: left, center, right, justify',
+            examples: ['left', 'center', 'right', 'justify'],
+        },
+        textColor: {
+            type: 'string',
+            optional: true,
+            description: 'Text color (hex)',
+        },
+        lineHeight: {
+            type: 'number',
+            optional: true,
+            description: 'Line height multiplier',
+        },
+        bulletStyle: {
+            type: 'string',
+            optional: true,
+            description: 'Bullet list style',
+        },
+        // Image-specific
+        imageUrl: {
+            type: 'url',
+            optional: true,
+            description: 'Image URL',
+        },
+        imageSource: {
+            type: 'string',
+            optional: true,
+            description: 'Image source or attribution',
+        },
+        imageAlt: {
+            type: 'string',
+            optional: true,
+            description: 'Image alt text',
+        },
+        // Video-specific
+        videoUrl: {
+            type: 'url',
+            optional: true,
+            description: 'Video URL',
+        },
+        videoProvider: {
+            type: 'string',
+            optional: true,
+            description: 'Video provider: youtube, vimeo, etc.',
+            examples: ['youtube', 'vimeo', 'local'],
+        },
+        autoplay: {
+            type: 'boolean',
+            optional: true,
+            description: 'Whether video autoplays',
+        },
+        loop: {
+            type: 'boolean',
+            optional: true,
+            description: 'Whether video loops',
+        },
+        // Shape-specific
+        shapeType: {
+            type: 'string',
+            optional: true,
+            description: 'Shape type',
+            examples: ['rectangle', 'circle', 'triangle', 'star', 'arrow', 'callout'],
+        },
+        fillColor: {
+            type: 'string',
+            optional: true,
+            description: 'Fill color (hex)',
+        },
+        strokeColor: {
+            type: 'string',
+            optional: true,
+            description: 'Stroke/border color (hex)',
+        },
+        strokeWidth: {
+            type: 'number',
+            optional: true,
+            description: 'Stroke width in points',
+        },
+        // Chart-specific
+        chartType: {
+            type: 'string',
+            optional: true,
+            description: 'Chart type',
+            examples: ['line', 'bar', 'pie', 'scatter', 'area'],
+        },
+        chartData: {
+            type: 'json',
+            optional: true,
+            description: 'Chart data and configuration',
+        },
+        // Table-specific
+        tableData: {
+            type: 'json',
+            optional: true,
+            description: 'Table data as 2D array',
+        },
+        tableRows: {
+            type: 'number',
+            optional: true,
+            description: 'Number of table rows',
+        },
+        tableColumns: {
+            type: 'number',
+            optional: true,
+            description: 'Number of table columns',
+        },
+        // Styling
+        backgroundColor: {
+            type: 'string',
+            optional: true,
+            description: 'Background color (hex)',
+        },
+        opacity: {
+            type: 'number',
+            optional: true,
+            description: 'Opacity (0-1)',
+        },
+        shadow: {
+            type: 'json',
+            optional: true,
+            description: 'Shadow configuration',
+        },
+        border: {
+            type: 'json',
+            optional: true,
+            description: 'Border configuration',
+        },
+        // Interactions
+        link: {
+            type: 'url',
+            optional: true,
+            description: 'Hyperlink URL',
+        },
+        linkType: {
+            type: 'string',
+            optional: true,
+            description: 'Link type: url, slide, file',
+            examples: ['url', 'slide', 'file', 'email'],
+        },
+        linkedSlideIndex: {
+            type: 'number',
+            optional: true,
+            description: 'Linked slide index for navigation',
+        },
+        // Animation
+        hasAnimation: {
+            type: 'boolean',
+            optional: true,
+            description: 'Whether element has animation',
+        },
+        // Grouping
+        isGrouped: {
+            type: 'boolean',
+            optional: true,
+            description: 'Whether element is part of a group',
+        },
+        groupId: {
+            type: 'string',
+            optional: true,
+            description: 'Group identifier',
+        },
+        // Visibility
+        hidden: {
+            type: 'boolean',
+            optional: true,
+            description: 'Whether element is hidden',
+        },
+        locked: {
+            type: 'boolean',
+            optional: true,
+            description: 'Whether element is locked from editing',
+        },
+        // Metadata
+        metadata: {
+            type: 'json',
+            optional: true,
+            description: 'Custom metadata',
+        },
+    },
+    relationships: {
+        slide: {
+            type: 'Slide',
+            backref: 'elements',
+            description: 'Parent slide',
+        },
+        animations: {
+            type: 'Animation[]',
+            backref: 'element',
+            description: 'Animations applied to this element',
+        },
+    },
+    actions: [
+        'create',
+        'edit',
+        'delete',
+        'duplicate',
+        'move',
+        'resize',
+        'rotate',
+        'bringToFront',
+        'sendToBack',
+        'bringForward',
+        'sendBackward',
+        'align',
+        'distribute',
+        'group',
+        'ungroup',
+        'lock',
+        'unlock',
+        'hide',
+        'unhide',
+        'setStyle',
+        'addLink',
+        'removeLink',
+        'addAnimation',
+        'copy',
+        'paste',
+        'cut',
+    ],
+    events: [
+        'created',
+        'edited',
+        'deleted',
+        'duplicated',
+        'moved',
+        'resized',
+        'rotated',
+        'reordered',
+        'aligned',
+        'distributed',
+        'grouped',
+        'ungrouped',
+        'locked',
+        'unlocked',
+        'hidden',
+        'unhidden',
+        'styled',
+        'linkAdded',
+        'linkRemoved',
+        'animationAdded',
+        'copied',
+        'pasted',
+    ],
+};
+// =============================================================================
+// SpeakerNotes
+// =============================================================================
+/**
+ * SpeakerNotes entity
+ *
+ * Represents detailed speaker notes for a slide.
+ */
+export const SpeakerNotes = {
+    singular: 'speaker notes',
+    plural: 'speaker notes',
+    description: 'Detailed speaker notes for a presentation slide',
+    properties: {
+        // Content
+        text: {
+            type: 'string',
+            description: 'Notes text content',
+        },
+        richText: {
+            type: 'json',
+            optional: true,
+            description: 'Rich formatted notes',
+        },
+        // Formatting
+        fontSize: {
+            type: 'number',
+            optional: true,
+            description: 'Font size for display',
+        },
+        // Timing
+        estimatedTime: {
+            type: 'number',
+            optional: true,
+            description: 'Estimated time for this slide in seconds',
+        },
+        actualTime: {
+            type: 'number',
+            optional: true,
+            description: 'Actual time spent on slide during presentation',
+        },
+        // Cues
+        cuePoints: {
+            type: 'json',
+            optional: true,
+            description: 'Timing cues or reminders',
+        },
+        // Structure
+        keyPoints: {
+            type: 'string',
+            array: true,
+            optional: true,
+            description: 'Key points to cover',
+        },
+        questions: {
+            type: 'string',
+            array: true,
+            optional: true,
+            description: 'Questions to ask audience',
+        },
+        // Visibility
+        visibleToAudience: {
+            type: 'boolean',
+            optional: true,
+            description: 'Whether notes are visible to audience',
+        },
+        // Metadata
+        metadata: {
+            type: 'json',
+            optional: true,
+            description: 'Custom metadata',
+        },
+    },
+    relationships: {
+        slide: {
+            type: 'Slide',
+            description: 'Associated slide',
+        },
+    },
+    actions: [
+        'create',
+        'edit',
+        'delete',
+        'clear',
+        'format',
+        'addCue',
+        'removeCue',
+        'setTiming',
+        'addKeyPoint',
+        'addQuestion',
+        'print',
+        'export',
+    ],
+    events: [
+        'created',
+        'edited',
+        'deleted',
+        'cleared',
+        'formatted',
+        'cueAdded',
+        'cueRemoved',
+        'timingSet',
+        'keyPointAdded',
+        'questionAdded',
+        'printed',
+        'exported',
+    ],
+};
+// =============================================================================
+// Animation
+// =============================================================================
+/**
+ * Animation entity
+ *
+ * Represents an animation effect applied to a slide or element.
+ */
+export const Animation = {
+    singular: 'animation',
+    plural: 'animations',
+    description: 'An animation effect applied to a slide or element',
+    properties: {
+        // Type
+        type: {
+            type: 'string',
+            description: 'Animation type: entrance, emphasis, exit, motion',
+            examples: ['entrance', 'emphasis', 'exit', 'motion'],
+        },
+        effect: {
+            type: 'string',
+            description: 'Animation effect name',
+            examples: [
+                'fade',
+                'fly',
+                'wipe',
+                'split',
+                'shape',
+                'wheel',
+                'zoom',
+                'bounce',
+                'spin',
+                'grow',
+                'shrink',
+                'pulse',
+            ],
+        },
+        variant: {
+            type: 'string',
+            optional: true,
+            description: 'Effect variant or direction',
+            examples: ['left', 'right', 'up', 'down', 'in', 'out'],
+        },
+        // Timing
+        trigger: {
+            type: 'string',
+            description: 'Animation trigger: on-click, with-previous, after-previous, auto',
+            examples: ['on-click', 'with-previous', 'after-previous', 'auto'],
+        },
+        order: {
+            type: 'number',
+            description: 'Animation sequence order',
+        },
+        delay: {
+            type: 'number',
+            optional: true,
+            description: 'Delay before animation starts in milliseconds',
+        },
+        duration: {
+            type: 'number',
+            optional: true,
+            description: 'Animation duration in milliseconds',
+        },
+        // Easing
+        easing: {
+            type: 'string',
+            optional: true,
+            description: 'Easing function',
+            examples: ['linear', 'ease', 'ease-in', 'ease-out', 'ease-in-out', 'bounce', 'elastic'],
+        },
+        // Motion path (for motion animations)
+        motionPath: {
+            type: 'json',
+            optional: true,
+            description: 'Motion path configuration',
+        },
+        // Options
+        reverse: {
+            type: 'boolean',
+            optional: true,
+            description: 'Whether animation plays in reverse',
+        },
+        rewind: {
+            type: 'boolean',
+            optional: true,
+            description: 'Whether element rewinds after animation',
+        },
+        loop: {
+            type: 'boolean',
+            optional: true,
+            description: 'Whether animation loops',
+        },
+        loopCount: {
+            type: 'number',
+            optional: true,
+            description: 'Number of times to loop',
+        },
+        // Sound
+        soundEffect: {
+            type: 'url',
+            optional: true,
+            description: 'Sound effect URL',
+        },
+        // Metadata
+        metadata: {
+            type: 'json',
+            optional: true,
+            description: 'Custom metadata',
+        },
+    },
+    relationships: {
+        slide: {
+            type: 'Slide',
+            backref: 'animations',
+            description: 'Parent slide',
+        },
+        element: {
+            type: 'SlideElement',
+            backref: 'animations',
+            required: false,
+            description: 'Element being animated',
+        },
+    },
+    actions: [
+        'create',
+        'edit',
+        'delete',
+        'duplicate',
+        'reorder',
+        'play',
+        'pause',
+        'stop',
+        'reset',
+        'preview',
+        'setTiming',
+        'setEffect',
+        'setTrigger',
+    ],
+    events: [
+        'created',
+        'edited',
+        'deleted',
+        'duplicated',
+        'reordered',
+        'played',
+        'paused',
+        'stopped',
+        'reset',
+        'timingSet',
+        'effectSet',
+        'triggerSet',
+    ],
+};
+// =============================================================================
+// Export all entities as a schema
+// =============================================================================
+/**
+ * All presentation entity types
+ */
+export const PresentationEntities = {
+    Presentation,
+    Slide,
+    SlideElement,
+    SpeakerNotes,
+    Animation,
+};
+/**
+ * Entity categories for organization
+ */
+export const PresentationCategories = {
+    presentations: ['Presentation', 'Slide', 'SlideElement', 'SpeakerNotes', 'Animation'],
+};