oasis-editor 0.0.19 → 0.0.21

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

@@ -1,4 +1,5 @@
 import { OasisPlugin } from '../../core/plugin.js';
+import { EditorPageMargins } from '../../core/model.js';
 import { TextCaseMode } from '../../core/commands/text.js';
 import { ToolbarStyleState } from '../../ui/toolbarStyleState.js';
 
@@ -108,10 +109,8 @@ export interface EssentialsSectionCapability {
     setOrientation: (orientation: "portrait" | "landscape") => void;
     breakNextPage: () => void;
     breakContinuous: () => void;
-    setPageMargins: (margins: {
-        left?: number;
-        right?: number;
-    }) => void;
+    getMargins: () => EditorPageMargins | undefined;
+    setPageMargins: (margins: Partial<EditorPageMargins>) => void;
 }
 export interface EssentialsTableCapability {
     insideTable: () => boolean;

package/dist/ui/components/Toolbar/groups/MarginsGroup.d.ts

@@ -0,0 +1,7 @@
+import { JSX } from 'solid-js';
+import { ToolbarActionApi } from '../schema/items.js';
+
+/** Word-style page-margin presets dropdown plus an inline custom form. */
+export declare function MarginsGroup(props: {
+    api: ToolbarActionApi;
+}): JSX.Element;

package/dist/ui/components/Toolbar/groups/SectionGroup.d.ts

@@ -1,6 +1,7 @@
+import { JSX } from 'solid-js';
 import { ToolbarActionApi } from '../schema/items.js';
 
 /** Section page-setup panel (orientation, section breaks) — command-driven. */
 export declare function SectionGroup(props: {
     api: ToolbarActionApi;
-}): import("solid-js").JSX.Element;
+}): JSX.Element;

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

@@ -0,0 +1,34 @@
+import { TranslationKey } from '../../../i18n/index.js';
+
+/** Convert a centimetre measurement to a rounded pixel value. */
+export declare function cmToPx(cm: number): number;
+/** Convert pixels back to centimetres (for display in the custom form). */
+export declare function pxToCm(px: number): number;
+export interface MarginPreset {
+    id: string;
+    labelKey: TranslationKey;
+    /** Margins in centimetres, mirroring Word's presets. */
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+}
+/**
+ * Word's built-in page-margin presets (values shown in the screenshot use the
+ * pt-BR localisation: "Normal" follows ABNT 2.5/2.5/3/3 cm rather than 1 inch).
+ */
+export declare const MARGIN_PRESETS: MarginPreset[];
+/** Preset margins converted to the px units stored on the page settings. */
+export declare function presetMarginsPx(preset: MarginPreset): {
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+};
+/** True when the current px margins match this preset (±1px tolerance). */
+export declare function marginsMatchPreset(margins: {
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+}, preset: MarginPreset): boolean;

package/dist/ui/components/Toolbar/presets/builtinToolbarIds.d.ts

@@ -37,6 +37,7 @@ export declare const OASIS_TOOLBAR_ITEMS: {
     readonly lineSpacing: "editor-toolbar-line-spacing-control";
     readonly metrics: "editor-toolbar-metrics";
     readonly table: "editor-toolbar-table";
+    readonly margins: "editor-toolbar-margins";
     readonly section: "editor-toolbar-section";
 };
 export type OasisToolbarItemId = (typeof OASIS_TOOLBAR_ITEMS)[keyof typeof OASIS_TOOLBAR_ITEMS];

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

@@ -6,6 +6,7 @@ export interface ToolbarButtonProps extends JSX.ButtonHTMLAttributes<HTMLButtonE
     active?: boolean;
     tooltip?: string;
     wide?: boolean;
+    ribbonSize?: "normal" | "large";
 }
 /** Generic toolbar button primitive (icon and/or label, active/disabled). */
 export declare function Button(props: ToolbarButtonProps): JSX.Element;

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

@@ -8,6 +8,7 @@ export interface MenuProps {
     active?: boolean;
     disabled?: boolean;
     hideChevron?: boolean;
+    ribbonSize?: "normal" | "large";
     /** Extra class for the popover panel. */
     panelClass?: string;
     keepMounted?: boolean;

package/dist/ui/components/Toolbar/ribbon/RibbonGroup.d.ts

@@ -1,3 +1,4 @@
+import { JSX } from 'solid-js';
 import { ToolbarActionApi } from '../schema/items.js';
 import { RibbonGroupModel } from './ribbonModel.js';
 
@@ -5,4 +6,4 @@ export interface RibbonGroupProps {
     group: RibbonGroupModel;
     api: ToolbarActionApi;
 }
-export declare function RibbonGroup(props: RibbonGroupProps): import("solid-js").JSX.Element;
+export declare function RibbonGroup(props: RibbonGroupProps): JSX.Element;

package/dist/ui/components/Toolbar/ribbon/ribbonModel.d.ts

@@ -7,6 +7,7 @@ export interface RibbonTabDefinition {
 export interface RibbonGroupModel {
     id: string;
     label: string;
+    largeItems: ToolbarItem[];
     rows: Record<RibbonRow, ToolbarItem[]>;
     order: number;
 }
@@ -17,5 +18,6 @@ export declare const DEFAULT_RIBBON_ROW: RibbonRow;
 export declare function normalizeRibbonTab(tab: ToolbarItem["tab"]): RibbonTabId;
 export declare function normalizeRibbonGroup(group: ToolbarItem["group"]): string;
 export declare function normalizeRibbonRow(row: ToolbarItem["row"]): RibbonRow;
+export declare function isLargeRibbonItem(item: ToolbarItem): boolean;
 export declare function ribbonGroupLabel(group: string): string;
 export declare function buildRibbonGroups(items: ToolbarItem[], tab: RibbonTabId): RibbonGroupModel[];

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

@@ -7,6 +7,7 @@ import { ColorPalette } from './palette.js';
 export declare const RIBBON_TABS: readonly ["file", "home", "insert", "draw", "layout", "references", "collaboration", "protection", "view", "plugins", "ai"];
 export type RibbonTabId = (typeof RIBBON_TABS)[number];
 export type RibbonRow = 1 | 2;
+export type RibbonSize = "normal" | "large";
 /** Reactive snapshot of a command's state, as consumed by toolbar items. */
 export interface ToolbarCommandState {
     isEnabled: boolean;
@@ -50,6 +51,8 @@ interface ToolbarItemBase extends ItemReactiveOverrides {
     group?: string;
     /** Two-row ribbon placement. Missing values default to row 1. */
     row?: RibbonRow;
+    /** Ribbon-only visual scale. Large items span both toolbar rows. */
+    ribbonSize?: RibbonSize;
     testId?: string;
     tooltipKey?: TranslationKey;
     tooltip?: string;

package/package.json

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