@shwfed/config 3.0.9 → 3.0.11

package/dist/runtime/components/table/columns/2026-07-16/com.shwfed.table.column.upload/schema.d.ts

@@ -0,0 +1,138 @@
+import { Schema } from 'effect';
+import type { ColumnDef } from '@tanstack/vue-table';
+import type { Environment } from '../../../../../vendor/cel-js/lib/index.js';
+import type { ColumnDefDeps } from '../../../utils/resolve.js';
+export declare const type: "com.shwfed.table.column.upload";
+export declare const compatibilityDate: "2026-07-16";
+export declare const metadata: {
+    readonly name: "文件上传";
+    readonly icon: "fluent:cloud-arrow-up-20-regular";
+    readonly description: "可编辑的文件上传单元格，值为文件描述对象列表，写回行数据";
+};
+export declare const JSON_VAR: {
+    readonly type: "dyn";
+    readonly label: "HTTP 响应体";
+    readonly description: "第一步 `请求` 的响应体（已解析 JSON）；用于构造第二步下载请求";
+};
+export declare const FILES_VAR: {
+    readonly type: "list<dyn>";
+    readonly label: "已选文件";
+    readonly description: "本次选择的文件列表（`File` 数组）；通常通过 `form({...})` 构造 multipart 请求体";
+};
+export declare const UPLOAD_JSON_VAR: {
+    readonly type: "dyn";
+    readonly label: "上传响应";
+    readonly description: "上传 `请求` 的响应体（已解析 JSON）；用于提取已上传文件项";
+};
+export declare const FILE_VAR: {
+    readonly type: "dyn";
+    readonly label: "文件项";
+    readonly description: "行数据中的单个文件项（服务端回填或上传响应映射所得）；返回其展示文件名";
+};
+export declare function schema(configure: (env: Environment) => void): Schema.Struct<{
+    placeholder: Schema.optional<Schema.suspend<readonly [{
+        readonly locale: "zh";
+        readonly message: string;
+    }, ...{
+        readonly locale: "en" | "ja" | "ko";
+        readonly message: string;
+    }[]], string | readonly [{
+        readonly locale: "zh";
+        readonly message: string;
+    }, ...{
+        readonly locale: "en" | "ja" | "ko";
+        readonly message: string;
+    }[]], never>>;
+    disabled: Schema.optional<Schema.Schema<string, string, never>>;
+    readonly: Schema.optional<Schema.Schema<string, string, never>>;
+    multiple: Schema.optional<Schema.SchemaClass<boolean, boolean, never>>;
+    accept: Schema.optional<Schema.Array$<typeof Schema.String>>;
+    maxFileSize: Schema.optional<Schema.refine<number, typeof Schema.Number>>;
+    maxTotalSize: Schema.optional<Schema.refine<number, typeof Schema.Number>>;
+    maxFiles: Schema.optional<Schema.refine<number, Schema.filter<typeof Schema.Number>>>;
+    upload: Schema.optional<Schema.Struct<{
+        request: Schema.Schema<string, string, never>;
+        handle: Schema.Schema<string, string, never>;
+        filename: Schema.optional<Schema.Schema<string, string, never>>;
+    }>>;
+    templates: Schema.optional<Schema.Array$<Schema.Struct<{
+        request: Schema.Schema<string, string, never>;
+        download: Schema.optional<Schema.Schema<string, string, never>>;
+        icon: Schema.optional<Schema.refine<string, typeof Schema.String>>;
+        label: Schema.optional<Schema.suspend<readonly [{
+            readonly locale: "zh";
+            readonly message: string;
+        }, ...{
+            readonly locale: "en" | "ja" | "ko";
+            readonly message: string;
+        }[]], string | readonly [{
+            readonly locale: "zh";
+            readonly message: string;
+        }, ...{
+            readonly locale: "en" | "ja" | "ko";
+            readonly message: string;
+        }[]], never>>;
+    }>>>;
+    download: Schema.optional<Schema.Struct<{
+        operations: Schema.Array$<Schema.Struct<{
+            id: Schema.optional<Schema.refine<string, typeof Schema.String>>;
+            target: Schema.refine<string, typeof Schema.String>;
+            operation: Schema.SchemaClass<string, string, never>;
+            compatibilityDate: Schema.optional<Schema.SchemaClass<string, string, never>>;
+            params: Schema.optional<Schema.SchemaClass<unknown, unknown, never>>;
+        }>>;
+        icon: Schema.optional<Schema.refine<string, typeof Schema.String>>;
+        label: Schema.optional<Schema.suspend<readonly [{
+            readonly locale: "zh";
+            readonly message: string;
+        }, ...{
+            readonly locale: "en" | "ja" | "ko";
+            readonly message: string;
+        }[]], string | readonly [{
+            readonly locale: "zh";
+            readonly message: string;
+        }, ...{
+            readonly locale: "en" | "ja" | "ko";
+            readonly message: string;
+        }[]], never>>;
+    }>>;
+    title: Schema.suspend<readonly [{
+        readonly locale: "zh";
+        readonly message: string;
+    }, ...{
+        readonly locale: "en" | "ja" | "ko";
+        readonly message: string;
+    }[]], string | readonly [{
+        readonly locale: "zh";
+        readonly message: string;
+    }, ...{
+        readonly locale: "en" | "ja" | "ko";
+        readonly message: string;
+    }[]], never>;
+    binding: Schema.refine<string, typeof Schema.String>;
+    enableSorting: Schema.optional<Schema.SchemaClass<boolean, boolean, never>>;
+    sortKey: Schema.optional<Schema.refine<string, typeof Schema.String>>;
+    size: Schema.optional<Schema.refine<number, Schema.filter<typeof Schema.Number>>>;
+    grow: Schema.optional<Schema.SchemaClass<boolean, boolean, never>>;
+    tooltip: Schema.optional<Schema.suspend<readonly [{
+        readonly locale: "zh";
+        readonly message: string;
+    }, ...{
+        readonly locale: "en" | "ja" | "ko";
+        readonly message: string;
+    }[]], string | readonly [{
+        readonly locale: "zh";
+        readonly message: string;
+    }, ...{
+        readonly locale: "en" | "ja" | "ko";
+        readonly message: string;
+    }[]], never>>;
+    hidden: Schema.optional<Schema.SchemaClass<boolean, boolean, never>>;
+    id: Schema.refine<string, typeof Schema.String>;
+    groupId: Schema.optional<typeof Schema.UUID>;
+    type: Schema.Literal<["com.shwfed.table.column.upload"]>;
+    compatibilityDate: Schema.Literal<["2026-07-16"]>;
+}>;
+export type Value = Schema.Schema.Type<ReturnType<typeof schema>>;
+export declare function defaults(): Partial<Value>;
+export declare function toColumnDef(value: Value, { getLocaleText }: ColumnDefDeps): Partial<ColumnDef<unknown, unknown>>;

