@synopackageland/ui 0.20.5 → 0.20.7

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## 0.20.7 (2026-11-05)
+
+- An `AppLayout` inside another one takes its first width measurement only after the containing layout has drawn its own measured layout, still before the first paint. Children mount before their parents, so a page's layout measured the shell's guessed layout and its aside slid once the shell settled
+- Reduced motion and `data-ui-motion="off"` only shorten transitions a rule declares. An element no rule gives a `transition-property` now has none, instead of a 0.01ms transition of `all` that made a change such as a layout's padding land a frame late
+- ContextMenu is placed at the pointer from its first position. Reka moved its anchor from the trigger to the pointer only after the menu mounted, so near an edge the first position beside the trigger left a few px of room, the menu shrank to it and then stayed narrow at the pointer (16px wide at the right edge of a 768px window)
+- A stacked `FormItem` or `SettingsRow` (label over the control in a narrow row) lets an `md` or `lg` control fill the column instead of stopping at 320/480px; `xs`, `sm` and CSS lengths keep their cap, so a field in a phone bottom sheet has the same space on both sides
+- In the mobile layout the `AppLayout` page scroller no longer reserves a scrollbar gutter, which pushed content off centre where scrollbars overlay
+- A Tooltip or Popover whose trigger is a component no longer throws when it reads the floating padding from Reka's virtual anchor
+- The DataGrid and DataTable phone list joins its two subtitle columns with a gap instead of a middle dot, and the sort summary reads "Name, ascending"
+- The pressed tint follows the text colour under a dark app root instead of keeping the light step
+- The DatePicker and Select phone sheets take their field size from `--ui-font-size-field`
+
+## 0.20.6 (2026-11-05)
+
+- Closed navigation drawer viewports let clicks reach the app in embedded windows and full pages; an open drawer keeps its dismissible backdrop
+- Phone bars preserve short brand names when actions compete for space; action labels shrink first while menu targets stay usable
+- Phone titles use the free bar width and stay centred only when they fit; short and multiword brand names remain readable without trailing actions
+- Phone segment labels stay on one line with ellipsis; up to four segments share a zero flex basis, reserve count pills and keep notification dots inside the track
+- Scoped preflight gives bare elements and pseudo-elements a zero-width border base inside the app, preserving explicit component borders and host styles
+- Dialogs without a description explicitly opt out of `aria-describedby`; supplied descriptions remain linked to the dialog
+- On a phone, a DatePicker with `editable` shows the calendar button and opens the calendar sheet; a typed text field would raise the keyboard under the sheet
+- A compact RichTextEditor on a touch screen labels the keyboard's return key Send (`enterkeyhint="send"`) and sends with it, since a phone keyboard has no Ctrl+Enter; an open @ list still takes Enter to pick
+- FilePicker shows a `dropzone` as the choose button on a touch screen, where nothing can be dragged onto it; its `description` stays as a line above the button
+
 ## 0.20.5 (2026-11-05)
 
 - In a DSM window on a touch device, a small Button, IconButton, checkbox, radio, switch or tappable Tag keeps its 44px tap box around itself. The host reset made these controls static, so the tap box covered the nearest positioned ancestor (a whole board or panel) and took every tap in it. `check:mobile` now fails when a tap box reaches past twice its control or 64px
@@ -27,12 +51,12 @@
 - Popover, DropdownMenu, Select and the combobox selects share one layer stack: Escape closes only the topmost surface, and an Escape that ends an IME composition closes nothing. `provideOverlayMotion('none')` makes popups inside a grid editor appear at once
 - Skeletons take the final geometry (`SectionSkeleton variant="grid" | "cards" | "fields"`); shapes show after 300ms. Toasts: success 3s, info and warning 5s, danger stays; `pending()` turns into its result in place. New `StatusSlot` and `useShowAfter`. `ToastProvider` drops its `duration` prop
 - New `VirtualCardGrid`, `CardCover` and `CardField`: a virtual card gallery whose card height comes from `cardHeight()`, whose column count is known before the first card renders, and which holds its columns while a side region moves
