@klarkxy/dsh-deep-view 0.0.0-stage → 0.2.0

package/lib/contracts.d.ts

@@ -0,0 +1,2 @@
+import { _ as ViewPresentation, a as PLUGIN_NAME, c as RpcResult, d as VIEW_OWNER, f as Value, g as ViewNode, h as ViewFailure, i as HOST_SERVICE, l as Scalar, m as ViewAnswerMetadata, n as DeepViewHost, o as PendingView, p as ViewAnswer, r as Formula, s as RPC_CHANNEL, t as ChoiceOption, u as ShownView, v as isRecord } from "./contracts2.js";
+export { ChoiceOption, DeepViewHost, Formula, HOST_SERVICE, PLUGIN_NAME, PendingView, RPC_CHANNEL, RpcResult, Scalar, ShownView, VIEW_OWNER, Value, ViewAnswer, ViewAnswerMetadata, ViewFailure, ViewNode, ViewPresentation, isRecord };

package/lib/contracts.js

@@ -0,0 +1,12 @@
+//#region src/contracts.ts
+const PLUGIN_NAME = "@klarkxy/dsh-deep-view";
+const RPC_CHANNEL = "/dsh-deep-view";
+const VIEW_OWNER = "dsh-deep-view";
+const HOST_SERVICE = "dshDeepView";
+function isRecord(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//#endregion
+export { HOST_SERVICE, PLUGIN_NAME, RPC_CHANNEL, VIEW_OWNER, isRecord };
+
+//# sourceMappingURL=contracts.js.map

package/lib/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","names":[],"sources":["../src/contracts.ts"],"sourcesContent":["import type { RpcResult as SharedRpcResult } from '@klarkxy/dsh-plugin-kit/contracts'\nexport type RpcResult<T = unknown> = SharedRpcResult<T>\nexport const PLUGIN_NAME = '@klarkxy/dsh-deep-view'\nexport const RPC_CHANNEL = '/dsh-deep-view'\nexport const VIEW_OWNER = 'dsh-deep-view'\nexport const HOST_SERVICE = 'dshDeepView'\nexport type DeepViewHost = {\n  /** Move an open card and route stale session lookups to a replacement root session. */\n  handoffSession(fromSessionId: string, toSessionId: string): boolean\n}\n\nexport type Scalar = string | number | boolean\nexport type Formula = { '=': string }\nexport type Value = Scalar | Formula\nexport type ChoiceOption = { label: string; value?: Scalar }\nexport type ViewNode = {\n  type: 'stack' | 'row' | 'text' | 'metric' | 'table' | 'chart' | 'progress' | 'callout' | 'sources'\n    | 'slider' | 'number' | 'choice' | 'toggle' | 'options' | 'confirm' | 'form' | 'submit'\n  id?: string\n  children?: ViewNode[]\n  let?: Record<string, string>\n  text?: Value\n  label?: string\n  value?: Value\n  tone?: Value\n  caption?: Value\n  columns?: { key: string; label: string }[]\n  rows?: Value[][]\n  kind?: 'bar' | 'hbar' | 'line' | 'area' | 'donut'\n  categories?: Scalar[]\n  series?: { name?: string; values: (number | Formula)[] }[]\n  unit?: string\n  percent?: Value\n  max?: Value\n  valueLabel?: Value\n  items?: { label: string; url: string }[]\n  min?: number\n  step?: number\n  options?: ChoiceOption[] | { label: string; description?: string }[]\n  multi?: boolean\n  confirmLabel?: string\n  cancelLabel?: string\n  fields?: { id: string; label: string; placeholder?: string }[]\n  submitLabel?: string\n}\nexport type ShownView = { title: string; view: ViewNode; interactive: boolean }\nexport type ViewFailure = { error: string }\nexport type PendingView = { id: string; sessionId: string; callId?: string; title: string; view: ViewNode }\nexport type ViewAnswer = { id: string; action: string; values: Record<string, unknown> }\n/** Stored on the same user message as its readable answer, outside model text. */\nexport type ViewAnswerMetadata = { owner: typeof VIEW_OWNER; version: 1; answer: ViewAnswer }\nexport type ViewPresentation = {\n  owner: typeof VIEW_OWNER\n  viewId?: string\n  title: string\n  view: ViewNode\n  interactive: boolean\n  awaitReply: boolean\n}\nexport function isRecord(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === 'object' && !Array.isArray(value)\n}\n"],"mappings":";AAEA,MAAa,cAAc;AAC3B,MAAa,cAAc;AAC3B,MAAa,aAAa;AAC1B,MAAa,eAAe;AAsD5B,SAAgB,SAAS,OAAkD;CACzE,OAAO,UAAU,QAAQ,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK;AAC5E"}

package/lib/contracts2.d.ts

@@ -0,0 +1,103 @@
+import { RpcResult } from "@klarkxy/dsh-plugin-kit/contracts";
+//#region src/contracts.d.ts
+type RpcResult$1<T = unknown> = RpcResult<T>;
+declare const PLUGIN_NAME = "@klarkxy/dsh-deep-view";
+declare const RPC_CHANNEL = "/dsh-deep-view";
+declare const VIEW_OWNER = "dsh-deep-view";
+declare const HOST_SERVICE = "dshDeepView";
+type DeepViewHost = {
+  /** Move an open card and route stale session lookups to a replacement root session. */
+  handoffSession(fromSessionId: string, toSessionId: string): boolean;
+};
+type Scalar = string | number | boolean;
+type Formula = {
+  '=': string;
+};
+type Value = Scalar | Formula;
+type ChoiceOption = {
+  label: string;
+  value?: Scalar;
+};
+type ViewNode = {
+  type: 'stack' | 'row' | 'text' | 'metric' | 'table' | 'chart' | 'progress' | 'callout' | 'sources' | 'slider' | 'number' | 'choice' | 'toggle' | 'options' | 'confirm' | 'form' | 'submit';
+  id?: string;
+  children?: ViewNode[];
+  let?: Record<string, string>;
+  text?: Value;
+  label?: string;
+  value?: Value;
+  tone?: Value;
+  caption?: Value;
+  columns?: {
+    key: string;
+    label: string;
+  }[];
+  rows?: Value[][];
+  kind?: 'bar' | 'hbar' | 'line' | 'area' | 'donut';
+  categories?: Scalar[];
+  series?: {
+    name?: string;
+    values: (number | Formula)[];
+  }[];
+  unit?: string;
+  percent?: Value;
+  max?: Value;
+  valueLabel?: Value;
+  items?: {
+    label: string;
+    url: string;
+  }[];
+  min?: number;
+  step?: number;
+  options?: ChoiceOption[] | {
+    label: string;
+    description?: string;
+  }[];
+  multi?: boolean;
+  confirmLabel?: string;
+  cancelLabel?: string;
+  fields?: {
+    id: string;
+    label: string;
+    placeholder?: string;
+  }[];
+  submitLabel?: string;
+};
+type ShownView = {
+  title: string;
+  view: ViewNode;
+  interactive: boolean;
+};
+type ViewFailure = {
+  error: string;
+};
+type PendingView = {
+  id: string;
+  sessionId: string;
+  callId?: string;
+  title: string;
+  view: ViewNode;
+};
+type ViewAnswer = {
+  id: string;
+  action: string;
+  values: Record<string, unknown>;
+};
+/** Stored on the same user message as its readable answer, outside model text. */
+type ViewAnswerMetadata = {
+  owner: typeof VIEW_OWNER;
+  version: 1;
+  answer: ViewAnswer;
+};
+type ViewPresentation = {
+  owner: typeof VIEW_OWNER;
+  viewId?: string;
+  title: string;
+  view: ViewNode;
+  interactive: boolean;
+  awaitReply: boolean;
+};
+declare function isRecord(value: unknown): value is Record<string, unknown>;
+//#endregion
+export { ViewPresentation as _, PLUGIN_NAME as a, RpcResult$1 as c, VIEW_OWNER as d, Value as f, ViewNode as g, ViewFailure as h, HOST_SERVICE as i, Scalar as l, ViewAnswerMetadata as m, DeepViewHost as n, PendingView as o, ViewAnswer as p, Formula as r, RPC_CHANNEL as s, ChoiceOption as t, ShownView as u, isRecord as v };
+//# sourceMappingURL=contracts2.d.ts.map

package/lib/copy.d.ts

@@ -0,0 +1,37 @@
+//#region src/copy.d.ts
+declare const uiZh: {
+  copy: string;
+  copied: string;
+  footnotes: string;
+  code: string;
+  wrap: string;
+  unwrap: string;
+  prepared: string;
+  preparing: string;
+  error: string;
+  invalid: string;
+  local: string;
+  answerFailed: string;
+  chart: string;
+  chartOptions: string;
+  viewAsChart: string;
+  viewAsTable: string;
+  copyData: string;
+  chartNumber: string;
+  value: string;
+  series: string;
+  view: string;
+  sources: string;
+  progress: string;
+  yourAnswer: string;
+  options: string;
+  submit: string;
+  cancel: string;
+  confirm: string;
+  send: string;
+  selected: string;
+};
+declare const uiEn: Record<keyof typeof uiZh, string>;
+//#endregion
+export { uiEn, uiZh };
+//# sourceMappingURL=copy.d.ts.map

package/lib/copy.js

@@ -0,0 +1,69 @@
+//#region src/copy.ts
+const uiZh = {
+	copy: "复制",
+	copied: "已复制",
+	footnotes: "脚注",
+	code: "代码",
+	wrap: "自动换行",
+	unwrap: "不换行",
+	prepared: "卡片将在最终回复中显示",
+	preparing: "正在准备视图…",
+	error: "视图未能显示",
+	invalid: "视图数据无效",
+	local: "仅本地预览；此卡片不会发送回答。",
+	answerFailed: "回答未能发送，请重试。",
+	chart: "图表",
+	chartOptions: "图表选项",
+	viewAsChart: "查看图表",
+	viewAsTable: "查看表格",
+	copyData: "复制数据",
+	chartNumber: "图表 {n}",
+	value: "值",
+	series: "系列",
+	view: "视图",
+	sources: "来源",
+	progress: "进度",
+	yourAnswer: "你的回答",
+	options: "选项",
+	submit: "提交",
+	cancel: "取消",
+	confirm: "确认",
+	send: "发送",
+	selected: "已选择"
+};
+const uiEn = {
+	copy: "Copy",
+	copied: "Copied",
+	footnotes: "Footnotes",
+	code: "Code",
+	wrap: "Wrap lines",
+	unwrap: "Do not wrap lines",
+	prepared: "The card will appear in the final reply",
+	preparing: "Preparing view…",
+	error: "The view could not be shown",
+	invalid: "Invalid view data",
+	local: "Local preview only; this card does not send an answer.",
+	answerFailed: "The answer could not be sent; try again.",
+	chart: "Chart",
+	chartOptions: "Chart options",
+	viewAsChart: "View as chart",
+	viewAsTable: "View as table",
+	copyData: "Copy data",
+	chartNumber: "Chart {n}",
+	value: "Value",
+	series: "Series",
+	view: "View",
+	sources: "Sources",
+	progress: "Progress",
+	yourAnswer: "Your answer",
+	options: "Options",
+	submit: "Submit",
+	cancel: "Cancel",
+	confirm: "Confirm",
+	send: "Send",
+	selected: "Selected"
+};
+//#endregion
+export { uiEn, uiZh };
+
+//# sourceMappingURL=copy.js.map

package/lib/copy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy.js","names":[],"sources":["../src/copy.ts"],"sourcesContent":["export const uiZh = {\n  copy: '复制', copied: '已复制', footnotes: '脚注', code: '代码', wrap: '自动换行', unwrap: '不换行',\n  prepared: '卡片将在最终回复中显示', preparing: '正在准备视图…', error: '视图未能显示', invalid: '视图数据无效',\n  local: '仅本地预览；此卡片不会发送回答。', answerFailed: '回答未能发送，请重试。',\n  chart: '图表', chartOptions: '图表选项', viewAsChart: '查看图表', viewAsTable: '查看表格', copyData: '复制数据',\n  chartNumber: '图表 {n}', value: '值', series: '系列', view: '视图', sources: '来源', progress: '进度', yourAnswer: '你的回答',\n  options: '选项', submit: '提交', cancel: '取消', confirm: '确认', send: '发送', selected: '已选择',\n}\n\nexport const uiEn: Record<keyof typeof uiZh, string> = {\n  copy: 'Copy', copied: 'Copied', footnotes: 'Footnotes', code: 'Code', wrap: 'Wrap lines', unwrap: 'Do not wrap lines',\n  prepared: 'The card will appear in the final reply', preparing: 'Preparing view…', error: 'The view could not be shown', invalid: 'Invalid view data',\n  local: 'Local preview only; this card does not send an answer.', answerFailed: 'The answer could not be sent; try again.',\n  chart: 'Chart', chartOptions: 'Chart options', viewAsChart: 'View as chart', viewAsTable: 'View as table', copyData: 'Copy data',\n  chartNumber: 'Chart {n}', value: 'Value', series: 'Series', view: 'View', sources: 'Sources', progress: 'Progress', yourAnswer: 'Your answer',\n  options: 'Options', submit: 'Submit', cancel: 'Cancel', confirm: 'Confirm', send: 'Send', selected: 'Selected',\n}\n"],"mappings":";AAAA,MAAa,OAAO;CAClB,MAAM;CAAM,QAAQ;CAAO,WAAW;CAAM,MAAM;CAAM,MAAM;CAAQ,QAAQ;CAC9E,UAAU;CAAe,WAAW;CAAW,OAAO;CAAU,SAAS;CACzE,OAAO;CAAoB,cAAc;CACzC,OAAO;CAAM,cAAc;CAAQ,aAAa;CAAQ,aAAa;CAAQ,UAAU;CACvF,aAAa;CAAU,OAAO;CAAK,QAAQ;CAAM,MAAM;CAAM,SAAS;CAAM,UAAU;CAAM,YAAY;CACxG,SAAS;CAAM,QAAQ;CAAM,QAAQ;CAAM,SAAS;CAAM,MAAM;CAAM,UAAU;AAClF;AAEA,MAAa,OAA0C;CACrD,MAAM;CAAQ,QAAQ;CAAU,WAAW;CAAa,MAAM;CAAQ,MAAM;CAAc,QAAQ;CAClG,UAAU;CAA2C,WAAW;CAAmB,OAAO;CAA+B,SAAS;CAClI,OAAO;CAA0D,cAAc;CAC/E,OAAO;CAAS,cAAc;CAAiB,aAAa;CAAiB,aAAa;CAAiB,UAAU;CACrH,aAAa;CAAa,OAAO;CAAS,QAAQ;CAAU,MAAM;CAAQ,SAAS;CAAW,UAAU;CAAY,YAAY;CAChI,SAAS;CAAW,QAAQ;CAAU,QAAQ;CAAU,SAAS;CAAW,MAAM;CAAQ,UAAU;AACtG"}

package/lib/core.d.ts

@@ -0,0 +1,57 @@
+import { g as ViewNode, h as ViewFailure, l as Scalar, r as Formula, u as ShownView } from "./contracts2.js";
+//#region src/core/index.d.ts
+declare const CHART_KINDS: readonly string[];
+declare const VIEW_BYTE_LIMIT: number;
+declare const FORMULA_FUNCTIONS: readonly string[];
+declare function isName(value: unknown): value is string;
+declare function show(value: unknown): string;
+declare function asText(value: unknown): string;
+declare function checkShownView(title: unknown, sent: unknown): ShownView | ViewFailure;
+declare function normalizeView(value: unknown): unknown;
+declare function validateView(view: unknown): {
+  ok: true;
+  interactive: boolean;
+} | {
+  ok: false;
+  error: string;
+};
+declare function viewBytes(title: unknown, view: unknown): number;
+declare function viewInputs(view: ViewNode): ViewNode[];
+declare function inputDefault(node: ViewNode): unknown;
+declare function choiceValue(option: {
+  label?: string;
+  value?: Scalar;
+} | undefined): Scalar | undefined;
+declare function viewScope(view: ViewNode, values?: Record<string, unknown>): (name: string) => unknown;
+declare function resolve(value: unknown, lookup: (name: string) => unknown, fallback?: unknown): unknown;
+declare function validateViewAnswer(view: ViewNode, action: unknown, values: unknown): Record<string, unknown> & {
+  error?: string;
+};
+declare function viewSummary(view: ViewNode): string;
+declare function inputsSummary(view: ViewNode, values: unknown): string;
+declare function hasInputs(view: ViewNode): boolean;
+declare function isFormula(value: unknown): value is Formula;
+type FormulaTree = {
+  type: string;
+  [key: string]: unknown;
+};
+declare function compileFormula(source: unknown): {
+  tree: FormulaTree;
+  names: string[];
+  error?: undefined;
+} | {
+  error: string;
+  tree?: undefined;
+  names?: undefined;
+};
+declare function createScope(inputs: Map<string, unknown>, lets: Map<string, FormulaTree>): (name: string) => unknown;
+declare function evaluate(tree: FormulaTree, lookup: (name: string) => unknown): {
+  value: unknown;
+  error?: undefined;
+} | {
+  error: string;
+  value?: undefined;
+};
+//#endregion
+export { CHART_KINDS, FORMULA_FUNCTIONS, VIEW_BYTE_LIMIT, asText, checkShownView, choiceValue, compileFormula, createScope, evaluate, hasInputs, inputDefault, inputsSummary, isFormula, isName, normalizeView, resolve, show, validateView, validateViewAnswer, viewBytes, viewInputs, viewScope, viewSummary };
+//# sourceMappingURL=core.d.ts.map

package/lib/core.js

@@ -0,0 +1,2 @@
+import { C as show, S as isName, _ as viewSummary, a as choiceValue, b as createScope, c as inputsSummary, d as resolve, f as validateView, g as viewScope, h as viewInputs, i as checkShownView, l as isFormula, m as viewBytes, n as VIEW_BYTE_LIMIT, o as hasInputs, p as validateViewAnswer, r as asText, s as inputDefault, t as CHART_KINDS, u as normalizeView, v as FORMULA_FUNCTIONS, x as evaluate, y as compileFormula } from "./core2.js";
+export { CHART_KINDS, FORMULA_FUNCTIONS, VIEW_BYTE_LIMIT, asText, checkShownView, choiceValue, compileFormula, createScope, evaluate, hasInputs, inputDefault, inputsSummary, isFormula, isName, normalizeView, resolve, show, validateView, validateViewAnswer, viewBytes, viewInputs, viewScope, viewSummary };