@para-ui/core 5.0.0-beta.11 → 5.0.0-beta.13

package/lib/DatePicker/component.json

@@ -0,0 +1,192 @@
+{
+    "name": "DatePicker",
+    "category": "Data Entry",
+    "description": "输入或选择日期的控件",
+    "semantic": {
+        "intent": [
+            "选择日期",
+            "选择时间",
+            "选择日期范围"
+        ],
+        "useCases": [
+            "表单日期录入",
+            "日程安排",
+            "数据报表时间筛选"
+        ],
+        "riskLevel": "normal"
+    },
+    "variants": {
+        "date": {
+            "meaning": "日期选择"
+        },
+        "range": {
+            "meaning": "日期范围选择"
+        },
+        "time": {
+            "meaning": "时间选择"
+        }
+    },
+    "states": [
+        "default",
+        "disabled",
+        "error",
+        "open"
+    ],
+    "idealProps": {
+        "value": {
+            "type": "Dayjs | null（DatePicker）/ [Dayjs, Dayjs] | null（RangePicker）",
+            "description": "当前选中的日期。**受控模式必传**——传入 null 表示未选中（清空状态）；与 onChange 配套使用。注意：RangePicker 的 value 才是 dayjs[]，DatePicker 不要传数组",
+            "_typeNote": "原'dayjs | dayjs[]'写法误导——分别属于 DatePicker / RangePicker，不是同一组件的联合类型"
+        },
+        "onChange": {
+            "type": "function",
+            "signature": "(date: Dayjs | null, dateString: string) => void",
+            "description": "日期变化回调。date=null 时表示清空（当 allowClear=true 用户点叉触发）；dateString 是按 format 格式化后的字符串，清空时为空串"
+        },
+        "picker": {
+            "type": "enum",
+            "values": [
+                "date",
+                "week",
+                "month",
+                "quarter",
+                "year"
+            ],
+            "default": "date",
+            "description": "选择器类型"
+        },
+        "showTime": {
+            "type": "boolean | object",
+            "objectShape": {
+                "format": { "type": "string", "description": "时间格式，例：'HH:mm:ss'" },
+                "defaultValue": { "type": "Dayjs", "description": "时间默认值" },
+                "disabledTime": { "type": "function", "description": "禁用时间回调" }
+            },
+            "default": false,
+            "description": "是否增加时间选择功能。传 true 使用默认时间选项；传对象可配置时间选择器参数（format/defaultValue/disabledTime 等）"
+        },
+        "format": {
+            "type": "string | string[]",
+            "default": "YYYY-MM-DD",
+            "description": "展示的日期格式"
+        },
+        "disabled": {
+            "type": "boolean",
+            "default": false,
+            "description": "是否禁用"
+        },
+        "allowClear": {
+            "type": "boolean",
+            "default": true,
+            "description": "是否显示清除按钮"
+        },
+        "bordered": {
+            "type": "boolean",
+            "default": true,
+            "description": "是否有边框"
+        },
+        "placeholder": {
+            "type": "string（DatePicker） | [string, string]（RangePicker，开始日期 + 结束日期 placeholder）",
+            "description": "输入框提示文字。DatePicker 接受 string；RangePicker 接受 [string, string] 元组（首/末 placeholder 分别）"
+        },
+        "disabledDate": {
+            "type": "function",
+            "signature": "(currentDate: Dayjs) => boolean",
+            "description": "不可选择的日期。返回 true 表示该日期不可选。currentDate 在 picker='date' 时为当天 00:00:00（无时分秒），可直接 `current < dayjs().endOf('day')` 比较；在 showTime 模式下含完整时分秒，此时若做日维度比较应用 `dayjs().startOf('day')` / `endOf('day')` 兜底"
+        },
+        "defaultValue": {
+            "type": "Dayjs",
+            "required": false,
+            "description": "默认日期（非受控）。初始渲染时的默认选中日期；⚠️ 不要同时传 value + defaultValue，受控模式只传 value + onChange，非受控模式只传 defaultValue"
+        },
+        "onOpenChange": {
+            "type": "function",
+            "signature": "(open: boolean) => void",
+            "required": false,
+            "description": "弹出日历/关闭日历时的回调，open=true 表示打开，open=false 表示关闭"
+        },
+        "open": {
+            "type": "boolean",
+            "required": false,
+            "description": "控制弹层是否展开（受控），配合 onOpenChange 使用"
+        },
+        "showToday": {
+            "type": "boolean",
+            "default": "true",
+            "required": false,
+            "description": "是否展示「今天」快捷按钮，picker='date' 时有效"
+        },
+        "showNow": {
+            "type": "boolean",
+            "required": false,
+            "description": "showTime=true 时是否展示「此刻」按钮"
+        }
+    },
+    "do": [
+        "使用 format 属性统一日期显示格式",
+        "对于需要选择范围的场景，使用 DatePicker.RangePicker（从同一导入中解构：`const { RangePicker } = DatePicker`）",
+        "受控模式只传 value + onChange，非受控模式只传 defaultValue——不要同时传两者",
+        "showTime=true 时，value 必须是含时分秒的 Dayjs 对象；onChange 接收的 date 参数也会含完整时间信息",
+        "禁用日期用 disabledDate 回调（返回 true 表示不可选）；禁止今天之前：`disabledDate={(cur) => cur && cur < dayjs().startOf('day')}`"
+    ],
+    "dont": [
+        "混用 moment 和 dayjs 对象（本项目统一使用 dayjs，value/defaultValue/disabledDate 参数都是 Dayjs 类型）",
+        "在移动端过度依赖复杂的弹出面板",
+        "不要对 DatePicker 传 value 数组——RangePicker.value 才是 [Dayjs, Dayjs]，DatePicker.value 是单个 Dayjs | null"
+    ],
+    "events": {
+        "onChange": {
+            "signature": "(date: Dayjs | null, dateString: string) => void",
+            "asyncSupported": false,
+            "examples": [
+                "日期选中时触发：date 为 Dayjs 对象，dateString 为 format 格式化后的字符串",
+                "用户点清空按钮时触发：date=null，dateString=''——需判断 null 再处理",
+                "showTime=true 模式下，date 包含完整时分秒（Dayjs），dateString 按 format 含时间部分"
+            ],
+            "commonMistakes": [
+                "只用 dateString 而忽略 date 参数——dateString 是 format 格式化结果，跨时区场景需用 date（Dayjs 对象）再转换",
+                "不处理 date=null 的清空场景——allowClear=true 时 user 点叉会触发 onChange(null, '')，此时直接存 date 会把 null 存入 state",
+                "RangePicker 的 onChange 签名不同——`(dates: [Dayjs, Dayjs] | null, dateStrings: [string, string]) => void`，不要用 DatePicker 的签名",
+                "假设 onChange 仅在确认时触发——date picker 模式（无 showTime）选日期即触发；showTime 模式需点「确定」按钮才触发"
+            ]
+        },
+        "onOpenChange": {
+            "signature": "(open: boolean) => void",
+            "asyncSupported": false,
+            "examples": [
+                "弹层打开时触发 onOpenChange(true)，关闭时触发 onOpenChange(false)",
+                "搭配 open 受控 prop 实现自定义开关逻辑（如点击外部关闭）"
+            ],
+            "commonMistakes": [
+                "在 onOpenChange 中直接做表单提交——open=false 仅表示面板关闭，value 不一定已更新",
+                "忘记 RangePicker 关闭时 src 代码会主动调 blur（generateRangePicker.tsx 实证）——不需要手动调"
+            ]
+        }
+    },
+    "typescriptPitfalls": [
+        {
+            "issue": "DatePicker value 类型应为 Dayjs | null，传字符串会导致显示异常",
+            "wrong": "value={'2024-01-01'}  // 字符串不是 Dayjs 对象，组件内部格式化会失败",
+            "right": "value={dayjs('2024-01-01')}  // 必须用 dayjs() 转换；清空用 null"
+        },
+        {
+            "issue": "RangePicker 和 DatePicker 的 onChange 签名不同，混用会导致类型错误",
+            "wrong": "// RangePicker 中用 DatePicker 的 onChange 签名\nonChange={(date: Dayjs, str: string) => ...}  // 应为数组",
+            "right": "// RangePicker\nonChange={(dates: [Dayjs, Dayjs] | null, strs: [string, string]) => ...}"
+        },
+        {
+            "issue": "RangePicker value 是 RangeValue<Dayjs> 类型（可 null 的二元元组），不能传普通数组",
+            "wrong": "value={[dayjs(), dayjs().add(7, 'day')]}  // 推断为 Dayjs[]，不匹配 RangeValue<Dayjs>",
+            "right": "import type { RangeValue } from '@para-ui/core'; const val: RangeValue<Dayjs> = [dayjs(), dayjs().add(7,'day')]; <DatePicker.RangePicker value={val} />"
+        },
+        {
+            "issue": "disabledDate 参数是 Dayjs 对象不是 Date，直接用 Date 方法会报类型错误",
+            "wrong": "disabledDate={(cur) => cur.getTime() < Date.now()}  // Dayjs 没有 getTime() 方法",
+            "right": "disabledDate={(cur) => cur && cur.isBefore(dayjs().startOf('day'))}  // 使用 Dayjs 的 isBefore / isAfter"
+        }
+    ],
+    "mapping": {
+        "realComponent": "DatePicker",
+        "adapter": null
+    }
+}

