@hmg-report-editor/template-converter 1.0.1

package/dist/converter.d.ts

@@ -0,0 +1,4 @@
+import type { CurrentReportTemplateVersion, TemplateConversionOptions, TemplateConversionResult } from './types.js';
+export declare const CURRENT_REPORT_TEMPLATE_VERSION: CurrentReportTemplateVersion;
+/** 将指定版本模板数据转换为当前报告模板格式。 */
+export declare function convertReportTemplate(data: unknown, sourceVersion: string, options?: TemplateConversionOptions): TemplateConversionResult;

package/dist/errors.d.ts

@@ -0,0 +1,8 @@
+import type { TemplateConversionErrorCode } from './types.js';
+/** 模板转换失败时抛出的结构化错误。 */
+export declare class TemplateConversionError extends Error {
+    readonly code: TemplateConversionErrorCode;
+    readonly detail?: unknown | undefined;
+    /** 创建包含错误码和原始明细的转换错误。 */
+    constructor(code: TemplateConversionErrorCode, message: string, detail?: unknown | undefined);
+}

package/dist/index.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const V=require("parse5");class d extends Error{constructor(t,i,r){super(i),this.code=t,this.detail=r,this.name="TemplateConversionError"}}const O=new Set(["article","aside","blockquote","dd","div","dl","dt","figcaption","figure","footer","h1","h2","h3","h4","h5","h6","header","li","main","nav","ol","section","table","tbody","td","tfoot","th","thead","tr","ul"]),$=new Set(["a","abbr","b","code","em","i","label","small","span","strong","sub","sup","u"]);function j(e,t){if(!Array.isArray(e))throw new d("INVALID_TEMPLATE_DATA","Legacy 1.0.0 template data must be an array of sections.",e);const i=e.map((r,n)=>G(r,n,t));return{version:t.targetVersion,sourceVersion:t.sourceVersion,sections:i,warnings:t.warnings}}function G(e,t,i){if(!te(e))throw new d("INVALID_TEMPLATE_DATA",`Legacy 1.0.0 section at index ${t} must be an object.`,e);const r=w(e.field,`section_${t+1}`),n=l(e.title),s=l(e.id),a=typeof e.value=="string"?e.value:"",u={sectionField:r,sectionIndex:t,templateId:i.templateId,controlIndex:0,warn:i.warn},c=a.trim()?B(a,u):[_()];return a.trim()||i.warn({code:"EMPTY_LEGACY_SECTION",message:`Legacy section has no HTML content: ${r}.`,sectionField:r}),{field:r,title:n,id:s,template:{version:i.targetVersion,title:n,content:c.length>0?c:[_()]}}}function B(e,t){const i=V.parseFragment(e);return R(i.childNodes,t)}function R(e,t){const i=[];let r=[];const n=()=>{r.length!==0&&(i.push(F(r,!1)),r=[])};for(const s of e)if(!(ie(s)&&r.length===0)){if(p(s)&&s.tagName.toLowerCase()==="p"){n(),i.push(H(s,t));continue}if(p(s)&&O.has(s.tagName.toLowerCase())){n(),i.push(...R(s.childNodes,t));continue}N(r,U(s,t,[]))}return n(),i}function H(e,t){const i=b(e.childNodes,t,[]);return F(i,!1)}function b(e,t,i){const r=[];for(let n=0;n<e.length;n+=1){const s=e[n],a=q(e,n,t,i);if(a){N(r,[a.node]),n=a.endIndex;continue}N(r,U(s,t,i))}return r}function U(e,t,i){if(L(e))return e.value?[C(e.value,i)]:[];if(!p(e))return t.warn({code:"UNSUPPORTED_HTML_NODE",message:`Unsupported legacy HTML node ignored: ${e.nodeName}.`,sectionField:t.sectionField,detail:{nodeName:e.nodeName}}),[];const r=e.tagName.toLowerCase();switch(r){case"input":return z(e,t);case"select":return k(e,t);case"img":return W(e,t);case"br":return[C(`
+`,i)];case"script":case"style":return t.warn({code:"UNSUPPORTED_HTML_TAG",message:`Unsupported legacy HTML tag ignored: <${r}>.`,sectionField:t.sectionField,detail:{tagName:r}}),[];default:return!$.has(r)&&!O.has(r)&&t.warn({code:"UNSUPPORTED_HTML_TAG",message:`Unsupported legacy HTML tag flattened: <${r}>.`,sectionField:t.sectionField,detail:{tagName:r}}),b(e.childNodes,t,X(e,i))}}function z(e,t){const i=(o(e,"type")??"text").toLowerCase();i!=="text"&&t.warn({code:"UNSUPPORTED_HTML_TAG",message:`Unsupported input type converted as text field: ${i}.`,sectionField:t.sectionField,detail:{type:i}});const r=g(e,t);return[{type:"structuredField",attrs:{...P(e,r,t,"input"),value:E(o(e,"value"),r==null?void 0:r.default,"")}}]}function k(e,t){const i=g(e,t),r=Q(i==null?void 0:i.options),n=K(e),s=r.options.length>0?r.options:n.options;return[{type:"dropdownField",attrs:{...P(e,i,t,"select"),value:E(n.selectedValue,r.defaultValue,i==null?void 0:i.default,""),options:s,allowCustomText:!1}}]}function W(e,t){const i=g(e,t);return v(e,i)?[]:(t.warn({code:"UNSUPPORTED_HTML_TAG",message:"Unsupported legacy image ignored.",sectionField:t.sectionField,detail:{src:o(e,"src")}}),[])}function q(e,t,i,r){const n=e[t];if(!p(n)||n.tagName.toLowerCase()!=="img")return;const s=g(n,i);if(!v(n,s))return;const a=J(e,t,s,i);if(a===-1){i.warn({code:"UNSUPPORTED_HTML_TAG",message:"Legacy visibility group marker has no matching closing marker.",sectionField:i.sectionField,detail:{serialId:s==null?void 0:s.serialId}});return}const u=b(e.slice(t+1,a),i,r);if(u.length===0){i.warn({code:"UNSUPPORTED_HTML_NODE",message:"Legacy visibility group marker range has no convertible content.",sectionField:i.sectionField,detail:{serialId:s==null?void 0:s.serialId}});return}return{endIndex:a,node:{type:"visibilityGroup",attrs:{condition:"all-controls-empty"},content:u}}}function J(e,t,i,r){const n=l(i==null?void 0:i.serialId);for(let s=t+1;s<e.length;s+=1){const a=e[s];if(!p(a)||a.tagName.toLowerCase()!=="img")continue;const u=g(a,r);if(!v(a,u))continue;const c=l(u==null?void 0:u.serialId);if(!n||!c||n===c)return s}return-1}function v(e,t){var n;if(e.tagName.toLowerCase()!=="img")return!1;const i=l(t==null?void 0:t.type),r=((n=l(o(e,"src")))==null?void 0:n.toLowerCase())??"";return i==="段落隐藏"||r.includes("tiny-left-icon")||r.includes("tiny-right-icon")}function P(e,t,i,r){const n=w(t==null?void 0:t.field,t==null?void 0:t.id,t==null?void 0:t.serialId,o(e,"id"),re(i,r)),s=w(t==null?void 0:t.label,t==null?void 0:t.title,o(e,"title"),n),a=l(o(e,"placeholder"),t==null?void 0:t.title,t==null?void 0:t.label),u=l(t==null?void 0:t.serialId),c=x(t==null?void 0:t.rule),A=l(t==null?void 0:t.nextItem);return{templateId:i.templateId,...u?{widgetNumber:u}:{},fieldId:n,fieldName:s,value:"",defaultValue:E(t==null?void 0:t.default,""),placeholder:a,required:y(t==null?void 0:t.isRequired),hideWhenEmpty:y(t==null?void 0:t.isNeedHide),noMatchDefault:y(t==null?void 0:t.noMatchDefault),...c.length>0?{rules:c}:{},...A?{nextWidgetNumber:A}:{}}}function x(e){return Array.isArray(e)?e.filter(t=>!!(t&&typeof t=="object")).map(t=>({title:l(t.title)??"规则",contents:Y(t.list)})):[]}function Y(e){return Array.isArray(e)?e.filter(t=>!!(t&&typeof t=="object")).filter(t=>!!(t.result&&typeof t.result=="object")).map(t=>({premises:Array.isArray(t.premiss)?t.premiss:[],result:t.result})):[]}function g(e,t){const i=o(e,"data-controlinfo");if(i)try{const r=JSON.parse(i.replace(/&quot;/g,'"'));return r&&typeof r=="object"?r:void 0}catch(r){t.warn({code:"CONTROL_INFO_PARSE_FAILED",message:"Legacy control info JSON parse failed.",sectionField:t.sectionField,detail:{raw:i,error:r}});return}}function K(e){const t=[];let i;for(const r of e.childNodes){if(!p(r)||r.tagName.toLowerCase()!=="option")continue;const n=M(r),s=o(r,"value")??n,a=o(r,"label")??n;t.push({value:s,label:a}),o(r,"selected")!==void 0&&i===void 0&&(i=s)}return{options:t,selectedValue:i}}function Q(e){if(!Array.isArray(e))return{options:[]};const t=[];let i;for(const r of e){if(r&&typeof r=="object"){const s=r,a=T(s.value??s.label??""),u=T(s.label??s.value??"");t.push({value:a,label:u}),i===void 0&&y(s.defaultFlag)&&(i=a);continue}const n=T(r);t.push({value:n,label:n})}return{options:t,defaultValue:i}}function X(e,t){const i=e.tagName.toLowerCase();let r=t;(i==="strong"||i==="b")&&(r=m(r,{type:"bold"})),(i==="em"||i==="i")&&(r=m(r,{type:"italic"})),i==="u"&&(r=m(r,{type:"underline"})),(i==="s"||i==="strike"||i==="del")&&(r=m(r,{type:"strike"}));const n=Z(o(e,"style"));return n&&(r=I(r,n)),r}function Z(e){if(!e)return;const t={};for(const i of e.split(";")){const[r,...n]=i.split(":"),s=r==null?void 0:r.trim().toLowerCase(),a=n.join(":").trim();!s||!a||(s==="font-family"?t.fontFamily=a:s==="font-size"?t.fontSize=a:s==="color"&&(t.color=a))}return Object.keys(t).length>0?t:void 0}function m(e,t){return e.some(i=>i.type===t.type)?e:[...e,t]}function I(e,t){return e.find(r=>r.type==="textStyle")?e.map(r=>r.type==="textStyle"?{...r,attrs:{...r.attrs??{},...t}}:r):[...e,{type:"textStyle",attrs:t}]}function N(e,t){for(const i of t){const r=e[e.length-1];S(r)&&S(i)&&ee(r.marks,i.marks)?r.text+=i.text:e.push(i)}}function S(e){return(e==null?void 0:e.type)==="text"&&typeof e.text=="string"}function ee(e,t){return JSON.stringify(e??[])===JSON.stringify(t??[])}function F(e,t){return{type:"paragraph",hidden:t,...e.length>0?{content:e}:{}}}function _(){return{type:"paragraph",hidden:!1,content:[]}}function C(e,t){return{type:"text",text:e,...t.length>0?{marks:t}:{}}}function te(e){return!!(e&&typeof e=="object")}function p(e){return"tagName"in e&&typeof e.tagName=="string"}function L(e){return e.nodeName==="#text"&&"value"in e}function ie(e){return L(e)&&/^\s*$/.test(e.value)}function o(e,t){const i=e.attrs.find(r=>r.name.toLowerCase()===t.toLowerCase());return i==null?void 0:i.value}function M(e){return L(e)?e.value:"childNodes"in e?e.childNodes.map(t=>M(t)).join(""):""}function re(e,t){return e.controlIndex+=1,`${e.sectionField}_${t}_${e.controlIndex}`}function w(...e){for(const t of e){const i=l(t);if(i)return i}return"field"}function l(...e){for(const t of e){if(t==null)continue;const i=String(t).trim();if(i)return i}}function E(...e){for(const t of e)if(t!==void 0)return ne(t);return""}function ne(e){return e===null||typeof e=="string"||typeof e=="number"||typeof e=="boolean"?e:String(e)}function T(e){return e==null?"":String(e)}function y(e){return typeof e=="boolean"?e:typeof e=="number"?e!==0:typeof e=="string"?["1","true","yes"].includes(e.trim().toLowerCase()):!1}const f="1.0.3";function se(e,t,i={}){const r=i.targetVersion??f;if(r!==f)throw new d("UNSUPPORTED_TARGET_VERSION",`Unsupported target template version: ${r}.`,{targetVersion:r});const n=ue(i);if(t==="1.0.0")return j(e,{targetVersion:r,sourceVersion:t,templateId:i.templateId??ae(),warn:n.warn,warnings:n.warnings});if(t===f)return oe(e,t,r,n.warnings);throw new d("UNSUPPORTED_TEMPLATE_VERSION",`Unsupported source template version: ${t}.`,{sourceVersion:t})}function ae(){const e=globalThis.crypto;return e!=null&&e.randomUUID?`template_${e.randomUUID()}`:`template_${Date.now().toString(36)}_${Math.random().toString(36).slice(2)}`}function ue(e){const t=[];return{warnings:t,warn(i){var r;t.push(i),(r=e.onWarning)==null||r.call(e,i)}}}function oe(e,t,i,r){if(D(e))return h(e.version),{version:i,sourceVersion:t,sections:[{field:"template",title:e.title,template:{...e,version:i}}],warnings:r};if(le(e)){h(e.version);for(const s of e.sections)h(s.template.version);const n=Array.isArray(e.warnings)?e.warnings.filter(ce):[];return{version:i,sourceVersion:t,sections:e.sections.map(s=>({...s,template:{...s.template,version:i}})),warnings:[...n,...r]}}throw new d("INVALID_TEMPLATE_DATA","Current template data must be a ReportTemplate or TemplateConversionResult.",e)}function h(e){if(e!==f)throw new d("UNSUPPORTED_TEMPLATE_VERSION",`Unsupported source template version: ${String(e??"")}.`,{sourceVersion:e})}function D(e){return!!(e&&typeof e=="object"&&"version"in e&&"content"in e&&Array.isArray(e.content))}function le(e){return!!(e&&typeof e=="object"&&"sections"in e&&Array.isArray(e.sections)&&e.sections.every(t=>!!(t&&typeof t=="object"&&"field"in t&&"template"in t&&D(t.template))))}function ce(e){return!!(e&&typeof e=="object"&&"code"in e&&typeof e.code=="string"&&"message"in e&&typeof e.message=="string")}exports.CURRENT_REPORT_TEMPLATE_VERSION=f;exports.TemplateConversionError=d;exports.convertReportTemplate=se;

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+/** 模板转换包公共出口，暴露转换入口、错误类型和转换相关类型。 */
+export { CURRENT_REPORT_TEMPLATE_VERSION, convertReportTemplate } from './converter.js';
+export { TemplateConversionError } from './errors.js';
+export type * from './types.js';

