@v587d/capital-generation 2.14.1 → 2.15.1

package/config/client.src.cjs

@@ -66,12 +66,20 @@ const CREDENTIAL_FIELDS = ['fuyao', 'ftshare', 'anysearch', 'wind', 'paddleocr']
 const AUTOMATION_FIELDS = ['tickMs', 'runTimeoutMinutes', 'idleTimeoutMinutes', 'maxSteps', 'maxToolCalls', 'inAppNotifications']
 const AUTOMATION_DEFAULTS = {
   tickMs: 60_000,
-  runTimeoutMinutes: 30,
+  runTimeoutMinutes: 60,
   idleTimeoutMinutes: 5,
   maxSteps: 300,
   maxToolCalls: 1_200,
   inAppNotifications: true,
 }
+/** Mirrors `automation/defaults.js`; out-of-range values get an inline error instead of a silent clamp. */
+const AUTOMATION_RANGES = {
+  tickMs: { min: 30_000, max: 3_600_000, unit: 'automationUnitMs' },
+  runTimeoutMinutes: { min: 5, max: 120, unit: 'automationUnitMinutes' },
+  idleTimeoutMinutes: { min: 1, max: 30, unit: 'automationUnitMinutes' },
+  maxSteps: { min: 100, max: 2_000, unit: 'automationUnitSteps' },
+  maxToolCalls: { min: 100, max: 5_000, unit: 'automationUnitCalls' },
+}
 const SELECTED_SKILL_FIELDS = SELECTED_SKILL_CATALOG.map(({ key }) => key)
 // Stable orders: facet counts change with the other dimension, but chips must not jump under the cursor.
 const SELECTED_SKILL_TRAITS = selectedSkillTraitOrder()
