@ahoo-wang/wow-view-engine 9.2.0-rc.0

package/dist/ui/manage/DeleteDialog.d.ts

@@ -0,0 +1,32 @@
+import { RefObject } from 'react';
+import { ViewInstanceSummary } from '../../model/index.js';
+/**
+ * Deleting says what it costs, and only what it costs: the base sentence
+ * always, and the two that depend on this view only when they apply.
+ *
+ * Asked twice for the one delete that conflicted — the first confirmation was
+ * about the view as it stood, and the view the conflict reports has changed
+ * since, so the second is put with the server's copy in hand.
+ *
+ * An `AlertDialog`, not a `Dialog`: a delete is not something to click past.
+ * Base UI keeps this one open under an outside click and holds focus on the
+ * two answers, so the only way out is to pick one.
+ */
+export declare function DeleteDialog({ open, onOpenChange, item, dirty, finalFocus, onConfirm, }: {
+    open: boolean;
+    onOpenChange(open: boolean): void;
+    item: ViewInstanceSummary;
+    /** True when this is the open view and it has unsaved edits. */
+    dirty: boolean;
+    /**
+     * Where focus goes once this closes. There is nowhere to send it back to
+     * by default: the button that opened it belongs to a row that a confirmed
+     * delete takes off the list, and a dialog that returns focus to an element
+     * no longer in the document leaves it on `<body>` — no keyboard position
+     * at all, and the manager still open around it. The caller names something
+     * that outlives the row.
+     */
+    finalFocus?: RefObject<HTMLElement | null>;
+    onConfirm(): void;
+}): import('react').JSX.Element;
+//# sourceMappingURL=DeleteDialog.d.ts.map

package/dist/ui/manage/DeleteDialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeleteDialog.d.ts","sourceRoot":"","sources":["../../../src/ui/manage/DeleteDialog.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,sBAAsB,CAAC;AAc9B;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,EAC3B,IAAI,EACJ,YAAY,EACZ,IAAI,EACJ,KAAK,EACL,UAAU,EACV,SAAS,GACV,EAAE;IACD,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,gEAAgE;IAChE,KAAK,EAAE,OAAO,CAAC;IACf;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC3C,SAAS,IAAI,IAAI,CAAC;CACnB,+BA6CA"}

package/dist/ui/manage/ViewManager.d.ts

@@ -0,0 +1,24 @@
+import { ViewListState, ViewManagerController } from '../../react/index.js';
+export interface ViewManagerProps {
+    manager: ViewManagerController;
+    list: ViewListState;
+    open: boolean;
+    onOpenChange(open: boolean): void;
+    /**
+     * The open view, when it has edits that were never saved. Deleting that one
+     * takes them with it, which is worth saying in the confirmation and cannot
+     * be worked out from the list.
+     */
+    openDirtyId?: string | null;
+}
+/**
+ * Managing the views rather than looking at one: rename, delete, reorder and
+ * choose which one opens first.
+ *
+ * It is a dialog rather than a mode of the sidebar because none of it is
+ * navigation — every button here writes. Each one exists only where it is
+ * permitted: a row the user may not rename has no rename button, not a
+ * greyed one, so what the list offers is exactly what the store will take.
+ */
+export declare function ViewManager({ manager, list, open, onOpenChange, openDirtyId, }: ViewManagerProps): import('react').JSX.Element;
+//# sourceMappingURL=ViewManager.d.ts.map

package/dist/ui/manage/ViewManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewManager.d.ts","sourceRoot":"","sources":["../../../src/ui/manage/ViewManager.tsx"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EACV,aAAa,EACb,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAsB9B,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,qBAAqB,CAAC;IAC/B,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAqBD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,IAAI,EACJ,IAAI,EACJ,YAAY,EACZ,WAAkB,GACnB,EAAE,gBAAgB,+BAmOlB"}

package/dist/ui/manage/ViewManagerRow.d.ts

