roosterjs-content-model-types 0.10.0

package/LICENSE

@@ -0,0 +1,25 @@
+    RoosterJS
+    Copyright (c) Microsoft Corporation
+    All rights reserved.
+
+    MIT License
+
+    Copyright (c) Microsoft Corporation. All rights reserved.
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in all
+    copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+    SOFTWARE

package/README.md

@@ -0,0 +1,307 @@
+[![Build Status](https://github.com/microsoft/roosterjs/actions/workflows/build-and-deploy.yml/badge.svg)](https://github.com/microsoft/roosterjs/actions/workflows/build-and-deploy.yml)
+
+# Rooster
+
+Rooster is a framework-independent JavaScript rich-text editor neatly nested
+inside one HTML `<div>` element. Editing operations performed by end users are
+handled in simple ways to generate the final HTML.
+
+To view the sample site, please click the link below:
+
+[RoosterJs Sample Site](https://microsoft.github.io/roosterjs/index.html).
+
+## Upgrade from RoosterJs 7.\*
+
+Please see [here](https://github.com/microsoft/roosterjs/wiki/RoosterJs-8).
+
+## Features
+
+### Packages
+
+Rooster contains 6 basic packages.
+
+1. [roosterjs](https://microsoft.github.io/roosterjs/docs/modules/roosterjs.html):
+   A facade of all Rooster code for those who want a quick start. Use the
+   `createEditor()` function in roosterjs to create an editor with default
+   configurations.
+
+2. [roosterjs-editor-core](https://microsoft.github.io/roosterjs/docs/modules/roosterjs_editor_core.html):
+   Defines the core editor and plugin infrastructure. Use `roosterjs-editor-core`
+   instead of `roosterjs` to build and customize your own editor.
+
+3. [roosterjs-editor-api](https://microsoft.github.io/roosterjs/docs/modules/roosterjs_editor_api.html):
+   Defines APIs for editor operations. Use these APIs to modify content and
+   formatting in the editor you built using `roosterjs-editor-core`.
+
+4. [roosterjs-editor-dom](https://microsoft.github.io/roosterjs/docs/modules/roosterjs_editor_dom.html):
+   Defines APIs for DOM operations. Use `roosterjs-editor-api` instead unless
+   you want to access DOM API directly.
+
+5. [roosterjs-editor-plugins](https://microsoft.github.io/roosterjs/docs/modules/roosterjs_editor_plugins.html):
+   Defines basic plugins for common features. Examples: making hyperlinks,
+   pasting HTML content, inserting inline images.
+
+6. [roosterjs-editor-types](https://microsoft.github.io/roosterjs/docs/modules/roosterjs_editor_types.html):
+   Defines public interfaces and enumerations.
+
+There are also some extension packages to provide additional functionalities.
+
+1. [roosterjs-color-utils](https://microsoft.github.io/roosterjs/docs/modules/roosterjs_color_utils.html):
+   Provide color transformation utility to make editor work under dark mode.
+
+2. [roosterjs-react](https://microsoft.github.io/roosterjs/docs/modules/roosterjs_react.html):
+   Provide a React wrapper of roosterjs so it can be easily used with React.
+
+3. [roosterjs-editor-types-compatible](https://microsoft.github.io/roosterjs/docs/modules/roosterjs_editor_types_compatible.html):
+   Provide types that are compatible with isolatedModules mode. When using isolatedModules mode,
+   "const enum" will not work correctly, this package provides enums with prefix "Compatible" in
+   their names and they have the same value with const enums in roosterjs-editor-types package
+
+### APIs
+
+Rooster provides DOM level APIs (in `roosterjs-editor-dom`), core APIs (in `roosterjs-editor-core`), and formatting APIs
+(in `roosterjs-editor-api`) to perform editing operations.
+
+`roosterjs-editor-dom` provides several levels of DOM operations:
+
+-   Perform basic DOM operations such as `wrap()`, `unwrap()`, ...
+-   Wrap a given DOM node with `InlineElement` or `BlockElement` and perform
+    operations with DOM Walker API.
+-   Perform DOM operations on a given scope using scopers.
+-   Travel among `InlineElements` and `BlockElements` with scope using
+    ContentTraverser API.
+
+`roosterjs-editor-core` provides APIs for editor core. Editor class will call such
+APIs to perform basic editor operations. These APIs are overridable by specifying
+API overrides in Editor options when creating the editor.
+
+`roosterjs-editor-api` provides APIs for scenario-based operations triggered by
+user interaction.
+
+## Plugins
+
+Rooster supports plugins. You can use built-in plugins or build your own.
+Plugins call APIs to communicate with the editor. When an operation is
+performed by the user or when content is changed by code, the editor will
+trigger events for the plugins to handle.
+
+Here's a sample plugin which will show a dialog containing "Hello Rooster" when
+an "a" is typed in the editor:
+
+```typescript
+class HelloRooster implements EditorPlugin {
+    getName() {
+        return 'HelloRooster';
+    }
+
+    initialize(editor: IEditor) {}
+
+    dispose() {}
+
+    onPluginEvent(e: PluginEvent) {
+        if (e.eventType == PluginEventType.KeyPress && e.rawEvent.which == 65) {
+            alert('Hello Rooster');
+        }
+    }
+}
+```
+
+## Installation
+
+Install via NPM or Yarn:
+
+`yarn add roosterjs`
+
+You can also install sub packages separately:
+
+`yarn add roosterjs-editor-core`
+
+`yarn add roosterjs-editor-api`
+
+`...`
+
+In order to run the code below, you may also need to install [webpack](https://webpack.js.org/):
+
+`yarn add webpack -g`
+
+## Usage
+
+### A quick start
+
+1. Create `editor.htm` contains a DIV with some styles, and a reference to a
+   .js file:
+
+```html
+<html>
+    <body>
+        <div
+            id="editorDiv"
+            style="width: 500px; height: 300px; overflow: auto;
+        border: solid 1px black"
+        ></div>
+        <script src="editor.js"></script>
+    </body>
+</html>
+```
+
+2. Create `source.js` to import roosterjs and create an editor:
+
+```javascript
+var roosterjs = require('roosterjs');
+var editorDiv = document.getElementById('editorDiv');
+var editor = roosterjs.createEditor(editorDiv);
+editor.setContent('Welcome to <b>RoosterJs</b>!');
+```
+
+3. Compile the javascript file using webpack:
+
+`webpack source.js editor.js`
+
+4. Navigate to editor.htm, you will see a editor shown in the page.
+
+### Add some format buttons
+
+1. Add some buttons into `editor.htm`:
+
+```html
+<html>
+    <body>
+        <div
+            id="editorDiv"
+            style="width: 500px; height: 300px; overflow: auto;
+        border: solid 1px black"
+        ></div>
+        <button id="buttonB">B</button> <button id="buttonI">I</button>
+        <button id="buttonU">U</button>
+        <script src="editor.js"></script>
+    </body>
+</html>
+```
+
+2. Add code to `source.js` to handle click event of the buttons:
+
+```javascript
+var roosterjs = require('roosterjs');
+var editorDiv = document.getElementById('editorDiv');
+var editor = roosterjs.createEditor(editorDiv);
+editor.setContent('Welcome to <b>RoosterJs</b>!');
+
+document.getElementById('buttonB').addEventListener('click', function () {
+    roosterjs.toggleBold(editor);
+});
+document.getElementById('buttonI').addEventListener('click', function () {
+    roosterjs.toggleItalic(editor);
+});
+document.getElementById('buttonU').addEventListener('click', function () {
+    roosterjs.toggleUnderline(editor);
+});
+```
+
+3. Compile the javascript file using webpack:
+
+`webpack source.js editor.js`
+
+4. Navigate to editor.htm, you will see buttons with bold, italic, underline
+   actions in the page.
+
+## Sample code
+
+To view the sample site, please click [here](https://microsoft.github.io/roosterjs/index.html).
+
+To build the sample site code yourself, follow these instructions:
+
+1. Get dependencies using [yarn](https://yarnpkg.com) or [npm](https://www.npmjs.com/):
+
+    ```cmd
+    yarn
+    ```
+
+2. Build the source code, and start the sample editor:
+
+    ```
+    yarn start
+    ```
+
+    or
+
+    ```
+    npm start
+    ```
+
+## Debugging
+
+There are two options for debugging:
+
+1. Debugging from VSCode
+
+    - Ensure the sample editor is running
+    - Set the breakpoints within VSCode
+    - Select "Debug app in Chrome" from the VSCode debugging configuration dropdown
+      <img src="/assets/readme-images/debug-in-VSCode.png" width="411" height="278"><br>
+    - Run the scenario that needs to be debugged
+
+2. Debugging directly from the development tools within the web browser
+    - The directions for how to do this are specific to each web browser. By opening the developer
+      tools for the web browser that Rooster is running on, you will be able to set breakpoints in
+      the code and debug accordingly.
+
+## Running tests
+
+There are two ways that tests can be run:
+
+1. Run all tests or a single test from VSCode<br>
+    - (Skip if running all tests) Ensure the file that you want to test is selected (ie: toggleBold.ts
+      or toggleBoldTest.ts)
+    - Select "Test all files" or "Test current file" from the VSCode debugging configuration dropdown
+      <img src="/assets/readme-images/test-in-VSCode.png" width="402" height="268">
+2. Run all tests from command line
+    ```
+    yarn test
+    ```
+
+## Dependencies
+
+As a NodeJs package, RoosterJs has dependencies for runtime (specified in package.json under each sub
+packages in "dependencies" section) and dependencies for build time (specified in package.json under
+root path in "devDependencies" section).
+
+For runtime dependencies, there are two parts:
+
+-   Internal dependencies (a RoosterJs package depends on other RoosterJs packages)
+-   External dependencies (RoosterJs depends on other NPM packages)
+
+Currently we have very few external dependencies. Before adding any new dependency, we need to check:
+
+1. What's the value of the new dependency and the code using the dependency bring into roosterjs?
+   If we add a new dependency and create our new API to just call into the dependency, that new API
+   doesn't actually bring too much value, and people who uses roosterjs in their project can do this
+   themselves in their code, and we should not add such dependency to people who don't really need it.
+
+2. What's the dependency tree of the dependency?
+   If we introduce a new dependency which has a deep dependency tree, we need to be careful since it
+   means we are actually adding a lot of new dependencies and our code size may be increased a lot.
+
+3. How much functionalities do we need from the dependency?
+   If the dependency provides a lot of functionalities but we actually only need a small piece of them,
+   we may need to consider other solutions, such as find another smaller one, or do it ourselves.
+
+4. What's the license of the dependency?
+   A dependency package under MIT license is good to be used for RoosterJs. For other licenses, we need
+   to review and see if we can take it as a dependency.
+
+If you still feel a new dependency is required after checking these questions, we can review it and
+finally decide whether we should add the new dependency.
+
+For build time dependencies, it is more flexable to add new dependencies since it won't increase runtime
+code size or dependencies.
+
+## More documentation
+
+We are still working on more documentation in [roosterjs wiki](https://github.com/Microsoft/roosterjs/wiki) and [API reference](https://microsoft.github.io/roosterjs/docs/index.html).
+
+## License - MIT
+
+License
+Copyright (c) Microsoft Corporation. All rights reserved.
+
+Licensed under the [MIT](LICENSE) License.

package/lib/block/ContentModelBlock.d.ts

@@ -0,0 +1,11 @@
+import { ContentModelDivider } from './ContentModelDivider';
+import { ContentModelEntity } from '../entity/ContentModelEntity';
+import { ContentModelFormatContainer } from '../group/ContentModelFormatContainer';
+import { ContentModelGeneralBlock } from '../group/ContentModelGeneralBlock';
+import { ContentModelListItem } from '../group/ContentModelListItem';
+import { ContentModelParagraph } from './ContentModelParagraph';
+import { ContentModelTable } from './ContentModelTable';
+/**
+ * A union type of Content Model Block
+ */
+export declare type ContentModelBlock = ContentModelFormatContainer | ContentModelListItem | ContentModelGeneralBlock | ContentModelTable | ContentModelParagraph | ContentModelEntity | ContentModelDivider;

package/lib/block/ContentModelBlock.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ContentModelBlock.js.map

package/lib/block/ContentModelBlock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentModelBlock.js","sourceRoot":"","sources":["../../../../packages-content-model/roosterjs-content-model-types/lib/block/ContentModelBlock.ts"],"names":[],"mappings":"","sourcesContent":["import { ContentModelDivider } from './ContentModelDivider';\nimport { ContentModelEntity } from '../entity/ContentModelEntity';\nimport { ContentModelFormatContainer } from '../group/ContentModelFormatContainer';\nimport { ContentModelGeneralBlock } from '../group/ContentModelGeneralBlock';\nimport { ContentModelListItem } from '../group/ContentModelListItem';\nimport { ContentModelParagraph } from './ContentModelParagraph';\nimport { ContentModelTable } from './ContentModelTable';\n\n/**\n * A union type of Content Model Block\n */\nexport type ContentModelBlock =\n    | ContentModelFormatContainer\n    | ContentModelListItem\n    | ContentModelGeneralBlock\n    | ContentModelTable\n    | ContentModelParagraph\n    | ContentModelEntity\n    | ContentModelDivider;\n"]}

package/lib/block/ContentModelBlockBase.d.ts

@@ -0,0 +1,12 @@
+import { ContentModelBlockFormat } from '../format/ContentModelBlockFormat';
+import { ContentModelBlockType } from '../enum/BlockType';
+import { ContentModelWithFormat } from '../format/ContentModelWithFormat';
+/**
+ * Base type of a block
+ */
+export interface ContentModelBlockBase<T extends ContentModelBlockType, TFormat extends ContentModelBlockFormat = ContentModelBlockFormat> extends ContentModelWithFormat<TFormat> {
+    /**
+     * Type of this block
+     */
+    blockType: T;
+}

package/lib/block/ContentModelBlockBase.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ContentModelBlockBase.js.map

package/lib/block/ContentModelBlockBase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentModelBlockBase.js","sourceRoot":"","sources":["../../../../packages-content-model/roosterjs-content-model-types/lib/block/ContentModelBlockBase.ts"],"names":[],"mappings":"","sourcesContent":["import { ContentModelBlockFormat } from '../format/ContentModelBlockFormat';\nimport { ContentModelBlockType } from '../enum/BlockType';\nimport { ContentModelWithFormat } from '../format/ContentModelWithFormat';\n\n/**\n * Base type of a block\n */\nexport interface ContentModelBlockBase<\n    T extends ContentModelBlockType,\n    TFormat extends ContentModelBlockFormat = ContentModelBlockFormat\n> extends ContentModelWithFormat<TFormat> {\n    /**\n     * Type of this block\n     */\n    blockType: T;\n}\n"]}

package/lib/block/ContentModelBlockWithCache.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Represent a Content Model block with cached element
+ */
+export interface ContentModelBlockWithCache<TElement extends HTMLElement = HTMLElement> {
+    /**
+     * Cached element for reuse
+     */
+    cachedElement?: TElement;
+}

package/lib/block/ContentModelBlockWithCache.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ContentModelBlockWithCache.js.map

package/lib/block/ContentModelBlockWithCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentModelBlockWithCache.js","sourceRoot":"","sources":["../../../../packages-content-model/roosterjs-content-model-types/lib/block/ContentModelBlockWithCache.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Represent a Content Model block with cached element\n */\nexport interface ContentModelBlockWithCache<TElement extends HTMLElement = HTMLElement> {\n    /**\n     * Cached element for reuse\n     */\n    cachedElement?: TElement;\n}\n"]}

package/lib/block/ContentModelDivider.d.ts

@@ -0,0 +1,17 @@
+import { ContentModelBlockBase } from './ContentModelBlockBase';
+import { ContentModelBlockWithCache } from './ContentModelBlockWithCache';
+import { ContentModelDividerFormat } from '../format/ContentModelDividerFormat';
+import { Selectable } from '../selection/Selectable';
+/**
+ * Content Model of horizontal divider
+ */
+export interface ContentModelDivider extends Selectable, ContentModelBlockWithCache, ContentModelBlockBase<'Divider', ContentModelDividerFormat> {
+    /**
+     * Tag name of this element, either HR or DIV
+     */
+    tagName: 'hr' | 'div';
+    /**
+     * Size property for HR
+     */
+    size?: string;
+}

package/lib/block/ContentModelDivider.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ContentModelDivider.js.map

package/lib/block/ContentModelDivider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentModelDivider.js","sourceRoot":"","sources":["../../../../packages-content-model/roosterjs-content-model-types/lib/block/ContentModelDivider.ts"],"names":[],"mappings":"","sourcesContent":["import { ContentModelBlockBase } from './ContentModelBlockBase';\nimport { ContentModelBlockWithCache } from './ContentModelBlockWithCache';\nimport { ContentModelDividerFormat } from '../format/ContentModelDividerFormat';\nimport { Selectable } from '../selection/Selectable';\n\n/**\n * Content Model of horizontal divider\n */\nexport interface ContentModelDivider\n    extends Selectable,\n        ContentModelBlockWithCache,\n        ContentModelBlockBase<'Divider', ContentModelDividerFormat> {\n    /**\n     * Tag name of this element, either HR or DIV\n     */\n    tagName: 'hr' | 'div';\n\n    /**\n     * Size property for HR\n     */\n    size?: string;\n}\n"]}

package/lib/block/ContentModelParagraph.d.ts

@@ -0,0 +1,27 @@
+import { ContentModelBlockBase } from './ContentModelBlockBase';
+import { ContentModelBlockWithCache } from './ContentModelBlockWithCache';
+import { ContentModelParagraphDecorator } from '../decorator/ContentModelParagraphDecorator';
+import { ContentModelSegment } from '../segment/ContentModelSegment';
+import { ContentModelSegmentFormat } from '../format/ContentModelSegmentFormat';
+/**
+ * Content Model of Paragraph
+ */
+export interface ContentModelParagraph extends ContentModelBlockWithCache, ContentModelBlockBase<'Paragraph'> {
+    /**
+     * Segments within this paragraph
+     */
+    segments: ContentModelSegment[];
+    /**
+     * Segment format on this paragraph. This is mostly used for default format
+     */
+    segmentFormat?: ContentModelSegmentFormat;
+    /**
+     * Header info for this paragraph if it is a header
+     */
+    decorator?: ContentModelParagraphDecorator;
+    /**
+     * Whether this block was created from a block HTML element or just some simple segment between other block elements.
+     * True means it doesn't have a related block element, false means it was from a block element
+     */
+    isImplicit?: boolean;
+}

package/lib/block/ContentModelParagraph.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ContentModelParagraph.js.map

package/lib/block/ContentModelParagraph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentModelParagraph.js","sourceRoot":"","sources":["../../../../packages-content-model/roosterjs-content-model-types/lib/block/ContentModelParagraph.ts"],"names":[],"mappings":"","sourcesContent":["import { ContentModelBlockBase } from './ContentModelBlockBase';\nimport { ContentModelBlockWithCache } from './ContentModelBlockWithCache';\nimport { ContentModelParagraphDecorator } from '../decorator/ContentModelParagraphDecorator';\nimport { ContentModelSegment } from '../segment/ContentModelSegment';\nimport { ContentModelSegmentFormat } from '../format/ContentModelSegmentFormat';\n\n/**\n * Content Model of Paragraph\n */\nexport interface ContentModelParagraph\n    extends ContentModelBlockWithCache,\n        ContentModelBlockBase<'Paragraph'> {\n    /**\n     * Segments within this paragraph\n     */\n    segments: ContentModelSegment[];\n\n    /**\n     * Segment format on this paragraph. This is mostly used for default format\n     */\n    segmentFormat?: ContentModelSegmentFormat;\n\n    /**\n     * Header info for this paragraph if it is a header\n     */\n    decorator?: ContentModelParagraphDecorator;\n\n    /**\n     * Whether this block was created from a block HTML element or just some simple segment between other block elements.\n     * True means it doesn't have a related block element, false means it was from a block element\n     */\n    isImplicit?: boolean;\n}\n"]}

package/lib/block/ContentModelTable.d.ts

@@ -0,0 +1,19 @@
+import { ContentModelBlockBase } from './ContentModelBlockBase';
+import { ContentModelBlockWithCache } from './ContentModelBlockWithCache';
+import { ContentModelTableFormat } from '../format/ContentModelTableFormat';
+import { ContentModelTableRow } from './ContentModelTableRow';
+import { ContentModelWithDataset } from '../format/ContentModelWithDataset';
+import { TableMetadataFormat } from '../format/metadata/TableMetadataFormat';
+/**
+ * Content Model of Table
+ */
+export interface ContentModelTable extends ContentModelBlockBase<'Table', ContentModelTableFormat>, ContentModelWithDataset<TableMetadataFormat>, ContentModelBlockWithCache<HTMLTableElement> {
+    /**
+     * Widths of each column
+     */
+    widths: number[];
+    /**
+     * Cells of this table
+     */
+    rows: ContentModelTableRow[];
+}

package/lib/block/ContentModelTable.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ContentModelTable.js.map

package/lib/block/ContentModelTable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentModelTable.js","sourceRoot":"","sources":["../../../../packages-content-model/roosterjs-content-model-types/lib/block/ContentModelTable.ts"],"names":[],"mappings":"","sourcesContent":["import { ContentModelBlockBase } from './ContentModelBlockBase';\nimport { ContentModelBlockWithCache } from './ContentModelBlockWithCache';\nimport { ContentModelTableFormat } from '../format/ContentModelTableFormat';\nimport { ContentModelTableRow } from './ContentModelTableRow';\nimport { ContentModelWithDataset } from '../format/ContentModelWithDataset';\nimport { TableMetadataFormat } from '../format/metadata/TableMetadataFormat';\n\n/**\n * Content Model of Table\n */\nexport interface ContentModelTable\n    extends ContentModelBlockBase<'Table', ContentModelTableFormat>,\n        ContentModelWithDataset<TableMetadataFormat>,\n        ContentModelBlockWithCache<HTMLTableElement> {\n    /**\n     * Widths of each column\n     */\n    widths: number[];\n\n    /**\n     * Cells of this table\n     */\n    rows: ContentModelTableRow[];\n}\n"]}

package/lib/block/ContentModelTableRow.d.ts

@@ -0,0 +1,17 @@
+import { ContentModelBlockFormat } from '../format/ContentModelBlockFormat';
+import { ContentModelBlockWithCache } from './ContentModelBlockWithCache';
+import { ContentModelTableCell } from '../group/ContentModelTableCell';
+import { ContentModelWithFormat } from '../format/ContentModelWithFormat';
+/**
+ * Content Model of Table
+ */
+export interface ContentModelTableRow extends ContentModelBlockWithCache<HTMLTableRowElement>, ContentModelWithFormat<ContentModelBlockFormat> {
+    /**
+     * Heights of each row
+     */
+    height: number;
+    /**
+     * Cells of this table
+     */
+    cells: ContentModelTableCell[];
+}

package/lib/block/ContentModelTableRow.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ContentModelTableRow.js.map

package/lib/block/ContentModelTableRow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentModelTableRow.js","sourceRoot":"","sources":["../../../../packages-content-model/roosterjs-content-model-types/lib/block/ContentModelTableRow.ts"],"names":[],"mappings":"","sourcesContent":["import { ContentModelBlockFormat } from '../format/ContentModelBlockFormat';\nimport { ContentModelBlockWithCache } from './ContentModelBlockWithCache';\nimport { ContentModelTableCell } from '../group/ContentModelTableCell';\nimport { ContentModelWithFormat } from '../format/ContentModelWithFormat';\n\n/**\n * Content Model of Table\n */\nexport interface ContentModelTableRow\n    extends ContentModelBlockWithCache<HTMLTableRowElement>,\n        ContentModelWithFormat<ContentModelBlockFormat> {\n    /**\n     * Heights of each row\n     */\n    height: number;\n\n    /**\n     * Cells of this table\n     */\n    cells: ContentModelTableCell[];\n}\n"]}

package/lib/context/ContentModelHandler.d.ts

@@ -0,0 +1,23 @@
+import { ContentModelBlock } from '../block/ContentModelBlock';
+import { ContentModelBlockGroup } from '../group/ContentModelBlockGroup';
+import { ContentModelDecorator } from '../decorator/ContentModelDecorator';
+import { ContentModelSegment } from '../segment/ContentModelSegment';
+import { ModelToDomContext } from './ModelToDomContext';
+/**
+ * Type of Content Model to DOM handler
+ * @param doc Target HTML Document object
+ * @param parent Parent HTML node to append the new node from the given model
+ * @param model The Content Model to handle
+ * @param context The context object to provide related information
+ */
+export declare type ContentModelHandler<T extends ContentModelSegment | ContentModelBlockGroup | ContentModelDecorator> = (doc: Document, parent: Node, model: T, context: ModelToDomContext) => void;
+/**
+ * Type of Content Model to DOM handler for block
+ * @param doc Target HTML Document object
+ * @param parent Parent HTML node to append the new node from the given model
+ * @param model The Content Model to handle
+ * @param context The context object to provide related information
+ * @param refNode Reference node. This is the next node the new node to be inserted.
+ * It is used when write DOM tree onto existing DOM true. If there is no reference node, pass null.
+ */
+export declare type ContentModelBlockHandler<T extends ContentModelBlock | ContentModelBlockGroup> = (doc: Document, parent: Node, model: T, context: ModelToDomContext, refNode: Node | null) => Node | null;

package/lib/context/ContentModelHandler.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ContentModelHandler.js.map

package/lib/context/ContentModelHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentModelHandler.js","sourceRoot":"","sources":["../../../../packages-content-model/roosterjs-content-model-types/lib/context/ContentModelHandler.ts"],"names":[],"mappings":"","sourcesContent":["import { ContentModelBlock } from '../block/ContentModelBlock';\nimport { ContentModelBlockGroup } from '../group/ContentModelBlockGroup';\nimport { ContentModelDecorator } from '../decorator/ContentModelDecorator';\nimport { ContentModelSegment } from '../segment/ContentModelSegment';\nimport { ModelToDomContext } from './ModelToDomContext';\n\n/**\n * Type of Content Model to DOM handler\n * @param doc Target HTML Document object\n * @param parent Parent HTML node to append the new node from the given model\n * @param model The Content Model to handle\n * @param context The context object to provide related information\n */\nexport type ContentModelHandler<\n    T extends ContentModelSegment | ContentModelBlockGroup | ContentModelDecorator\n> = (doc: Document, parent: Node, model: T, context: ModelToDomContext) => void;\n\n/**\n * Type of Content Model to DOM handler for block\n * @param doc Target HTML Document object\n * @param parent Parent HTML node to append the new node from the given model\n * @param model The Content Model to handle\n * @param context The context object to provide related information\n * @param refNode Reference node. This is the next node the new node to be inserted.\n * It is used when write DOM tree onto existing DOM true. If there is no reference node, pass null.\n */\nexport type ContentModelBlockHandler<T extends ContentModelBlock | ContentModelBlockGroup> = (\n    doc: Document,\n    parent: Node,\n    model: T,\n    context: ModelToDomContext,\n    refNode: Node | null\n) => Node | null;\n"]}

package/lib/context/DomToModelContext.d.ts

@@ -0,0 +1,9 @@
+import { DomToModelSelectionContext } from './DomToModelSelectionContext';
+import { DomToModelSettings } from './DomToModelSettings';
+import { EditorContext } from './EditorContext';
+import { DomToModelFormatContext, DomToModelDecoratorContext } from './DomToModelFormatContext';
+/**
+ * Context of DOM to Model conversion, used for parse HTML element according to current context
+ */
+export interface DomToModelContext extends EditorContext, DomToModelSelectionContext, DomToModelFormatContext, DomToModelSettings, DomToModelDecoratorContext {
+}

package/lib/context/DomToModelContext.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=DomToModelContext.js.map

package/lib/context/DomToModelContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DomToModelContext.js","sourceRoot":"","sources":["../../../../packages-content-model/roosterjs-content-model-types/lib/context/DomToModelContext.ts"],"names":[],"mappings":"","sourcesContent":["import { DomToModelSelectionContext } from './DomToModelSelectionContext';\nimport { DomToModelSettings } from './DomToModelSettings';\nimport { EditorContext } from './EditorContext';\nimport { DomToModelFormatContext, DomToModelDecoratorContext } from './DomToModelFormatContext';\n\n/**\n * Context of DOM to Model conversion, used for parse HTML element according to current context\n */\nexport interface DomToModelContext\n    extends EditorContext,\n        DomToModelSelectionContext,\n        DomToModelFormatContext,\n        DomToModelSettings,\n        DomToModelDecoratorContext {}\n"]}

package/lib/context/DomToModelFormatContext.d.ts

@@ -0,0 +1,68 @@
+import { ContentModelBlockFormat } from '../format/ContentModelBlockFormat';
+import { ContentModelBlockGroup } from '../group/ContentModelBlockGroup';
+import { ContentModelCode } from '../decorator/ContentModelCode';
+import { ContentModelLink } from '../decorator/ContentModelLink';
+import { ContentModelListItemLevelFormat } from '../format/ContentModelListItemLevelFormat';
+import { ContentModelParagraphDecorator } from '../decorator/ContentModelParagraphDecorator';
+import { ContentModelSegmentFormat } from '../format/ContentModelSegmentFormat';
+import { ZoomScaleFormat } from '../format/formatParts/ZoomScaleFormat';
+/**
+ * Represents the context object used when do DOM to Content Model conversion and processing a List
+ */
+export interface DomToModelListFormat {
+    /**
+     * Current number of each level of current thread
+     */
+    threadItemCounts: number[];
+    /**
+     * The list that is currently processing
+     */
+    listParent?: ContentModelBlockGroup;
+    /**
+     * Current list type stack
+     */
+    levels: ContentModelListItemLevelFormat[];
+}
+/**
+ * Represents format info used by DOM to Content Model conversion
+ */
+export interface DomToModelFormatContext {
+    /**
+     * Format of current block
+     */
+    blockFormat: ContentModelBlockFormat;
+    /**
+     * Format of current segment
+     */
+    segmentFormat: ContentModelSegmentFormat;
+    /**
+     * Context of list that is currently processing
+     */
+    listFormat: DomToModelListFormat;
+    /**
+     * Zoom scale of the content
+     */
+    zoomScaleFormat: ZoomScaleFormat;
+    /**
+     * Whether put the source element into Content Model when possible.
+     * When pass true, this cached element will be used to create DOM tree back when convert Content Model to DOM
+     */
+    allowCacheElement?: boolean;
+}
+/**
+ * Represents decorator info used by DOM to Content Model conversion
+ */
+export interface DomToModelDecoratorContext {
+    /**
+     * Context of hyper link info
+     */
+    link: ContentModelLink;
+    /**
+     * Context of code info
+     */
+    code: ContentModelCode;
+    /**
+     * Context for paragraph decorator
+     */
+    blockDecorator: ContentModelParagraphDecorator;
+}