package/dist/runtime/components/table/columns/2026-07-16/com.shwfed.table.column.upload/schema.js

@@ -0,0 +1,181 @@
+import { Schema } from "effect";
+import { getProperty } from "dot-prop";
+import { Expression } from "../../../../../share/expression.js";
+import { Triggers } from "../../../../../share/event-bus.js";
+import { Locale } from "../../../../../share/locale.js";
+import {
+  CelRowAccess,
+  editableColumnFields,
+  editableHeader,
+  registerRowVariablesIfAbsent
+} from "../../../utils/shared.js";
+export const type = "com.shwfed.table.column.upload";
+export const compatibilityDate = "2026-07-16";
+export const metadata = {
+  name: "\u6587\u4EF6\u4E0A\u4F20",
+  icon: "fluent:cloud-arrow-up-20-regular",
+  description: "\u53EF\u7F16\u8F91\u7684\u6587\u4EF6\u4E0A\u4F20\u5355\u5143\u683C\uFF0C\u503C\u4E3A\u6587\u4EF6\u63CF\u8FF0\u5BF9\u8C61\u5217\u8868\uFF0C\u5199\u56DE\u884C\u6570\u636E"
+};
+export const JSON_VAR = {
+  type: "dyn",
+  label: "HTTP \u54CD\u5E94\u4F53",
+  description: "\u7B2C\u4E00\u6B65 `\u8BF7\u6C42` \u7684\u54CD\u5E94\u4F53\uFF08\u5DF2\u89E3\u6790 JSON\uFF09\uFF1B\u7528\u4E8E\u6784\u9020\u7B2C\u4E8C\u6B65\u4E0B\u8F7D\u8BF7\u6C42"
+};
+export const FILES_VAR = {
+  type: "list<dyn>",
+  label: "\u5DF2\u9009\u6587\u4EF6",
+  description: "\u672C\u6B21\u9009\u62E9\u7684\u6587\u4EF6\u5217\u8868\uFF08`File` \u6570\u7EC4\uFF09\uFF1B\u901A\u5E38\u901A\u8FC7 `form({...})` \u6784\u9020 multipart \u8BF7\u6C42\u4F53"
+};
+export const UPLOAD_JSON_VAR = {
+  type: "dyn",
+  label: "\u4E0A\u4F20\u54CD\u5E94",
+  description: "\u4E0A\u4F20 `\u8BF7\u6C42` \u7684\u54CD\u5E94\u4F53\uFF08\u5DF2\u89E3\u6790 JSON\uFF09\uFF1B\u7528\u4E8E\u63D0\u53D6\u5DF2\u4E0A\u4F20\u6587\u4EF6\u9879"
+};
+export const FILE_VAR = {
+  type: "dyn",
+  label: "\u6587\u4EF6\u9879",
+  description: "\u884C\u6570\u636E\u4E2D\u7684\u5355\u4E2A\u6587\u4EF6\u9879\uFF08\u670D\u52A1\u7AEF\u56DE\u586B\u6216\u4E0A\u4F20\u54CD\u5E94\u6620\u5C04\u6240\u5F97\uFF09\uFF1B\u8FD4\u56DE\u5176\u5C55\u793A\u6587\u4EF6\u540D"
+};
+function withRowAndVar(configure, name, spec) {
+  return (env) => {
+    configure(env);
+    registerRowVariablesIfAbsent(env);
+    env.registerVariable(name, spec.type, { description: spec.description });
+  };
+}
+export function schema(configure) {
+  const CelBool = CelRowAccess(configure, { resultType: "bool" });
+  const CelHttpRequest = CelRowAccess(configure, { resultType: "HttpRequest" });
+  const CelDownloadRequest = Expression({ configure: withRowAndVar(configure, "json", JSON_VAR), resultType: "HttpRequest" });
+  const CelUploadRequest = Expression({ configure: withRowAndVar(configure, "files", FILES_VAR), resultType: "HttpRequest" });
+  const CelUploadHandle = Expression({ configure: withRowAndVar(configure, "json", UPLOAD_JSON_VAR), resultType: "list" });
+  const CelItemName = Expression({ configure: withRowAndVar(configure, "file", FILE_VAR), resultType: "string" });
+  return Schema.Struct({
+    type: Schema.Literal(type),
+    compatibilityDate: Schema.Literal(compatibilityDate),
+    ...editableColumnFields(),
+    placeholder: Schema.optional(Locale.annotations({
+      title: "\u5360\u4F4D\u7B26",
+      description: "\u5355\u5143\u683C\u4E3A\u7A7A\u65F6\u4E0A\u4F20\u533A\u57DF\u7684\u63D0\u793A\u6587\u672C"
+    })),
+    disabled: Schema.optional(CelBool.annotations({
+      title: "\u7981\u7528\u6761\u4EF6",
+      description: "\u8FD4\u56DE `true` \u65F6\u4E0A\u4F20\u533A\u57DF\u4ECD\u7136\u6E32\u67D3\u4F46\u4E0D\u53EF\u64CD\u4F5C"
+    })),
+    readonly: Schema.optional(CelBool.annotations({
+      title: "\u53EA\u8BFB\u6761\u4EF6",
+      description: "\u8FD4\u56DE `true` \u65F6\u4EC5\u4EE5\u6587\u4EF6\u5217\u8868\u5C55\u793A\u5F53\u524D\u503C\uFF0C\u4E0D\u5141\u8BB8\u589E\u5220"
+    })),
+    multiple: Schema.optional(Schema.Boolean.annotations({
+      title: "\u5141\u8BB8\u591A\u6587\u4EF6",
+      description: "\u5F00\u542F\u540E\u53EF\u4E00\u6B21\u9009\u62E9/\u62D6\u5165\u591A\u4E2A\u6587\u4EF6\uFF1B\u5173\u95ED\u65F6\u65B0\u6587\u4EF6\u4F1A\u66FF\u6362\u5DF2\u9009\u6587\u4EF6"
+    })),
+    accept: Schema.optional(Schema.Array(Schema.String).annotations({
+      title: "\u5141\u8BB8\u7684\u6587\u4EF6\u7C7B\u578B",
+      description: "\u5141\u8BB8\u4E0A\u4F20\u7684 MIME \u7C7B\u578B\u5217\u8868\uFF1B\u7559\u7A7A\u8868\u793A\u4E0D\u9650\u5236"
+    })),
+    maxFileSize: Schema.optional(Schema.Number.pipe(Schema.positive()).annotations({
+      title: "\u5355\u6587\u4EF6\u5927\u5C0F\u9650\u5236",
+      description: "\u5355\u4E2A\u6587\u4EF6\u5141\u8BB8\u7684\u6700\u5927\u5B57\u8282\u6570\uFF1B\u8D85\u8FC7\u6B64\u9650\u5236\u7684\u6587\u4EF6\u4F1A\u88AB\u62D2\u7EDD"
+    })),
+    maxTotalSize: Schema.optional(Schema.Number.pipe(Schema.positive()).annotations({
+      title: "\u603B\u5927\u5C0F\u9650\u5236",
+      description: "\u6240\u6709\u5DF2\u9009\u6587\u4EF6\u7D2F\u8BA1\u7684\u6700\u5927\u5B57\u8282\u6570\uFF1B\u65B0\u589E\u5BFC\u81F4\u8D85\u51FA\u65F6\u4F1A\u88AB\u62D2\u7EDD"
+    })),
+    maxFiles: Schema.optional(Schema.Number.pipe(Schema.int(), Schema.positive()).annotations({
+      title: "\u6587\u4EF6\u6570\u91CF\u9650\u5236",
+      description: "\u5141\u8BB8\u540C\u65F6\u4E0A\u4F20\u7684\u6700\u5927\u6587\u4EF6\u6570\uFF1B\u8FBE\u5230\u4E0A\u9650\u540E\u65B0\u589E\u6587\u4EF6\u4F1A\u88AB\u62D2\u7EDD"
+    })),
+    // Immediate upload. Its presence enables "upload on pick": each picked file
+    // is POSTed right away (`request`), the response is mapped into the stored
+    // items (`handle`), and each stored item's display name is resolved via
+    // `filename`. Absent → files are held as raw `File[]` at the binding and
+    // submitted with whatever consumes the row. Mirrors the form upload field.
+    upload: Schema.optional(Schema.Struct({
+      request: CelUploadRequest.annotations({
+        title: "\u4E0A\u4F20\u8BF7\u6C42",
+        description: '\u8FD4\u56DE `HttpRequest` \u7684 CEL \u8868\u8FBE\u5F0F\uFF1B\u53EF\u901A\u8FC7 `files` \u5F15\u7528\u672C\u6B21\u9009\u62E9\u7684\u6587\u4EF6\uFF0C\u4F8B\u5982 `http.post(url).body(form({"files": files}))`\u3002\u4EE5 `.json()` \u53D1\u8D77'
+      }),
+      handle: CelUploadHandle.annotations({
+        title: "\u5904\u7406\u54CD\u5E94",
+        description: '\u8FD4\u56DE**\u5217\u8868**\u7684 CEL \u8868\u8FBE\u5F0F\uFF0C\u53EF\u901A\u8FC7 `json` \u5F15\u7528\u4E0A\u4F20\u54CD\u5E94\uFF1B\u6620\u5C04\u4E3A\u5199\u5165\u7ED1\u5B9A\u503C\u7684\u6587\u4EF6\u9879\uFF0C\u4F8B\u5982 `json.data.map(d, {"cacheKey": d.key, "filename": d.fileOriginalName})`'
+      }),
+      filename: Schema.optional(CelItemName.annotations({
+        title: "\u6587\u4EF6\u540D",
+        description: "\u8FD4\u56DE `string` \u7684 CEL \u8868\u8FBE\u5F0F\uFF0C\u53EF\u901A\u8FC7 `file` \u5F15\u7528\u5355\u4E2A\u6587\u4EF6\u9879\uFF1B\u7528\u4E8E\u5C55\u793A\u6587\u4EF6\u540D\uFF0C\u4F8B\u5982 `file.filename`\u3002\u7559\u7A7A\u65F6\u56DE\u9000\u5230 `filename` / `name` \u5B57\u6BB5"
+      }))
+    }).annotations({
+      title: "\u5373\u65F6\u4E0A\u4F20",
+      description: "\u914D\u7F6E\u540E\u6587\u4EF6\u5728\u9009\u62E9\u65F6\u7ACB\u5373\u4E0A\u4F20\uFF0C\u7ED1\u5B9A\u503C\u5B58\u50A8\u6620\u5C04\u540E\u7684\u6587\u4EF6\u9879\uFF08\u800C\u975E\u539F\u59CB `File`\uFF09\uFF1B\u4E0D\u914D\u7F6E\u5219\u4FDD\u7559\u6587\u4EF6\u7B49\u5F85\u6574\u884C\u63D0\u4EA4"
+    })),
+    // Download templates — each entry renders one button next to the upload
+    // zone. `request` is the (possibly only) step; `download` is an optional
+    // second step that may reference the first response via `json`.
+    templates: Schema.optional(Schema.Array(Schema.Struct({
+      request: CelHttpRequest.annotations({
+        title: "\u8BF7\u6C42",
+        description: "\u8FD4\u56DE `HttpRequest` \u7684 CEL \u8868\u8FBE\u5F0F\u3002\u672A\u914D\u7F6E\u300C\u4E0B\u8F7D\u8BF7\u6C42\u300D\u65F6\u76F4\u63A5\u53D1\u8D77\u5E76\u4E0B\u8F7D\u5176\u54CD\u5E94\uFF1B\u914D\u7F6E\u4E86\u300C\u4E0B\u8F7D\u8BF7\u6C42\u300D\u65F6\u4F5C\u4E3A\u83B7\u53D6\u4E0B\u8F7D\u51ED\u636E\u7684\u7B2C\u4E00\u6B65\u8BF7\u6C42"
+      }),
+      download: Schema.optional(CelDownloadRequest.annotations({
+        title: "\u4E0B\u8F7D\u8BF7\u6C42",
+        description: "\u53EF\u9009\u7684\u7B2C\u4E8C\u6B65\uFF1A\u8FD4\u56DE `HttpRequest` \u7684 CEL \u8868\u8FBE\u5F0F\uFF0C\u53EF\u901A\u8FC7 `json` \u5F15\u7528\u7B2C\u4E00\u6B65\u7684\u54CD\u5E94\u4F53\uFF0C\u4F8B\u5982\u7528 `json.data.key` \u6784\u9020\u771F\u6B63\u7684\u4E0B\u8F7D\u8BF7\u6C42"
+      })),
+      icon: Schema.optional(Schema.String.pipe(Schema.minLength(1)).annotations({
+        title: "\u6A21\u677F\u6309\u94AE\u56FE\u6807",
+        description: "Iconify \u56FE\u6807\u6807\u8BC6\u7B26\uFF0C\u4F8B\u5982 `fluent:arrow-download-20-regular`\uFF1B\u7559\u7A7A\u65F6\u4F7F\u7528\u9ED8\u8BA4\u56FE\u6807"
+      })),
+      label: Schema.optional(Locale.annotations({
+        title: "\u6A21\u677F\u6309\u94AE\u6587\u672C",
+        description: "\u4E0B\u8F7D\u6A21\u677F\u6309\u94AE\u4E0A\u7684\u672C\u5730\u5316\u6587\u672C\uFF1B\u7559\u7A7A\u65F6\u4F7F\u7528\u300C\u4E0B\u8F7D\u6A21\u677F\u300D"
+      }))
+    })).annotations({
+      title: "\u4E0B\u8F7D\u6A21\u677F",
+      description: "\u4E0B\u8F7D\u6A21\u677F\u5217\u8868\uFF1B\u6BCF\u4E00\u9879\u5728\u4E0A\u4F20\u533A\u57DF\u65C1\u6E32\u67D3\u4E00\u4E2A\u4E0B\u8F7D\u6309\u94AE"
+    })),
+    // Per-file download — a 触发操作 (trigger-operation) list run when the user
+    // clicks a file item's 下载 button, with the clicked stored item in scope as
+    // `file` (the same `FILE_VAR` as `upload.filename`), on top of the row scope.
+    // Object entries download via these operations; a freshly-picked native
+    // `File` bypasses the list and downloads from its in-memory blob. Mirrors the
+    // form upload field.
+    download: Schema.optional(Schema.Struct({
+      operations: Triggers,
+      icon: Schema.optional(Schema.String.pipe(Schema.minLength(1)).annotations({
+        title: "\u4E0B\u8F7D\u6309\u94AE\u56FE\u6807",
+        description: "Iconify \u56FE\u6807\u6807\u8BC6\u7B26\uFF0C\u4F8B\u5982 `fluent:arrow-download-20-regular`\uFF1B\u7559\u7A7A\u65F6\u4F7F\u7528\u9ED8\u8BA4\u56FE\u6807"
+      })),
+      label: Schema.optional(Locale.annotations({
+        title: "\u4E0B\u8F7D\u6309\u94AE\u6587\u672C",
+        description: "\u6BCF\u4E2A\u6587\u4EF6\u9879\u4E0B\u8F7D\u6309\u94AE\u7684\u672C\u5730\u5316\u65E0\u969C\u788D\u6807\u7B7E\uFF1B\u7559\u7A7A\u65F6\u4F7F\u7528\u300C\u4E0B\u8F7D\u300D"
+      }))
+    }).annotations({
+      title: "\u6587\u4EF6\u4E0B\u8F7D",
+      description: "\u914D\u7F6E\u540E\u6BCF\u4E2A\u6587\u4EF6\u9879\u65C1\u6E32\u67D3\u4E0B\u8F7D\u6309\u94AE\uFF1A\u5DF2\u4E0A\u4F20/\u56DE\u586B\u7684\u5BF9\u8C61\u9879\u6309\u300C\u89E6\u53D1\u64CD\u4F5C\u300D\u5217\u8868\u4E0B\u8F7D\uFF08`file` \u4E3A\u8BE5\u6587\u4EF6\u9879\uFF09\uFF1B\u5C1A\u672A\u4E0A\u4F20\u7684\u672C\u5730\u6587\u4EF6\u76F4\u63A5\u4ECE\u5185\u5B58\u4E0B\u8F7D\uFF0C\u4E0D\u7ECF\u8FC7\u8BE5\u5217\u8868"
+    }))
+  }).annotations({ title: "UploadRenderer", description: "\u6587\u4EF6\u4E0A\u4F20\u6E32\u67D3\u5668\uFF08\u53EF\u7F16\u8F91\uFF09" });
+}
+export function defaults() {
+  return {
+    title: [{ locale: "zh", message: "" }],
+    binding: "",
+    size: 200
+  };
+}
+export function toColumnDef(value, { getLocaleText }) {
+  return {
+    header: editableHeader(getLocaleText(value.title)),
+    // `binding` is a dot-prop path (validated non-empty); the cell renderer
+    // reads through the same path it writes to. No CEL — accessor is literal.
+    accessorFn: (row) => {
+      if (!row || typeof row !== "object") return void 0;
+      return getProperty(row, value.binding);
+    },
+    enableSorting: value.enableSorting ?? false,
+    sortingFn: "alphanumeric",
+    size: value.size,
+    meta: {
+      grow: value.grow ?? false,
+      tooltip: getLocaleText(value.tooltip)
+    }
+  };
+}

