@stll/folio-core 0.0.1-placeholder.0 → 0.1.0

package/dist/types/index.d.ts

@@ -0,0 +1,107 @@
+import { document_d_exports } from "./document.js";
+type AbstractNumbering = document_d_exports.AbstractNumbering;
+type BlockContent = document_d_exports.BlockContent;
+type BookmarkEnd = document_d_exports.BookmarkEnd;
+type BookmarkStart = document_d_exports.BookmarkStart;
+type BorderSpec = document_d_exports.BorderSpec;
+type BreakContent = document_d_exports.BreakContent;
+type CellMargins = document_d_exports.CellMargins;
+type ColorValue = document_d_exports.ColorValue;
+type Column = document_d_exports.Column;
+type ComplexField = document_d_exports.ComplexField;
+type ConditionalFormatStyle = document_d_exports.ConditionalFormatStyle;
+type DocDefaults = document_d_exports.DocDefaults;
+type Document = document_d_exports.Document;
+type DocumentBody = document_d_exports.DocumentBody;
+type DocxPackage = document_d_exports.DocxPackage;
+type DrawingContent = document_d_exports.DrawingContent;
+type EmphasisMark = document_d_exports.EmphasisMark;
+type Endnote = document_d_exports.Endnote;
+type EndnotePosition = document_d_exports.EndnotePosition;
+type EndnoteProperties = document_d_exports.EndnoteProperties;
+type Field = document_d_exports.Field;
+type FieldCharContent = document_d_exports.FieldCharContent;
+type FieldType = document_d_exports.FieldType;
+type FloatingTableProperties = document_d_exports.FloatingTableProperties;
+type FontInfo = document_d_exports.FontInfo;
+type FontTable = document_d_exports.FontTable;
+type FooterReference = document_d_exports.FooterReference;
+type Footnote = document_d_exports.Footnote;
+type FootnotePosition = document_d_exports.FootnotePosition;
+type FootnoteProperties = document_d_exports.FootnoteProperties;
+type HeaderFooter = document_d_exports.HeaderFooter;
+type HeaderFooterType = document_d_exports.HeaderFooterType;
+type HeaderReference = document_d_exports.HeaderReference;
+type Hyperlink = document_d_exports.Hyperlink;
+type Image = document_d_exports.Image;
+type ImageCrop = document_d_exports.ImageCrop;
+type ImagePadding = document_d_exports.ImagePadding;
+type ImagePosition = document_d_exports.ImagePosition;
+type ImageSize = document_d_exports.ImageSize;
+type ImageTransform = document_d_exports.ImageTransform;
+type ImageWrap = document_d_exports.ImageWrap;
+type InstrTextContent = document_d_exports.InstrTextContent;
+type LevelSuffix = document_d_exports.LevelSuffix;
+type LineNumberRestart = document_d_exports.LineNumberRestart;
+type LineSpacingRule = document_d_exports.LineSpacingRule;
+type ListLevel = document_d_exports.ListLevel;
+type ListRendering = document_d_exports.ListRendering;
+type MediaFile = document_d_exports.MediaFile;
+type NoBreakHyphenContent = document_d_exports.NoBreakHyphenContent;
+type NoteNumberRestart = document_d_exports.NoteNumberRestart;
+type NoteReferenceContent = document_d_exports.NoteReferenceContent;
+type NumberFormat = document_d_exports.NumberFormat;
+type NumberingDefinitions = document_d_exports.NumberingDefinitions;
+type NumberingInstance = document_d_exports.NumberingInstance;
+type PageOrientation = document_d_exports.PageOrientation;
+type Paragraph = document_d_exports.Paragraph;
+type ParagraphAlignment = document_d_exports.ParagraphAlignment;
+type ParagraphContent = document_d_exports.ParagraphContent;
+type ParagraphFormatting = document_d_exports.ParagraphFormatting;
+type Relationship = document_d_exports.Relationship;
+type RelationshipMap = document_d_exports.RelationshipMap;
+type RelationshipType = document_d_exports.RelationshipType;
+type Run = document_d_exports.Run;
+type RunContent = document_d_exports.RunContent;
+type Section = document_d_exports.Section;
+type SectionProperties = document_d_exports.SectionProperties;
+type SectionStart = document_d_exports.SectionStart;
+type ShadingProperties = document_d_exports.ShadingProperties;
+type Shape = document_d_exports.Shape;
+type ShapeContent = document_d_exports.ShapeContent;
+type ShapeFill = document_d_exports.ShapeFill;
+type ShapeOutline = document_d_exports.ShapeOutline;
+type ShapeTextBody = document_d_exports.ShapeTextBody;
+type ShapeType = document_d_exports.ShapeType;
+type SimpleField = document_d_exports.SimpleField;
+type SoftHyphenContent = document_d_exports.SoftHyphenContent;
+type Style = document_d_exports.Style;
+type StyleDefinitions = document_d_exports.StyleDefinitions;
+type StyleType = document_d_exports.StyleType;
+type SymbolContent = document_d_exports.SymbolContent;
+type TabContent = document_d_exports.TabContent;
+type TabLeader = document_d_exports.TabLeader;
+type TabStop = document_d_exports.TabStop;
+type TabStopAlignment = document_d_exports.TabStopAlignment;
+type Table = document_d_exports.Table;
+type TableBorders = document_d_exports.TableBorders;
+type TableCell = document_d_exports.TableCell;
+type TableCellFormatting = document_d_exports.TableCellFormatting;
+type TableFormatting = document_d_exports.TableFormatting;
+type TableLook = document_d_exports.TableLook;
+type TableMeasurement = document_d_exports.TableMeasurement;
+type TableRow = document_d_exports.TableRow;
+type TableRowFormatting = document_d_exports.TableRowFormatting;
+type TableWidthType = document_d_exports.TableWidthType;
+type TextBox = document_d_exports.TextBox;
+type TextContent = document_d_exports.TextContent;
+type TextEffect = document_d_exports.TextEffect;
+type TextFormatting = document_d_exports.TextFormatting;
+type Theme = document_d_exports.Theme;
+type ThemeColorScheme = document_d_exports.ThemeColorScheme;
+type ThemeColorSlot = document_d_exports.ThemeColorSlot;
+type ThemeFont = document_d_exports.ThemeFont;
+type ThemeFontScheme = document_d_exports.ThemeFontScheme;
+type UnderlineStyle = document_d_exports.UnderlineStyle;
+type VerticalAlign = document_d_exports.VerticalAlign;
+export type { AbstractNumbering, BlockContent, BookmarkEnd, BookmarkStart, BorderSpec, BreakContent, CellMargins, ColorValue, Column, ComplexField, ConditionalFormatStyle, DocDefaults, Document, DocumentBody, DocxPackage, DrawingContent, EmphasisMark, Endnote, EndnotePosition, EndnoteProperties, Field, FieldCharContent, FieldType, FloatingTableProperties, FontInfo, FontTable, FooterReference, Footnote, FootnotePosition, FootnoteProperties, HeaderFooter, HeaderFooterType, HeaderReference, Hyperlink, Image, ImageCrop, ImagePadding, ImagePosition, ImageSize, ImageTransform, ImageWrap, InstrTextContent, LevelSuffix, LineNumberRestart, LineSpacingRule, ListLevel, ListRendering, MediaFile, NoBreakHyphenContent, NoteNumberRestart, NoteReferenceContent, NumberFormat, NumberingDefinitions, NumberingInstance, PageOrientation, Paragraph, ParagraphAlignment, ParagraphContent, ParagraphFormatting, Relationship, RelationshipMap, RelationshipType, Run, RunContent, Section, SectionProperties, SectionStart, ShadingProperties, Shape, ShapeContent, ShapeFill, ShapeOutline, ShapeTextBody, ShapeType, SimpleField, SoftHyphenContent, Style, StyleDefinitions, StyleType, SymbolContent, TabContent, TabLeader, TabStop, TabStopAlignment, Table, TableBorders, TableCell, TableCellFormatting, TableFormatting, TableLook, TableMeasurement, TableRow, TableRowFormatting, TableWidthType, TextBox, TextContent, TextEffect, TextFormatting, Theme, ThemeColorScheme, ThemeColorSlot, ThemeFont, ThemeFontScheme, UnderlineStyle, VerticalAlign };