@@ -102,9 +110,17 @@ const zh = {
   localFetchLabel: '允许启动本地提取网页内容',
   localFetchHint: '开启后本地抓取兜底（回执来源 local-http）。保存后新自动模式会话生效。',
   automationTitle: '投研自动化',
-  automationHint: '调度器与无人值守运行的默认上限；任务详情里的设置优先。改动在下一个 tick 生效。',
-  automationTick: '调度间隔（毫秒）',
-  automationRunTimeout: 'wall-clock 上限（分钟）',
+  automationScheduleGroup: '调度',
+  automationRunGroup: '单次运行上限',
+  automationNotifyGroup: '通知',
+  automationInAppHint: '运行结束、失败或超时后，在应用内通知里留一条记录。',
+  automationTick: '自动检查间隔（毫秒）',
+  automationRunTimeout: '最长运行时间（分钟）',
+  automationInvalid: '请填写 {min}–{max} {unit}',
+  automationUnitMs: '毫秒',
+  automationUnitMinutes: '分钟',
+  automationUnitSteps: '步',
+  automationUnitCalls: '次',
   automationIdleTimeout: '空闲超时（分钟）',
   automationMaxSteps: '最大步骤',
   automationMaxToolCalls: '最大工具调用',
@@ -136,7 +152,9 @@ const zh = {
   save: '保存',
   saving: '保存中…',
   readOnly: '本部署的设置为只读。',
-  saveFailed: '本部署没有接受这些值，已保留供你修改。',
+  // A rejected or non-landing write (stale page revision, transport hiccup). Plain words only:
+  // the typed value is still there, so the next action is retry, not a restart.
+  saveFailed: '没有保存成功，请再试一次。',
   unavailable: '该插件当前未加载，暂时无法配置。',
   githubLabel: 'GitHub 仓库',
   npmLabel: 'npm 包页面',
@@ -157,9 +175,17 @@ const en = {
   localFetchLabel: 'Allow local web page extraction',
   localFetchHint: 'When on, a failed fetch falls back to local direct fetching (receipt via: local-http). Takes effect in new Auto mode sessions.',
   automationTitle: 'Research automation',
-  automationHint: 'Scheduler and unattended-run defaults; per-task limits win. Changes apply on the next tick.',
-  automationTick: 'Tick interval (ms)',
-  automationRunTimeout: 'Wall-clock limit (minutes)',
+  automationScheduleGroup: 'Scheduling',
+  automationRunGroup: 'Per-run limits',
+  automationNotifyGroup: 'Notifications',
+  automationInAppHint: 'Leave an in-app notification when a run finishes, fails, or times out.',
+  automationTick: 'Auto-check interval (ms)',
+  automationRunTimeout: 'Max run time (minutes)',
+  automationInvalid: 'Enter a whole number from {min} to {max} {unit}',
+  automationUnitMs: 'ms',
+  automationUnitMinutes: 'minutes',
+  automationUnitSteps: 'steps',
+  automationUnitCalls: 'calls',
   automationIdleTimeout: 'Idle timeout (minutes)',
   automationMaxSteps: 'Max steps',
   automationMaxToolCalls: 'Max tool calls',
@@ -191,7 +217,7 @@ const en = {
   save: 'Save',
   saving: 'Saving…',
   readOnly: 'This deployment stores settings read-only.',
-  saveFailed: 'The deployment did not accept these values; they were left for you to correct.',
+  saveFailed: "That didn't save. Please try again.",
   unavailable: 'This plugin is not loaded, so it cannot be configured right now.',
   githubLabel: 'GitHub repository',
   npmLabel: 'npm package page',
@@ -221,6 +247,7 @@ function installStyles() {
     .capital-config-panel[hidden] { display: none; }
     /* Host rows section: positive :has rules only, so any mismatch leaves it visible. */
     [data-plugin-detail="${BUNDLE_NAME}"]:has(.capital-config-card[data-capital-config-tab="sources"]) section[data-plugin-rows] { display: none; }
+    [data-plugin-detail="${BUNDLE_NAME}"]:has(.capital-config-card[data-capital-config-tab="automation"]) section[data-plugin-rows] { display: none; }
     [data-plugin-detail="${BUNDLE_NAME}"]:has(.capital-config-card[data-capital-config-tab="skills"]) section[data-plugin-rows] { display: none; }
     /* Internal roles must stay declared for delegation; hide their user-selectable cards in Settings. */
     [data-agent-preset-id="capital-data-junior"],
@@ -230,8 +257,14 @@ function installStyles() {
     .capital-config-secret-row label { flex: 0 1 auto; }
     .capital-config-secret-row label ~ span { order: 1; margin-left: auto; }
     .capital-config-field { display: flex; flex-direction: column; gap: 6px; padding: 12px 0; border-top: 0.5px solid var(--dsw-alias-border-l2); }
+    .capital-config-automation { display: flex; flex-direction: column; gap: 16px; padding-top: 12px; }
+    .capital-config-automation-group { display: flex; flex-direction: column; gap: 8px; }
+    .capital-config-automation-group > .capital-config-group-label { color: var(--dsw-alias-label-secondary); font-size: 12px; font-weight: 500; line-height: 18px; }
+    .capital-config-number { display: flex; flex-direction: column; gap: 4px; min-width: 0; }
+    .capital-config-number-head { display: flex; flex-wrap: wrap; align-items: baseline; gap: 2px 8px; min-width: 0; }
+    .capital-config-number-head .capital-config-write-failed { font-size: 11px; line-height: 16px; }
     .capital-config-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(140px, 1fr)); gap: 8px; }
-    .capital-config-field input[type="number"] { width: 100%; box-sizing: border-box; padding: 6px 8px; border: .5px solid var(--dsw-alias-border-l1); border-radius: 8px; background: var(--dsw-alias-bg-module-platform); color: var(--dsw-alias-label-primary); font: inherit; font-size: 12px; }
+    .capital-config-automation input[type="number"] { width: 100%; box-sizing: border-box; padding: 6px 8px; border: .5px solid var(--dsw-alias-border-l1); border-radius: 8px; background: var(--dsw-alias-bg-module-platform); color: var(--dsw-alias-label-primary); font: inherit; font-size: 12px; }
     .capital-config-selected-mode { padding: 12px 14px; border: 0.5px solid var(--dsw-alias-border-l1); border-radius: 10px; background: var(--dsw-alias-bg-layer-2); }
     .capital-config-switch-row { align-items: center; gap: 12px; display: flex; }
     .capital-config-switch-text { min-width: 0; flex: 1; display: flex; flex-direction: column; gap: 4px; }
@@ -303,6 +336,7 @@ class CapitalCardController {
     this.selectedSkillsModeFailed = false
     this.automationWriting = new Set()
     this.automationFailed = new Set()
+    this.automationInvalid = new Set()
     // Row count is external: null = unknown, never 0; fetch only after the card is shown.
     this.bundleRows = null
     this.rowsRequested = false
@@ -357,6 +391,7 @@ class CapitalCardController {
         on: snapshot.value?.automation?.[field] !== false,
         writing: this.automationWriting.has(field),
         failed: this.automationFailed.has(field),
+        invalid: this.automationInvalid.has(field),
       }])),
       // `count === null` means unknown, not zero: the card decides whether to draw it.
       components: { count: this.bundleRows },
@@ -471,18 +506,34 @@ class CapitalCardController {
     this.store.set(this.projection())
   }
 
+  /** Returns why the write did or did not land: the card restores the input only for `invalid`. */
   async writeAutomation(field, value) {
-    if (!AUTOMATION_FIELDS.includes(field) || this.automationWriting.has(field)) return
+    if (!AUTOMATION_FIELDS.includes(field) || this.automationWriting.has(field)) return 'ignored'
     const snapshot = this.scope.getSnapshot()
-    if (snapshot.status !== 'ready' || !snapshot.writable) return
-    const next = field === 'inAppNotifications' ? value === true : Number(value)
-    if (field !== 'inAppNotifications' && !Number.isFinite(next)) return
+    if (snapshot.status !== 'ready' || !snapshot.writable) return 'ignored'
+    let next
+    if (field === 'inAppNotifications') {
+      next = value === true
+    } else {
+      const { min, max } = AUTOMATION_RANGES[field]
+      const raw = typeof value === 'string' ? value.trim() : value
+      next = Number(raw)
+      if (raw === '' || raw === null || raw === undefined || !Number.isInteger(next) || next < min || next > max) {
+        // Point at the range and write nothing; the card puts the saved value back.
+        this.automationInvalid.add(field)
+        this.automationFailed.delete(field)
+        this.store.set(this.projection())
+        return 'invalid'
+      }
+      this.automationInvalid.delete(field)
+    }
     this.automationWriting.add(field)
     this.automationFailed.delete(field)
     this.store.set(this.projection())
     try {
-      const current = this.scope.getSnapshot().value?.automation ?? { ...AUTOMATION_DEFAULTS }
-      await this.scope.mutate([{ op: 'set', path: ['automation'], value: { ...AUTOMATION_DEFAULTS, ...current, [field]: next } }])
+      // Only leaves are volatile: writing the `automation` container is rejected by the settings
+      // service even though every child field is editable.
+      await this.scope.mutate([{ op: 'set', path: ['automation', field], value: next }])
     } catch {
       // The landed check below reports the failure.
     }
@@ -490,6 +541,12 @@ class CapitalCardController {
     const landed = this.scope.getSnapshot().value?.automation?.[field] ?? AUTOMATION_DEFAULTS[field]
     if (landed !== next) this.automationFailed.add(field)
     this.store.set(this.projection())
+    return landed === next ? 'saved' : 'failed'
+  }
+
+  clearAutomationInvalid(field) {
+    if (!this.automationInvalid.delete(field)) return
+    this.store.set(this.projection())
   }
 
   /**
@@ -533,6 +590,7 @@ class CapitalCardController {
       ...this.model.actions(),
       toggleLocalFetch: (value) => this.toggleLocalFetch(value),
       writeAutomation: (field, value) => this.writeAutomation(field, value),
+      clearAutomationInvalid: (field) => this.clearAutomationInvalid(field),
       toggleSelectedSkill: (field, value) => this.toggleSelectedSkill(field, value),
       toggleSelectedSkillsMode: (auto) => this.toggleSelectedSkillsMode(auto),
       ensureBundleRows: () => this.ensureBundleRows(),
@@ -789,37 +847,75 @@ function CapitalCard(props) {
     ),
     state.localFetch?.failed ? h('p', { role: 'status', className: 'capital-config-write-failed' }, t('saveFailed')) : null,
   )
-  const automationNumber = (field, label, min, max) => h('label', { className: 'capital-config-field' },
-    h('span', { className: 'capital-config-switch-label' }, t(label)),
-    h('input', {
-      type: 'number',
-      min,
-      max,
-      defaultValue: state.automation?.[field]?.value,
-      disabled: disabled || state.saving,
-      onBlur: (event) => props.writeAutomation(field, event.target.value),
-    }),
-    state.automation?.[field]?.failed ? h('p', { role: 'status', className: 'capital-config-write-failed' }, t('saveFailed')) : null,
-  )
-  const automationSection = h('div', { className: 'capital-config-field' },
-    h('span', { className: 'capital-config-switch-label' }, t('automationTitle')),
-    h('p', { className: 'capital-config-hint' }, t('automationHint')),
-    h('div', { className: 'capital-config-grid' },
-      automationNumber('tickMs', 'automationTick', 30000, 3600000),
-      automationNumber('runTimeoutMinutes', 'automationRunTimeout', 5, 120),
-      automationNumber('idleTimeoutMinutes', 'automationIdleTimeout', 1, 30),
-      automationNumber('maxSteps', 'automationMaxSteps', 10, 2000),
-      automationNumber('maxToolCalls', 'automationMaxToolCalls', 10, 6000),
-    ),
-    h('label', { className: 'capital-config-switch-row' },
-      h('span', { className: 'capital-config-switch-label' }, t('automationInApp')),
+  const automationNumber = (field, label) => {
+    const { min, max, unit } = AUTOMATION_RANGES[field]
+    const stored = state.automation?.[field]?.value
+    const invalid = state.automation?.[field]?.invalid === true
+    const error = invalid
+      ? t('automationInvalid', { min, max, unit: t(unit) })
+      : state.automation?.[field]?.failed ? t('saveFailed') : null
+    return h('label', { className: 'capital-config-number' },
+      // Error sits on the title row (the card's usual spot), not under the box.
+      h('span', { className: 'capital-config-number-head' },
+        h('span', { className: 'capital-config-switch-label' }, t(label)),
+        error ? h('span', {
+          id: `capital-config-automation-${field}-error`,
+          role: invalid ? 'alert' : 'status',
+          className: 'capital-config-write-failed',
+        }, error) : null,
+      ),
       h('input', {
-        type: 'checkbox',
-        checked: state.automation?.inAppNotifications?.on !== false,
+        type: 'number',
+        min,
+        max,
+        step: 1,
+        defaultValue: stored,
         disabled: disabled || state.saving,
-        onChange: (event) => props.writeAutomation('inAppNotifications', event.target.checked),
+        'aria-invalid': invalid ? 'true' : undefined,
+        'aria-describedby': error ? `capital-config-automation-${field}-error` : undefined,
+        onFocus: () => props.clearAutomationInvalid(field),
+        onBlur: (event) => {
+          const input = event.target
+          return Promise.resolve(props.writeAutomation(field, input.value)).then((outcome) => {
+            if (outcome === 'invalid' && stored !== undefined) input.value = String(stored)
+          })
+        },
       }),
-    ),
+    )
+  }
+  const automationGroup = (labelKey, children) => h('div', { className: 'capital-config-automation-group' },
+    h('span', { className: 'capital-config-group-label' }, t(labelKey)),
+    ...children,
+  )
+  const automationSection = h('div', { className: 'capital-config-automation' },
+    automationGroup('automationScheduleGroup', [
+      h('div', { className: 'capital-config-grid' },
+        automationNumber('tickMs', 'automationTick'),
+      ),
+    ]),
+    automationGroup('automationRunGroup', [
+      h('div', { className: 'capital-config-grid' },
+        automationNumber('runTimeoutMinutes', 'automationRunTimeout'),
+        automationNumber('idleTimeoutMinutes', 'automationIdleTimeout'),
+        automationNumber('maxSteps', 'automationMaxSteps'),
+        automationNumber('maxToolCalls', 'automationMaxToolCalls'),
+      ),
+    ]),
+    automationGroup('automationNotifyGroup', [
+      h('div', { className: 'capital-config-switch-row' },
+        h('div', { className: 'capital-config-switch-text' },
+          h('span', { className: 'capital-config-switch-label' }, t('automationInApp')),
+          h('p', { className: 'capital-config-hint' }, t('automationInAppHint')),
+        ),
+        h(Switch, {
+          label: t('automationInApp'),
+          checked: state.automation?.inAppNotifications?.on !== false,
+          disabled: disabled || state.saving || state.automation?.inAppNotifications?.writing === true,
+          onChange: (value) => props.writeAutomation('inAppNotifications', value),
+        }),
+      ),
+      state.automation?.inAppNotifications?.failed ? h('p', { role: 'status', className: 'capital-config-write-failed' }, t('saveFailed')) : null,
+    ]),
   )
   const modeSection = h('div', { className: 'capital-config-selected-mode' },
     h('div', { className: 'capital-config-switch-row' },
@@ -889,6 +985,7 @@ function CapitalCard(props) {
   const options = [
     // A dirty draft while Save is off-screen must be announced on the tab.
     { value: 'sources', label: state.dirty ? t('titleUnsaved') : t('title') },
+    { value: 'automation', label: t('automationTitle') },
     { value: 'skills', label: t('selectedSkillsTitle') },
     { value: 'components', label: withCount(t('componentsTitle'), state.components?.count) },
   ]
@@ -915,7 +1012,8 @@ function CapitalCard(props) {
         if (next === 'skills') setPinnedSkills(enabledKeys())
       },
     }),
-    panel('sources', [form, localFetchSection, automationSection]),
+    panel('sources', [form, localFetchSection]),
+    panel('automation', [automationSection]),
     panel('skills', autoMode
       ? [modeSection]
       : [modeSection, h('div', { className: 'capital-config-skills-browser' },

package/config/index.js

@@ -77,15 +77,15 @@ export const Config = z.object({
   fuyaoCredentialRef: z.string().default('FUYAO_API_KEY').volatile().description('Fuyao credentials 引用名'),
   ftshareCredentialRef: z.string().default('FTSHARE_API_KEY').volatile().description('FTShare（非凸科技）credentials 引用名'),
   automation: z.object({
-    tickMs: z.number().default(60_000).volatile().description('投研自动化调度间隔毫秒（30000–3600000）'),
-    runTimeoutMinutes: z.number().default(30).volatile().description('单次运行 wall-clock 上限分钟（5–120）'),
+    tickMs: z.number().default(60_000).volatile().description('投研自动化自动检查间隔（毫秒，30000–3600000）'),
+    runTimeoutMinutes: z.number().default(60).volatile().description('单次运行最长运行时间（分钟，5–120）'),
     idleTimeoutMinutes: z.number().default(5).volatile().description('单次运行空闲超时分钟（1–30）'),
-    maxSteps: z.number().default(300).volatile().description('单次运行最大步骤数（10–2000）'),
-    maxToolCalls: z.number().default(1_200).volatile().description('单次运行最大工具调用数（10–6000）'),
+    maxSteps: z.number().default(300).volatile().description('单次运行最大步骤数（100–2000）'),
+    maxToolCalls: z.number().default(1_200).volatile().description('单次运行最大工具调用数（100–5000）'),
     inAppNotifications: z.boolean().default(true).volatile().description('是否写入应用内通知'),
   }).default({
     tickMs: 60_000,
-    runTimeoutMinutes: 30,
+    runTimeoutMinutes: 60,
     idleTimeoutMinutes: 5,
     maxSteps: 300,
     maxToolCalls: 1_200,

package/config/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@v587d/config",
-  "version": "2.14.1",
+  "version": "2.15.1",
   "description": "自动模式的取数凭据与偏好配置行：卡片坐在 @v587d/capital-generation 插件主页的「配置」段，点这一行本身没有表单。",
   "license": "MIT",
   "type": "module",

package/lib/chart/runtime.d.ts

@@ -4,4 +4,4 @@
  * back to `globalThis.LightweightCharts` — another plugin's copy could silently win. The IIFE
  * returns `{ render, version }`; nothing is attached to globals.
  */
-export declare const CHART_RUNTIME_SOURCE = "\n(function () {\n  'use strict'\n\n  var FALLBACK = {\n    '--dsw-alias-bg-base': '#ffffff',\n    '--dsw-alias-border-l1': 'rgba(0, 0, 0, 0.10)',\n    '--dsw-alias-label-primary': '#1f2328',\n    '--dsw-alias-label-secondary': '#6b7280',\n    '--dsw-alias-brand-primary': '#2563eb',\n    '--dsw-alias-state-error-primary': '#d94a3d',\n    '--dsw-alias-state-success-primary': '#2f9e44'\n  }\n\n  // Hex colors receive alpha; other formats convert to rgba or stay unchanged, never emit invalid CSS.\n  function withAlpha(color, alpha) {\n    var text = String(color || '').trim()\n    var hex = /^#([0-9a-f]{3}|[0-9a-f]{6})$/i.exec(text)\n    if (hex) {\n      var expanded = hex[1].length === 3\n        ? '#' + hex[1].split('').map(function (part) { return part + part }).join('')\n        : text\n      return expanded + Math.round(alpha * 255).toString(16).padStart(2, '0')\n    }\n    var rgb = /^rgba?\\(\\s*([^)]*)\\)$/i.exec(text)\n    if (rgb) {\n      var parts = rgb[1].split(/[,\\s/]+/).filter(Boolean)\n      if (parts.length >= 3 && parts.slice(0, 3).every(function (part) { return /^[-+]?\\d*\\.?\\d+%?$/.test(part) })) {\n        return 'rgba(' + parts.slice(0, 3).join(', ') + ', ' + alpha + ')'\n      }\n    }\n    return text\n  }\n\n  // First series uses brand color; later series use a stable palette so one symbol keeps its color.\n  var PALETTE = ['#f59e0b', '#10b981', '#8b5cf6', '#0ea5e9', '#ec4899']\n\n  function readToken(name) {\n    try {\n      var value = getComputedStyle(document.documentElement).getPropertyValue(name)\n      if (value && value.trim().length > 0) return value.trim()\n    } catch (error) {\n      /* Non-browser or unavailable styles fall back to defaults. */\n    }\n    return FALLBACK[name]\n  }\n\n  function resolveColors() {\n    return {\n      bg: readToken('--dsw-alias-bg-base'),\n      grid: readToken('--dsw-alias-border-l1'),\n      text: readToken('--dsw-alias-label-secondary'),\n      strong: readToken('--dsw-alias-label-primary'),\n      brand: readToken('--dsw-alias-brand-primary'),\n      up: readToken('--dsw-alias-state-error-primary'),\n      down: readToken('--dsw-alias-state-success-primary')\n    }\n  }\n\n  function showError(container, message) {\n    container.textContent = ''\n    var box = document.createElement('div')\n    box.setAttribute('data-chart-error', '1')\n    box.style.cssText = 'padding:12px;border:0.5px solid ' + readToken('--dsw-alias-border-l1') + ';border-radius:8px;color:' + readToken('--dsw-alias-label-secondary') + ';font-size:13px;line-height:1.6'\n    box.textContent = message\n    container.appendChild(box)\n  }\n\n  function applyIndexLabels(chart, labels) {\n    function format(time) {\n      var key = String(time)\n      return Object.prototype.hasOwnProperty.call(labels, key) ? labels[key] : key\n    }\n    // Replace both tick and crosshair formatters for category axes or synthetic dates leak through.\n    chart.applyOptions({\n      localization: { timeFormatter: format },\n      timeScale: { tickMarkFormatter: function (time) { return format(time) } }\n    })\n  }\n\n  /** Support both v5 plugin markers and the older series API so markers never disappear silently. */\n  function attachMarkers(anchor, markers, LWC) {\n    if (typeof LWC.createSeriesMarkers === 'function') {\n      LWC.createSeriesMarkers(anchor, markers)\n      return true\n    }\n    if (anchor && typeof anchor.setMarkers === 'function') {\n      anchor.setMarkers(markers)\n      return true\n    }\n    return false\n  }\n\n  function volumePointColor(point, colors) {\n    if (point.direction === 'up') return colors.up\n    if (point.direction === 'down') return colors.down\n    return colors.brand\n  }\n\n  function seriesColor(index, colors) {\n    return index === 0 ? colors.brand : PALETTE[(index - 1) % PALETTE.length]\n  }\n\n  function appendLegend(container, payload, colors) {\n    var items = []\n    if (payload.ohlc && payload.ohlc.label) items.push({ label: payload.ohlc.label, color: colors.up })\n    if (Array.isArray(payload.series)) {\n      payload.series.forEach(function (item, index) {\n        if (item && item.label) items.push({ label: item.label, color: seriesColor(index, colors) })\n      })\n    }\n    if (payload.volume && payload.volume.label) items.push({ label: payload.volume.label, color: colors.brand })\n    if (items.length === 0) return\n\n    var legend = document.createElement('div')\n    legend.setAttribute('data-chart-legend', '1')\n    legend.style.cssText = 'position:absolute;z-index:2;top:8px;left:8px;right:8px;display:flex;flex-wrap:wrap;gap:4px 10px;align-items:center;pointer-events:none;color:' + colors.text + ';font-size:11px;line-height:16px'\n    items.forEach(function (item) {\n      var entry = document.createElement('span')\n      entry.style.cssText = 'display:inline-flex;align-items:center;gap:4px;padding:1px 5px;border-radius:4px;background:' + withAlpha(colors.bg, 0.8)\n      var swatch = document.createElement('span')\n      swatch.style.cssText = 'width:7px;height:7px;border-radius:50%;background:' + item.color + ';flex:none'\n      var label = document.createElement('span')\n      label.textContent = item.label\n      entry.appendChild(swatch)\n      entry.appendChild(label)\n      legend.appendChild(entry)\n    })\n    container.appendChild(legend)\n  }\n\n  function renderCapitalChart(container, payload, library) {\n    if (!container) throw new Error('renderCapitalChart: container is required')\n    if (!payload || typeof payload !== 'object') throw new Error('renderCapitalChart: payload is required')\n    // Use the injected library; never fall back to a global copy owned by another plugin.\n    var LWC = library\n    if (!LWC || typeof LWC.createChart !== 'function') {\n      showError(container, '\u56FE\u8868\u5E93\u672A\u52A0\u8F7D\uFF08\u8C03\u7528\u65B9\u672A\u63D0\u4F9B LightweightCharts\uFF09\u3002')\n      return null\n    }\n\n    var colors = resolveColors()\n    container.textContent = ''\n    if (container.style) container.style.position = 'relative'\n    container.setAttribute('data-chart-id', String(payload.chart_id || ''))\n    container.setAttribute('data-chart-kind', String(payload.kind || ''))\n\n    var chart = LWC.createChart(container, {\n      autoSize: true,\n      // attributionLogo stays enabled for Apache-2.0 attribution.\n      layout: { background: { color: 'transparent' }, textColor: colors.text, fontFamily: 'inherit', attributionLogo: true },\n      grid: { vertLines: { color: colors.grid }, horzLines: { color: colors.grid } },\n      rightPriceScale: { borderColor: colors.grid, entireTextOnly: true },\n      timeScale: { borderColor: colors.grid, rightOffset: 2, barSpacing: 6, minBarSpacing: 0.5 },\n      crosshair: { mode: LWC.CrosshairMode ? LWC.CrosshairMode.Normal : 0 },\n      localization: { locale: 'zh-CN' }\n    })\n\n    if (payload.axis === 'index' && payload.labels) applyIndexLabels(chart, payload.labels)\n\n    var anchor = null\n\n    if (payload.ohlc && Array.isArray(payload.ohlc.data) && payload.ohlc.data.length > 0) {\n      // kind=bar uses BarSeries; other OHLC kinds use CandlestickSeries with the same data contract.\n      var isOhlcBar = payload.kind === 'bar'\n      var candles = chart.addSeries(isOhlcBar ? LWC.BarSeries : LWC.CandlestickSeries, {\n        upColor: colors.up,\n        downColor: colors.down,\n        borderUpColor: colors.up,\n        borderDownColor: colors.down,\n        wickUpColor: colors.up,\n        wickDownColor: colors.down\n      })\n      candles.setData(payload.ohlc.data)\n      anchor = candles\n    }\n\n    if (Array.isArray(payload.series)) {\n      for (var index = 0; index < payload.series.length; index += 1) {\n        var item = payload.series[index]\n        if (!item || !Array.isArray(item.data) || item.data.length === 0) continue\n        var color = seriesColor(index, colors)\n        var options = { title: item.label || '', priceLineVisible: false, lastValueVisible: true }\n        var series = null\n        if (item.type === 'area') {\n          options.lineColor = color\n          options.topColor = withAlpha(color, 0.2)\n          options.bottomColor = withAlpha(color, 0.02)\n          options.lineWidth = 2\n          series = chart.addSeries(LWC.AreaSeries, options)\n        } else if (item.type === 'column') {\n          // Single-value histograms need HistogramSeries; BarSeries would render an empty chart.\n          options.color = color\n          options.base = 0\n          series = chart.addSeries(LWC.HistogramSeries, options)\n        } else {\n          options.color = color\n          options.lineWidth = 2\n          series = chart.addSeries(LWC.LineSeries, options)\n        }\n        series.setData(item.data)\n        if (anchor === null) anchor = series\n      }\n    }\n\n    if (payload.volume && Array.isArray(payload.volume.data) && payload.volume.data.length > 0) {\n      var volume = chart.addSeries(LWC.HistogramSeries, {\n        title: payload.volume.label || '',\n        priceFormat: { type: 'volume' },\n        priceLineVisible: false,\n        lastValueVisible: false\n      }, 1)\n      volume.setData(payload.volume.data.map(function (point) {\n        return { time: point.time, value: point.value, color: volumePointColor(point, colors) }\n      }))\n    }\n\n    if (anchor === null) {\n      showError(container, '\u8FD9\u5F20\u56FE\u6CA1\u6709\u53EF\u6E32\u67D3\u7684\u5E8F\u5217\uFF08payload \u91CC\u65E2\u6CA1\u6709 ohlc \u4E5F\u6CA1\u6709 series\uFF09\u3002')\n      return chart\n    }\n\n    if (Array.isArray(payload.markers) && payload.markers.length > 0) {\n      attachMarkers(anchor, payload.markers.map(function (marker) {\n        return { time: marker.time, position: marker.position, text: marker.text, color: colors.strong, shape: 'circle' }\n      }), LWC)\n    }\n\n    appendLegend(container, payload, colors)\n\n    // Main/volume panes use a 3:1 ratio; a single pane has no second pane object.\n    var panes = typeof chart.panes === 'function' ? chart.panes() : []\n    if (panes.length > 1) {\n      if (typeof panes[0].setStretchFactor === 'function') panes[0].setStretchFactor(3)\n      if (typeof panes[1].setStretchFactor === 'function') panes[1].setStretchFactor(1)\n    }\n\n    chart.timeScale().fitContent()\n    return chart\n  }\n\n  return { render: renderCapitalChart, version: 1 }\n})()\n";
+export declare const CHART_RUNTIME_SOURCE = "\n(function () {\n  'use strict'\n\n  var FALLBACK = {\n    '--dsw-alias-bg-base': '#ffffff',\n    '--dsw-alias-border-l1': 'rgba(0, 0, 0, 0.10)',\n    '--dsw-alias-label-primary': '#1f2328',\n    '--dsw-alias-label-secondary': '#6b7280',\n    '--dsw-alias-brand-primary': '#2563eb',\n    '--dsw-alias-state-error-primary': '#d94a3d',\n    '--dsw-alias-state-success-primary': '#2f9e44'\n  }\n\n  // Hex colors receive alpha; other formats convert to rgba or stay unchanged, never emit invalid CSS.\n  function withAlpha(color, alpha) {\n    var text = String(color || '').trim()\n    var hex = /^#([0-9a-f]{3}|[0-9a-f]{6})$/i.exec(text)\n    if (hex) {\n      var expanded = hex[1].length === 3\n        ? '#' + hex[1].split('').map(function (part) { return part + part }).join('')\n        : text\n      return expanded + Math.round(alpha * 255).toString(16).padStart(2, '0')\n    }\n    var rgb = /^rgba?\\(\\s*([^)]*)\\)$/i.exec(text)\n    if (rgb) {\n      var parts = rgb[1].split(/[,\\s/]+/).filter(Boolean)\n      if (parts.length >= 3 && parts.slice(0, 3).every(function (part) { return /^[-+]?\\d*\\.?\\d+%?$/.test(part) })) {\n        return 'rgba(' + parts.slice(0, 3).join(', ') + ', ' + alpha + ')'\n      }\n    }\n    return text\n  }\n\n  // First series uses brand color; later series use a stable palette so one symbol keeps its color.\n  var PALETTE = ['#f59e0b', '#10b981', '#8b5cf6', '#0ea5e9', '#ec4899']\n\n  function readToken(name) {\n    try {\n      var value = getComputedStyle(document.documentElement).getPropertyValue(name)\n      if (value && value.trim().length > 0) return value.trim()\n    } catch (error) {\n      /* Non-browser or unavailable styles fall back to defaults. */\n    }\n    return FALLBACK[name]\n  }\n\n  function resolveColors() {\n    return {\n      bg: readToken('--dsw-alias-bg-base'),\n      grid: readToken('--dsw-alias-border-l1'),\n      text: readToken('--dsw-alias-label-secondary'),\n      strong: readToken('--dsw-alias-label-primary'),\n      brand: readToken('--dsw-alias-brand-primary'),\n      up: readToken('--dsw-alias-state-error-primary'),\n      down: readToken('--dsw-alias-state-success-primary')\n    }\n  }\n\n  function showError(container, message) {\n    container.textContent = ''\n    var box = document.createElement('div')\n    box.setAttribute('data-chart-error', '1')\n    box.style.cssText = 'padding:12px;border:0.5px solid ' + readToken('--dsw-alias-border-l1') + ';border-radius:8px;color:' + readToken('--dsw-alias-label-secondary') + ';font-size:13px;line-height:1.6'\n    box.textContent = message\n    container.appendChild(box)\n  }\n\n  function applyIndexLabels(chart, labels) {\n    function format(time) {\n      var key = String(time)\n      return Object.prototype.hasOwnProperty.call(labels, key) ? labels[key] : key\n    }\n    // Replace both tick and crosshair formatters for category axes or synthetic dates leak through.\n    chart.applyOptions({\n      localization: { timeFormatter: format },\n      timeScale: { tickMarkFormatter: function (time) { return format(time) } }\n    })\n  }\n\n  var CHART_TIME_ZONE = 'Asia/Shanghai'\n  var CHART_DAY_SECONDS = 86400\n  var CHART_LOCAL_MIDNIGHT_UTC = 57600\n\n  function pad2(value) {\n    var text = String(value)\n    return text.length < 2 ? '0' + text : text\n  }\n\n  function timeLabel(time) {\n    if (typeof time === 'string') return time\n    if (time && typeof time === 'object') {\n      var year = time.year\n      var month = time.month\n      var day = time.day\n      if (year !== undefined && month !== undefined && day !== undefined) {\n        return String(year) + '-' + pad2(month) + '-' + pad2(day)\n      }\n    }\n    return String(time)\n  }\n\n  function collectNumericTimes(payload) {\n    var times = []\n    function add(list) {\n      if (!Array.isArray(list)) return\n      for (var i = 0; i < list.length; i += 1) {\n        var point = list[i]\n        if (point && typeof point.time === 'number' && isFinite(point.time)) times.push(point.time)\n      }\n    }\n    if (payload.ohlc) add(payload.ohlc.data)\n    if (Array.isArray(payload.series)) {\n      for (var i = 0; i < payload.series.length; i += 1) add(payload.series[i] && payload.series[i].data)\n    }\n    if (payload.volume) add(payload.volume.data)\n    return times\n  }\n\n  // Numeric epochs are true instants; render them in Asia/Shanghai. Business-day strings keep\n  // their own labels, so no formatter is applied when every point is a date string.\n  function makeTimeAxisFormatter(payload) {\n    var times = collectNumericTimes(payload)\n    if (times.length === 0) return null\n    var min = times[0]\n    var max = times[0]\n    var daily = true\n    for (var i = 0; i < times.length; i += 1) {\n      if (times[i] < min) min = times[i]\n      if (times[i] > max) max = times[i]\n      var mod = ((times[i] % CHART_DAY_SECONDS) + CHART_DAY_SECONDS) % CHART_DAY_SECONDS\n      if (mod !== 0 && mod !== CHART_LOCAL_MIDNIGHT_UTC) daily = false\n    }\n    var span = max - min\n    var formatter = new Intl.DateTimeFormat('en-CA', {\n      timeZone: CHART_TIME_ZONE,\n      year: 'numeric', month: '2-digit', day: '2-digit',\n      hour: '2-digit', minute: '2-digit', hourCycle: 'h23'\n    })\n    function parts(seconds) {\n      var values = formatter.formatToParts(new Date(seconds * 1000))\n      var out = {}\n      for (var j = 0; j < values.length; j += 1) out[values[j].type] = values[j].value\n      return out\n    }\n    function tick(time) {\n      if (typeof time !== 'number') return timeLabel(time)\n      var p = parts(time)\n      if (daily) {\n        if (span > 3 * 365 * CHART_DAY_SECONDS) return p.year\n        if (span > 120 * CHART_DAY_SECONDS) return p.year + '-' + p.month\n        return p.month + '-' + p.day\n      }\n      if (span > 2 * CHART_DAY_SECONDS) return p.month + '-' + p.day + ' ' + p.hour + ':' + p.minute\n      return p.hour + ':' + p.minute\n    }\n    function full(time) {\n      if (typeof time !== 'number') return timeLabel(time)\n      var p = parts(time)\n      return daily\n        ? p.year + '-' + p.month + '-' + p.day\n        : p.year + '-' + p.month + '-' + p.day + ' ' + p.hour + ':' + p.minute\n    }\n    return { tick: tick, full: full }\n  }\n\n  /** Support both v5 plugin markers and the older series API so markers never disappear silently. */\n  function attachMarkers(anchor, markers, LWC) {\n    if (typeof LWC.createSeriesMarkers === 'function') {\n      LWC.createSeriesMarkers(anchor, markers)\n      return true\n    }\n    if (anchor && typeof anchor.setMarkers === 'function') {\n      anchor.setMarkers(markers)\n      return true\n    }\n    return false\n  }\n\n  function volumePointColor(point, colors) {\n    if (point.direction === 'up') return colors.up\n    if (point.direction === 'down') return colors.down\n    return colors.brand\n  }\n\n  function seriesColor(index, colors) {\n    return index === 0 ? colors.brand : PALETTE[(index - 1) % PALETTE.length]\n  }\n\n  function appendLegend(container, payload, colors) {\n    var items = []\n    if (payload.ohlc && payload.ohlc.label) items.push({ label: payload.ohlc.label, color: colors.up })\n    if (Array.isArray(payload.series)) {\n      payload.series.forEach(function (item, index) {\n        if (item && item.label) items.push({ label: item.label, color: seriesColor(index, colors) })\n      })\n    }\n    if (payload.volume && payload.volume.label) items.push({ label: payload.volume.label, color: colors.brand })\n    if (items.length === 0) return\n\n    var legend = document.createElement('div')\n    legend.setAttribute('data-chart-legend', '1')\n    legend.style.cssText = 'position:absolute;z-index:2;top:8px;left:8px;right:8px;display:flex;flex-wrap:wrap;gap:4px 10px;align-items:center;pointer-events:none;color:' + colors.text + ';font-size:11px;line-height:16px'\n    items.forEach(function (item) {\n      var entry = document.createElement('span')\n      entry.style.cssText = 'display:inline-flex;align-items:center;gap:4px;padding:1px 5px;border-radius:4px;background:' + withAlpha(colors.bg, 0.8)\n      var swatch = document.createElement('span')\n      swatch.style.cssText = 'width:7px;height:7px;border-radius:50%;background:' + item.color + ';flex:none'\n      var label = document.createElement('span')\n      label.textContent = item.label\n      entry.appendChild(swatch)\n      entry.appendChild(label)\n      legend.appendChild(entry)\n    })\n    container.appendChild(legend)\n  }\n\n  function renderCapitalChart(container, payload, library) {\n    if (!container) throw new Error('renderCapitalChart: container is required')\n    if (!payload || typeof payload !== 'object') throw new Error('renderCapitalChart: payload is required')\n    // Use the injected library; never fall back to a global copy owned by another plugin.\n    var LWC = library\n    if (!LWC || typeof LWC.createChart !== 'function') {\n      showError(container, '\u56FE\u8868\u5E93\u672A\u52A0\u8F7D\uFF08\u8C03\u7528\u65B9\u672A\u63D0\u4F9B LightweightCharts\uFF09\u3002')\n      return null\n    }\n\n    var colors = resolveColors()\n    container.textContent = ''\n    if (container.style) container.style.position = 'relative'\n    container.setAttribute('data-chart-id', String(payload.chart_id || ''))\n    container.setAttribute('data-chart-kind', String(payload.kind || ''))\n\n    var chart = LWC.createChart(container, {\n      autoSize: true,\n      // attributionLogo stays enabled for Apache-2.0 attribution.\n      layout: { background: { color: 'transparent' }, textColor: colors.text, fontFamily: 'inherit', attributionLogo: true },\n      grid: { vertLines: { color: colors.grid }, horzLines: { color: colors.grid } },\n      rightPriceScale: { borderColor: colors.grid, entireTextOnly: true },\n      timeScale: { borderColor: colors.grid, rightOffset: 2, barSpacing: 6, minBarSpacing: 0.5 },\n      crosshair: { mode: LWC.CrosshairMode ? LWC.CrosshairMode.Normal : 0 },\n      localization: { locale: 'zh-CN' }\n    })\n\n    if (payload.axis === 'index' && payload.labels) applyIndexLabels(chart, payload.labels)\n    if (payload.axis === 'time') {\n      var timeAxis = makeTimeAxisFormatter(payload)\n      if (timeAxis) {\n        chart.applyOptions({\n          localization: { timeFormatter: timeAxis.full },\n          timeScale: { tickMarkFormatter: timeAxis.tick }\n        })\n      }\n    }\n\n    var anchor = null\n\n    if (payload.ohlc && Array.isArray(payload.ohlc.data) && payload.ohlc.data.length > 0) {\n      // kind=bar uses BarSeries; other OHLC kinds use CandlestickSeries with the same data contract.\n      var isOhlcBar = payload.kind === 'bar'\n      var candles = chart.addSeries(isOhlcBar ? LWC.BarSeries : LWC.CandlestickSeries, {\n        upColor: colors.up,\n        downColor: colors.down,\n        borderUpColor: colors.up,\n        borderDownColor: colors.down,\n        wickUpColor: colors.up,\n        wickDownColor: colors.down\n      })\n      candles.setData(payload.ohlc.data)\n      anchor = candles\n    }\n\n    if (Array.isArray(payload.series)) {\n      for (var index = 0; index < payload.series.length; index += 1) {\n        var item = payload.series[index]\n        if (!item || !Array.isArray(item.data) || item.data.length === 0) continue\n        var color = seriesColor(index, colors)\n        var options = { title: item.label || '', priceLineVisible: false, lastValueVisible: true }\n        var series = null\n        if (item.type === 'area') {\n          options.lineColor = color\n          options.topColor = withAlpha(color, 0.2)\n          options.bottomColor = withAlpha(color, 0.02)\n          options.lineWidth = 2\n          series = chart.addSeries(LWC.AreaSeries, options)\n        } else if (item.type === 'column') {\n          // Single-value histograms need HistogramSeries; BarSeries would render an empty chart.\n          options.color = color\n          options.base = 0\n          series = chart.addSeries(LWC.HistogramSeries, options)\n        } else {\n          options.color = color\n          options.lineWidth = 2\n          series = chart.addSeries(LWC.LineSeries, options)\n        }\n        series.setData(item.data)\n        if (anchor === null) anchor = series\n      }\n    }\n\n    if (payload.volume && Array.isArray(payload.volume.data) && payload.volume.data.length > 0) {\n      var volume = chart.addSeries(LWC.HistogramSeries, {\n        title: payload.volume.label || '',\n        priceFormat: { type: 'volume' },\n        priceLineVisible: false,\n        lastValueVisible: false\n      }, 1)\n      volume.setData(payload.volume.data.map(function (point) {\n        return { time: point.time, value: point.value, color: volumePointColor(point, colors) }\n      }))\n    }\n\n    if (anchor === null) {\n      showError(container, '\u8FD9\u5F20\u56FE\u6CA1\u6709\u53EF\u6E32\u67D3\u7684\u5E8F\u5217\uFF08payload \u91CC\u65E2\u6CA1\u6709 ohlc \u4E5F\u6CA1\u6709 series\uFF09\u3002')\n      return chart\n    }\n\n    if (Array.isArray(payload.markers) && payload.markers.length > 0) {\n      attachMarkers(anchor, payload.markers.map(function (marker) {\n        return { time: marker.time, position: marker.position, text: marker.text, color: colors.strong, shape: 'circle' }\n      }), LWC)\n    }\n\n    appendLegend(container, payload, colors)\n\n    // Main/volume panes use a 3:1 ratio; a single pane has no second pane object.\n    var panes = typeof chart.panes === 'function' ? chart.panes() : []\n    if (panes.length > 1) {\n      if (typeof panes[0].setStretchFactor === 'function') panes[0].setStretchFactor(3)\n      if (typeof panes[1].setStretchFactor === 'function') panes[1].setStretchFactor(1)\n    }\n\n    chart.timeScale().fitContent()\n    return chart\n  }\n\n  return { render: renderCapitalChart, version: 1 }\n})()\n";

package/lib/chart/runtime.js

@@ -84,6 +84,92 @@ export const CHART_RUNTIME_SOURCE = `
     })
   }
 
+  var CHART_TIME_ZONE = 'Asia/Shanghai'
+  var CHART_DAY_SECONDS = 86400
+  var CHART_LOCAL_MIDNIGHT_UTC = 57600
+
+  function pad2(value) {
+    var text = String(value)
+    return text.length < 2 ? '0' + text : text
+  }
+
+  function timeLabel(time) {
+    if (typeof time === 'string') return time
+    if (time && typeof time === 'object') {
+      var year = time.year
+      var month = time.month
+      var day = time.day
+      if (year !== undefined && month !== undefined && day !== undefined) {
+        return String(year) + '-' + pad2(month) + '-' + pad2(day)
+      }
+    }
+    return String(time)
+  }
+
+  function collectNumericTimes(payload) {
+    var times = []
+    function add(list) {
+      if (!Array.isArray(list)) return
+      for (var i = 0; i < list.length; i += 1) {
+        var point = list[i]
+        if (point && typeof point.time === 'number' && isFinite(point.time)) times.push(point.time)
+      }
+    }
+    if (payload.ohlc) add(payload.ohlc.data)
+    if (Array.isArray(payload.series)) {
+      for (var i = 0; i < payload.series.length; i += 1) add(payload.series[i] && payload.series[i].data)
+    }
+    if (payload.volume) add(payload.volume.data)
+    return times
+  }
+
+  // Numeric epochs are true instants; render them in Asia/Shanghai. Business-day strings keep
+  // their own labels, so no formatter is applied when every point is a date string.
+  function makeTimeAxisFormatter(payload) {
+    var times = collectNumericTimes(payload)
+    if (times.length === 0) return null
+    var min = times[0]
+    var max = times[0]
+    var daily = true
+    for (var i = 0; i < times.length; i += 1) {
+      if (times[i] < min) min = times[i]
+      if (times[i] > max) max = times[i]
+      var mod = ((times[i] % CHART_DAY_SECONDS) + CHART_DAY_SECONDS) % CHART_DAY_SECONDS
+      if (mod !== 0 && mod !== CHART_LOCAL_MIDNIGHT_UTC) daily = false
+    }
+    var span = max - min
+    var formatter = new Intl.DateTimeFormat('en-CA', {
+      timeZone: CHART_TIME_ZONE,
+      year: 'numeric', month: '2-digit', day: '2-digit',
+      hour: '2-digit', minute: '2-digit', hourCycle: 'h23'
+    })
+    function parts(seconds) {
+      var values = formatter.formatToParts(new Date(seconds * 1000))
+      var out = {}
+      for (var j = 0; j < values.length; j += 1) out[values[j].type] = values[j].value
+      return out
+    }
+    function tick(time) {
+      if (typeof time !== 'number') return timeLabel(time)
+      var p = parts(time)
+      if (daily) {
+        if (span > 3 * 365 * CHART_DAY_SECONDS) return p.year
+        if (span > 120 * CHART_DAY_SECONDS) return p.year + '-' + p.month
+        return p.month + '-' + p.day
+      }
+      if (span > 2 * CHART_DAY_SECONDS) return p.month + '-' + p.day + ' ' + p.hour + ':' + p.minute
+      return p.hour + ':' + p.minute
+    }
+    function full(time) {
+      if (typeof time !== 'number') return timeLabel(time)
+      var p = parts(time)
+      return daily
+        ? p.year + '-' + p.month + '-' + p.day
+        : p.year + '-' + p.month + '-' + p.day + ' ' + p.hour + ':' + p.minute
+    }
+    return { tick: tick, full: full }
+  }
+
   /** Support both v5 plugin markers and the older series API so markers never disappear silently. */
   function attachMarkers(anchor, markers, LWC) {
     if (typeof LWC.createSeriesMarkers === 'function') {
@@ -163,6 +249,15 @@ export const CHART_RUNTIME_SOURCE = `
     })
 
     if (payload.axis === 'index' && payload.labels) applyIndexLabels(chart, payload.labels)
+    if (payload.axis === 'time') {
+      var timeAxis = makeTimeAxisFormatter(payload)
+      if (timeAxis) {
+        chart.applyOptions({
+          localization: { timeFormatter: timeAxis.full },
+          timeScale: { tickMarkFormatter: timeAxis.tick }
+        })
+      }
+    }
 
     var anchor = null
 

package/lib/chart/series.d.ts

@@ -68,16 +68,16 @@ export declare function extractRows(value: unknown): {
     shape: string;
 };
 interface ParsedTime {
-    /** Value handed to the library: 'YYYY-MM-DD' business day, or UTC seconds. */
+    /** Value handed to the library: 'YYYY-MM-DD' business day, or epoch seconds. */
     display: string | number;
-    /** Comparison key (UTC seconds) for sort/filter/alignment. */
+    /** Comparison key (epoch seconds); date-only and naive datetime values use Asia/Shanghai. */
     seconds: number;
     /** True when the value came from a date-only string; decides business-day rendering. */
     dateOnly: boolean;
 }
 /**
- * Deterministic across machines: date-only stays a business-day string (no TZ shift), naive
- * datetime is UTC, numbers >= 1e11 are epoch ms, unparseable means the row has no time.
+ * Deterministic across machines: date-only is an Asia/Shanghai calendar day, naive datetime is
+ * Asia/Shanghai wall clock, numbers >= 1e11 are epoch ms, unparseable means the row has no time.
  */
 export declare function parseTimeValue(value: unknown): ParsedTime | undefined;
 export interface BuildChartPayloadInput {

package/lib/chart/series.js

@@ -17,6 +17,8 @@ const INDEX_EPOCH_SECONDS = Date.UTC(2000, 0, 1) / 1000;
 const SECONDS_PER_DAY = 86_400;
 /** Values >= 1e11 are epoch ms (1e11 seconds is year 5138). */
 const MILLISECONDS_THRESHOLD = 1e11;
+/** Chart convention: data timestamps are Asia/Shanghai wall clock; UTC+8 has no DST for supported dates. */
+const CHART_UTC_OFFSET_MS = 8 * 3_600_000;
 function isRecord(value) {
     return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
 }
@@ -89,9 +91,24 @@ function toNumber(value) {
 }
 const DATE_ONLY = /^(\d{4})-(\d{2})-(\d{2})$/;
 const DATE_TIME = /^(\d{4})-(\d{2})-(\d{2})[ T](\d{2}):(\d{2})(?::(\d{2}))?(?:\.\d+)?(Z|[+-]\d{2}:?\d{2})?$/;
+/** Calendar-valid UTC midnight, or undefined for 2025-02-30 style input. */
+function calendarUtcMs(year, month, day) {
+    const utc = Date.UTC(year, month - 1, day);
+    const check = new Date(utc);
+    if (check.getUTCFullYear() !== year || check.getUTCMonth() + 1 !== month || check.getUTCDate() !== day)
+        return undefined;
+    return utc;
+}
+/** Asia/Shanghai wall clock to epoch ms; fixed offset matches every supported market date. */
+function shanghaiEpochMs(year, month, day, hour, minute, second) {
+    const utc = calendarUtcMs(year, month, day);
+    if (utc === undefined)
+        return undefined;
+    return utc - CHART_UTC_OFFSET_MS + hour * 3_600_000 + minute * 60_000 + second * 1000;
+}
 /**
- * Deterministic across machines: date-only stays a business-day string (no TZ shift), naive
- * datetime is UTC, numbers >= 1e11 are epoch ms, unparseable means the row has no time.
+ * Deterministic across machines: date-only is an Asia/Shanghai calendar day, naive datetime is
+ * Asia/Shanghai wall clock, numbers >= 1e11 are epoch ms, unparseable means the row has no time.
  */
 export function parseTimeValue(value) {
     if (typeof value === 'number') {
@@ -110,16 +127,26 @@ export function parseTimeValue(value) {
         const year = Number(dateOnly[1]);
         const month = Number(dateOnly[2]);
         const day = Number(dateOnly[3]);
-        const check = new Date(Date.UTC(year, month - 1, day));
-        if (check.getUTCFullYear() !== year || check.getUTCMonth() + 1 !== month || check.getUTCDate() !== day)
+        const epoch = shanghaiEpochMs(year, month, day, 0, 0, 0);
+        if (epoch === undefined)
             return undefined;
-        return { display: text, seconds: Math.round(check.getTime() / 1000), dateOnly: true };
+        return { display: text, seconds: Math.round(epoch / 1000), dateOnly: true };
     }
     const dateTime = DATE_TIME.exec(text);
     if (dateTime) {
-        const normalized = `${dateTime[1]}-${dateTime[2]}-${dateTime[3]}T${dateTime[4]}:${dateTime[5]}:${dateTime[6] ?? '00'}${dateTime[7] ?? 'Z'}`;
-        const parsed = Date.parse(normalized);
-        if (!Number.isFinite(parsed))
+        const year = Number(dateTime[1]);
+        const month = Number(dateTime[2]);
+        const day = Number(dateTime[3]);
+        const hour = Number(dateTime[4]);
+        const minute = Number(dateTime[5]);
+        const second = Number(dateTime[6] ?? '00');
+        if (calendarUtcMs(year, month, day) === undefined)
+            return undefined;
+        // An explicit Z/offset is an instant; a timezone-less value is Asia/Shanghai wall clock.
+        const parsed = dateTime[7] === undefined
+            ? shanghaiEpochMs(year, month, day, hour, minute, second)
+            : Date.parse(`${dateTime[1]}-${dateTime[2]}-${dateTime[3]}T${dateTime[4]}:${dateTime[5]}:${dateTime[6] ?? '00'}${dateTime[7]}`);
+        if (parsed === undefined || !Number.isFinite(parsed))
             return undefined;
         return { display: Math.round(parsed / 1000), seconds: Math.round(parsed / 1000), dateOnly: false };
     }
@@ -130,6 +157,13 @@ export function parseTimeValue(value) {
         return undefined;
     return { display: Math.round(parsed / 1000), seconds: Math.round(parsed / 1000), dateOnly: false };
 }
+/** `to` on a date-only bound includes the whole Asia/Shanghai calendar day, not just midnight. */
+function rangeBound(value, edge) {
+    const parsed = parseTimeValue(value);
+    if (parsed === undefined)
+        return undefined;
+    return parsed.dateOnly && edge === 'to' ? parsed.seconds + SECONDS_PER_DAY - 1 : parsed.seconds;
+}
 export function buildChartPayload(input) {
     const { spec } = input;
     const warnings = [];
@@ -204,8 +238,8 @@ export function buildChartPayload(input) {
         if (axis === 'index') {
             throw new ChartError('chart_spec_invalid', 'spec.range requires a time axis; remove range for category data or provide a parseable time field in spec.x');
         }
-        const from = spec.range.from === undefined ? undefined : parseTimeValue(spec.range.from)?.seconds;
-        const to = spec.range.to === undefined ? undefined : parseTimeValue(spec.range.to)?.seconds;
+        const from = spec.range.from === undefined ? undefined : rangeBound(spec.range.from, 'from');
+        const to = spec.range.to === undefined ? undefined : rangeBound(spec.range.to, 'to');
         if (spec.range.from !== undefined && from === undefined)
             throw new ChartError('chart_spec_invalid', 'spec.range.from is not a recognizable date');
         if (spec.range.to !== undefined && to === undefined)