oasis-editor 0.0.19 → 0.0.20

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/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/package.json

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