package/dist/utils/authorColors.d.ts

@@ -0,0 +1,16 @@
+//#region src/utils/authorColors.d.ts
+/**
+ * Author Color Assignment for Tracked Changes
+ *
+ * Word-style per-author colors. The first unique author seen gets red (#c00000),
+ * the second gets blue, etc. Assignment is deterministic within a document
+ * session: the same author always receives the same color.
+ */
+/** Word-style tracked change author colors (5-color rotation) */
+declare const AUTHOR_COLORS: readonly ["#c00000", "#2f5496", "#538135", "#7030a0", "#bf8f00"];
+/** Returns a stable color index (0..4) for a given author name */
+declare const getAuthorColorIdx: (author: string) => number;
+/** Reset the author-to-color mapping (e.g., when loading a new document) */
+declare const resetAuthorColors: () => void;
+//#endregion
+export { AUTHOR_COLORS, getAuthorColorIdx, resetAuthorColors };

package/dist/utils/authorColors.js

@@ -0,0 +1,30 @@
+//#region src/utils/authorColors.ts
+/**
+* Author Color Assignment for Tracked Changes
+*
+* Word-style per-author colors. The first unique author seen gets red (#c00000),
+* the second gets blue, etc. Assignment is deterministic within a document
+* session: the same author always receives the same color.
+*/
+/** Word-style tracked change author colors (5-color rotation) */
+const AUTHOR_COLORS = [
+	"#c00000",
+	"#2f5496",
+	"#538135",
+	"#7030a0",
+	"#bf8f00"
+];
+const authorColorMap = /* @__PURE__ */ new Map();
+/** Returns a stable color index (0..4) for a given author name */
+const getAuthorColorIdx = (author) => {
+	if (!authorColorMap.has(author)) authorColorMap.set(author, authorColorMap.size % AUTHOR_COLORS.length);
+	const idx = authorColorMap.get(author);
+	if (idx === void 0) return 0;
+	return idx;
+};
+/** Reset the author-to-color mapping (e.g., when loading a new document) */
+const resetAuthorColors = () => {
+	authorColorMap.clear();
+};
+//#endregion
+export { AUTHOR_COLORS, getAuthorColorIdx, resetAuthorColors };