@@ -0,0 +1,96 @@
+import { RefObject } from 'react';
+import { ViewAudience, ViewInstanceSummary } from '../../model/index.js';
+import { WriteState } from '../../runtime/index.js';
+import { ViewListState, ViewManagerController } from '../../react/index.js';
+import { HandleMove } from '../kit/DragHandle.js';
+export interface ViewManagerRowProps {
+    item: ViewInstanceSummary;
+    manager: ViewManagerController;
+    list: ViewListState;
+    openDirtyId: string | null;
+    /**
+     * Where focus goes when this row's delete confirmation closes. The row may
+     * be gone by then — that is what was confirmed — so there is nothing on it
+     * to return to, and the manager hands down its own heading instead.
+     */
+    returnFocus?: RefObject<HTMLElement | null>;
+    /**
+     * Where the row stands in its own group, and how many the group holds,
+     * for the handle's menu.
+     */
+    place: {
+        index: number;
+        total: number;
+    };
+    /** Moves the row, from the arrow keys on its handle or from its menu. */
+    onMove(move: HandleMove): void;
+    /** Moves the view to the other audience (设为共享／设为个人). */
+    onChangeAudience(audience: ViewAudience): void;
+    /** Publishes a copy of the view as a system view (D81). */
+    onPublish?(): void;
+    /**
+     * True once this row has just arrived in its group by a move of audience.
+     * The button that sent it here was on a row that is gone — the row is
+     * drawn anew under the other group — so focus is put on this row's
+     * button, which now says the way back, or on `returnFocus` when there is
+     * none; `onFocused` says it has been.
+     */
+    arrived?: boolean;
+    onFocused?(): void;
+    /** True while the library is carrying this row, so the arrows are its. */
+    dragging?: boolean;
+    elementRef?(element: HTMLElement | null): void;
+    handleRef?(element: HTMLElement | null): void;
+}
+/**
+ * One view in the manager: where it sits, what it is, what it is called, and
+ * the writes it permits.
+ *
+ * Every button exists only where it is permitted rather than greyed out, so
+ * what the row offers is exactly what the store will take. Renaming happens
+ * in place: the title becomes an input and the row's other buttons stand down
+ * until the edit is confirmed or dropped.
+ */
+export declare function ViewManagerRow({ item, manager, list, openDirtyId, returnFocus, place, onMove, onChangeAudience, onPublish, arrived, onFocused, dragging, elementRef, handleRef, }: ViewManagerRowProps): import('react').JSX.Element;
+/**
+ * A row that can be dragged, wired to the library.
+ *
+ * `group` is the audience the row is drawn under, which is how the two groups
+ * stay apart: a row of the other group is not a drop target at all, so a
+ * personal view cannot be carried in among the shared ones — the order would
+ * be stored again, the revision spent, and the rows would sit exactly where
+ * they were, because both lists draw personal views above shared ones
+ * whatever order is stored.
+ *
+ * The optimistic plugin is left out on purpose. It reorders the DOM while the
+ * pointer moves, which makes the indexes this component is rendered from
+ * stale exactly when the drop is read; without it the library still draws the
+ * drag preview, and the committed order is computed from the two ids the drop
+ * reports.
+ */
+export declare function SortableViewManagerRow(props: ViewManagerRowProps & {
+    index: number;
+    group: string;
+}): import('react').JSX.Element;
+/**
+ * What a write that no open view owns came to, under the row that started it.
+ * The order and the default are one record rather than a row, so theirs is
+ * drawn at the top of the dialog with no row above it.
+ *
+ * Reloading a preference conflict does not replay the intent (design/management.md):
+ * the list comes back at the stored revision and the user presses again, so
+ * the line stays until they do something with it.
+ */
+export declare function ViewManagerOutcome({ state, manager, list, outcomeKey, item, dirty, returnFocus, }: {
+    state: WriteState;
+    manager: ViewManagerController;
+    list: ViewListState;
+    outcomeKey: string;
+    /** The row this outcome belongs to; the preferences record has none. */
+    item?: ViewInstanceSummary;
+    /** True when this is the open view and it has unsaved edits. */
+    dirty?: boolean;
+    /** Where focus goes when the second delete confirmation closes. */
+    returnFocus?: RefObject<HTMLElement | null>;
+}): import('react').JSX.Element;
+//# sourceMappingURL=ViewManagerRow.d.ts.map

package/dist/ui/manage/ViewManagerRow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewManagerRow.d.ts","sourceRoot":"","sources":["../../../src/ui/manage/ViewManagerRow.tsx"],"names":[],"mappings":"AAaA,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGpE,OAAO,EAKL,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACzB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,KAAK,EACV,aAAa,EACb,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAqDnE,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,qBAAqB,CAAC;IAC/B,IAAI,EAAE,aAAa,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B;;;;OAIG;IACH,WAAW,CAAC,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC5C;;;OAGG;IACH,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,yEAAyE;IACzE,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IAC/B,wDAAwD;IACxD,gBAAgB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAC/C,2DAA2D;IAC3D,SAAS,CAAC,IAAI,IAAI,CAAC;IACnB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,IAAI,IAAI,CAAC;IACnB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CAAC;IAC/C,SAAS,CAAC,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CAAC;CAC/C;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,EAC7B,IAAI,EACJ,OAAO,EACP,IAAI,EACJ,WAAW,EACX,WAAW,EACX,KAAK,EACL,MAAM,EACN,gBAAgB,EAChB,SAAS,EACT,OAAe,EACf,SAAS,EACT,QAAQ,EACR,UAAU,EACV,SAAS,GACV,EAAE,mBAAmB,+BAoRrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,mBAAmB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,+BAkB9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,KAAK,EACL,OAAO,EACP,IAAI,EACJ,UAAU,EACV,IAAI,EACJ,KAAa,EACb,WAAW,GACZ,EAAE;IACD,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,EAAE,qBAAqB,CAAC;IAC/B,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,gEAAgE;IAChE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,mEAAmE;IACnE,WAAW,CAAC,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CAC7C,+BA8DA"}