package/dist/runtime/share/navigation.d.ts

@@ -1 +1,24 @@
 export declare function isAbsoluteUrl(url: string): boolean;
+/**
+ * Demote an absolute href that names OUR OWN origin to a router-ready in-app
+ * path, so `_self` navigation to it is an SPA push rather than a full document
+ * reload. Returns `null` for any other origin — and for opaque-origin schemes
+ * like `mailto:` / `tel:` / custom app schemes — which stay full-page
+ * navigations governed by `isAbsoluteUrl`.
+ *
+ * Why it exists: a CEL author who writes `location.query('tab', 'x')` gets a
+ * `URL` back, and `string(URL)` is the full `.href` — origin and all. Reloading
+ * our own page just to flip a query param is almost never the intent, so a
+ * same-origin absolute is routed internally instead.
+ *
+ * Two subtleties make this more than an `=== origin` check — and are exactly
+ * why it cannot fold back into `isAbsoluteUrl`:
+ *  - The router prepends its history base (`app.baseURL`) to whatever path it
+ *    routes, and a full pathname ALREADY carries that base. Handing it back
+ *    unstripped double-prepends (`/base/x` → `/base/base/x`), so the base is
+ *    peeled off here. Vue Router's `history.base` may or may not carry a
+ *    trailing slash; both normalize.
+ *  - A protocol-relative `//host/x` has no scheme of its own, so it resolves
+ *    against `origin` to inherit ours before the comparison.
+ */
+export declare function sameOriginInternalPath(href: string, origin: string, base: string): string | null;