package/lib/DatePicker/generatePicker/generateRangePicker.js

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const r=require("../../_virtual/jsx-runtime.js"),o=require("react"),x=require("clsx"),ee=require("../../node_modules/@para-ui/icons/CloseCircleF/index.js"),re=require("../../node_modules/@para-ui/icons/SortRight/index.js"),te=require("../../node_modules/@para-ui/icons/Calendar/index.js"),se=require("../../node_modules/@para-ui/icons/Time/index.js"),ne=require("rc-picker"),s=require("../util.js"),T=require("./index.js"),w=require("../lang/index.js"),oe=require("../../GlobalContext/index.js"),ae=require("../../Label/index.js"),le=require("../../HelperText/index.js"),y=require("../../GlobalContext/constant.js"),ie=require("@paraview/lib"),I=require("../PickerTag.js"),ue=require("../../Tooltip/index.js");function ce(z){return o.forwardRef((i,L)=>{const{className:O,size:xe,bordered:_=!0,placeholder:H,error:u=!1,helperText:M,style:S,value:V,defaultValue:F,label:d="",labelTooltip:A,required:f=!1,shortcuts:m,presets:j,ranges:de,shortcutsPlacement:R="left",getPopupContainer:D,isolationPopupOnHide:U=!1,disabled:g,disabledTooltip:P,...c}=i,{format:p,showTime:h,picker:n,use12Hours:B}=i,l=o.useRef(null),$=o.useRef(),b=o.useMemo(()=>ie.UUID(),[]),t=`${y.$prefixCls}-picker`,{language:C,locale:q}=o.useContext(oe.default);let E={};if(q){const e=q[C||"zh"];e&&(E=e.DatePicker)}const G=w.default[C||"zh"]||w.default.zh,v=s.mergedLocale(E,G);let a={};a={...a,...h?s.getTimeProps({format:p,picker:n,...h}):{},...n==="time"?s.getTimeProps({format:p,...i,picker:n}):{}},a.style&&delete a.style;const k=e=>{if(!Array.isArray(e))return e;const Y=p??T.pickerFormatMap[n];return e.map(Z=>s.formatPickerValue(Z,Y))},J=()=>d||f?r.jsxRuntimeExports.jsx(ae.default,{label:d,required:f,...A}):null;o.useImperativeHandle(L,()=>({focus:()=>l.current?.focus(),blur:()=>l.current?.blur()}));const N=j?j.map(e=>({label:typeof e.label=="string"?r.jsxRuntimeExports.jsx(I.default,{children:e.label}):e.label,value:e.value})):m?m.map(e=>({label:typeof e.text=="string"?r.jsxRuntimeExports.jsx(I.default,{children:e.text}):e.text,value:typeof e.value=="function"?e.value():e.value})):[],K=!!N?.length,Q=x(b,c.dropdownClassName,`${y.$prefixCls}-scrollbar-small`,{[`${t}-use12Hours`]:B,[`${t}-presets-${R}`]:K}),W=e=>s.getPopupContainer(e,D,$),X=e=>{c.onOpenChange?.(e),U&&s.isolationPopupPollution(e,b),e||l.current?.blur()};return(()=>{const e=r.jsxRuntimeExports.jsxs("div",{ref:$,className:x(`${t}-wrapper`,O),style:S,children:[J(),r.jsxRuntimeExports.jsx(ne.RangePicker,{separator:r.jsxRuntimeExports.jsx("span",{"aria-label":"to",className:`${t}-separator`,children:r.jsxRuntimeExports.jsx(re.SortRight,{})}),ref:l,placeholder:s.getRangePlaceholder(n,v,H),suffixIcon:n==="time"?r.jsxRuntimeExports.jsx(se.Time,{}):r.jsxRuntimeExports.jsx(te.Calendar,{className:"picker-icon"}),clearIcon:r.jsxRuntimeExports.jsx(ee.CloseCircleF,{}),allowClear:!0,disabled:g,...c,...a,defaultValue:k(F),value:k(V),presets:N,className:x({[`${t}-borderless`]:!_,[`${t}-error`]:u,[`${t}-shortcuts-${R}`]:u}),locale:v.lang,prefixCls:t,generateConfig:z,prevIcon:r.jsxRuntimeExports.jsx("span",{className:`${t}-prev-icon`}),nextIcon:r.jsxRuntimeExports.jsx("span",{className:`${t}-next-icon`}),superPrevIcon:r.jsxRuntimeExports.jsx("span",{className:`${t}-super-prev-icon`}),superNextIcon:r.jsxRuntimeExports.jsx("span",{className:`${t}-super-next-icon`}),components:T.Components,direction:"ltr",dropdownClassName:Q,getPopupContainer:W,onOpenChange:X}),r.jsxRuntimeExports.jsx(le.default,{error:u,helperText:M})]});return g&&P?r.jsxRuntimeExports.jsx(ue.Tooltip,{disabled:!0,...P,children:e}):e})()})}exports.default=ce;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const r=require("../../_virtual/jsx-runtime.js"),o=require("react"),x=require("clsx"),ee=require("../../node_modules/@para-ui/icons/CloseCircleF/index.js"),re=require("../../node_modules/@para-ui/icons/SortRight/index.js"),te=require("../../node_modules/@para-ui/icons/Calendar/index.js"),se=require("../../node_modules/@para-ui/icons/Time/index.js"),ne=require("rc-picker"),s=require("../util.js"),T=require("./index.js"),w=require("../lang/index.js"),oe=require("../../GlobalContext/index.js"),le=require("../../Label/index.js"),ae=require("../../HelperText/index.js"),y=require("../../GlobalContext/constant.js"),ie=require("@snack-kit/lib"),I=require("../PickerTag.js"),ue=require("../../Tooltip/index.js");function ce(z){return o.forwardRef((i,L)=>{const{className:O,size:xe,bordered:_=!0,placeholder:H,error:u=!1,helperText:M,style:S,value:V,defaultValue:F,label:d="",labelTooltip:A,required:f=!1,shortcuts:m,presets:j,ranges:de,shortcutsPlacement:R="left",getPopupContainer:D,isolationPopupOnHide:U=!1,disabled:g,disabledTooltip:P,...c}=i,{format:p,showTime:h,picker:n,use12Hours:B}=i,a=o.useRef(null),b=o.useRef(null),C=o.useMemo(()=>ie.UUID(),[]),t=`${y.$prefixCls}-picker`,{language:$,locale:q}=o.useContext(oe.default);let E={};if(q){const e=q[$||"zh"];e&&(E=e.DatePicker)}const G=w.default[$||"zh"]||w.default.zh,v=s.mergedLocale(E,G);let l={};l={...l,...h?s.getTimeProps({format:p,picker:n,...h}):{},...n==="time"?s.getTimeProps({format:p,...i,picker:n}):{}},l.style&&delete l.style;const k=e=>{if(!Array.isArray(e))return e;const Y=p??T.pickerFormatMap[n];return e.map(Z=>s.formatPickerValue(Z,Y))},J=()=>d||f?r.jsxRuntimeExports.jsx(le.default,{label:d,required:f,...A}):null;o.useImperativeHandle(L,()=>({focus:()=>a.current?.focus(),blur:()=>a.current?.blur()}));const N=j?j.map(e=>({label:typeof e.label=="string"?r.jsxRuntimeExports.jsx(I.default,{children:e.label}):e.label,value:e.value})):m?m.map(e=>({label:typeof e.text=="string"?r.jsxRuntimeExports.jsx(I.default,{children:e.text}):e.text,value:typeof e.value=="function"?e.value():e.value})):[],K=!!N?.length,Q=x(C,c.dropdownClassName,`${y.$prefixCls}-scrollbar-small`,{[`${t}-use12Hours`]:B,[`${t}-presets-${R}`]:K}),W=e=>s.getPopupContainer(e,D,b),X=e=>{c.onOpenChange?.(e),U&&s.isolationPopupPollution(e,C),e||a.current?.blur()};return(()=>{const e=r.jsxRuntimeExports.jsxs("div",{ref:b,className:x(`${t}-wrapper`,O),style:S,children:[J(),r.jsxRuntimeExports.jsx(ne.RangePicker,{separator:r.jsxRuntimeExports.jsx("span",{"aria-label":"to",className:`${t}-separator`,children:r.jsxRuntimeExports.jsx(re.SortRight,{})}),ref:a,placeholder:s.getRangePlaceholder(n,v,H),suffixIcon:n==="time"?r.jsxRuntimeExports.jsx(se.Time,{}):r.jsxRuntimeExports.jsx(te.Calendar,{className:"picker-icon"}),clearIcon:r.jsxRuntimeExports.jsx(ee.CloseCircleF,{}),allowClear:!0,disabled:g,...c,...l,defaultValue:k(F),value:k(V),presets:N,className:x({[`${t}-borderless`]:!_,[`${t}-error`]:u,[`${t}-shortcuts-${R}`]:u}),locale:v.lang,prefixCls:t,generateConfig:z,prevIcon:r.jsxRuntimeExports.jsx("span",{className:`${t}-prev-icon`}),nextIcon:r.jsxRuntimeExports.jsx("span",{className:`${t}-next-icon`}),superPrevIcon:r.jsxRuntimeExports.jsx("span",{className:`${t}-super-prev-icon`}),superNextIcon:r.jsxRuntimeExports.jsx("span",{className:`${t}-super-next-icon`}),components:T.Components,direction:"ltr",dropdownClassName:Q,getPopupContainer:W,onOpenChange:X}),r.jsxRuntimeExports.jsx(ae.default,{error:u,helperText:M})]});return g&&P?r.jsxRuntimeExports.jsx(ue.Tooltip,{disabled:!0,...P,children:e}):e})()})}exports.default=ce;
 //# sourceMappingURL=generateRangePicker.js.map

