oasis-editor 0.0.30 → 0.0.32

package/dist/core/editorState.d.ts

@@ -1,6 +1,12 @@
 import { EditorAsset, EditorBlockNode, EditorDocument, EditorFootnote, EditorPageSettings, EditorParagraphNode, EditorSection, EditorState, EditorTableCellNode, EditorTableNode, EditorTableRowNode, EditorTextRun, EditorTextStyle, EditorTextBoxData, EditorImageRunData, EditorNamedStyle } from './model.js';
 
-export declare function resetEditorIds(): void;
+export type EditorNodeKind = "document" | "paragraph" | "run" | "table" | "table-row" | "table-cell" | "footnote" | "bookmark" | "comment";
+/**
+ * Single authority for editor node IDs. Stateless and globally unique, so two
+ * editors mounted on the same page never share a sequence. The `kind` prefix is
+ * kept purely for debuggability; no code parses it for ordering or numbering.
+ */
+export declare function createEditorNodeId(kind: EditorNodeKind): string;
 export declare function createEditorBookmarkId(): string;
 export declare function createEditorCommentId(): string;
 export declare function createEditorRun(text?: string): EditorTextRun;

package/dist/core/endnotes.d.ts

@@ -1,7 +1,5 @@
 import { EditorBlockNode, EditorDocument, EditorEndnote, EditorEndnotes, EditorParagraphNode, EditorTextRun } from './model.js';
 
-export declare function resetEndnoteIds(): void;
-export declare function createEndnoteId(): string;
 /**
  * Iterate every paragraph in document order (endnote bodies excluded), yielding
  * each endnote reference run with its owning paragraph. Order matches reading

package/dist/core/footnotes.d.ts

@@ -1,7 +1,5 @@
 import { EditorBlockNode, EditorDocument, EditorFootnote, EditorFootnoteNumberFormat, EditorFootnotes, EditorParagraphNode, EditorTextRun } from './model.js';
 
-export declare function resetFootnoteIds(): void;
-export declare function createFootnoteId(): string;
 /**
  * Iterate every paragraph in document order (sections + footnotes excluded),
  * yielding each footnote reference run along with the owning paragraph. Order

package/dist/core/model/index.d.ts

@@ -29,4 +29,5 @@ export { getDocumentSections, getDocumentSectionsCanonical, } from './documentSe
 export { DocumentIndexBuilder, getDocumentParagraphIndex, getDocumentParagraphs, getDocumentParagraphsCanonical, getParagraphById, findParagraphLocation, findParagraphTableLocation, WeakMapDocumentIndexCache, } from './documentIndex.js';
 export type { EditorParagraphLocation, TableLocation, DocumentParagraphIndexEntry, DocumentIndexCache, } from './documentIndex.js';
 export { getBlockParagraphs, collectSectionParagraphs, } from './paragraphWalker.js';
+export { buildListLabels, resolveListLabel } from './listNumbering.js';
 export { getActiveSectionIndex, getActiveZone, getEditableBlocksForZone, tryGetEditableBlocksForZone, getActiveSectionBlocks, getParagraphs, } from './editingZones.js';

package/dist/core/model/listNumbering.d.ts

@@ -0,0 +1,5 @@
+import { EditorDocument } from './types/document.js';
+import { EditorParagraphNode } from './types/nodes.js';
+
+export declare function buildListLabels(document: EditorDocument): Map<string, string>;
+export declare function resolveListLabel(paragraph: EditorParagraphNode, labels: Map<string, string>): string;

package/dist/core/model/types/primitives.d.ts

@@ -26,8 +26,18 @@ export interface EditorTabStop {
 export interface EditorParagraphListStyle {
     kind: "bullet" | "ordered";
     level?: number;
+    /** Imported OOXML `w:numId`; paragraphs sharing it use the same counters. */
+    instanceId?: string;
     format?: "decimal" | "lowerLetter" | "upperLetter" | "lowerRoman" | "upperRoman" | "bullet";
     startAt?: number;