package/dist/runtime/share/navigation.js

@@ -2,3 +2,18 @@ const ABSOLUTE = /^(?:[a-z][a-z0-9+\-.]*:|\/\/)/i;
 export function isAbsoluteUrl(url) {
   return ABSOLUTE.test(url.trim());
 }
+export function sameOriginInternalPath(href, origin, base) {
+  let url;
+  try {
+    url = new URL(href.trim(), origin);
+  } catch {
+    return null;
+  }
+  if (url.origin !== origin) return null;
+  const path = `${url.pathname}${url.search}${url.hash}`;
+  const prefix = base.replace(/\/+$/, "");
+  if (prefix && (path === prefix || path.startsWith(`${prefix}/`))) {
+    return path.slice(prefix.length) || "/";
+  }
+  return path;
+}

package/dist/runtime/vendor/cel-js/CLAUDE.md

@@ -26,6 +26,8 @@ The `homogeneousAggregateLiterals` and `enableOptionalTypes` environment options
 
 The custom `Optional` class has been replaced with Effect's `Option` type (`import { Option } from 'effect'`). Internal helpers `optionalOf(value)` and `optionalValue(opt)` in `optional.js` handle the CEL-specific semantics (treating `undefined` as `None`, throwing `EvaluationError` on missing value access). The optional surface is `optional.of(A): optional<A>` (the lift / `pure` — `of(null)` is `Some(null)`), `optional.ofNullable(A): optional<A>` (the null-tolerant lift, Java-style — `null` becomes `None`), `optional.none()`, `optional.hasValue()`, `optional.value()`, `optional.or(optional)`, `optional.orValue(value)`, plus `optional<A>.flatMap(var, body): optional<B>` (monadic bind), `optional<A>.map(var, body): optional<B>` (the Functor `fmap`), `optional<A>.zip(other, x, y, body): optional<C>` (the applicative `liftA2` / `zipWith`), `optional<A>.filter(var, predicate): optional<A>` (Rust `Option::filter` / Haskell `mfilter`), and the folds `optional<A>.exists(var, predicate): bool` (predicate on `Some`, `false` on `None` — Rust `is_some_and`) and `optional<A>.all(var, predicate): bool` (predicate on `Some`, vacuously `true` on `None` — Scala `forall`) — all local additions (not from upstream). All are variable-binding macros (registered with `ast` arg types so the unbound args stay unevaluated): on `Some` they bind the value(s) and evaluate `body`; on `None` they short-circuit without touching `body`. `flatMap`'s body must itself yield an `optional`; `map`'s body is a plain value that gets re-wrapped in `Some`; `filter` / `exists` / `all` predicates must be `bool` (enforced at type-check when static, at runtime via `invalid_condition_type` otherwise). `map` is the derived `o.flatMap(v, optional.of(body))` promoted to a first-class macro. `zip` is the flattened `a.flatMap(x, b.map(y, body))`: it type-checks `other` in the outer ctx, binds `x` then `y` under two chained overlays, re-wraps the plain body in `Some`, and short-circuits to `None` if either side is `None` (a `None` receiver skips evaluating `other`). Because CEL has no tuple type the transform is fused (there is no useful `optional<pair>` to return), so `zip` is `zipWith`, not Rust/Scala's pair-building `Option.zip`. The short-circuit makes `zip` observationally monadic — harmless for `optional` (a `None` carries no payload) but it would not generalise to an error-accumulating applicative. An `optional.none()` receiver/argument carries a `param` element type; the shared `bindOptionalValueType` helper (exported from `optional.ts`) binds it as `dyn` so a boolean body still type-checks — every binding macro (`map` / `flatMap` / `zip` / `filter` / `exists` / `all`) goes through it (leaking the `param` into the iteration variable was a real bug in `map` / `flatMap`, regression-tested in `optional-extras.test.ts`). `zip` lives in `optional.ts` beside `flatMap`; the two-variable binding is why it is not folded into the shared `map` expander. NOTE: `map`, `filter`, `all`, and `exists` are **registered in `macros.ts`**, not here — the parser resolves a macro by name before types are known, so the optional variants and the list-comprehension variants must share one expander per name that dispatches on the receiver type at type-check (an `optional` receiver → optional semantics; `list`/`map` → comprehension; a `dyn` receiver is deferred to a runtime `Option.isOption` check). `exists_one` and `find` stay list-only.
 
