@shwfed/config 3.0.12 → 3.0.13

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

@@ -48,24 +48,6 @@ const EXTENSIONS = {
   "application/msword": [".doc"],
   "application/vnd.openxmlformats-officedocument.wordprocessingml.document": [".docx"]
 };
-const SHORT_NAMES = {
-  "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": "XLSX",
-  "application/vnd.ms-excel": "XLS",
-  "application/vnd.openxmlformats-officedocument.presentationml.presentation": "PPTX",
-  "application/vnd.ms-powerpoint": "PPT",
-  "application/zip": "ZIP",
-  "application/x-zip-compressed": "ZIP",
-  "application/vnd.rar": "RAR",
-  "application/x-rar-compressed": "RAR",
-  "application/pdf": "PDF",
-  "application/ofd": "OFD",
-  "application/xml": "XML",
-  "image/png": "PNG",
-  "image/jpg": "JPG",
-  "image/jpeg": "JPEG",
-  "application/msword": "DOC",
-  "application/vnd.openxmlformats-officedocument.wordprocessingml.document": "DOCX"
-};
 defineOptions({ name: "ShwfedTableUploadRendererRuntime" });
 const props = defineProps({
   column: { type: null, required: true },
@@ -76,7 +58,6 @@ const { locale, t } = useI18n({
   messages: {
     zh: {
       "upload-add-file": "\u6DFB\u52A0\u6587\u4EF6",
-      "upload-accept-hint": "\u4EC5\u63A5\u53D7 {types}",
       "upload-rejected-mime": "\u300C{name}\u300D\u7C7B\u578B\u4E0D\u88AB\u5141\u8BB8",
       "upload-rejected-size": "\u300C{name}\u300D\u8D85\u51FA\u5355\u6587\u4EF6\u5927\u5C0F\u9650\u5236",
       "upload-rejected-total": "\u300C{name}\u300D\u52A0\u5165\u540E\u5C06\u8D85\u51FA\u603B\u5927\u5C0F\u9650\u5236",
@@ -86,7 +67,6 @@ const { locale, t } = useI18n({
     },
     en: {
       "upload-add-file": "Add file",
-      "upload-accept-hint": "Only {types} are accepted",
       "upload-rejected-mime": "{name} is not an allowed file type",
       "upload-rejected-size": "{name} exceeds the maximum file size",
       "upload-rejected-total": "{name} would exceed the total size limit",
@@ -96,7 +76,6 @@ const { locale, t } = useI18n({
     },
     ja: {
       "upload-add-file": "\u30D5\u30A1\u30A4\u30EB\u3092\u8FFD\u52A0",
-      "upload-accept-hint": "{types} \u306E\u307F\u53D7\u3051\u4ED8\u3051\u307E\u3059",
       "upload-rejected-mime": "\u300C{name}\u300D\u306F\u8A31\u53EF\u3055\u308C\u305F\u30D5\u30A1\u30A4\u30EB\u5F62\u5F0F\u3067\u306F\u3042\u308A\u307E\u305B\u3093",
       "upload-rejected-size": "\u300C{name}\u300D\u306F\u30D5\u30A1\u30A4\u30EB\u30B5\u30A4\u30BA\u306E\u4E0A\u9650\u3092\u8D85\u3048\u3066\u3044\u307E\u3059",
       "upload-rejected-total": "\u300C{name}\u300D\u3092\u8FFD\u52A0\u3059\u308B\u3068\u5408\u8A08\u30B5\u30A4\u30BA\u306E\u4E0A\u9650\u3092\u8D85\u3048\u307E\u3059",
@@ -110,9 +89,6 @@ const formState = useFormState();
 const inherited = injectCELContext();
 const $cel = (expression, context) => _rawCel(expression, celScope(inherited, context));
 const eventChannel = useEventChannel();
-const placeholderText = computed(
-  () => props.column.placeholder ? getLocalizedText(props.column.placeholder, locale.value) : void 0
-);
 function evalBool(expression, label) {
   if (!expression) return false;
   try {
@@ -160,19 +136,24 @@ function entryIcon(entry) {
   if (entry instanceof File) return ICONS[entry.type] ?? "fluent:document-20-regular";
   return "fluent:document-20-regular";
 }
+const addIcon = computed(() => props.column.addIcon ?? "fluent:add-20-regular");
+const addLabel = computed(
+  () => (props.column.addLabel ? getLocalizedText(props.column.addLabel, locale.value) : void 0) ?? t("upload-add-file")
+);
 const inputRef = ref();
 const acceptAttr = computed(() => {
   const list = props.column.accept;
   return list && list.length > 0 ? list.join(",") : void 0;
 });
-const acceptHint = computed(() => {
-  const list = props.column.accept;
-  if (!list || list.length === 0) return void 0;
-  return Array.from(new Set(list.map((m) => SHORT_NAMES[m] ?? m))).join("\u3001");
+const effectiveMaxFiles = computed(() => {
+  const configured = props.column.maxFiles;
+  if (props.column.multiple !== true) return Math.min(1, configured ?? 1);
+  return configured;
+});
+const isFull = computed(() => {
+  const cap = effectiveMaxFiles.value;
+  return cap !== void 0 && entries.value.length >= cap;
 });
-const isFull = computed(
-  () => props.column.maxFiles !== void 0 && entries.value.length >= props.column.maxFiles
-);
 const canAdd = computed(() => !isDisabled.value && !isReadonly.value && !isFull.value && !uploading.value);
 function isMimeAllowed(file) {
   const list = props.column.accept;
@@ -197,7 +178,7 @@ function partition(incoming) {
       rejected.push({ file, reason: "size" });
       continue;
     }
-    if (props.column.maxFiles !== void 0 && count >= props.column.maxFiles) {
+    if (effectiveMaxFiles.value !== void 0 && count >= effectiveMaxFiles.value) {
       rejected.push({ file, reason: "count" });
       continue;
     }
@@ -264,13 +245,6 @@ function onAddClick() {
   if (!canAdd.value) return;
   inputRef.value?.click();
 }
-function onKeydown(event) {
-  if (!canAdd.value) return;
-  if (event.key === "Enter" || event.key === " ") {
-    event.preventDefault();
-    inputRef.value?.click();
-  }
-}
 function onDelete(index) {
   if (isDisabled.value || isReadonly.value || uploading.value) return;
   const next = [...entries.value];
@@ -287,34 +261,6 @@ function saveFile(file) {
   a.remove();
   URL.revokeObjectURL(url);
 }
-const templates = computed(() => props.column.templates ?? []);
-function templateIcon(template) {
-  return template.icon ?? "fluent:arrow-download-20-regular";
-}
-function templateLabelText(template) {
-  return (template.label ? getLocalizedText(template.label, locale.value) : void 0) ?? "\u4E0B\u8F7D\u6A21\u677F";
-}
-async function onDownloadTemplate(template) {
-  const program = Effect.gen(function* () {
-    const requestBuilder = yield* $cel(template.request, {});
-    if (!template.download) {
-      return yield* requestBuilder.file();
-    }
-    const json = yield* requestBuilder.json();
-    const downloadBuilder = yield* $cel(template.download, { json });
-    return yield* downloadBuilder.file();
-  });
-  try {
-    const file = await Effect.runPromise(Effect.provide(program, Fetch.layer));
-    if (!(file instanceof File)) {
-      console.error(`[shwfed-table] template request for ${props.column.id} did not produce a File`);
-      return;
-    }
-    saveFile(file);
-  } catch (err) {
-    console.error(`[shwfed-table] failed to download template for ${props.column.id}:`, err);
-  }
-}
 const downloadEnabled = computed(() => props.column.download != null);
 const downloadIcon = computed(() => props.column.download?.icon ?? "fluent:arrow-download-20-regular");
 const downloadLabel = computed(
@@ -418,53 +364,26 @@ async function onDownloadEntry(entry) {
       </ul>
 
       <!--
-        Empty editable state: a compact dashed add zone. Kept short (min-h-16)
-        so an empty row does not tower over its neighbours; the non-empty list
-        grows only as far as the files it holds.
+        Add button — the only affordance for picking files, empty cell or not.
+        A cell is one grid row tall, so the dashed drop zone this replaces made
+        empty rows tower over their neighbours. `isFull` hides it (nothing left
+        to add); `isDisabled` keeps it rendered but inert, per the schema.
       -->
-      <div
-        v-else
-        role="button"
-        :tabindex="canAdd ? 0 : -1"
-        data-slot="upload-zone"
-        :data-disabled="isDisabled || void 0"
-        :aria-disabled="isDisabled || void 0"
-        class="flex min-h-16 w-full flex-col items-center justify-center gap-1 rounded border border-dashed border-zinc-200 bg-zinc-50/60 px-2 py-2 outline-none transition-colors duration-180 ease-out focus-visible:border-(--primary) data-[disabled=true]:cursor-not-allowed data-[disabled=true]:opacity-60"
-        :class="canAdd && 'cursor-pointer hover:border-zinc-400 hover:bg-zinc-100'"
-        @click="onAddClick"
-        @keydown="onKeydown"
-      >
-        <Icon
-          :icon="uploading ? 'fluent:spinner-ios-20-regular' : 'fluent:cloud-arrow-up-20-regular'"
-          class="size-5 text-zinc-400"
-          :class="uploading && 'animate-spin'"
-        />
-        <p class="text-[0.7rem] text-zinc-500">
-          {{ uploading ? t("upload-uploading") : placeholderText ?? t("upload-add-file") }}
-        </p>
-        <p
-          v-if="acceptHint"
-          class="text-[0.65rem] text-zinc-400"
-        >
-          {{ t("upload-accept-hint", { types: acceptHint }) }}
-        </p>
-      </div>
-
-      <!-- Add button — only when the list is non-empty and adding is allowed. -->
       <Button
-        v-if="entries.length > 0 && canAdd"
+        v-if="!isReadonly && !isFull"
         type="button"
         variant="default"
         size="sm"
         data-slot="upload-zone-add"
         class="h-6 w-full shrink-0 text-[0.75rem]"
+        :disabled="isDisabled || uploading"
         @click="onAddClick"
       >
         <Icon
-          :icon="uploading ? 'fluent:spinner-ios-20-regular' : 'fluent:add-20-regular'"
+          :icon="uploading ? 'fluent:spinner-ios-20-regular' : addIcon"
           :class="uploading && 'animate-spin'"
         />
-        {{ uploading ? t("upload-uploading") : t("upload-add-file") }}
+        {{ uploading ? t("upload-uploading") : addLabel }}
       </Button>
 
       <input
@@ -476,28 +395,6 @@ async function onDownloadEntry(entry) {
         :disabled="isDisabled || isReadonly"
         @change="onPickerChange"
       >
-
-      <div
-        v-if="templates.length > 0 && !isReadonly"
-        class="flex flex-wrap justify-end gap-1"
-      >
-        <Button
-          v-for="(template, index) in templates"
-          :key="index"
-          type="button"
-          variant="link"
-          size="sm"
-          data-slot="upload-zone-template"
-          class="h-5 px-1 text-[0.7rem]"
-          @click="onDownloadTemplate(template)"
-        >
-          <Icon
-            :icon="templateIcon(template)"
-            class="size-3.5"
-          />
-          {{ templateLabelText(template) }}
-        </Button>
-      </div>
     </div>
   </div>
 </template>

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

@@ -9,11 +9,6 @@ export declare const metadata: {
     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: "已选文件";
@@ -30,7 +25,11 @@ export declare const FILE_VAR: {
     readonly description: "行数据中的单个文件项（服务端回填或上传响应映射所得）；返回其展示文件名";
 };
 export declare function schema(configure: (env: Environment) => void): Schema.Struct<{
-    placeholder: Schema.optional<Schema.suspend<readonly [{
+    disabled: Schema.optional<Schema.Schema<string, string, never>>;
+    readonly: Schema.optional<Schema.Schema<string, string, never>>;
+    multiple: Schema.optional<Schema.SchemaClass<boolean, boolean, never>>;
+    addIcon: Schema.optional<Schema.refine<string, typeof Schema.String>>;
+    addLabel: Schema.optional<Schema.suspend<readonly [{
         readonly locale: "zh";
         readonly message: string;
     }, ...{
@@ -43,9 +42,6 @@ export declare function schema(configure: (env: Environment) => void): Schema.St
         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>>;
@@ -55,24 +51,6 @@ export declare function schema(configure: (env: Environment) => void): Schema.St
         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>>;

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

@@ -16,11 +16,6 @@ export const metadata = {
   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",
@@ -45,8 +40,6 @@ function withRowAndVar(configure, name, spec) {
 }
 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" });
@@ -54,13 +47,9 @@ export function schema(configure) {
     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"
+      description: "\u8FD4\u56DE `true` \u65F6\u6DFB\u52A0\u6309\u94AE\u4ECD\u7136\u6E32\u67D3\u4F46\u4E0D\u53EF\u64CD\u4F5C"
     })),
     readonly: Schema.optional(CelBool.annotations({
       title: "\u53EA\u8BFB\u6761\u4EF6",
@@ -68,7 +57,15 @@ export function schema(configure) {
     })),
     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"
+      description: "\u5F00\u542F\u540E\u53EF\u4E00\u6B21\u9009\u62E9\u591A\u4E2A\u6587\u4EF6\uFF1B\u5173\u95ED\u65F6\u6700\u591A\u4FDD\u7559\u4E00\u4E2A\u6587\u4EF6\uFF0C\u9700\u5148\u5220\u9664\u5DF2\u6709\u6587\u4EF6\u624D\u80FD\u91CD\u65B0\u6DFB\u52A0"
+    })),
+    addIcon: Schema.optional(Schema.String.pipe(Schema.minLength(1)).annotations({
+      title: "\u6DFB\u52A0\u6309\u94AE\u56FE\u6807",
+      description: "Iconify \u56FE\u6807\u6807\u8BC6\u7B26\uFF0C\u4F8B\u5982 `fluent:add-20-regular`\uFF1B\u7559\u7A7A\u65F6\u4F7F\u7528\u9ED8\u8BA4\u56FE\u6807"
+    })),
+    addLabel: Schema.optional(Locale.annotations({
+      title: "\u6DFB\u52A0\u6309\u94AE\u6587\u672C",
+      description: "\u6DFB\u52A0\u6587\u4EF6\u6309\u94AE\u4E0A\u7684\u672C\u5730\u5316\u6587\u672C\uFF1B\u7559\u7A7A\u65F6\u4F7F\u7528\u300C\u6DFB\u52A0\u6587\u4EF6\u300D"
     })),
     accept: Schema.optional(Schema.Array(Schema.String).annotations({
       title: "\u5141\u8BB8\u7684\u6587\u4EF6\u7C7B\u578B",
@@ -108,30 +105,6 @@ export function schema(configure) {
       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.

package/dist/runtime/components/ui/invoice/InvoiceSheet.d.vue.ts

@@ -0,0 +1,66 @@
+/**
+ * 数电票的票面骨架。国家税务总局的数电票是**一张底版 + 逐业务的差异**：抬头（双线标题 /
+ * 发票号码 / 开票日期）、购销双方、明细三表对齐、合计、价税合计大小写、备注框、开票人
+ * 在全家族逐像素相同；只有「业务标签」「明细有哪些列」「备注里有哪些栏」逐票不同。
+ * 这里收口相同的那部分，差异走 slot。
+ *
+ * 列宽（`colgroup`）刻意由调用方给：明细列逐业务不同，但**同一张票的三张表必须共用同
+ * 一份 colgroup** 才对得齐，所以它属于「块自己写一份、三处都用」，不属于骨架。同理
+ * 合计行（`items-foot`）—— 金额 / 税额落在第几列取决于该票的列，骨架不该猜。
+ */
+type __VLS_Props = {
+    /** 票面标题全文，如 `电子发票（增值税专用发票）`。骨架不认识票种。 */
+    title: string;
+    invoiceNumber: string;
+    issueDate: string;
+    buyer: {
+        name: string;
+        taxId: string;
+    };
+    seller: {
+        name: string;
+        taxId: string;
+    };
+    /** 价税合计（小写）。已格式化，空串即不打印 `¥`。 */
+    grandTotal: string;
+    /** 价税合计（大写）。空串即留空 —— 见 `useInvoiceEval` 的 `capital`。 */
+    grandTotalCapital: string;
+    issuer?: string;
+    /** 为真时票面中央叠加「红字发票」水印。 */
+    redLetter?: boolean;
+    /** 明细列数 —— 只用来给填充空行的 `colspan` 定宽。 */
+    columnCount: number;
+    /** 实际明细行数 —— 骨架据此补足填充空行。 */
+    rowCount: number;
+    /** 明细区最大高度（CSS 长度）。留空则明细区随行数增长，滚动条永不出现。 */
+    itemsMaxHeight?: string;
+};
+declare var __VLS_1: {}, __VLS_3: {}, __VLS_5: {}, __VLS_13: {}, __VLS_15: {}, __VLS_17: {}, __VLS_19: {}, __VLS_21: {};
+type __VLS_Slots = {} & {
+    business?: (props: typeof __VLS_1) => any;
+} & {
+    colgroup?: (props: typeof __VLS_3) => any;
+} & {
+    'items-head'?: (props: typeof __VLS_5) => any;
+} & {
+    colgroup?: (props: typeof __VLS_13) => any;
+} & {
+    'items-body'?: (props: typeof __VLS_15) => any;
+} & {
+    colgroup?: (props: typeof __VLS_17) => any;
+} & {
+    'items-foot'?: (props: typeof __VLS_19) => any;
+} & {
+    remark?: (props: typeof __VLS_21) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    redLetter: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/runtime/components/ui/invoice/InvoiceSheet.vue

@@ -0,0 +1,182 @@
+<script setup>
+import { computed } from "vue";
+import { ScrollArea } from "../scroll-area";
+defineOptions({ name: "ShwfedInvoiceSheet" });
+const props = defineProps({
+  title: { type: String, required: true },
+  invoiceNumber: { type: String, required: true },
+  issueDate: { type: String, required: true },
+  buyer: { type: Object, required: true },
+  seller: { type: Object, required: true },
+  grandTotal: { type: String, required: true },
+  grandTotalCapital: { type: String, required: true },
+  issuer: { type: String, required: false },
+  redLetter: { type: Boolean, required: false, default: false },
+  columnCount: { type: Number, required: true },
+  rowCount: { type: Number, required: true },
+  itemsMaxHeight: { type: String, required: false }
+});
+const MIN_ROWS = 6;
+const fillerRows = computed(() => Math.max(0, MIN_ROWS - props.rowCount));
+const itemsStyle = computed(
+  () => props.itemsMaxHeight ? { maxHeight: props.itemsMaxHeight } : void 0
+);
+</script>
+
+<template>
+  <div class="invoice">
+    <!-- 抬头：标题相对整张票居中，业务标签 / 号码块靠两侧 -->
+    <header class="head">
+      <div class="business">
+        <slot name="business" />
+      </div>
+      <div class="title-block">
+        <h1 class="title">
+          {{ title }}
+        </h1>
+        <div
+          class="title-rule"
+          aria-hidden="true"
+        />
+      </div>
+      <dl class="meta">
+        <div>
+          <dt>发票号码：</dt>
+          <dd>{{ invoiceNumber }}</dd>
+        </div>
+        <div>
+          <dt>开票日期：</dt>
+          <dd>{{ issueDate }}</dd>
+        </div>
+      </dl>
+    </header>
+
+    <div class="frame">
+      <!-- 购销双方 -->
+      <div class="parties">
+        <div class="party">
+          <div class="side-label">
+            购买方信息
+          </div>
+          <div class="party-body">
+            <div class="party-row">
+              <span class="party-key">名称：</span>
+              <span class="party-value">{{ buyer.name }}</span>
+            </div>
+            <div class="party-row">
+              <span class="party-key">统一社会信用代码/纳税人识别号：</span>
+              <span class="party-value tax-id">{{ buyer.taxId }}</span>
+            </div>
+          </div>
+        </div>
+        <div class="party">
+          <div class="side-label">
+            销售方信息
+          </div>
+          <div class="party-body">
+            <div class="party-row">
+              <span class="party-key">名称：</span>
+              <span class="party-value">{{ seller.name }}</span>
+            </div>
+            <div class="party-row">
+              <span class="party-key">统一社会信用代码/纳税人识别号：</span>
+              <span class="party-value tax-id">{{ seller.taxId }}</span>
+            </div>
+          </div>
+        </div>
+      </div>
+
+      <!-- 明细。列标题 / 内容 / 合计拆成三张 table，只有中间那张进 ScrollArea ——
+           ScrollArea 的滚动条是覆盖整个滚动容器高度的绝对定位条，表头表尾若也在里面
+           就会被它横穿。三张靠调用方给的同一份 colgroup 对齐（都是 table-layout: fixed）。 -->
+      <div class="items">
+        <!-- 水印：在明细内容**之下**（纸质票的红字是印在票面底纹上、被文字压住的），
+             不参与布局，也不拦截选中 -->
+        <div
+          v-if="redLetter"
+          class="watermark"
+          aria-hidden="true"
+        >
+          红字发票
+        </div>
+
+        <table class="items-head">
+          <slot name="colgroup" />
+          <thead>
+            <slot name="items-head" />
+          </thead>
+        </table>
+
+        <!-- `overscroll-none`：明细滚到头就停住，既不橡皮筋回弹、也不把滚动传给外层页面
+             —— 票是嵌在页面里的一小块，滚它不该顺带滚走整张页面。 -->
+        <ScrollArea
+          class="items-body"
+          viewport-class="overscroll-none"
+          :style="itemsStyle"
+        >
+          <table>
+            <slot name="colgroup" />
+            <tbody>
+              <slot name="items-body" />
+              <!-- 撑满票面的空行，纸质票同款 -->
+              <tr
+                v-for="n in fillerRows"
+                :key="`filler-${n}`"
+                class="filler"
+              >
+                <td :colspan="columnCount">
+                  &nbsp;
+                </td>
+              </tr>
+            </tbody>
+          </table>
+        </ScrollArea>
+
+        <table class="items-foot">
+          <slot name="colgroup" />
+          <tfoot>
+            <slot name="items-foot" />
+          </tfoot>
+        </table>
+      </div>
+
+      <!-- 价税合计 -->
+      <div class="grand">
+        <div class="grand-label">
+          价税合计（大写）
+        </div>
+        <div class="grand-capital">
+          <span class="cross">⊗</span>{{ grandTotalCapital }}
+        </div>
+        <div class="grand-lower">
+          <span class="grand-lower-key">（小写）</span>
+          <template v-if="grandTotal">
+            ¥{{ grandTotal }}
+          </template>
+        </div>
+      </div>
+
+      <!-- 备注。框与竖排栏标是全家族共用的，栏内怎么排逐票不同（通用票是一段自由文本，
+           不动产系是「标签:值;」的内联流），故走 slot。 -->
+      <div class="remark">
+        <div class="side-label">
+          备 注
+        </div>
+        <div class="remark-body">
+          <slot name="remark" />
+        </div>
+      </div>
+    </div>
+
+    <footer
+      v-if="issuer"
+      class="foot"
+    >
+      <span class="foot-label">开票人：</span>{{ issuer }}
+    </footer>
+  </div>
+</template>
+
+<style scoped>
+.invoice{--invoice-ink:maroon;--invoice-data:#000;--invoice-font-song:"Songti SC",SimSun,STSong,"Source Han Serif SC","Noto Serif CJK SC","Noto Serif SC",serif;--invoice-font-kai:KaiTi,"Kaiti SC",STKaiti,"AR PL UKai CN","LXGW WenKai",var(--invoice-font-song);background:#fff;color:var(--invoice-data);container-type:inline-size;font-family:var(--invoice-font-song);font-size:clamp(9px,1.15cqw,14px);line-height:1.5;padding:1rem}.foot-label,.grand-label,.grand-lower-key,.items :deep(.total-label),.items :deep(th),.meta dt,.party-key,.side-label,.title{color:var(--invoice-ink);font-family:var(--invoice-font-kai)}.head{display:flex;justify-content:center;padding:1.8em 0 2em;position:relative}.business{left:0;position:absolute;top:50%;transform:translateY(-50%)}.title-block{display:flex;flex-direction:column}.title{font-size:2.6em;font-weight:400;letter-spacing:.1em;white-space:nowrap}.title-rule{border-bottom:1.5px solid var(--invoice-ink);border-top:1.5px solid var(--invoice-ink);height:.32em;margin-top:.45em}.meta{flex-direction:column;gap:.35em;position:absolute;right:0;top:50%;transform:translateY(-50%);white-space:nowrap}.meta,.meta div{display:flex}.meta dt{font-weight:400}.meta dd{letter-spacing:.02em;margin:0}.frame{border:1px solid var(--invoice-ink)}.parties{border-bottom:1px solid var(--invoice-ink);display:grid;grid-template-columns:1fr 1fr}.party{display:grid;grid-template-columns:auto 1fr}.party+.party{border-left:1px solid var(--invoice-ink)}.side-label{align-items:center;border-right:1px solid var(--invoice-ink);display:flex;justify-content:center;letter-spacing:.25em;padding:.5em .4em;text-orientation:upright;white-space:nowrap;writing-mode:vertical-rl}.party-body{flex-direction:column;justify-content:space-around;padding:.6em .8em}.party-body,.party-row{display:flex;min-width:0}.party-row{align-items:baseline}.party-key{white-space:nowrap}.party-value{min-width:0;word-break:break-all}.tax-id{font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,Courier New,monospace}.items{position:relative}.items table{border-collapse:collapse;table-layout:fixed;width:100%}.items-body,.items-foot,.items-head{position:relative;z-index:1}.items :deep(th){font-weight:400;letter-spacing:.05em;padding:.4em .5em;text-align:center}.items :deep(td){padding:.25em .5em;vertical-align:top}.items :deep(.cell-text){white-space:pre-wrap;word-break:break-all}.items :deep(.cell-center){text-align:center}.items :deep(.cell-num){font-variant-numeric:tabular-nums;text-align:right}.items :deep(.total-label){letter-spacing:.05em;text-align:center}.items :deep(tfoot td){padding-bottom:.35em;padding-top:.35em}.watermark{color:transparent;display:flex;font-size:3.4em;inset:0;justify-content:center;letter-spacing:.5em;pointer-events:none;position:absolute;z-index:0;-webkit-text-stroke:1px color-mix(in srgb,var(--invoice-ink) 40%,#fff);font-family:var(--invoice-font-kai);opacity:.85}.grand,.watermark{align-items:center}.grand{border-bottom:1px solid var(--invoice-ink);border-top:1px solid var(--invoice-ink);display:grid;grid-template-columns:22% 1fr auto}.grand-label{border-right:1px solid var(--invoice-ink);letter-spacing:.1em;padding:.5em 1.2em;text-align:center;white-space:nowrap}.grand-capital{min-width:0;padding:.5em .8em;word-break:break-all}.cross{margin-right:.3em}.grand-lower{font-variant-numeric:tabular-nums;padding:.5em 1.2em;white-space:nowrap}.grand-lower-key{margin-right:.4em}.remark{display:grid;grid-template-columns:auto 1fr;min-height:5em}.remark-body{padding:.5em .8em;white-space:pre-wrap;word-break:break-all}.foot{padding-left:3em;padding-top:.75em}
+</style>