+    /** Effective `w:lvlText` pattern, for example `%1.%2.`. */
+    levelText?: string;
+    /** Effective formats for referenced levels in a multilevel label. */
+    levelFormats?: Array<"decimal" | "lowerLetter" | "upperLetter" | "lowerRoman" | "upperRoman" | "bullet">;
+    /** `w:lvlJc`: alignment of the label inside its hanging-indent area. */
+    alignment?: "left" | "center" | "right";
+    /** `w:isLgl`: render referenced ordered levels with decimal digits. */
+    legal?: boolean;
     /**
      * Separator between the list label and the paragraph text (`w:lvl/w:suff`).
      * OOXML default is "tab"; Word renders the label, then advances to the next

package/dist/export/docx/docxTypes.d.ts

@@ -2,16 +2,23 @@ import { EditorBlockNode, EditorImageCrop, EditorImageFillMode, EditorImageFloat
 import { BookmarkEventsByParagraph } from './bookmarksXml.js';
 import { CommentEventsByParagraph } from './commentsXml.js';
 
-export interface NumberingDefinition {
+export interface NumberingLevelDefinition {
     kind: EditorParagraphListStyle["kind"];
     level: number;
-    abstractNumId: number;
-    numId: number;
     format?: NonNullable<EditorParagraphListStyle["format"]>;
     startAt?: number;
+    levelText?: string;
+    suffix?: EditorParagraphListStyle["suffix"];
+    alignment?: EditorParagraphListStyle["alignment"];
+    legal?: boolean;
     bulletGlyph?: string;
     bulletFont?: string;
 }
+export interface NumberingDefinition {
+    abstractNumId: number;
+    numId: number;
+    levels: NumberingLevelDefinition[];
+}
 export interface DocContext {
     numberingInfo: Map<string, {
         numId: number;

package/dist/export/pdf/draw/drawBlockList.d.ts

@@ -2,4 +2,4 @@ import { EditorDocument, EditorLayoutBlock, EditorPageSettings } from '../../../
 import { PdfFontRegistry } from '../fonts/PdfFontRegistry.js';
 import { OasisPdfWriter } from '../OasisPdfWriter.js';
 
-export declare function drawBlockList(writer: OasisPdfWriter, pageIndex: number, blocks: EditorLayoutBlock[] | undefined, document: EditorDocument, originX: number, originY: number, contentWidth: number, fontRegistry: PdfFontRegistry, listOrdinals: Map<string, number>, pageSettings?: EditorPageSettings): Promise<void>;
+export declare function drawBlockList(writer: OasisPdfWriter, pageIndex: number, blocks: EditorLayoutBlock[] | undefined, document: EditorDocument, originX: number, originY: number, contentWidth: number, fontRegistry: PdfFontRegistry, listOrdinals: Map<string, string>, pageSettings?: EditorPageSettings): Promise<void>;

package/dist/export/pdf/draw/drawParagraph.d.ts

@@ -9,4 +9,4 @@ import { OasisPdfWriter } from '../OasisPdfWriter.js';
  * dotted edges use {@link borderDashArray} to match the canvas renderer.
  */
 export declare function drawParagraphDecorations(writer: OasisPdfWriter, pageIndex: number, paragraphStyle: EditorParagraphStyle, lines: EditorLayoutLine[], originX: number, contentTop: number, contentWidth: number): void;
-export declare function drawParagraph(writer: OasisPdfWriter, pageIndex: number, paragraph: EditorParagraphNode, lines: EditorLayoutLine[], document: EditorDocument, originX: number, originY: number, fontRegistry: PdfFontRegistry, listOrdinals: Map<string, number>): Promise<void>;
+export declare function drawParagraph(writer: OasisPdfWriter, pageIndex: number, paragraph: EditorParagraphNode, lines: EditorLayoutLine[], document: EditorDocument, originX: number, originY: number, fontRegistry: PdfFontRegistry, listOrdinals: Map<string, string>): Promise<void>;

package/dist/export/pdf/draw/drawTable.d.ts

@@ -2,4 +2,4 @@ import { EditorDocument, EditorLayoutBlock } from '../../../core/model.js';
 import { PdfFontRegistry } from '../fonts/PdfFontRegistry.js';
 import { OasisPdfWriter } from '../OasisPdfWriter.js';
 
-export declare function drawTableBlock(writer: OasisPdfWriter, pageIndex: number, block: EditorLayoutBlock, document: EditorDocument, originX: number, originY: number, contentWidth: number, fontRegistry: PdfFontRegistry, listOrdinals: Map<string, number>): Promise<void>;
+export declare function drawTableBlock(writer: OasisPdfWriter, pageIndex: number, block: EditorLayoutBlock, document: EditorDocument, originX: number, originY: number, contentWidth: number, fontRegistry: PdfFontRegistry, listOrdinals: Map<string, string>): Promise<void>;

package/dist/export/pdf/draw/lists.d.ts

@@ -2,5 +2,5 @@ import { EditorDocument, EditorLayoutLine, EditorParagraphNode } from '../../../
 import { PdfFontRegistry } from '../fonts/PdfFontRegistry.js';
 import { OasisPdfWriter } from '../OasisPdfWriter.js';
 