package/dist/utils/baseDirection.d.ts

@@ -0,0 +1,23 @@
+//#region src/utils/baseDirection.d.ts
+/**
+ * First-strong base-direction detection (the Unicode `dir="auto"` rule).
+ *
+ * Scans text for the first *strong* directional signal — an explicit bidi
+ * control (RLM / ALM => RTL, LRM => LTR) or the first letter (`\p{L}`) — and
+ * reports the base paragraph direction it implies. Digits, combining marks,
+ * punctuation and whitespace are weak/neutral and skipped. Text with no strong
+ * character returns `null` (undecided; the caller decides the default).
+ *
+ * Shared by the layout painter (paragraph base direction) and the auto-bidi
+ * detector (sets `w:bidi` on Arabic/Hebrew-led paragraphs that arrived without
+ * an explicit direction flag).
+ */
+declare const RTL_STRONG_LETTER: RegExp;
+type BaseDirection = "rtl" | "ltr";
+/**
+ * Resolve the first-strong base direction of `text`, or `null` when the text
+ * carries no strong directional character.
+ */
+declare function detectBaseDirection(text: string): BaseDirection | null;
+//#endregion
+export { BaseDirection, RTL_STRONG_LETTER, detectBaseDirection };

package/dist/utils/baseDirection.js

@@ -0,0 +1,34 @@
+//#region src/utils/baseDirection.ts
+/**
+* First-strong base-direction detection (the Unicode `dir="auto"` rule).
+*
+* Scans text for the first *strong* directional signal — an explicit bidi
+* control (RLM / ALM => RTL, LRM => LTR) or the first letter (`\p{L}`) — and
+* reports the base paragraph direction it implies. Digits, combining marks,
+* punctuation and whitespace are weak/neutral and skipped. Text with no strong
+* character returns `null` (undecided; the caller decides the default).
+*
+* Shared by the layout painter (paragraph base direction) and the auto-bidi
+* detector (sets `w:bidi` on Arabic/Hebrew-led paragraphs that arrived without
+* an explicit direction flag).
+*/
+const RTL_STRONG_LETTER = /[\p{Script=Hebrew}\p{Script=Arabic}\p{Script=Syriac}\p{Script=Thaana}\p{Script=Nko}\p{Script=Samaritan}\p{Script=Mandaic}\p{Script=Adlam}]/u;
+const LETTER = /\p{L}/u;
+const RLM = 8207;
+const ALM = 1564;
+const LRM = 8206;
+/**
+* Resolve the first-strong base direction of `text`, or `null` when the text
+* carries no strong directional character.
+*/
+function detectBaseDirection(text) {
+	for (const ch of text) {
+		const cp = ch.codePointAt(0);
+		if (cp === RLM || cp === ALM) return "rtl";
+		if (cp === LRM) return "ltr";
+		if (LETTER.test(ch)) return RTL_STRONG_LETTER.test(ch) ? "rtl" : "ltr";
+	}
+	return null;
+}
+//#endregion
+export { RTL_STRONG_LETTER, detectBaseDirection };

package/dist/utils/clipboard.d.ts