+A `list.filterMap(var, body): list<dyn>` macro has been added (not from upstream, in `macros.ts` beside `find`) — Rust's `Iterator::filter_map`. The body evaluates to an `optional<B>` per element; `Some` values are kept (unwrapped), `None`s dropped, yielding `list<B>`. It fuses the map-then-strip-absent pattern (which would otherwise need `.map(...)` to build a `list<optional>` plus a second pass to drop the `None`s) and is the optional-gated complement to the 3-arg `map(var, filter, transform)`, whose gate is a bool predicate. NOTE: it is **not** a comprehension desugar — the accu/ternary primitives gate on a bool, not on `Option` presence — so unlike the 2/3-arg `map` and `filter` it runs a manual fold like `find` (eval receiver → coerce Set/Map/object to an array → per-element `ev.eval(body)` → `ensureOptional` → push the `Some`s). Type-check: the receiver element type comes from list `valueType` / map `keyType` / `dyn` (same `invalid_comprehension_range` contract as `find`); the body must be `optional<B>` when statically typed (via `ensureOptionalType`), and a `dyn` body defers to the runtime `ensureOptional` (matching `flatMap`); the result is `registry.getListType(bindOptionalValueType(bodyType))`. Because the body already returns an `optional`, `filterMap` needs no receiver-type dispatch (there is no `optional<A>.filterMap` — that role is `flatMap`), so it is a single list-only expander. Tested in `__tests__/filter-map-macro.test.ts`.
+
 An `http` built-in has been added (`http-builtins.ts`, `http-builder.ts`) — not from upstream. It registers the `http` constant and the `http` / `HttpRequest` types on `globalRegistry`, so `http.get(url).header(...).body(...)` expressions type-check and evaluate in every `Environment`. A CEL expression only builds an `HttpRequestBuilder` — a pure description of a request; it never issues one. The terminal methods `.json()`, `.file()`, and `.fileOrJson()` are dispatched by the host on the returned builder (none is a CEL method), so expression evaluation stays free of IO. `.fileOrJson()` branches on the response `Content-Type`: a JSON media type (`application/json` or a `+json` suffix) is parsed and returned as `{ _tag: 'json', json }`; anything else is returned as `{ _tag: 'file', file }`. Note the `Fetch` service itself `ensureOk`s (both `FetchLive` and the mock layer), so a non-2xx fails at `Fetch.fetch` before the branch and this only ever distinguishes 2xx bodies — i.e. the HTTP-200-with-error-envelope case. The download operation uses it so a backend that answers a download with a JSON error envelope (commonly `{ code: -1 }` on a 200) is classified rather than saved as the file. Endpoints must be absolute URLs — there is no base-URL resolution. Depends on `fx-fetch`. The host can register process-wide default headers via `HttpRequestBuilder.setDefaultHeader(name, valueOrGetter)` / `clearDefaultHeader(name)`; they are merged in at `#buildRequest()` time, with case-insensitive precedence to an explicit `.header(...)` on the builder. A getter that returns `null` / `undefined` / `''` skips the header for that request, so the host can source values from live refs (e.g. the active i18n locale for `Accept-Language`) without baking in stale snapshots. `.query` accepts `(string, string)` / `(string, number)`, the optional-valued `(string, optional<string>)` / `(string, optional<number>)` (a `None`, e.g. an absent `.?` field, drops the param rather than emitting `key=`; `Some` appends it via the string/number coercion), and the record-splat `(dyn)`.
 
 A `form(dyn): FormData` built-in has been added (`form-builtins.ts`) — not from upstream. It registers the `FormData` type on `globalRegistry` and a global `form` function that turns a CEL map into a native `FormData`, so authors can write `http.post(url).body(form({"file": myFile, "name": "Alice"}))` (`.body()` passes `FormData` through verbatim; `#buildRequest()` serializes it). NOTE: `#buildRequest()` must serialize a `FormData` body itself rather than hand it to fx-fetch — fx-fetch clones bodies via `new Response(body).blob()`, and the File API ASCII-lowercases `Blob#type`, so in Chrome the multipart boundary in the derived `Content-Type` loses its case while the body bytes keep it (boundaries are case-sensitive → every parser sees zero parts). The builder lifts the case-preserved `Content-Type` off the `Response` *header* (header values are never case-normalized), adds it as an explicit header (unless the author set their own `Content-Type`), and passes the bytes as a `Promise<Blob>` (fx-fetch resolves promises verbatim). Value coercion mirrors `.query()`'s flat-record semantics: `null` / `undefined` / `Option.None` skip the key; `Option.Some(x)` recurses on `x`; `File` / `Blob` pass through (preserves the `File` filename); `Decimal` → `.toString()` (preserves precision past safe-integer); `Date` (`TZDate`) → `.toISOString()`; `bool` → `'true'` / `'false'`; arrays append one entry per element; nested objects throw (`multipart/form-data` is flat — same rule as `.query(dyn)`). Top-level input must be a map literal / record (Map or plain object); passing an array or scalar throws.
