@twip/web 0.0.0-canary-4e9c983 → 0.0.0-canary-092e560

package/dist/THIRD-PARTY-NOTICES.md

@@ -3384,7 +3384,7 @@ the following restrictions:
 3. This notice may not be removed or altered from any source distribution.
 ```
 
-## C and C++ libraries, and fonts
+## C and C++ libraries, fonts and data
 
 ### Skia (BSD-3-Clause)
 
@@ -5455,3 +5455,525 @@ given a different name.
 
 $Id$
 ```
+
+### ECMA-376 preset shape definitions (LicenseRef-Ecma)
+
+In: the native library and the WebAssembly module
+
+```
+The preset shape geometries built into the engine are generated from presetShapeDefinitions.xml, an electronic insert
+of ECMA-376 Part 1, Office Open XML File Formats - Fundamentals and Markup Language Reference, 5th edition (December
+2016), https://ecma-international.org/publications-and-standards/standards/ecma-376/
+
+COPYRIGHT NOTICE
+(c) Ecma International
+By obtaining and/or copying this work, you (the licensee) agree that you have read, understood, and will comply
+with the following terms and conditions.
+This document may be copied, published and distributed to others, and certain derivative works of it may be
+prepared, copied, published, and distributed, in whole or in part, provided that the above copyright notice and
+this Copyright License and Disclaimer are included on all such copies and derivative works. The only derivative
+works that are permissible under this Copyright License and Disclaimer are:
+(i) works which incorporate all or portion of this document for the purpose of providing commentary or
+    explanation (such as an annotated version of the document),
+(ii) works which incorporate all or portion of this document for the purpose of incorporating features that
+    provide accessibility,
+(iii) translations of this document into languages other than English and into different formats and
+(iv) works by making use of this specification in standard conformant products by implementing (e.g. by
+    copy and paste wholly or partly) the functionality therein.
+However, the content of this document itself may not be modified in any way, including by removing the
+copyright notice or references to Ecma International, except as required to translate it into languages other
+than English or into a different format.
+The official version of an Ecma International document is the English language version on the Ecma
+International website. In the event of discrepancies between a translated version and the official version, the
+official version shall govern.
+The limited permissions granted above are perpetual and will not be revoked by Ecma International or its
+successors or assigns.
+This document and the information contained herein is provided on an "AS IS" basis and ECMA
+INTERNATIONAL DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT
+THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY OWNERSHIP RIGHTS OR ANY IMPLIED WARRANTIES OF
+MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
+```
+
+### JetBrains Mono (subset) (OFL-1.1)
+
+In: the native library and the WebAssembly module
+
+```
+Copyright 2020 The JetBrains Mono Project Authors (https://github.com/JetBrains/JetBrainsMono)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.
+```
+
+### LibreOffice AutoCorrect list (en-US) (MPL-2.0)
+
+In: the native library and the WebAssembly module
+
+```
+The AutoCorrect replacement list (crates/twip/src/editing/autocorrect/en-US.tsv) is derived from LibreOffice's
+extras/source/autocorr/lang/en-US/DocumentList.xml (https://github.com/LibreOffice/core), and is licensed under the
+Mozilla Public License 2.0:
+
+Mozilla Public License Version 2.0
+==================================
+
+1. Definitions
+--------------
+
+1.1. "Contributor"
+    means each individual or legal entity that creates, contributes to
+    the creation of, or owns Covered Software.
+
+1.2. "Contributor Version"
+    means the combination of the Contributions of others (if any) used
+    by a Contributor and that particular Contributor's Contribution.
+
+1.3. "Contribution"
+    means Covered Software of a particular Contributor.
+
+1.4. "Covered Software"
+    means Source Code Form to which the initial Contributor has attached
+    the notice in Exhibit A, the Executable Form of such Source Code
+    Form, and Modifications of such Source Code Form, in each case
+    including portions thereof.
+
+1.5. "Incompatible With Secondary Licenses"
+    means
+
+    (a) that the initial Contributor has attached the notice described
+        in Exhibit B to the Covered Software; or
+
+    (b) that the Covered Software was made available under the terms of
+        version 1.1 or earlier of the License, but not also under the
+        terms of a Secondary License.
+
+1.6. "Executable Form"
+    means any form of the work other than Source Code Form.
+
+1.7. "Larger Work"
+    means a work that combines Covered Software with other material, in
+    a separate file or files, that is not Covered Software.
+
+1.8. "License"
+    means this document.
+
+1.9. "Licensable"
+    means having the right to grant, to the maximum extent possible,
+    whether at the time of the initial grant or subsequently, any and
+    all of the rights conveyed by this License.
+
+1.10. "Modifications"
+    means any of the following:
+
+    (a) any file in Source Code Form that results from an addition to,
+        deletion from, or modification of the contents of Covered
+        Software; or
+
+    (b) any new file in Source Code Form that contains any Covered
+        Software.
+
+1.11. "Patent Claims" of a Contributor
+    means any patent claim(s), including without limitation, method,
+    process, and apparatus claims, in any patent Licensable by such
+    Contributor that would be infringed, but for the grant of the
+    License, by the making, using, selling, offering for sale, having
+    made, import, or transfer of either its Contributions or its
+    Contributor Version.
+
+1.12. "Secondary License"
+    means either the GNU General Public License, Version 2.0, the GNU
+    Lesser General Public License, Version 2.1, the GNU Affero General
+    Public License, Version 3.0, or any later versions of those
+    licenses.
+
+1.13. "Source Code Form"
+    means the form of the work preferred for making modifications.
+
+1.14. "You" (or "Your")
+    means an individual or a legal entity exercising rights under this
+    License. For legal entities, "You" includes any entity that
+    controls, is controlled by, or is under common control with You. For
+    purposes of this definition, "control" means (a) the power, direct
+    or indirect, to cause the direction or management of such entity,
+    whether by contract or otherwise, or (b) ownership of more than
+    fifty percent (50%) of the outstanding shares or beneficial
+    ownership of such entity.
+
+2. License Grants and Conditions
+--------------------------------
+
+2.1. Grants
+
+Each Contributor hereby grants You a world-wide, royalty-free,
+non-exclusive license:
+
+(a) under intellectual property rights (other than patent or trademark)
+    Licensable by such Contributor to use, reproduce, make available,
+    modify, display, perform, distribute, and otherwise exploit its
+    Contributions, either on an unmodified basis, with Modifications, or
+    as part of a Larger Work; and
+
+(b) under Patent Claims of such Contributor to make, use, sell, offer
+    for sale, have made, import, and otherwise transfer either its
+    Contributions or its Contributor Version.
+
+2.2. Effective Date
+
+The licenses granted in Section 2.1 with respect to any Contribution
+become effective for each Contribution on the date the Contributor first
+distributes such Contribution.
+
+2.3. Limitations on Grant Scope
+
+The licenses granted in this Section 2 are the only rights granted under
+this License. No additional rights or licenses will be implied from the
+distribution or licensing of Covered Software under this License.
+Notwithstanding Section 2.1(b) above, no patent license is granted by a
+Contributor:
+
+(a) for any code that a Contributor has removed from Covered Software;
+    or
+
+(b) for infringements caused by: (i) Your and any other third party's
+    modifications of Covered Software, or (ii) the combination of its
+    Contributions with other software (except as part of its Contributor
+    Version); or
+
+(c) under Patent Claims infringed by Covered Software in the absence of
+    its Contributions.
+
+This License does not grant any rights in the trademarks, service marks,
+or logos of any Contributor (except as may be necessary to comply with
+the notice requirements in Section 3.4).
+
+2.4. Subsequent Licenses
+
+No Contributor makes additional grants as a result of Your choice to
+distribute the Covered Software under a subsequent version of this
+License (see Section 10.2) or under the terms of a Secondary License (if
+permitted under the terms of Section 3.3).
+
+2.5. Representation
+
+Each Contributor represents that the Contributor believes its
+Contributions are its original creation(s) or it has sufficient rights
+to grant the rights to its Contributions conveyed by this License.
+
+2.6. Fair Use
+
+This License is not intended to limit any rights You have under
+applicable copyright doctrines of fair use, fair dealing, or other
+equivalents.
+
+2.7. Conditions
+
+Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted
+in Section 2.1.
+
+3. Responsibilities
+-------------------
+
+3.1. Distribution of Source Form
+
+All distribution of Covered Software in Source Code Form, including any
+Modifications that You create or to which You contribute, must be under
+the terms of this License. You must inform recipients that the Source
+Code Form of the Covered Software is governed by the terms of this
+License, and how they can obtain a copy of this License. You may not
+attempt to alter or restrict the recipients' rights in the Source Code
+Form.
+
+3.2. Distribution of Executable Form
+
+If You distribute Covered Software in Executable Form then:
+
+(a) such Covered Software must also be made available in Source Code
+    Form, as described in Section 3.1, and You must inform recipients of
+    the Executable Form how they can obtain a copy of such Source Code
+    Form by reasonable means in a timely manner, at a charge no more
+    than the cost of distribution to the recipient; and
+
+(b) You may distribute such Executable Form under the terms of this
+    License, or sublicense it under different terms, provided that the
+    license for the Executable Form does not attempt to limit or alter
+    the recipients' rights in the Source Code Form under this License.
+
+3.3. Distribution of a Larger Work
+
+You may create and distribute a Larger Work under terms of Your choice,
+provided that You also comply with the requirements of this License for
+the Covered Software. If the Larger Work is a combination of Covered
+Software with a work governed by one or more Secondary Licenses, and the
+Covered Software is not Incompatible With Secondary Licenses, this
+License permits You to additionally distribute such Covered Software
+under the terms of such Secondary License(s), so that the recipient of
+the Larger Work may, at their option, further distribute the Covered
+Software under the terms of either this License or such Secondary
+License(s).
+
+3.4. Notices
+
+You may not remove or alter the substance of any license notices
+(including copyright notices, patent notices, disclaimers of warranty,
+or limitations of liability) contained within the Source Code Form of
+the Covered Software, except that You may alter any license notices to
+the extent required to remedy known factual inaccuracies.
+
+3.5. Application of Additional Terms
+
+You may choose to offer, and to charge a fee for, warranty, support,
+indemnity or liability obligations to one or more recipients of Covered
+Software. However, You may do so only on Your own behalf, and not on
+behalf of any Contributor. You must make it absolutely clear that any
+such warranty, support, indemnity, or liability obligation is offered by
+You alone, and You hereby agree to indemnify every Contributor for any
+liability incurred by such Contributor as a result of warranty, support,
+indemnity or liability terms You offer. You may include additional
+disclaimers of warranty and limitations of liability specific to any
+jurisdiction.
+
+4. Inability to Comply Due to Statute or Regulation
+---------------------------------------------------
+
+If it is impossible for You to comply with any of the terms of this
+License with respect to some or all of the Covered Software due to
+statute, judicial order, or regulation then You must: (a) comply with
+the terms of this License to the maximum extent possible; and (b)
+describe the limitations and the code they affect. Such description must
+be placed in a text file included with all distributions of the Covered
+Software under this License. Except to the extent prohibited by statute
+or regulation, such description must be sufficiently detailed for a
+recipient of ordinary skill to be able to understand it.
+
+5. Termination
+--------------
+
+5.1. The rights granted under this License will terminate automatically
+if You fail to comply with any of its terms. However, if You become
+compliant, then the rights granted under this License from a particular
+Contributor are reinstated (a) provisionally, unless and until such
+Contributor explicitly and finally terminates Your grants, and (b) on an
+ongoing basis, if such Contributor fails to notify You of the
+non-compliance by some reasonable means prior to 60 days after You have
+come back into compliance. Moreover, Your grants from a particular
+Contributor are reinstated on an ongoing basis if such Contributor
+notifies You of the non-compliance by some reasonable means, this is the
+first time You have received notice of non-compliance with this License
+from such Contributor, and You become compliant prior to 30 days after
+Your receipt of the notice.
+
+5.2. If You initiate litigation against any entity by asserting a patent
+infringement claim (excluding declaratory judgment actions,
+counter-claims, and cross-claims) alleging that a Contributor Version
+directly or indirectly infringes any patent, then the rights granted to
+You by any and all Contributors for the Covered Software under Section
+2.1 of this License shall terminate.
+
+5.3. In the event of termination under Sections 5.1 or 5.2 above, all
+end user license agreements (excluding distributors and resellers) which
+have been validly granted by You or Your distributors under this License
+prior to termination shall survive termination.
+
+************************************************************************
+*                                                                      *
+*  6. Disclaimer of Warranty                                           *
+*  -------------------------                                           *
+*                                                                      *
+*  Covered Software is provided under this License on an "as is"       *
+*  basis, without warranty of any kind, either expressed, implied, or  *
+*  statutory, including, without limitation, warranties that the       *
+*  Covered Software is free of defects, merchantable, fit for a        *
+*  particular purpose or non-infringing. The entire risk as to the     *
+*  quality and performance of the Covered Software is with You.        *
+*  Should any Covered Software prove defective in any respect, You     *
+*  (not any Contributor) assume the cost of any necessary servicing,   *
+*  repair, or correction. This disclaimer of warranty constitutes an   *
+*  essential part of this License. No use of any Covered Software is   *
+*  authorized under this License except under this disclaimer.         *
+*                                                                      *
+************************************************************************
+
+************************************************************************
+*                                                                      *
+*  7. Limitation of Liability                                          *
+*  --------------------------                                          *
+*                                                                      *
+*  Under no circumstances and under no legal theory, whether tort      *
+*  (including negligence), contract, or otherwise, shall any           *
+*  Contributor, or anyone who distributes Covered Software as          *
+*  permitted above, be liable to You for any direct, indirect,         *
+*  special, incidental, or consequential damages of any character      *
+*  including, without limitation, damages for lost profits, loss of    *
+*  goodwill, work stoppage, computer failure or malfunction, or any    *
+*  and all other commercial damages or losses, even if such party      *
+*  shall have been informed of the possibility of such damages. This   *
+*  limitation of liability shall not apply to liability for death or   *
+*  personal injury resulting from such party's negligence to the       *
+*  extent applicable law prohibits such limitation. Some               *
+*  jurisdictions do not allow the exclusion or limitation of           *
+*  incidental or consequential damages, so this exclusion and          *
+*  limitation may not apply to You.                                    *
+*                                                                      *
+************************************************************************
+
+8. Litigation
+-------------
+
+Any litigation relating to this License may be brought only in the
+courts of a jurisdiction where the defendant maintains its principal
+place of business and such litigation shall be governed by laws of that
+jurisdiction, without reference to its conflict-of-law provisions.
+Nothing in this Section shall prevent a party's ability to bring
+cross-claims or counter-claims.
+
+9. Miscellaneous
+----------------
+
+This License represents the complete agreement concerning the subject
+matter hereof. If any provision of this License is held to be
+unenforceable, such provision shall be reformed only to the extent
+necessary to make it enforceable. Any law or regulation which provides
+that the language of a contract shall be construed against the drafter
+shall not be used to construe this License against a Contributor.
+
+10. Versions of the License
+---------------------------
+
+10.1. New Versions
+
+Mozilla Foundation is the license steward. Except as provided in Section
+10.3, no one other than the license steward has the right to modify or
+publish new versions of this License. Each version will be given a
+distinguishing version number.
+
+10.2. Effect of New Versions
+
+You may distribute the Covered Software under the terms of the version
+of the License under which You originally received the Covered Software,
+or under the terms of any subsequent version published by the license
+steward.
+
+10.3. Modified Versions
+
+If you create software not governed by this License, and you want to
+create a new license for such software, you may create and use a
+modified version of this License if you rename the license and remove
+any references to the name of the license steward (except to note that
+such modified license differs from this License).
+
+10.4. Distributing Source Code Form that is Incompatible With Secondary
+Licenses
+
+If You choose to distribute Source Code Form that is Incompatible With
+Secondary Licenses under the terms of this version of the License, the
+notice described in Exhibit B of this License must be attached.
+
+Exhibit A - Source Code Form License Notice
+-------------------------------------------
+
+  This Source Code Form is subject to the terms of the Mozilla Public
+  License, v. 2.0. If a copy of the MPL was not distributed with this
+  file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+If it is not possible or desirable to put the notice in a particular
+file, then You may include the notice in a location (such as a LICENSE
+file in a relevant directory) where a recipient would be likely to look
+for such a notice.
+
+You may add additional accurate notices of copyright ownership.
+
+Exhibit B - "Incompatible With Secondary Licenses" Notice
+---------------------------------------------------------
+
+  This Source Code Form is "Incompatible With Secondary Licenses", as
+  defined by the Mozilla Public License, v. 2.0.
+```