package/dist/index.js

@@ -0,0 +1,596 @@
+import { parseFragment as V } from "parse5";
+class d extends Error {
+  /** 创建包含错误码和原始明细的转换错误。 */
+  constructor(t, i, r) {
+    super(i), this.code = t, this.detail = r, this.name = "TemplateConversionError";
+  }
+}
+const O = /* @__PURE__ */ new Set([
+  "article",
+  "aside",
+  "blockquote",
+  "dd",
+  "div",
+  "dl",
+  "dt",
+  "figcaption",
+  "figure",
+  "footer",
+  "h1",
+  "h2",
+  "h3",
+  "h4",
+  "h5",
+  "h6",
+  "header",
+  "li",
+  "main",
+  "nav",
+  "ol",
+  "section",
+  "table",
+  "tbody",
+  "td",
+  "tfoot",
+  "th",
+  "thead",
+  "tr",
+  "ul"
+]), $ = /* @__PURE__ */ new Set([
+  "a",
+  "abbr",
+  "b",
+  "code",
+  "em",
+  "i",
+  "label",
+  "small",
+  "span",
+  "strong",
+  "sub",
+  "sup",
+  "u"
+]);
+function G(e, t) {
+  if (!Array.isArray(e))
+    throw new d(
+      "INVALID_TEMPLATE_DATA",
+      "Legacy 1.0.0 template data must be an array of sections.",
+      e
+    );
+  const i = e.map((r, n) => j(r, n, t));
+  return {
+    version: t.targetVersion,
+    sourceVersion: t.sourceVersion,
+    sections: i,
+    warnings: t.warnings
+  };
+}
+function j(e, t, i) {
+  if (!te(e))
+    throw new d(
+      "INVALID_TEMPLATE_DATA",
+      `Legacy 1.0.0 section at index ${t} must be an object.`,
+      e
+    );
+  const r = w(e.field, `section_${t + 1}`), n = l(e.title), s = l(e.id), a = typeof e.value == "string" ? e.value : "", u = {
+    sectionField: r,
+    sectionIndex: t,
+    templateId: i.templateId,
+    controlIndex: 0,
+    warn: i.warn
+  }, c = a.trim() ? B(a, u) : [_()];
+  return a.trim() || i.warn({
+    code: "EMPTY_LEGACY_SECTION",
+    message: `Legacy section has no HTML content: ${r}.`,
+    sectionField: r
+  }), {
+    field: r,
+    title: n,
+    id: s,
+    template: {
+      version: i.targetVersion,
+      title: n,
+      content: c.length > 0 ? c : [_()]
+    }
+  };
+}
+function B(e, t) {
+  const i = V(e);
+  return U(i.childNodes, t);
+}
+function U(e, t) {
+  const i = [];
+  let r = [];
+  const n = () => {
+    r.length !== 0 && (i.push(R(r, !1)), r = []);
+  };
+  for (const s of e)
+    if (!(ie(s) && r.length === 0)) {
+      if (p(s) && s.tagName.toLowerCase() === "p") {
+        n(), i.push(H(s, t));
+        continue;
+      }
+      if (p(s) && O.has(s.tagName.toLowerCase())) {
+        n(), i.push(...U(s.childNodes, t));
+        continue;
+      }
+      N(
+        r,
+        F(
+          s,
+          t,
+          []
+        )
+      );
+    }
+  return n(), i;
+}
+function H(e, t) {
+  const i = b(
+    e.childNodes,
+    t,
+    []
+  );
+  return R(i, !1);
+}
+function b(e, t, i) {
+  const r = [];
+  for (let n = 0; n < e.length; n += 1) {
+    const s = e[n], a = q(e, n, t, i);
+    if (a) {
+      N(r, [a.node]), n = a.endIndex;
+      continue;
+    }
+    N(r, F(s, t, i));
+  }
+  return r;
+}
+function F(e, t, i) {
+  if (v(e))
+    return e.value ? [C(e.value, i)] : [];
+  if (!p(e))
+    return t.warn({
+      code: "UNSUPPORTED_HTML_NODE",
+      message: `Unsupported legacy HTML node ignored: ${e.nodeName}.`,
+      sectionField: t.sectionField,
+      detail: { nodeName: e.nodeName }
+    }), [];
+  const r = e.tagName.toLowerCase();
+  switch (r) {
+    case "input":
+      return z(e, t);
+    case "select":
+      return k(e, t);
+    case "img":
+      return W(e, t);
+    case "br":
+      return [C(`
+`, i)];
+    case "script":
+    case "style":
+      return t.warn({
+        code: "UNSUPPORTED_HTML_TAG",
+        message: `Unsupported legacy HTML tag ignored: <${r}>.`,
+        sectionField: t.sectionField,
+        detail: { tagName: r }
+      }), [];
+    default:
+      return !$.has(r) && !O.has(r) && t.warn({
+        code: "UNSUPPORTED_HTML_TAG",
+        message: `Unsupported legacy HTML tag flattened: <${r}>.`,
+        sectionField: t.sectionField,
+        detail: { tagName: r }
+      }), b(e.childNodes, t, X(e, i));
+  }
+}
+function z(e, t) {
+  const i = (o(e, "type") ?? "text").toLowerCase();
+  i !== "text" && t.warn({
+    code: "UNSUPPORTED_HTML_TAG",
+    message: `Unsupported input type converted as text field: ${i}.`,
+    sectionField: t.sectionField,
+    detail: { type: i }
+  });
+  const r = f(e, t);
+  return [
+    {
+      type: "structuredField",
+      attrs: {
+        ...P(e, r, t, "input"),
+        value: A(o(e, "value"), r == null ? void 0 : r.default, "")
+      }
+    }
+  ];
+}
+function k(e, t) {
+  const i = f(e, t), r = Q(i == null ? void 0 : i.options), n = K(e), s = r.options.length > 0 ? r.options : n.options;
+  return [
+    {
+      type: "dropdownField",
+      attrs: {
+        ...P(e, i, t, "select"),
+        value: A(n.selectedValue, r.defaultValue, i == null ? void 0 : i.default, ""),
+        options: s,
+        allowCustomText: !1
+      }
+    }
+  ];
+}
+function W(e, t) {
+  const i = f(e, t);
+  return L(e, i) ? [] : (t.warn({
+    code: "UNSUPPORTED_HTML_TAG",
+    message: "Unsupported legacy image ignored.",
+    sectionField: t.sectionField,
+    detail: {
+      src: o(e, "src")
+    }
+  }), []);
+}
+function q(e, t, i, r) {
+  const n = e[t];
+  if (!p(n) || n.tagName.toLowerCase() !== "img")
+    return;
+  const s = f(n, i);
+  if (!L(n, s))
+    return;
+  const a = J(e, t, s, i);
+  if (a === -1) {
+    i.warn({
+      code: "UNSUPPORTED_HTML_TAG",
+      message: "Legacy visibility group marker has no matching closing marker.",
+      sectionField: i.sectionField,
+      detail: { serialId: s == null ? void 0 : s.serialId }
+    });
+    return;
+  }
+  const u = b(e.slice(t + 1, a), i, r);
+  if (u.length === 0) {
+    i.warn({
+      code: "UNSUPPORTED_HTML_NODE",
+      message: "Legacy visibility group marker range has no convertible content.",
+      sectionField: i.sectionField,
+      detail: { serialId: s == null ? void 0 : s.serialId }
+    });
+    return;
+  }
+  return {
+    endIndex: a,
+    node: {
+      type: "visibilityGroup",
+      attrs: {
+        condition: "all-controls-empty"
+      },
+      content: u
+    }
+  };
+}
+function J(e, t, i, r) {
+  const n = l(i == null ? void 0 : i.serialId);
+  for (let s = t + 1; s < e.length; s += 1) {
+    const a = e[s];
+    if (!p(a) || a.tagName.toLowerCase() !== "img")
+      continue;
+    const u = f(a, r);
+    if (!L(a, u))
+      continue;
+    const c = l(u == null ? void 0 : u.serialId);
+    if (!n || !c || n === c)
+      return s;
+  }
+  return -1;
+}
+function L(e, t) {
+  var n;
+  if (e.tagName.toLowerCase() !== "img")
+    return !1;
+  const i = l(t == null ? void 0 : t.type), r = ((n = l(o(e, "src"))) == null ? void 0 : n.toLowerCase()) ?? "";
+  return i === "段落隐藏" || r.includes("tiny-left-icon") || r.includes("tiny-right-icon");
+}
+function P(e, t, i, r) {
+  const n = w(
+    t == null ? void 0 : t.field,
+    t == null ? void 0 : t.id,
+    t == null ? void 0 : t.serialId,
+    o(e, "id"),
+    re(i, r)
+  ), s = w(
+    t == null ? void 0 : t.label,
+    t == null ? void 0 : t.title,
+    o(e, "title"),
+    n
+  ), a = l(o(e, "placeholder"), t == null ? void 0 : t.title, t == null ? void 0 : t.label), u = l(t == null ? void 0 : t.serialId), c = x(t == null ? void 0 : t.rule), E = l(t == null ? void 0 : t.nextItem);
+  return {
+    templateId: i.templateId,
+    ...u ? { widgetNumber: u } : {},
+    fieldId: n,
+    fieldName: s,
+    value: "",
+    defaultValue: A(t == null ? void 0 : t.default, ""),
+    placeholder: a,
+    required: m(t == null ? void 0 : t.isRequired),
+    hideWhenEmpty: m(t == null ? void 0 : t.isNeedHide),
+    noMatchDefault: m(t == null ? void 0 : t.noMatchDefault),
+    ...c.length > 0 ? { rules: c } : {},
+    ...E ? { nextWidgetNumber: E } : {}
+  };
+}
+function x(e) {
+  return Array.isArray(e) ? e.filter((t) => !!(t && typeof t == "object")).map((t) => ({
+    title: l(t.title) ?? "规则",
+    contents: Y(t.list)
+  })) : [];
+}
+function Y(e) {
+  return Array.isArray(e) ? e.filter((t) => !!(t && typeof t == "object")).filter((t) => !!(t.result && typeof t.result == "object")).map((t) => ({
+    premises: Array.isArray(t.premiss) ? t.premiss : [],
+    result: t.result
+  })) : [];
+}
+function f(e, t) {
+  const i = o(e, "data-controlinfo");
+  if (i)
+    try {
+      const r = JSON.parse(i.replace(/&quot;/g, '"'));
+      return r && typeof r == "object" ? r : void 0;
+    } catch (r) {
+      t.warn({
+        code: "CONTROL_INFO_PARSE_FAILED",
+        message: "Legacy control info JSON parse failed.",
+        sectionField: t.sectionField,
+        detail: { raw: i, error: r }
+      });
+      return;
+    }
+}
+function K(e) {
+  const t = [];
+  let i;
+  for (const r of e.childNodes) {
+    if (!p(r) || r.tagName.toLowerCase() !== "option")
+      continue;
+    const n = D(r), s = o(r, "value") ?? n, a = o(r, "label") ?? n;
+    t.push({ value: s, label: a }), o(r, "selected") !== void 0 && i === void 0 && (i = s);
+  }
+  return { options: t, selectedValue: i };
+}
+function Q(e) {
+  if (!Array.isArray(e))
+    return { options: [] };
+  const t = [];
+  let i;
+  for (const r of e) {
+    if (r && typeof r == "object") {
+      const s = r, a = h(s.value ?? s.label ?? ""), u = h(s.label ?? s.value ?? "");
+      t.push({ value: a, label: u }), i === void 0 && m(s.defaultFlag) && (i = a);
+      continue;
+    }
+    const n = h(r);
+    t.push({ value: n, label: n });
+  }
+  return { options: t, defaultValue: i };
+}
+function X(e, t) {
+  const i = e.tagName.toLowerCase();
+  let r = t;
+  (i === "strong" || i === "b") && (r = g(r, { type: "bold" })), (i === "em" || i === "i") && (r = g(r, { type: "italic" })), i === "u" && (r = g(r, { type: "underline" })), (i === "s" || i === "strike" || i === "del") && (r = g(r, { type: "strike" }));
+  const n = Z(o(e, "style"));
+  return n && (r = I(r, n)), r;
+}
+function Z(e) {
+  if (!e)
+    return;
+  const t = {};
+  for (const i of e.split(";")) {
+    const [r, ...n] = i.split(":"), s = r == null ? void 0 : r.trim().toLowerCase(), a = n.join(":").trim();
+    !s || !a || (s === "font-family" ? t.fontFamily = a : s === "font-size" ? t.fontSize = a : s === "color" && (t.color = a));
+  }
+  return Object.keys(t).length > 0 ? t : void 0;
+}
+function g(e, t) {
+  return e.some((i) => i.type === t.type) ? e : [...e, t];
+}
+function I(e, t) {
+  return e.find((r) => r.type === "textStyle") ? e.map(
+    (r) => r.type === "textStyle" ? {
+      ...r,
+      attrs: {
+        ...r.attrs ?? {},
+        ...t
+      }
+    } : r
+  ) : [...e, { type: "textStyle", attrs: t }];
+}
+function N(e, t) {
+  for (const i of t) {
+    const r = e[e.length - 1];
+    S(r) && S(i) && ee(r.marks, i.marks) ? r.text += i.text : e.push(i);
+  }
+}
+function S(e) {
+  return (e == null ? void 0 : e.type) === "text" && typeof e.text == "string";
+}
+function ee(e, t) {
+  return JSON.stringify(e ?? []) === JSON.stringify(t ?? []);
+}
+function R(e, t) {
+  return {
+    type: "paragraph",
+    hidden: t,
+    ...e.length > 0 ? { content: e } : {}
+  };
+}
+function _() {
+  return {
+    type: "paragraph",
+    hidden: !1,
+    content: []
+  };
+}
+function C(e, t) {
+  return {
+    type: "text",
+    text: e,
+    ...t.length > 0 ? { marks: t } : {}
+  };
+}
+function te(e) {
+  return !!(e && typeof e == "object");
+}
+function p(e) {
+  return "tagName" in e && typeof e.tagName == "string";
+}
+function v(e) {
+  return e.nodeName === "#text" && "value" in e;
+}
+function ie(e) {
+  return v(e) && /^\s*$/.test(e.value);
+}
+function o(e, t) {
+  const i = e.attrs.find((r) => r.name.toLowerCase() === t.toLowerCase());
+  return i == null ? void 0 : i.value;
+}
+function D(e) {
+  return v(e) ? e.value : "childNodes" in e ? e.childNodes.map((t) => D(t)).join("") : "";
+}
+function re(e, t) {
+  return e.controlIndex += 1, `${e.sectionField}_${t}_${e.controlIndex}`;
+}
+function w(...e) {
+  for (const t of e) {
+    const i = l(t);
+    if (i)
+      return i;
+  }
+  return "field";
+}
+function l(...e) {
+  for (const t of e) {
+    if (t == null)
+      continue;
+    const i = String(t).trim();
+    if (i)
+      return i;
+  }
+}
+function A(...e) {
+  for (const t of e)
+    if (t !== void 0)
+      return ne(t);
+  return "";
+}
+function ne(e) {
+  return e === null || typeof e == "string" || typeof e == "number" || typeof e == "boolean" ? e : String(e);
+}
+function h(e) {
+  return e == null ? "" : String(e);
+}
+function m(e) {
+  return typeof e == "boolean" ? e : typeof e == "number" ? e !== 0 : typeof e == "string" ? ["1", "true", "yes"].includes(e.trim().toLowerCase()) : !1;
+}
+const y = "1.0.3";
+function de(e, t, i = {}) {
+  const r = i.targetVersion ?? y;
+  if (r !== y)
+    throw new d(
+      "UNSUPPORTED_TARGET_VERSION",
+      `Unsupported target template version: ${r}.`,
+      { targetVersion: r }
+    );
+  const n = ae(i);
+  if (t === "1.0.0")
+    return G(e, {
+      targetVersion: r,
+      sourceVersion: t,
+      templateId: i.templateId ?? se(),
+      warn: n.warn,
+      warnings: n.warnings
+    });
+  if (t === y)
+    return ue(e, t, r, n.warnings);
+  throw new d(
+    "UNSUPPORTED_TEMPLATE_VERSION",
+    `Unsupported source template version: ${t}.`,
+    { sourceVersion: t }
+  );
+}
+function se() {
+  const e = globalThis.crypto;
+  return e != null && e.randomUUID ? `template_${e.randomUUID()}` : `template_${Date.now().toString(36)}_${Math.random().toString(36).slice(2)}`;
+}
+function ae(e) {
+  const t = [];
+  return {
+    warnings: t,
+    warn(i) {
+      var r;
+      t.push(i), (r = e.onWarning) == null || r.call(e, i);
+    }
+  };
+}
+function ue(e, t, i, r) {
+  if (M(e))
+    return T(e.version), {
+      version: i,
+      sourceVersion: t,
+      sections: [
+        {
+          field: "template",
+          title: e.title,
+          template: {
+            ...e,
+            version: i
+          }
+        }
+      ],
+      warnings: r
+    };
+  if (oe(e)) {
+    T(e.version);
+    for (const s of e.sections)
+      T(s.template.version);
+    const n = Array.isArray(e.warnings) ? e.warnings.filter(le) : [];
+    return {
+      version: i,
+      sourceVersion: t,
+      sections: e.sections.map((s) => ({
+        ...s,
+        template: {
+          ...s.template,
+          version: i
+        }
+      })),
+      warnings: [...n, ...r]
+    };
+  }
+  throw new d(
+    "INVALID_TEMPLATE_DATA",
+    "Current template data must be a ReportTemplate or TemplateConversionResult.",
+    e
+  );
+}
+function T(e) {
+  if (e !== y)
+    throw new d(
+      "UNSUPPORTED_TEMPLATE_VERSION",
+      `Unsupported source template version: ${String(e ?? "")}.`,
+      { sourceVersion: e }
+    );
+}
+function M(e) {
+  return !!(e && typeof e == "object" && "version" in e && "content" in e && Array.isArray(e.content));
+}
+function oe(e) {
+  return !!(e && typeof e == "object" && "sections" in e && Array.isArray(e.sections) && e.sections.every(
+    (t) => !!(t && typeof t == "object" && "field" in t && "template" in t && M(t.template))
+  ));
+}
+function le(e) {
+  return !!(e && typeof e == "object" && "code" in e && typeof e.code == "string" && "message" in e && typeof e.message == "string");
+}
+export {
+  y as CURRENT_REPORT_TEMPLATE_VERSION,
+  d as TemplateConversionError,
+  de as convertReportTemplate
+};