@@ -51,7 +53,7 @@ lib/
 ├── operators.ts      — Binary/unary operator implementations
 ├── overloads.ts      — Operator overload definitions
 ├── functions.ts      — Built-in functions + Date type (TZDate)
-├── macros.ts         — map / filter / all / exists (each dispatching list comprehension vs optional receiver), exists_one, find, has, cel.bind
+├── macros.ts         — map / filter / all / exists (each dispatching list comprehension vs optional receiver), exists_one, find, filterMap, has, cel.bind
 ├── http-builtins.ts  — `http` constant + http/HttpRequest types (local addition)
 ├── http-builder.ts   — `HttpRequestBuilder` — what an http.* expression returns
 ├── json-builtins.ts  — `JSON` constant + `JSON.parse` / `JSON.stringify` (local addition)

package/dist/runtime/vendor/cel-js/PROMPT.md

@@ -505,6 +505,19 @@ Macros are special forms — they look like method calls but have special evalua
 [1, 2, 3, 4, 5].filter(x, x > 3)           // [4, 5]
 ```
 
+### filterMap — Transform-and-keep in one pass (Rust `filter_map`)
+The body returns an `optional<B>` per element; the `Some` values are kept
+(unwrapped) and the `None`s dropped, yielding a `list<B>`. Use it when the
+keep/drop decision *is* the transform — computing the mapped value and its
+presence together — rather than a separate bool predicate. (The 3-arg
+`map(x, filter, transform)` is the bool-predicate form; reach for `filterMap`
+when the gate rides on an `optional`, e.g. a `.?` field or `optional.ofNullable`.)
+```cel
+[1, 2, 3, 4].filterMap(x, x % 2 == 0 ? optional.of(x * 10) : optional.none())  // [20, 40]
+users.filterMap(u, optional.ofNullable(u.email))     // emails of users that have one
+rows.filterMap(r, r.?qty.map(q, q * 2))              // doubled qty, skipping rows without one
+```
+
 ### all — True if ALL elements match
 ```cel
 [1, 2, 3].all(x, x > 0)                    // true