package/dist/commands.d.ts

@@ -1,8 +1,9 @@
 import type { RichText } from './review.js';
 import type { ControlKind, ControlOptions, DataBinding } from './services/elements.js';
-import type { TabAlignment, TabLeader } from './services/ruler.js';
-import type { HighlightColor, HorizontalPosition, LineSpacing, MarkupView, ObjectWrap, RowHeight, TableWidth, UnderlineStyle, VerticalPosition, WrapSide } from './state.js';
-import type { Color, CommentId, ElementId, Points, RevisionId, StyleId } from './types.js';
+import type { TabAlignment, TabLeader, TabSelector } from './services/ruler.js';
+import type { ViewOptions } from './services/view.js';
+import type { AutoCorrectChange, HighlightColor, HorizontalPosition, LineSpacing, MarkupView, ObjectWrap, RowHeight, TablePosition, TableWidth, UnderlineStyle, VerticalPosition, WrapSide } from './state.js';
+import type { Arrange, Color, CommentId, Degrees, EffectsChange, ElementId, FillValue, FlipAxis, LineChange, PictureAdjustChange, Points, RevisionId, ShapeAdjust, ShapeInsert, ShapePreset, ShapeTextChange, StyleId } from './types.js';
 /** Which elements a field command acts on: the given ids, or the selection's by default. */
 export interface FieldTargets {
     /** The fields; default: the selection's. */
@@ -254,6 +255,11 @@ export interface Commands {
     }): Promise<void>;
     /** Inserts a text box. */
     insertTextBox(): Promise<void>;
