@iota-uz/sdk 0.26.0 → 0.27.0

package/dist/lens/reports/editing.d.ts

@@ -0,0 +1,176 @@
+import { type JSX } from 'solid-js';
+import { useTranslate, type LensThemeMode } from '../runtime';
+import type { Composition, ContextPeriod, Placement, Proposal } from './contract/types';
+import { type ReportDraft, type SaveIntent } from './draft';
+import type { ReportLeaveGuard } from './guard';
+import { type PlacementDirection } from './layout';
+import { type ReportCatalogHost, type ReportPickerConfirmation } from './picker';
+export type ReportProposal = Proposal;
+/** new: an unpublished draft (Save draft / Publish). existing: a saved object (Save changes / Cancel). */
+export type ReportEditorLifecycle = 'new' | 'existing';
+export interface ReportProposalHandlers {
+    /** Called after the reader applied or rejected the proposal. */
+    settled?: (proposalId: string, outcome: 'applied' | 'rejected') => void;
+    /** Prepare the proposal again against the current draft (reportDraftToken). */
+    regenerate?: (proposal: ReportProposal) => void;
+    /** Keep a stale proposal as a separate draft instead of applying it here. */
+    openAsDraft?: (proposal: ReportProposal) => void;
+}
+/** The host operations a composition editing session can call. Every member is read when used. */
+export interface CompositionSessionHost {
+    draft: ReportDraft<Composition>;
+    lifecycle?: ReportEditorLifecycle;
+    /** The saved report's title for a placement without its own caption. */
+    reportTitle?: (reportId: string) => string | undefined;
+    /** Enables "Add report" through the picker. */
+    catalog?: ReportCatalogHost;
+    /** How many placements use a report, shown before editing the shared definition. */
+    usage?: (reportId: string) => Promise<number> | number;
+    /** Opens the shared report definition for editing. */
+    onEditReport?: (reportId: string, placementId: string) => Promise<void> | void;
+    /** Replaces the placement's report with an independent copy. */
+    onCopyReport?: (placementId: string) => Promise<void> | void;
+    /** After a revision conflict: keep the local draft as an independent object. */
+    onSaveCopy?: (draft: Composition) => Promise<void> | void;
+    proposal?: ReportProposal;
+    proposalHandlers?: ReportProposalHandlers;
+    /** Placement span of cards added from the picker (12 by default). */
+    addSpan?: number;
+    theme?: LensThemeMode;
+}
+export interface SessionPlacement {
+    placement: Placement;
+    row: number;
+    index: number;
+    rowSize: number;
+}
+export declare function periodText(period: ContextPeriod | undefined, translate: ReturnType<typeof useTranslate>): string | undefined;
+/**
+ * The state of one editing session over a composition draft: layout commands
+ * with their announcements and focus moves, the dialogs they open, saving,
+ * cancelling and proposals. The separate editor and the live dashboard's edit
+ * mode both drive a draft through it, so they behave the same.
+ */
+export declare function createCompositionSession(host: CompositionSessionHost): {
+    host: CompositionSessionHost;
+    draft: ReportDraft<Composition>;
+    translate: (key: string, fallback: string, vars?: import("../runtime").TranslationVars) => string;
+    instructionsId: string;
+    cards: Map<string, HTMLElement>;
+    handles: Map<string, HTMLElement>;
+    refs: {
+        add?: HTMLElement;
+    };
+    placements: import("solid-js").Accessor<SessionPlacement[]>;
+    ids: import("solid-js").Accessor<string[]>;
+    byId: (id: string) => SessionPlacement | undefined;
+    title: (placement: Placement) => string;
+    placedCount: (reportId: string) => number;
+    picking: import("solid-js").Accessor<boolean>;
+    setPicking: import("solid-js").Setter<boolean>;
+    configuring: import("solid-js").Accessor<string | undefined>;
+    setConfiguring: import("solid-js").Setter<string | undefined>;
+    impact: import("solid-js").Accessor<{
+        placementId: string;
+        reportId: string;
+        usage?: number;
+    } | undefined>;
+    setImpact: import("solid-js").Setter<{
+        placementId: string;
+        reportId: string;
+        usage?: number;
+    } | undefined>;
+    notice: import("solid-js").Accessor<string>;
+    setNotice: import("solid-js").Setter<string>;
+    announcement: import("solid-js").Accessor<string>;
+    setAnnouncement: import("solid-js").Setter<string>;
+    added: import("solid-js").Accessor<string[]>;
+    saved: import("solid-js").Accessor<boolean>;
+    copyFailed: import("solid-js").Accessor<boolean>;
+    /** The catalog entry each placement added in this session came from, for its preview. */
+    pickedEntry: (placementId: string) => import("./contract/types").CatalogEntry | undefined;
+    edit: (change: (composition: Composition) => Composition) => void;
+    move: (id: string, direction: PlacementDirection) => void;
+    moveBefore: (id: string, targetId: string) => void;
+    resize: (id: string, span: number) => void;
+    remove: (id: string) => void;
+    addPicked: (confirmation: ReportPickerConfirmation) => void;
+    configure: (id: string, settings: {
+        title: string;
+        span: number;
+        period?: ContextPeriod;
+    }) => void;
+    save: (intent: SaveIntent) => Promise<boolean>;
+    cancel: (options?: {
+        announce?: boolean;
+    }) => void;
+    openImpact: (placementId: string, reportId: string) => Promise<void>;
+    saveCopy: () => void;
+    conflict: () => import("./draft").ReportRevisionConflictError<Composition> | undefined;
+    saveError: () => boolean;
+    status: () => string;
+    proposal: () => Proposal | undefined;
+    proposalValid: (value: ReportProposal) => boolean;
+    applyProposal: (current: ReportProposal) => void;
+    rejectProposal: (current: ReportProposal) => void;
+};
+export type CompositionSession = ReturnType<typeof createCompositionSession>;
+/** Save failure, revision conflict and notices, then the screen-reader announcement and move instructions. */
+export declare function SessionAlerts(props: {
+    session: CompositionSession;
+}): JSX.Element;
+/** The pending external proposal, if any, as an apply/reject panel over the draft. */
+export declare function SessionProposal(props: {
+    session: CompositionSession;
+}): JSX.Element;
+/** The picker, card settings, shared-edit impact and leave dialogs of a session. */
+export declare function SessionDialogs(props: {
+    session: CompositionSession;
+    guard: ReportLeaveGuard;
+}): JSX.Element;
+/** The session's save actions: Save changes, or Save draft and Publish for a new object. */
+export declare function SessionSaveActions(props: {
+    session: CompositionSession;
+    onSave: (intent: SaveIntent) => void;
+}): JSX.Element;
+/**
+ * The pointer and keyboard controls of one editable card: a drag handle that
+ * also moves the card with the arrow keys, a width slider and the card's drop
+ * target. preview is the width shown while a resize drag is in progress.
+ */
+export declare function createPlacementControls(props: {
+    id: () => string;
+    span: () => number;
+    grid: () => HTMLElement | undefined;
+    onMove: (direction: PlacementDirection) => void;
+    onResize: (span: number) => void;
+    onDropBefore: (draggedId: string) => void;
+}): {
+    span: () => number;
+    dropTarget: import("solid-js").Accessor<boolean>;
+    dropProps: {
+        onDragLeave: () => false;
+        onDragOver: (event: DragEvent) => void;
+        onDrop: (event: DragEvent) => void;
+    };
+    onHandleKey: (event: KeyboardEvent) => void;
+    onResizeKey: (event: KeyboardEvent) => void;
+    onResizePointer: (event: PointerEvent) => void;
+    onDragStart: (event: DragEvent) => void;
+};
+export type PlacementControls = ReturnType<typeof createPlacementControls>;
+/** The drag handle: a pointer drags the card, the arrow keys move it one step. */
+export declare function PlacementHandle(props: {
+    id: string;
+    title: string;
+    describedBy: string;
+    controls: PlacementControls;
+    handleRef: (element: HTMLButtonElement) => void;
+}): JSX.Element;
+/** The width slider on a card's trailing edge: drag it, or use the arrow keys, Home and End. */
+export declare function PlacementResize(props: {
+    id: string;
+    title: string;
+    controls: PlacementControls;
+}): JSX.Element;
+//# sourceMappingURL=editing.d.ts.map

package/dist/lens/reports/editing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editing.d.ts","sourceRoot":"","sources":["../../src/reports/editing.tsx"],"names":[],"mappings":"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"}

package/dist/lens/{scales-BgYelCDe.js → scales-COnESBiP.js}

@@ -1,4 +1,4 @@
-import { au as b } from "./index-D0vCs6QJ.js";
+import { aH as b } from "./index-C2oaf8ou.js";
 const l = {
   annotation: (n) => `annotation:${n}`,
   average: (n) => `average:${n}`,