package/dist/runtime/vendor/cel-js/lib/macros.js

@@ -1,7 +1,7 @@
 import { Effect, Option } from "effect";
 import { evaluationError, parseError } from "./errors.js";
 import { OPERATORS as OPS } from "./operators.js";
-import { optionalOf, ensureOptional, bindOptionalValueType } from "./optional.js";
+import { optionalOf, ensureOptional, ensureOptionalType, bindOptionalValueType } from "./optional.js";
 const identity = (x) => x;
 function assertIdentifier(node, message) {
   if (node.op === "id") return node.args;
@@ -294,6 +294,68 @@ function createFindExpander() {
     };
   };
 }
+function createFilterMapExpander() {
+  const functionDesc = "filterMap(var, body)";
+  const invalidMsg = `${functionDesc} invalid iteration variable`;
+  const invalidBody = `${functionDesc} body`;
+  function typeCheck(chk, macro, ctx) {
+    const iterType = chk.check(macro.receiver, ctx);
+    let elemType;
+    if (iterType.kind === "dyn") elemType = iterType;
+    else if (iterType.kind === "list") elemType = iterType.valueType;
+    else if (iterType.kind === "map") elemType = iterType.keyType;
+    else {
+      throw chk.createError(
+        "invalid_comprehension_range",
+        `Expression of type '${iterType}' cannot be range of filterMap (must be list, map, or dynamic).`,
+        macro.receiver
+      );
+    }
+    macro.iterCtx = ctx.forkWithVariable(macro.iterVarName, elemType);
+    const bodyType = ensureOptionalType(chk, macro.body, macro.iterCtx, invalidBody);
+    return chk.registry.getListType(bindOptionalValueType(chk, bodyType));
+  }
+  function evaluate(ev, macro, ctx) {
+    return Effect.gen(function* () {
+      let items = yield* ev.eval(macro.receiver, ctx);
+      if (!Array.isArray(items)) {
+        if (items instanceof Set) items = [...items];
+        else if (items instanceof Map) items = [...items.keys()];
+        else if (items && typeof items === "object") items = Object.keys(items);
+        else {
+          return yield* Effect.fail(
+            ev.createError(
+              "invalid_comprehension_range",
+              `Expression of type '${ev.debugType(items)}' cannot be range of filterMap.`,
+              macro.receiver
+            )
+          );
+        }
+      }
+      const iterCtx = macro.iterCtx.reuse(ctx);
+      const arr = items;
+      const out = [];
+      for (let i = 0; i < arr.length; i++) {
+        const result = yield* ev.eval(macro.body, iterCtx.setIterValue(arr[i], ev));
+        const optional = ensureOptional(result, macro.body, invalidBody);
+        if (Option.isSome(optional)) out.push(optional.value);
+      }
+      return out;
+    });
+  }
+  return (opts) => {
+    const { args, receiver, ast } = opts;
+    return {
+      ast,
+      receiver,
+      iterVarName: assertIdentifier(args[0], invalidMsg),
+      body: args[1],
+      iterCtx: void 0,
+      evaluate,
+      typeCheck
+    };
+  };
+}
 function createHasExpander() {
   const invalidHasArgument = "has() invalid argument";
   function evaluate(ev, macro, ctx) {
@@ -395,6 +457,7 @@ export function registerMacros(registry) {
   functionOverload("list.map(ast, ast, ast): list<dyn>", createMapExpander(true));
   functionOverload("list.filter(ast, ast): list<dyn>", createFilterExpander());
   functionOverload("list.find(ast, ast): optional<dyn>", createFindExpander());
+  functionOverload("list.filterMap(ast, ast): list<dyn>", createFilterMapExpander());
   class CelNamespace {
     #kind = "cel";
     toString() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shwfed/config",
-  "version": "3.0.9",
+  "version": "3.0.11",
   "description": "Configurable UI for SHWFED",
   "type": "module",
   "publishConfig": {
@@ -36,6 +36,7 @@
     "lint": "eslint .",
     "test": "vitest run",
     "test:watch": "vitest watch",
+    "test:ai-eval": "AI_EVAL=1 vitest run --config vitest.eval.config.mjs",
     "test:types": "vue-tsc --noEmit && cd playground && vue-tsc --noEmit"
   },
   "dependencies": {