@doxi/angular 0.11.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mahbub Hasan
+
+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,70 @@
+# @doxi/angular
+
+Angular adapter for [`@doxi/core`](../core). Ships a standalone `<dx-editor>` component wrapping the underlying `EditorView`.
+
+> **Status:** v0.10.x preview. Public API may evolve until v1.0.
+
+## Install
+
+```bash
+pnpm add @doxi/angular @doxi/core @angular/core @angular/common rxjs
+```
+
+Peer-deps: `@angular/core` ≥ 18 (works under 19), `@angular/common` ≥ 18, `rxjs` ≥ 7, `@doxi/core`. Zero runtime deps beyond the peers.
+
+## Quickstart
+
+```ts
+import { Component } from '@angular/core'
+import { DoxivaEditorComponent } from '@doxi/angular'
+import {
+  defaultRenderer,
+  defaultSchema,
+  EditorState,
+  historyPlugin,
+} from '@doxi/core'
+
+@Component({
+  selector: 'app-root',
+  standalone: true,
+  imports: [DoxivaEditorComponent],
+  template: `
+    <dx-editor
+      [state]="state"
+      [renderer]="renderer"
+      [ariaLabel]="'Dokumentredigerer'"
+      (dispatch)="onDispatch($event)"
+    />
+  `,
+})
+export class AppComponent {
+  state = EditorState.create({
+    schema: defaultSchema,
+    plugins: [historyPlugin().plugin],
+  })
+  renderer = defaultRenderer
+
+  onDispatch(tr: any) {
+    this.state = this.state.apply(tr)
+  }
+}
+```
+
+Don't forget to import the stylesheets in your global styles:
+
+```scss
+@import '@doxi/core/styles/base.css';
+@import '@doxi/core/styles/light.css';
+```
+
+## Change-detection model
+
+`<dx-editor>` runs the underlying `EditorView` **outside** `NgZone` to avoid Angular's change-detection thrashing on high-frequency editor updates. Dispatched transactions re-enter the zone so consumer handlers run in-zone as normal.
+
+## Toolbar
+
+`@doxi/angular` ships a default toolbar; consumers can compose their own from the per-group builders. See the [example app](../example-angular) for a full reference setup.
+
+## License
+
+[MIT](LICENSE)

package/dist/doxiva-doxiva-editor.component.d.ts