package/dist/ui/manage/drag.d.ts

@@ -0,0 +1,33 @@
+import { ViewAudience } from '../../model/index.js';
+import { DragWordingKeys } from '../kit/dragWording.js';
+import { Drop, DropOperation } from '../kit/dragDrop.js';
+import { MessageFormatters } from '../kit/MessagesProvider.js';
+/**
+ * The drop this list will take, or null.
+ *
+ * What makes a drop a drop at all is the one guard every list here shares
+ * ({@link dropped}). What is added on top is the audiences, checked here as
+ * well as held apart by the library's groups: both lists draw personal views
+ * above shared ones whatever order is stored, so a row carried across that
+ * line would store a new order, spend a revision and leave the screen exactly
+ * as it was — and there is no index inside a group that could even express
+ * it.
+ */
+export declare function managerDrop(operation: DropOperation, canceled: boolean | undefined, audienceOf: (id: string) => ViewAudience | undefined): Drop | null;
+/** Where this list's drag sentences live in the catalogue. */
+export declare const MANAGE_DRAG_WORDING: DragWordingKeys;
+/**
+ * What a screen reader hears while a view is being carried: the shared
+ * wording of a drag said in the manager's own words, with the instance ids
+ * the library is holding turned back into the titles on screen.
+ */
+export declare function manageDragAccessibility(messages: MessageFormatters, titleFor: (id: string) => string): {
+    screenReaderInstructions: {
+        draggable: string;
+    };
+    announcements: {
+        dragstart: (event: import('../kit/dragAnnounce.js').DragAnnouncement) => string | undefined;
+        dragend: (event: import('../kit/dragAnnounce.js').DragAnnouncement) => string | undefined;
+    };
+};
+//# sourceMappingURL=drag.d.ts.map

package/dist/ui/manage/drag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drag.d.ts","sourceRoot":"","sources":["../../../src/ui/manage/drag.ts"],"names":[],"mappings":"AAaA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,EAAe,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAW,KAAK,IAAI,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEpE;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,aAAa,EACxB,QAAQ,EAAE,OAAO,GAAG,SAAS,EAC7B,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,YAAY,GAAG,SAAS,GACnD,IAAI,GAAG,IAAI,CAOb;AAED,8DAA8D;AAC9D,eAAO,MAAM,mBAAmB,EAAE,eAIjC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,iBAAiB,EAC3B,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM;;;;;;;;EAMjC"}

package/dist/ui/messages/actions.d.ts

@@ -0,0 +1,32 @@
+/**
+ * The declared actions' machinery (host-integration.md 5): the words the
+ * engine says around a host's commands — the row's menu, the selection's
+ * button, the question before a command goes to many, the records that
+ * will not take it and why, a form's fields. The commands' own names and
+ * reasons are the host's (`text(key)`).
+ */
+export declare const actionsMessages: {
+    readonly 'label.action.more': "Actions for {record}";
+    readonly 'label.action.bulk': "{action} {count}";
+    readonly 'label.action.bulk-able': "{action} {able}/{count}";
+    readonly 'label.action.confirm': "Run “{action}” on {count} records?";
+    readonly 'label.action.confirm-record': "Run “{action}” on {record}?";
+    readonly 'label.action.on-record': "{action}: {record}";
+    readonly 'label.action.record': "Record {record}";
+    readonly 'label.action.left': "The ones refused stay selected, with the reason.";
+    readonly 'label.action.able': "{able} of {count} can take it.";
+    readonly 'label.action.none-able': "None of the {count} can take it now.";
+    readonly 'label.action.refused': "Not sent, and left selected:";
+    readonly 'label.action.refused-keys-more': "{keys} and {count} more";
+    readonly 'label.action.only-able': "Only the {count} that can";
+    readonly 'label.action.only-able-one': "Only the one that can";
+    readonly 'label.action.cancel': "Cancel";
+    readonly 'label.action.required': "Required";
+    readonly 'label.action.unseen': "Not on the page in view";
+    readonly 'label.action.not-offered': "Not offered for this record";
+    readonly 'label.action.unavailable': "Not available now";
+    readonly 'label.action.failed': "Failed, with no reason given";
+    readonly 'label.action.timed-out': "No answer in time";
+    readonly 'label.action.abandoned': "Stopped waiting";
+};
+//# sourceMappingURL=actions.d.ts.map

package/dist/ui/messages/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../src/ui/messages/actions.ts"],"names":[],"mappings":"AAaA;;;;;;GAMG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;CAkClB,CAAC"}