+    /**
+     * Inserts a floating shape at the caret's paragraph, in front of the text, with the theme's default style, and
+     * selects it.
+     */
+    insertShape(options: ShapeInsert): Promise<void>;
     /** Inserts a footnote. */
     insertFootnote(): Promise<void>;
     /** Inserts an endnote. */
@@ -368,6 +374,13 @@ export interface Commands {
         bandedRows?: boolean;
         bandedColumns?: boolean;
     }): Promise<void>;
+    /**
+     * Positions the caret's table, so text wraps around it, as dragging its move handle does: a table without a
+     * position gets one across from the margin and down from the paragraph, and each axis given is aligned, offset, or
+     * (with neither) kept where it is and measured from its new reference. Unset fields keep their value; `null` puts
+     * the table back in the text.
+     */
+    setTablePosition(position: TablePosition | null): Promise<void>;
     /** Sets the object's size, 1 to 1584. */
     setObjectSize(options: {
         width?: Points;
@@ -406,6 +419,32 @@ export interface Commands {
     }): Promise<void>;
     /** Deletes the object. */
     deleteObject(): Promise<void>;
+    /** Changes the shape's preset geometry; its text, fill, outline and effects stay and its adjust values reset. */
+    setShapePreset(preset: ShapePreset): Promise<void>;
+    /** Sets one of the shape's adjust values. */
+    setShapeAdjust(options: ShapeAdjust): Promise<void>;
+    /** Sets the selected objects' fill; `fromStyle` gives them the style reference's again. */
+    setShapeFill(fill: FillValue): Promise<void>;
+    /** Sets the selected objects' outline; unset fields keep their value. */
+    setShapeLine(change: LineChange): Promise<void>;
+    /** Sets the selected objects' shadows, glow, soft edge and blur; unset fields keep their value, `null` removes. */
+    setShapeEffects(change: EffectsChange): Promise<void>;
+    /** Sets the shape's text insets, anchor, autofit, wrapping and direction; unset fields keep their value. */
+    setShapeText(change: ShapeTextChange): Promise<void>;
+    /** Sets the picture's transparency, greyscale, brightness and contrast; unset fields keep their value. */
+    setPictureAdjust(change: PictureAdjustChange): Promise<void>;
+    /** Sets the selected objects' rotation, 0 to 360 degrees clockwise. */
+    setObjectRotation(degrees: Degrees): Promise<void>;
+    /** Flips the selected objects. */
+    flipObject(axis: FlipAxis): Promise<void>;
+    /** Moves the floating object in the paint order, or behind or in front of the text. */
+    arrangeObject(where: Arrange): Promise<void>;
+    /** Groups the selected floating objects: two or more, in one story. The group is selected. */
+    groupObjects(): Promise<void>;
+    /** Ungroups the selected group. Its children are selected. */
+    ungroupObjects(): Promise<void>;
+    /** Selects the next or previous child of the selected group. View. */
+    selectGroupChild(direction: 'next' | 'previous'): Promise<void>;
     /** Changes a field's code or display. */
     setField(options: {
         id: ElementId;
@@ -584,26 +623,40 @@ export interface Commands {
     }): Promise<void>;
     /** Sets the zoom: 10 to 500 percent, or a fit. */
     setZoom(zoom: number | 'pageWidth' | 'wholePage'): Promise<void>;
-    /** Shows or hides formatting marks (Ctrl+Shift+8), gridlines and text boundaries. */
-    setViewOptions(options: {
-        formattingMarks?: boolean;
-        gridlines?: boolean;
-        textBoundaries?: boolean;
-        liveLayout?: boolean;
-    }): Promise<void>;
+    /**
+     * Sets view options: formatting marks (Ctrl+Shift+8), gridlines, text boundaries, live layout, the chrome's theme
+     * and accent, the page's appearance, the measuring detail and the object grid.
+     */
+    setViewOptions(options: ViewOptions): Promise<void>;
     /** Switches between editing and design mode. */
     setMode(mode: 'editing' | 'design'): Promise<void>;
+    /** Sets what a click on the ruler adds; answers the tab type popover. View. */
+    setRulerTabType(type: TabSelector): Promise<void>;
+    /** Asks for the tab type popover (`popoverRequested`). View. */
+    showTabTypes(): Promise<void>;
+    /** Asks for the options of the tab stop nearest the caret (`popoverRequested`). View. */
+    showTabStop(): Promise<void>;
+    /** Sets what typing corrects: the rules given switch, the lists given replace the shipped ones. A session setting: no undo. */
+    setAutoCorrect(change: AutoCorrectChange): Promise<void>;
+    /** Puts back what was typed in place of the correction just made: undoes it when it is the last step, else one undo step. */
+    revertAutoCorrect(): Promise<void>;
+    /** Reverts the correction just made, as `revertAutoCorrect` does, and never makes it again (adds it to `autoCorrect.never`). */
+    neverAutoCorrect(): Promise<void>;
+    /** Asks for the options of the correction just made (`popoverRequested`), Alt+Shift+F10. View. */
+    showAutoCorrectOptions(): Promise<void>;
+    /** Dismisses the popover asked for (`popoverClosed`), for an application that closes its own on Esc or a press elsewhere; with none open, nothing. View. */
+    closePopover(): Promise<void>;
 }
 /** A command id: the method name, the batch op's `type`, the catalog id and the key in `state.commands`. */
 export type CommandId = keyof Commands;
 /**
- * An op's fields besides `type`. A single argument (a primitive, {@link RichText}, bytes, an array, or a union with a
- * primitive) goes in `value`; an options object, and a tagged value such as {@link LineSpacing} or
- * {@link TableWidth}, is spread into the op.
+ * An op's fields besides `type`. A single argument (a primitive, {@link RichText}, bytes, an array, a
+ * {@link FillValue}, whose `type` would clash with the op's, or a union with a primitive) goes in `value`; an options
+ * object, and a tagged value such as {@link LineSpacing} or {@link TableWidth}, is spread into the op.
  */
 export type OpArgs<K extends CommandId> = Parameters<Commands[K]> extends [] ? {} : [Exclude<Parameters<Commands[K]>[0], undefined>] extends [string | number | boolean | null] ? {
     value: Exclude<Parameters<Commands[K]>[0], undefined>;
-} : [Exclude<Parameters<Commands[K]>[0], undefined>] extends [RichText | Uint8Array | readonly unknown[]] ? {
+} : [Exclude<Parameters<Commands[K]>[0], undefined>] extends [RichText | Uint8Array | FillValue | readonly unknown[]] ? {
     value: Exclude<Parameters<Commands[K]>[0], undefined>;
 } : [Exclude<Parameters<Commands[K]>[0], undefined>] extends [object] ? Exclude<Parameters<Commands[K]>[0], undefined> : {
     value: Exclude<Parameters<Commands[K]>[0], undefined>;