-export declare function getListOrdinals(document: EditorDocument): Map<string, number>;
-export declare function drawListPrefix(writer: OasisPdfWriter, pageIndex: number, paragraph: EditorParagraphNode, line: EditorLayoutLine, document: EditorDocument, originX: number, originY: number, fontRegistry: PdfFontRegistry, listOrdinals: Map<string, number>): void;
+export declare function getListOrdinals(document: EditorDocument): Map<string, string>;
+export declare function drawListPrefix(writer: OasisPdfWriter, pageIndex: number, paragraph: EditorParagraphNode, line: EditorLayoutLine, document: EditorDocument, originX: number, originY: number, fontRegistry: PdfFontRegistry, listOrdinals: Map<string, string>): void;

package/dist/i18n/I18nContext.d.ts

@@ -0,0 +1,9 @@
+import { JSX } from 'solid-js';
+import { TranslateFn } from './index.js';
+
+/** Access the translator from the nearest `I18nProvider`. */
+export declare function useI18n(): TranslateFn;
+export declare function I18nProvider(props: {
+    translator: TranslateFn;
+    children: JSX.Element;
+}): JSX.Element;

package/dist/i18n/index.d.ts

@@ -2,6 +2,10 @@ import { en } from './locales/en.js';
 
 export type Locale = "en" | "pt-BR";
 export type TranslationKey = keyof typeof en;
-export declare function setLocale(locale: Locale): void;
-export declare function getLocale(): Locale;
-export declare function t(key: TranslationKey, params?: unknown[]): string;
+export type TranslateFn = (key: TranslationKey, params?: unknown[]) => string;
+/**
+ * Build a translator bound to a locale accessor. The accessor is read on every
+ * call, so when it reads a Solid signal the translation tracks locale changes
+ * reactively. No module-level mutable locale is involved.
+ */
+export declare function createTranslator(getLocale: () => Locale): TranslateFn;

package/dist/import/docx/numbering.d.ts

@@ -1,41 +1,32 @@
 import { Element as XmlElement } from '@xmldom/xmldom';
 import { EditorParagraphListStyle } from '../../core/model.js';
 
-export interface NumberingMaps {
-    abstractKinds: Map<string, EditorParagraphListStyle["kind"]>;
-    numKinds: Map<string, EditorParagraphListStyle["kind"]>;
-    /** Indent per level, keyed by "abstractNumId:ilvl". Values in points. */
-    abstractIndents: Map<string, {
+type ListFormat = NonNullable<EditorParagraphListStyle["format"]>;
+interface NumberingLevel {
+    kind?: EditorParagraphListStyle["kind"];
+    format?: ListFormat;
+    suffix?: EditorParagraphListStyle["suffix"];
+    startAt?: number;
+    levelText?: string;
+    alignment?: EditorParagraphListStyle["alignment"];
+    legal?: boolean;
+    bulletGlyph?: string;
+    bulletFont?: string;
+    indent?: {
         left?: number;
         hanging?: number;
-    }>;
-    /** Suffix (`w:suff`) per level, keyed by "abstractNumId:ilvl". */
-    abstractSuffixes: Map<string, EditorParagraphListStyle["suffix"]>;
-    /** numFmt mapped to editor format, keyed by "abstractNumId:ilvl". */
-    abstractFormats: Map<string, NonNullable<EditorParagraphListStyle["format"]>>;
-    /** Starting number from `w:start`, keyed by "abstractNumId:ilvl". OOXML default is 1. */
-    abstractStarts: Map<string, number>;
-    /** Literal bullet glyph from `w:lvlText`, keyed by "abstractNumId:ilvl". */
-    abstractBulletGlyphs: Map<string, string>;
-    /** Font name from `w:lvl/w:rPr/w:rFonts`, keyed by "abstractNumId:ilvl". */
-    abstractBulletFonts: Map<string, string>;
-    /** `w:startOverride` values from `w:num/w:lvlOverride`, keyed by "numId:ilvl". */
+    };
+}
+export interface NumberingMaps {
+    abstractLevels: Map<string, NumberingLevel>;
+    numOverrideLevels: Map<string, NumberingLevel>;
     numStartOverrides: Map<string, number>;
-    /** numId → abstractNumId */
     numToAbstractId: Map<string, string>;
-    /**
-     * Tracks which "numId:ilvl" pairs have been seen during paragraph parsing.
-     * The first paragraph for each pair carries the level's `startAt` value;
-     * subsequent paragraphs in the same list instance do not, so the counter
-     * continues from the previous ordinal instead of resetting.
-     */
     seenInstances: Set<string>;
 }
 export declare function parseNumbering(numberingXml: string | null): NumberingMaps;
 export declare function parseParagraphList(paragraphProperties: XmlElement | null, numberingMaps: NumberingMaps): {
     list: EditorParagraphListStyle;
-    indent?: {
-        left?: number;
-        hanging?: number;
-    };
+    indent?: NumberingLevel["indent"];
 } | undefined;
+export {};