@sobree/core 0.1.0

package/dist/history/types.d.ts

@@ -0,0 +1,54 @@
+/**
+ * History config + depth shape. Phase 1b.6+ — backed by Y.UndoManager;
+ * the snapshot-specific types (HistoryEntry, SnapshotPosition,
+ * SnapshotSelection) that lived here in Phase 1a are no longer needed.
+ */
+export interface HistoryConfig {
+    /** Hard cap on entry count (per stack). UndoManager doesn't expose
+     *  a max-depth knob directly — kept here for forward-compat in case
+     *  we add LRU-trim ourselves; Yjs's UndoManager grows unboundedly
+     *  in practice (one entry per coalesced typing burst, so a long
+     *  session is still bounded). */
+    maxDepth: number;
+    /**
+     * Soft cap on rough memory footprint in bytes. Currently unused
+     * (UndoManager doesn't expose memory introspection); kept for
+     * future tuning. */
+    maxBytesEstimate: number;
+    /**
+     * Idle time within which consecutive Y operations merge into one
+     * undo step (Y.UndoManager's `captureTimeout`). Default 1000ms —
+     * Word-style typing-session coalescing.
+     */
+    coalesceIdleMs: number;
+}
+export declare const DEFAULT_HISTORY_CONFIG: HistoryConfig;
+/** Snapshot of `{undoDepth, redoDepth}` for `History.depth()` + change events. */
+export interface HistoryDepth {
+    undo: number;
+    redo: number;
+}
+/** @deprecated Selection now persists via stable block ids — no
+ *  snapshot conversion is needed. */
+export interface SnapshotPosition {
+    blockIndex: number;
+    offset: number;
+}
+/** @deprecated Pass-through alias to keep older imports compiling. */
+export type SnapshotSelection = null | {
+    kind: "caret";
+    at: SnapshotPosition;
+} | {
+    kind: "range";
+    from: SnapshotPosition;
+    to: SnapshotPosition;
+};
+/** @deprecated Y.UndoManager owns history state; no separate entry
+ *  shape is exposed. Kept as a permissive type alias so any consumer
+ *  that imported `HistoryEntry` keeps compiling. */
+export interface HistoryEntry {
+    doc: unknown;
+    selection: SnapshotSelection | unknown;
+    reason: string;
+    timestamp: number;
+}

package/dist/index.css

