@starrykit/slides-core 0.1.26

package/dist/layout.d.ts

@@ -0,0 +1,36 @@
+export interface RectLike {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+export interface StageRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface StageGeometry {
+    scale: number;
+    offsetX: number;
+    offsetY: number;
+    slideWidth: number;
+    slideHeight: number;
+}
+export declare const ELEMENT_LAYOUT_STYLE_KEYS: readonly ["position", "left", "top", "width", "maxWidth", "height", "transform", "transformOrigin", "margin", "zIndex"];
+export type ElementLayoutStyleKey = (typeof ELEMENT_LAYOUT_STYLE_KEYS)[number];
+export type ElementLayoutStyleSnapshot = Record<ElementLayoutStyleKey, string | null>;
+export declare function createEmptyElementLayoutStyleSnapshot(): ElementLayoutStyleSnapshot;
+export declare function captureElementLayoutStyleSnapshot(node: HTMLElement): ElementLayoutStyleSnapshot;
+export declare function normalizeElementLayoutStyleSnapshot(snapshot: Partial<ElementLayoutStyleSnapshot>): ElementLayoutStyleSnapshot;
+export declare function parseTransformParts(transformValue: string | null | undefined): {
+    translateX: number;
+    translateY: number;
+    rotate: number;
+};
+export declare function composeTransform(translateX: number, translateY: number, rotate: number): string | null;
+export declare function elementRectToStageRect(elementRect: RectLike, rootRect: RectLike, geometry: StageGeometry): StageRect;
+export declare function stageDeltaToSlideDelta(deltaX: number, deltaY: number, geometry: StageGeometry): {
+    x: number;
+    y: number;
+};

package/dist/pdf-export.d.ts

@@ -0,0 +1,20 @@
+import type { SlideDeckManifestEntry } from "./slide-contract.js";
+export type PdfExportSelection = {
+    mode?: "all";
+} | {
+    mode: "slide";
+    slideFile?: string;
+} | {
+    mode: "slides";
+    slideFiles?: string[];
+};
+export type ResolvedPdfExportMode = "all" | "single" | "slides";
+export interface ResolvedPdfExportSelection {
+    mode: ResolvedPdfExportMode;
+    slides: SlideDeckManifestEntry[];
+}
+export declare function planPdfExport({ slides, selection, }: {
+    slides: SlideDeckManifestEntry[];
+    selection?: PdfExportSelection;
+}): ResolvedPdfExportSelection;
+export declare function planPdfExportSlides(slides: SlideDeckManifestEntry[], selection?: PdfExportSelection): SlideDeckManifestEntry[];

package/dist/presentation.d.ts

@@ -0,0 +1,7 @@
+export type PresentationTool = "none" | "laser" | "pen";
+export declare const PRESENTATION_PEN_COLORS: string[];
+export interface PresentableSlide {
+    hidden?: boolean;
+}
+export declare function planPresentationSlides<TSlide extends PresentableSlide>(slides: TSlide[]): TSlide[];
+export declare function clampPresentationIndex(index: number, slideCount: number): number;

package/dist/slide-contract.d.ts

@@ -0,0 +1,56 @@
+export type EditableType = "text" | "image" | "block" | "group";
+export interface EditableElement {
+    id: string;
+    selector: string;
+    type: EditableType;
+    content: string;
+    tagName: string;
+}
+export interface SlideModel {
+    id: string;
+    title: string;
+    htmlSource: string;
+    rootSelector: string;
+    width: number;
+    height: number;
+    elements: EditableElement[];
+    sourceFile?: string;
+    hidden?: boolean;
+}
+export interface SlideDeckManifestEntry {
+    file: string;
+    title?: string;
+    hidden?: boolean;
+    archetype?: string;
+    notes?: string;
+}
+export interface SlideDeckManifest {
+    deckTitle?: string;
+    description?: string;
+    generatedAt?: string;
+    slides?: SlideDeckManifestEntry[];
+}
+export interface ImportedSlideDeck {
+    manifest: SlideDeckManifest;
+    slides: SlideModel[];
+}
+export declare const SELECTOR_ATTR = "data-editable-id";
+export declare const SLIDE_ROOT_ID = "slide-root";
+export declare const SLIDE_ROOT_SELECTOR = "body";
+export declare const DEFAULT_SLIDE_WIDTH = 1920;
+export declare const DEFAULT_SLIDE_HEIGHT = 1080;
+export declare function getSlideElementSelector(elementId: string): string;
+export declare function getSlideRootSelector(rootId: string): string;
+export declare function getElementId(node: Element | null): string | null;
+export declare function isPersistedGroupElementId(elementId: string | null | undefined): boolean;
+export declare function isPersistedGroupNode(node: Element | null): boolean;
+export declare function setElementId(node: Element, id: string): void;
+export declare function createElementId(index: number, type: EditableType): string;
+export declare function parseDimension(value: string | null, fallback: number): number;
+export declare function parseFixedPixelDimension(value: string | null | undefined): number | null;
+export declare function readBodyStyleValueFromHtmlSource(html: string, propertyName: string): string | null;
+export declare function readBodyDimensionsFromHtmlSource(html: string): {
+    width: number;
+    height: number;
+};
+export declare function normalizeSlideId(slideId: string): string;

package/dist/slide-document.d.ts

@@ -0,0 +1,7 @@
+import { type SlideModel } from "./slide-contract.js";
+export declare function ensureEditableSelectors(html: string): string;
+export declare function parseSlide(html: string, slideId?: string): SlideModel;
+export declare function querySlideElement<T extends Element = HTMLElement>(doc: ParentNode, elementId: string): T | null;
+export declare function querySlideRoot<T extends HTMLElement = HTMLBodyElement>(doc: ParentNode): T | null;
+export declare function querySlideNode<T extends HTMLElement = HTMLElement>(doc: ParentNode, elementId: string): T | null;
+export declare function getSlideInlineStyleValue(slide: SlideModel, elementId: string, propertyName: string): string;

package/dist/slide-html-base.d.ts

@@ -0,0 +1,2 @@
+export declare function getDeckSlideBaseUrl(sourceFile?: string): string;
+export declare function injectBaseTag(htmlSource: string, sourceFile?: string): string;

package/dist/slide-html-document.d.ts

@@ -0,0 +1,3 @@
+export declare function parseHtmlDocument(html: string): Document | null;
+export declare function serializeHtmlDocument(doc: Document): string;
+export declare function updateHtmlSource(html: string, updater: (doc: Document) => void): string;

package/dist/slide-operation-reducer.d.ts

@@ -0,0 +1,4 @@
+import type { SlideModel } from "./slide-contract.js";
+import type { SlideOperation } from "./slide-operation-types.js";
+export declare function applySlideOperation(slide: SlideModel, operation: SlideOperation): SlideModel;
+export declare function invertSlideOperation(operation: SlideOperation): SlideOperation;

package/dist/slide-operation-types.d.ts

@@ -0,0 +1,123 @@
+import type { ElementLayoutStyleSnapshot } from "./layout.js";
+import type { SlideModel } from "./slide-contract.js";
+export interface TextUpdateOperation {
+    type: "text.update";
+    slideId: string;
+    elementId: string;
+    previousText: string;
+    nextText: string;
+    timestamp: number;
+}
+export interface StyleUpdateOperation {
+    type: "style.update";
+    slideId: string;
+    elementId: string;
+    propertyName: string;
+    previousValue: string;
+    nextValue: string;
+    timestamp: number;
+}
+export interface AttributeUpdateOperation {
+    type: "attribute.update";
+    slideId: string;
+    elementId: string;
+    attributeName: string;
+    previousValue: string;
+    nextValue: string;
+    timestamp: number;
+}
+export interface ElementLayoutUpdateOperation {
+    type: "element.layout.update";
+    slideId: string;
+    elementId: string;
+    previousStyle: ElementLayoutStyleSnapshot;
+    nextStyle: ElementLayoutStyleSnapshot;
+    timestamp: number;
+}
+export interface ElementInsertOperation {
+    type: "element.insert";
+    slideId: string;
+    elementId: string;
+    parentElementId: string | null;
+    previousSiblingElementId: string | null;
+    nextSiblingElementId: string | null;
+    html: string;
+    timestamp: number;
+}
+export interface ElementRemoveOperation {
+    type: "element.remove";
+    slideId: string;
+    elementId: string;
+    parentElementId: string | null;
+    previousSiblingElementId: string | null;
+    nextSiblingElementId: string | null;
+    html: string;
+    timestamp: number;
+}
+export interface GroupCreateOperation {
+    type: "group.create";
+    slideId: string;
+    groupElementId: string;
+    elementIds: string[];
+    previousHtmlSource: string;
+    nextHtmlSource: string;
+    timestamp: number;
+}
+export interface GroupUngroupOperation {
+    type: "group.ungroup";
+    slideId: string;
+    groupElementId: string;
+    childElementIds: string[];
+    previousHtmlSource: string;
+    nextHtmlSource: string;
+    timestamp: number;
+}
+export type AtomicSlideOperation = TextUpdateOperation | StyleUpdateOperation | AttributeUpdateOperation | ElementLayoutUpdateOperation | ElementInsertOperation | ElementRemoveOperation | GroupCreateOperation | GroupUngroupOperation;
+export interface SlideBatchOperation {
+    type: "operation.batch";
+    slideId: string;
+    operations: AtomicSlideOperation[];
+    timestamp: number;
+}
+export interface SlideCreateOperation {
+    type: "slide.create";
+    slide: SlideModel;
+    index: number;
+    timestamp: number;
+}
+export interface SlideDeleteOperation {
+    type: "slide.delete";
+    slide: SlideModel;
+    index: number;
+    timestamp: number;
+}
+export interface SlideDuplicateOperation {
+    type: "slide.duplicate";
+    sourceSlideId: string;
+    slide: SlideModel;
+    index: number;
+    timestamp: number;
+}
+export interface SlideReorderOperation {
+    type: "slide.reorder";
+    slideId: string;
+    fromIndex: number;
+    toIndex: number;
+    timestamp: number;
+}
+export interface SlideVisibilityUpdateOperation {
+    type: "slide.visibility.update";
+    slideId: string;
+    previousHidden: boolean;
+    nextHidden: boolean;
+    timestamp: number;
+}
+export interface SlideTitleUpdateOperation {
+    type: "slide.title.update";
+    slideId: string;
+    previousTitle: string;
+    nextTitle: string;
+    timestamp: number;
+}
+export type DeckSlideOperation = SlideCreateOperation | SlideDeleteOperation | SlideDuplicateOperation | SlideReorderOperation | SlideVisibilityUpdateOperation | SlideTitleUpdateOperation;
+export type SlideOperation = AtomicSlideOperation | SlideBatchOperation | DeckSlideOperation;

package/dist/slide-operations-helpers.d.ts

@@ -0,0 +1,14 @@
+import { type ElementLayoutStyleSnapshot } from "./layout.js";
+import type { ElementInsertOperation } from "./slide-operation-types.js";
+export declare function updateSlideText(html: string, elementId: string, value: string): string;
+export declare function updateSlideStyle(html: string, elementId: string, propertyName: string, value: string): string;
+export declare function updateSlideAttribute(html: string, elementId: string, attributeName: string, value: string): string;
+export declare function duplicateSlideElement(html: string, sourceElementId: string, nextElementId: string): string;
+export declare function updateSlideElementLayout(html: string, elementId: string, snapshot: ElementLayoutStyleSnapshot): string;
+export declare function createElementPlacement(html: string, elementId: string): Pick<ElementInsertOperation, "parentElementId" | "previousSiblingElementId" | "nextSiblingElementId"> | null;
+export declare function getSlideElementHtml(html: string, elementId: string): string | null;
+export declare function updateSlideElementHtmlIds(elementHtml: string, idMap: Record<string, string>): string;
+export declare function createUniqueElementId(html: string, preferredId: string): string;
+export declare function insertSlideElement(html: string, operation: Pick<ElementInsertOperation, "elementId" | "parentElementId" | "previousSiblingElementId" | "nextSiblingElementId" | "html">): string;
+export declare function removeSlideElement(html: string, elementId: string): string;
+export declare function updateSlideElementTransform(html: string, elementId: string, deltaX: number, deltaY: number): string;

package/dist/slide-operations.d.ts

@@ -0,0 +1,5 @@
+export type { AtomicSlideOperation, AttributeUpdateOperation, ElementInsertOperation, ElementLayoutUpdateOperation, ElementRemoveOperation, GroupCreateOperation, GroupUngroupOperation, SlideBatchOperation, SlideTitleUpdateOperation, SlideOperation, StyleUpdateOperation, TextUpdateOperation, } from "./slide-operation-types.js";
+export type { GroupElementRectMap, ElementPresentationStyleMap } from "./group-operations.js";
+export { createGroupCreateOperation, createGroupUngroupOperation, } from "./group-operations.js";
+export { createElementPlacement, createUniqueElementId, duplicateSlideElement, getSlideElementHtml, insertSlideElement, removeSlideElement, updateSlideAttribute, updateSlideElementHtmlIds, updateSlideElementLayout, updateSlideElementTransform, updateSlideStyle, updateSlideText, } from "./slide-operations-helpers.js";
+export { applySlideOperation, invertSlideOperation } from "./slide-operation-reducer.js";

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@starrykit/slides-core",
+  "version": "0.1.26",
+  "description": "Slide contract, document model, validation, history, operations, and export-planning logic for Starry Slides.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json && tsup src/index.ts --format esm"
+  }
+}