@lotics/app-sdk 0.124.4 → 0.124.5

package/dist/hooks.d.ts

@@ -3,7 +3,7 @@ import { type AttachmentPiles, type AttachmentPilesOptions, type AttachmentsOpti
 import { type AiContextValue } from "./rpc.js";
 import { type AgentUIPart, type PendingChoice, type AgentRunLanding } from "./agent_stream.js";
 import type { AppWorkflows, AppWorkflowResults, AppAgents, AppAgentResults } from "./types.js";
-import type { ResolvedMember } from "./members.js";
+import type { ResolvedMember } from "./shared_types.js";
 import type { PhotoPlace } from "./row.js";
 export type { AgentRunState, AgentUIPart, PendingChoice, ChoiceQuestion, ChoiceOption, AskUserChoiceOutput, AgentRunLanding } from "./agent_stream.js";
 export { buildChoiceOutput } from "./agent_stream.js";

package/dist/index.d.ts

@@ -6,7 +6,8 @@ export type { AppErrorKind } from "./error_report.js";
 export { useWorkflow, useWorkflows, writesSettled, useFileUpload, useAttachments, useAttachmentPiles, useMembers, useAgentRun, useAgentRuns, useAiContext, buildChoiceOutput, } from "./hooks.js";
 export type { UploadedFile, WorkflowResult, MembersOptions, AgentRunOptions, UseAgentRun, AgentRunLanding, AgentRunRecord, AgentRunState, AgentUIPart, PendingChoice, ChoiceQuestion, ChoiceOption, AskUserChoiceOutput, } from "./hooks.js";
 export { useQuery, useQueries, queryAll, exportQuery, useFieldOptions } from "./queries.js";
-export type { QueryRow, QueryCall, QueryState, RowOf, QueryOptions, ColumnKeyOf, QuerySortKey, QueryFieldSortKey, QueryFirstSortKey, QueryFilter, QueryFilterCondition, QueryFilterFieldCondition, QueryFilterRecordIdCondition, QueryFilterGroup, FieldOptions, FieldOptionsState, FieldOptionsOptions, FigureUnits, ExportCall, ExportFile, ExportReport, ExportTab, } from "./queries.js";
+export type { QueryCall, QueryState, RowOf, QueryOptions, ColumnKeyOf, FieldOptions, FieldOptionsState, FieldOptionsOptions, FigureUnits, } from "./queries.js";
+export type { QueryRow, QuerySortKey, QueryFieldSortKey, QueryFirstSortKey, QueryFilter, QueryFilterCondition, QueryFilterFieldCondition, QueryFilterRecordIdCondition, QueryFilterGroup, ExportCall, ExportFile, ExportReport, ExportTab, } from "./shared_types.js";
 export type { ExportedFile } from "./shared_types.js";
 export type { AttachedFile, AttachmentPiles, AttachmentPilesOptions, AttachmentsOptions, AttachmentsState } from "./attachments.js";
 export { useComments, useCommentCounts } from "./comments.js";
@@ -27,15 +28,15 @@ export { openApp, peekApp } from "./open_app.js";
 export { askAi, type AskAiArgs } from "./ask_ai.js";
 export { downloadFile } from "./download.js";
 export { renameFile } from "./rename_file.js";
-export { readMembers } from "./members.js";
-export type { ResolvedMember } from "./members.js";
-export { readSelect } from "./select.js";
-export type { ResolvedOption } from "./select.js";
+export { readMembers, readSelect } from "./shared_types.js";
+export type { ResolvedMember, ResolvedOption } from "./shared_types.js";
 export type { AppFixture, MockExport, MockQuery, MockQueryCall, MockWorkflow } from "./mock.js";
 export type { MockAgent, MockAgentRun } from "./mock_agent_run.js";
 export type { AppWorkflows, AppWorkflowResults, AppQueries, AppQueryColumns, AppAgents, AppAgentResults } from "./types.js";
-export { row, readLinks, readFiles, readLocked, readLockedBy, readCreatedAt, readUpdatedAt, PENDING } from "./row.js";
-export type { ResolvedLink, AppFile, PhotoPlace } from "./row.js";
+export { row, readLinks } from "./shared_types.js";
+export type { ResolvedLink } from "./shared_types.js";
+export { readFiles, readLocked, readLockedBy, readCreatedAt, readUpdatedAt, PENDING } from "./row.js";
+export type { AppFile, PhotoPlace } from "./row.js";
 export { useNewRecord, newRecordId } from "./new_record.js";
 export type { NewRecordApi } from "./new_record.js";
 export { useRecents } from "./use_recents.js";

package/dist/index.js

@@ -10765,8 +10765,7 @@ function useAgentRuns(sessionId, opts) {
 // src/queries.ts
 import { useCallback as useCallback5, useMemo as useMemo3, useState as useState3 } from "react";
 
-// src/row.ts
-var PENDING = "__pending";
+// ../shared/src/app_screen/cells.ts
 function opt(v) {
   if (typeof v === "string") return v || null;
   if (Array.isArray(v)) return v.length ? opt(v[0]) : null;
@@ -10837,6 +10836,49 @@ function readLinks(v) {
   }
   return out;
 }
+var row = { opt, text, num, bool, date, datetime, link };
+function readSelect(value) {
+  if (!Array.isArray(value)) return [];
+  const out = [];
+  for (const entry of value) {
+    if (typeof entry === "string") {
+      if (entry !== "") out.push({ key: entry, label: entry });
+      continue;
+    }
+    if (!entry || typeof entry !== "object") continue;
+    const obj = entry;
+    const key = obj.key;
+    if (typeof key !== "string" || key === "") continue;
+    const label = typeof obj.label === "string" ? obj.label : key;
+    out.push({ key, label });
+  }
+  return out;
+}
+function readMembers(value) {
+  if (!Array.isArray(value)) return [];
+  const out = [];
+  for (const entry of value) {
+    if (!entry || typeof entry !== "object") continue;
+    const obj = entry;
+    const id = obj.id;
+    if (typeof id !== "string" || id === "") continue;
+    const name = typeof obj.name === "string" ? obj.name : obj.name === null ? null : null;
+    const m = { id, name };
+    if ("email" in obj) m.email = typeof obj.email === "string" ? obj.email : null;
+    if ("image" in obj) m.image = typeof obj.image === "string" ? obj.image : null;
+    if ("groups" in obj) {
+      m.groups = Array.isArray(obj.groups) ? obj.groups.filter((g) => typeof g === "string") : [];
+    }
+    if (obj.role === "owner" || obj.role === "admin" || obj.role === "member") m.role = obj.role;
+    if (typeof obj.joined === "string" && obj.joined !== "") m.joined = obj.joined;
+    if (obj.archived === true) m.archived = true;
+    out.push(m);
+  }
+  return out;
+}
+
+// src/row.ts
+var PENDING = "__pending";
 function placeOf(value) {
   if (typeof value !== "object" || value === null) return void 0;
   const latitude = Reflect.get(value, "latitude");
@@ -10880,7 +10922,7 @@ function readFiles(v) {
 }
 function readLocked(rowValue) {
   if (!rowValue || typeof rowValue !== "object") return false;
-  return bool(rowValue["__source_locked"]) === true;
+  return row.bool(rowValue["__source_locked"]) === true;
 }
 function readLockedBy(rowValue) {
   if (!rowValue || typeof rowValue !== "object") return [];
@@ -10900,14 +10942,13 @@ function readCreatedAt(rowValue) {
 function readUpdatedAt(rowValue) {
   return rowInstant(rowValue, "__updated_at");
 }
-var row = { opt, text, num, bool, date, datetime, link };
 function countsOf(rows, by) {
   const counts = {};
   for (const one of rows) {
     const cell = one[by];
     const held2 = Array.isArray(cell) ? cell : cell == null ? [] : [cell];
     for (const value of held2) {
-      const key = opt(value);
+      const key = row.opt(value);
       if (key !== null) counts[key] = (counts[key] ?? 0) + 1;
     }
   }
@@ -14482,49 +14523,6 @@ function renameFile(file_id, filename) {
   return rpc("file.rename", { file_id, filename });
 }
 
-// src/members.ts
-function readMembers(value) {
-  if (!Array.isArray(value)) return [];
-  const out = [];
-  for (const entry of value) {
-    if (!entry || typeof entry !== "object") continue;
-    const obj = entry;
-    const id = obj.id;
-    if (typeof id !== "string" || id === "") continue;
-    const name = typeof obj.name === "string" ? obj.name : obj.name === null ? null : null;
-    const m = { id, name };
-    if ("email" in obj) m.email = typeof obj.email === "string" ? obj.email : null;
-    if ("image" in obj) m.image = typeof obj.image === "string" ? obj.image : null;
-    if ("groups" in obj) {
-      m.groups = Array.isArray(obj.groups) ? obj.groups.filter((g) => typeof g === "string") : [];
-    }
-    if (obj.role === "owner" || obj.role === "admin" || obj.role === "member") m.role = obj.role;
-    if (typeof obj.joined === "string" && obj.joined !== "") m.joined = obj.joined;
-    if (obj.archived === true) m.archived = true;
-    out.push(m);
-  }
-  return out;
-}
-
-// src/select.ts
-function readSelect(value) {
-  if (!Array.isArray(value)) return [];
-  const out = [];
-  for (const entry of value) {
-    if (typeof entry === "string") {
-      if (entry !== "") out.push({ key: entry, label: entry });
-      continue;
-    }
-    if (!entry || typeof entry !== "object") continue;
-    const obj = entry;
-    const key = obj.key;
-    if (typeof key !== "string" || key === "") continue;
-    const label = typeof obj.label === "string" ? obj.label : key;
-    out.push({ key, label });
-  }
-  return out;
-}
-
 // src/use_recents.ts
 import { useCallback as useCallback8, useEffect as useEffect5, useRef as useRef4, useState as useState4 } from "react";
 var PREFIX = "lotics.recents.";

package/dist/mock.d.ts

@@ -10,7 +10,7 @@ import type { QueryAggregate } from "./shared_types.js";
 import type { WorkflowResult } from "./hooks.js";
 import type { MockAgent } from "./mock_agent_run.js";
 import type { ExportedFile } from "./shared_types.js";
-import type { ExportCall, QuerySortKey } from "./queries.js";
+import type { ExportCall, QuerySortKey } from "./shared_types.js";
 import type { RecordingState } from "./recording_state.js";
 /** A result, or a function of the inputs — return a slow promise to review the pending state. */
 export type MockWorkflow = WorkflowResult | ((inputs: Record<string, unknown>) => WorkflowResult | Promise<WorkflowResult>);

package/dist/queries.d.ts

@@ -1,22 +1,8 @@
 import type { QueryAggregate } from "./shared_types.js";
 import type { AppQueries, AppQueryColumns } from "./types.js";
-import type { ResolvedOption } from "./select.js";
-import type { ReportLanguage } from "./shared_types.js";
+import type { ResolvedOption } from "./shared_types.js";
 import type { ExportedFile } from "./shared_types.js";
-import type { ReportColumn, ReportLabels, ReportReading } from "./shared_types.js";
-/**
- * One row of a query whose columns codegen could not read (a dynamic alias, a
- * bare `from_table`). Values stay `unknown` — the cell readers narrow them.
- * Only the two addressing columns are typed, because they are handed raw to a
- * `record_id` / `table_id`; every other `__*` column has a reader that owns it.
- */
-export interface QueryRow {
-    [column: string]: unknown;
-    /** The record this row came from: null on a grouped row, which stands for no one record. */
-    __source_record_id?: string | null;
-    /** The table that record lives in: null on a grouped row. */
-    __source_table_id?: string | null;
-}
+import type { ExportCall, QueryFilter, QueryRow, QuerySortKey } from "./shared_types.js";
 /**
  * The row type of alias `K`: its projected columns plus the two addressing
  * columns, and no index signature — a column the query does not carry reads
@@ -25,47 +11,6 @@ export interface QueryRow {
 export type RowOf<K extends string> = K extends keyof AppQueryColumns ? {
     [C in AppQueryColumns[K] & string]: unknown;
 } & Pick<QueryRow, "__source_record_id" | "__source_table_id"> : QueryRow;
-/** A column's order — applied after the named query, bounded to its projected columns. */
-export interface QueryFieldSortKey<C extends string = string> {
-    field_key: C;
-    order: "asc" | "desc";
-    /** Where blank cells sit; `"bottom"` when omitted. */
-    blank_position?: "top" | "bottom";
-}
-/** The rows each filter keeps, in turn, before the rest — a row with the first it meets, those meeting none last;
- *  each part in the keys after. At most 8 filters. */
-export interface QueryFirstSortKey<C extends string = string> {
-    first: QueryFilter<C>[];
-}
-/** One key of a read's order; each breaks the ties of the ones before it. */
-export type QuerySortKey<C extends string = string> = QueryFieldSortKey<C> | QueryFirstSortKey<C>;
-export interface QueryFilterFieldCondition<C extends string = string> {
-    node_type: "condition";
-    field_key: C;
-    type?: string;
-    operator: string;
-    value?: unknown;
-    /** A comparison on a figure read in each row's own unit or currency: the option, by key, its value is in. */
-    unit_option?: string;
-}
-/** A condition on the row's own id — no `field_key`, since no field holds it. */
-export interface QueryFilterRecordIdCondition {
-    node_type: "condition";
-    type: "record_id";
-    operator: string;
-    value?: unknown;
-}
-export type QueryFilterCondition<C extends string = string> = QueryFilterFieldCondition<C> | QueryFilterRecordIdCondition;
-export interface QueryFilterGroup<C extends string = string> {
-    node_type: "group";
-    logic: "and" | "or";
-    children: Array<QueryFilterCondition<C> | QueryFilterGroup<C>>;
-}
-/**
- * Runtime filter applied after the named query, bounded to its projected
- * columns — by `C` at compile time and again on the server.
- */
-export type QueryFilter<C extends string = string> = QueryFilterCondition<C> | QueryFilterGroup<C>;
 /** A `filter`/`sort` key on alias `K`: its projected columns, else `string`. */
 export type ColumnKeyOf<K extends string> = K extends keyof AppQueryColumns ? AppQueryColumns[K] & string : string;
 export interface QueryOptions<C extends string = string> {
@@ -201,72 +146,6 @@ export declare function queryAll(alias: string, params?: Record<string, unknown>
     filter?: QueryFilter;
     sort?: readonly QuerySortKey[];
 }): Promise<QueryRow[]>;
-/** What an export states of its rows beside them: the page's title, one line per thing narrowing them, and the
- *  figures over them as the screen drew them. */
-export interface ExportReport {
-    title: string;
-    lines: string[];
-    readings: ReportReading[];
-    /** Each date filter narrowing the rows, by field alias: its bounds, a day or a minute of one, with no zone. */
-    dates?: Record<string, {
-        from?: string;
-        to?: string;
-    }>;
-    /** The file's name, in the template grammar over the report; absent, the template's name, or `title`. */
-    filename?: string;
-    /** The period a register's tabs read their rows over: its bounds, a day or a minute of one, with no zone. */
-    period?: {
-        from: string;
-        to: string;
-    };
-    /** The value the report was picked for (its `per`), as the reader names it. */
-    per?: string;
-    /** The fields of the picked row a one-link `per` names that `filename` reads as `per_row.<field>`, by field alias: a
-     *  scalar, null where the row holds none. */
-    per_row?: Record<string, string | number | boolean | null>;
-}
-/** One tab of the register: its rows read as the export's own are — same query and params — under its own filter and order. */
-export interface ExportTab {
-    tab: string;
-    label: string;
-    filter?: QueryFilter;
-    sort?: readonly QuerySortKey[];
-    /** A tab of totals over the period: the declared query `query` read again under `params` (the period's two days), its
-     *  rows joined to the tab's by the link column `via`, and the columns `columns` each one's `alias` and header. */
-    totals?: {
-        query: string;
-        params: Record<string, string>;
-        via: string;
-        columns: {
-            alias: string;
-            label: string;
-        }[];
-    };
-}
-/** The file an export makes: the default report workbook — its words in `language`, the rows under `columns` on the
- *  tab `sheet` — or a template the query declares under `templates`, by its name there. */
-export type ExportFile = {
-    kind: "workbook";
-    language: ReportLanguage;
-    sheet: string;
-    columns: ReportColumn[];
-} | {
-    kind: "template";
-    template: string;
-};
-export interface ExportCall {
-    params?: Record<string, unknown>;
-    filter?: QueryFilter;
-    sort?: readonly QuerySortKey[];
-    /** A register's tabs, each one's rows beside the call's own (the open tab's): a template reads them under each
-     *  tab's name, the workbook holds one sheet per tab. */
-    tabs?: readonly ExportTab[];
-    report: ExportReport;
-    file: ExportFile;
-    /** The words each option key of a select column prints as, by the column, in either file: a cell the server names
-     *  by its field's option prints as that. */
-    labels?: ReportLabels;
-}
 /**
  * Every row a declared query matches — narrowed by `filter` and ordered by `sort` as a page of it is — made into one
  * file by the server, so no row reaches the browser. Past the most rows one export holds it is refused, never cut.

package/dist/row.d.ts

@@ -5,40 +5,6 @@
  */
 /** The column a predicted row carries, so no surface opens a row the server has not answered for. */
 export declare const PENDING = "__pending";
-/** Select → first option key; `readSelect` for every option. */
-declare function opt(v: unknown): string | null;
-/** Numbers stringified; anything else non-string is "". */
-declare function text(v: unknown): string;
-/** `null` for an empty or non-finite cell — empty is not 0; write `?? 0` where it is. */
-declare function num(v: unknown): number | null;
-/**
- * `null` for an unanswered cell, which is not a "no". Write `=== true` where
- * only yes acts, `?? false` where false is the safe reading.
- */
-declare function bool(v: unknown): boolean | null;
-/**
- * The stored day at local midnight, so placement never shifts across zones. A
- * reduced-precision value ("2026-05") decodes to its period start.
- */
-declare function date(v: unknown): Date | null;
-/**
- * A local Date keeping the stored wall-clock time verbatim, with no UTC
- * conversion; a missing month/day is 1 and a missing time midnight.
- */
-declare function datetime(v: unknown): Date | null;
-export interface ResolvedLink {
-    /** A `rec_…` id, to correlate or filter. */
-    id: string;
-    /** The primary-field value, to render. */
-    display: string;
-}
-/** The first linked record, or null; `readLinks` for all. */
-declare function link(v: unknown): ResolvedLink | null;
-/**
- * Every linked record. A lookup of a link arrives one level deeper (one link
- * cell per linked row); it is flattened here, in order, each id once.
- */
-export declare function readLinks(v: unknown): ResolvedLink[];
 /** A files cell entry; `url`/`thumbnail_url` are presigned (24h) and load from the sandboxed frame. */
 export interface AppFile {
     id: string;
@@ -83,15 +49,6 @@ export declare function readLockedBy(rowValue: unknown): string[];
 export declare function readCreatedAt(rowValue: unknown): Date | null;
 /** `__updated_at`, as {@link readCreatedAt}. */
 export declare function readUpdatedAt(rowValue: unknown): Date | null;
-export declare const row: {
-    opt: typeof opt;
-    text: typeof text;
-    num: typeof num;
-    bool: typeof bool;
-    date: typeof date;
-    datetime: typeof datetime;
-    link: typeof link;
-};
 /**
  * Rows counted per value of one column — what the query RPC's `count_by`
  * answers, over rows already in hand. A cell holding several values (a
@@ -99,4 +56,3 @@ export declare const row: {
  * same rows a `has_any_of` on each value keeps.
  */
 export declare function countsOf(rows: ReadonlyArray<Record<string, unknown>>, by: string): Record<string, number>;
-export {};