-- The interaction core (outside layers, IME guard, focus, pointer gesture, edit session), the drag kit (`createDragKit`, `useDragKit`, auto-scroll) and the motion helpers are exported from the package entry ([UX foundation](docs/ux-foundation.md))
-- New `@synopackageland/ui/grid` entry: `GridHost`, a canvas grid ported from Teable's MIT grid, with cell renderers for every field kind, editing with IME-safe first keys, and a save-status store. Load it lazily
+- The interaction core (outside layers, IME guard, focus, pointer gesture, edit session), the drag kit (`createDragKit`, `useDragKit`, auto-scroll) and the motion helpers are exported from the package entry
+- New `@synopackageland/ui/grid` entry: `GridHost`, a canvas grid with cell renderers for every field kind, editing with IME-safe first keys, and a save-status store. Load it lazily
 - Five new accessible labels (Checked, Not checked, Rating, Saving, Not saved) and `Restore {name}`, in all nine locales
 - Phone viewport and keyboard layer: `AppRoot full-page` makes the root a `100dvh` page whose document never scrolls (no overscroll reload) and calls `ensureDeviceViewport()`, which now adds `viewport-fit=cover, interactive-widget=resizes-content` (zoom stays on). Every `AppRoot` publishes `--ui-vvh`, `--ui-vv-top`, `--ui-kb-inset` and `data-ui-keyboard="open"` from the visual viewport (60px threshold, one read per frame) and keeps the focused field visible inside its own scroller. New `useVisualViewport`, `focusWithoutScroll` and `useBackDismiss` (Back closes the top sheet, drawer or pushed page only); `useSoftKeyboard` is exported and confirms the keyboard with the viewport
 - Phone and touch: the touch rules now apply in every app (they were keyed on a theme name nobody set). On a coarse pointer every field, select and editable text is 16px, and small controls get a 44px tap box. A phone (640px and narrower) reads 15px body, 13px secondary text, 44px fields and form buttons, 48px list and menu rows and one 48px header; long words break instead of widening a row; hover styles apply only where hover exists ([Mobile-native UI](docs/mobile-native.md))
-- Third-party notices for the ported Teable and Baserow code are in `LICENSES/ux-foundation.md` and `LICENSES/ux-grid-teable.md`
+- Third-party notices are in `LICENSES/source-notices.md`
 - Popover and Tooltip use one floating preset (`floating.ts`): 8px plus safe area and soft keyboard from the edge, `sticky: 'partial'`, `hideWhenDetached`, sizes from Reka's available room instead of `100vw`. The AppRoot portal layer clips so a popup never grows the page. Tooltip `openOnTap` is on by default on coarse pointers, and a real tap (with its click) no longer closes it at once
 
 ## 0.20.3 (2026-11-04)

package/LICENSES/source-notices.md