@@ -0,0 +1 @@
+.paper-stack{display:flex;flex-direction:column;padding:48px;gap:28px;outline:none}.paper-row{display:flex;flex-direction:row;align-items:flex-start;gap:24px}.paper{position:relative;background:#fff;border:1px solid rgba(0,0,0,.3);box-shadow:0 1px 2px #00000014,0 18px 60px #0000001f;padding-top:var(--margin-top, 25mm);padding-right:var(--margin-right, 20mm);padding-bottom:var(--margin-bottom, 25mm);padding-left:var(--margin-left, 20mm);overflow:hidden;flex:none}.paper-header,.paper-footer{position:absolute;left:var(--margin-left, 20mm);right:var(--margin-right, 20mm);font-size:10pt;color:#555;white-space:pre-wrap}.paper-header{top:0;min-height:var(--margin-top, 25mm);padding-top:var(--header-offset-mm, 12.7mm);padding-bottom:4mm;border-bottom:1px dashed transparent}.paper-footer{bottom:0;min-height:var(--margin-bottom, 25mm);padding-top:4mm;text-align:center;border-top:1px dashed transparent}.paper-anchors{position:absolute;top:var(--margin-top, 25mm);right:var(--margin-right, 20mm);bottom:var(--margin-bottom, 25mm);left:var(--margin-left, 20mm);pointer-events:none;isolation:isolate;z-index:1}.paper-anchors.is-empty{display:none}.paper-anchor{position:absolute;box-sizing:border-box;overflow:hidden}.paper-header>p,.paper-footer>p,.paper-header>ul,.paper-header>ol,.paper-footer>ul,.paper-footer>ol{margin:0}.paper-footnotes{position:absolute;left:var(--margin-left, 20mm);right:var(--margin-right, 20mm);bottom:var(--margin-bottom, 25mm);font-size:.85em;padding-top:.5em;border-top:1pt solid currentColor;background:#fffffff5;z-index:1;max-height:40%;overflow:hidden}.paper-footnotes.is-empty{display:none}.paper-comments{flex:0 0 70mm;max-width:70mm;font-size:.85em;padding:0 .5em;align-self:stretch;overflow-y:auto}.paper-comments.is-empty{display:none}.paper-footnotes .sobree-footnotes__list{margin:0;padding-left:1.5em}.paper-footnotes .sobree-footnotes__item{margin:.25em 0}.paper-content{position:relative;height:100%;min-height:100px;display:flex;flex-direction:column;justify-content:flex-start}.paper-content td p:not([style*=line-height]),.paper-content td li:not([style*=line-height]),.paper-content th p:not([style*=line-height]),.paper-content th li:not([style*=line-height]){line-height:1}.paper-content td p:not([style*=margin]),.paper-content th p:not([style*=margin]){margin:0}.paper-content ul.sobree-list-custom-bullet>li::marker,.paper-content ol.sobree-list-custom-bullet>li::marker{content:var(--sobree-bullet-glyph) "  "}.paper-content .sobree-tab-spread{display:flex;justify-content:space-between;align-items:baseline;gap:1em;white-space:nowrap}.paper-content .sobree-tab-spread .sobree-tab-spread__before,.paper-content .sobree-tab-spread .sobree-tab-spread__after{white-space:pre-wrap;min-width:0}.paper-content table.sobree-table-bordered td,.paper-content table.sobree-table-bordered th{border:var(--table-cell-border, none);padding:0 4px}.sobree-editor{position:relative;outline:none}.sobree-editor>:first-child{margin-top:0}.sobree-editor p,.sobree-editor h1,.sobree-editor h2,.sobree-editor h3,.sobree-editor h4,.sobree-editor h5,.sobree-editor h6,.sobree-editor ul,.sobree-editor ol,.sobree-editor li,.sobree-editor blockquote,.sobree-editor pre{margin:0;padding:0}.sobree-editor ul,.sobree-editor ol{padding-left:1.5em}.sobree-editor li.sobree-li-continuation{list-style-type:none}.sobree-editor li.sobree-li-continuation::marker{content:""}.sobree-editor .sobree-fragment-continued{text-align-last:justify}.sobree-editor .sobree-footnote-ref a{color:inherit;text-decoration:none}.sobree-editor .sobree-footnote-ref a:hover{text-decoration:underline}.sobree-editor .sobree-footnotes{margin-top:2em;padding-top:.5em;border-top:1pt solid currentColor;font-size:.85em}.sobree-editor .sobree-footnotes__list{padding-left:1.5em}.sobree-editor .sobree-footnotes__item{margin:.25em 0}.sobree-editor ins.sobree-revision-ins{text-decoration:underline}.sobree-editor del.sobree-revision-del{text-decoration:line-through}.sobree-editor .sobree-revision-format{text-decoration:underline dashed var(--sobree-format-revision-color, currentColor);text-underline-offset:3px}.sobree-editor [data-block-revision=ins]:after,.sobree-editor [data-block-revision=del]:after{content:" ¶";color:var(--sobree-block-revision-color, currentColor);opacity:.65;font-weight:600;-webkit-user-select:none;user-select:none}.sobree-editor [data-block-revision=del]:after{text-decoration:line-through}.sobree-editor .sobree-comment-range{background:var(--sobree-comment-range-bg, rgba(255, 217, 0, .25));border-bottom:1px dotted var(--sobree-comment-range-border, rgba(180, 130, 0, .5))}.sobree-editor .sobree-comment-ref{display:inline;font-size:.85em;margin:0 .1em}.sobree-editor .sobree-comment-ref a{color:inherit;text-decoration:none}.sobree-editor .sobree-comment-ref a:hover{filter:brightness(.7)}.sobree-editor h1,.sobree-editor h2,.sobree-editor h3,.sobree-editor h4,.sobree-editor h5,.sobree-editor h6{font-size:inherit;font-weight:inherit}.sobree-editor table{border-collapse:collapse;width:100%;position:relative}.sobree-editor th,.sobree-editor td{border:none;padding:0 .08in;vertical-align:top;transition:border-color .12s ease}.sobree-editor .sobree-section-break{display:flex;align-items:center;gap:8px;margin:8px 0;color:var(--fg-subtle, #7c7764);font-size:11px;letter-spacing:.04em;text-transform:uppercase;-webkit-user-select:none;user-select:none}.sobree-editor .sobree-section-break--continuous{visibility:hidden;height:0;margin:0;padding:0;border:none;overflow:hidden;font-size:0;line-height:0}.sobree-editor .sobree-section-break:before,.sobree-editor .sobree-section-break:after{content:"";flex:1;border-top:1px dashed var(--border, #dedbd0)}.sobree-editor .sobree-section-break__label{flex:none;padding:0 6px;background:var(--bg-elevated, #fff)}.sobree-editor .sobree-textbox-frame p{line-height:1.2}.sobree-editor .paper-content p,.sobree-editor .paper-content li,.sobree-editor .paper-header p,.sobree-editor .paper-header li,.sobree-editor .paper-footer p,.sobree-editor .paper-footer li,.sobree-editor .sobree-textbox-frame p{white-space:pre-wrap}.sobree-editor .sobree-section-trailer-empty{height:0;line-height:0;font-size:0;margin:0;padding:0;overflow:hidden}.sobree-editor .sobree-textbox-frame--placeholder{border:1px solid var(--border, #c8c4b8)}.sobree-editor .sobree-textbox-frame--placeholder.sobree-textbox-frame--filled{border:none;z-index:-1}.sobree-editor img.is-selected{outline:2px solid var(--sobree-primary, #d4521f);outline-offset:2px}.sobree-image-resize-handle{position:absolute;width:16px;height:16px;background:var(--sobree-primary, #d4521f);border:2px solid #fff;border-radius:3px;cursor:nwse-resize;z-index:1000;-webkit-user-select:none;user-select:none}.sobree-viewport{position:relative;overflow:hidden;overscroll-behavior:contain;touch-action:none;background:#ececee}.sobree-viewport__stage{position:absolute;top:0;left:0;transform-origin:0 0;will-change:transform}.sobree-viewport__stage.is-animating{transition:transform .32s cubic-bezier(.2,.7,.2,1)}.sobree-viewport__slot{display:block}.paper-stack .paper-content,.paper-stack .paper-header,.paper-stack .paper-footer{transition:opacity .2s ease}.paper-stack.is-zone-editing .paper-content,.paper-stack.is-zone-editing .paper-header,.paper-stack.is-zone-editing .paper-footer{opacity:.2}.paper-stack.is-zone-editing .paper-header[contenteditable=true],.paper-stack.is-zone-editing .paper-footer[contenteditable=true]{opacity:1}.paper-header[contenteditable=true],.paper-footer[contenteditable=true]{outline:2px dotted var(--primary, #c96f22);outline-offset:4px;background:var(--primary-soft, #fdf6ee);color:var(--fg-strong, #14130f);border-radius:2px}

package/dist/index.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @sobree/core — public surface.
+ *
+ * The kernel: framework-free Editor + AST + serializers, the paginated
+ * paper stack, the floating block tools, header /
+ * footer zone editor, and the `Sobree` façade that composes them.
+ *
+ * Embedders typically only need:
+ *
+ *   import { createSobree } from "@sobree/core";
+ *   import "@sobree/core/tokens.css";
+ */
+export { createSobree } from './createSobree';
+export type { CreateSobreeOptions, SobreeContent, SobreeHandle, } from './createSobree';
+export { parseMarkdown } from './markdown/parse';
+export { Sobree } from './sobree';
+export type { SobreeMode, SobreeOptions, SobreeEvent, SobreeEventPayload, SobreeUnsubscribe, } from './sobree';
+export type { SobreePlugin, SobreePluginInstance, PluginContext, } from './plugin';
+export { Editor } from './editor';
+export type { ApiRangeType, RevisionSpan, BlockInfo, ChangePayload, CommandBus, CommandDefinition, CommandSnapshot, EditorEvent, EditorEventPayload, EditorOptions, EditError, EditResult, KeyDownPayload, OutlineItem, ParagraphPropertiesPatch, RunPropertiesPatch, SelectionPayload, TrackChangesState, Unsubscribe, WrapTag, CellRef, InsertAt, InsertColumnOpts, InsertRowOpts, MergeCellsOpts, } from './editor';
+export * from './doc/types';
+export * from './doc/builders';
+export { resolveStyleCascade } from './doc/styles';
+export { collectLivePartPaths, pruneOrphanParts } from './doc/parts';
+export { embedFontIntoDoc, removeFontFromDoc, FontFaceRegistry, generateFontKey, obfuscate, deobfuscate, isUnobfuscated, canEmbed, readFsType, } from './fonts';
+export type { EmbedFontFaces, EmbedFontOptions, EmbedFontResult, EmbedMode, FsTypeReport, } from './fonts';
+export { DEFAULT_HISTORY_CONFIG, History } from './history';
+export type { HistoryConfig, HistoryDepth, HistoryEvent, HistoryListener, } from './history';
+export { templateToBlocks, blocksToTemplate, pageSetupToSection, sectionToPageSetup } from './doc/pageSetupBridge';
+export type { Selection, BlockRef, InlinePosition, Range } from './doc/api';
+export { PaperStack } from './paperStack/paperStack';
+export { Paper } from './paperStack/paper';
+export { PAGE_SIZES, DEFAULT_PAGE_SETUP, resolvedDimensions, substituteVariables, zoneTemplateFor, } from './paperStack/pageSetup';
+export type { PageSetup, PageSizeKey, PageZoneText, VerticalAlign, Orientation, Margins } from './paperStack/pageSetup';
+export { Viewport } from './embed/viewport';
+export type { ViewportOptions } from './embed/viewport';
+export { getFloatingCorner } from './embed/floatingCorner';
+export type { FloatingCornerPlacement } from './embed/floatingCorner';
+export { attachSections } from './plugins/sections';
+export { MARK_COMMAND_DEFS, MARK_PROP, MARK_ON, toggleMark, isMarkActive, rangeAtSelection, } from './plugins/marks';
+export type { MarkCommandDef, ToggleableMark } from './plugins/marks';
+export { enterZoneEdit } from './zoneEdit';
+export type { ZoneKind, EnterZoneEditOptions } from './zoneEdit';
+export { Y_BLOCK_AST_KEY, Y_BLOCK_ID_KEY, Y_BLOCK_KIND_KEY, Y_BLOCK_PROPS_KEY, Y_BLOCK_TEXT_KEY, Y_BODY_KEY, Y_META_FIELDS, Y_META_KEY, Y_PARTS_KEY, applyDocumentToYDoc, buildBlockYMap, diffApplyText, populateParagraphYMap, projectBlock, projectYDoc, seedYDoc, } from './ydoc';
+export { attrsToRunProps, deltaToRuns, runPropsToAttrs, runsToDelta, } from './ydoc';
+export type { DeltaOp, EmbedContent, LinkMark } from './ydoc';
+export { BlobCache, BlobStoreError, fetchBlobStore, inMemoryBlobStore, isBlobHash, sha256Hex, } from './blob';
+export type { BlobCacheOptions, BlobHash, BlobStore, FetchBlobStoreOptions, } from './blob';
+export { HeadlessSobree } from './headless';
+export type { HeadlessChangePayload, HeadlessEvent, HeadlessSobreeOptions, HeadlessUnsubscribe, } from './headless';
+export { attachPresence, attachPresenceOverlay, isPresenceState, presenceSelectionFromEditor, } from './presence';
+export type { AttachPresenceOptions, AttachPresenceOverlayOptions, AwarenessChanges, AwarenessLike, PresenceHandle, PresenceOverlayHandle, PresenceSelection, PresenceState, PresenceUser, } from './presence';