oasis-editor 0.0.134 → 0.0.136

package/dist/plugins/internal/essentialsCapabilities.d.ts

@@ -1,7 +1,9 @@
-import { EditorPageMargins } from '../../core/model.js';
+import { EditorImageBorder, EditorPageMargins } from '../../core/model.js';
+import { ImageBorderPatch } from '../../core/commands/image.js';
 import { TextCaseMode } from '../../core/commands/text.js';
 import { ToolbarStyleState } from '../../ui/toolbarStyleState.js';
 import { OasisBuiltinCommand } from '../../core/commands/builtinCommands.js';
+import { TableBorderPreset } from '../../core/commands/table.js';
 
 export interface EssentialsFeatureGate {
     isCommandEnabled: (commandName: OasisBuiltinCommand) => boolean;
@@ -72,6 +74,13 @@ export interface EssentialsDocumentStyleDescriptor {
     color?: string;
     bold?: boolean;
     italic?: boolean;
+    tablePreview?: {
+        wholeFill?: string;
+        headerFill?: string;
+        bandFill?: string;
+        borderColor?: string;
+        headerColor?: string;
+    };
 }
 export interface EssentialsDocumentCapability {
     documentStyles: () => EssentialsDocumentStyleDescriptor[];
@@ -105,6 +114,10 @@ export interface EssentialsImageCapability {
     toggleCrop: () => void;
     /** Apply an aspect-ratio crop preset (e.g. "16:9", "1:1", "reset"). */
     applyCropAspect: (preset: string) => void;
+    /** Outline of the selected image (`pic:spPr/a:ln`), or `null`. */
+    getBorder: () => EditorImageBorder | null;
+    /** Merge a partial outline edit; `{ color: null }` removes the outline. */
+    setBorder: (patch: ImageBorderPatch) => void;
 }
 export interface EssentialsBrowserCapability {
     print: () => void;
@@ -175,6 +188,11 @@ export interface EssentialsTableCapability {
     cellShading: (color: string | null) => void;
     cellBorders: () => void;
     cellNoBorders: () => void;
+    applyBorderPreset: (preset: TableBorderPreset) => void;
+    isDrawingBorders: () => boolean;
+    toggleDrawingBorders: () => void;
+    isShowingGridlines: () => boolean;
+    toggleGridlines: () => void;
     width100: () => void;
     alignLeft: () => void;
     alignCenter: () => void;

package/dist/text/fonts/FontMetricsProvider.d.ts

@@ -35,4 +35,4 @@ export declare function getFontMetricsProvider(): FontMetricsProvider;
  * browser. Call this before the first layout/mount. In Node it is unnecessary
  * (synchronous `fs` loading covers it) but harmless.
  */
-export declare function preloadLayoutFonts(families?: Iterable<string | null | undefined>): Promise<void>;
+export declare function preloadLayoutFonts(families?: Iterable<string | null | undefined>): Promise<boolean>;

package/dist/text/fonts/core/types.d.ts

@@ -1,6 +1,6 @@
 import { Os2VerticalMetrics, VerticalMetrics } from '../../truetype/tableParsers.js';
 
-export type FontFormat = "ttf" | "woff2";
+export type FontFormat = "ttf" | "woff" | "woff2";
 export interface FontDecoder {
     readonly format: FontFormat;
     canDecode(bytes: Uint8Array): boolean;

package/dist/text/fonts/decoders/WoffDecoder.d.ts

@@ -0,0 +1,8 @@
+import { FontDecoder } from '../core/types.js';
+
+export declare class WoffDecoder implements FontDecoder {
+    readonly format: "woff";
+    canDecode(bytes: Uint8Array): boolean;
+    decode(bytes: Uint8Array): Promise<Uint8Array>;
+    decodeSync(bytes: Uint8Array): Uint8Array;
+}

package/dist/text/fonts/preciseFontMetrics.d.ts

@@ -2,6 +2,15 @@ import { SfntFontProgram } from './sfnt/SfntFontProgram.js';
 
 export declare function registerPreciseFont(family: string, bold: boolean, italic: boolean, program: SfntFontProgram): void;
 export declare function clearPreciseFonts(): void;
+/**
+ * Registers the exact locally-read bytes under an Oasis-owned CSS family.
+ * Using a private alias prevents a previously loaded remote @font-face with the
+ * document family name from painting different glyphs than the local program
+ * used by the layout engine.
+ */
+export declare function registerPreciseBrowserFontFace(family: string, bold: boolean, italic: boolean, bytes: Uint8Array): Promise<string | null>;
+/** Exact CSS family registered for a locally-read precise font, when present. */
+export declare function getPreciseBrowserFontFamily(family: string | null | undefined): string | null;
 /** Whether any real face is loaded for the family (ignores the mode flag). */
 export declare function hasPreciseFont(family: string | null | undefined): boolean;
 /** Whether a specific face has already been registered (used to skip reloads). */

package/dist/text/fonts/remoteWebFonts.d.ts

@@ -0,0 +1,16 @@
+export interface RemotePdfFontFace {
+    family: string;
+    bold: boolean;
+    italic: boolean;
+    fontData: Uint8Array;
+    postscriptName?: string;
+}
+export declare function isRemoteWebFontActive(fontFamily: string | null | undefined): boolean;
+/**
+ * Loads unbundled document fonts from fixed, HTTPS-only providers. Requests are
+ * browser-only, lazy, and deduplicated for the page lifetime. A failed request
+ * is non-fatal: the existing bundled metric substitute remains active.
+ */
+export declare function loadRemoteWebFonts(families: Iterable<string | null | undefined>): Promise<boolean>;
+/** Returns decoded SFNT data already requested by the browser font loader. */
+export declare function getRemotePdfFontFaces(families: Iterable<string | null | undefined>): Promise<RemotePdfFontFace[]>;

package/dist/ui/OasisEditorAppProps.d.ts

@@ -14,6 +14,8 @@ export interface OasisEditorLoadingOptions {
     style?: JSX.CSSProperties;
 }
 export interface OasisEditorAppUiProps {
+    /** Visual chrome palette. Defaults to light to preserve existing embeds. */
+    theme?: "light" | "dark";
     showChrome?: boolean;
     shell?: "document" | "inline" | "balloon";
     uiVariant?: "classic" | "docs";
@@ -34,6 +36,8 @@ export interface OasisEditorAppUiProps {
 export interface OasisEditorAppDocumentProps {
     initialDocument?: EditorDocument;
     initialState?: EditorState;
+    /** Load otherwise unavailable document fonts from Google Fonts/CDNFonts. */
+    remoteWebFonts?: boolean;
     onStateChange?: (state: EditorState) => void;
     readOnly?: boolean;
     persistenceEnabled?: boolean;

package/dist/ui/OasisEditorEditorProps.d.ts

@@ -8,6 +8,7 @@ import { ResizeHandleDirection } from './resizeGeometry.js';
 type ImportProgress = ImportProgressState;
 export interface OasisEditorEditorLayoutProps {
     documentLayout: Accessor<EditorLayoutDocument>;
+    remoteWebFonts?: boolean;
     measuredBlockHeights?: Accessor<Record<string, number>>;
     measuredParagraphLayouts?: Accessor<Record<string, EditorLayoutParagraph>>;
     viewportHeight?: number | string;

package/dist/ui/app/buildEditorViewProps.d.ts

@@ -14,6 +14,7 @@ type ImportProgress = NonNullable<ReturnType<NonNullable<OasisEditorEditorOverla
 /** Page sizing / zoom inputs that shape the layout prop bundle. */
 export interface EditorViewLayoutInput {
     documentLayout: Accessor<EditorLayoutDocument>;
+    remoteWebFonts?: boolean;
     viewportHeight: number | string | undefined;
     className: string | undefined;
     style: JSX.CSSProperties | undefined;

package/dist/ui/app/createAppCommandsController.d.ts

@@ -72,6 +72,7 @@ declare function createAppCommandsControllerImpl(deps: AppCommandsControllerDeps
         applyImageWidthCmCommand: (cm: number) => void;
         applyImageHeightCmCommand: (cm: number) => void;
         applyImageCropAspectCommand: (preset: string) => void;
+        applyImageBorderCommand: (patch: import('../../core/commands/image.js').ImageBorderPatch) => void;
         handleListTab: (direction: "indent" | "outdent") => boolean;
         handleListEnter: () => boolean;
         handleListBoundaryBackspace: (event: KeyboardEvent & {
@@ -109,6 +110,7 @@ declare function createAppCommandsControllerImpl(deps: AppCommandsControllerDeps
         applyImageWidthCmCommand: (cm: number) => void;
         applyImageHeightCmCommand: (cm: number) => void;
         applyImageCropAspectCommand: (preset: string) => void;
+        applyImageBorderCommand: (patch: import('../../core/commands/image.js').ImageBorderPatch) => void;
         handleListTab: (direction: "indent" | "outdent") => boolean;
         handleListEnter: () => boolean;
         handleListBoundaryBackspace: (event: KeyboardEvent & {

package/dist/ui/app/createEditorCommandRuntime.d.ts

@@ -87,6 +87,7 @@ declare function createEditorCommandRuntimeImpl(deps: EditorCommandRuntimeDeps):
         applyImageWidthCmCommand: (cm: number) => void;
         applyImageHeightCmCommand: (cm: number) => void;
         applyImageCropAspectCommand: (preset: string) => void;
+        applyImageBorderCommand: (patch: import('../../core/commands/image.js').ImageBorderPatch) => void;
         handleListTab: (direction: "indent" | "outdent") => boolean;
         handleListEnter: () => boolean;
         handleListBoundaryBackspace: (event: KeyboardEvent & {

package/dist/ui/app/documentFontPreparation.d.ts

@@ -0,0 +1,23 @@
+import { EditorDocument } from '../../core/model.js';
+
+export type DocumentFontSource = "local" | "remote" | "bundled" | "fallback";
+export interface DocumentFontPreparationResult {
+    changed: boolean;
+    families: Array<{
+        requested: string;
+        metricFamily: string;
+        source: DocumentFontSource;
+        browserFamily: string | null;
+    }>;
+}
+export interface DocumentFontPreparationOptions {
+    remoteWebFonts?: boolean;
+}
+/**
+ * Prepares every face needed by a parsed document before its editor state is
+ * applied. The promise is cached by family set/mode so the surface effect can
+ * safely call the same service without triggering a second relayout.
+ */
+export declare function prepareDocumentFonts(document: EditorDocument, options?: DocumentFontPreparationOptions): Promise<DocumentFontPreparationResult>;
+/** Test-only reset for the module-level deduplication cache. */
+export declare function clearDocumentFontPreparationCache(): void;

package/dist/ui/canvas/canvasFontResolution.d.ts

@@ -4,7 +4,7 @@ export declare function resolveCanvasTextRenderMetrics(styles: {
     subscript?: boolean;
     smallCaps?: boolean;
     baselineShift?: number | null;
-} | undefined, fontSize: number): {
+} | undefined, fontSize: number, sourceChar?: string): {
     fontSize: number;
     baselineOffset: number;
 };
@@ -48,7 +48,7 @@ type RunStyleInput = {
     smallCaps?: boolean;
     baselineShift?: number | null;
 } | undefined;
-export declare function resolveCanvasRunPaintStyle(styles: RunStyleInput): {
+export declare function resolveCanvasRunPaintStyle(styles: RunStyleInput, sourceChar?: string): {
     font: string;
     fillStyle: string;
     renderMetrics: ReturnType<typeof resolveCanvasTextRenderMetrics>;

package/dist/ui/canvas/paragraph/canvasInlineImage.d.ts

@@ -2,7 +2,7 @@ import { EditorImageRunData, EditorLayoutLine, EditorPageSettings, EditorState }
 
 /**
  * Draw an inline image fragment, honoring crop (`a:srcRect`), rotation
- * (`a:xfrm/@rot`) and horizontal/vertical flips.
+ * (`a:xfrm/@rot`), horizontal/vertical flips and the picture outline.
  */
 export declare function drawImageFragment(ctx: CanvasRenderingContext2D, img: CanvasImageSource & {
     naturalWidth: number;

package/dist/ui/canvas/paragraph/canvasTextEffects.d.ts

@@ -40,4 +40,5 @@ export declare function drawFragmentReflection(ctx: CanvasRenderingContext2D, fr
 }): void;
 export declare function getRenderedChar(char: string, styles: {
     allCaps?: boolean;
+    smallCaps?: boolean;
 }): string;

package/dist/ui/components/Toolbar/TableBordersMenu.d.ts

@@ -0,0 +1,6 @@
+import { JSX } from 'solid-js';
+import { ToolbarActionApi } from './schema/items.js';
+
+export declare function TableBordersMenu(props: {
+    api: ToolbarActionApi;
+}): JSX.Element;

package/dist/ui/components/Toolbar/TableStyleGallery.d.ts

@@ -0,0 +1,9 @@
+import { JSX } from 'solid-js';
+import { ToolbarActionApi, ToolbarDocumentStyle } from './schema/items.js';
+
+export interface TableStyleGalleryProps {
+    api: ToolbarActionApi;
+    styles: ToolbarDocumentStyle[];
+    testId?: string;
+}
+export declare function TableStyleGallery(props: TableStyleGalleryProps): JSX.Element;

package/dist/ui/components/Toolbar/TableStyleOptions.d.ts

@@ -0,0 +1,6 @@
+import { JSX } from 'solid-js';
+import { ToolbarActionApi } from './schema/items.js';
+
+export declare function TableStyleOptions(props: {
+    api: ToolbarActionApi;
+}): JSX.Element;

package/dist/ui/components/Toolbar/pictureBorderPresets.d.ts

@@ -0,0 +1,19 @@
+import { EditorLineDash } from '../../../core/model.js';
+import { TranslationKey } from '../../../i18n/index.js';
+
+/** Border weights offered by Word's Picture Border ▸ Weight submenu, in points. */
+export declare const PICTURE_BORDER_WEIGHTS_PT: number[];
+/** `0.25` → `"¼"`, `1.5` → `"1½"`, `3` → `"3"`. */
+export declare function formatBorderWeight(widthPt: number): string;
+export interface PictureBorderDashOption {
+    value: EditorLineDash;
+    labelKey: TranslationKey;
+}
+/** Ordered as Word's Dashes flyout: shortest pattern first. */
+export declare const PICTURE_BORDER_DASH_OPTIONS: PictureBorderDashOption[];
+/**
+ * `stroke-dasharray` for a menu preview stroke, derived from the same point
+ * table the canvas and PDF renderers use — so a preview can never disagree with
+ * what gets painted. Solid yields `undefined` (no attribute).
+ */
+export declare function dashPreviewArray(dash: EditorLineDash): string | undefined;

package/dist/ui/components/Toolbar/presets/defaultToolbar/buttonSpecs.d.ts

@@ -18,6 +18,7 @@ export declare const TABLE_LAYOUT_BUTTONS: Array<{
     command: string;
     icon: string;
     tooltipKey: TranslationKey;
+    ribbonSize?: "large";
 }>;
 /** tblLook conditional-formatting toggles on the Table Design tab. */
 export declare const TABLE_DESIGN_TOGGLES: Array<{

package/dist/ui/components/Toolbar/primitives/ColorGrids.d.ts

@@ -0,0 +1,20 @@
+import { JSX } from 'solid-js';
+import { ColorPalette } from '../schema/palette.js';
+
+export interface ColorGridsProps {
+    palette: ColorPalette;
+    themeColorsLabel: string;
+    standardColorsLabel: string;
+    /** Lowercased hex of the currently applied colour, for the active ring. */
+    activeColor: string;
+    testId: string;
+    onPreview: (color: string | null) => void;
+    onPick: (color: string) => void;
+}
+/**
+ * The theme-colour columns and standard-colour row shared by every colour popup
+ * (font colour, highlight, shading, picture border). Owns only the swatches —
+ * the surrounding "automatic"/"no colour" and "more colours" actions differ per
+ * consumer and stay with them.
+ */
+export declare function ColorGrids(props: ColorGridsProps): JSX.Element;

package/dist/ui/components/Toolbar/primitives/PictureBorderPicker.d.ts

@@ -0,0 +1,37 @@
+import { JSX } from 'solid-js';
+import { ColorPalette } from '../schema/palette.js';
+import { EditorImageBorder, EditorLineDash } from '../../../../core/model.js';
+import { ImageBorderPatch } from '../../../../core/commands/image.js';
+
+export interface PictureBorderPickerProps {
+    /** The outline currently on the selected picture, or `null`. */
+    border: EditorImageBorder | null;
+    palette: ColorPalette;
+    disabled?: boolean;
+    testId: string;
+    label: string;
+    noOutlineLabel: string;
+    moreColorsLabel: string;
+    weightLabel: string;
+    dashesLabel: string;
+    themeColorsLabel: string;
+    standardColorsLabel: string;
+    /** Ordered dash presets with their translated names. */
+    dashOptions: Array<{
+        value: EditorLineDash;
+        label: string;
+    }>;
+    onApply: (patch: ImageBorderPatch) => void;
+}
+/**
+ * Word's Picture Border popup: theme/standard colour grids, "No Outline",
+ * "More Outline Colors…", and Weight/Dashes flyouts. Purely presentational —
+ * every action reports a partial patch, so a colour pick keeps the current
+ * weight and vice-versa.
+ *
+ * The flyouts render *inside* the popover panel rather than in their own
+ * portal: `Popover`'s dismiss watcher only knows about the trigger and the
+ * panel, so a portalled child would read as an outside click and close its own
+ * parent.
+ */
+export declare function PictureBorderPicker(props: PictureBorderPickerProps): JSX.Element;

package/dist/ui/components/Toolbar/primitives/WideMenuButton.d.ts

@@ -0,0 +1,27 @@
+import { JSX } from 'solid-js';
+
+export interface WideMenuButtonProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    icon?: string;
+    label: string;
+    tooltip?: string;
+    testId?: string;
+    active?: boolean;
+    disabled?: boolean;
+    /** A swatch strip under the icon, e.g. the current border colour. */
+    indicatorColor?: string | null;
+    panelClass?: string;
+    children: JSX.Element;
+}
+/**
+ * A dropdown whose trigger lays icon, label and chevron out on a single
+ * horizontal line, sized to span a ribbon group's full height. This is the
+ * shape Word gives its Picture Border / Picture Effects / Picture Layout
+ * buttons, and it is the third trigger geometry in the toolbar — distinct from
+ * the icon-only (`normal`) and icon-above-label (`large`) `Button`s.
+ *
+ * Unlike `Menu`, no click inside the panel is intercepted: consumers own when
+ * the popup closes, which nested flyouts need.
+ */
+export declare function WideMenuButton(props: WideMenuButtonProps): JSX.Element;

package/dist/ui/components/Toolbar/schema/items.d.ts

@@ -30,6 +30,14 @@ export interface ToolbarDocumentStyle {
     color?: string;
     bold?: boolean;
     italic?: boolean;
+    /** Narrow, renderer-safe colour data for the table-style ribbon gallery. */
+    tablePreview?: {
+        wholeFill?: string;
+        headerFill?: string;
+        bandFill?: string;
+        borderColor?: string;
+        headerColor?: string;
+    };
 }
 /**
  * Narrow surface every toolbar item depends on (DIP/ISP). Items only dispatch
@@ -143,6 +151,20 @@ export interface ColorPickerItem extends ToolbarItemBase {
     labelKey?: TranslationKey;
     label?: string;
 }
+/**
+ * Word's Picture Border control: a wide horizontal trigger over a popup that
+ * carries colour grids plus Weight/Dashes flyouts. Its own item type (rather
+ * than a `colorPicker` variant) because a border is three facets — colour,
+ * weight, dash — dispatched as partial patches of one command.
+ */
+export interface PictureBorderItem extends ToolbarItemBase {
+    type: "pictureBorder";
+    /** Command dispatched with an `ImageBorderPatch` payload. */
+    command: CommandRef;
+    palette?: ColorPalette;
+    labelKey?: TranslationKey;
+    label?: string;
+}
 export interface GridPickerItem extends ToolbarItemBase {
     type: "gridPicker";
     /** Command dispatched with `{ rows, cols }` as payload. */
@@ -171,5 +193,5 @@ export interface CustomItem extends ToolbarItemBase {
     type: "custom";
     render: (api: ToolbarActionApi) => JSX.Element;
 }
-export type ToolbarItem = ButtonItem | ToggleItem | SplitItem | MenuItem | SelectItem | StyleGalleryItem | ColorPickerItem | GridPickerItem | SeparatorItem | GroupItem | CustomItem;
+export type ToolbarItem = ButtonItem | ToggleItem | SplitItem | MenuItem | SelectItem | StyleGalleryItem | ColorPickerItem | PictureBorderItem | GridPickerItem | SeparatorItem | GroupItem | CustomItem;
 export type ToolbarItemType = ToolbarItem["type"];

package/dist/ui/editorUiTypes.d.ts

@@ -81,6 +81,7 @@ export interface LayoutOptionsOverlay {
 export interface EditorSurfaceProps {
     state: Accessor<EditorState>;
     documentLayout: Accessor<EditorLayoutDocument>;
+    remoteWebFonts?: boolean;
     measuredBlockHeights?: Accessor<Record<string, number>>;
     measuredParagraphLayouts?: Accessor<Record<string, EditorLayoutParagraph>>;
     /**

package/dist/ui/textMeasurement/fontMetrics.d.ts

@@ -1,8 +1,9 @@
 import { EditorTextStyle } from '../../core/model.js';
 
-export declare function getMeasuredFontSize(styles: EditorTextStyle | undefined, fallbackFontSize: number): number;
+export declare function getMeasuredFontSize(styles: EditorTextStyle | undefined, fallbackFontSize: number, sourceChar?: string): number;
 export declare function getRenderedMeasureChar(char: string, styles: EditorTextStyle | undefined): string;
-export declare function buildCanvasFont(styles: EditorTextStyle | undefined, fallbackFontSize: number): string;
+export declare function buildCanvasFont(styles: EditorTextStyle | undefined, fallbackFontSize: number, sourceChar?: string): string;
+export declare function measureCanvasTextWidth(text: string, font: string): number | null;
 /**
  * Clears the cached natural line heights. Required after the metric source for a
  * family changes (precise font mode toggling, or real metrics arriving), since

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oasis-editor",
-  "version": "0.0.134",
+  "version": "0.0.136",
   "type": "module",
   "repository": {
     "type": "git",