package/lib/DatePicker/generatePicker/generateSinglePicker.js

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const r=require("../../_virtual/jsx-runtime.js"),l=require("react"),x=require("clsx"),se=require("rc-picker"),ne=require("../../node_modules/@para-ui/icons/CloseCircleF/index.js"),oe=require("../../node_modules/@para-ui/icons/Calendar/index.js"),ie=require("../../node_modules/@para-ui/icons/Time/index.js"),s=require("../util.js"),E=require("./index.js"),N=require("../lang/index.js"),le=require("../../GlobalContext/index.js"),ae=require("../../Label/index.js"),ce=require("../../HelperText/index.js"),w=require("../../GlobalContext/constant.js"),ue=require("@paraview/lib"),pe=require("../PickerTag.js"),de=require("../../Tooltip/index.js");function xe(y){function n(c,me){return l.forwardRef((a,M)=>{const{className:V,size:Pe,bordered:D=!0,placeholder:F,error:m=!1,helperText:S,style:U,value:G,defaultValue:Q,label:f="",labelTooltip:W,required:P=!1,presets:j,getPopupContainer:Y,isolationPopupOnHide:A=!1,disabled:g,disabledTooltip:k,...u}=a,p=l.useRef(null),R=l.useRef(),{format:d,showTime:C,use12Hours:B}=a,t=`${w.$prefixCls}-picker`,q=l.useMemo(()=>ue.UUID(),[]),{language:b,locale:h}=l.useContext(le.default);let $={};if(h){const e=h[b||"zh"];e&&($=e.DatePicker)}const J=N.default[b||"zh"]||N.default.zh,T=s.mergedLocale($,J),K={showToday:!0};let o={};c&&(o.picker=c);const i=c||a.picker;o={...o,...C?s.getTimeProps({format:d,picker:i,...C}):{},...i==="time"?s.getTimeProps({format:d,...a,picker:i}):{}},o.style&&delete o.style;const v=e=>{const te=d??E.pickerFormatMap[i];return s.formatPickerValue(e,te)},X=()=>f||P?r.jsxRuntimeExports.jsx(ae.default,{label:f,required:P,...W}):null;l.useImperativeHandle(M,()=>({focus:()=>p.current?.focus(),blur:()=>p.current?.blur()}));const Z=j?j.map(e=>({label:typeof e.label=="string"?r.jsxRuntimeExports.jsx(pe.default,{children:e.label}):e.label,value:e.value})):[],ee=e=>s.getPopupContainer(e,Y,R),re=e=>{u.onOpenChange?.(e),A&&s.isolationPopupPollution(e,q)};return(()=>{const e=r.jsxRuntimeExports.jsxs("div",{ref:R,className:x(`${t}-wrapper`,V),style:U,children:[X(),r.jsxRuntimeExports.jsx(se,{ref:p,placeholder:s.getPlaceholder(i,T,F),suffixIcon:i==="time"?r.jsxRuntimeExports.jsx(ie.Time,{}):r.jsxRuntimeExports.jsx(oe.Calendar,{}),clearIcon:r.jsxRuntimeExports.jsx(ne.CloseCircleF,{}),allowClear:!0,disabled:g,...K,...u,...o,defaultValue:v(Q),value:v(G),locale:T.lang,className:x({[`${t}-borderless`]:!D,[`${t}-error`]:m}),prefixCls:t,presets:Z,generateConfig:y,prevIcon:r.jsxRuntimeExports.jsx("span",{className:`${t}-prev-icon`}),nextIcon:r.jsxRuntimeExports.jsx("span",{className:`${t}-next-icon`}),superPrevIcon:r.jsxRuntimeExports.jsx("span",{className:`${t}-super-prev-icon`}),superNextIcon:r.jsxRuntimeExports.jsx("span",{className:`${t}-super-next-icon`}),components:E.Components,direction:"ltr",dropdownClassName:x(q,u.dropdownClassName,B&&`${t}-use12Hours`,`${w.$prefixCls}-scrollbar-small`),getPopupContainer:ee,onOpenChange:re}),r.jsxRuntimeExports.jsx(ce.default,{error:m,helperText:S})]});return g&&k?r.jsxRuntimeExports.jsx(de.Tooltip,{disabled:!0,...k,children:e}):e})()})}const I=n(),z=n("week"),L=n("month"),O=n("year"),_=n("time"),H=n("quarter");return{DatePicker:I,WeekPicker:z,MonthPicker:L,YearPicker:O,TimePicker:_,QuarterPicker:H}}exports.default=xe;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const r=require("../../_virtual/jsx-runtime.js"),l=require("react"),x=require("clsx"),se=require("rc-picker"),ne=require("../../node_modules/@para-ui/icons/CloseCircleF/index.js"),oe=require("../../node_modules/@para-ui/icons/Calendar/index.js"),ie=require("../../node_modules/@para-ui/icons/Time/index.js"),s=require("../util.js"),E=require("./index.js"),N=require("../lang/index.js"),le=require("../../GlobalContext/index.js"),ae=require("../../Label/index.js"),ce=require("../../HelperText/index.js"),w=require("../../GlobalContext/constant.js"),ue=require("@snack-kit/lib"),pe=require("../PickerTag.js"),de=require("../../Tooltip/index.js");function xe(y){function n(c,me){return l.forwardRef((a,M)=>{const{className:V,size:Pe,bordered:D=!0,placeholder:F,error:m=!1,helperText:S,style:U,value:G,defaultValue:Q,label:f="",labelTooltip:W,required:P=!1,presets:j,getPopupContainer:Y,isolationPopupOnHide:A=!1,disabled:g,disabledTooltip:k,...u}=a,p=l.useRef(null),R=l.useRef(null),{format:d,showTime:C,use12Hours:B}=a,t=`${w.$prefixCls}-picker`,b=l.useMemo(()=>ue.UUID(),[]),{language:h,locale:q}=l.useContext(le.default);let $={};if(q){const e=q[h||"zh"];e&&($=e.DatePicker)}const J=N.default[h||"zh"]||N.default.zh,T=s.mergedLocale($,J),K={showToday:!0};let o={};c&&(o.picker=c);const i=c||a.picker;o={...o,...C?s.getTimeProps({format:d,picker:i,...C}):{},...i==="time"?s.getTimeProps({format:d,...a,picker:i}):{}},o.style&&delete o.style;const v=e=>{const te=d??E.pickerFormatMap[i];return s.formatPickerValue(e,te)},X=()=>f||P?r.jsxRuntimeExports.jsx(ae.default,{label:f,required:P,...W}):null;l.useImperativeHandle(M,()=>({focus:()=>p.current?.focus(),blur:()=>p.current?.blur()}));const Z=j?j.map(e=>({label:typeof e.label=="string"?r.jsxRuntimeExports.jsx(pe.default,{children:e.label}):e.label,value:e.value})):[],ee=e=>s.getPopupContainer(e,Y,R),re=e=>{u.onOpenChange?.(e),A&&s.isolationPopupPollution(e,b)};return(()=>{const e=r.jsxRuntimeExports.jsxs("div",{ref:R,className:x(`${t}-wrapper`,V),style:U,children:[X(),r.jsxRuntimeExports.jsx(se,{ref:p,placeholder:s.getPlaceholder(i,T,F),suffixIcon:i==="time"?r.jsxRuntimeExports.jsx(ie.Time,{}):r.jsxRuntimeExports.jsx(oe.Calendar,{}),clearIcon:r.jsxRuntimeExports.jsx(ne.CloseCircleF,{}),allowClear:!0,disabled:g,...K,...u,...o,defaultValue:v(Q),value:v(G),locale:T.lang,className:x({[`${t}-borderless`]:!D,[`${t}-error`]:m}),prefixCls:t,presets:Z,generateConfig:y,prevIcon:r.jsxRuntimeExports.jsx("span",{className:`${t}-prev-icon`}),nextIcon:r.jsxRuntimeExports.jsx("span",{className:`${t}-next-icon`}),superPrevIcon:r.jsxRuntimeExports.jsx("span",{className:`${t}-super-prev-icon`}),superNextIcon:r.jsxRuntimeExports.jsx("span",{className:`${t}-super-next-icon`}),components:E.Components,direction:"ltr",dropdownClassName:x(b,u.dropdownClassName,B&&`${t}-use12Hours`,`${w.$prefixCls}-scrollbar-small`),getPopupContainer:ee,onOpenChange:re}),r.jsxRuntimeExports.jsx(ce.default,{error:m,helperText:S})]});return g&&k?r.jsxRuntimeExports.jsx(de.Tooltip,{disabled:!0,...k,children:e}):e})()})}const I=n(),z=n("week"),L=n("month"),O=n("year"),_=n("time"),H=n("quarter");return{DatePicker:I,WeekPicker:z,MonthPicker:L,YearPicker:O,TimePicker:_,QuarterPicker:H}}exports.default=xe;
 //# sourceMappingURL=generateSinglePicker.js.map