@@ -0,0 +1,110 @@
+# Source notices
+
+A few source files in this package contain code under the MIT licence from
+the projects below. Those files carry a one-line pointer to this page in their
+header, and the built bundles open with a notice that points here as well. The
+full copyright and permission notices are reproduced below.
+
+No upstream name, logo or icon asset is shipped.
+
+## Files in the main entry
+
+| Source file in this package | Notice |
+| --- | --- |
+| `src/interaction/ime.ts` | Teable |
+| `src/interaction/gesture.ts` | Teable |
+| `src/components/primitives/popover/overlay.ts` | Teable |
+| `src/components/composite/record-panel/recordPanelWidth.ts` | Teable |
+| `src/components/composite/record-panel/RecordPanel.vue` | Teable |
+| `src/interaction/outside.ts` | Baserow |
+| `src/dnd/dragKit.ts` | Baserow |
+| `src/dnd/autoScroll.ts` | Baserow |
+| `src/virtual/cardHeight.ts` | Baserow |
+
+Every file under `src/grid-core/` and `src/grid/cells/` carries the same
+notices in its header, and so does the grid bundle.
+
+## Teable notice
+
+Teable `packages/*` is MIT licensed.
+
+```text
+MIT License
+
+Copyright (c) 2023-2025 Teable, Inc.
+
+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.
+```
+
+## Baserow notice
+
+Baserow Open Source Edition (outside `premium/` and `enterprise/`) is MIT
+(Expat) licensed.
+
+```text
+MIT License
+
+Copyright (c) 2019-present Baserow B.V.
+
+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.
+```
+
+## Tailwind CSS palette
+
+The grid's default colours come from the Tailwind CSS palette, MIT licensed,
+Copyright (c) Tailwind Labs, Inc.
+
+```text
+MIT License
+
+Copyright (c) Tailwind Labs, Inc.
+
+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

@@ -549,7 +549,7 @@ DSM-style application building blocks:
 - ListDetail (a list with the selected item's detail beside it, the pane's width set by dragging and remembered; see [docs/list-detail.md](docs/list-detail.md))
 - AsidePanel (the right side region: rail, docked, floating, sheet) / RecordPanel (a non-modal record panel docked over the view) / AdaptivePanel (a popover on desktop, a bottom sheet on a phone) / StatusSlot
 - VirtualCardGrid / CardCover / CardField (a virtual card gallery whose card height is computed, never measured)
-- Interaction core, drag kit and motion helpers for app views (see [docs/ux-foundation.md](docs/ux-foundation.md); phone and touch rules in [docs/mobile-native.md](docs/mobile-native.md)); the canvas grid is the separate `@synopackageland/ui/grid` entry
+- Interaction core, drag kit and motion helpers for app views (phone and touch rules in [docs/mobile-native.md](docs/mobile-native.md)); the canvas grid is the separate `@synopackageland/ui/grid` entry
 
 `Tabs` and `SectionTabs` move a raised selection notch in 120ms. Selected labels
 are blue; main labels are bold 14px and section labels bold 13px. `Tabs` fades its

package/dist/components/composite/file-picker/FilePicker.vue.d.ts

@@ -14,6 +14,7 @@ type __VLS_Props = {
     maxSize?: number;
     directory?: boolean;
     showList?: boolean;
+    /** `dropzone` shows as `compact` on a touch screen, where nothing can be dragged onto it. */
     variant?: 'dropzone' | 'compact';
     /** Takes files pasted while the picker has focus, and adds a Paste button where the browser can read the clipboard (an iPhone has no keyboard to paste with). */
     paste?: boolean;

package/dist/components/composite/form/FormItem.vue.d.ts

@@ -50,7 +50,7 @@ type __VLS_Props = {
     direction?: FormDirection;
     /** Width of the label column in the horizontal layout. */
     labelWidth?: string;
-    /** Maximum control width; inherits the form's `fieldWidth` (`'md'` by default). */
+    /** Maximum control width; inherits the form's `fieldWidth` (`'md'` by default). In a narrow row that stacks its label, `'md'` and `'lg'` fill the column. */
     fieldWidth?: FieldWidth;
     /** Value restored by `resetFields()`; also the initial dirty baseline. */
     initialValue?: unknown;

package/dist/components/composite/record-panel/recordPanelWidth.d.ts

@@ -1,30 +1,9 @@
 /**
  * @license MIT
- * The width rule (560 default, 320 minimum, 240 of the view kept beside the
- * panel, the secondary column added on top and capped at the host) is ported
- * from Teable's record side panel
- * (packages/sdk/src/components/expand-record/Panel.tsx:20-26, 83-88 at
- * f8be01fad).
+ * The width rule: 560 default, 320 minimum, 240 of the view kept beside the
+ * panel, the secondary column added on top and capped at the host.
  *
- * Copyright (c) 2023-2025 Teable, Inc.
- *
- * 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.
+ * Licence: LICENSES/source-notices.md
  */
 export declare const RECORD_PANEL_DEFAULT_WIDTH = 560;
 export declare const RECORD_PANEL_MIN_WIDTH = 320;
@@ -32,7 +11,7 @@ export declare const RECORD_PANEL_MIN_WIDTH = 320;
 export declare const RECORD_PANEL_MIN_MAIN_WIDTH = 240;
 /** The comments (or other secondary) column, added on the panel's far side. */
 export declare const RECORD_PANEL_SECONDARY_WIDTH = 320;
-/** Body padding switches from 24 to 48 at this body width (Teable `getBodyPadding`). */
+/** Body padding switches from 24 to 48 at this body width. */
 export declare const RECORD_PANEL_WIDE_BODY = 640;
 export interface RecordPanelBounds {
     minWidth: number;

package/dist/components/primitives/context-menu/ContextMenu.vue.d.ts

@@ -5,9 +5,9 @@ type __VLS_Props = {
     /** How long a touch press is held before the menu opens, in ms; Reka's 700 when unset. */
     pressOpenDelay?: number;
 };
-declare var __VLS_17: {};
+declare var __VLS_20: {};
 type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_17) => any;
+    default?: (props: typeof __VLS_20) => any;
 };
 declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     select: (key: string) => any;

package/dist/components/primitives/date-picker/DatePicker.vue.d.ts

@@ -25,7 +25,7 @@ type __VLS_Props = {
     ariaLabel?: string;
     /** Additive: show a time picker under the calendar and emit a local date-time string. */
     showTime?: boolean;
-    /** Additive: type the date directly instead of picking it. Cannot be combined with `showTime`. */
+    /** Additive: type the date directly instead of picking it. Cannot be combined with `showTime`. On a phone the calendar sheet is used instead. */
     editable?: boolean;
     /** Additive: an empty text field clears the value instead of reporting `required`. */
     allowBlank?: boolean;

package/dist/components/rich-text-editor/extensions.d.ts

@@ -23,6 +23,8 @@ export type ExtensionOptions = {
     mention: Omit<SuggestionOptions<MentionCandidate>, 'editor' | 'char'>;
     /** Ctrl+Enter or Cmd+Enter; returns whether it was taken. Never while an input method composes. */
     submit?: () => boolean;
+    /** Plain Enter, before it breaks the line; returns whether it was taken (a compact box on a touch screen sends). Never while an input method composes. */
+    enter?: () => boolean;
     /** Ctrl+K or Cmd+K. */
     link: () => boolean;
     escape: () => boolean;

package/dist/composables/collisionBoundary.d.ts

@@ -1,4 +1,10 @@
+/**
+ * The element behind an anchor. Reka hands a virtual element (a bare rect that
+ * carries its context element) whenever the trigger is a component rather than
+ * a DOM node, so resolve that first and ignore anything without `closest`.
+ */
+export declare function anchorElement(anchor: Element | null | undefined): Element | null;
 /** Where a popup opened from `anchor` must stay: the app window it opens from,
  * or the whole viewport from a dialog floating over the DSM desktop. Reka flips
  * and shrinks the popup to fit this boundary while it is open. */
-export declare function useCollisionBoundary(anchor: () => HTMLElement | undefined, open: () => boolean): import('vue').ComputedRef<HTMLElement | HTMLElement[]>;
+export declare function useCollisionBoundary(anchor: () => Element | null | undefined, open: () => boolean): import('vue').ComputedRef<HTMLElement | HTMLElement[]>;

package/dist/composables/elementWidth.d.ts

@@ -1,4 +1,10 @@
 import { Ref } from 'vue';
 /** Observe the component's container, including DSM window resizes that do not
- * resize the document viewport. Zero is unknown (e.g. hidden tab or SSR). */
-export declare function useElementWidth(element: Readonly<Ref<HTMLElement | null | undefined>>): Ref<number, number>;
+ * resize the document viewport. Zero is unknown (e.g. hidden tab or SSR).
+ * `after` holds the first measurement until it is true (a containing layout
+ * that has not drawn its own measured layout yet); `onMeasured` runs once the
+ * first measurement has been drawn. */
+export declare function useElementWidth(element: Readonly<Ref<HTMLElement | null | undefined>>, options?: {
+    after?: Readonly<Ref<boolean>>;
+    onMeasured?: () => void;
+}): Ref<number, number>;

package/dist/dnd/autoScroll.d.ts

@@ -1,28 +1,9 @@
 /**
  * @license MIT
  * The edge-zone percentage and the linear speed ramp (full speed at and beyond
- * the edge) are ported from Baserow's `v-auto-scroll` directive
- * (web-frontend/modules/core/directives/autoScroll.js:30-99 at 98f727dc2),
- * rewritten as a requestAnimationFrame loop with a minimum zone and both axes.
+ * the edge), as a requestAnimationFrame loop with a minimum zone and both axes.
  *
- * Copyright (c) 2019-present Baserow B.V.
- *
- * 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.
+ * Licence: LICENSES/source-notices.md
  */
 /** Share of the scroll box, per edge, that scrolls (interaction-spec §5.2). */
 export declare const AUTO_SCROLL_ZONE_PERCENT = 15;
@@ -47,7 +28,7 @@ export interface AutoScroll {
  * Speed for a pointer `offset` px from the box start on an axis `size` long:
  * negative toward the start, positive toward the end, 0 outside both zones.
  * Linear from 0 at the inner zone border to `max` at the edge; a pointer past
- * the edge keeps full speed (Baserow clamps the distance to 0).
+ * the edge keeps full speed (the distance is not clamped to 0).
  */
 export declare function edgeSpeed(offset: number, size: number, options?: Pick<AutoScrollOptions, 'padding' | 'minZone' | 'maxSpeed'>): number;
 /**

package/dist/dnd/dragKit.d.ts

@@ -5,7 +5,7 @@ export type DragKey = string | number;
 export declare const TOUCH_HOLD_MS = 250;
 /** Movement before the hold ends that hands the touch back to native scrolling. */
 export declare const TOUCH_HOLD_TOLERANCE_PX = 6;
-/** After a sibling moves, the target holds still this long (Baserow 100 ms). */
+/** After a sibling moves, the target holds still this long (100 ms). */
 export declare const SWAP_LOCK_MS = 100;
 export declare const DND_LANE_ATTR = "data-dnd-lane";
 export declare const DND_KEY_ATTR = "data-dnd-key";

package/dist/grid/cells/number.d.ts

@@ -1,5 +1,5 @@
 import { GridNumberFormat } from './types';
 /** 12.5 → "12.50"; currency "$1,234.50"; percent 0.125 → "12.50%". Empty for null. */
 export declare const formatGridNumber: (value: number | null | undefined, format?: GridNumberFormat, locale?: string) => string;
-/** Teable's lenient parse: keeps digits, `.`, `+`, `-`; "12.5abc" → 12.5, "50%" → 0.5. Null when nothing parses. */
+/** Lenient parse: keeps digits, `.`, `+`, `-`; "12.5abc" → 12.5, "50%" → 0.5. Null when nothing parses. */
 export declare const parseGridNumber: (value: string | null | undefined, format?: GridNumberFormat) => number | null;

package/dist/grid/cells/types.d.ts

@@ -24,7 +24,7 @@ export interface GridAttachment {
     /** Image thumbnail; files without one draw an extension badge. */
     thumbnailUrl?: string;
 }
-/** Teable's number formatting (packages/core, MIT). */
+/** Number formatting (MIT, see LICENSES/source-notices.md). */
 export type GridNumberFormat = {
     type: 'decimal';
     precision?: number;

package/dist/grid/clipboard/tsv.d.ts

@@ -8,7 +8,6 @@ export declare const toTsv: (rows: readonly (readonly string[])[]) => string;
 export declare const parseTsv: (text: string) => string[][];
 /**
  * An HTML table for rich targets (Sheets, Excel, Docs), or undefined for a
- * single cell, as Baserow does (copyPasteHelper.js `prepareHTMLData`, MIT):
- * one cell pastes better as plain text.
+ * single cell (MIT): one cell pastes better as plain text.
  */
 export declare const toHtmlTable: (rows: readonly (readonly string[])[]) => string | undefined;

package/dist/grid/contracts.d.ts

@@ -11,7 +11,7 @@ export interface GridColumn {
     name: string;
     /** Width in CSS px. Default 150. */
     width?: number;
-    /** Smallest width a resize reaches. Default 100 (Teable). */
+    /** Smallest width a resize reaches. Default 100. */
     minWidth?: number;
     /** No edit requests for this column (the grid can still select and copy it). */
     readonly?: boolean;

package/dist/grid/focus/editor-style.d.ts

@@ -2,7 +2,7 @@ import { IGridTheme } from '../../grid-core/theme';
 import { GridEditorKind } from '../contracts';
 /** Ring width outside the cell box while editing. */
 export declare const EDITOR_RING_PX = 2;
-/** Inner radius; with the 2 px ring the outer corner is Teable's 6 px. */
+/** Inner radius; with the 2 px ring the outer corner is 6 px. */
 export declare const EDITOR_RADIUS_PX = 4;
 /** Line height of wrapped text in the long-text editor and the read-only view. */
 export declare const WRAP_LINE_HEIGHT_PX = 20;

package/dist/grid/host/controller.d.ts

@@ -25,7 +25,7 @@ export interface GridHostConfig {
     fillable?: boolean;
     /**
      * Touch UI (a coarse primary pointer): no fill handle and no column resize
-     * handle, as in Teable's touch layer. Touch gestures go through `tap` and
+     * handle. Touch gestures go through `tap` and
      * `longPress`, never through the pointer methods. At a grid width of
      * `PHONE_MAX_WIDTH` or less it is the phone layout (see `isPhone`).
      */
@@ -64,9 +64,9 @@ export type GridKeyInput = Pick<KeyboardEvent, 'key' | 'keyCode' | 'shiftKey' |
 export type GridKeyResult = 'prevent' | 'pass' | 'ignore';
 /** Width of the row header: the row number, plus 24 px per row control beyond the first. */
 export declare const rowHeaderWidth: (controls: readonly GridRowControl[]) => number;
-/** Grid widths up to this are a phone on touch: a tap opens the record (Teable's `(max-width: 640px)`). */
+/** Grid widths up to this are a phone on touch: a tap opens the record. */
 export declare const PHONE_MAX_WIDTH = 640;
-/** The phone's row header: row numbers only, as Teable's touch grid. */
+/** The phone's row header: row numbers only. */
 export declare const PHONE_ROW_HEADER_WIDTH = 50;
 export declare class GridHostController {
     coord: CoordinateManager;
@@ -101,7 +101,7 @@ export declare class GridHostController {
     /**
      * Touch on a grid no wider than 640 px. There a tap opens the record (the
      * cell and its editor cannot fit beside the keyboard), the row header shows
-     * numbers only and no column is frozen: Teable's phone grid.
+     * numbers only and no column is frozen.
      */
     get isPhone(): boolean;
     private visibleRowControls;
@@ -110,7 +110,7 @@ export declare class GridHostController {
     private applyColumns;
     /**
      * Frozen columns that fit: the scrolling part keeps at least 240 px, so on a
-     * phone a wide first column stops freezing (Teable's getMaxFreezeColumnCount).
+     * phone a wide first column stops freezing.
      */
     private freezeCount;
     configure(next: GridHostConfig): void;
@@ -140,11 +140,11 @@ export declare class GridHostController {
     }): void;
     private selectCell;
     getCellRect(cell: GridCell): GridRect | null;
-    /** Minimal scroll that shows the cell with Teable's 16 px buffer; instant. */
+    /** Minimal scroll that shows the cell with a 16 px buffer; instant. */
     scrollToCell(cell: GridCell): void;
     private regionContext;
     private get isFillEnabled();
-    /** No resize handle on touch: a 5 px edge is no finger target (Teable has none on touch either). */
+    /** No resize handle on touch: a 5 px edge is no finger target. */
     private get isResizeEnabled();
     /** True while the fill handle is dragged. */
     get isFilling(): boolean;
@@ -183,11 +183,11 @@ export declare class GridHostController {
      * The tapped row or header keeps a pressed tint until `clearTapFeedback`.
      *
      * - A cell on a phone (`isPhone`): selects it and opens the record
-     *   (`rowExpand` with the column), as Teable's touch grid.
+     *   (`rowExpand` with the column).
      * - A cell on a wider touch screen: the first tap selects it, a second tap
      *   on the selected cell asks for an edit (`tap` trigger).
-     * - A header with a menu opens the menu, as in Teable's touch layer (the
-     *   16 px chevron is no finger target); without one it selects the column.
+     * - A header with a menu opens the menu (the 16 px chevron is no finger
+     *   target); without one it selects the column.
      * - The row header is one target: on a phone it opens the record; wider, it
      *   expands the row with the `expand` control, else toggles the checkbox.
      *
@@ -201,7 +201,7 @@ export declare class GridHostController {
     private requestEdit;
     /**
      * After an edit of `cell` commits: Enter moves down, Tab right, Shift+Tab
-     * left (Teable's enterCommitSelection / tabSelection), from the edited cell.
+     * left, from the edited cell.
      */
     moveAfterEdit(cell: GridCell, move: 'down' | 'right' | 'left'): void;
     /** An input method started composing on the selected cell. */

package/dist/grid/range/block.d.ts

@@ -10,7 +10,7 @@ export interface GridCellRange {
  * The cells a selection covers, as ordered row and column indexes. A cell
  * selection is one rectangle; a row selection covers every column of its
  * rows; a column selection covers every row of its columns. Several runs
- * (Cmd+click on headers) are joined in index order, as Teable copies them.
+ * (Cmd+click on headers) are joined in index order.
  */
 export interface GridCellBlock {
     rows: readonly number[];

package/dist/grid-core/auto-scroll.d.ts

@@ -19,16 +19,16 @@ export interface IAutoScrollBounds {
  * Scroll direction for a pointer at `position` (relative to the grid's
  * top-left). Right/bottom: within 30 px of the edge or beyond it. Left/top:
  * within 30 px past the frozen columns / header, over the row header or header,
- * or beyond the grid. Teable stops when the pointer passes over the header or
- * leaves the grid on the left or top; we keep scrolling there.
+ * or beyond the grid. It keeps scrolling when the pointer passes over the
+ * header or leaves the grid on the left or top.
  * `dragType` limits a row drag to y and a column drag to x.
  */
 export declare const getAutoScrollDirection: (position: IPosition, bounds: IAutoScrollBounds, dragType?: DragRegionType, threshold?: number) => [IScrollDirection, IScrollDirection];
 /**
- * One frame of Teable's ramp: `speed = min(1, speed + dt/1200)`, then
- * `px = speed · dt · 2`. Teable floors `px` every frame; with `carry` the
- * fractional part moves to the next frame instead, so the distance does not
- * depend on the refresh rate.
+ * One frame of the ramp: `speed = min(1, speed + dt/1200)`, then
+ * `px = speed * dt * 2`. With `carry` the fractional part moves to the next
+ * frame instead of being floored, so the distance does not depend on the
+ * refresh rate.
  */
 export declare const autoScrollStep: (speed: number, dt: number, carry?: number) => {
     speed: number;
@@ -40,7 +40,7 @@ export interface IAutoScrollerOptions {
     scrollBy: (deltaX: number, deltaY: number) => void;
     /** After each scroll; re-derive the selection head from the last pointer here. */
     onTick?: (deltaX: number, deltaY: number) => void;
-    /** Default true. False floors each frame exactly as Teable does. */
+    /** Default true. False floors each frame, the classic ramp. */
     carryFraction?: boolean;
     requestFrame?: (callback: (time: number) => void) => number;
     cancelFrame?: (id: number) => void;

package/dist/grid-core/column-resize.d.ts

@@ -8,7 +8,7 @@ export declare const resolveResizeColumnIndex: (coordInstance: CoordinateManager
 export interface IColumnResizeControllerOptions {
     coordInstance: () => CoordinateManager;
     scrollState: () => Pick<IScrollState, 'scrollLeft'>;
-    /** Minimum width, per column if a function. Default 100 px (Teable). */
+    /** Minimum width, per column if a function. Default 100 px. */
     minWidth?: number | ((columnIndex: number) => number);
     /** Every width change while dragging, and the restored width on cancel. */
     onResize?: (width: number, columnIndex: number) => void;

package/dist/grid-core/config.d.ts

@@ -15,7 +15,7 @@ export declare const GRID_DEFAULT: {
     readonly columnResizeHandlerPaddingTop: 4;
     readonly columnFreezeHandlerWidth: 8;
     readonly columnFreezeHandlerHeight: 30;
-    /** Teable's hard-coded minimum while resizing. */
+    /** The minimum while resizing. */
     readonly columnMinWidth: 100;
     readonly cellHorizontalPadding: 8;
     readonly cellVerticalPaddingXS: 3;

package/dist/grid-core/keys.d.ts

@@ -1,4 +1,4 @@
-/** keyCode values (the `ts-keycode-enum` names Teable uses). */
+/** keyCode values, by key name. */
 export declare const KeyCode: {
     readonly Space: 32;
     readonly Digit0: 48;
@@ -20,7 +20,7 @@ export declare const KeyCode: {
 };
 /**
  * The first-key test and the composition guard are shared with editors outside
- * the grid, so they live in the interaction core (also ported from Teable).
+ * the grid, so they live in the interaction core.
  * Ask `guard.ownsKey(event)` before handling Enter, Esc or Tab; ask
  * `isComposingKey(event)` before arrows.
  */

package/dist/grid-core/renderer/layout.d.ts

@@ -92,7 +92,7 @@ export declare const calcCells: (p: IResolvedProps, region: IRenderRegion) => {
 export declare const drawRowHeader: (ctx: CanvasRenderingContext2D, props: IRowHeaderProps, p: IResolvedProps) => void;
 /** Backgrounds and grid lines on the main canvas; cell content on the cache canvas when `shouldRerender`. */
 export declare const drawCells: (mainCtx: CanvasRenderingContext2D, cacheCtx: CanvasRenderingContext2D, p: IResolvedProps) => void;
-/** The active cell: cell background, a 1 px neutral ring with radius 2 (Teable style), and its content on top. */
+/** The active cell: cell background, a 1 px neutral ring with radius 2, and its content on top. */
 export declare const drawActiveCell: (ctx: CanvasRenderingContext2D, p: IResolvedProps) => void;
 /** While dragging the fill handle: a tinted box over the target rows only, above or below the range. */
 export declare const drawFillPreview: (ctx: CanvasRenderingContext2D, p: IResolvedProps) => void;

package/dist/grid-core/selection-controller.d.ts

@@ -23,8 +23,8 @@ export interface ISelectionControllerOptions {
     onRowRangeSelected?: (ranges: IRange[]) => void;
 }
 /**
- * Pointer rules for the selection, as a plain state holder (Teable's
- * `useSelection` without React). Selection starts on pointerdown on a cell;
+ * Pointer rules for the selection, as a plain state holder. Selection starts
+ * on pointerdown on a cell;
  * header, checkbox and corner selection happen on click.
  *
  * - Shift+click on a cell keeps the anchor and moves the head; Cmd+click is a plain click.

package/dist/grid-core/theme.d.ts

@@ -19,7 +19,7 @@ export interface IGridTheme {
     cellBgSelected: string;
     cellBgLoading: string;
     cellLineColor: string;
-    /** The active cell's ring: 1 px, neutral (Teable style). */
+    /** The active cell's ring: 1 px, neutral. */
     cellLineColorActived: string;
     cellTextColor: string;
     cellTextColorHighlight: string;
@@ -49,12 +49,12 @@ export interface IGridTheme {
 export type IGridThemeColorKey = {
     [K in keyof IGridTheme]: IGridTheme[K] extends string ? K : never;
 }[keyof IGridTheme];
-/** Teable's light theme values. */
-export declare const teableGridTheme: IGridTheme;
+/** Default light theme values. */
+export declare const defaultGridTheme: IGridTheme;
 /**
  * Which UI library token feeds each theme colour. Task 08 owns the token
  * values; this only names them. The active-cell ring uses the text colour for a
- * 1 px neutral ring, as in Teable.
+ * 1 px neutral ring.
  */
 export declare const GRID_THEME_TOKENS: Record<Exclude<IGridThemeColorKey, 'themeKey' | 'fontFamily'>, string>;
 export declare const GRID_FONT_TOKENS: {
@@ -66,7 +66,7 @@ export declare const GRID_FONT_TOKENS: {
 export type IGridTokenSource = (token: string) => string | undefined;
 /**
  * Builds the theme from token values. Colours come back as the source resolved
- * them; missing tokens keep Teable's value.
+ * them; missing tokens keep the default value.
  */
 export declare const createGridTheme: (source: IGridTokenSource, overrides?: Partial<IGridTheme>) => IGridTheme;
 /**