package/dist/legacyV100.d.ts

@@ -0,0 +1,11 @@
+import type { CurrentReportTemplateVersion, TemplateConversionResult, TemplateConversionWarning } from './types.js';
+type LegacyConversionContext = {
+    sourceVersion: string;
+    targetVersion: CurrentReportTemplateVersion;
+    templateId: string;
+    warnings: TemplateConversionWarning[];
+    warn: (warning: TemplateConversionWarning) => void;
+};
+/** 转换 v1.0.0 历史模板数组为当前分段模板结果。 */
+export declare function convertLegacyTemplateV100(data: unknown, context: LegacyConversionContext): TemplateConversionResult;
+export {};

package/dist/types.d.ts

@@ -0,0 +1,42 @@
+/** 模板转换包共享类型，描述版本、错误、警告和转换结果。 */
+import type { ReportTemplate } from '@hmg-report-editor/core';
+/** 当前可输出的报告模板版本。 */
+export type CurrentReportTemplateVersion = '1.0.3';
+/** 模板转换错误码。 */
+export type TemplateConversionErrorCode = 'INVALID_TEMPLATE_DATA' | 'UNSUPPORTED_TARGET_VERSION' | 'UNSUPPORTED_TEMPLATE_VERSION';
+/** 模板转换警告码。 */
+export type TemplateConversionWarningCode = 'CONTROL_INFO_PARSE_FAILED' | 'EMPTY_LEGACY_SECTION' | 'UNSUPPORTED_HTML_NODE' | 'UNSUPPORTED_HTML_TAG';
+/** 模板转换过程中的非阻断警告。 */
+export type TemplateConversionWarning = {
+    code: TemplateConversionWarningCode;
+    message: string;
+    sectionField?: string;
+    detail?: unknown;
+};
+/** 模板转换选项。 */
+export type TemplateConversionOptions = {
+    targetVersion?: CurrentReportTemplateVersion;
+    templateId?: string;
+    onWarning?: (warning: TemplateConversionWarning) => void;
+};
+/** 转换结果中的单个报告片段。 */
+export type ConvertedTemplateSection = {
+    field: string;
+    title?: string;
+    id?: string;
+    template: ReportTemplate;
+};
+/** 模板转换的完整结果。 */
+export type TemplateConversionResult = {
+    version: CurrentReportTemplateVersion;
+    sourceVersion: string;
+    sections: ConvertedTemplateSection[];
+    warnings: TemplateConversionWarning[];
+};
+/** v1.0.0 历史模板中的原始分段。 */
+export type LegacyTemplateSectionV100 = {
+    field?: unknown;
+    title?: unknown;
+    value?: unknown;
+    id?: unknown;
+} & Record<string, unknown>;

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@hmg-report-editor/template-converter",
+  "version": "1.0.1",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "scripts": {
+    "build": "vite build && tsc -p tsconfig.build.json && node ../../scripts/finalize-package-types.mjs .",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "@hmg-report-editor/core": "^1.0.1",
+    "parse5": "^7.3.0"
+  }
+}