package/lib/Descriptions/component.json

@@ -0,0 +1,142 @@
+{
+    "name": "Descriptions",
+    "category": "Data Display",
+    "description": "描述列表，成组展示多个只读键值对字段，支持折叠展开和边框模式",
+    "semantic": {
+        "intent": [
+            "信息展示",
+            "详情查看",
+            "键值对展示"
+        ],
+        "useCases": [
+            "用户信息",
+            "订单详情",
+            "配置概览"
+        ],
+        "riskLevel": "low"
+    },
+    "variants": {
+        "default": {
+            "meaning": "标准描述列表（无边框，horizontal 布局）"
+        },
+        "bordered": {
+            "meaning": "带边框描述列表（border=true）"
+        }
+    },
+    "states": [
+        "default",
+        "collapsed",
+        "expanded"
+    ],
+    "idealProps": {
+        "list": {
+            "type": "DescriptionsListProps[]",
+            "description": "列表配置数组；DescriptionsListProps 字段：label(ReactNode 标题)、content(ReactNode 内容)、column(number 占比列数，默认 1)。**不是 antd 风格的 items 字段——para-ui 用 list**"
+        },
+        "layout": {
+            "type": "enum",
+            "values": [
+                "horizontal",
+                "vertical"
+            ],
+            "default": "horizontal",
+            "description": "布局方向；horizontal=标题+内容在同一行，vertical=标题在上内容在下（各占一行）"
+        },
+        "column": {
+            "type": "number",
+            "description": "每行显示的列数；horizontal 无 border 默认 4，horizontal 有 border 默认 3，vertical 默认 4；也可通过 list 每项的 column 字段单独设置跨列数"
+        },
+        "border": {
+            "type": "boolean",
+            "default": false,
+            "description": "是否显示边框（table 形式）；border=true 时 collapse 功能不可用（src/Descriptions/index.tsx:235 实证：collapse && !border 才启用折叠）"
+        },
+        "title": {
+            "type": "string | TitleProps",
+            "description": "标题；传 string 时自动包装为 TitleProps；传 TitleProps 对象可自定义 title/subtitle/action 等"
+        },
+        "collapse": {
+            "type": "boolean",
+            "default": false,
+            "description": "是否启用折叠（仅 horizontal 无 border 时有效）；启用后显示展开/收起按钮，配合 collapsedHeight 控制收起最小高度"
+        },
+        "collapsedHeight": {
+            "type": "string | number",
+            "default": 60,
+            "description": "收起状态最小高度（default 60）；仅 collapse=true 且 border=false 时生效"
+        },
+        "defaultOpen": {
+            "type": "boolean",
+            "default": false,
+            "description": "初始是否展开（非受控，仅首次渲染生效）"
+        },
+        "open": {
+            "type": "boolean",
+            "description": "受控展开状态；传入后外部可控制展开/收起；不传时组件内部维护状态"
+        },
+        "onCollapse": {
+            "type": "(bol: boolean) => void",
+            "description": "折叠状态变化回调；bol=true 表示展开"
+        },
+        "paddingRight": {
+            "type": "number | string",
+            "default": 40,
+            "description": "横向模式每个字段的右内边距（控制标题与内容间距）"
+        },
+        "className": {
+            "type": "string",
+            "description": "根容器自定义类名"
+        },
+        "style": {
+            "type": "React.CSSProperties",
+            "description": "根容器自定义样式"
+        }
+    },
+    "do": [
+        "用于展示键值对形式的详情数据——list 每项传 { label, content } 即可",
+        "根据内容量决定 column：内容较少用 column=2，内容较多用 column=3/4",
+        "需要折叠功能：传 collapse=true（仅 horizontal + 无 border 时有效），配合 collapsedHeight 设置预览高度"
+    ],
+    "dont": [
+        "在 Descriptions 中放入可编辑表单——应使用 Form 组件",
+        "Label 过长导致排版错乱——label 超过 6 个字时建议配合 AutoTips 或缩短文案",
+        "border=true 时传 collapse=true 期望折叠生效——两者互斥（src 实证：border=true 时 collapse 被忽略）",
+        "用 items 字段传数据（antd 风格）——para-ui Descriptions 用 list 字段"
+    ],
+    "events": {
+        "onCollapse": {
+            "signature": "(bol: boolean) => void",
+            "asyncSupported": false,
+            "examples": [
+                "受控折叠：<Descriptions collapse open={isOpen} onCollapse={(bol) => setIsOpen(bol)} />",
+                "仅监听不受控：<Descriptions collapse onCollapse={(bol) => trackEvent(bol ? 'expand' : 'collapse')} />",
+                "bol=true 表示用户点击展开，bol=false 表示用户点击收起"
+            ],
+            "commonMistakes": [
+                "期望 border=true 时 onCollapse 触发——collapse 功能在 border=true 时不可用，onCollapse 永不触发",
+                "传 open 不传 onCollapse，以为可以完全受控——open prop 变化会同步状态，但不传 onCollapse 用户点击无法反向通知父端"
+            ]
+        }
+    },
+    "typescriptPitfalls": [
+        {
+            "issue": "list 字段名是 list，不是 antd 风格的 items",
+            "wrong": "<Descriptions items={[{ label: '姓名', children: '张三' }]} />  // items/children 是 antd 风格，para-ui 不支持",
+            "right": "<Descriptions list={[{ label: '姓名', content: '张三' }]} />  // 用 list + content"
+        },
+        {
+            "issue": "border=true 时 collapse 不生效，两者在 TS 层面不互斥但运行时 border 优先级更高",
+            "wrong": "<Descriptions border collapse />  // border=true 时 collapse 被忽略，无折叠按钮",
+            "right": "<Descriptions collapse />  // 折叠功能只在 border=false（默认）时可用"
+        },
+        {
+            "issue": "title 同时接受 string 和 TitleProps 对象，混用导致 TS 联合类型错误",
+            "wrong": "title={{ text: '标题' }}  // TitleProps 字段是 title，不是 text",
+            "right": "title='标题'  // 字符串即可；或 title={{ title: '标题', subtitle: '副标题' }}"
+        }
+    ],
+    "mapping": {
+        "realComponent": "Descriptions",
+        "adapter": null
+    }
+}