@@ -0,0 +1,118 @@
+import { EventEmitter, TemplateRef, type AfterViewInit, type OnChanges, type OnDestroy, type OnInit, type SimpleChanges } from '@angular/core';
+import { EditorState, type DxNode, type EditorView, type PageConfig, type Renderer, type Transaction } from '@doxi/core';
+import type { ImportWarning } from '@doxi/docx';
+import { type ToolbarItem, type ToolbarPopoverContext } from './doxiva-toolbar.component.js';
+import { type FeatureFlags, type PageSizePreset, type Theme } from './doxiva.types.js';
+/**
+ * The bundled Doxiva editor — a single Angular standalone component that
+ * internally orchestrates the toolbar, popovers (link / table / image /
+ * header-footer / page-settings), keymap, print bridge, DOCX import/export,
+ * page chrome, and theme handling. Hosts pass `features` to disable parts
+ * of the UX and `theme` to switch palettes. The low-level
+ * `DoxivaEditorComponent` (`<dx-editor>`), `DoxivaToolbarComponent`
+ * (`<dx-toolbar>`), and `defaultToolbarActions` remain exported for power
+ * users.
+ */
+export declare class DxDoxivaEditorComponent implements OnInit, AfterViewInit, OnChanges, OnDestroy {
+    initialDoc?: DxNode;
+    theme: Theme;
+    features?: FeatureFlags;
+    paginated: boolean;
+    defaultPageSize: PageSizePreset;
+    editable: boolean;
+    ariaLabel?: string;
+    /**
+     * When set to `null`, suppresses the default warnings panel entirely.
+     * Otherwise the panel renders inline and (if `importWarnings` is also
+     * subscribed to) the host can mirror them.
+     */
+    onImportWarnings?: ((warnings: ReadonlyArray<ImportWarning>) => void) | null;
+    change: EventEmitter<DxNode>;
+    stateChange: EventEmitter<EditorState>;
+    importWarnings: EventEmitter<readonly ImportWarning[]>;
+    /** Emitted once the underlying EditorView is mounted (and again on remount). */
+    ready: EventEmitter<EditorView>;
+    private readonly cdr;
+    private readonly host;
+    private readonly history;
+    readonly renderer: Renderer;
+    state: EditorState;
+    effectiveFeatures: Required<FeatureFlags>;
+    actions: ToolbarItem[];
+    pageSize: PageSizePreset;
+    pageOrientation: 'portrait' | 'landscape';
+    pageMargins: 'normal' | 'narrow' | 'wide';
+    editorVisible: boolean;
+    chromeHeaderEnabled: boolean;
+    chromeFooterEnabled: boolean;
+    chromeHeaderHeightPx: number;
+    chromeFooterHeightPx: number;
+    headerText: string;
+    footerText: string;
+    headerPageNum: boolean;
+    footerPageNum: boolean;
+    imageSrc: string;
+    imageAlt: string;
+    readonly tablePickerRows: ReadonlyArray<number>;
+    readonly tablePickerCols: ReadonlyArray<number>;
+    tableHover: {
+        r: number;
+        c: number;
+    } | null;
+    view: EditorView | null;
+    importWarningsList: ReadonlyArray<ImportWarning>;
+    resolvedTheme: 'light' | 'dark';
+    private mediaQuery;
+    private mediaListener;
+    private onPrintListener;
+    linkTpl: TemplateRef<ToolbarPopoverContext>;
+    tableTpl: TemplateRef<ToolbarPopoverContext>;
+    imageTpl: TemplateRef<ToolbarPopoverContext>;
+    pageSettingsTpl: TemplateRef<ToolbarPopoverContext>;
+    headerFooterTpl: TemplateRef<ToolbarPopoverContext>;
+    popoverTemplates: Record<string, TemplateRef<ToolbarPopoverContext>>;
+    ngOnInit(): void;
+    ngAfterViewInit(): void;
+    ngOnChanges(changes: SimpleChanges): void;
+    ngOnDestroy(): void;
+    get showTopRow(): boolean;
+    get showWarningsPanel(): boolean;
+    get paginatedConfig(): PageConfig;
+    private recomputeFeatures;
+    private recomputeActions;
+    private buildPopoverTemplates;
+    private resolveTheme;
+    private installMediaListener;
+    private uninstallMediaListener;
+    onDispatch(tr: Transaction): void;
+    onReady(view: EditorView): void;
+    onPrintClick(): void;
+    onDownloadPdfClick(): void;
+    onExportDocxClick(): Promise<void>;
+    onImportFile(event: Event): Promise<void>;
+    applyPageSettings(close: () => void): void;
+    private remountEditor;
+    setChromeHeaderEnabled(v: boolean): void;
+    setChromeFooterEnabled(v: boolean): void;
+    setChromeHeaderHeight(raw: string | number): void;
+    setChromeFooterHeight(raw: string | number): void;
+    private clampChromeHeight;
+    private fragmentFromText;
+    private fragmentWithPageNumbers;
+    applyHeaderFooter(state: EditorState, dispatch: (tr: Transaction) => void, close: () => void): void;
+    clearHeaderFooter(state: EditorState, dispatch: (tr: Transaction) => void, close: () => void): void;
+    applyImage(state: EditorState, dispatch: (tr: Transaction) => void, close: () => void): void;
+    onImageKeydown(event: KeyboardEvent, state: EditorState, dispatch: (tr: Transaction) => void, close: () => void): void;
+    setTableHover(r: number, c: number): void;
+    resetTableHover(): void;
+    isTableCellOn(r: number, c: number): boolean;
+    tablePickerLabel(): string;
+    pickTable(state: EditorState, dispatch: (tr: Transaction) => void, close: () => void, r: number, c: number): void;
+    private get linkType();
+    hasExistingLink(state: EditorState): boolean;
+    linkInitialHref(state: EditorState): string;
+    applyLink(state: EditorState, dispatch: (tr: Transaction) => void, close: () => void, rawHref: string): void;
+    removeLink(state: EditorState, dispatch: (tr: Transaction) => void, close: () => void): void;
+    onLinkKeydown(event: KeyboardEvent, state: EditorState, dispatch: (tr: Transaction) => void, close: () => void, rawHref: string): void;
+}
+//# sourceMappingURL=doxiva-doxiva-editor.component.d.ts.map

package/dist/doxiva-doxiva-editor.component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doxiva-doxiva-editor.component.d.ts","sourceRoot":"","sources":["../src/doxiva-doxiva-editor.component.ts"],"names":[],"mappings":"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"}