@@ -0,0 +1,126 @@
+import { document_d_exports } from "../types/document.js";
+
+//#region src/utils/clipboard.d.ts
+/**
+ * Clipboard content format
+ */
+type ClipboardContent = {
+  /** Plain text representation */plainText: string; /** HTML representation */
+  html: string; /** Internal format (JSON) for preserving full formatting */
+  internal?: string;
+};
+/**
+ * Parsed clipboard content
+ */
+type ParsedClipboardContent = {
+  /** Runs parsed from clipboard */runs: document_d_exports.Run[]; /** Whether content came from Word */
+  fromWord: boolean; /** Whether content came from our editor */
+  fromEditor: boolean; /** Original plain text */
+  plainText: string;
+};
+/**
+ * Options for clipboard operations
+ */
+type ClipboardOptions = {
+  /** Whether to include formatting in copy */includeFormatting?: boolean; /** Whether to clean Word-specific formatting */
+  cleanWordFormatting?: boolean; /** Callback for handling errors */
+  onError?: (error: Error) => void;
+};
+/**
+ * Custom MIME type for internal clipboard format
+ */
+declare const INTERNAL_CLIPBOARD_TYPE = "application/x-stella-folio";
+/**
+ * Standard clipboard MIME types
+ */
+declare const CLIPBOARD_TYPES: {
+  readonly HTML: "text/html";
+  readonly PLAIN: "text/plain";
+};
+/**
+ * Extract image files from clipboard data (if present).
+ */
+type ClipboardDataLike = {
+  files?: FileList | readonly File[] | undefined;
+  items?: DataTransferItemList | readonly DataTransferItem[] | undefined;
+};
+declare function getClipboardImageFiles(clipboardData: ClipboardDataLike | null): File[];
+/**
+ * Copy runs to clipboard with formatting
+ */
+declare function copyRuns(runs: document_d_exports.Run[], options?: ClipboardOptions): Promise<boolean>;
+/**
+ * Copy paragraphs to clipboard with formatting
+ */
+declare function copyParagraphs(paragraphs: document_d_exports.Paragraph[], options?: ClipboardOptions): Promise<boolean>;
+/**
+ * Convert runs to clipboard content (HTML and plain text)
+ */
+declare function runsToClipboardContent(runs: document_d_exports.Run[], includeFormatting?: boolean): ClipboardContent;
+/**
+ * Convert paragraphs to clipboard content
+ */
+declare function paragraphsToClipboardContent(paragraphs: document_d_exports.Paragraph[], includeFormatting?: boolean): ClipboardContent;
+/**
+ * Write content to clipboard
+ */
+declare function writeToClipboard(content: ClipboardContent): Promise<boolean>;
+/**
+ * Read content from clipboard
+ */
+declare function readFromClipboard(options?: ClipboardOptions): Promise<ParsedClipboardContent | null>;
+/**
+ * Handle paste event
+ */
+declare function handlePasteEvent(event: ClipboardEvent, options?: ClipboardOptions): ParsedClipboardContent | null;
+/**
+ * Parse HTML from clipboard
+ */
+declare function parseClipboardHtml(html: string, plainText: string, cleanWordFormatting?: boolean): ParsedClipboardContent;
+/**
+ * Check if HTML is from Microsoft Word
+ */
+declare function isWordHtml(html: string): boolean;
+/**
+ * Check if HTML is from our editor
+ */
+declare function isEditorHtml(html: string): boolean;
+/**
+ * Clean Microsoft Word HTML
+ */
+declare function cleanWordHtml(html: string): string;
+/**
+ * Convert HTML to runs
+ */
+declare function htmlToRuns(html: string, plainTextFallback: string): document_d_exports.Run[];
+/**
+ * Create clipboard keyboard handlers for an editor
+ */
+declare function createClipboardHandlers(options: {
+  onCopy?: () => {
+    runs: document_d_exports.Run[];
+  } | null;
+  onCut?: () => {
+    runs: document_d_exports.Run[];
+  } | null;
+  onPaste?: (content: ParsedClipboardContent) => void;
+  clipboardOptions?: ClipboardOptions;
+}): {
+  handleCopy: (event: ClipboardEvent) => Promise<void>;
+  handleCut: (event: ClipboardEvent) => Promise<void>;
+  handlePaste: (event: ClipboardEvent) => void;
+  handleKeyDown: (event: KeyboardEvent) => Promise<void>;
+};
+declare const _default: {
+  copyRuns: typeof copyRuns;
+  copyParagraphs: typeof copyParagraphs;
+  readFromClipboard: typeof readFromClipboard;
+  handlePasteEvent: typeof handlePasteEvent;
+  htmlToRuns: typeof htmlToRuns;
+  cleanWordHtml: typeof cleanWordHtml;
+  isWordHtml: typeof isWordHtml;
+  isEditorHtml: typeof isEditorHtml;
+  createClipboardHandlers: typeof createClipboardHandlers;
+};
+//#endregion
+export { CLIPBOARD_TYPES, ClipboardContent, ClipboardOptions, INTERNAL_CLIPBOARD_TYPE, ParsedClipboardContent, cleanWordHtml, copyParagraphs, copyRuns, createClipboardHandlers, _default as default, getClipboardImageFiles, handlePasteEvent, htmlToRuns, isEditorHtml, isWordHtml, paragraphsToClipboardContent, parseClipboardHtml, readFromClipboard, runsToClipboardContent, writeToClipboard };