package/lib/Descriptions/index.d.ts

@@ -7,7 +7,7 @@ export interface DescriptionsListProps {
     content?: ReactNode;
     /** 占比列，默认占比1 */
     column?: number;
-    [name: string]: any;
+    [name: string]: unknown;
 }
 export interface DescriptionsProps {
     /** 样式class */

package/lib/Desktop/component.json

@@ -0,0 +1,171 @@
+{
+    "name": "Desktop",
+    "category": "Layout",
+    "description": "桌面布局组件,支持拖拽排序的网格布局。**API 设计上有 3 个已知硬约束**(见 limitations):1) onClick/onSort 回调返回完整数组而非单项;2) icon 只接受 base64 string 不接受 ReactNode;3) 无 children / render prop 不支持任意内容渲染",
+    "semantic": {
+        "intent": [
+            "拖拽排序的应用网格",
+            "可自定义顺序的图标列表",
+            "持久化用户布局偏好"
+        ],
+        "useCases": [
+            "工作台(可拖拽的应用入口集合)",
+            "仪表盘首页(应用列表,需要内容用 base64 icon)",
+            "个性化首页(顺序持久化到 localStorage)"
+        ],
+        "riskLevel": "low"
+    },
+    "limitations": {
+        "L1_onClick_returns_full_array": {
+            "issue": "**onClick(data) 的 data 是完整 DesktopDataItem 数组,不是被点击的单个 item**。无法直接知道用户点的是第几项",
+            "rootCause": "src/Desktop/index.tsx:44 实证:click handler 传 `[...data]` 给外部",
+            "workaround": "在 data 项挂 _payload 扩展字段(如 _index / _app),配合 onSort 维护当前顺序的引用,在 onClick 内根据 e.target.closest('[data-key]') 或自维护的 currentClickedKey 反查 —— 但**Desktop 内部没有暴露 click 时的 key,只能改用 data[0] 假设是被点击项或外部加 React 事件代理**。**结构性限制,docs 救不了**",
+            "alternative": "**强烈建议**:如果业务需要识别点击项,改用 Container + Card 自行实现网格 + onClick,或者只用 Desktop 做'排序'功能,'打开应用'功能由 data 项上的 children 字段(若需嵌入按钮)在外层另起 UI"
+        },
+        "L2_icon_no_reactnode": {
+            "issue": "**icon 字段只接受 base64 string,不接受 React.ReactNode**(SVG 组件 / 图标组件等)",
+            "rootCause": "Desktop 内部用 `<img src={icon} />` 渲染,React.ReactNode 会触发 TypeScript 类型错误或运行时 ReactNode-as-string 错误",
+            "workaround": "**适配上层 AppItem.icon: ReactNode 接口的 3 种方式**:\n1. **改业务接口**(推荐):AppItem.icon 改成 `string | { reactNode: ReactNode }`,Desktop 只读 string 分支\n2. **运行时转换**:用 dom-to-image / html-to-image 把 ReactNode 渲染成 base64(performance 代价大)\n3. **降级**:typeof icon === 'string' 时透传,否则不传 icon 字段(显示无图标,只显示 name)\n\n业务方常踩坑写 `<Desktop data={[{key, name, icon: <Icon />}]} />` 直接传 ReactNode,会 tsc 报错",
+            "alternative": "需要任意 ReactNode 渲染:换用 Container + 自实现网格,或者 RcDraggable 类组件"
+        },
+        "L3_no_children_render": {
+            "issue": "**Desktop 不支持 children / render prop / itemRender 自定义格子内容**。每个格子只能渲染 icon (img) + name (text)",
+            "rootCause": "src/Desktop/index.tsx:33 - DesktopProps 无 children / renderItem / itemRender 等字段",
+            "workaround": "无 —— 这是结构性限制",
+            "alternative": "需要每格放 React 组件(如 Widget / Card / 按钮组):**不要用 Desktop**,改用 Container + 自己用 react-grid-layout / dnd-kit 实现拖拽网格"
+        }
+    },
+    "adaptationPatterns": {
+        "patternA_localStorageOrder": "**持久化排序到 localStorage**(主流场景):\n```ts\n// 1. 读初始顺序\nconst orderKey = 'myApp:desktopOrder';\nconst initialOrder: string[] = JSON.parse(localStorage.getItem(orderKey) || '[]');\n// 2. 按持久化顺序对业务数据排序\nconst orderedApps = useMemo(() => {\n  if (!initialOrder.length) return apps;\n  return [...apps].sort((a, b) => initialOrder.indexOf(a.id) - initialOrder.indexOf(b.id));\n}, [apps, initialOrder]);\n// 3. onSort 时只保存 key 序列,sort prop 保持 {}\nconst handleSort = (nextData) => {\n  setApps(nextData.map(d => d._app));\n  localStorage.setItem(orderKey, JSON.stringify(nextData.map(d => d.key)));\n};\n```\n**关键:sort prop 只在'恢复历史 sort 对象'场景才需要,正常持久化 key 序列就够**",
+        "patternB_clickIdentification": "**识别点击项 (workaround,有限可靠)**:\nDesktop 的 onClick(data) 不告诉你点了哪项,只能用 DOM 事件代理:\n```ts\n<div onClick={(e) => {\n  const cell = (e.target as HTMLElement).closest('[data-id]');\n  const id = cell?.getAttribute('data-id');\n  if (id) handleAppClick(id);\n}}>\n  <Desktop data={dataWithDataIdAttr} ... />\n</div>\n```\n或更**推荐:不依赖 Desktop.onClick,Desktop 只管排序,'打开应用'的点击行为另起方案**",
+        "patternC_reactNodeIcon": "**业务接口声明 icon: ReactNode 的衔接**:\n```ts\ninterface BusinessApp { id: string; name: string; icon: ReactNode; iconUrl?: string; }\n// 映射时只取 iconUrl(base64),不传 ReactNode\nconst desktopData = apps.map(app => ({\n  key: app.id,\n  name: app.name,\n  icon: app.iconUrl  // 只透传 string,ReactNode 不传\n}));\n```"
+    },
+    "variants": {
+        "default": {
+            "meaning": "默认样式"
+        }
+    },
+    "states": [
+        "default",
+        "dragging"
+    ],
+    "idealProps": {
+        "data": {
+            "type": "Array<DesktopDataItem>",
+            "required": true,
+            "description": "拖拽列表数据;DesktopDataItem 接口 src/Desktop/index.tsx:23 已 export,字段:key(string 必填 唯一)、name(string?)、disable(boolean?)、icon(string? base64,**不支持 React.ReactNode** —— 见 limitations.L2)、disabledTooltip(TooltipProps?)、可挂任意扩展字段(`[k]: string|boolean|number|...`,常用 _payload / _app 挂业务模型)"
+        },
+        "sort": {
+            "type": "{ [key: string]: mapProps[] }",
+            "description": "排序映射,**可选受控**;value 为内部 mapProps[](opaque),`interface mapProps` 未 export,**调用方不应手动构造**。**典型用法 1**:首次渲染传 `{}`,组件按 data 顺序推导默认排序(推荐,99% 场景)。**典型用法 2**:从 localStorage 反序列化某次 onSort 后保存的 sort 对象再透传(罕见,通常直接持久化 key 序列即可)。**onSort 回调后通常无需更新 sort prop** —— 组件会基于新 data 顺序自动重排"
+        },
+        "onSort": {
+            "type": "(data: Array<DesktopDataItem>) => void",
+            "signature": "(data: Array<DesktopDataItem>) => void",
+            "description": "排序变化回调;**⚠️ data 参数为【排序后的完整 DesktopDataItem 数组】,不是 sort 映射对象,也不是 diff**。src/Desktop/index.tsx:42 实证;持久化新顺序时:**推荐保存 data.map(d => d.key) 数组**(简单稳定),而不是 sort 对象(opaque + 易过期)"
+        },
+        "onClick": {
+            "type": "(data: Array<DesktopDataItem>) => void",
+            "signature": "(data: Array<DesktopDataItem>) => void",
+            "description": "点击回调;**⚠️ data 参数为【完整 DesktopDataItem 数组】,不是被点击的单个 item**(已知 API 限制,见 limitations.L1)。**workaround**:在 Desktop 外层 div 用 React 事件代理 + 自维护 data-id 属性(见 adaptationPatterns.patternB)。**或不用 onClick**——只用 Desktop 排序,'打开应用'另起方案"
+        },
+        "tipMaxWidth": {
+            "type": "number",
+            "description": "禁用项 Tooltip 的最大宽度(px);仅在 DesktopDataItem 设置了 disable=true + disabledTooltip 字段时生效"
+        }
+    },
+    "commonMisconceptions": {
+        "M1": {
+            "wrong": "把 onSort(data) 的 data 当成 sort 映射对象处理:`onSort: (sortObj) => setSort(sortObj)`",
+            "result": "**data 实际是数组**,setSort 收到数组而期望对象 → TS 类型错误 + sort prop 状态混乱",
+            "fix": "改成 `onSort: (nextData) => setData(nextData)` —— data 是【排序后的完整 DesktopDataItem 数组】。sort prop 通常不需要在 onSort 回调里更新,保持 {} 即可"
+        },
+        "M2": {
+            "wrong": "在 data 项的 icon 字段传 React.ReactNode: `<Desktop data={[{key, name, icon: <Icon />}]} />`",
+            "result": "**TS 报错**(icon: string 字段类型不匹配) 或 runtime 渲染 [object Object]",
+            "fix": "icon 必须是 base64 string。需要 SVG / 图标组件:**预先用工具转 base64**(`btoa` + SVG 字符串),或**不传 icon**(显示无图标,只显示 name)。见 adaptationPatterns.patternC"
+        },
+        "M3": {
+            "wrong": "期望 onClick(data) 的 data 就是被点击的单项: `onClick: (item) => openApp(item.key)`",
+            "result": "**item 实际是完整数组**,`item.key` 是 undefined,openApp(undefined) 触发空指针",
+            "fix": "Desktop **结构性不支持识别单项点击**(L1)。两种 workaround:1) 外层 div 事件代理 + data-id(patternB);2) 不依赖 Desktop.onClick,改用 Desktop 仅管排序,点击行为另起 UI"
+        },
+        "M4": {
+            "wrong": "期望 Desktop 接受 children / renderItem 自定义格子内容: `<Desktop>{apps.map(...)}</Desktop>` 或 `<Desktop renderItem={...} />`",
+            "result": "**DesktopProps 无 children / renderItem 字段**,传入被静默忽略,格子仍只渲染 icon + name",
+            "fix": "需要每格放 React 组件:**不要用 Desktop**,改 Container + react-grid-layout / dnd-kit"
+        },
+        "M5": {
+            "wrong": "手动构造 sort prop 的 mapProps[] 形态: `sort={{ 'group-1': [{type: 'app', key: 'a', index: 0, ...}] }}`",
+            "result": "mapProps 接口未 export,字段会变(opaque),手动构造容易引发不可预期的渲染状态",
+            "fix": "sort 只用两种值:`{}` (默认,组件按 data 顺序推导) 或 上次 onSort 后从 localStorage 反序列化的整个 sort 对象。**永远不手动写 sort 字面量**"
+        }
+    },
+    "do": [
+        "**默认用法**:`<Desktop data={data} sort={{}} onSort={setData} />`(sort 用空对象,Desktop 自动推导)",
+        "用户排序偏好:保存 `nextData.map(d => d.key)` 到 localStorage(而非 sort 对象,见 patternA)",
+        "业务模型挂在 data 项的扩展字段(`_app`, `_payload` 等),onSort 时 map(_app) 取回",
+        "上层接口 icon 是 ReactNode 时:映射时只取 string 字段(iconUrl / iconBase64),不传 ReactNode(patternC)",
+        "需要识别点击项:外层 div 事件代理 + data-id 自维护(patternB);或不用 Desktop.onClick"
+    ],
+    "dont": [
+        "**不要**把 onSort 的参数当 sort 对象处理——是数组(M1)",
+        "**不要**给 icon 传 React.ReactNode——只接受 base64 string(M2,L2)",
+        "**不要**期望 onClick 知道点的是哪一项——是数组(M3,L1)",
+        "**不要**用 children / renderItem 自定义格子——不存在(M4,L3)",
+        "**不要**手动构造 sort prop 的 mapProps 字面量——opaque(M5)",
+        "**不要**在每格需要嵌入任意 React 组件的场景使用 Desktop——换 Container + dnd-kit",
+        "拖拽项过多(>100)导致性能问题"
+    ],
+    "events": {
+        "onSort": {
+            "signature": "(data: Array<DesktopDataItem>) => void",
+            "asyncSupported": false,
+            "examples": [
+                "基本排序：<Desktop data={data} sort={{}} onSort={(nextData) => setData(nextData)} />",
+                "持久化排序：onSort={(nextData) => { setData(nextData); localStorage.setItem('order', JSON.stringify(nextData.map(d => d.key))); }}",
+                "onSort 的 data 参数是排序后的完整 DesktopDataItem 数组（不是 diff，不是 sort 映射对象）"
+            ],
+            "commonMistakes": [
+                "把 onSort(data) 的 data 当 sort 映射对象处理：setSort(data)——data 是数组，sort 期望 { [key]: mapProps[] }",
+                "期望 onSort 在初始化时触发——只有用户拖拽后才触发",
+                "持久化保存整个 data 数组（含业务 _payload 字段）——推荐只保存 data.map(d => d.key) 的 key 序列"
+            ]
+        },
+        "onClick": {
+            "signature": "(data: Array<DesktopDataItem>) => void",
+            "asyncSupported": false,
+            "examples": [
+                "注意：data 是完整数组，不是被点击的单项——识别点击项需要外层事件代理",
+                "外层事件代理识别点击项：通过 e.target.closest('[data-id]') 反查 id",
+                "若不需要识别单项：仅用 onClick 感知'有项被点击'的触发，具体 item 由 sort 顺序推断"
+            ],
+            "commonMistakes": [
+                "期望 onClick(item) 的 item 是被点击的单个 DesktopDataItem——实际是完整数组",
+                "item.key 是 undefined（因为 item 是数组）：openApp(item.key) 触发空指针",
+                "期望通过 children/renderItem 自定义格子点击行为——Desktop 不支持 children/renderItem"
+            ]
+        }
+    },
+    "typescriptPitfalls": [
+        {
+            "issue": "icon 字段只接受 base64 string，传 ReactNode 会 TS 报错或运行时渲染 [object Object]",
+            "wrong": "data={[{ key: 'app1', name: '应用1', icon: <AppIcon /> }]}  // TS 报错：icon: string 类型不匹配",
+            "right": "// icon 必须是 base64 字符串，ReactNode 图标需预先转 base64\ndata={[{ key: 'app1', name: '应用1', icon: 'data:image/png;base64,...' }]}"
+        },
+        {
+            "issue": "onSort/onClick 的参数 data 是完整数组，不是单个 item，类型声明也是 Array<DesktopDataItem>",
+            "wrong": "onClick={(item) => openApp(item.key)}  // item 实际是数组，item.key 是 undefined",
+            "right": "// Desktop 不支持识别单项点击，只能用事件代理：\n<div onClick={(e) => { const id = (e.target as HTMLElement).closest('[data-id]')?.getAttribute('data-id'); }}>\n  <Desktop ... />\n</div>"
+        },
+        {
+            "issue": "sort prop 的 mapProps[] 接口未 export，不能手动构造 sort 字面量",
+            "wrong": "sort={{ 'group-1': [{ type: 'app', key: 'a', index: 0 }] }}  // mapProps 接口未公开，字段会变",
+            "right": "sort={{}}  // 传空对象，Desktop 自动按 data 顺序推导"
+        }
+    ],
+    "mapping": {
+        "realComponent": "Desktop",
+        "adapter": null
+    }
+}