[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6HY7BKJMV6QVQJ32P6K7EF4":3,"skill-same:01M6HY7BKJMV6QVQJ32P6K7EF4":83},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":23,"publishedAt":44,"linkOnly":45,"markdownContent":46,"markdownBody":47,"frontMatter":48,"refName":49,"commitSha":50,"skillDirectory":51,"forksCount":52,"repositoryHtmlUrl":53,"repositoryHomepageUrl":6,"ownerHtmlUrl":54,"ownerBlogUrl":55,"ownerDescription":6,"updatedAt":56,"install":57,"resources":70},"01M6HY7BKJMV6QVQJ32P6K7EF4","panel-component-xss-safe",null,"Create a dashboard panel component using vanilla TypeScript DOM API, following the worldmonitor Panel architecture. Panels have a header with title\u002Fcount, scrollable content area, loading\u002Ferror states, and resize handles. Includes XSS-safe rendering pattern with esc() helper for safely interpolating untrusted external API data into innerHTML.","HKUDS\u002FAgentPilot","HKUDS","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F118165258?v=4","01M6HW8VRNZP64G0P4MVJW2KKQ","✨Data Intelligence Lab@HKU✨","01M6HW8VWZVHBRHYH3T330PFWV",8029,"MIT","https:\u002F\u002Fgithub.com\u002FHKUDS\u002FAgentPilot\u002Fblob\u002Fmain\u002Fopenspace\u002Flegacy\u002Fv1\u002Fshowcase\u002Fskills\u002Fpanel-component-xss-safe\u002FSKILL.md",[18],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000033","数据分析师","PROFESSION","适用职业",[24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43],"panel component","component","panel component xss safe","xss","panel","safe","error","external api","for","dom","with","loading","states","helper","panels","worldmonitor","api","create","architecture","dashboard","2026-11-10 10:12:30",false,"---\nname: panel-component-xss-safe\ndescription: Create a dashboard panel component using vanilla TypeScript DOM API, following the worldmonitor Panel architecture. Panels have a header with title\u002Fcount, scrollable content area, loading\u002Ferror states, and resize handles. Includes XSS-safe rendering pattern with esc() helper for safely interpolating untrusted external API data into innerHTML.\n---\n\n# Panel Component Pattern (XSS-Safe)\n\nCreate dashboard panel components using **vanilla TypeScript** (no framework, no JSX). Each panel is a class extending a `Panel` base class.\n\n> **Security note:** Panels that consume external API data (calendar events, news feeds, stock names, user-supplied content, etc.) MUST escape all untrusted values before injecting them into `innerHTML`. Use the `esc()` helper documented below.\n\n## Architecture Overview\n\n```\nPanel (base class)\n├── element: HTMLElement (outer container, .panel)\n│   ├── header: HTMLElement (.panel-header)\n│   │   ├── headerLeft (.panel-header-left)\n│   │   │   ├── title (.panel-title)\n│   │   │   └── newBadge (.panel-new-badge) [optional]\n│   │   ├── statusBadge (.panel-data-badge) [optional]\n│   │   └── countEl (.panel-count) [optional]\n│   ├── content: HTMLElement (.panel-content)\n│   └── resizeHandle (.panel-resize-handle)\n```\n\n## XSS-Safe Rendering: the `esc()` Helper\n\n**Always use `esc()` when interpolating untrusted data into an HTML string.**  \nUntrusted data includes anything from external APIs: event titles, locations, URLs, names, descriptions, symbols, etc.\n\nCreate `src\u002Futils\u002Fesc.ts`:\n\n```typescript\n\u002F**\n * Escapes a value for safe interpolation into an innerHTML string.\n * Converts &, \u003C, >, \", and ' to their HTML entity equivalents.\n *\n * Usage:\n *   this.setContent(`\u003Cdiv class=\"title\">${esc(item.title)}\u003C\u002Fdiv>`);\n *\n * Do NOT use for:\n *   - href\u002Fsrc attributes with user-controlled URLs — validate scheme instead\n *   - CSS values — use a separate sanitizer\n *\u002F\nexport function esc(value: unknown): string {\n  return String(value ?? '')\n    .replace(\u002F&\u002Fg, '&amp;')\n    .replace(\u002F\u003C\u002Fg, '&lt;')\n    .replace(\u002F>\u002Fg, '&gt;')\n    .replace(\u002F\"\u002Fg, '&quot;')\n    .replace(\u002F'\u002Fg, '&#39;');\n}\n```\n\n### When to use `esc()`\n\n| Data source | Safe? | Action |\n|---|---|---|\n| Hardcoded string literal in source | ✅ Safe | No escaping needed |\n| Enum \u002F controlled constant | ✅ Safe | No escaping needed |\n| External API string field (title, name, body…) | ❌ Unsafe | **Use `esc()`** |\n| User input \u002F localStorage value | ❌ Unsafe | **Use `esc()`** |\n| Number\u002Fboolean (rendered as text) | ✅ Safe | `String(n)` is fine |\n| URL from external API | ⚠️ Unsafe | Validate scheme + `esc()` |\n\n### URL Safety\n\nFor URLs from external sources, validate the scheme before injecting:\n\n```typescript\n\u002F** Returns the URL only if it uses http or https; otherwise returns '#'. *\u002F\nexport function safeUrl(raw: unknown): string {\n  const s = String(raw ?? '').trim();\n  return \u002F^https?:\\\u002F\\\u002F\u002Fi.test(s) ? s : '#';\n}\n```\n\nUsage: `\u003Ca href=\"${safeUrl(item.url)}\">${esc(item.title)}\u003C\u002Fa>`\n\n---\n\n## Base Panel Class\n\nCreate `src\u002Fcomponents\u002FPanel.ts`:\n\n```typescript\nexport interface PanelOptions {\n  id: string;\n  title: string;\n  showCount?: boolean;\n  className?: string;\n}\n\nexport class Panel {\n  protected element: HTMLElement;\n  protected content: HTMLElement;\n  protected header: HTMLElement;\n  protected countEl: HTMLElement | null = null;\n  protected panelId: string;\n  private _fetching = false;\n\n  constructor(options: PanelOptions) {\n    this.panelId = options.id;\n    this.element = document.createElement('div');\n    this.element.className = `panel ${options.className || ''}`;\n    this.element.dataset.panel = options.id;\n\n    \u002F\u002F Header\n    this.header = document.createElement('div');\n    this.header.className = 'panel-header';\n\n    const headerLeft = document.createElement('div');\n    headerLeft.className = 'panel-header-left';\n\n    const title = document.createElement('span');\n    title.className = 'panel-title';\n    title.textContent = options.title;  \u002F\u002F textContent is always safe\n    headerLeft.appendChild(title);\n    this.header.appendChild(headerLeft);\n\n    \u002F\u002F Count badge (optional)\n    if (options.showCount) {\n      this.countEl = document.createElement('span');\n      this.countEl.className = 'panel-count';\n      this.countEl.textContent = '0';\n      this.header.appendChild(this.countEl);\n    }\n\n    \u002F\u002F Content area\n    this.content = document.createElement('div');\n    this.content.className = 'panel-content';\n    this.content.id = `${options.id}Content`;\n\n    this.element.appendChild(this.header);\n    this.element.appendChild(this.content);\n    this.showLoading();\n  }\n\n  public getElement(): HTMLElement { return this.element; }\n\n  public showLoading(message = 'Loading...'): void {\n    \u002F\u002F message is a hardcoded string — no escaping needed here\n    this.content.innerHTML = `\n      \u003Cdiv class=\"panel-loading\">\n        \u003Cdiv class=\"panel-loading-spinner\">\u003C\u002Fdiv>\n        \u003Cdiv class=\"panel-loading-text\">${message}\u003C\u002Fdiv>\n      \u003C\u002Fdiv>`;\n  }\n\n  public showError(message = 'Failed to load', onRetry?: () => void): void {\n    \u002F\u002F message is a hardcoded string — no escaping needed here\n    this.content.innerHTML = `\n      \u003Cdiv class=\"panel-error-state\">\n        \u003Cdiv class=\"panel-error-msg\">${message}\u003C\u002Fdiv>\n        ${onRetry ? '\u003Cbutton class=\"panel-retry-btn\" data-panel-retry>Retry\u003C\u002Fbutton>' : ''}\n      \u003C\u002Fdiv>`;\n    if (onRetry) {\n      this.content.querySelector('[data-panel-retry]')?.addEventListener('click', onRetry);\n    }\n  }\n\n  public setContent(html: string): void {\n    this.content.innerHTML = html;\n  }\n\n  public setCount(count: number): void {\n    if (this.countEl) this.countEl.textContent = count.toString();\n  }\n\n  public show(): void { this.element.classList.remove('hidden'); }\n  public hide(): void { this.element.classList.add('hidden'); }\n\n  protected setFetching(v: boolean): void { this._fetching = v; }\n  protected get isFetching(): boolean { return this._fetching; }\n\n  public destroy(): void {\n    this.element.remove();\n  }\n}\n```\n\n---\n\n## Creating a Concrete Panel (Example: StockPanel — XSS-safe)\n\nImport `esc` and wrap every API-derived string field:\n\n```typescript\nimport { Panel } from '.\u002FPanel';\nimport { esc } from '..\u002Futils\u002Fesc';\n\ninterface StockQuote {\n  symbol: string;\n  name: string;\n  price: number | null;\n  change: number | null;\n  sparkline?: number[];\n}\n\nexport class StockPanel extends Panel {\n  private refreshTimer: ReturnType\u003Ctypeof setInterval> | null = null;\n\n  constructor() {\n    super({ id: 'stocks', title: 'Stock Market', showCount: true });\n    this.fetchData();\n    this.refreshTimer = setInterval(() => this.fetchData(), 60_000);\n  }\n\n  private async fetchData(): Promise\u003Cvoid> {\n    if (this.isFetching) return;\n    this.setFetching(true);\n    try {\n      const quotes = await fetchStockQuotes(); \u002F\u002F from data-service\n      this.render(quotes);\n      this.setCount(quotes.length);\n    } catch (err) {\n      this.showError('Failed to load stock data', () => this.fetchData());\n    } finally {\n      this.setFetching(false);\n    }\n  }\n\n  private render(quotes: StockQuote[]): void {\n    const rows = quotes.map(q => `\n      \u003Cdiv class=\"stock-row\">\n        \u003Cspan class=\"stock-symbol\">${esc(q.symbol)}\u003C\u002Fspan>\n        \u003Cspan class=\"stock-name\">${esc(q.name)}\u003C\u002Fspan>\n        \u003Cspan class=\"stock-price\">${q.price != null ? '$' + q.price.toFixed(2) : '&mdash;'}\u003C\u002Fspan>\n        \u003Cspan class=\"stock-change ${(q.change ?? 0) >= 0 ? 'positive' : 'negative'}\">\n          ${q.change != null ? (q.change >= 0 ? '+' : '') + q.change.toFixed(2) + '%' : '&mdash;'}\n        \u003C\u002Fspan>\n      \u003C\u002Fdiv>\n    `).join('');\n    \u002F\u002F                ^^^         ^^^\n    \u002F\u002F symbol and name come from an external API — always escape them.\n    \u002F\u002F price and change are numbers rendered via .toFixed() — safe without esc().\n\n    this.setContent(`\u003Cdiv class=\"stock-list\">${rows}\u003C\u002Fdiv>`);\n  }\n\n  public override destroy(): void {\n    if (this.refreshTimer) clearInterval(this.refreshTimer);\n    super.destroy();\n  }\n}\n```\n\n## Creating a Concrete Panel (Example: EventPanel — calendar\u002Fnews data)\n\nCalendar and news panels are highest-risk because titles, locations, and URLs all come from untrusted sources:\n\n```typescript\nimport { Panel } from '.\u002FPanel';\nimport { esc, safeUrl } from '..\u002Futils\u002Fesc';\n\ninterface CalendarEvent {\n  id: string;\n  title: string;       \u002F\u002F untrusted — user-created content\n  location?: string;   \u002F\u002F untrusted\n  url?: string;        \u002F\u002F untrusted — must validate scheme\n  startTime: Date;\n}\n\nexport class SchedulePanel extends Panel {\n  private refreshTimer: ReturnType\u003Ctypeof setInterval> | null = null;\n\n  constructor() {\n    super({ id: 'schedule', title: \"Today's Schedule\", showCount: true });\n    this.fetchData();\n    this.refreshTimer = setInterval(() => this.fetchData(), 5 * 60_000);\n  }\n\n  private async fetchData(): Promise\u003Cvoid> {\n    if (this.isFetching) return;\n    this.setFetching(true);\n    try {\n      const events = await fetchCalendarEvents();\n      this.render(events);\n      this.setCount(events.length);\n    } catch (err) {\n      this.showError('Failed to load calendar', () => this.fetchData());\n    } finally {\n      this.setFetching(false);\n    }\n  }\n\n  private render(events: CalendarEvent[]): void {\n    if (events.length === 0) {\n      this.setContent('\u003Cdiv class=\"schedule-empty\">No events today\u003C\u002Fdiv>');\n      return;\n    }\n\n    const rows = events.map(ev => `\n      \u003Cdiv class=\"schedule-row\">\n        \u003Cspan class=\"schedule-time\">${esc(formatTime(ev.startTime))}\u003C\u002Fspan>\n        \u003Cspan class=\"schedule-title\">\n          ${ev.url\n            ? `\u003Ca href=\"${safeUrl(ev.url)}\" target=\"_blank\" rel=\"noopener noreferrer\">${esc(ev.title)}\u003C\u002Fa>`\n            : esc(ev.title)\n          }\n        \u003C\u002Fspan>\n        ${ev.location ? `\u003Cspan class=\"schedule-location\">${esc(ev.location)}\u003C\u002Fspan>` : ''}\n      \u003C\u002Fdiv>\n    `).join('');\n    \u002F\u002F              ^^^              ^^^              ^^^\n    \u002F\u002F title, location, url — ALL from external API, ALL escaped.\n    \u002F\u002F safeUrl() prevents javascript: \u002F data: scheme injection in href.\n\n    this.setContent(`\u003Cdiv class=\"schedule-list\">${rows}\u003C\u002Fdiv>`);\n  }\n\n  public override destroy(): void {\n    if (this.refreshTimer) clearInterval(this.refreshTimer);\n    super.destroy();\n  }\n}\n```\n\n---\n\n## Key Patterns\n\n1. **Constructor** calls `super()` with panel config, then triggers initial data fetch\n2. **fetchData()** is async, uses `isFetching` guard, shows error on failure with retry\n3. **render()** builds HTML strings with `esc()` around every API-derived string, then calls `this.setContent(html)`\n4. **destroy()** cleans up timers and event listeners\n5. Use `showLoading()` during initial load (auto-called in constructor)\n6. Use `showError(msg, retryFn)` on failure — `msg` should be a hardcoded string, not API data\n7. **Import `esc` from `..\u002Futils\u002Fesc`** in every panel that consumes external data\n8. Numbers and booleans rendered via `.toFixed()` \u002F `.toString()` \u002F template arithmetic are safe — no `esc()` needed\n9. Use `textContent` instead of `innerHTML` for single text nodes when convenient — it is always safe\n\n## Sparkline Utility\n\nSparklines use computed numbers only — no escaping needed:\n\n```typescript\nexport function miniSparkline(data: number[] | undefined, change: number | null, w = 50, h = 16): string {\n  if (!data || data.length \u003C 2) return '';\n  const min = Math.min(...data);\n  const max = Math.max(...data);\n  const range = max - min || 1;\n  const color = change != null && change >= 0 ? 'var(--green)' : 'var(--red)';\n  const points = data.map((v, i) => {\n    const x = (i \u002F (data.length - 1)) * w;\n    const y = h - ((v - min) \u002F range) * (h - 2) - 1;\n    return `${x.toFixed(1)},${y.toFixed(1)}`;\n  }).join(' ');\n  return `\u003Csvg width=\"${w}\" height=\"${h}\" viewBox=\"0 0 ${w} ${h}\">\u003Cpolyline points=\"${points}\" fill=\"none\" stroke=\"${color}\" stroke-width=\"1.2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"\u002F>\u003C\u002Fsvg>`;\n}\n```\n\n---\n\n## Checklist Before Submitting a Panel\n\n- [ ] Every `string` field from an external API is wrapped in `esc()` before HTML interpolation\n- [ ] Every URL from an external API is passed through `safeUrl()` before use in `href`\u002F`src`\n- [ ] `showError()` is only called with hardcoded messages (never raw API error bodies)\n- [ ] `esc` and `safeUrl` are imported from `src\u002Futils\u002Fesc`\n- [ ] Numbers \u002F computed values rendered with `.toFixed()` or arithmetic are left unwrapped (they cannot contain HTML)\n","# Panel Component Pattern (XSS-Safe)\n\nCreate dashboard panel components using **vanilla TypeScript** (no framework, no JSX). Each panel is a class extending a `Panel` base class.\n\n> **Security note:** Panels that consume external API data (calendar events, news feeds, stock names, user-supplied content, etc.) MUST escape all untrusted values before injecting them into `innerHTML`. Use the `esc()` helper documented below.\n\n## Architecture Overview\n\n```\nPanel (base class)\n├── element: HTMLElement (outer container, .panel)\n│   ├── header: HTMLElement (.panel-header)\n│   │   ├── headerLeft (.panel-header-left)\n│   │   │   ├── title (.panel-title)\n│   │   │   └── newBadge (.panel-new-badge) [optional]\n│   │   ├── statusBadge (.panel-data-badge) [optional]\n│   │   └── countEl (.panel-count) [optional]\n│   ├── content: HTMLElement (.panel-content)\n│   └── resizeHandle (.panel-resize-handle)\n```\n\n## XSS-Safe Rendering: the `esc()` Helper\n\n**Always use `esc()` when interpolating untrusted data into an HTML string.**  \nUntrusted data includes anything from external APIs: event titles, locations, URLs, names, descriptions, symbols, etc.\n\nCreate `src\u002Futils\u002Fesc.ts`:\n\n```typescript\n\u002F**\n * Escapes a value for safe interpolation into an innerHTML string.\n * Converts &, \u003C, >, \", and ' to their HTML entity equivalents.\n *\n * Usage:\n *   this.setContent(`\u003Cdiv class=\"title\">${esc(item.title)}\u003C\u002Fdiv>`);\n *\n * Do NOT use for:\n *   - href\u002Fsrc attributes with user-controlled URLs — validate scheme instead\n *   - CSS values — use a separate sanitizer\n *\u002F\nexport function esc(value: unknown): string {\n  return String(value ?? '')\n    .replace(\u002F&\u002Fg, '&amp;')\n    .replace(\u002F\u003C\u002Fg, '&lt;')\n    .replace(\u002F>\u002Fg, '&gt;')\n    .replace(\u002F\"\u002Fg, '&quot;')\n    .replace(\u002F'\u002Fg, '&#39;');\n}\n```\n\n### When to use `esc()`\n\n| Data source | Safe? | Action |\n|---|---|---|\n| Hardcoded string literal in source | ✅ Safe | No escaping needed |\n| Enum \u002F controlled constant | ✅ Safe | No escaping needed |\n| External API string field (title, name, body…) | ❌ Unsafe | **Use `esc()`** |\n| User input \u002F localStorage value | ❌ Unsafe | **Use `esc()`** |\n| Number\u002Fboolean (rendered as text) | ✅ Safe | `String(n)` is fine |\n| URL from external API | ⚠️ Unsafe | Validate scheme + `esc()` |\n\n### URL Safety\n\nFor URLs from external sources, validate the scheme before injecting:\n\n```typescript\n\u002F** Returns the URL only if it uses http or https; otherwise returns '#'. *\u002F\nexport function safeUrl(raw: unknown): string {\n  const s = String(raw ?? '').trim();\n  return \u002F^https?:\\\u002F\\\u002F\u002Fi.test(s) ? s : '#';\n}\n```\n\nUsage: `\u003Ca href=\"${safeUrl(item.url)}\">${esc(item.title)}\u003C\u002Fa>`\n\n---\n\n## Base Panel Class\n\nCreate `src\u002Fcomponents\u002FPanel.ts`:\n\n```typescript\nexport interface PanelOptions {\n  id: string;\n  title: string;\n  showCount?: boolean;\n  className?: string;\n}\n\nexport class Panel {\n  protected element: HTMLElement;\n  protected content: HTMLElement;\n  protected header: HTMLElement;\n  protected countEl: HTMLElement | null = null;\n  protected panelId: string;\n  private _fetching = false;\n\n  constructor(options: PanelOptions) {\n    this.panelId = options.id;\n    this.element = document.createElement('div');\n    this.element.className = `panel ${options.className || ''}`;\n    this.element.dataset.panel = options.id;\n\n    \u002F\u002F Header\n    this.header = document.createElement('div');\n    this.header.className = 'panel-header';\n\n    const headerLeft = document.createElement('div');\n    headerLeft.className = 'panel-header-left';\n\n    const title = document.createElement('span');\n    title.className = 'panel-title';\n    title.textContent = options.title;  \u002F\u002F textContent is always safe\n    headerLeft.appendChild(title);\n    this.header.appendChild(headerLeft);\n\n    \u002F\u002F Count badge (optional)\n    if (options.showCount) {\n      this.countEl = document.createElement('span');\n      this.countEl.className = 'panel-count';\n      this.countEl.textContent = '0';\n      this.header.appendChild(this.countEl);\n    }\n\n    \u002F\u002F Content area\n    this.content = document.createElement('div');\n    this.content.className = 'panel-content';\n    this.content.id = `${options.id}Content`;\n\n    this.element.appendChild(this.header);\n    this.element.appendChild(this.content);\n    this.showLoading();\n  }\n\n  public getElement(): HTMLElement { return this.element; }\n\n  public showLoading(message = 'Loading...'): void {\n    \u002F\u002F message is a hardcoded string — no escaping needed here\n    this.content.innerHTML = `\n      \u003Cdiv class=\"panel-loading\">\n        \u003Cdiv class=\"panel-loading-spinner\">\u003C\u002Fdiv>\n        \u003Cdiv class=\"panel-loading-text\">${message}\u003C\u002Fdiv>\n      \u003C\u002Fdiv>`;\n  }\n\n  public showError(message = 'Failed to load', onRetry?: () => void): void {\n    \u002F\u002F message is a hardcoded string — no escaping needed here\n    this.content.innerHTML = `\n      \u003Cdiv class=\"panel-error-state\">\n        \u003Cdiv class=\"panel-error-msg\">${message}\u003C\u002Fdiv>\n        ${onRetry ? '\u003Cbutton class=\"panel-retry-btn\" data-panel-retry>Retry\u003C\u002Fbutton>' : ''}\n      \u003C\u002Fdiv>`;\n    if (onRetry) {\n      this.content.querySelector('[data-panel-retry]')?.addEventListener('click', onRetry);\n    }\n  }\n\n  public setContent(html: string): void {\n    this.content.innerHTML = html;\n  }\n\n  public setCount(count: number): void {\n    if (this.countEl) this.countEl.textContent = count.toString();\n  }\n\n  public show(): void { this.element.classList.remove('hidden'); }\n  public hide(): void { this.element.classList.add('hidden'); }\n\n  protected setFetching(v: boolean): void { this._fetching = v; }\n  protected get isFetching(): boolean { return this._fetching; }\n\n  public destroy(): void {\n    this.element.remove();\n  }\n}\n```\n\n---\n\n## Creating a Concrete Panel (Example: StockPanel — XSS-safe)\n\nImport `esc` and wrap every API-derived string field:\n\n```typescript\nimport { Panel } from '.\u002FPanel';\nimport { esc } from '..\u002Futils\u002Fesc';\n\ninterface StockQuote {\n  symbol: string;\n  name: string;\n  price: number | null;\n  change: number | null;\n  sparkline?: number[];\n}\n\nexport class StockPanel extends Panel {\n  private refreshTimer: ReturnType\u003Ctypeof setInterval> | null = null;\n\n  constructor() {\n    super({ id: 'stocks', title: 'Stock Market', showCount: true });\n    this.fetchData();\n    this.refreshTimer = setInterval(() => this.fetchData(), 60_000);\n  }\n\n  private async fetchData(): Promise\u003Cvoid> {\n    if (this.isFetching) return;\n    this.setFetching(true);\n    try {\n      const quotes = await fetchStockQuotes(); \u002F\u002F from data-service\n      this.render(quotes);\n      this.setCount(quotes.length);\n    } catch (err) {\n      this.showError('Failed to load stock data', () => this.fetchData());\n    } finally {\n      this.setFetching(false);\n    }\n  }\n\n  private render(quotes: StockQuote[]): void {\n    const rows = quotes.map(q => `\n      \u003Cdiv class=\"stock-row\">\n        \u003Cspan class=\"stock-symbol\">${esc(q.symbol)}\u003C\u002Fspan>\n        \u003Cspan class=\"stock-name\">${esc(q.name)}\u003C\u002Fspan>\n        \u003Cspan class=\"stock-price\">${q.price != null ? '$' + q.price.toFixed(2) : '&mdash;'}\u003C\u002Fspan>\n        \u003Cspan class=\"stock-change ${(q.change ?? 0) >= 0 ? 'positive' : 'negative'}\">\n          ${q.change != null ? (q.change >= 0 ? '+' : '') + q.change.toFixed(2) + '%' : '&mdash;'}\n        \u003C\u002Fspan>\n      \u003C\u002Fdiv>\n    `).join('');\n    \u002F\u002F                ^^^         ^^^\n    \u002F\u002F symbol and name come from an external API — always escape them.\n    \u002F\u002F price and change are numbers rendered via .toFixed() — safe without esc().\n\n    this.setContent(`\u003Cdiv class=\"stock-list\">${rows}\u003C\u002Fdiv>`);\n  }\n\n  public override destroy(): void {\n    if (this.refreshTimer) clearInterval(this.refreshTimer);\n    super.destroy();\n  }\n}\n```\n\n## Creating a Concrete Panel (Example: EventPanel — calendar\u002Fnews data)\n\nCalendar and news panels are highest-risk because titles, locations, and URLs all come from untrusted sources:\n\n```typescript\nimport { Panel } from '.\u002FPanel';\nimport { esc, safeUrl } from '..\u002Futils\u002Fesc';\n\ninterface CalendarEvent {\n  id: string;\n  title: string;       \u002F\u002F untrusted — user-created content\n  location?: string;   \u002F\u002F untrusted\n  url?: string;        \u002F\u002F untrusted — must validate scheme\n  startTime: Date;\n}\n\nexport class SchedulePanel extends Panel {\n  private refreshTimer: ReturnType\u003Ctypeof setInterval> | null = null;\n\n  constructor() {\n    super({ id: 'schedule', title: \"Today's Schedule\", showCount: true });\n    this.fetchData();\n    this.refreshTimer = setInterval(() => this.fetchData(), 5 * 60_000);\n  }\n\n  private async fetchData(): Promise\u003Cvoid> {\n    if (this.isFetching) return;\n    this.setFetching(true);\n    try {\n      const events = await fetchCalendarEvents();\n      this.render(events);\n      this.setCount(events.length);\n    } catch (err) {\n      this.showError('Failed to load calendar', () => this.fetchData());\n    } finally {\n      this.setFetching(false);\n    }\n  }\n\n  private render(events: CalendarEvent[]): void {\n    if (events.length === 0) {\n      this.setContent('\u003Cdiv class=\"schedule-empty\">No events today\u003C\u002Fdiv>');\n      return;\n    }\n\n    const rows = events.map(ev => `\n      \u003Cdiv class=\"schedule-row\">\n        \u003Cspan class=\"schedule-time\">${esc(formatTime(ev.startTime))}\u003C\u002Fspan>\n        \u003Cspan class=\"schedule-title\">\n          ${ev.url\n            ? `\u003Ca href=\"${safeUrl(ev.url)}\" target=\"_blank\" rel=\"noopener noreferrer\">${esc(ev.title)}\u003C\u002Fa>`\n            : esc(ev.title)\n          }\n        \u003C\u002Fspan>\n        ${ev.location ? `\u003Cspan class=\"schedule-location\">${esc(ev.location)}\u003C\u002Fspan>` : ''}\n      \u003C\u002Fdiv>\n    `).join('');\n    \u002F\u002F              ^^^              ^^^              ^^^\n    \u002F\u002F title, location, url — ALL from external API, ALL escaped.\n    \u002F\u002F safeUrl() prevents javascript: \u002F data: scheme injection in href.\n\n    this.setContent(`\u003Cdiv class=\"schedule-list\">${rows}\u003C\u002Fdiv>`);\n  }\n\n  public override destroy(): void {\n    if (this.refreshTimer) clearInterval(this.refreshTimer);\n    super.destroy();\n  }\n}\n```\n\n---\n\n## Key Patterns\n\n1. **Constructor** calls `super()` with panel config, then triggers initial data fetch\n2. **fetchData()** is async, uses `isFetching` guard, shows error on failure with retry\n3. **render()** builds HTML strings with `esc()` around every API-derived string, then calls `this.setContent(html)`\n4. **destroy()** cleans up timers and event listeners\n5. Use `showLoading()` during initial load (auto-called in constructor)\n6. Use `showError(msg, retryFn)` on failure — `msg` should be a hardcoded string, not API data\n7. **Import `esc` from `..\u002Futils\u002Fesc`** in every panel that consumes external data\n8. Numbers and booleans rendered via `.toFixed()` \u002F `.toString()` \u002F template arithmetic are safe — no `esc()` needed\n9. Use `textContent` instead of `innerHTML` for single text nodes when convenient — it is always safe\n\n## Sparkline Utility\n\nSparklines use computed numbers only — no escaping needed:\n\n```typescript\nexport function miniSparkline(data: number[] | undefined, change: number | null, w = 50, h = 16): string {\n  if (!data || data.length \u003C 2) return '';\n  const min = Math.min(...data);\n  const max = Math.max(...data);\n  const range = max - min || 1;\n  const color = change != null && change >= 0 ? 'var(--green)' : 'var(--red)';\n  const points = data.map((v, i) => {\n    const x = (i \u002F (data.length - 1)) * w;\n    const y = h - ((v - min) \u002F range) * (h - 2) - 1;\n    return `${x.toFixed(1)},${y.toFixed(1)}`;\n  }).join(' ');\n  return `\u003Csvg width=\"${w}\" height=\"${h}\" viewBox=\"0 0 ${w} ${h}\">\u003Cpolyline points=\"${points}\" fill=\"none\" stroke=\"${color}\" stroke-width=\"1.2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"\u002F>\u003C\u002Fsvg>`;\n}\n```\n\n---\n\n## Checklist Before Submitting a Panel\n\n- [ ] Every `string` field from an external API is wrapped in `esc()` before HTML interpolation\n- [ ] Every URL from an external API is passed through `safeUrl()` before use in `href`\u002F`src`\n- [ ] `showError()` is only called with hardcoded messages (never raw API error bodies)\n- [ ] `esc` and `safeUrl` are imported from `src\u002Futils\u002Fesc`\n- [ ] Numbers \u002F computed values rendered with `.toFixed()` or arithmetic are left unwrapped (they cannot contain HTML)\n",{"name":5,"description":7},"main","6b84b0689ca0d9e7b1e4061188ff6b60758e0f8a","openspace\u002Flegacy\u002Fv1\u002Fshowcase\u002Fskills\u002Fpanel-component-xss-safe",944,"https:\u002F\u002Fgithub.com\u002FHKUDS\u002FAgentPilot","https:\u002F\u002Fgithub.com\u002FHKUDS","https:\u002F\u002Fsites.google.com\u002Fview\u002Fchaoh","2026-11-12 22:26:39",{"source":8,"skillName":5,"commands":58,"prompt":68,"zipAvailable":69},[59,62,65],{"tool":60,"command":61},"npx","npx skills add HKUDS\u002FAgentPilot --skill panel-component-xss-safe",{"tool":63,"command":64},"bunx","bunx skills add HKUDS\u002FAgentPilot --skill panel-component-xss-safe",{"tool":66,"command":67},"pnpm","pnpm dlx skills add HKUDS\u002FAgentPilot --skill panel-component-xss-safe","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FHKUDS\u002FAgentPilot\u002Fblob\u002Fmain\u002Fopenspace\u002Flegacy\u002Fv1\u002Fshowcase\u002Fskills\u002Fpanel-component-xss-safe\u002FSKILL.md",true,[71,77],{"path":72,"resourceType":73,"resourceTypeDesc":74,"sizeBytes":75,"sourceHtmlUrl":76},".skill_id","OTHER","其他",45,"https:\u002F\u002Fgithub.com\u002FHKUDS\u002FAgentPilot\u002Fblob\u002Fmain\u002Fopenspace\u002Flegacy\u002Fv1\u002Fshowcase\u002Fskills\u002Fpanel-component-xss-safe\u002F.skill_id",{"path":78,"resourceType":79,"resourceTypeDesc":80,"sizeBytes":81,"sourceHtmlUrl":82},"src\u002Futils\u002Fesc.ts","SCRIPT","脚本",951,"https:\u002F\u002Fgithub.com\u002FHKUDS\u002FAgentPilot\u002Fblob\u002Fmain\u002Fopenspace\u002Flegacy\u002Fv1\u002Fshowcase\u002Fskills\u002Fpanel-component-xss-safe\u002Fsrc\u002Futils\u002Fesc.ts",[84,103,122,147,170,193],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":44},"01M6HYB297NDABRERJRVG0K8R0","agentpilot","Set up AgentPilot and use its single entry to prepare missing inputs and run configured RSI experiments. Use when the user requests AgentPilot installation or work with AgentPilot.","https:\u002F\u002Fgithub.com\u002FHKUDS\u002FAgentPilot\u002Fblob\u002Fmain\u002Fplugins\u002Fagentpilot\u002Fskills\u002Fagentpilot\u002FSKILL.md",[],[86,91,92,34,93,94,95,96,97,98,99,100,101,102],"prepare","requests","missing","installation","rsi","up","use","user","work","SET","run","experiments",{"skillNo":104,"name":105,"nameZh":6,"description":106,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":107,"categories":108,"keywords":109,"publishedAt":44},"01M6HYAYWXTTE1J7DJM0MFNQ4H","remember","Review auto-memory entries and propose promotions to OPENSPACE.md, OPENSPACE.local.md, or retained auto-memory topics; detect duplicates, stale facts, conflicts, and ambiguous entries before making changes.","https:\u002F\u002Fgithub.com\u002FHKUDS\u002FAgentPilot\u002Fblob\u002Fmain\u002Fopenspace\u002Fopenspace\u002Fskills\u002Fremember\u002FSKILL.md",[],[105,110,111,112,113,114,115,116,117,118,119,120,121],"memory","review","auto","openspace","changes","facts","detect","entries","local","conflicts","stale","duplicates",{"skillNo":123,"name":124,"nameZh":6,"description":125,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":126,"categories":127,"keywords":133,"publishedAt":44},"01M6HYAVMPM4SBDV60R2B5HPV8","skill-discovery","Search reusable OpenSpace skills locally, and browse cloud packages step by step when a cloud skill may help. Reusing proven skills saves tokens, improves reliability, and extends your capabilities beyond built-in tools.","https:\u002F\u002Fgithub.com\u002FHKUDS\u002FAgentPilot\u002Fblob\u002Fmain\u002Fopenspace\u002Fopenspace\u002Fhost_skills\u002Fskill-discovery\u002FSKILL.md",[128],{"categoryNo":129,"categoryName":130,"taxonomyType":131,"taxonomyTypeDesc":132},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[134,135,136,113,137,138,139,140,141,142,143,144,145,146],"skill discovery","discovery","reusable","step by step","tokens","packages","help","cloud","reliability","capabilities","browse","search","Tools",{"skillNo":148,"name":149,"nameZh":6,"description":150,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":151,"categories":152,"keywords":154,"publishedAt":44},"01M6HYAR811B3RB0M50RBEDGN6","delegate-task","Delegate tasks to OpenSpace — a full-stack autonomous worker for coding, DevOps, web research, and desktop automation, backed by an extensive MCP tool and skill library. Skills auto-improve through use, reducing token consumption over time. A cloud community lets agents share and collectively evolve reusable skills.","https:\u002F\u002Fgithub.com\u002FHKUDS\u002FAgentPilot\u002Fblob\u002Fmain\u002Fopenspace\u002Fopenspace\u002Fhost_skills\u002Fdelegate-task\u002FSKILL.md",[153],{"categoryNo":129,"categoryName":130,"taxonomyType":131,"taxonomyTypeDesc":132},[155,156,157,113,158,159,160,161,162,136,112,97,163,164,165,32,166,167,168,169],"delegate","task","delegate task","time","improve","desktop automation","worker","community","autonomous","tool","stack","share","tasks","automation","MCP",{"skillNo":171,"name":172,"nameZh":6,"description":173,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":174,"categories":175,"keywords":176,"publishedAt":44},"01M6HYAM9FSGV6E52AYENDQXYH","write-special-chars-ts-check","Workaround for write_file failures caused by special characters (apostrophes, backticks, template literals) using a Python heredoc script, plus a reliable TypeScript type-checking step that filters output to only the newly-written files to avoid being misled by pre-existing errors.","https:\u002F\u002Fgithub.com\u002FHKUDS\u002FAgentPilot\u002Fblob\u002Fmain\u002Fopenspace\u002Flegacy\u002Fv1\u002Fshowcase\u002Fskills\u002Fwrite-special-chars-ts-check\u002FSKILL.md",[],[177,178,179,180,181,182,183,184,185,186,187,188,189,190,32,191,192],"write special chars ts check","write","check","type","files","filters","only","template","file","python","typescript","output","Existing","type-checking","errors","script",{"skillNo":194,"name":195,"nameZh":6,"description":196,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":197,"categories":198,"keywords":199,"publishedAt":44},"01M6HYAH05HGV7SVWSVR8PJRQD","write-special-chars-readback","Workaround for write_file failures caused by special characters (apostrophes, backticks, template literals) using a Python heredoc script, with mandatory post-write verification via read_file and cleanup of \u002Ftmp helper scripts.","https:\u002F\u002Fgithub.com\u002FHKUDS\u002FAgentPilot\u002Fblob\u002Fmain\u002Fopenspace\u002Flegacy\u002Fv1\u002Fshowcase\u002Fskills\u002Fwrite-special-chars-readback\u002FSKILL.md",[],[200,201,178,34,32,192,37,202,203,204,205,184,185,206,207,186],"write special chars readback","readback","post","via","scripts","read","verification","cleanup"]