diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml index 027151d..4366177 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.yml +++ b/.github/ISSUE_TEMPLATE/bug_report.yml @@ -86,6 +86,8 @@ body: - DonutChart - RadarChart - CandlestickChart + - ProgressChart + - ContributionHeatmap - Multiple components validations: required: true diff --git a/.github/workflows/pages.yml b/.github/workflows/pages.yml index 27cad89..18838ad 100644 --- a/.github/workflows/pages.yml +++ b/.github/workflows/pages.yml @@ -33,13 +33,30 @@ jobs: with: persist-credentials: false + - name: Set up Bun + uses: oven-sh/setup-bun@735343b667d3e6f658f44d0eca948eb6282f2b76 # v2.0.2 + with: + bun-version: 1.3.14 + + - name: Install documentation dependencies + working-directory: docs + run: bun install --frozen-lockfile + + - name: Check documentation + working-directory: docs + run: bun run check + + - name: Build documentation + working-directory: docs + run: bun run build + - name: Configure GitHub Pages uses: actions/configure-pages@983d7736d9b0ae728b81ab479565c72886d7745b # v5.0.0 - name: Upload documentation artifact uses: actions/upload-pages-artifact@fc324d3547104276b827a68afc52ff2a11cc49c9 # v5.0.0 with: - path: docs + path: docs/dist - name: Deploy to GitHub Pages id: deployment diff --git a/.gitignore b/.gitignore index 5dd86d0..46b97df 100644 --- a/.gitignore +++ b/.gitignore @@ -5,4 +5,7 @@ *.log /.build/ resources/ios/.build/ -android-harness/ +.idea/ +*.iml +.vscode/ +.playwright-mcp diff --git a/CHANGELOG.md b/CHANGELOG.md index 4d523f7..0f42ff4 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,6 +4,26 @@ All notable changes to NativePHP Charts are documented here. The project follows ## [Unreleased] +### Added + +- Native progress and contribution heatmap charts with selection, reduced-motion behavior, empty/error states, and accessible summaries. +- Semantic `light`, `dark`, and `system` themes with built-in and application-defined presets. +- An Astro/Starlight documentation application. + +### Changed + +- Moved native payload reads and decoding off the UI thread while preserving the last valid snapshot during replacement loading. +- Reduced Android solid-linear HWUI geometry at sub-pixel density while preserving per-column extrema and the complete selection snapshot. +- Made explicit series, segment, and metric colors optional so semantic palettes can supply stable defaults. +- Extended the version 1 `PointSelection` contract with `progress` and `contribution_heatmap` chart types. + +### Fixed + +- Reject unknown contracts and corrupt native snapshots with a bounded diagnostic and visible error state. +- Keep new file-backed payloads for at least ten minutes and prune only expired entries beyond the retained 64. +- Ignore unrevealed Android geometry during animated hit testing. +- Preserve the full chart accessibility frame on iOS so VoiceOver focus and assistive hit testing cover the rendered plot. + ## [1.1.0] - 2026-09-01 ### Added diff --git a/README.md b/README.md index b78258f..df63717 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@

- - NativePHP Charts + + NativePHP Charts

@@ -13,9 +13,9 @@ **[Explore the documentation and native demos →](https://donmanueldev.github.io/nativephp-charts/)** -Start with the focused guides: [installation and your first chart](https://donmanueldev.github.io/nativephp-charts/guides/installation/), [line, area, bar, and scatter charts](https://donmanueldev.github.io/nativephp-charts/guides/cartesian-charts/), [pie and donut charts](https://donmanueldev.github.io/nativephp-charts/guides/radial-charts/), and [radar and candlestick charts](https://donmanueldev.github.io/nativephp-charts/guides/radar-candlestick/). +Start with [installation](https://donmanueldev.github.io/nativephp-charts/getting-started/installation/), choose from the chart guides beginning with [line](https://donmanueldev.github.io/nativephp-charts/charts/line/), then use the focused guides for [themes](https://donmanueldev.github.io/nativephp-charts/guides/themes/), [callbacks](https://donmanueldev.github.io/nativephp-charts/guides/callbacks-interactions/), and [troubleshooting](https://donmanueldev.github.io/nativephp-charts/guides/troubleshooting/). -Native line, area, bar, scatter, candlestick, radar, pie, and donut charts for [NativePHP Mobile](https://nativephp.com). iOS renders with Swift Charts and SwiftUI Canvas; Android renders with Jetpack Compose Canvas. Data stays on the device; there is no WebView, JavaScript chart library, network service, telemetry, or third-party native chart dependency. +Ten native chart types for [NativePHP Mobile](https://nativephp.com), including Cartesian, radial, progress, and contribution charts. iOS renders with Swift Charts and SwiftUI Canvas; Android renders with Jetpack Compose Canvas. Data stays on the device; there is no WebView, JavaScript chart library, network service, telemetry, or third-party native chart dependency. > NativePHP Charts is an independent community plugin. It is not an official NativePHP package. @@ -117,10 +117,10 @@ Create `resources/views/native/sales-dashboard.blade.php`. Give the chart an exp ``` -The same `series` contract powers line, area, bar, and scatter charts. Every series needs a unique `id`, `name`, `color`, and ordered `points`. Give each point a stable `id` when the chart is interactive or updates frequently. +The same `series` contract powers line, area, bar, and scatter charts. Every series needs a unique `id`, `name`, and ordered `points`; `color` is optional and otherwise comes from the active preset. Give every interactive point a stable `id` so selection survives updates and reordering.

- Native line chart running in the iOS simulator + Native line chart running in the iOS simulator

Native line chart rendered in the installed iOS app.

@@ -137,6 +137,8 @@ The same `series` contract powers line, area, bar, and scatter charts. Every ser | Radar | `` | Ordered `axes`, `series`, and axis values | Grid levels and fill opacity | | Pie | `` | Ordered `segments` | Fixed inner radius of `0` | | Donut | `` | Ordered `segments` | `inner-radius-ratio` from `0.2` to `0.85` | +| Progress | `` | Ordered `metrics` with values from `0` to `1` | Ring track, gap, cap, and center label styles | +| Contribution heatmap | `` | Unique ISO-dated `values` | Date window, week start, scale, and label visibility | Every listed chart renders natively on iOS and Android and supports localized values, empty states, semantic styling, legends, selection callbacks, and accessible summaries. @@ -316,7 +318,7 @@ Radar charts require 3 to 24 ordered axes. Each series must provide exactly one ### Pie and donut charts -Pie and donut charts use ordered `segments`. Every segment needs a unique `id`, a `label`, a non-negative finite `value`, and a `color`. A non-empty chart must contain at least one positive value. +Pie and donut charts use ordered `segments`. Every segment needs a unique `id`, a `label`, and a non-negative finite `value`; `color` is optional. A non-empty chart must contain at least one positive value. ```blade + + +``` + ## API guide Use this section after the first chart renders to add interaction, formatting, legends, and semantic styling. +### Themes and presets + +Every chart accepts `theme="light|dark|system"`, `preset`, and `error-label`. Built-in presets are `default`, `spectrum`, and `contrast`. Publish the package config to register application presets: + +```bash +php artisan vendor:publish --tag=nativephp-charts-config +``` + +Resolution is deterministic: built-in preset, application preset override, chart theme/style, then explicit series, segment, or metric color. The API stays renderer-neutral; it exposes no SwiftUI or Compose primitives. + ### Selection and PHP callbacks Bind `_select` to a public method on the surrounding `NativeComponent`. Native selection and tooltips update immediately; the PHP callback receives the selected identity and value as JSON. @@ -504,21 +548,22 @@ Blade uses kebab case. The fluent PHP API uses camelCase methods such as `series - Category x-axes do not accept an explicit numeric/date domain. - Unknown axis, legend, style, series, point, and segment options are rejected instead of silently ignored. -### Accessibility and performance +### Accessibility - Always provide a localized `a11y-label` describing the chart's purpose. - Use stable IDs so selection remains deterministic across updates and reordering. - Native renderers bound large accessibility summaries instead of reading an unbounded dataset. -- Native rendering is not a promise of unlimited data. Validate realistic and worst-case datasets on every target device. -- Simulator and host tests do not replace VoiceOver, TalkBack, text scaling, gesture, and performance checks on physical devices. +- Validate realistic and worst-case datasets on every target device. -### Testing and evidence +### Testing ```bash composer test +swift test ``` -PHP tests prove normalization, serialization, compatibility, and callback registration. Native compilation, simulator/emulator rendering, interaction, accessibility, and physical-device performance remain separate acceptance gates. +PHP tests cover normalization, serialization, compatibility, and callback registration. Swift tests cover the iOS renderer source. + ## Platform and frontend scope diff --git a/config/nativephp-charts.php b/config/nativephp-charts.php new file mode 100644 index 0000000..96cfb42 --- /dev/null +++ b/config/nativephp-charts.php @@ -0,0 +1,9 @@ + [], +]; diff --git a/docs/.gitignore b/docs/.gitignore new file mode 100644 index 0000000..1462565 --- /dev/null +++ b/docs/.gitignore @@ -0,0 +1,26 @@ +# build output +dist/ +test-results/ +playwright-report/ + +# generated types +.astro/ + +# dependencies +node_modules/ + +# logs +npm-debug.log* +yarn-debug.log* +yarn-error.log* +pnpm-debug.log* + +# environment variables +.env +.env.production + +# macOS-specific files +.DS_Store + +# jetbrains setting folder +.idea/ diff --git a/docs/assets/demos/android/bar-selection.mp4 b/docs/assets/demos/android/bar-selection.mp4 deleted file mode 100644 index 21df326..0000000 Binary files a/docs/assets/demos/android/bar-selection.mp4 and /dev/null differ diff --git a/docs/assets/demos/android/line-update.mp4 b/docs/assets/demos/android/line-update.mp4 deleted file mode 100644 index 5077408..0000000 Binary files a/docs/assets/demos/android/line-update.mp4 and /dev/null differ diff --git a/docs/assets/demos/android/radial-selection.mp4 b/docs/assets/demos/android/radial-selection.mp4 deleted file mode 100644 index fc2a3df..0000000 Binary files a/docs/assets/demos/android/radial-selection.mp4 and /dev/null differ diff --git a/docs/assets/demos/ios/bar-selection.mp4 b/docs/assets/demos/ios/bar-selection.mp4 deleted file mode 100644 index f10a4a2..0000000 Binary files a/docs/assets/demos/ios/bar-selection.mp4 and /dev/null differ diff --git a/docs/assets/demos/ios/line-update.mp4 b/docs/assets/demos/ios/line-update.mp4 deleted file mode 100644 index d7b1f63..0000000 Binary files a/docs/assets/demos/ios/line-update.mp4 and /dev/null differ diff --git a/docs/assets/demos/ios/radial-selection.mp4 b/docs/assets/demos/ios/radial-selection.mp4 deleted file mode 100644 index 768abb2..0000000 Binary files a/docs/assets/demos/ios/radial-selection.mp4 and /dev/null differ diff --git a/docs/assets/initial.css b/docs/assets/initial.css deleted file mode 100644 index 718d659..0000000 --- a/docs/assets/initial.css +++ /dev/null @@ -1,565 +0,0 @@ -:root { - color-scheme: light; - --ink: #080808; - --ink-soft: #151515; - --paper: #ffffff; - --paper-muted: #f4f3f1; - --paper-warm: #fff5ee; - --surface: #151515; - --ember: #ed3f16; - --ember-action: #c8320f; - --ember-dark: #c92f0d; - --ember-light: #ff9b67; - --text: #151515; - --muted: #67635f; - --muted-on-dark: #b8b4af; - --line: #dedbd7; - --line-dark: #2a2a2a; - --shadow: 0 24px 70px rgb(0 0 0 / 14%); - --radius-small: 8px; - --radius-medium: 18px; - --radius-large: 32px; - --shell: 1360px; - --font-sans: Inter, ui-sans-serif, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; - --font-mono: "SFMono-Regular", Consolas, "Liberation Mono", monospace; -} -*, -*::before, -*::after { - box-sizing: border-box; -} - -html { - scroll-behavior: smooth; -} - -body { - margin: 0; - background: var(--paper); - color: var(--text); - font-family: var(--font-sans); - font-size: 16px; - line-height: 1.6; - text-rendering: optimizeLegibility; - -webkit-font-smoothing: antialiased; -} - -img { - display: block; - max-width: 100%; -} - -a { - color: inherit; -} - -button, -a { - -webkit-tap-highlight-color: transparent; -} - -button { - font: inherit; -} - -:focus-visible { - outline: 3px solid var(--ember-light); - outline-offset: 4px; -} - -.sr-only { - position: absolute; - width: 1px; - height: 1px; - padding: 0; - margin: -1px; - overflow: hidden; - clip: rect(0, 0, 0, 0); - white-space: nowrap; - border: 0; -} - -.skip-link { - position: fixed; - z-index: 100; - top: 12px; - left: 12px; - padding: 10px 14px; - border-radius: var(--radius-small); - background: var(--paper); - color: var(--ink); - font-weight: 800; - transform: translateY(-160%); - transition: transform 160ms ease; -} - -.skip-link:focus { - transform: translateY(0); -} - -.shell { - width: min(calc(100% - 80px), var(--shell)); - margin-inline: auto; -} - -.site-header { - position: sticky; - z-index: 50; - top: 0; - border-bottom: 1px solid rgb(255 255 255 / 12%); - background: rgb(8 8 8 / 92%); - color: var(--paper); - backdrop-filter: blur(18px); -} - -.header-inner { - display: flex; - min-height: 76px; - align-items: center; - justify-content: space-between; - gap: 32px; -} - -.brand { - display: inline-flex; - align-items: center; - gap: 12px; - color: inherit; - font-size: 16px; - font-weight: 800; - letter-spacing: -0.02em; - text-decoration: none; -} - -.brand img { - flex: 0 0 auto; -} - -.primary-navigation { - display: flex; - align-items: center; - gap: 34px; -} - -.primary-navigation a { - color: #c9c7c4; - font-size: 14px; - font-weight: 650; - text-decoration: none; - transition: color 160ms ease, background-color 160ms ease; -} - -.primary-navigation a:hover { - color: var(--paper); -} - -.primary-navigation .nav-cta { - padding: 10px 18px; - border-radius: var(--radius-small); - background: var(--ember-action); - color: var(--paper); -} - -.primary-navigation .nav-cta:hover { - background: var(--ember-light); - color: var(--ink); -} - -.grid-surface { - background-color: var(--ink); - background-image: - linear-gradient(rgb(255 255 255 / 5%) 1px, transparent 1px), - linear-gradient(90deg, rgb(255 255 255 / 5%) 1px, transparent 1px); - background-size: 48px 48px; - color: var(--paper); -} - -.hero { - position: relative; - min-height: 760px; - overflow: hidden; -} - -.hero::after { - position: absolute; - inset: auto 0 0; - height: 220px; - background: linear-gradient(to bottom, transparent, rgb(8 8 8 / 85%)); - content: ""; - pointer-events: none; -} - -.hero-layout { - position: relative; - z-index: 1; - display: grid; - min-height: 760px; - grid-template-columns: minmax(0, 0.92fr) minmax(560px, 1.08fr); - align-items: center; - gap: clamp(40px, 6vw, 100px); - padding-block: 72px 58px; -} - -.hero-copy { - padding-bottom: 34px; -} - -.hero-copy > .status-note { - margin: 0 0 22px; - color: var(--ember-light); - font-size: 12px; - font-weight: 800; - letter-spacing: 0.1em; - line-height: 1.4; - text-transform: uppercase; -} - -.hero h1, -.section-heading h2, -.accessibility h2, -.closing h2 { - margin: 0; - font-weight: 850; - letter-spacing: -0.055em; - line-height: 0.98; -} - -.hero h1 { - max-width: 770px; - font-size: clamp(58px, 6.1vw, 96px); -} - -.hero-copy > p { - max-width: 650px; - margin: 34px 0 0; - color: #aaa7a4; - font-size: clamp(18px, 1.7vw, 24px); - line-height: 1.45; -} - -.hero-actions, -.closing-actions { - display: flex; - flex-wrap: wrap; - gap: 14px; - margin-top: 34px; -} - -.button { - display: inline-flex; - min-height: 52px; - align-items: center; - justify-content: center; - padding: 13px 22px; - border: 1px solid transparent; - border-radius: var(--radius-small); - font-size: 15px; - font-weight: 800; - line-height: 1; - text-decoration: none; - transition: transform 160ms ease, background-color 160ms ease, border-color 160ms ease; -} - -.button:hover { - transform: translateY(-2px); -} - -.button-primary { - background: var(--ember-action); - color: var(--paper); -} - -.button-primary:hover { - background: var(--ember-light); - color: var(--ink); -} - -.button-secondary { - border-color: #494949; - background: rgb(255 255 255 / 2%); - color: var(--paper); -} - -.button-secondary:hover { - border-color: var(--paper); -} - -.compatibility { - display: flex; - flex-wrap: wrap; - gap: 9px 0; - margin: 32px 0 0; - padding: 0; - color: #7f7d7a; - font-size: 13px; - font-weight: 700; - list-style: none; -} - -.compatibility li + li::before { - margin-inline: 10px; - color: var(--ember); - content: "/"; -} - -.hero-devices { - position: relative; - align-self: stretch; - min-height: 650px; -} - -.device { - position: absolute; - width: min(41%, 294px); - margin: 0; -} - -.device::before { - position: absolute; - z-index: -1; - inset: 10% -16% 4%; - border-radius: 50%; - background: rgb(237 63 22 / 22%); - filter: blur(54px); - content: ""; -} - -.device img, -.screenshot-frame { - border: 9px solid #151515; - border-radius: 42px; - background: #f8f8f8; - box-shadow: var(--shadow); -} - -.device img { - width: 100%; - height: auto; - aspect-ratio: 402 / 874; - object-fit: cover; - object-position: top center; -} - -.device figcaption { - margin-top: 13px; - color: #85827f; - font-size: 12px; - font-weight: 750; - letter-spacing: 0.04em; - text-align: center; - text-transform: uppercase; -} - -.device-android { - z-index: 2; - right: 42%; - bottom: -112px; - transform: rotate(-3deg); -} - -.device-ios { - right: 4%; - bottom: -62px; - transform: rotate(3deg); -} - -@media (max-width: 1120px) { - .hero-layout { - grid-template-columns: minmax(0, 0.9fr) minmax(430px, 1.1fr); - } - - .hero-devices { - min-height: 570px; - } - - .device { - width: 44%; - } -} - -@media (max-width: 860px) { - body { - padding-bottom: calc(68px + env(safe-area-inset-bottom)); - } - - .shell { - width: min(calc(100% - 40px), var(--shell)); - } - - .header-inner { - min-height: 76px; - flex-wrap: nowrap; - gap: 16px; - padding-block: 12px; - } - - .site-header { - backdrop-filter: none; - } - - .primary-navigation { - position: fixed; - z-index: 60; - inset: auto 0 0; - min-height: calc(68px + env(safe-area-inset-bottom)); - gap: 4px; - padding: 8px 12px calc(8px + env(safe-area-inset-bottom)); - border-top: 1px solid var(--line-dark); - background: rgb(8 8 8 / 96%); - box-shadow: 0 -14px 32px rgb(0 0 0 / 24%); - backdrop-filter: blur(18px); - } - - .primary-navigation a { - flex: 1 1 0; - min-width: 0; - padding: 10px 4px; - border: 0; - border-radius: 10px; - color: var(--paper); - font-size: 12px; - line-height: 1.2; - text-align: center; - text-overflow: ellipsis; - white-space: nowrap; - overflow: hidden; - } - - .primary-navigation .nav-cta { - display: none; - } - - .hero, - .hero-layout { - min-height: auto; - } - - .hero-layout { - grid-template-columns: 1fr; - padding-block: 82px 0; - } - - .hero h1 { - font-size: clamp(54px, 13vw, 82px); - } - - .hero-devices { - min-height: 590px; - } - - .device { - width: min(42%, 265px); - } - - .device-android { - right: 50%; - bottom: -86px; - } - - .device-ios { - right: 10%; - bottom: -36px; - } -} - -@media (max-width: 620px) { - .shell { - width: min(calc(100% - 32px), var(--shell)); - } - - .header-inner { - min-height: 68px; - } - - .primary-navigation { - padding-inline: 8px; - } - - .primary-navigation a { - font-size: 11px; - } - - .brand { - font-size: 14px; - } - - .brand img { - width: 38px; - height: auto; - } - - .hero-layout { - gap: 8px; - padding-top: 42px; - } - - .hero h1 { - font-size: clamp(44px, 13vw, 60px); - } - - .hero-copy { - padding-bottom: 0; - } - - .hero-copy > .status-note { - margin-bottom: 14px; - } - - .hero-copy > p { - margin-top: 24px; - font-size: 18px; - } - - .hero-actions, - .closing-actions { - display: grid; - } - - .hero-actions { - gap: 10px; - margin-top: 26px; - } - - .button { - width: 100%; - } - - .compatibility { - display: grid; - grid-template-columns: repeat(2, minmax(0, 1fr)); - gap: 5px 14px; - margin-top: 24px; - } - - .compatibility li + li::before { - display: none; - } - - .hero-devices { - min-height: 390px; - } - - .device { - width: 46%; - } - - .device img, - .screenshot-frame { - border-width: 6px; - border-radius: 30px; - } - - .device figcaption { - font-size: 9px; - } - - .device-android { - right: 49%; - bottom: -72px; - } - - .device-ios { - right: 2%; - bottom: -34px; - } -} diff --git a/docs/assets/runtime/android/biyuyo-budget-charts-480.webp b/docs/assets/runtime/android/biyuyo-budget-charts-480.webp deleted file mode 100644 index a9c1bc9..0000000 Binary files a/docs/assets/runtime/android/biyuyo-budget-charts-480.webp and /dev/null differ diff --git a/docs/assets/runtime/android/biyuyo-budget-charts.png b/docs/assets/runtime/android/biyuyo-budget-charts.png deleted file mode 100644 index 1902c41..0000000 Binary files a/docs/assets/runtime/android/biyuyo-budget-charts.png and /dev/null differ diff --git a/docs/assets/runtime/android/biyuyo-budget.png b/docs/assets/runtime/android/biyuyo-budget.png deleted file mode 100644 index 21ecf01..0000000 Binary files a/docs/assets/runtime/android/biyuyo-budget.png and /dev/null differ diff --git a/docs/assets/runtime/android/biyuyo-goal-charts.png b/docs/assets/runtime/android/biyuyo-goal-charts.png deleted file mode 100644 index e2a6a41..0000000 Binary files a/docs/assets/runtime/android/biyuyo-goal-charts.png and /dev/null differ diff --git a/docs/assets/runtime/android/biyuyo-goal.png b/docs/assets/runtime/android/biyuyo-goal.png deleted file mode 100644 index 4c269ed..0000000 Binary files a/docs/assets/runtime/android/biyuyo-goal.png and /dev/null differ diff --git a/docs/assets/runtime/complete/android/performance/area.png b/docs/assets/runtime/complete/android/performance/area.png deleted file mode 100644 index a35bcf3..0000000 Binary files a/docs/assets/runtime/complete/android/performance/area.png and /dev/null differ diff --git a/docs/assets/runtime/complete/android/performance/bar.png b/docs/assets/runtime/complete/android/performance/bar.png deleted file mode 100644 index 45f7962..0000000 Binary files a/docs/assets/runtime/complete/android/performance/bar.png and /dev/null differ diff --git a/docs/assets/runtime/complete/android/performance/donut.png b/docs/assets/runtime/complete/android/performance/donut.png deleted file mode 100644 index 9fd74db..0000000 Binary files a/docs/assets/runtime/complete/android/performance/donut.png and /dev/null differ diff --git a/docs/assets/runtime/complete/android/performance/line.png b/docs/assets/runtime/complete/android/performance/line.png deleted file mode 100644 index 514907e..0000000 Binary files a/docs/assets/runtime/complete/android/performance/line.png and /dev/null differ diff --git a/docs/assets/runtime/complete/android/performance/pie.png b/docs/assets/runtime/complete/android/performance/pie.png deleted file mode 100644 index 9180b75..0000000 Binary files a/docs/assets/runtime/complete/android/performance/pie.png and /dev/null differ diff --git a/docs/assets/runtime/complete/android/performance/scatter.png b/docs/assets/runtime/complete/android/performance/scatter.png deleted file mode 100644 index 9c2ae1f..0000000 Binary files a/docs/assets/runtime/complete/android/performance/scatter.png and /dev/null differ diff --git a/docs/assets/runtime/complete/android/showcases/audio.png b/docs/assets/runtime/complete/android/showcases/audio.png deleted file mode 100644 index 57fff73..0000000 Binary files a/docs/assets/runtime/complete/android/showcases/audio.png and /dev/null differ diff --git a/docs/assets/runtime/complete/android/showcases/product.png b/docs/assets/runtime/complete/android/showcases/product.png deleted file mode 100644 index 9b0ece3..0000000 Binary files a/docs/assets/runtime/complete/android/showcases/product.png and /dev/null differ diff --git a/docs/assets/runtime/complete/android/showcases/research.png b/docs/assets/runtime/complete/android/showcases/research.png deleted file mode 100644 index 65d4ed3..0000000 Binary files a/docs/assets/runtime/complete/android/showcases/research.png and /dev/null differ diff --git a/docs/assets/runtime/complete/android/showcases/training.png b/docs/assets/runtime/complete/android/showcases/training.png deleted file mode 100644 index d1b9f52..0000000 Binary files a/docs/assets/runtime/complete/android/showcases/training.png and /dev/null differ diff --git a/docs/assets/runtime/complete/android/showcases/weather.png b/docs/assets/runtime/complete/android/showcases/weather.png deleted file mode 100644 index b974a4e..0000000 Binary files a/docs/assets/runtime/complete/android/showcases/weather.png and /dev/null differ diff --git a/docs/assets/runtime/complete/ios/performance/area.png b/docs/assets/runtime/complete/ios/performance/area.png deleted file mode 100644 index 0c6022a..0000000 Binary files a/docs/assets/runtime/complete/ios/performance/area.png and /dev/null differ diff --git a/docs/assets/runtime/complete/ios/performance/bar.png b/docs/assets/runtime/complete/ios/performance/bar.png deleted file mode 100644 index 720e740..0000000 Binary files a/docs/assets/runtime/complete/ios/performance/bar.png and /dev/null differ diff --git a/docs/assets/runtime/complete/ios/performance/donut.png b/docs/assets/runtime/complete/ios/performance/donut.png deleted file mode 100644 index 61a875c..0000000 Binary files a/docs/assets/runtime/complete/ios/performance/donut.png and /dev/null differ diff --git a/docs/assets/runtime/complete/ios/performance/line.png b/docs/assets/runtime/complete/ios/performance/line.png deleted file mode 100644 index 8502af9..0000000 Binary files a/docs/assets/runtime/complete/ios/performance/line.png and /dev/null differ diff --git a/docs/assets/runtime/complete/ios/performance/pie.png b/docs/assets/runtime/complete/ios/performance/pie.png deleted file mode 100644 index 51655bb..0000000 Binary files a/docs/assets/runtime/complete/ios/performance/pie.png and /dev/null differ diff --git a/docs/assets/runtime/complete/ios/performance/scatter.png b/docs/assets/runtime/complete/ios/performance/scatter.png deleted file mode 100644 index 017e9b0..0000000 Binary files a/docs/assets/runtime/complete/ios/performance/scatter.png and /dev/null differ diff --git a/docs/assets/runtime/complete/ios/showcases/audio.png b/docs/assets/runtime/complete/ios/showcases/audio.png deleted file mode 100644 index 561bb50..0000000 Binary files a/docs/assets/runtime/complete/ios/showcases/audio.png and /dev/null differ diff --git a/docs/assets/runtime/complete/ios/showcases/product.png b/docs/assets/runtime/complete/ios/showcases/product.png deleted file mode 100644 index c567cb0..0000000 Binary files a/docs/assets/runtime/complete/ios/showcases/product.png and /dev/null differ diff --git a/docs/assets/runtime/complete/ios/showcases/research.png b/docs/assets/runtime/complete/ios/showcases/research.png deleted file mode 100644 index 7e9b5c0..0000000 Binary files a/docs/assets/runtime/complete/ios/showcases/research.png and /dev/null differ diff --git a/docs/assets/runtime/complete/ios/showcases/training.png b/docs/assets/runtime/complete/ios/showcases/training.png deleted file mode 100644 index a9a59c5..0000000 Binary files a/docs/assets/runtime/complete/ios/showcases/training.png and /dev/null differ diff --git a/docs/assets/runtime/complete/ios/showcases/weather.png b/docs/assets/runtime/complete/ios/showcases/weather.png deleted file mode 100644 index 2b675b6..0000000 Binary files a/docs/assets/runtime/complete/ios/showcases/weather.png and /dev/null differ diff --git a/docs/assets/runtime/ios/biyuyo-budget-charts.png b/docs/assets/runtime/ios/biyuyo-budget-charts.png deleted file mode 100644 index 6549649..0000000 Binary files a/docs/assets/runtime/ios/biyuyo-budget-charts.png and /dev/null differ diff --git a/docs/assets/runtime/ios/biyuyo-budget.png b/docs/assets/runtime/ios/biyuyo-budget.png deleted file mode 100644 index 8089ca1..0000000 Binary files a/docs/assets/runtime/ios/biyuyo-budget.png and /dev/null differ diff --git a/docs/assets/runtime/ios/biyuyo-goal-charts-320.webp b/docs/assets/runtime/ios/biyuyo-goal-charts-320.webp deleted file mode 100644 index 9db1209..0000000 Binary files a/docs/assets/runtime/ios/biyuyo-goal-charts-320.webp and /dev/null differ diff --git a/docs/assets/runtime/ios/biyuyo-goal-charts.png b/docs/assets/runtime/ios/biyuyo-goal-charts.png deleted file mode 100644 index 81b5a22..0000000 Binary files a/docs/assets/runtime/ios/biyuyo-goal-charts.png and /dev/null differ diff --git a/docs/assets/runtime/ios/biyuyo-goal.png b/docs/assets/runtime/ios/biyuyo-goal.png deleted file mode 100644 index b810163..0000000 Binary files a/docs/assets/runtime/ios/biyuyo-goal.png and /dev/null differ diff --git a/docs/assets/screenshots/area-android.png b/docs/assets/screenshots/area-android.png deleted file mode 100644 index 291a99b..0000000 Binary files a/docs/assets/screenshots/area-android.png and /dev/null differ diff --git a/docs/assets/screenshots/bar-android.png b/docs/assets/screenshots/bar-android.png deleted file mode 100644 index e04cad2..0000000 Binary files a/docs/assets/screenshots/bar-android.png and /dev/null differ diff --git a/docs/assets/screenshots/bar-ios.png b/docs/assets/screenshots/bar-ios.png deleted file mode 100644 index ad0faff..0000000 Binary files a/docs/assets/screenshots/bar-ios.png and /dev/null differ diff --git a/docs/assets/screenshots/donut-android.png b/docs/assets/screenshots/donut-android.png deleted file mode 100644 index fe6c156..0000000 Binary files a/docs/assets/screenshots/donut-android.png and /dev/null differ diff --git a/docs/assets/screenshots/donut-ios.png b/docs/assets/screenshots/donut-ios.png deleted file mode 100644 index 1c285e3..0000000 Binary files a/docs/assets/screenshots/donut-ios.png and /dev/null differ diff --git a/docs/assets/screenshots/line-android.png b/docs/assets/screenshots/line-android.png deleted file mode 100644 index 57ecb25..0000000 Binary files a/docs/assets/screenshots/line-android.png and /dev/null differ diff --git a/docs/assets/screenshots/line-ios-320.webp b/docs/assets/screenshots/line-ios-320.webp deleted file mode 100644 index 12e60c0..0000000 Binary files a/docs/assets/screenshots/line-ios-320.webp and /dev/null differ diff --git a/docs/assets/screenshots/line-ios.png b/docs/assets/screenshots/line-ios.png deleted file mode 100644 index ecd394c..0000000 Binary files a/docs/assets/screenshots/line-ios.png and /dev/null differ diff --git a/docs/assets/screenshots/pie-ios.png b/docs/assets/screenshots/pie-ios.png deleted file mode 100644 index 5281173..0000000 Binary files a/docs/assets/screenshots/pie-ios.png and /dev/null differ diff --git a/docs/assets/screenshots/scatter-ios.png b/docs/assets/screenshots/scatter-ios.png deleted file mode 100644 index 9c63291..0000000 Binary files a/docs/assets/screenshots/scatter-ios.png and /dev/null differ diff --git a/docs/assets/site.js b/docs/assets/site.js deleted file mode 100644 index 22dfd6d..0000000 --- a/docs/assets/site.js +++ /dev/null @@ -1,126 +0,0 @@ -const tabs = Array.from(document.querySelectorAll('[data-code-tab]')); -const panels = Array.from(document.querySelectorAll('[data-code-panel]')); -const demoPanels = Array.from(document.querySelectorAll('[data-demo-panel]')); -const apiShowcase = document.querySelector('.api-showcase'); -const apiPreview = document.querySelector('.api-preview'); -const prefersReducedMotion = window.matchMedia('(prefers-reduced-motion: reduce)'); - -const loadDemoMedia = (video, shouldLoadVideo) => { - if (!video.poster && video.dataset.poster) { - video.poster = video.dataset.poster; - } - - if (!shouldLoadVideo) { - return; - } - - const source = video.querySelector('source'); - - if (source.src) { - return; - } - - source.src = source.dataset.src; - video.load(); -}; - -const syncDemo = (selectedName) => { - const selectedPanel = demoPanels.find((panel) => panel.dataset.demoPanel === selectedName); - - if (apiShowcase && apiPreview) { - const hasPreview = Boolean(selectedPanel); - apiShowcase.dataset.hasPreview = String(hasPreview); - apiPreview.hidden = !hasPreview; - } - - demoPanels.forEach((panel) => { - panel.hidden = panel.dataset.demoPanel !== selectedName; - const isSelected = !panel.hidden; - - panel.querySelectorAll('video').forEach((video) => { - video.pause(); - - if (isSelected) { - loadDemoMedia(video, !prefersReducedMotion.matches); - } - - if (isSelected && !prefersReducedMotion.matches) { - video.currentTime = 0; - video.play().catch(() => {}); - } - }); - }); -}; - -const selectTab = (selectedTab, moveFocus = true) => { - const selectedName = selectedTab.dataset.codeTab; - - tabs.forEach((tab) => { - const isSelected = tab === selectedTab; - tab.setAttribute('aria-selected', String(isSelected)); - tab.tabIndex = isSelected ? 0 : -1; - }); - - panels.forEach((panel) => { - panel.hidden = panel.dataset.codePanel !== selectedName; - }); - - syncDemo(selectedName); - - if (moveFocus) { - selectedTab.focus(); - } -}; - -tabs.forEach((tab, index) => { - tab.addEventListener('click', () => selectTab(tab, false)); - tab.addEventListener('keydown', (event) => { - if (!['ArrowLeft', 'ArrowRight', 'Home', 'End'].includes(event.key)) { - return; - } - - event.preventDefault(); - - if (event.key === 'Home') { - selectTab(tabs[0]); - return; - } - - if (event.key === 'End') { - selectTab(tabs[tabs.length - 1]); - return; - } - - const direction = event.key === 'ArrowRight' ? 1 : -1; - const nextIndex = (index + direction + tabs.length) % tabs.length; - selectTab(tabs[nextIndex]); - }); -}); - -syncDemo(tabs.find((tab) => tab.getAttribute('aria-selected') === 'true')?.dataset.codeTab); -prefersReducedMotion.addEventListener('change', () => { - syncDemo(tabs.find((tab) => tab.getAttribute('aria-selected') === 'true')?.dataset.codeTab); -}); - -document.querySelectorAll('[data-copy-target]').forEach((button) => { - button.addEventListener('click', async () => { - const target = document.getElementById(button.dataset.copyTarget); - - if (!target) { - return; - } - - const originalLabel = button.textContent; - - try { - await navigator.clipboard.writeText(target.textContent.trim()); - button.textContent = 'Copied'; - } catch { - button.textContent = 'Copy unavailable'; - } - - window.setTimeout(() => { - button.textContent = originalLabel; - }, 4000); - }); -}); diff --git a/docs/assets/styles.css b/docs/assets/styles.css deleted file mode 100644 index 60c2f77..0000000 --- a/docs/assets/styles.css +++ /dev/null @@ -1,1044 +0,0 @@ -.section { - padding-block: clamp(88px, 10vw, 152px); -} -.section-muted { - background: var(--paper-muted); -} - -.section-heading { - max-width: 580px; -} - -.section-heading-wide { - max-width: 880px; -} - -.section-heading h2, -.accessibility h2, -.closing h2 { - font-size: clamp(48px, 5.6vw, 84px); -} - -.section-heading p { - max-width: 700px; - margin: 28px 0 0; - color: var(--muted); - font-size: 19px; -} - -.installation-layout { - display: grid; - grid-template-columns: minmax(320px, 0.8fr) minmax(520px, 1.2fr); - gap: clamp(56px, 9vw, 140px); -} - -.installation-steps { - min-width: 0; -} - -.code-window { - overflow: hidden; - border: 1px solid #292929; - border-radius: var(--radius-medium); - background: #0d1117; - box-shadow: 0 20px 50px rgb(0 0 0 / 18%); - color: #f2f2f2; -} - -.code-toolbar { - display: flex; - min-height: 48px; - align-items: center; - justify-content: space-between; - gap: 20px; - padding: 0 18px; - border-bottom: 1px solid #292929; - color: #8e949d; - font-family: var(--font-mono); - font-size: 12px; -} - -.copy-button { - padding: 6px 9px; - border: 1px solid #3a3f47; - border-radius: 6px; - background: transparent; - color: #d7d9dc; - font-family: var(--font-sans); - font-size: 12px; - font-weight: 750; - cursor: pointer; -} - -.copy-button:hover { - border-color: var(--ember-light); - color: var(--paper); -} - -pre { - margin: 0; - overflow-x: auto; - padding: 24px; - font-family: var(--font-mono); - font-size: 13px; - line-height: 1.75; - tab-size: 2; -} - -pre code { - color: #f2b390; -} - -.code-window-compact pre code::first-line { - color: #f2f2f2; -} - -.requirements { - display: grid; - grid-template-columns: repeat(2, minmax(0, 1fr)); - margin-top: 28px; - border-top: 1px solid var(--line); - border-left: 1px solid var(--line); -} - -.requirements div { - display: grid; - min-height: 98px; - align-content: center; - gap: 4px; - padding: 20px; - border-right: 1px solid var(--line); - border-bottom: 1px solid var(--line); -} - -.requirements span { - color: var(--muted); - font-size: 12px; - font-weight: 750; - letter-spacing: 0.08em; - text-transform: uppercase; -} - -.requirements strong { - font-size: 15px; -} - -.demo-rail { - display: grid; - grid-template-columns: repeat(6, minmax(168px, 1fr)); - gap: clamp(16px, 2vw, 28px); - margin-top: 70px; -} - -.demo-item { - min-width: 0; - margin: 0; -} - -.demo-item-lifted { - transform: translateY(34px); -} - -.screenshot-frame { - position: relative; - overflow: hidden; - aspect-ratio: 402 / 874; -} - -.screenshot-frame::after { - position: absolute; - inset: 0; - border: 1px solid rgb(255 255 255 / 22%); - border-radius: 32px; - content: ""; - pointer-events: none; -} - -.screenshot-frame img { - width: 100%; - height: 100%; - object-fit: cover; - object-position: top center; -} - -.demo-item figcaption { - display: flex; - align-items: baseline; - justify-content: space-between; - gap: 10px; - margin-top: 18px; -} - -.demo-item figcaption strong { - font-size: 18px; -} - -.demo-item figcaption span { - color: var(--muted); - font-size: 11px; - font-weight: 800; - letter-spacing: 0.08em; - text-transform: uppercase; -} - -.evidence-disclosure { - border-block: 1px solid var(--line); - background: var(--paper); -} - -.evidence-disclosure > summary { - display: grid; - width: min(calc(100% - 80px), var(--shell)); - min-height: 150px; - align-content: center; - grid-template-columns: minmax(170px, 0.35fr) minmax(240px, 0.65fr) minmax(320px, 1fr) auto; - align-items: baseline; - gap: 24px 48px; - margin-inline: auto; - cursor: pointer; - list-style-position: outside; -} - -.evidence-disclosure > summary::marker { - color: var(--ember-dark); -} - -.evidence-disclosure > summary strong { - font-size: clamp(24px, 2.4vw, 36px); - letter-spacing: -0.04em; - line-height: 1.1; -} - -.evidence-disclosure > summary > span:last-child { - color: var(--ember-dark); -} - -.evidence-disclosure > summary > span:nth-child(3) { - color: var(--muted); - font-size: 15px; -} - -.evidence-summary-action { - font-size: 13px; - font-weight: 800; - white-space: nowrap; -} - -.evidence-summary-action .when-open, -.evidence-disclosure[open] .evidence-summary-action .when-closed { - display: none; -} - -.evidence-disclosure[open] .evidence-summary-action .when-open { - display: inline; -} - -.evidence-summary-kicker { - color: var(--ember-dark); - font-size: 12px; - font-weight: 800; - letter-spacing: 0.1em; - text-transform: uppercase; -} - -.evidence-disclosure[open] > summary { - border-bottom: 1px solid var(--line); -} - -.coverage-gallery { - border-bottom: 1px solid var(--line); -} - -.coverage-grid { - display: grid; - grid-template-columns: repeat(2, minmax(0, 1fr)); - gap: 1px; - margin-top: 72px; - border: 1px solid var(--line); - background: var(--line); -} - -.coverage-item { - padding: clamp(24px, 4vw, 44px); - background: var(--surface); -} - -.grid-surface .coverage-item:last-child:nth-child(odd) { - grid-column: 1 / -1; -} - -.coverage-heading { - display: flex; - align-items: baseline; - justify-content: space-between; - gap: 20px; - margin-bottom: 30px; -} - -.coverage-heading h3, -.coverage-heading p, -.coverage-platforms figure { - margin: 0; -} - -.coverage-heading h3 { - font-size: 24px; - letter-spacing: -0.03em; -} - -.coverage-heading p { - max-width: 250px; - color: var(--muted); - font-size: 13px; - text-align: right; -} - -.grid-surface .coverage-heading p, -.grid-surface .coverage-platforms figcaption { - color: var(--muted-on-dark); -} - -.coverage-platforms { - display: grid; - grid-template-columns: repeat(2, minmax(0, 1fr)); - gap: clamp(16px, 3vw, 32px); -} - -.coverage-item-research .coverage-platforms { - width: min(100%, 860px); - margin-inline: auto; -} - -.coverage-platforms figcaption { - margin-top: 12px; - color: var(--muted); - font-size: 11px; - font-weight: 800; - letter-spacing: 0.08em; - text-align: center; - text-transform: uppercase; -} - -.coverage-grid-performance .coverage-item { - background: var(--paper); -} - -.biyuyo-gallery { - border-top: 1px solid var(--line); - border-bottom: 1px solid var(--line); -} - -.section-kicker { - margin-bottom: 18px !important; - color: var(--ember) !important; - font-size: 12px !important; - font-weight: 800; - letter-spacing: 0.12em; - text-transform: uppercase; -} - -.biyuyo-gallery-group { - margin-top: 72px; -} - -.biyuyo-gallery-group h3 { - margin: 0; - color: var(--muted); - font-size: 12px; - font-weight: 800; - letter-spacing: 0.12em; - text-transform: uppercase; -} - -.biyuyo-grid { - display: grid; - grid-template-columns: repeat(4, minmax(0, 1fr)); - gap: clamp(18px, 3vw, 38px); - margin-top: 24px; -} - -.biyuyo-grid figure { - min-width: 0; - margin: 0; -} - -.biyuyo-grid figcaption { - display: flex; - align-items: baseline; - justify-content: space-between; - gap: 12px; - margin-top: 16px; -} - -.biyuyo-grid figcaption strong { - font-size: 16px; -} - -.biyuyo-grid figcaption span { - color: var(--muted); - font-size: 10px; - font-weight: 800; - letter-spacing: 0.08em; - text-transform: uppercase; -} - -.api-showcase { - display: grid; - grid-template-columns: minmax(0, 1.25fr) minmax(340px, 0.75fr); - align-items: start; - gap: clamp(46px, 8vw, 120px); - margin-top: 72px; -} - -.api-showcase[data-has-preview="false"] { - grid-template-columns: minmax(0, 1fr); -} - -.api-showcase[data-has-preview="false"] .code-demo { - width: min(100%, 960px); -} - -.code-demo { - min-width: 0; -} - -.code-tabs { - display: flex; - gap: clamp(24px, 3vw, 40px); - margin-bottom: 18px; - border-bottom: 1px solid var(--line); - overflow-x: auto; - overscroll-behavior-inline: contain; - scrollbar-width: thin; -} - -.code-tabs button { - position: relative; - flex: 0 0 auto; - padding: 12px 0 14px; - border: 0; - background: transparent; - color: var(--muted); - font-size: 15px; - font-weight: 800; - cursor: pointer; -} - -.code-tabs button[aria-selected="true"] { - color: var(--ember); -} - -.code-tabs button[aria-selected="true"]::after { - position: absolute; - right: 0; - bottom: -1px; - left: 0; - height: 3px; - background: var(--ember); - content: ""; -} - -.code-panel[hidden] { - display: none; -} - -.code-panel pre { - min-height: 470px; -} - -.api-preview { - width: min(100%, 430px); - margin: -96px auto 0; -} - -.demo-panel { - display: grid; - grid-template-columns: repeat(2, minmax(0, 1fr)); - gap: 18px; -} - -.demo-panel[hidden] { - display: none; -} - -.demo-panel figure { - margin: 0; -} - -.screenshot-frame video { - display: block; - width: 100%; - height: 100%; - object-fit: cover; - object-position: top center; -} - -.demo-panel figcaption, -.api-preview-caption { - color: var(--muted); - font-size: 11px; - font-weight: 750; - text-align: center; -} - -.demo-panel figcaption { - margin-top: 12px; - letter-spacing: 0.06em; - text-transform: uppercase; -} - -.api-preview-caption { - margin: 20px 0 0; - font-size: 13px; -} - -.reference-grid { - display: grid; - grid-template-columns: repeat(4, minmax(0, 1fr)); - margin-top: 110px; - border-top: 1px solid var(--line); - border-left: 1px solid var(--line); -} - -.reference-grid article { - min-height: 280px; - padding: 30px; - border-right: 1px solid var(--line); - border-bottom: 1px solid var(--line); -} - -.reference-grid article > span { - color: var(--ember); - font-family: var(--font-mono); - font-size: 12px; - font-weight: 800; -} - -.reference-grid h3 { - margin: 58px 0 10px; - font-size: 22px; - letter-spacing: -0.03em; -} - -.reference-grid p { - margin: 0; - color: var(--muted); - font-size: 15px; -} - -.reference-grid code { - color: var(--text); - font-family: var(--font-mono); - font-size: 0.92em; -} - -.reference-link { - display: flex; - align-items: center; - justify-content: space-between; - gap: 32px; - padding: 28px 30px; - border: 1px solid var(--line); - border-top: 0; -} - -.reference-link p { - margin: 0; - color: var(--muted); -} - -.reference-link a { - flex: 0 0 auto; - color: var(--ember-dark); - font-weight: 800; - text-decoration: none; -} - -.section-ember { - background: var(--ember-action); - color: var(--paper); -} - -.accessibility-layout { - display: grid; - grid-template-columns: minmax(0, 1.1fr) minmax(360px, 0.9fr); - align-items: end; - gap: clamp(60px, 11vw, 170px); -} - -.accessibility h2 { - font-size: clamp(44px, 5vw, 76px); -} - -.accessibility-layout > div p { - max-width: 610px; - margin: 24px 0 0; - color: #ffd6c2; - font-size: 19px; -} - -.accessibility-contract { - margin: 0; - padding: 32px 0 10px 32px; - border-left: 2px solid rgb(255 255 255 / 52%); -} - -.accessibility-contract div { - display: grid; - grid-template-columns: minmax(96px, .45fr) 1fr; - gap: 18px; - padding: 15px 0; - border-bottom: 1px solid rgb(255 255 255 / 30%); -} - -.accessibility-contract dt { - font-size: 12px; - font-weight: 750; - letter-spacing: .08em; - text-transform: uppercase; -} - -.accessibility-contract dd { - margin: 0; - font-size: clamp(17px, 1.55vw, 22px); - font-weight: 750; - line-height: 1.3; -} - -.accessibility-contract code { - font-size: .86em; -} - -.closing { - padding-block: 110px; -} - -.closing-layout { - display: flex; - align-items: end; - justify-content: space-between; - gap: 60px; -} - -.closing h2 { - font-size: clamp(48px, 5vw, 76px); -} - -.closing-actions { - flex: 0 0 auto; - margin: 0; -} - -.site-footer { - padding-block: 50px; - border-top: 1px solid var(--line-dark); - background: var(--ink); - color: var(--paper); -} - -.chart-coverage { - display: grid; - grid-template-columns: repeat(4, minmax(0, 1fr)); - gap: 1px; - margin-top: 2rem; - background: var(--line); - border: 1px solid var(--line); -} - -.chart-coverage article { - color: var(--paper); - display: flex; - flex-direction: column; - justify-content: space-between; - min-height: 7rem; - padding: 1.25rem; - background: var(--surface); -} - -.chart-coverage strong, -.chart-coverage span { - display: block; -} - -.chart-coverage strong { - color: var(--paper); - font-size: 1.15rem; - letter-spacing: -.02em; -} - -.chart-coverage span { - color: #aaa7a4; - font-size: .85rem; - line-height: 1.45; -} - -.faq-layout, -.guide-layout { - display: grid; - grid-template-columns: minmax(0, .75fr) minmax(0, 1.25fr); - gap: clamp(2rem, 7vw, 7rem); -} - -.faq-list { - border-top: 1px solid var(--line); -} - -.faq-list details { - border-bottom: 1px solid var(--line); - padding: 1.15rem 0; -} - -.faq-list summary { - cursor: pointer; - font-weight: 700; -} - -.faq-list p { - color: var(--muted); - line-height: 1.65; - margin: .85rem 2rem .1rem 0; -} - -.faq-list a, -.guide-content a { - color: var(--ember); -} - -.guide-hero { - padding: clamp(8rem, 14vw, 12rem) 0 clamp(3.5rem, 8vw, 7rem); -} - -.guide-hero .eyebrow { - color: var(--ember); - font-size: .78rem; - font-weight: 800; - letter-spacing: .12em; - text-transform: uppercase; -} - -.guide-hero h1 { - font-size: clamp(2.75rem, 7vw, 6.5rem); - letter-spacing: -.065em; - line-height: .94; - margin: .8rem 0 1.4rem; - max-width: 12ch; -} - -.guide-hero p { - color: var(--muted); - font-size: clamp(1.05rem, 2vw, 1.35rem); - line-height: 1.6; - max-width: 45rem; -} - -.guide-content { - min-width: 0; - max-width: 48rem; -} - -.guide-content h2 { - font-size: clamp(1.7rem, 3.4vw, 2.8rem); - letter-spacing: -.04em; - line-height: 1.05; - margin: 3.5rem 0 1rem; -} - -.guide-content h3 { - font-size: 1.15rem; - margin: 2rem 0 .65rem; -} - -.guide-content p, -.guide-content li { - color: var(--muted); - line-height: 1.72; -} - -.guide-content ul { - padding-left: 1.2rem; -} - -.guide-content pre { - overflow-x: auto; - padding: 1.25rem; - background: #111; - border: 1px solid var(--line); - color: #f6f1eb; - line-height: 1.55; -} - -.guide-aside { - align-self: start; - border-top: 2px solid var(--ember); - padding-top: 1rem; - position: sticky; - top: 7rem; -} - -.guide-aside a { - color: var(--muted); - display: block; - margin: .75rem 0; -} - -.guide-aside a:hover, -.guide-aside a:focus-visible { - color: var(--ink); -} - -@media (max-width: 820px) { - .chart-coverage { - grid-template-columns: repeat(2, minmax(0, 1fr)); - } - - .faq-layout, - .guide-layout { - grid-template-columns: 1fr; - } - - .guide-aside { - position: static; - } -} - -.footer-layout { - display: grid; - grid-template-columns: 1fr auto; - align-items: center; - gap: 24px 48px; -} - -.brand-footer img { - width: 44px; -} - -.site-footer nav { - display: flex; - flex-wrap: wrap; - justify-content: flex-end; - gap: 12px 28px; -} - -.site-footer nav a { - color: #aaa7a4; - font-size: 13px; - text-decoration: none; -} - -.site-footer nav a:hover { - color: var(--paper); -} - -.site-footer p { - grid-column: 1 / -1; - margin: 0; - color: #666360; - font-size: 12px; -} - -@media (max-width: 1120px) { - .demo-rail { - margin-right: calc((100vw - 100%) / -2); - padding-right: 40px; - grid-template-columns: repeat(6, 190px); - overflow-x: auto; - overscroll-behavior-inline: contain; - scroll-snap-type: inline mandatory; - scrollbar-width: thin; - } - - .demo-item { - scroll-snap-align: start; - } - - .reference-grid { - grid-template-columns: repeat(2, minmax(0, 1fr)); - } - - .closing-layout { - display: grid; - } - - .closing-actions { - margin-top: 0; - } -} - -@media (max-width: 860px) { - .installation-layout, - .api-showcase, - .accessibility-layout { - grid-template-columns: 1fr; - } - - .api-preview { - width: min(100%, 480px); - margin-top: 0; - } - - .reference-grid { - margin-top: 72px; - } - - .accessibility-contract { - max-width: 620px; - } - - .biyuyo-grid { - grid-template-columns: repeat(2, minmax(0, 1fr)); - } - - .evidence-disclosure > summary { - width: min(calc(100% - 40px), var(--shell)); - grid-template-columns: minmax(160px, 0.45fr) 1fr auto; - } - - .evidence-disclosure > summary > span:nth-child(3) { - grid-column: 1 / -1; - } -} - -@media (max-width: 620px) { - .section { - padding-block: 82px; - } - - .section-heading h2, - .accessibility h2, - .closing h2 { - font-size: clamp(42px, 12vw, 58px); - } - - .section-heading p, - .accessibility-layout > div p { - font-size: 17px; - } - - .installation-layout { - gap: 42px; - } - - pre { - padding: 19px; - font-size: 11px; - } - - .requirements { - grid-template-columns: 1fr; - } - - .demo-rail { - margin-top: 52px; - margin-right: -16px; - padding-right: 16px; - grid-template-columns: repeat(6, minmax(210px, 68vw)); - } - - .demo-item-lifted { - transform: none; - } - - .evidence-disclosure > summary { - width: min(calc(100% - 32px), var(--shell)); - min-height: 176px; - grid-template-columns: 1fr; - gap: 8px; - } - - .evidence-disclosure > summary > span:nth-child(3) { - grid-column: auto; - } - - .coverage-grid { - grid-template-columns: 1fr; - margin-top: 52px; - } - - .grid-surface .coverage-item:last-child:nth-child(odd) { - grid-column: auto; - } - - .coverage-heading { - align-items: flex-start; - flex-direction: column; - gap: 8px; - } - - .coverage-heading p { - text-align: left; - } - - .biyuyo-gallery-group { - margin-top: 52px; - } - - .biyuyo-grid { - margin-right: -16px; - padding-right: 16px; - grid-template-columns: repeat(4, minmax(220px, 70vw)); - overflow-x: auto; - overscroll-behavior-inline: contain; - scroll-snap-type: inline mandatory; - scrollbar-width: thin; - } - - .biyuyo-grid figure { - scroll-snap-align: start; - } - - .code-tabs { - gap: 28px; - } - - .code-panel pre { - min-height: 430px; - } - - .reference-grid { - grid-template-columns: 1fr; - } - - .reference-grid article { - min-height: auto; - } - - .reference-grid h3 { - margin-top: 30px; - } - - .reference-link { - align-items: flex-start; - flex-direction: column; - } - - .accessibility-contract { - padding-left: 22px; - } - - .closing { - padding-block: 82px; - } - - .footer-layout { - grid-template-columns: 1fr; - } - - .site-footer nav { - justify-content: flex-start; - } -} - -@media (prefers-reduced-motion: reduce) { - html { - scroll-behavior: auto; - } - - *, - *::before, - *::after { - scroll-behavior: auto !important; - transition-duration: 0.01ms !important; - animation-duration: 0.01ms !important; - animation-iteration-count: 1 !important; - } -} diff --git a/docs/astro.config.mjs b/docs/astro.config.mjs new file mode 100644 index 0000000..c8328f8 --- /dev/null +++ b/docs/astro.config.mjs @@ -0,0 +1,35 @@ +// @ts-check +import { defineConfig } from 'astro/config'; +import starlight from '@astrojs/starlight'; + +const base = '/nativephp-charts'; + +export default defineConfig({ + site: 'https://donmanueldev.github.io', + base, + integrations: [ + starlight({ + title: 'NativePHP Charts', + description: 'Compiled-native charts for NativePHP Mobile.', + disable404Route: true, + logo: { src: './public/brand/nativephp-charts-mark.svg', replacesTitle: false }, + favicon: "/favicon.svg", + social: [{ icon: 'github', label: 'GitHub', href: 'https://github.com/donmanueldev/nativephp-charts' }], + customCss: ['./src/styles/docs.css'], + head: [{ tag: 'script', attrs: { src: `${base}/site.js`, defer: true } }], + editLink: { baseUrl: 'https://github.com/donmanueldev/nativephp-charts/edit/main/docs/' }, + sidebar: [ + { + label: 'Getting started', items: [ + { label: 'Overview', slug: 'getting-started/overview' }, + { label: 'Installation', slug: 'getting-started/installation' }, + ] + }, + { label: 'Charts', items: [{ autogenerate: { directory: 'charts' } }] }, + { label: 'Guides', items: [{ autogenerate: { directory: 'guides' } }] }, + { label: 'Reference', items: [{ label: 'API reference', slug: 'reference/api' }] }, + { label: 'Showcase', items: [{ label: 'Apps using NativePHP Charts', slug: 'apps' }] }, + ], + }), + ], +}); diff --git a/docs/bun.lock b/docs/bun.lock new file mode 100644 index 0000000..67d390b --- /dev/null +++ b/docs/bun.lock @@ -0,0 +1,916 @@ +{ + "lockfileVersion": 1, + "configVersion": 1, + "workspaces": { + "": { + "name": "nativephp-charts-docs", + "dependencies": { + "@astrojs/starlight": "^0.42.1", + "astro": "^7.3.2", + }, + "devDependencies": { + "@astrojs/check": "^0.9.6", + "typescript": "^5.9.2", + }, + }, + }, + "packages": { + "@astrojs/check": ["@astrojs/check@0.9.10", "", { "dependencies": { "@astrojs/language-server": "^2.16.7", "chokidar": "^4.0.3", "kleur": "^4.1.5", "yargs": "^18.0.0" }, "peerDependencies": { "typescript": "^5.0.0 || ^6.0.0" }, "bin": { "astro-check": "./bin/astro-check.js" } }, "sha512-zgx/UQMozdjOa3bOxjgeCFdtpE3c9rRX6xHwa+2QXvy8z8Akifu2AtubHyv/zzC2znO8dl8fFWL4K+Ba9kS8HQ=="], + + "@astrojs/compiler": ["@astrojs/compiler@2.13.1", "", {}, "sha512-f3FN83d2G/v32ipNClRKgYv30onQlMZX1vCeZMjPsMMPl1mDpmbl0+N5BYo4S/ofzqJyS5hvwacEo0CCVDn/Qg=="], + + "@astrojs/compiler-binding": ["@astrojs/compiler-binding@0.4.1", "", { "optionalDependencies": { "@astrojs/compiler-binding-android-arm64": "0.4.1", "@astrojs/compiler-binding-darwin-arm64": "0.4.1", "@astrojs/compiler-binding-darwin-x64": "0.4.1", "@astrojs/compiler-binding-linux-arm64-gnu": "0.4.1", "@astrojs/compiler-binding-linux-arm64-musl": "0.4.1", "@astrojs/compiler-binding-linux-x64-gnu": "0.4.1", "@astrojs/compiler-binding-linux-x64-musl": "0.4.1", "@astrojs/compiler-binding-wasm32-wasi": "0.4.1", "@astrojs/compiler-binding-win32-arm64-msvc": "0.4.1", "@astrojs/compiler-binding-win32-x64-msvc": "0.4.1" } }, "sha512-ZYVDW1P58OXyxqZbOMp+/2U9KA7y2esIx9r4pWdpZ/l6fCZhaw4ul+D7EgpRVxYLkyTWqzANbTTUFGPFP8zDHA=="], + + "@astrojs/compiler-binding-android-arm64": ["@astrojs/compiler-binding-android-arm64@0.4.1", "", { "os": "android", "cpu": "arm64" }, "sha512-Wtx2DZORuNTLASLLZ8hlrjFaJe1LUloatcCn9EPq7knBhRpjMGXeJANIJMeBZG4igvz7x+3nyAJM2iwCSW9xog=="], + + "@astrojs/compiler-binding-darwin-arm64": ["@astrojs/compiler-binding-darwin-arm64@0.4.1", "", { "os": "darwin", "cpu": "arm64" }, "sha512-7iwXcU+hB60Y1SvOfnWHNioT72gDsDQKaDipXh2Onwp/TvQMozhbvhy13wJR8Af940a0h6PbddCeJFpj791UDA=="], + + "@astrojs/compiler-binding-darwin-x64": ["@astrojs/compiler-binding-darwin-x64@0.4.1", "", { "os": "darwin", "cpu": "x64" }, "sha512-pifjICos49RXhSVKSDu5gDB0/8j0O7DmxSp1DaWW2PyLG5ekwSkcrfOZto5JqhdI7QYMZB3XOiXpsdOXpS4npA=="], + + "@astrojs/compiler-binding-linux-arm64-gnu": ["@astrojs/compiler-binding-linux-arm64-gnu@0.4.1", "", { "os": "linux", "cpu": "arm64" }, "sha512-hsZMlNWc6LqWHh9LlSwTq1/XCY7pxA5rkkKIdZRV8mgbOz9OwLvjEoe5Jry13eIZjMUQO8XnQyzk8o/Pjw2YFA=="], + + "@astrojs/compiler-binding-linux-arm64-musl": ["@astrojs/compiler-binding-linux-arm64-musl@0.4.1", "", { "os": "linux", "cpu": "arm64" }, "sha512-a3EW27f+Z9uf57vYmpLgUriA1y9wDhKz57PT8D8XlFZt2HZEWhUxKuxI1jvKVI9p8okYee11WXEm/FHY1G9yoQ=="], + + "@astrojs/compiler-binding-linux-x64-gnu": ["@astrojs/compiler-binding-linux-x64-gnu@0.4.1", "", { "os": "linux", "cpu": "x64" }, "sha512-XruPTKB/SS4DFzeAjQ1ZyM0ieHDjapHkOSnnzRApZ4FXY2YAI7UY3mETjfJiIS/acyZyrnPH5jObv1gATTdUJQ=="], + + "@astrojs/compiler-binding-linux-x64-musl": ["@astrojs/compiler-binding-linux-x64-musl@0.4.1", "", { "os": "linux", "cpu": "x64" }, "sha512-E8j7lGanqNpudtkUbsFaOLJhmwFe4Ecqux7K9hkj4wULIPNZRM2bYZNcMSj8r1oWvaUiwZl8LaaNwv3+14jqhw=="], + + "@astrojs/compiler-binding-wasm32-wasi": ["@astrojs/compiler-binding-wasm32-wasi@0.4.1", "", { "dependencies": { "@napi-rs/wasm-runtime": "1.2.4" }, "cpu": "none" }, "sha512-vNLxIv41ZE+nmPFtw24cRW5ZXG+ZPcAGtgigtjCP8lvcxKI7u2GrXoMsCgEH5fMw8WCEJpwLvsVBg15rJKAkyA=="], + + "@astrojs/compiler-binding-win32-arm64-msvc": ["@astrojs/compiler-binding-win32-arm64-msvc@0.4.1", "", { "os": "win32", "cpu": "arm64" }, "sha512-/xTDgRsFDoTh0/+KFXJ74DY4Jqn8CoSHwa8UP5RAblHfnRHkenwfSl4zYDET61O9vXKLk09UzHjjq09yP20/AQ=="], + + "@astrojs/compiler-binding-win32-x64-msvc": ["@astrojs/compiler-binding-win32-x64-msvc@0.4.1", "", { "os": "win32", "cpu": "x64" }, "sha512-0x5J6iHZO0Fjo/CVzoIbXKzWnGESftDbEUQ/oXQ61HhUAFoR7+T1jfToZSNAS+gYyBXHSTpMWYC7lzarbhClcg=="], + + "@astrojs/compiler-rs": ["@astrojs/compiler-rs@0.4.1", "", { "dependencies": { "@astrojs/compiler-binding": "0.4.1" } }, "sha512-//NmAuRhy7eU9iP0ceI5Pymy55M+nUZ//kS6XeOyhBWdDib2KbJOyFaVJ52k7sDkJwTKVox7oPu3SpYiVnGm5A=="], + + "@astrojs/internal-helpers": ["@astrojs/internal-helpers@0.11.0", "", { "dependencies": { "@types/hast": "3.0.5", "@types/mdast": "4.0.4", "js-yaml": "4.3.2", "picomatch": "4.0.7", "retext-smartypants": "6.2.0", "shiki": "4.4.3", "smol-toml": "1.8.0", "unified": "11.0.5" } }, "sha512-3rzxJ+xbo0+8YyqOzLziIN32wmsHdCjEVz2sGOpRxJ+Ben/KiLph4ItxBy1abEL+E8fkRzqjg0rfXmaHJGw9JA=="], + + "@astrojs/language-server": ["@astrojs/language-server@2.16.16", "", { "dependencies": { "@astrojs/compiler": "^2.13.1", "@astrojs/yaml2ts": "^0.2.4", "@jridgewell/sourcemap-codec": "^1.5.5", "@volar/kit": "~2.4.28", "@volar/language-core": "~2.4.28", "@volar/language-server": "~2.4.28", "@volar/language-service": "~2.4.28", "muggle-string": "^0.4.1", "tinyglobby": "^0.2.16", "volar-service-css": "0.0.71", "volar-service-emmet": "0.0.71", "volar-service-html": "0.0.71", "volar-service-prettier": "0.0.71", "volar-service-typescript": "0.0.71", "volar-service-typescript-twoslash-queries": "0.0.71", "volar-service-yaml": "0.0.71", "vscode-html-languageservice": "^5.6.2", "vscode-uri": "^3.1.0" }, "peerDependencies": { "prettier": "^3.0.0", "prettier-plugin-astro": ">=0.11.0" }, "optionalPeers": ["prettier", "prettier-plugin-astro"], "bin": { "astro-ls": "./bin/nodeServer.js" } }, "sha512-KuS17AOOqH/M5mHXPmKvtp8L+NNteARC7Xjf395+9R9dtJOBndqdStwU4V+OKzYZpgZ+hliV13knzx/oMtFl7Q=="], + + "@astrojs/markdown-satteri": ["@astrojs/markdown-satteri@0.4.1", "", { "dependencies": { "@astrojs/internal-helpers": "0.11.0", "@astrojs/prism": "4.0.2", "github-slugger": "2.0.0", "satteri": "0.10.5" } }, "sha512-EniHbFNa6SQHDih7JnpPos3NWXO6hdt4raBcOosfGmlfc3gP9CI/sESA3VOf1PgJZ7SFfewlZW9Livn0JugEZg=="], + + "@astrojs/mdx": ["@astrojs/mdx@8.0.1", "", { "dependencies": { "@astrojs/internal-helpers": "0.11.0", "@astrojs/markdown-satteri": "0.4.1", "es-module-lexer": "^2.0.0" }, "peerDependencies": { "@astrojs/markdown-remark": "^7.3.0", "astro": "^7.2.6" }, "optionalPeers": ["@astrojs/markdown-remark"] }, "sha512-VKodp/f3+XE6L0950K+ZOAolY47vdt0R78Ao+L2RdJ1hfAdYffL7IEjc/MsoyuS7CPVvCsd5/I3RP0ZyAIewdQ=="], + + "@astrojs/prism": ["@astrojs/prism@4.0.2", "", { "dependencies": { "prismjs": "1.30.0" } }, "sha512-KTivpmnz6lDsC6o9H4+DNm2SrE/GHzw8cNAvEJwAvUT+eoaEnn/4NtbDNfRRaxaJHdp15gf+tfHAWiXR4wB3BA=="], + + "@astrojs/sitemap": ["@astrojs/sitemap@3.7.4", "", { "dependencies": { "sitemap": "^9.0.0", "zod": "^4.3.6" } }, "sha512-LbKNC24bdUWcQf/pThB6qLlSqHojxGjZDURIzFocY8rlWnAn2t74nnhnK6S5x0NHriHoAduLEpVjRykmeGiVvA=="], + + "@astrojs/starlight": ["@astrojs/starlight@0.42.1", "", { "dependencies": { "@astrojs/markdown-satteri": "^0.4.0", "@astrojs/mdx": "^8.0.0", "@astrojs/sitemap": "^3.7.3", "@pagefind/default-ui": "^1.3.0", "@types/hast": "^3.0.5", "@types/js-yaml": "^4.0.9", "@types/mdast": "^4.0.4", "astro-expressive-code": "^0.44.0", "bcp-47": "^2.1.0", "hast-util-format": "^1.1.0", "hast-util-select": "^6.0.4", "hast-util-to-html": "^9.0.5", "hast-util-to-string": "^3.0.1", "hastscript": "^9.0.1", "i18next": "^26.0.7", "js-yaml": "^4.1.1", "klona": "^2.0.6", "magic-string": "^1.2.3", "mdast-util-directive": "^3.1.0", "mdast-util-to-markdown": "^2.1.2", "mdast-util-to-string": "^4.0.0", "pagefind": "^1.5.2", "remark-directive": "^4.0.0", "satteri": "^0.10.3", "ultrahtml": "^1.6.0", "unified": "^11.0.5", "unist-util-visit": "^5.1.0", "vfile": "^6.0.3" }, "peerDependencies": { "@astrojs/markdown-remark": "^7.3.0", "astro": "^7.2.10" }, "optionalPeers": ["@astrojs/markdown-remark"] }, "sha512-ABS/A0IfbJeMbuhCKVkrAcO3EWxhpeLveFuL28+7+BQje7ZHa9OXZbUoiLXdYUhH7XFaiAQjAg44RiF2uuZPJw=="], + + "@astrojs/telemetry": ["@astrojs/telemetry@3.3.3", "", { "dependencies": { "ci-info": "4.4.0", "dset": "3.1.4", "is-docker": "4.0.0", "package-manager-detector": "1.8.0" } }, "sha512-C1TLn5sPJr0x4vk56piHWKbnqlEB8BKyte5Y45V02U+D7BGO5eMqZDH5aPjnkXQWJggvmsTXxH03QMZ9NgWLzQ=="], + + "@astrojs/yaml2ts": ["@astrojs/yaml2ts@0.2.4", "", { "dependencies": { "yaml": "^2.8.3" } }, "sha512-8oddpOae35pJsXPQXhTkM0ypfKPskVsh2bCxRtbf7e+/Epw2nReakFYpLKjZMEr75CsoF203PMnCocpfz0s69A=="], + + "@babel/helper-string-parser": ["@babel/helper-string-parser@7.29.7", "", {}, "sha512-Pb5ijPrZ89GDH8223L4UP8i6QApWxs04RbPQJTeWDV0/keR2E36MeKnyr6LYmUUvqRRI+Iv87SuF1W6ErINzYw=="], + + "@babel/helper-validator-identifier": ["@babel/helper-validator-identifier@7.29.7", "", {}, "sha512-qehxGkRj55h/ff8EMaJ+cYhyaKlHIxqYDn682wQD7RNp9UujOQsHog2uS0r2vzr4pW+sXf90NeeayjcNaX3fFg=="], + + "@babel/parser": ["@babel/parser@7.29.8", "", { "dependencies": { "@babel/types": "7.29.8" }, "bin": "./bin/babel-parser.js" }, "sha512-E8lTAYNB1KW+FH+VGJuZM1ioAx2E6oVlvQFRrf5P8ZZmsiJXYAD9vTFV7yyEURNzgh1dFqMZuO6tUwcARbqFCA=="], + + "@babel/types": ["@babel/types@7.29.8", "", { "dependencies": { "@babel/helper-string-parser": "7.29.7", "@babel/helper-validator-identifier": "7.29.7" } }, "sha512-Vj1jF3cPfxg7OAfoI7QnVKLoILlm2JF9pnVHrX8qx7AHMiYWT+NDAA7jChlNgRS4WTLc/fD1lXLmPixluj+3Gg=="], + + "@bruits/satteri-darwin-arm64": ["@bruits/satteri-darwin-arm64@0.10.5", "", { "os": "darwin", "cpu": "arm64" }, "sha512-27KTVl4TJkVahMy/ohyA7qd4938G5UNneFUz/PsScYfpIhj0IVAS23mpcJXdPF44sa6nva198lmV/cKIb2YPyA=="], + + "@bruits/satteri-darwin-x64": ["@bruits/satteri-darwin-x64@0.10.5", "", { "os": "darwin", "cpu": "x64" }, "sha512-IjnLe3nKspq6qaeqGgjT7MT8VrTV74yWRlaag7ZdNsI8TDAYZ0iPxMCo+9KQZHUk5EyVB+reBI/PFWL5KuFw9Q=="], + + "@bruits/satteri-linux-arm64-gnu": ["@bruits/satteri-linux-arm64-gnu@0.10.5", "", { "os": "linux", "cpu": "arm64" }, "sha512-glkYXZCJywjP13v67eAyAMSJdF+ncvEbYvgi/wOtffL9tQ27lr/zsyzUfgs+ovjJ9d8JNQKiXeiArJcX8PJL9w=="], + + "@bruits/satteri-linux-arm64-musl": ["@bruits/satteri-linux-arm64-musl@0.10.5", "", { "os": "linux", "cpu": "arm64" }, "sha512-yWdgG1g17Nh2QyGVlFUxGRa3FEFwiMcpZEyMNWkbM3deC94cmVc+/i9OuyFpdKuWo3GkgoCtYVOoxk1uCnCZIA=="], + + "@bruits/satteri-linux-x64-gnu": ["@bruits/satteri-linux-x64-gnu@0.10.5", "", { "os": "linux", "cpu": "x64" }, "sha512-FVaLoPT1fBgGl0J+AYebyyXJYBachGl8Oyyrf1lye4RTqCB4S0Gwkj1uM9RJyThUOvx5VUmAT1CnNh1SFHA+kw=="], + + "@bruits/satteri-linux-x64-musl": ["@bruits/satteri-linux-x64-musl@0.10.5", "", { "os": "linux", "cpu": "x64" }, "sha512-EHpVAx2bqW3GINHTKkljtxVfQmVDGWIuwOYOP5YghTj+0PkBa2o8oKPRtQ9Kbsr1Fye8jtUcDjhwj2jMNugZKg=="], + + "@bruits/satteri-wasm32-wasi": ["@bruits/satteri-wasm32-wasi@0.10.5", "", { "dependencies": { "@emnapi/core": "1.11.1", "@emnapi/runtime": "1.11.1", "@napi-rs/wasm-runtime": "1.2.4" }, "cpu": "none" }, "sha512-ypz8c/Zmipxp4IoeDa228Gstv6TLzVmNs3yC6wKCoNSOjx1iwpgzu87Y3hTkXFdwChVGU85qeUDuOIarGUZQLw=="], + + "@bruits/satteri-win32-arm64-msvc": ["@bruits/satteri-win32-arm64-msvc@0.10.5", "", { "os": "win32", "cpu": "arm64" }, "sha512-siTV88nb0LRqNpkL2gXboqCwVdq95sLtzMHS1/3eONV2gLbB3NAK46wmSMvCO/yquBvI2lvaFIfd8P12ecsxBw=="], + + "@bruits/satteri-win32-x64-msvc": ["@bruits/satteri-win32-x64-msvc@0.10.5", "", { "os": "win32", "cpu": "x64" }, "sha512-C3IfPvfvMXmlzBxaMPKFS1XiuV9pu2mC7YqkPk7PSvTgPZ8gbdASIpHpztDLvTTQjqZ0z1Ol8tK5X+V6XXC0wQ=="], + + "@capsizecss/unpack": ["@capsizecss/unpack@4.0.1", "", { "dependencies": { "fontkitten": "1.0.3" } }, "sha512-CuNiSqg7+e1cO/GjffyMOm5Tt2jUF9CWHHnvQ/UkqvtkGfHdgwEC0wpmq7fkN3gxwpRnrAN0WzO3vREKmNolMQ=="], + + "@clack/core": ["@clack/core@1.5.1", "", { "dependencies": { "fast-wrap-ansi": "0.2.2", "sisteransi": "1.0.5" } }, "sha512-iHTrHA8MtVuLl2TfZySmcKv1qO2PoyC9Z7pfSDozEuV5vtY3/wcOPKJXlqJ5Oq2Cx5DDGQGAMVx6HZfRRoVEbQ=="], + + "@clack/prompts": ["@clack/prompts@1.8.1", "", { "dependencies": { "@clack/core": "1.5.1", "fast-string-width": "3.0.2", "fast-wrap-ansi": "0.2.2", "sisteransi": "1.0.5" } }, "sha512-dlT1m5e/0yUL0kRNcQn7yGLVThkgbB0Ga/1AmfDDC/8ik6AIiSf2QLQO2zPYvefsHP0aFgxO93cVLCCfDp7kzQ=="], + + "@ctrl/tinycolor": ["@ctrl/tinycolor@4.2.1", "", {}, "sha512-Vh5uy9Y1JBMId6J1f68TMXnZrTCvNdo9Fu2k0d1YnJngR+sM5kWTKl441c/3TFs+cG0NWOjRWgQ/iaWhbYx+7A=="], + + "@emmetio/abbreviation": ["@emmetio/abbreviation@2.3.3", "", { "dependencies": { "@emmetio/scanner": "^1.0.4" } }, "sha512-mgv58UrU3rh4YgbE/TzgLQwJ3pFsHHhCLqY20aJq+9comytTXUDNGG/SMtSeMJdkpxgXSXunBGLD8Boka3JyVA=="], + + "@emmetio/css-abbreviation": ["@emmetio/css-abbreviation@2.1.8", "", { "dependencies": { "@emmetio/scanner": "^1.0.4" } }, "sha512-s9yjhJ6saOO/uk1V74eifykk2CBYi01STTK3WlXWGOepyKa23ymJ053+DNQjpFcy1ingpaO7AxCcwLvHFY9tuw=="], + + "@emmetio/css-parser": ["@emmetio/css-parser@0.4.1", "", { "dependencies": { "@emmetio/stream-reader": "^2.2.0", "@emmetio/stream-reader-utils": "^0.1.0" } }, "sha512-2bC6m0MV/voF4CTZiAbG5MWKbq5EBmDPKu9Sb7s7nVcEzNQlrZP6mFFFlIaISM8X6514H9shWMme1fCm8cWAfQ=="], + + "@emmetio/html-matcher": ["@emmetio/html-matcher@1.3.0", "", { "dependencies": { "@emmetio/scanner": "^1.0.0" } }, "sha512-NTbsvppE5eVyBMuyGfVu2CRrLvo7J4YHb6t9sBFLyY03WYhXET37qA4zOYUjBWFCRHO7pS1B9khERtY0f5JXPQ=="], + + "@emmetio/scanner": ["@emmetio/scanner@1.0.4", "", {}, "sha512-IqRuJtQff7YHHBk4G8YZ45uB9BaAGcwQeVzgj/zj8/UdOhtQpEIupUhSk8dys6spFIWVZVeK20CzGEnqR5SbqA=="], + + "@emmetio/stream-reader": ["@emmetio/stream-reader@2.2.0", "", {}, "sha512-fXVXEyFA5Yv3M3n8sUGT7+fvecGrZP4k6FnWWMSZVQf69kAq0LLpaBQLGcPR30m3zMmKYhECP4k/ZkzvhEW5kw=="], + + "@emmetio/stream-reader-utils": ["@emmetio/stream-reader-utils@0.1.0", "", {}, "sha512-ZsZ2I9Vzso3Ho/pjZFsmmZ++FWeEd/txqybHTm4OgaZzdS8V9V/YYWQwg5TC38Z7uLWUV1vavpLLbjJtKubR1A=="], + + "@emnapi/core": ["@emnapi/core@1.11.1", "", { "dependencies": { "@emnapi/wasi-threads": "1.2.2", "tslib": "2.8.1" } }, "sha512-RSvbQmHzdKzNsLYa/wHrbc3KN4sYLKAdPZxqiM2HATqv/SBk2/ENSHpvXGaLOMcsAyz0poEGqkmmKYG3OWiJEQ=="], + + "@emnapi/runtime": ["@emnapi/runtime@1.11.1", "", { "dependencies": { "tslib": "2.8.1" } }, "sha512-vgj7R3y3Wgx24IQaGPA/R6YFXLHVMOZ0uVEyIQPaWs+rd1AzfEMXlAC22FYwO1XkKR6NPsq7mUandH8oIRdZFw=="], + + "@emnapi/wasi-threads": ["@emnapi/wasi-threads@1.2.2", "", { "dependencies": { "tslib": "2.8.1" } }, "sha512-c95qOXkHdydNKhscBTebqEC1CVAZpyqOfVfBzQ1qgzyl3gfeldUjIggDbIZgDKsHLgnsM+igH7TJ/eAasaVuMA=="], + + "@esbuild/aix-ppc64": ["@esbuild/aix-ppc64@0.28.2", "", { "os": "aix", "cpu": "ppc64" }, "sha512-XExcO+dvLKvVtNTibSTBej1NCAbaGhWn9Ww1ZPx80qsahhPFe/8jgWP0IchNe0F3HwkU7n8ejhH8bjonqht8mQ=="], + + "@esbuild/android-arm": ["@esbuild/android-arm@0.28.2", "", { "os": "android", "cpu": "arm" }, "sha512-kXXoiPVVGQcnIYGOeaovwOURpniDBpSq4A03qkQ+BMQqtGG6HYap3xne9C1O1yo4TR3qxlCX5IqqmX6fFo2Lqg=="], + + "@esbuild/android-arm64": ["@esbuild/android-arm64@0.28.2", "", { "os": "android", "cpu": "arm64" }, "sha512-5YfKeeI8qWfBZIX+u2xZC3Zlb3Os/gLS2sbEKM+I4ZOcsWmHS2WLysCcQZDAFRslDUU5Oiq44gf6PYN1vGwG5A=="], + + "@esbuild/android-x64": ["@esbuild/android-x64@0.28.2", "", { "os": "android", "cpu": "x64" }, "sha512-O387ite7SzUyCcy3JQX4P4bLtEA7bLLkx+esve5JHnyYfNTxcVpXZo9jhdB0lTKN44gztELTdU7nS8Nr16Fs1Q=="], + + "@esbuild/darwin-arm64": ["@esbuild/darwin-arm64@0.28.2", "", { "os": "darwin", "cpu": "arm64" }, "sha512-n4KqkOQrraxHJcgjM1RvwbigfQKIKJVpM7xp+KsxiyUSrRdIXnt73VhrPAx0fV44hgfmIVKjxMN9J1t5jySVkw=="], + + "@esbuild/darwin-x64": ["@esbuild/darwin-x64@0.28.2", "", { "os": "darwin", "cpu": "x64" }, "sha512-uq6suIWYP37qzGddBKPw5QEQPi6HiLGsO7UmkpfyaYNQ3D+rN6w6WfwH+nuqcGXWvawGwxOEroO4YGnFh95azw=="], + + "@esbuild/freebsd-arm64": ["@esbuild/freebsd-arm64@0.28.2", "", { "os": "freebsd", "cpu": "arm64" }, "sha512-n+I0BTSRIoy+d6RPKnEVwql5UwBJolytvY4mAOIEJorKlqgPII8ix6slVVrfZ5Tnj7glIZvloylbB/EJPMWEXw=="], + + "@esbuild/freebsd-x64": ["@esbuild/freebsd-x64@0.28.2", "", { "os": "freebsd", "cpu": "x64" }, "sha512-78XJTJkvPs0kz2w61301PJjXl4g7q3JqiYMZ/M/yVI73EHBrCRTgkhu9oqG7vPqq+a/yadEW8aD+agKlk5xrmg=="], + + "@esbuild/linux-arm": ["@esbuild/linux-arm@0.28.2", "", { "os": "linux", "cpu": "arm" }, "sha512-XlDnu2q5yoqems+xay6wSAcg9DDD7K9RLKZEBOMZm3ckNpJBvOX20tSfby8KfrrhINDyv9V2YVZKY/SpoGJI8w=="], + + "@esbuild/linux-arm64": ["@esbuild/linux-arm64@0.28.2", "", { "os": "linux", "cpu": "arm64" }, "sha512-pW4AC0P3it8c7do9MVM4p51FzHzdM/TZrerurgRcHJ2WTa1VQ1CIq18xncfpBJw4ojkiZZrKW2yIBWBP92j6Ug=="], + + "@esbuild/linux-ia32": ["@esbuild/linux-ia32@0.28.2", "", { "os": "linux", "cpu": "ia32" }, "sha512-CYbnj78HsIeA+DhgUKgFCfvNsTHFhMMrinUrMZpDXJXKN8T3XViTZ/+wtHeVxEWY8ewSzTFN+nRmSwO2tZaLUQ=="], + + "@esbuild/linux-loong64": ["@esbuild/linux-loong64@0.28.2", "", { "os": "linux", "cpu": "none" }, "sha512-buwkd8nsph4R+ajRvw0qM5Hja/TXQow3ptzWO2EbG/cqcIkHloRrdlBtQlshyYGTNFvfkfJ5tpPLVkY4DtsPfQ=="], + + "@esbuild/linux-mips64el": ["@esbuild/linux-mips64el@0.28.2", "", { "os": "linux", "cpu": "none" }, "sha512-ZVykbDyk7519VwiNb9Lcj9m8XM6v5V9uKPvrEMkkEedVewf+0itkhahp4HDpgERXhwLRpWFypsGbG/J8s0QjJA=="], + + "@esbuild/linux-ppc64": ["@esbuild/linux-ppc64@0.28.2", "", { "os": "linux", "cpu": "ppc64" }, "sha512-CAXl+Dtd9UUuJd8pKKdwh6MLm3MUMiqMPmhZ3tTSXPqfyQ3vDl6R5hZdZ/kYojK4ofXtdfSv1tFq8XzWx3heNQ=="], + + "@esbuild/linux-riscv64": ["@esbuild/linux-riscv64@0.28.2", "", { "os": "linux", "cpu": "none" }, "sha512-GeXCej4IQtU1B+QlDV8W/RRvbzI3O/Stss+/bCXv4lZls5WGRtu2a+3JkA3i4qIUlMXpcHebWpF8AkJhATowuA=="], + + "@esbuild/linux-s390x": ["@esbuild/linux-s390x@0.28.2", "", { "os": "linux", "cpu": "s390x" }, "sha512-3H1weTYZPxt/WOhByszQZybS9w5lKzUn1FDMsgEChbHWQwHYQQRfBxgCcZvPhjHfKyJjIievvMmEUawJrdY9Dg=="], + + "@esbuild/linux-x64": ["@esbuild/linux-x64@0.28.2", "", { "os": "linux", "cpu": "x64" }, "sha512-4xTZr1FUmSoQW4XIWmit3tzQrUTZM+N3P0XV8xROKYF50XfI7xeO90+1bZvNwxIufQ9hDQVRJH5YhgPVF8A/HQ=="], + + "@esbuild/netbsd-arm64": ["@esbuild/netbsd-arm64@0.28.2", "", { "os": "none", "cpu": "arm64" }, "sha512-sSATRjPeDBg3pdgHoQfoYBob11Kk1FGa9lui5RIHZCoCkJa9QKlvl3/vKz2usCmYYjs7ymJR/2Nnsqe+Hjt5nw=="], + + "@esbuild/netbsd-x64": ["@esbuild/netbsd-x64@0.28.2", "", { "os": "none", "cpu": "x64" }, "sha512-lqnzCV+mM0gIADaKihiCg6ifgfU2L3h5E33rNQBN1Y4MaVGnzryzmvvf7UHxprpQdE8hpqLolJ9Rl+SkIRDpyw=="], + + "@esbuild/openbsd-arm64": ["@esbuild/openbsd-arm64@0.28.2", "", { "os": "openbsd", "cpu": "arm64" }, "sha512-AL2qJILH7lNjrDmCQDvdxMfAUIv8KMNZOvrwAQ8i8//ntL9FflhOyMJ8OZSMBb8/AWXe3/5v5S20y3zCoZWKoQ=="], + + "@esbuild/openbsd-x64": ["@esbuild/openbsd-x64@0.28.2", "", { "os": "openbsd", "cpu": "x64" }, "sha512-QtiuPytchRyC4rwUKhexJdQKvDuZ6hWloi3igqPQNUJCS1/v9EiO3UTOXR6A3FoMo4fnAKbWJdqaIwhOzh8qEw=="], + + "@esbuild/openharmony-arm64": ["@esbuild/openharmony-arm64@0.28.2", "", { "os": "none", "cpu": "arm64" }, "sha512-WkhYDmpTjLvGlScA1rwjRUmhl4k8oXR3cIbtqWmELgU/dFeHHlEllxDvdWcNJV9rbzCexB5vz8gtNewWLgCT7Q=="], + + "@esbuild/sunos-x64": ["@esbuild/sunos-x64@0.28.2", "", { "os": "sunos", "cpu": "x64" }, "sha512-GPMSkTOtMnv2U2F8gxe4Io6qmVs+YKyp832Etqqxr0hFngmXQ3rzwytelm3GIn7T4VviRUlf3sOgBOiTdvaf7g=="], + + "@esbuild/win32-arm64": ["@esbuild/win32-arm64@0.28.2", "", { "os": "win32", "cpu": "arm64" }, "sha512-PIhhEkE9uPBleRBrQEJpUn7MBnibZzbGzYWPmY3x+YoVg/95zbjB4CxPPOQ8l5tYYM4mMaCthF8/1DIfBQQyWQ=="], + + "@esbuild/win32-ia32": ["@esbuild/win32-ia32@0.28.2", "", { "os": "win32", "cpu": "ia32" }, "sha512-YmJbfTlvU7Sdn9BB+4PRES4oB6pxgS37MAONj+hBr/cpXS1aBPKXxNnDbu+QCWPj0o9dgyxeq79g6c5P8KeuYA=="], + + "@esbuild/win32-x64": ["@esbuild/win32-x64@0.28.2", "", { "os": "win32", "cpu": "x64" }, "sha512-5ebpxr3nWMzrL/rnUI755Jkuee0bHL/Gq0WTF9lvcpv73wAp5eu8MfBUgWK9bhWvZjj7yX8etf/8tI8Ney695g=="], + + "@expressive-code/core": ["@expressive-code/core@0.44.2", "", { "dependencies": { "@ctrl/tinycolor": "^4.0.4", "hast-util-select": "^6.0.2", "hast-util-to-html": "^9.0.1", "hast-util-to-text": "^4.0.1", "hastscript": "^9.0.0", "postcss": "^8.4.38", "postcss-nested": "^6.0.1", "unist-util-visit": "^5.0.0", "unist-util-visit-parents": "^6.0.1" } }, "sha512-Yw5KonQCD1HoOO2P89y4wifqS9qrJcGVY0LkVMUsVZjhi++bhz4WwQ37inenKFNOEVo50P7cjoVsCdaVnUbq8w=="], + + "@expressive-code/plugin-frames": ["@expressive-code/plugin-frames@0.44.2", "", { "dependencies": { "@expressive-code/core": "^0.44.2" } }, "sha512-gVLm6TQMNIRWIaM7o+mCtxkGNjLZY5/2faSTLoXeo9wv/Pkj/0QAtZyXPVPrRsPARqiipATNFmfvQFLJudxPHQ=="], + + "@expressive-code/plugin-shiki": ["@expressive-code/plugin-shiki@0.44.2", "", { "dependencies": { "@expressive-code/core": "^0.44.2", "shiki": "^4.0.2" } }, "sha512-ebWIvCDzXvjyD8rH6T6DfytYJw1GoArLR4nusIAE4VxXrCQf3d+owytiv010KU/dUg+SRLZskDn0N+HaFXeuSg=="], + + "@expressive-code/plugin-text-markers": ["@expressive-code/plugin-text-markers@0.44.2", "", { "dependencies": { "@expressive-code/core": "^0.44.2" } }, "sha512-SNI7EgUSiADqbqUzzMbj1ZeC/r2pa5eg3KyFOGAd3a7EsIA4qzjXQLp+ODWQtHVDKFCdGs4J3ovSJUqvKIK96g=="], + + "@img/colour": ["@img/colour@1.1.0", "", {}, "sha512-Td76q7j57o/tLVdgS746cYARfSyxk8iEfRxewL9h4OMzYhbW4TAcppl0mT4eyqXddh6L/jwoM75mo7ixa/pCeQ=="], + + "@img/sharp-darwin-arm64": ["@img/sharp-darwin-arm64@0.35.4", "", { "optionalDependencies": { "@img/sharp-libvips-darwin-arm64": "1.3.3" }, "os": "darwin", "cpu": "arm64" }, "sha512-Uhfl4V4lhP2nbUVF9+hyH1+luj86f1gUFeo8ALYxFoULoU+G87D43BfeMP8XHsk9boxAnCY/bf2EHwhA7MuGsA=="], + + "@img/sharp-darwin-x64": ["@img/sharp-darwin-x64@0.35.4", "", { "optionalDependencies": { "@img/sharp-libvips-darwin-x64": "1.3.3" }, "os": "darwin", "cpu": "x64" }, "sha512-hWniXY3bG5qKpkKrAwPe4y+VTPmf086YQAnkxWh7uA1YrlRouWGa0M0Mxj3ZjnXFkv7/TD1bTy9lGUK26vRvWw=="], + + "@img/sharp-freebsd-wasm32": ["@img/sharp-freebsd-wasm32@0.35.4", "", { "dependencies": { "@img/sharp-wasm32": "0.35.4" }, "os": "freebsd" }, "sha512-lIsKw/BU+kjB4eZjxrYrZmwOJYi3Ajrv66iAlBmUPyKc3HpnloevB1g3wxGD9P/5BbQ1brBGl65VRRrCvQDEqA=="], + + "@img/sharp-libvips-darwin-arm64": ["@img/sharp-libvips-darwin-arm64@1.3.3", "", { "os": "darwin", "cpu": "arm64" }, "sha512-suTBPTDGrI9WodccaDdwZItTSaBYASlBk1NSfElSHrUfzu3szG6lvIF58+WiFvnfzuK8ZBFS5zE00PxqxnRiPg=="], + + "@img/sharp-libvips-darwin-x64": ["@img/sharp-libvips-darwin-x64@1.3.3", "", { "os": "darwin", "cpu": "x64" }, "sha512-FVJZ5mITMobmXIz/hPDTw0EintTW5H3WfrxwLqEqjiIihlu+hVRyGrFQ60xl0Lxn7Bt3zdpevPaQi0HEzqz9fw=="], + + "@img/sharp-libvips-linux-arm": ["@img/sharp-libvips-linux-arm@1.3.3", "", { "os": "linux", "cpu": "arm" }, "sha512-3rbU4vqXXc3hY/OiXdl52xZvT0F1yEngWfvqudtPJg/KkyiaQw2DRsFrNzpmLvfavbwOq3qXn36GP8obHRULQA=="], + + "@img/sharp-libvips-linux-arm64": ["@img/sharp-libvips-linux-arm64@1.3.3", "", { "os": "linux", "cpu": "arm64" }, "sha512-0DaL0A6Xu6sQSQFwe4iVCrKWU2cCTItnRsYsCdxAMm9NF6twAA9BKnoqy4hqz4+azQ0JHuA26qiUKsf1XJ/v5A=="], + + "@img/sharp-libvips-linux-ppc64": ["@img/sharp-libvips-linux-ppc64@1.3.3", "", { "os": "linux", "cpu": "ppc64" }, "sha512-cdn1OvUBwsXhbC0zSzJnNzf5MZ/mTrobawDvNXBTxe8VtqKAm0sRuEY2Evzovb/w9JMk4TvRxqt1mekSuJz64w=="], + + "@img/sharp-libvips-linux-riscv64": ["@img/sharp-libvips-linux-riscv64@1.3.3", "", { "os": "linux", "cpu": "none" }, "sha512-HjPVx7yKz+0lqdhDlTw1tt90wamBoxhiXpvl1XZpJLiHH4RCJ5yDTqH+VlYPv2fwFs89JFw4c1IexYOcQUi4IQ=="], + + "@img/sharp-libvips-linux-s390x": ["@img/sharp-libvips-linux-s390x@1.3.3", "", { "os": "linux", "cpu": "s390x" }, "sha512-neWLh+3yCNThxnfy3c4BbVBeGgt9aftno+XbT56iK28RgeDs3UOFWviLWlUu0bArYVYJaFDK+RRohbicUNCm8Q=="], + + "@img/sharp-libvips-linux-x64": ["@img/sharp-libvips-linux-x64@1.3.3", "", { "os": "linux", "cpu": "x64" }, "sha512-4vKmvAst9nrowcqquKFAyZJUDolUaIp8uRiN0mWFguJ1IplC9/pitXtlnnlU4aa/eJw3J7i67V+pwUL+wZGdsA=="], + + "@img/sharp-libvips-linuxmusl-arm64": ["@img/sharp-libvips-linuxmusl-arm64@1.3.3", "", { "os": "linux", "cpu": "arm64" }, "sha512-Y9kQaLMuNoB0bPYOOdcZMaseNrFpPodIWWMrx+CZyydf2xn68j9WYc6sWWRrDwNkzCQjKYfc68L7jKjGlHMibw=="], + + "@img/sharp-libvips-linuxmusl-x64": ["@img/sharp-libvips-linuxmusl-x64@1.3.3", "", { "os": "linux", "cpu": "x64" }, "sha512-fj8Mv0HHfD1Rr+4I68+3agJynxDWtBFgicTbSOb9Bke6pIwzGcJ+RX/yHjmiEGFMCavY/dxvem7MyNaJF+wDiw=="], + + "@img/sharp-linux-arm": ["@img/sharp-linux-arm@0.35.4", "", { "optionalDependencies": { "@img/sharp-libvips-linux-arm": "1.3.3" }, "os": "linux", "cpu": "arm" }, "sha512-7OAS8gI0EReKGVN2HssHlM6umJgxF5VI3xN0p9FA91p/YO+ou5hiNghLdZ5BEHztwaaK5+bLKRf8x/o2L2nk9A=="], + + "@img/sharp-linux-arm64": ["@img/sharp-linux-arm64@0.35.4", "", { "optionalDependencies": { "@img/sharp-libvips-linux-arm64": "1.3.3" }, "os": "linux", "cpu": "arm64" }, "sha512-De4jpEnAU8Hd5oT0j1G3uL4ZvTuipVMn7YC6vPaJhy6/7EwEae0SVAoBrUMYQbkLGDm85taVWwuPc1a44LTzCQ=="], + + "@img/sharp-linux-ppc64": ["@img/sharp-linux-ppc64@0.35.4", "", { "optionalDependencies": { "@img/sharp-libvips-linux-ppc64": "1.3.3" }, "os": "linux", "cpu": "ppc64" }, "sha512-2oYZJeIl4kCcMGk4ouZVjnkCtFrpQFlNEtJ6GbxzhHQchwH0NH/qEb9ykmOl29dqwMq+JhFdZn+1ak2FKhI9fQ=="], + + "@img/sharp-linux-riscv64": ["@img/sharp-linux-riscv64@0.35.4", "", { "optionalDependencies": { "@img/sharp-libvips-linux-riscv64": "1.3.3" }, "os": "linux", "cpu": "none" }, "sha512-cPbNChoRURAWdebDIHSenxRpgEdy7JkPydSnUxRm9VvKD7m0/xVaR/8Fzlu81pk5nHEvHH87UZUA7cTtwnbJSA=="], + + "@img/sharp-linux-s390x": ["@img/sharp-linux-s390x@0.35.4", "", { "optionalDependencies": { "@img/sharp-libvips-linux-s390x": "1.3.3" }, "os": "linux", "cpu": "s390x" }, "sha512-RY0JFY8Fd6RonCBtHz+DvadaPkXDSI1AUn6yWL9TipqkZ1vY8w8evqdgyDFnkm4/K1ve1TvZiaePP5oSd4+WVQ=="], + + "@img/sharp-linux-x64": ["@img/sharp-linux-x64@0.35.4", "", { "optionalDependencies": { "@img/sharp-libvips-linux-x64": "1.3.3" }, "os": "linux", "cpu": "x64" }, "sha512-9qvvEAuk8k89TfWUoX2htWjbAMX8p+NxCppjpcg5k6xMsjhBQPTsoIh36h9Qde4WRuGpJeYnOjdosDn/cnv+OA=="], + + "@img/sharp-linuxmusl-arm64": ["@img/sharp-linuxmusl-arm64@0.35.4", "", { "optionalDependencies": { "@img/sharp-libvips-linuxmusl-arm64": "1.3.3" }, "os": "linux", "cpu": "arm64" }, "sha512-KB5jxpfWQTr0nc3xdHtWChdbifHrBGsd2SM62Eyxrl8afikm+f5qGBU75SJIZBT/S1MC8XyacdlXBMSWq6OURA=="], + + "@img/sharp-linuxmusl-x64": ["@img/sharp-linuxmusl-x64@0.35.4", "", { "optionalDependencies": { "@img/sharp-libvips-linuxmusl-x64": "1.3.3" }, "os": "linux", "cpu": "x64" }, "sha512-f+eZJZIQNEEd26RPSW+76chwOf1XtA2Y/O+5ocVyLliHkeih3e+jhLVBdNTd2rS3IbNXK8+ug93Vf5ZXtF5Lxg=="], + + "@img/sharp-wasm32": ["@img/sharp-wasm32@0.35.4", "", { "dependencies": { "@emnapi/runtime": "1.11.3" } }, "sha512-zQnl4Kwp7Q6NHsENtU2T/00Zi+w3AQNwz3+UaTyVBy2FpXrzXzGjndpK61onhZjRtRpQXxCTeqw19bVyXOh7jA=="], + + "@img/sharp-webcontainers-wasm32": ["@img/sharp-webcontainers-wasm32@0.35.4", "", { "dependencies": { "@img/sharp-wasm32": "0.35.4" }, "cpu": "none" }, "sha512-ESfNkywmCfPNyaZjxooddJQiQ+l/nTpGEOGthxiLnIHXC/CmcBixnfwUleX9mCz9ovrUUvKMap/pm8RYbzfwaA=="], + + "@img/sharp-win32-arm64": ["@img/sharp-win32-arm64@0.35.4", "", { "os": "win32", "cpu": "arm64" }, "sha512-iNdlBX9gLVvqe2I3uIJSIKTq6wckP/DYxZtcqxm09x5Gi24DnFBmPAWZmr60ZyYMG0xlzo6goG3670ar+RXvRw=="], + + "@img/sharp-win32-ia32": ["@img/sharp-win32-ia32@0.35.4", "", { "os": "win32", "cpu": "ia32" }, "sha512-kqRsbaa5CS6KHlpxnN7WhE6vAAugXyZButpRdvDWetlv6Qv4N9WTcrWzF7tXfB9T7MsoadqdI8hmwLq6UlLvtw=="], + + "@img/sharp-win32-x64": ["@img/sharp-win32-x64@0.35.4", "", { "os": "win32", "cpu": "x64" }, "sha512-XtmnYhBcrORsJ4XJngyzr/EWP0hRZLAZRFaApdKuviyqF78+ylxh2y06ZmtULAMOnObJ3ucpN0AcwSWnMowTRg=="], + + "@jridgewell/sourcemap-codec": ["@jridgewell/sourcemap-codec@1.6.0", "", {}, "sha512-T7jf+5zgsZHwNJ4lvQ7/aezbyk0nNX+zJVWpmHA7VYsEx7a7qr5Rg5IbtJFqkgze5Y2sruq1RUY8Q837Od7iFw=="], + + "@napi-rs/wasm-runtime": ["@napi-rs/wasm-runtime@1.2.4", "", { "dependencies": { "@tybys/wasm-util": "0.10.4" }, "peerDependencies": { "@emnapi/core": "1.11.1", "@emnapi/runtime": "1.11.1" } }, "sha512-AJxoUD2/15ESHbvpcyjU274nsAPLuOtPHCk0vKJM5pj//Fg/B1FXNWjPnXTT9PymCYYiHo4zPj0ZomXBKhoy7g=="], + + "@oslojs/encoding": ["@oslojs/encoding@1.1.0", "", {}, "sha512-70wQhgYmndg4GCPxPPxPGevRKqTIJ2Nh4OkiMWmDAVYsTQ+Ta7Sq+rPevXyXGdzr30/qZBnyOalCszoMxlyldQ=="], + + "@oxc-project/types": ["@oxc-project/types@0.149.0", "", {}, "sha512-Efcc+iF0j3Bf67YjEqIqWXbX5XddXoK/Mw4K1/JuXwRCZ8N16VR7iT23nlCc9XrveFVh/E5Rqs2StT0V8v9LdA=="], + + "@pagefind/darwin-arm64": ["@pagefind/darwin-arm64@1.5.2", "", { "os": "darwin", "cpu": "arm64" }, "sha512-MXpI+7HsAdPkvJ0gk9xj9g541BCqBZOBbdwj9g6lB5LCj6kSV6nqDSjzcAJwvOsfu0fjwvC8hQU+ecfhp+MpiQ=="], + + "@pagefind/darwin-x64": ["@pagefind/darwin-x64@1.5.2", "", { "os": "darwin", "cpu": "x64" }, "sha512-IojxFWMEJe0RQ7PQ3KXQsPIImNsbpPYpoZ+QUDrL8fAl/O27IX+LVLs74/UzEZy5uA2LD8Nz1AiwKr72vrkZQw=="], + + "@pagefind/default-ui": ["@pagefind/default-ui@1.5.2", "", {}, "sha512-pm1LMnQg8N2B3n2TnjKlhaFihpz6zTiA4HiGQ6/slKO/+8K9CAU5kcjdSSPgpuk1PMuuN4hxLipUIifnrkl3Sg=="], + + "@pagefind/freebsd-x64": ["@pagefind/freebsd-x64@1.5.2", "", { "os": "freebsd", "cpu": "x64" }, "sha512-7EVzo9+0w+2cbe671BtMj10UlNo83I+HrLVLfRxO731svHRJKUfJ/mo05gU14pe9PCfpKNQT8FS3Xc/oDN6pOA=="], + + "@pagefind/linux-arm64": ["@pagefind/linux-arm64@1.5.2", "", { "os": "linux", "cpu": "arm64" }, "sha512-Ovt9+K35sqzn8H3ZMXGwls4TD/wMJuvRtShHIsmUQREmaxjrDEX7gHckRCrwYJ4XE1H1p6HkLz3wukrAnsfXQw=="], + + "@pagefind/linux-x64": ["@pagefind/linux-x64@1.5.2", "", { "os": "linux", "cpu": "x64" }, "sha512-V+tFqHKXhQKq/WqPBD67AFy7scn1/aZID00ws4fSDd+1daSi5UHR9VVlRrOUYKxn3VuFQYRD7lYXdZK1WED1YA=="], + + "@pagefind/windows-arm64": ["@pagefind/windows-arm64@1.5.2", "", { "os": "win32", "cpu": "arm64" }, "sha512-hN9Nh90fNW61nNRCW9ZyQrAj/mD0eRvmJ8NlTUzkbuW8kIzGJUi3cxjFkEcMZ5h/8FsKWD/VcouZl4yo1F7B6g=="], + + "@pagefind/windows-x64": ["@pagefind/windows-x64@1.5.2", "", { "os": "win32", "cpu": "x64" }, "sha512-Fa2Iyw7kaDRzGMfNYNUXNW2zbL5FQVDgSOcbDHdzBrDEdpqOqg8TcZ68F22ol6NJ9IGzvUdmeyZypLW5dyhqsg=="], + + "@rolldown/binding-android-arm-eabi": ["@rolldown/binding-android-arm-eabi@1.2.8", "", { "os": "android", "cpu": "arm" }, "sha512-tN5aztYkKCte4i5SIrrz5yK/HMjEuCqCSCJa418jOV8tZ1cBY3YF2otxB1ktPxzsLA1BeTqwapK0bfjxNvHJVw=="], + + "@rolldown/binding-android-arm64": ["@rolldown/binding-android-arm64@1.2.8", "", { "os": "android", "cpu": "arm64" }, "sha512-dIYTWl9XprMUiQFoc55KUyk/oS8SKYH3zFl0LTR7RT0Xj4hgSVyuJcroH8JUu8RcpF8fTB6E0aOwCkZoYPcDSQ=="], + + "@rolldown/binding-darwin-arm64": ["@rolldown/binding-darwin-arm64@1.2.8", "", { "os": "darwin", "cpu": "arm64" }, "sha512-PCSDQGXD2IyTEFrcgPyBM8jJuGmrbCMuoIOXdbEGVemruKACXoLQJrb+A45Z0L5t1RQkdfJprAYPkikbh7dzdA=="], + + "@rolldown/binding-darwin-x64": ["@rolldown/binding-darwin-x64@1.2.8", "", { "os": "darwin", "cpu": "x64" }, "sha512-Uk7lRsGhPFHVX/sAUC6D5H9Ol30dFHd6iquokll2th3LpdJ3F5CzQB+7DHn0Ri2mG+U7k2zXiPHDrwZenXhwSA=="], + + "@rolldown/binding-freebsd-x64": ["@rolldown/binding-freebsd-x64@1.2.8", "", { "os": "freebsd", "cpu": "x64" }, "sha512-DjszaTEVogPqA5bYzsEeqDCQxbcp2fexQwKcRspYji2yzR68fCf+e4fx6kBSRDwX5/brZaHw/hWS9+A/+/w9sQ=="], + + "@rolldown/binding-linux-arm-gnueabihf": ["@rolldown/binding-linux-arm-gnueabihf@1.2.8", "", { "os": "linux", "cpu": "arm" }, "sha512-zmwa7FTmdzB6aaEEuuls18H6Ap5JmJPSoPTuXixeJZV6tG40SyLkApQtz1g8ptZtiEKqj9OM0oNLPh1AgvE31Q=="], + + "@rolldown/binding-linux-arm64-gnu": ["@rolldown/binding-linux-arm64-gnu@1.2.8", "", { "os": "linux", "cpu": "arm64" }, "sha512-KdYQDPHwJVnbFwdTGMgxsI9SqblBlz6STGM+w1We/d5B8OWWidYH0MwkU/uA1wM5fIpO2MkOVxXrNzzuZhw9ew=="], + + "@rolldown/binding-linux-arm64-musl": ["@rolldown/binding-linux-arm64-musl@1.2.8", "", { "os": "linux", "cpu": "arm64" }, "sha512-jFJTifHnNPY+yzOoNZQfSIysrVyXzEQPhPnOUjmD1bcQGHH6s7c8cViKWar8YplQImE5N9JRqMCLrM2CdxOrZA=="], + + "@rolldown/binding-linux-ppc64-gnu": ["@rolldown/binding-linux-ppc64-gnu@1.2.8", "", { "os": "linux", "cpu": "ppc64" }, "sha512-FhiOziBDWPBjbcmRzfLyIJnaP7AVMFXT7YCXPjXxj7wKU3vx24RjrCNN/zjvVa+N2vVoHJwCoUBvsrN/DG3zIA=="], + + "@rolldown/binding-linux-s390x-gnu": ["@rolldown/binding-linux-s390x-gnu@1.2.8", "", { "os": "linux", "cpu": "s390x" }, "sha512-WnHfADMzOV2Y55wlx1hzzQnar/wDt/VdvWSD99r18Mz9ylNieIGOkRx3UV21h7m/eJvjySYJkO26VvGNFkwsIQ=="], + + "@rolldown/binding-linux-x64-gnu": ["@rolldown/binding-linux-x64-gnu@1.2.8", "", { "os": "linux", "cpu": "x64" }, "sha512-H9tRr5ibfXFVLxbPOseVewewFpl28zcEdjRDt2FTUZU7odxP0gEv1ki4/kGmcGOh78oRwZuuQllGLZ9zTJp84g=="], + + "@rolldown/binding-linux-x64-musl": ["@rolldown/binding-linux-x64-musl@1.2.8", "", { "os": "linux", "cpu": "x64" }, "sha512-UefiqfM3D6IVNlZ8tSGs9+Ejjud2T+oxO0IHADU45Y+lyEjD2dVFyZHbkfX0LUb5Zugo/oIv1eCO/KVYhgYJYA=="], + + "@rolldown/binding-openharmony-arm64": ["@rolldown/binding-openharmony-arm64@1.2.8", "", { "os": "none", "cpu": "arm64" }, "sha512-637Ke4kWSy6rp9cxQ9gMOXlxPgIw/c1beASV4M//3+9I4uwBVOOl74G+e3zyU3u19U7RkRl/HuewixZ/Z6+Rjg=="], + + "@rolldown/binding-win32-arm64-msvc": ["@rolldown/binding-win32-arm64-msvc@1.2.8", "", { "os": "win32", "cpu": "arm64" }, "sha512-xWBkPOF1Q9k/Gv1nQXnVdLxKu74jXppuOM4Z3mnypVUJJJwLsMl7hNJGRAUJoG8A5MgOI1ACKM+wBFxSJzKy4A=="], + + "@rolldown/binding-win32-x64-msvc": ["@rolldown/binding-win32-x64-msvc@1.2.8", "", { "os": "win32", "cpu": "x64" }, "sha512-uz2ZvfgXbxqNwijjjbxrnvALwpyODDcgc1T1N8N3rf/DXKQmaFwmB4LX4yyjggpwN2obdQLb2rgirX5ffCWYng=="], + + "@rolldown/pluginutils": ["@rolldown/pluginutils@1.0.1", "", {}, "sha512-2j9bGt5Jh8hj+vPtgzPtl72j0yRxHAyumoo6TNfAjsLB04UtpSvPbPcDcBMxz7n+9CYB0c1GxQFxYRg2jimqGw=="], + + "@shikijs/core": ["@shikijs/core@4.4.3", "", { "dependencies": { "@shikijs/primitive": "4.4.3", "@shikijs/types": "4.4.3", "@shikijs/vscode-textmate": "10.0.2", "@types/hast": "3.0.5", "hast-util-to-html": "9.0.5" } }, "sha512-QCR4q2ZO/ILJEuwiBMel4wdcTDb1JGwfjKTxPDF6x8ixOaluPrVqIn06C99AcRPhmYlBR56d/Fb+GN58GzExpg=="], + + "@shikijs/engine-javascript": ["@shikijs/engine-javascript@4.4.3", "", { "dependencies": { "@shikijs/types": "4.4.3", "@shikijs/vscode-textmate": "10.0.2", "oniguruma-to-es": "4.3.6" } }, "sha512-FbOjFJp9VLdo1Wevs10BBtVxiTWwNLqZh5Gkhjgda/ioL15YOgeSl9n+6XMa3qRlPQzfhFNe641SrynFHYG0nQ=="], + + "@shikijs/engine-oniguruma": ["@shikijs/engine-oniguruma@4.4.3", "", { "dependencies": { "@shikijs/types": "4.4.3", "@shikijs/vscode-textmate": "10.0.2" } }, "sha512-EcOQkxdxGQrc1Row/cC2c96/v1dbZqGnEVu1qTuT/MJmp6+cXCvQussowVmCv5Tqr3KuY3c7IbM6HTW3LJ1k9w=="], + + "@shikijs/langs": ["@shikijs/langs@4.4.3", "", { "dependencies": { "@shikijs/types": "4.4.3" } }, "sha512-ePic0yfAJGOF83D5wBHK/00EjK65oahBYxFk5epgq33WRv7X9UuxLEV8PtR0szC0z8dl7INIpIodB99JRFlR+A=="], + + "@shikijs/primitive": ["@shikijs/primitive@4.4.3", "", { "dependencies": { "@shikijs/types": "4.4.3", "@shikijs/vscode-textmate": "10.0.2", "@types/hast": "3.0.5" } }, "sha512-m0wBeLDQDeIxRdUmrCPdQqfuUamDwRL5isCfYbguKD6NiaKpVbsv+3J81DyIKgNW5h4WAIIr8T4EkgQrBBxvaQ=="], + + "@shikijs/themes": ["@shikijs/themes@4.4.3", "", { "dependencies": { "@shikijs/types": "4.4.3" } }, "sha512-w8UHjeUnIR965KMWJHUPXOc2mNJUnK3vpVLYLvw5IYU2mnTTJ89E24OrJDBNiJDQ0qzb0tc4l7mrIXx5cFeIyw=="], + + "@shikijs/types": ["@shikijs/types@4.4.3", "", { "dependencies": { "@shikijs/vscode-textmate": "10.0.2", "@types/hast": "3.0.5" } }, "sha512-UEJxmRR++MAGR6hugn0vgVS2W/6lWAts84FFSrnlH9sP0LNol7E5+NQ792pH8liWUhyMyjhTgSUH3k7iD7tc5g=="], + + "@shikijs/vscode-textmate": ["@shikijs/vscode-textmate@10.0.2", "", {}, "sha512-83yeghZ2xxin3Nj8z1NMd/NCuca+gsYXswywDy5bHvwlWL8tpTQmzGeUuHd9FC3E/SBEMvzJRwWEOz5gGes9Qg=="], + + "@tybys/wasm-util": ["@tybys/wasm-util@0.10.4", "", { "dependencies": { "tslib": "2.8.1" } }, "sha512-W3c4gRigFS0T/Ma4qIYF3GDAc5AQdHb1yL5znJT1Zv1YaD9Kitx656wBjvr19qbiosmZT8lWDM5BEMynUqX65A=="], + + "@types/debug": ["@types/debug@4.1.13", "", { "dependencies": { "@types/ms": "*" } }, "sha512-KSVgmQmzMwPlmtljOomayoR89W4FynCAi3E8PPs7vmDVPe84hT+vGPKkJfThkmXs0x0jAaa9U8uW8bbfyS2fWw=="], + + "@types/estree": ["@types/estree@1.0.9", "", {}, "sha512-GhdPgy1el4/ImP05X05Uw4cw2/M93BCUmnEvWZNStlCzEKME4Fkk+YpoA5OiHNQmoS7Cafb8Xa3Pya8m1Qrzeg=="], + + "@types/estree-jsx": ["@types/estree-jsx@1.0.5", "", { "dependencies": { "@types/estree": "1.0.9" } }, "sha512-52CcUVNFyfb1A2ALocQw/Dd1BQFNmSdkuC3BkZ6iqhdMfQz7JWOFRuJFloOzjk+6WijU56m9oKXFAXc7o3Towg=="], + + "@types/hast": ["@types/hast@3.0.5", "", { "dependencies": { "@types/unist": "3.0.3" } }, "sha512-rp/ezSWaD1m44dPKICGhiskI13nVr7qTloFwDa/IYkhhf5nzwP+zIQcIJh3WIFSBOy/H1PzB40jPjMDksN4F+g=="], + + "@types/js-yaml": ["@types/js-yaml@4.0.9", "", {}, "sha512-k4MGaQl5TGo/iipqb2UDG2UwjXziSWkh0uysQelTlJpX1qGlpUZYm8PnO4DxG1qBomtJUdYJ6qR6xdIah10JLg=="], + + "@types/mdast": ["@types/mdast@4.0.4", "", { "dependencies": { "@types/unist": "3.0.3" } }, "sha512-kGaNbPh1k7AFzgpud/gMdvIm5xuECykRR+JnWKQno9TAXVa6WIVCGTPvYGekIDL4uwCZQSYbUxNBSb1aUo79oA=="], + + "@types/ms": ["@types/ms@2.1.0", "", {}, "sha512-GsCCIZDE/p3i96vtEqx+7dBUGXrc7zeSK3wwPHIaRThS+9OhWIXRqzs4d6k1SVU8g91DrNRWxWUGhp5KXQb2VA=="], + + "@types/nlcst": ["@types/nlcst@2.0.3", "", { "dependencies": { "@types/unist": "3.0.3" } }, "sha512-vSYNSDe6Ix3q+6Z7ri9lyWqgGhJTmzRjZRqyq15N0Z/1/UnVsno9G/N40NBijoYx2seFDIl0+B2mgAb9mezUCA=="], + + "@types/node": ["@types/node@24.13.5", "", { "dependencies": { "undici-types": "~7.18.0" } }, "sha512-TXyindR+lBr22aJIdMQzCFHPHR6cR4js838mRDCSz5hOKWZvZwsXSSiXDmjRj4iJmgl+sR9O+1mkoVBSMadNug=="], + + "@types/sax": ["@types/sax@1.2.7", "", { "dependencies": { "@types/node": "*" } }, "sha512-rO73L89PJxeYM3s3pPPjiPgVVcymqU490g0YO5n5By0k2Erzj6tay/4lr1CHAAU4JyOWd1rpQ8bCf6cZfHU96A=="], + + "@types/unist": ["@types/unist@3.0.3", "", {}, "sha512-ko/gIFJRv177XgZsZcBwnqJN5x/Gien8qNOn0D5bQU/zAzVf9Zt3BlcUiLqhV9y4ARk0GbT3tnUiPNgnTXzc/Q=="], + + "@ungap/structured-clone": ["@ungap/structured-clone@1.4.0", "", {}, "sha512-1mEZtMKPM09vDmQt5y7YvmN2+DFTP7Tg0EWXdic8/C6VRnpb33e4ghisCIE3WZjsE2N8mf+QV1Zqh7ZFYLWInQ=="], + + "@volar/kit": ["@volar/kit@2.4.28", "", { "dependencies": { "@volar/language-service": "2.4.28", "@volar/typescript": "2.4.28", "typesafe-path": "^0.2.2", "vscode-languageserver-textdocument": "^1.0.11", "vscode-uri": "^3.0.8" }, "peerDependencies": { "typescript": "*" } }, "sha512-cKX4vK9dtZvDRaAzeoUdaAJEew6IdxHNCRrdp5Kvcl6zZOqb6jTOfk3kXkIkG3T7oTFXguEMt5+9ptyqYR84Pg=="], + + "@volar/language-core": ["@volar/language-core@2.4.28", "", { "dependencies": { "@volar/source-map": "2.4.28" } }, "sha512-w4qhIJ8ZSitgLAkVay6AbcnC7gP3glYM3fYwKV3srj8m494E3xtrCv6E+bWviiK/8hs6e6t1ij1s2Endql7vzQ=="], + + "@volar/language-server": ["@volar/language-server@2.4.28", "", { "dependencies": { "@volar/language-core": "2.4.28", "@volar/language-service": "2.4.28", "@volar/typescript": "2.4.28", "path-browserify": "^1.0.1", "request-light": "^0.7.0", "vscode-languageserver": "^9.0.1", "vscode-languageserver-protocol": "^3.17.5", "vscode-languageserver-textdocument": "^1.0.11", "vscode-uri": "^3.0.8" } }, "sha512-NqcLnE5gERKuS4PUFwlhMxf6vqYo7hXtbMFbViXcbVkbZ905AIVWhnSo0ZNBC2V127H1/2zP7RvVOVnyITFfBw=="], + + "@volar/language-service": ["@volar/language-service@2.4.28", "", { "dependencies": { "@volar/language-core": "2.4.28", "vscode-languageserver-protocol": "^3.17.5", "vscode-languageserver-textdocument": "^1.0.11", "vscode-uri": "^3.0.8" } }, "sha512-Rh/wYCZJrI5vCwMk9xyw/Z+MsWxlJY1rmMZPsxUoJKfzIRjS/NF1NmnuEcrMbEVGja00aVpCsInJfixQTMdvLw=="], + + "@volar/source-map": ["@volar/source-map@2.4.28", "", {}, "sha512-yX2BDBqJkRXfKw8my8VarTyjv48QwxdJtvRgUpNE5erCsgEUdI2DsLbpa+rOQVAJYshY99szEcRDmyHbF10ggQ=="], + + "@volar/typescript": ["@volar/typescript@2.4.28", "", { "dependencies": { "@volar/language-core": "2.4.28", "path-browserify": "^1.0.1", "vscode-uri": "^3.0.8" } }, "sha512-Ja6yvWrbis2QtN4ClAKreeUZPVYMARDYZl9LMEv1iQ1QdepB6wn0jTRxA9MftYmYa4DQ4k/DaSZpFPUfxl8giw=="], + + "@vscode/emmet-helper": ["@vscode/emmet-helper@2.11.0", "", { "dependencies": { "emmet": "^2.4.3", "jsonc-parser": "^2.3.0", "vscode-languageserver-textdocument": "^1.0.1", "vscode-languageserver-types": "^3.15.1", "vscode-uri": "^3.0.8" } }, "sha512-QLxjQR3imPZPQltfbWRnHU6JecWTF1QSWhx3GAKQpslx7y3Dp6sIIXhKjiUJ/BR9FX8PVthjr9PD6pNwOJfAzw=="], + + "@vscode/l10n": ["@vscode/l10n@0.0.18", "", {}, "sha512-KYSIHVmslkaCDyw013pphY+d7x1qV8IZupYfeIfzNA+nsaWHbn5uPuQRvdRFsa9zFzGeudPuoGoZ1Op4jrJXIQ=="], + + "ajv": ["ajv@8.20.0", "", { "dependencies": { "fast-deep-equal": "^3.1.3", "fast-uri": "^3.0.1", "json-schema-traverse": "^1.0.0", "require-from-string": "^2.0.2" } }, "sha512-Thbli+OlOj+iMPYFBVBfJ3OmCAnaSyNn4M1vz9T6Gka5Jt9ba/HIR56joy65tY6kx/FCF5VXNB819Y7/GUrBGA=="], + + "ajv-draft-04": ["ajv-draft-04@1.0.0", "", { "peerDependencies": { "ajv": "^8.5.0" }, "optionalPeers": ["ajv"] }, "sha512-mv00Te6nmYbRp5DCwclxtt7yV/joXJPGS7nM+97GdxvuttCOfgI3K4U25zboyeX0O+myI8ERluxQe5wljMmVIw=="], + + "ajv-i18n": ["ajv-i18n@4.2.0", "", { "peerDependencies": { "ajv": "^8.0.0-beta.0" } }, "sha512-v/ei2UkCEeuKNXh8RToiFsUclmU+G57LO1Oo22OagNMENIw+Yb8eMwvHu7Vn9fmkjJyv6XclhJ8TbuigSglPkg=="], + + "am-i-vibing": ["am-i-vibing@0.4.0", "", { "dependencies": { "process-ancestry": "0.1.0" }, "bin": { "am-i-vibing": "dist/cli.mjs" } }, "sha512-MxT4XZL7pzLHpuvhDKdMaQHMGGkJDLluKBLsbstn+8wv9sWcFT6h+0ve9qkml95amVTZtZV83gQe2hY+ojgHLg=="], + + "ansi-regex": ["ansi-regex@6.3.0", "", {}, "sha512-WpDfL7NO6j7tH88IDBNVdUJxDh9nmCteAVW9dsep846XdwF4naCBK+/tGLX3KJgcpgMRXCFlTM2hKGoK9FsdrQ=="], + + "ansi-styles": ["ansi-styles@6.2.3", "", {}, "sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg=="], + + "anymatch": ["anymatch@3.1.3", "", { "dependencies": { "normalize-path": "3.0.0", "picomatch": "2.3.2" } }, "sha512-KMReFUr0B4t+D+OBkjR3KYqvocp2XaSzO55UcB6mgQMd3KbcE+mWTyvVV7D/zsdEbNnV6acZUutkiHQXvTr1Rw=="], + + "arg": ["arg@5.0.2", "", {}, "sha512-PYjyFOLKQ9y57JvQ6QLo8dAgNqswh8M1RMJYdQduT6xbWSgK36P/Z/v+p888pM69jMMfS8Xd8F6I1kQ/I9HUGg=="], + + "argparse": ["argparse@2.0.1", "", {}, "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q=="], + + "aria-query": ["aria-query@5.3.2", "", {}, "sha512-COROpnaoap1E2F000S62r6A60uHZnmlvomhfyT2DlTcrY1OrBKn2UhH7qn5wTC9zMvD0AY7csdPSNwKP+7WiQw=="], + + "astro": ["astro@7.3.2", "", { "dependencies": { "@astrojs/compiler-rs": "0.4.1", "@astrojs/internal-helpers": "0.11.0", "@astrojs/markdown-satteri": "0.4.1", "@astrojs/telemetry": "3.3.3", "@capsizecss/unpack": "4.0.1", "@clack/prompts": "1.8.1", "@oslojs/encoding": "1.1.0", "am-i-vibing": "0.4.0", "aria-query": "5.3.2", "axobject-query": "4.1.0", "ci-info": "4.4.0", "clsx": "2.1.1", "common-ancestor-path": "2.0.0", "cookie": "2.0.1", "devalue": "5.9.2", "diff": "9.0.0", "dset": "3.1.4", "es-module-lexer": "2.3.2", "esbuild": "0.28.2", "find-proc": "0.1.0", "flattie": "1.1.1", "fontace": "0.4.1", "get-tsconfig": "5.0.0-beta.4", "github-slugger": "2.0.0", "html-escaper": "3.0.3", "http-cache-semantics": "4.2.0", "js-yaml": "4.3.2", "jsonc-parser": "3.3.1", "magic-string": "1.4.1", "magicast": "0.5.5", "mrmime": "2.0.1", "neotraverse": "1.0.1", "obug": "2.2.1", "p-limit": "7.3.2", "p-queue": "9.3.3", "package-manager-detector": "1.8.0", "piccolore": "0.1.3", "picomatch": "4.0.7", "semver": "7.8.5", "shiki": "4.4.3", "smol-toml": "1.8.0", "svgo": "4.1.0", "tinyclip": "0.1.15", "tinyexec": "1.3.1", "tinyglobby": "0.2.17", "ultrahtml": "1.7.0", "unifont": "0.7.5", "unstorage": "1.17.5", "vite": "8.3.0", "vitefu": "1.1.3", "xxhash-wasm": "1.1.0", "yargs-parser": "22.0.0", "zod": "4.6.5" }, "optionalDependencies": { "sharp": "0.35.4" }, "bin": { "astro": "./bin/astro.mjs" } }, "sha512-ysTcdpGP61XZpHoMRYC/CK19DQ94qkBvzXMtXEo0gEqPNkmOU/Tv++CtWmzaI4nF2Ck8RXFdiWvdlTWa2oOr9w=="], + + "astro-expressive-code": ["astro-expressive-code@0.44.2", "", { "dependencies": { "rehype-expressive-code": "^0.44.2", "url-extras": "^0.1.0" }, "peerDependencies": { "astro": "^4.0.0-beta || ^5.0.0-beta || ^3.3.0 || ^6.0.0-beta || ^7.0.0" } }, "sha512-avop7nZcRwC7quvIxVguhwEZ9Tp6IoTzKUCLwP30Fb7+er+pWQgcysP01dcuzRIJo81kLGg30q/YAI2Yb1Sdzg=="], + + "axobject-query": ["axobject-query@4.1.0", "", {}, "sha512-qIj0G9wZbMGNLjLmg1PT6v2mE9AH2zlnADJD/2tC6E00hgmhUOfEB6greHPAfLRSufHqROIUTkw6E+M3lH0PTQ=="], + + "bail": ["bail@2.0.2", "", {}, "sha512-0xO6mYd7JB2YesxDKplafRpsiOzPt9V02ddPCLbY1xYGPOX24NTyN50qnUxgCPcSoYMhKpAuBTjQoRZCAkUDRw=="], + + "bcp-47": ["bcp-47@2.1.1", "", { "dependencies": { "is-alphabetical": "^2.0.0", "is-alphanumerical": "^2.0.0", "is-decimal": "^2.0.0" } }, "sha512-KLw+H/gd2p4zly1X7Yh/qziuyae5/w/QFnvTng9eZL5fvszL7Whl3MBoWF8yxL7ksUjBfOD+OxkytiqbBpG+Fw=="], + + "bcp-47-match": ["bcp-47-match@2.0.3", "", {}, "sha512-JtTezzbAibu8G0R9op9zb3vcWZd9JF6M0xOYGPn0fNCd7wOpRB1mU2mH9T8gaBGbAAyIIVgB2G7xG0GP98zMAQ=="], + + "boolbase": ["boolbase@1.0.0", "", {}, "sha512-JZOSA7Mo9sNGB8+UjSgzdLtokWAky1zbztM3WRLCbZ70/3cTANmQmOdR7y2g+J0e2WXywy1yS468tY+IruqEww=="], + + "ccount": ["ccount@2.0.1", "", {}, "sha512-eyrF0jiFpY+3drT6383f1qhkbGsLSifNAjA61IUjZjmLCWjItY6LB9ft9YhoDgwfmclB2zhu51Lc7+95b8NRAg=="], + + "character-entities": ["character-entities@2.0.2", "", {}, "sha512-shx7oQ0Awen/BRIdkjkvz54PnEEI/EjwXDSIZp86/KKdbafHh1Df/RYGBhn4hbe2+uKC9FnT5UCEdyPz3ai9hQ=="], + + "character-entities-html4": ["character-entities-html4@2.1.0", "", {}, "sha512-1v7fgQRj6hnSwFpq1Eu0ynr/CDEw0rXo2B61qXrLNdHZmPKgb7fqS1a2JwF0rISo9q77jDI8VMEHoApn8qDoZA=="], + + "character-entities-legacy": ["character-entities-legacy@3.0.0", "", {}, "sha512-RpPp0asT/6ufRm//AJVwpViZbGM/MkjQFxJccQRHmISF/22NBtsHqAWmL+/pmkPWoIUJdWyeVleTl1wydHATVQ=="], + + "character-reference-invalid": ["character-reference-invalid@2.0.1", "", {}, "sha512-iBZ4F4wRbyORVsu0jPV7gXkOsGYjGHPmAyv+HiHG8gi5PtC9KI2j1+v8/tlibRvjoWX027ypmG/n0HtO5t7unw=="], + + "chokidar": ["chokidar@4.0.3", "", { "dependencies": { "readdirp": "^4.0.1" } }, "sha512-Qgzu8kfBvo+cA4962jnP1KkS6Dop5NS6g7R5LFYJr4b8Ub94PPQXUksCw9PvXoeXPRRddRNC5C1JQUR2SMGtnA=="], + + "ci-info": ["ci-info@4.4.0", "", {}, "sha512-77PSwercCZU2Fc4sX94eF8k8Pxte6JAwL4/ICZLFjJLqegs7kCuAsqqj/70NQF6TvDpgFjkubQB2FW2ZZddvQg=="], + + "cliui": ["cliui@9.0.1", "", { "dependencies": { "string-width": "^7.2.0", "strip-ansi": "^7.1.0", "wrap-ansi": "^9.0.0" } }, "sha512-k7ndgKhwoQveBL+/1tqGJYNz097I7WOvwbmmU2AR5+magtbjPWQTS1C5vzGkBC8Ym8UWRzfKUzUUqFLypY4Q+w=="], + + "clsx": ["clsx@2.1.1", "", {}, "sha512-eYm0QWBtUrBWZWG0d386OGAw16Z995PiOVo2B7bjWSbHedGl5e0ZWaq65kOGgUSNesEIDkB9ISbTg/JK9dhCZA=="], + + "comma-separated-tokens": ["comma-separated-tokens@2.0.3", "", {}, "sha512-Fu4hJdvzeylCfQPp9SGWidpzrMs7tTrlu6Vb8XGaRGck8QSNZJJp538Wrb60Lax4fPwR64ViY468OIUTbRlGZg=="], + + "commander": ["commander@11.1.0", "", {}, "sha512-yPVavfyCcRhmorC7rWlkHn15b4wDVgVmBA7kV4QVBsF7kv/9TKJAbAXVTxvTnwP8HHKjRCJDClKbciiYS7p0DQ=="], + + "common-ancestor-path": ["common-ancestor-path@2.0.0", "", {}, "sha512-dnN3ibLeoRf2HNC+OlCiNc5d2zxbLJXOtiZUudNFSXZrNSydxcCsSpRzXwfu7BBWCIfHPw+xTayeBvJCP/D8Ng=="], + + "cookie": ["cookie@2.0.1", "", {}, "sha512-yuToqVvRrj6pfDXREyQAAv8SkAEk/8GS3jQRTiUMm66TVtBYmqQeoEjL2Lmq8Rpo6271vH76InTChTitEAm65w=="], + + "cookie-es": ["cookie-es@1.2.3", "", {}, "sha512-lXVyvUvrNXblMqzIRrxHb57UUVmqsSWlxqt3XIjCkUP0wDAf6uicO6KMbEgYrMNtEvWgWHwe42CKxPu9MYAnWw=="], + + "crossws": ["crossws@0.3.5", "", { "dependencies": { "uncrypto": "0.1.3" } }, "sha512-ojKiDvcmByhwa8YYqbQI/hg7MEU0NC03+pSdEq4ZUnZR9xXpwk7E43SMNGkn+JxJGPFtNvQ48+vV2p+P1ml5PA=="], + + "css-select": ["css-select@6.0.0", "", { "dependencies": { "boolbase": "1.0.0", "css-what": "7.0.0", "domhandler": "5.0.3", "domutils": "3.2.2", "nth-check": "2.1.1" } }, "sha512-rZZVSLle8v0+EY8QAkDWrKhpgt6SA5OtHsgBnsj6ZaLb5dmDVOWUDtQitd9ydxxvEjhewNudS6eTVU7uOyzvXw=="], + + "css-selector-parser": ["css-selector-parser@3.3.0", "", {}, "sha512-Y2asgMGFqJKF4fq4xHDSlFYIkeVfRsm69lQC1q9kbEsH5XtnINTMrweLkjYMeaUgiXBy/uvKeO/a1JHTNnmB2g=="], + + "css-tree": ["css-tree@3.2.1", "", { "dependencies": { "mdn-data": "2.27.1", "source-map-js": "1.2.1" } }, "sha512-X7sjQzceUhu1u7Y/ylrRZFU2FS6LRiFVp6rKLPg23y3x3c3DOKAwuXGDp+PAGjh6CSnCjYeAul8pcT8bAl+lSA=="], + + "css-what": ["css-what@7.0.0", "", {}, "sha512-wD5oz5xibMOPHzy13CyGmogB3phdvcDaB5t0W/Nr5Z2O/agcB8YwOz6e2Lsp10pNDzBoDO9nVa3RGs/2BttpHQ=="], + + "cssesc": ["cssesc@3.0.0", "", { "bin": { "cssesc": "bin/cssesc" } }, "sha512-/Tb/JcjK111nNScGob5MNtsntNM1aCNUDipB/TkwZFhyDrrE47SOx/18wF2bbjgc3ZzCSKW1T5nt5EbFoAz/Vg=="], + + "csso": ["csso@5.0.5", "", { "dependencies": { "css-tree": "2.2.1" } }, "sha512-0LrrStPOdJj+SPCCrGhzryycLjwcgUSHBtxNA8aIDxf0GLsRh1cKYhB00Gd1lDOS4yGH69+SNn13+TWbVHETFQ=="], + + "debug": ["debug@4.4.3", "", { "dependencies": { "ms": "^2.1.3" }, "peerDependencies": { "supports-color": "*" }, "optionalPeers": ["supports-color"] }, "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA=="], + + "decode-named-character-reference": ["decode-named-character-reference@1.3.0", "", { "dependencies": { "character-entities": "^2.0.0" } }, "sha512-GtpQYB283KrPp6nRw50q3U9/VfOutZOe103qlN7BPP6Ad27xYnOIWv4lPzo8HCAL+mMZofJ9KEy30fq6MfaK6Q=="], + + "defu": ["defu@6.1.7", "", {}, "sha512-7z22QmUWiQ/2d0KkdYmANbRUVABpZ9SNYyH5vx6PZ+nE5bcC0l7uFvEfHlyld/HcGBFTL536ClDt3DEcSlEJAQ=="], + + "dequal": ["dequal@2.0.3", "", {}, "sha512-0je+qPKHEMohvfRTCEo3CrPG6cAzAYgmzKyxRiYSSDkS6eGJdyVJm7WaYA5ECaAD9wLB2T4EEeymA5aFVcYXCA=="], + + "destr": ["destr@2.0.5", "", {}, "sha512-ugFTXCtDZunbzasqBxrK93Ik/DRYsO6S/fedkWEMKqt04xZ4csmnmwGDBAb07QWNaGMAmnTIemsYZCksjATwsA=="], + + "detect-libc": ["detect-libc@2.1.2", "", {}, "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ=="], + + "devalue": ["devalue@5.9.2", "", {}, "sha512-po4PAY5c53tw5XMocSnf8A/5OHhbbUftpr93aEN6BBoAdntUmK7vu7wOATqvt7cXO7m1Cl4gMVn6p7n6n4mj0w=="], + + "devlop": ["devlop@1.1.0", "", { "dependencies": { "dequal": "2.0.3" } }, "sha512-RWmIqhcFf1lRYBvNmr7qTNuyCt/7/ns2jbpp1+PalgE/rDQcBT0fioSMUpJ93irlUhC5hrg4cYqe6U+0ImW0rA=="], + + "diff": ["diff@9.0.0", "", {}, "sha512-svtcdpS8CgJyqAjEQIXdb3OjhFVVYjzGAPO8WGCmRbrml64SPw/jJD4GoE98aR7r25A0XcgrK3F02yw9R/vhQw=="], + + "direction": ["direction@2.0.1", "", { "bin": { "direction": "cli.js" } }, "sha512-9S6m9Sukh1cZNknO1CWAr2QAWsbKLafQiyM5gZ7VgXHeuaoUwffKN4q6NC4A/Mf9iiPlOXQEKW/Mv/mh9/3YFA=="], + + "dom-serializer": ["dom-serializer@2.0.0", "", { "dependencies": { "domelementtype": "2.3.0", "domhandler": "5.0.3", "entities": "4.5.0" } }, "sha512-wIkAryiqt/nV5EQKqQpo3SToSOV9J0DnbJqwK7Wv/Trc92zIAYZ4FlMu+JPFW1DfGFt81ZTCGgDEabffXeLyJg=="], + + "domelementtype": ["domelementtype@2.3.0", "", {}, "sha512-OLETBj6w0OsagBwdXnPdN0cnMfF9opN69co+7ZrbfPGrdpPVNBUj02spi6B1N7wChLQiPn4CSH/zJvXw56gmHw=="], + + "domhandler": ["domhandler@5.0.3", "", { "dependencies": { "domelementtype": "2.3.0" } }, "sha512-cgwlv/1iFQiFnU96XXgROh8xTeetsnJiDsTc7TYCLFd9+/WNkIqPTxiM/8pSd8VIrhXGTf1Ny1q1hquVqDJB5w=="], + + "domutils": ["domutils@3.2.2", "", { "dependencies": { "dom-serializer": "2.0.0", "domelementtype": "2.3.0", "domhandler": "5.0.3" } }, "sha512-6kZKyUajlDuqlHKVX1w7gyslj9MPIXzIFiz/rGu35uC1wMi+kMhQwGhl4lt9unC9Vb9INnY9Z3/ZA3+FhASLaw=="], + + "dset": ["dset@3.1.4", "", {}, "sha512-2QF/g9/zTaPDc3BjNcVTGoBbXBgYfMTTceLaYcFJ/W9kggFUkhxD/hMEeuLKbugyef9SqAx8cpgwlIP/jinUTA=="], + + "emmet": ["emmet@2.4.11", "", { "dependencies": { "@emmetio/abbreviation": "^2.3.3", "@emmetio/css-abbreviation": "^2.1.8" } }, "sha512-23QPJB3moh/U9sT4rQzGgeyyGIrcM+GH5uVYg2C6wZIxAIJq7Ng3QLT79tl8FUwDXhyq9SusfknOrofAKqvgyQ=="], + + "emoji-regex": ["emoji-regex@10.6.0", "", {}, "sha512-toUI84YS5YmxW219erniWD0CIVOo46xGKColeNQRgOzDorgBi1v4D71/OFzgD9GO2UGKIv1C3Sp8DAn0+j5w7A=="], + + "entities": ["entities@4.5.0", "", {}, "sha512-V0hjH4dGPh9Ao5p0MoRY6BVqtwCjhz6vI5LT8AJ55H+4g9/4vbHx1I54fS0XuclLhDHArPQCiMjDxjaL8fPxhw=="], + + "es-module-lexer": ["es-module-lexer@2.3.2", "", {}, "sha512-poHGpORABojJJucnV9KbOavETW8lBVnphkW77ER5/BQ5Fz7oXSoCNek7IH3vR5nRjdsEz926ibFYX8KtLQmdyw=="], + + "esbuild": ["esbuild@0.28.2", "", { "optionalDependencies": { "@esbuild/aix-ppc64": "0.28.2", "@esbuild/android-arm": "0.28.2", "@esbuild/android-arm64": "0.28.2", "@esbuild/android-x64": "0.28.2", "@esbuild/darwin-arm64": "0.28.2", "@esbuild/darwin-x64": "0.28.2", "@esbuild/freebsd-arm64": "0.28.2", "@esbuild/freebsd-x64": "0.28.2", "@esbuild/linux-arm": "0.28.2", "@esbuild/linux-arm64": "0.28.2", "@esbuild/linux-ia32": "0.28.2", "@esbuild/linux-loong64": "0.28.2", "@esbuild/linux-mips64el": "0.28.2", "@esbuild/linux-ppc64": "0.28.2", "@esbuild/linux-riscv64": "0.28.2", "@esbuild/linux-s390x": "0.28.2", "@esbuild/linux-x64": "0.28.2", "@esbuild/netbsd-arm64": "0.28.2", "@esbuild/netbsd-x64": "0.28.2", "@esbuild/openbsd-arm64": "0.28.2", "@esbuild/openbsd-x64": "0.28.2", "@esbuild/openharmony-arm64": "0.28.2", "@esbuild/sunos-x64": "0.28.2", "@esbuild/win32-arm64": "0.28.2", "@esbuild/win32-ia32": "0.28.2", "@esbuild/win32-x64": "0.28.2" }, "bin": { "esbuild": "bin/esbuild" } }, "sha512-HKVLS8dvII+xoKW9kmqxbRKrnWEXfJJr/FZhhJmiqIB0e053QNYFqOBouTMO/k5sID4MvCiUCvv8b9M4h32wIA=="], + + "escalade": ["escalade@3.2.0", "", {}, "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA=="], + + "eventemitter3": ["eventemitter3@5.0.4", "", {}, "sha512-mlsTRyGaPBjPedk6Bvw+aqbsXDtoAyAzm5MO7JgU+yVRyMQ5O8bD4Kcci7BS85f93veegeCPkL8R4GLClnjLFw=="], + + "expressive-code": ["expressive-code@0.44.2", "", { "dependencies": { "@expressive-code/core": "^0.44.2", "@expressive-code/plugin-frames": "^0.44.2", "@expressive-code/plugin-shiki": "^0.44.2", "@expressive-code/plugin-text-markers": "^0.44.2" } }, "sha512-MLNghkvhyFgVW4oCD5DxBuYnnTXIf0PygzGmfT6OZeOOYWh/D4sH1j931biElkA5RG/J9wY/iuSMGAPF5vzHOg=="], + + "extend": ["extend@3.0.2", "", {}, "sha512-fjquC59cD7CyW6urNXK0FBufkZcoiGG80wTuPujX590cB5Ttln20E2UB4S/WARVqhXffZl2LNgS+gQdPIIim/g=="], + + "fast-deep-equal": ["fast-deep-equal@3.1.3", "", {}, "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q=="], + + "fast-string-truncated-width": ["fast-string-truncated-width@3.0.3", "", {}, "sha512-0jjjIEL6+0jag3l2XWWizO64/aZVtpiGE3t0Zgqxv0DPuxiMjvB3M24fCyhZUO4KomJQPj3LTSUnDP3GpdwC0g=="], + + "fast-string-width": ["fast-string-width@3.0.2", "", { "dependencies": { "fast-string-truncated-width": "3.0.3" } }, "sha512-gX8LrtNEI5hq8DVUfRQMbr5lpaS4nMIWV+7XEbXk2b8kiQIizgnlr12B4dA3ZEx3308ze0O4Q1R+cHts8kyUJg=="], + + "fast-uri": ["fast-uri@3.1.8", "", {}, "sha512-GZMtZUTNRpOVIECoXwLNZS5xUGE+mVNbTB8h/7Rwh2TFWcBQiPzTgyZi05BF9UMZKkLJv8XBRJTlU7zg8+ZfMg=="], + + "fast-wrap-ansi": ["fast-wrap-ansi@0.2.2", "", { "dependencies": { "fast-string-width": "3.0.2" } }, "sha512-7F2Fl+TjRSenLqlU3UjSH0iyqopqoZIu7eZVpEirP2g1GtWa2G/ecEmBdgz31+Mxr+ELclgg6sokpSFIQiZ02Q=="], + + "fdir": ["fdir@6.5.0", "", { "optionalDependencies": { "picomatch": "4.0.7" } }, "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg=="], + + "find-proc": ["find-proc@0.1.0", "", {}, "sha512-OaOpEYv2PiQ7SQ5LIrl+deA1XaWcxEjnpM6VuWXTUvn+teIXxeFTLDmu18/zDQpFmHN4o3oDBX+BT0AGwEhemg=="], + + "flattie": ["flattie@1.1.1", "", {}, "sha512-9UbaD6XdAL97+k/n+N7JwX46K/M6Zc6KcFYskrYL8wbBV/Uyk0CTAMY0VT+qiK5PM7AIc9aTWYtq65U7T+aCNQ=="], + + "fontace": ["fontace@0.4.1", "", { "dependencies": { "fontkitten": "1.0.3" } }, "sha512-lDMvbAzSnHmbYMTEld5qdtvNH2/pWpICOqpean9IgC7vUbUJc3k+k5Dokp85CegamqQpFbXf0rAVkbzpyTA8aw=="], + + "fontkitten": ["fontkitten@1.0.3", "", { "dependencies": { "tiny-inflate": "1.0.3" } }, "sha512-Wp1zXWPVUPBmfoa3Cqc9ctaKuzKAV6uLstRqlR56kSjplf5uAce+qeyYym7F+PHbGTk+tCEdkCW6RD7DX/gBZw=="], + + "fsevents": ["fsevents@2.3.3", "", { "os": "darwin" }, "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw=="], + + "get-caller-file": ["get-caller-file@2.0.5", "", {}, "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg=="], + + "get-east-asian-width": ["get-east-asian-width@1.6.0", "", {}, "sha512-QRbvDIbx6YklUe6RxeTeleMR0yv3cYH6PsPZHcnVn7xv7zO1BHN8r0XETu8n6Ye3Q+ahtSarc3WgtNWmehIBfA=="], + + "get-tsconfig": ["get-tsconfig@5.0.0-beta.4", "", { "dependencies": { "resolve-pkg-maps": "1.0.0" } }, "sha512-7nF7C9fIPFEMHgEMEfgIlO9wDdZ8CyHw27rWciFZfHvHDReIiPhsYuzPRXsfvBCqFy1l8RRyyWV7QLM+ZhUJsQ=="], + + "github-slugger": ["github-slugger@2.0.0", "", {}, "sha512-IaOQ9puYtjrkq7Y0Ygl9KDZnrf/aiUJYUpVf89y8kyaxbRG7Y1SrX/jaumrv81vc61+kiMempujsM3Yw7w5qcw=="], + + "h3": ["h3@1.15.11", "", { "dependencies": { "cookie-es": "1.2.3", "crossws": "0.3.5", "defu": "6.1.7", "destr": "2.0.5", "iron-webcrypto": "1.2.1", "node-mock-http": "1.0.5", "radix3": "1.1.2", "ufo": "1.6.4", "uncrypto": "0.1.3" } }, "sha512-L3THSe2MPeBwgIZVSH5zLdBBU90TOxarvhK9d04IDY2AmVS8j2Jz2LIWtwsGOU3lu2I5jCN7FNvVfY2+XyF+mg=="], + + "has-flag": ["has-flag@4.0.0", "", {}, "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ=="], + + "hast-util-embedded": ["hast-util-embedded@3.0.0", "", { "dependencies": { "@types/hast": "^3.0.0", "hast-util-is-element": "^3.0.0" } }, "sha512-naH8sld4Pe2ep03qqULEtvYr7EjrLK2QHY8KJR6RJkTUjPGObe1vnx585uzem2hGra+s1q08DZZpfgDVYRbaXA=="], + + "hast-util-format": ["hast-util-format@1.1.0", "", { "dependencies": { "@types/hast": "^3.0.0", "hast-util-embedded": "^3.0.0", "hast-util-minify-whitespace": "^1.0.0", "hast-util-phrasing": "^3.0.0", "hast-util-whitespace": "^3.0.0", "html-whitespace-sensitive-tag-names": "^3.0.0", "unist-util-visit-parents": "^6.0.0" } }, "sha512-yY1UDz6bC9rDvCWHpx12aIBGRG7krurX0p0Fm6pT547LwDIZZiNr8a+IHDogorAdreULSEzP82Nlv5SZkHZcjA=="], + + "hast-util-has-property": ["hast-util-has-property@3.0.0", "", { "dependencies": { "@types/hast": "^3.0.0" } }, "sha512-MNilsvEKLFpV604hwfhVStK0usFY/QmM5zX16bo7EjnAEGofr5YyI37kzopBlZJkHD4t887i+q/C8/tr5Q94cA=="], + + "hast-util-is-body-ok-link": ["hast-util-is-body-ok-link@3.0.1", "", { "dependencies": { "@types/hast": "^3.0.0" } }, "sha512-0qpnzOBLztXHbHQenVB8uNuxTnm/QBFUOmdOSsEn7GnBtyY07+ENTWVFBAnXd/zEgd9/SUG3lRY7hSIBWRgGpQ=="], + + "hast-util-is-element": ["hast-util-is-element@3.0.0", "", { "dependencies": { "@types/hast": "^3.0.0" } }, "sha512-Val9mnv2IWpLbNPqc/pUem+a7Ipj2aHacCwgNfTiK0vJKl0LF+4Ba4+v1oPHFpf3bLYmreq0/l3Gud9S5OH42g=="], + + "hast-util-minify-whitespace": ["hast-util-minify-whitespace@1.0.1", "", { "dependencies": { "@types/hast": "^3.0.0", "hast-util-embedded": "^3.0.0", "hast-util-is-element": "^3.0.0", "hast-util-whitespace": "^3.0.0", "unist-util-is": "^6.0.0" } }, "sha512-L96fPOVpnclQE0xzdWb/D12VT5FabA7SnZOUMtL1DbXmYiHJMXZvFkIZfiMmTCNJHUeO2K9UYNXoVyfz+QHuOw=="], + + "hast-util-parse-selector": ["hast-util-parse-selector@4.0.0", "", { "dependencies": { "@types/hast": "^3.0.0" } }, "sha512-wkQCkSYoOGCRKERFWcxMVMOcYE2K1AaNLU8DXS9arxnLOUEWbOXKXiJUNzEpqZ3JOKpnha3jkFrumEjVliDe7A=="], + + "hast-util-phrasing": ["hast-util-phrasing@3.0.1", "", { "dependencies": { "@types/hast": "^3.0.0", "hast-util-embedded": "^3.0.0", "hast-util-has-property": "^3.0.0", "hast-util-is-body-ok-link": "^3.0.0", "hast-util-is-element": "^3.0.0" } }, "sha512-6h60VfI3uBQUxHqTyMymMZnEbNl1XmEGtOxxKYL7stY2o601COo62AWAYBQR9lZbYXYSBoxag8UpPRXK+9fqSQ=="], + + "hast-util-select": ["hast-util-select@6.0.4", "", { "dependencies": { "@types/hast": "^3.0.0", "@types/unist": "^3.0.0", "bcp-47-match": "^2.0.0", "comma-separated-tokens": "^2.0.0", "css-selector-parser": "^3.0.0", "devlop": "^1.0.0", "direction": "^2.0.0", "hast-util-has-property": "^3.0.0", "hast-util-to-string": "^3.0.0", "hast-util-whitespace": "^3.0.0", "nth-check": "^2.0.0", "property-information": "^7.0.0", "space-separated-tokens": "^2.0.0", "unist-util-visit": "^5.0.0", "zwitch": "^2.0.0" } }, "sha512-RqGS1ZgI0MwxLaKLDxjprynNzINEkRHY2i8ln4DDjgv9ZhcYVIHN9rlpiYsqtFwrgpYU361SyWDQcGNIBVu3lw=="], + + "hast-util-to-html": ["hast-util-to-html@9.0.5", "", { "dependencies": { "@types/hast": "3.0.5", "@types/unist": "3.0.3", "ccount": "2.0.1", "comma-separated-tokens": "2.0.3", "hast-util-whitespace": "3.0.0", "html-void-elements": "3.0.0", "mdast-util-to-hast": "13.2.1", "property-information": "7.2.0", "space-separated-tokens": "2.0.2", "stringify-entities": "4.0.4", "zwitch": "2.0.4" } }, "sha512-OguPdidb+fbHQSU4Q4ZiLKnzWo8Wwsf5bZfbvu7//a9oTYoqD/fWpe96NuHkoS9h0ccGOTe0C4NGXdtS0iObOw=="], + + "hast-util-to-string": ["hast-util-to-string@3.0.1", "", { "dependencies": { "@types/hast": "^3.0.0" } }, "sha512-XelQVTDWvqcl3axRfI0xSeoVKzyIFPwsAGSLIsKdJKQMXDYJS4WYrBNF/8J7RdhIcFI2BOHgAifggsvsxp/3+A=="], + + "hast-util-to-text": ["hast-util-to-text@4.0.2", "", { "dependencies": { "@types/hast": "^3.0.0", "@types/unist": "^3.0.0", "hast-util-is-element": "^3.0.0", "unist-util-find-after": "^5.0.0" } }, "sha512-KK6y/BN8lbaq654j7JgBydev7wuNMcID54lkRav1P0CaE1e47P72AWWPiGKXTJU271ooYzcvTAn/Zt0REnvc7A=="], + + "hast-util-whitespace": ["hast-util-whitespace@3.0.0", "", { "dependencies": { "@types/hast": "3.0.5" } }, "sha512-88JUN06ipLwsnv+dVn+OIYOvAuvBMy/Qoi6O7mQHxdPXpjy+Cd6xRkWwux7DKO+4sYILtLBRIKgsdpS2gQc7qw=="], + + "hastscript": ["hastscript@9.0.1", "", { "dependencies": { "@types/hast": "^3.0.0", "comma-separated-tokens": "^2.0.0", "hast-util-parse-selector": "^4.0.0", "property-information": "^7.0.0", "space-separated-tokens": "^2.0.0" } }, "sha512-g7df9rMFX/SPi34tyGCyUBREQoKkapwdY/T04Qn9TDWfHhAYt4/I0gMVirzK5wEzeUqIjEB+LXC/ypb7Aqno5w=="], + + "html-escaper": ["html-escaper@3.0.3", "", {}, "sha512-RuMffC89BOWQoY0WKGpIhn5gX3iI54O6nRA0yC124NYVtzjmFWBIiFd8M0x+ZdX0P9R4lADg1mgP8C7PxGOWuQ=="], + + "html-void-elements": ["html-void-elements@3.0.0", "", {}, "sha512-bEqo66MRXsUGxWHV5IP0PUiAWwoEjba4VCzg0LjFJBpchPaTfyfCKTG6bc5F8ucKec3q5y6qOdGyYTSBEvhCrg=="], + + "html-whitespace-sensitive-tag-names": ["html-whitespace-sensitive-tag-names@3.0.1", "", {}, "sha512-q+310vW8zmymYHALr1da4HyXUQ0zgiIwIicEfotYPWGN0OJVEN/58IJ3A4GBYcEq3LGAZqKb+ugvP0GNB9CEAA=="], + + "http-cache-semantics": ["http-cache-semantics@4.2.0", "", {}, "sha512-dTxcvPXqPvXBQpq5dUr6mEMJX4oIEFv6bwom3FDwKRDsuIjjJGANqhBuoAn9c1RQJIdAKav33ED65E2ys+87QQ=="], + + "i18next": ["i18next@26.4.2", "", { "peerDependencies": { "typescript": "^5 || ^6 || ^7" }, "optionalPeers": ["typescript"] }, "sha512-RX+R0VLg13IbvRuJSxnqykUFS9vQZTl8wYpWPCIUDWVrSGjsQywB5Y+pjzrkboxGAuYfJZVH1InFTdgBdxq6ug=="], + + "iron-webcrypto": ["iron-webcrypto@1.2.1", "", {}, "sha512-feOM6FaSr6rEABp/eDfVseKyTMDt+KGpeB35SkVn9Tyn0CqvVsY3EwI0v5i8nMHyJnzCIQf7nsy3p41TPkJZhg=="], + + "is-alphabetical": ["is-alphabetical@2.0.1", "", {}, "sha512-FWyyY60MeTNyeSRpkM2Iry0G9hpr7/9kD40mD/cGQEuilcZYS4okz8SN2Q6rLCJ8gbCt6fN+rC+6tMGS99LaxQ=="], + + "is-alphanumerical": ["is-alphanumerical@2.0.1", "", { "dependencies": { "is-alphabetical": "^2.0.0", "is-decimal": "^2.0.0" } }, "sha512-hmbYhX/9MUMF5uh7tOXyK/n0ZvWpad5caBA17GsC6vyuCqaWliRG5K1qS9inmUhEMaOBIW7/whAnSwveW/LtZw=="], + + "is-decimal": ["is-decimal@2.0.1", "", {}, "sha512-AAB9hiomQs5DXWcRB1rqsxGUstbRroFOPPVAomNk/3XHR5JyEZChOyTWe2oayKnsSsr/kcGqF+z6yuH6HHpN0A=="], + + "is-docker": ["is-docker@4.0.0", "", { "bin": { "is-docker": "cli.js" } }, "sha512-LHE+wROyG/Y/0ZnbktRCoTix2c1RhgWaZraMZ8o1Q7zCh0VSrICJQO5oqIIISrcSBtrXv0o233w1IYwsWCjTzA=="], + + "is-hexadecimal": ["is-hexadecimal@2.0.1", "", {}, "sha512-DgZQp241c8oO6cA1SbTEWiXeoxV42vlcJxgH+B3hi1AiqqKruZR3ZGF8In3fj4+/y/7rHvlOZLZtgJ/4ttYGZg=="], + + "is-plain-obj": ["is-plain-obj@4.1.0", "", {}, "sha512-+Pgi+vMuUNkJyExiMBt5IlFoMyKnr5zhJ4Uspz58WOhBF5QoIZkFyNHIbBAtHwzVAgk5RtndVNsDRN61/mmDqg=="], + + "js-yaml": ["js-yaml@4.3.2", "", { "dependencies": { "argparse": "2.0.1" }, "bin": { "js-yaml": "bin/js-yaml.js" } }, "sha512-SFNOvSJ+Dgf/9An904Yx+CgSlIPCkIpao4qo51lpee25TIRejdH3rhR4EZMGoNx3/TP3O+wzWuiTFl4sqbltzA=="], + + "json-schema-traverse": ["json-schema-traverse@1.0.0", "", {}, "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug=="], + + "jsonc-parser": ["jsonc-parser@3.3.1", "", {}, "sha512-HUgH65KyejrUFPvHFPbqOY0rsFip3Bo5wb4ngvdi1EpCYWUQDC5V+Y7mZws+DLkr4M//zQJoanu1SP+87Dv1oQ=="], + + "kleur": ["kleur@4.1.5", "", {}, "sha512-o+NO+8WrRiQEE4/7nwRJhN1HWpVmJm511pBHUxPLtp0BUISzlBplORYSmTclCnJvQq2tKu/sgl3xVpkc7ZWuQQ=="], + + "klona": ["klona@2.0.6", "", {}, "sha512-dhG34DXATL5hSxJbIexCft8FChFXtmskoZYnoPWjXQuebWYCNkVeV3KkGegCK9CP1oswI/vQibS2GY7Em/sJJA=="], + + "lightningcss": ["lightningcss@1.33.0", "", { "dependencies": { "detect-libc": "2.1.2" }, "optionalDependencies": { "lightningcss-android-arm64": "1.33.0", "lightningcss-darwin-arm64": "1.33.0", "lightningcss-darwin-x64": "1.33.0", "lightningcss-freebsd-x64": "1.33.0", "lightningcss-linux-arm-gnueabihf": "1.33.0", "lightningcss-linux-arm64-gnu": "1.33.0", "lightningcss-linux-arm64-musl": "1.33.0", "lightningcss-linux-x64-gnu": "1.33.0", "lightningcss-linux-x64-musl": "1.33.0", "lightningcss-win32-arm64-msvc": "1.33.0", "lightningcss-win32-x64-msvc": "1.33.0" } }, "sha512-WkUDrojuJs0xkgGf2udWxa3yGBRxPtxUkB79i6aCZLRgc7PM8fZe9TosfPDcvEpQZbuFASnHYmRLBLUbmLOIIA=="], + + "lightningcss-android-arm64": ["lightningcss-android-arm64@1.33.0", "", { "os": "android", "cpu": "arm64" }, "sha512-gEpRTalKdosp4Bb8qWtc2iOgE5SeIHlpS1up9bFq2wAyYhl1UdTObYiHe98zEM9SQvSoqQZ1IQD0JNpg3Ml5pg=="], + + "lightningcss-darwin-arm64": ["lightningcss-darwin-arm64@1.33.0", "", { "os": "darwin", "cpu": "arm64" }, "sha512-Sciaz8eenNTKn9b3t7+xr0ipTp9YxKQY4npwQ3mrRuL0BAVHBLyZxofhaKBAVtzmtRZ/zTyo0/to4B1uWG/Djg=="], + + "lightningcss-darwin-x64": ["lightningcss-darwin-x64@1.33.0", "", { "os": "darwin", "cpu": "x64" }, "sha512-Z5UPAxzrjlWNNyGy6i65cJzzvgJ5D3T6wMvs+gWpY9d7qRhANrxqAp6LhxIgZhWEw18RfJTGcRxjuLIBr+m8XQ=="], + + "lightningcss-freebsd-x64": ["lightningcss-freebsd-x64@1.33.0", "", { "os": "freebsd", "cpu": "x64" }, "sha512-QQM/Ti/hQajJwCY+RiWuCZ9sdtI/XQk7nDK5vC8kkdwixezOlDgvDx7+RT+QjK6FcFT4MpsuoBnHIo/O3StRRg=="], + + "lightningcss-linux-arm-gnueabihf": ["lightningcss-linux-arm-gnueabihf@1.33.0", "", { "os": "linux", "cpu": "arm" }, "sha512-N7FVBe6iS24MlM6R/4RBTxGhQheZGs7tiQ9U32UtF75NzP5Q7xWPRqLBCKxlRQRk3rY1jCIPLzx7WzOhuUIRLQ=="], + + "lightningcss-linux-arm64-gnu": ["lightningcss-linux-arm64-gnu@1.33.0", "", { "os": "linux", "cpu": "arm64" }, "sha512-j2v/itmy4HlNxlc6voKXYgBqNi0Ng2LShg4z7GufpEgs05P+2suBVyi9I6YHq5uoVFx9ETin3eCEhLVyXGQnKg=="], + + "lightningcss-linux-arm64-musl": ["lightningcss-linux-arm64-musl@1.33.0", "", { "os": "linux", "cpu": "arm64" }, "sha512-yiO5ROMuYQgXbC60yjZU5CYSFZGKXL0HFATXt9mHJn1+zW55oCtMI9NfcVhYLMFDL7gV7oBPon/EmMMGg2OvtQ=="], + + "lightningcss-linux-x64-gnu": ["lightningcss-linux-x64-gnu@1.33.0", "", { "os": "linux", "cpu": "x64" }, "sha512-ar+Ju7LmcN0Jo4FpL4hpFybwNG9/3A/Br5KW2n2jyODg3MEZXaDYADdemoNS+BDNfMgKvylJLj4S5tyRActuAg=="], + + "lightningcss-linux-x64-musl": ["lightningcss-linux-x64-musl@1.33.0", "", { "os": "linux", "cpu": "x64" }, "sha512-RYiYbkokw0trfKqqzfF55lginwEPrD3OJDfTuJzFs1MK6iFnDenaz1fqLLtX4ITG3OktJQXOeTaw1awrBAlZPw=="], + + "lightningcss-win32-arm64-msvc": ["lightningcss-win32-arm64-msvc@1.33.0", "", { "os": "win32", "cpu": "arm64" }, "sha512-1K+MPfLSFVpphzpdbfkhlWk6wBrTObBzS2T6db10PNOZgR9GoVsAWzwNyuhUYYbTp23j+4RrncfujZ4uAzXvwA=="], + + "lightningcss-win32-x64-msvc": ["lightningcss-win32-x64-msvc@1.33.0", "", { "os": "win32", "cpu": "x64" }, "sha512-OlEICDx/Xl0FqSp4bry8zFnCvGpig3Gl4gCquvYwHuqJKEC1+n9NgDniFvqHGmMv1ZkqDJrDqKKSykTDX+ehuA=="], + + "longest-streak": ["longest-streak@3.1.0", "", {}, "sha512-9Ri+o0JYgehTaVBBDoMqIl8GXtbWg711O3srftcHhZ0dqnETqLaoIK0x17fUw9rFSlK/0NlsKe0Ahhyl5pXE2g=="], + + "lru-cache": ["lru-cache@11.5.2", "", {}, "sha512-4pfM1Ff0x50o0tQwb5ucw/RzNyD0/YJME6IVcStalZuMWxdt3sR3huStTtxz4PUmvZfRguvDejasvQ2kifR11g=="], + + "magic-string": ["magic-string@1.4.1", "", { "dependencies": { "@jridgewell/sourcemap-codec": "1.6.0" } }, "sha512-8lyCu36ErXR0J9uaGKlKQoiLZKmtI63YGLE8G2o9jyRPdr4X47LusSOwgOJOzcVtp81fTAAjxR7BwKz682Jhow=="], + + "magicast": ["magicast@0.5.5", "", { "dependencies": { "@babel/parser": "7.29.8", "@babel/types": "7.29.8", "source-map-js": "1.2.1" } }, "sha512-UicdXN8zQ3JHlxVq+28afMXPr1z7WNY6+7EJnzTdQWkTAlMLF5fNCCKxJHBQwGaNGR11581EiQmQzx73+MvszA=="], + + "mdast-util-directive": ["mdast-util-directive@3.1.0", "", { "dependencies": { "@types/mdast": "^4.0.0", "@types/unist": "^3.0.0", "ccount": "^2.0.0", "devlop": "^1.0.0", "mdast-util-from-markdown": "^2.0.0", "mdast-util-to-markdown": "^2.0.0", "parse-entities": "^4.0.0", "stringify-entities": "^4.0.0", "unist-util-visit-parents": "^6.0.0" } }, "sha512-I3fNFt+DHmpWCYAT7quoM6lHf9wuqtI+oCOfvILnoicNIqjh5E3dEJWiXuYME2gNe8vl1iMQwyUHa7bgFmak6Q=="], + + "mdast-util-from-markdown": ["mdast-util-from-markdown@2.0.3", "", { "dependencies": { "@types/mdast": "^4.0.0", "@types/unist": "^3.0.0", "decode-named-character-reference": "^1.0.0", "devlop": "^1.0.0", "mdast-util-to-string": "^4.0.0", "micromark": "^4.0.0", "micromark-util-decode-numeric-character-reference": "^2.0.0", "micromark-util-decode-string": "^2.0.0", "micromark-util-normalize-identifier": "^2.0.0", "micromark-util-symbol": "^2.0.0", "micromark-util-types": "^2.0.0", "unist-util-stringify-position": "^4.0.0" } }, "sha512-W4mAWTvSlKvf8L6J+VN9yLSqQ9AOAAvHuoDAmPkz4dHf553m5gVj2ejadHJhoJmcmxEnOv6Pa8XJhpxE93kb8Q=="], + + "mdast-util-phrasing": ["mdast-util-phrasing@4.1.0", "", { "dependencies": { "@types/mdast": "^4.0.0", "unist-util-is": "^6.0.0" } }, "sha512-TqICwyvJJpBwvGAMZjj4J2n0X8QWp21b9l0o7eXyVJ25YNWYbJDVIyD1bZXE6WtV6RmKJVYmQAKWa0zWOABz2w=="], + + "mdast-util-to-hast": ["mdast-util-to-hast@13.2.1", "", { "dependencies": { "@types/hast": "3.0.5", "@types/mdast": "4.0.4", "@ungap/structured-clone": "1.4.0", "devlop": "1.1.0", "micromark-util-sanitize-uri": "2.0.1", "trim-lines": "3.0.1", "unist-util-position": "5.0.0", "unist-util-visit": "5.1.0", "vfile": "6.0.3" } }, "sha512-cctsq2wp5vTsLIcaymblUriiTcZd0CwWtCbLvrOzYCDZoWyMNV8sZ7krj09FSnsiJi3WVsHLM4k6Dq/yaPyCXA=="], + + "mdast-util-to-markdown": ["mdast-util-to-markdown@2.1.2", "", { "dependencies": { "@types/mdast": "^4.0.0", "@types/unist": "^3.0.0", "longest-streak": "^3.0.0", "mdast-util-phrasing": "^4.0.0", "mdast-util-to-string": "^4.0.0", "micromark-util-classify-character": "^2.0.0", "micromark-util-decode-string": "^2.0.0", "unist-util-visit": "^5.0.0", "zwitch": "^2.0.0" } }, "sha512-xj68wMTvGXVOKonmog6LwyJKrYXZPvlwabaryTjLh9LuvovB/KAH+kvi8Gjj+7rJjsFi23nkUxRQv1KqSroMqA=="], + + "mdast-util-to-string": ["mdast-util-to-string@4.0.0", "", { "dependencies": { "@types/mdast": "^4.0.0" } }, "sha512-0H44vDimn51F0YwvxSJSm0eCDOJTRlmN0R1yBh4HLj9wiV1Dn0QoXGbvFAWj2hSItVTlCmBF1hqKlIyUBVFLPg=="], + + "mdn-data": ["mdn-data@2.27.1", "", {}, "sha512-9Yubnt3e8A0OKwxYSXyhLymGW4sCufcLG6VdiDdUGVkPhpqLxlvP5vl1983gQjJl3tqbrM731mjaZaP68AgosQ=="], + + "micromark": ["micromark@4.0.2", "", { "dependencies": { "@types/debug": "^4.0.0", "debug": "^4.0.0", "decode-named-character-reference": "^1.0.0", "devlop": "^1.0.0", "micromark-core-commonmark": "^2.0.0", "micromark-factory-space": "^2.0.0", "micromark-util-character": "^2.0.0", "micromark-util-chunked": "^2.0.0", "micromark-util-combine-extensions": "^2.0.0", "micromark-util-decode-numeric-character-reference": "^2.0.0", "micromark-util-encode": "^2.0.0", "micromark-util-normalize-identifier": "^2.0.0", "micromark-util-resolve-all": "^2.0.0", "micromark-util-sanitize-uri": "^2.0.0", "micromark-util-subtokenize": "^2.0.0", "micromark-util-symbol": "^2.0.0", "micromark-util-types": "^2.0.0" } }, "sha512-zpe98Q6kvavpCr1NPVSCMebCKfD7CA2NqZ+rykeNhONIJBpc1tFKt9hucLGwha3jNTNI8lHpctWJWoimVF4PfA=="], + + "micromark-core-commonmark": ["micromark-core-commonmark@2.0.3", "", { "dependencies": { "decode-named-character-reference": "^1.0.0", "devlop": "^1.0.0", "micromark-factory-destination": "^2.0.0", "micromark-factory-label": "^2.0.0", "micromark-factory-space": "^2.0.0", "micromark-factory-title": "^2.0.0", "micromark-factory-whitespace": "^2.0.0", "micromark-util-character": "^2.0.0", "micromark-util-chunked": "^2.0.0", "micromark-util-classify-character": "^2.0.0", "micromark-util-html-tag-name": "^2.0.0", "micromark-util-normalize-identifier": "^2.0.0", "micromark-util-resolve-all": "^2.0.0", "micromark-util-subtokenize": "^2.0.0", "micromark-util-symbol": "^2.0.0", "micromark-util-types": "^2.0.0" } }, "sha512-RDBrHEMSxVFLg6xvnXmb1Ayr2WzLAWjeSATAoxwKYJV94TeNavgoIdA0a9ytzDSVzBy2YKFK+emCPOEibLeCrg=="], + + "micromark-extension-directive": ["micromark-extension-directive@4.0.0", "", { "dependencies": { "devlop": "^1.0.0", "micromark-factory-space": "^2.0.0", "micromark-factory-whitespace": "^2.0.0", "micromark-util-character": "^2.0.0", "micromark-util-symbol": "^2.0.0", "micromark-util-types": "^2.0.0", "parse-entities": "^4.0.0" } }, "sha512-/C2nqVmXXmiseSSuCdItCMho7ybwwop6RrrRPk0KbOHW21JKoCldC+8rFOaundDoRBUWBnJJcxeA/Kvi34WQXg=="], + + "micromark-factory-destination": ["micromark-factory-destination@2.0.1", "", { "dependencies": { "micromark-util-character": "^2.0.0", "micromark-util-symbol": "^2.0.0", "micromark-util-types": "^2.0.0" } }, "sha512-Xe6rDdJlkmbFRExpTOmRj9N3MaWmbAgdpSrBQvCFqhezUn4AHqJHbaEnfbVYYiexVSs//tqOdY/DxhjdCiJnIA=="], + + "micromark-factory-label": ["micromark-factory-label@2.0.1", "", { "dependencies": { "devlop": "^1.0.0", "micromark-util-character": "^2.0.0", "micromark-util-symbol": "^2.0.0", "micromark-util-types": "^2.0.0" } }, "sha512-VFMekyQExqIW7xIChcXn4ok29YE3rnuyveW3wZQWWqF4Nv9Wk5rgJ99KzPvHjkmPXF93FXIbBp6YdW3t71/7Vg=="], + + "micromark-factory-space": ["micromark-factory-space@2.0.1", "", { "dependencies": { "micromark-util-character": "^2.0.0", "micromark-util-types": "^2.0.0" } }, "sha512-zRkxjtBxxLd2Sc0d+fbnEunsTj46SWXgXciZmHq0kDYGnck/ZSGj9/wULTV95uoeYiK5hRXP2mJ98Uo4cq/LQg=="], + + "micromark-factory-title": ["micromark-factory-title@2.0.1", "", { "dependencies": { "micromark-factory-space": "^2.0.0", "micromark-util-character": "^2.0.0", "micromark-util-symbol": "^2.0.0", "micromark-util-types": "^2.0.0" } }, "sha512-5bZ+3CjhAd9eChYTHsjy6TGxpOFSKgKKJPJxr293jTbfry2KDoWkhBb6TcPVB4NmzaPhMs1Frm9AZH7OD4Cjzw=="], + + "micromark-factory-whitespace": ["micromark-factory-whitespace@2.0.1", "", { "dependencies": { "micromark-factory-space": "^2.0.0", "micromark-util-character": "^2.0.0", "micromark-util-symbol": "^2.0.0", "micromark-util-types": "^2.0.0" } }, "sha512-Ob0nuZ3PKt/n0hORHyvoD9uZhr+Za8sFoP+OnMcnWK5lngSzALgQYKMr9RJVOWLqQYuyn6ulqGWSXdwf6F80lQ=="], + + "micromark-util-character": ["micromark-util-character@2.1.1", "", { "dependencies": { "micromark-util-symbol": "2.0.1", "micromark-util-types": "2.0.2" } }, "sha512-wv8tdUTJ3thSFFFJKtpYKOYiGP2+v96Hvk4Tu8KpCAsTMs6yi+nVmGh1syvSCsaxz45J6Jbw+9DD6g97+NV67Q=="], + + "micromark-util-chunked": ["micromark-util-chunked@2.0.1", "", { "dependencies": { "micromark-util-symbol": "^2.0.0" } }, "sha512-QUNFEOPELfmvv+4xiNg2sRYeS/P84pTW0TCgP5zc9FpXetHY0ab7SxKyAQCNCc1eK0459uoLI1y5oO5Vc1dbhA=="], + + "micromark-util-classify-character": ["micromark-util-classify-character@2.0.1", "", { "dependencies": { "micromark-util-character": "^2.0.0", "micromark-util-symbol": "^2.0.0", "micromark-util-types": "^2.0.0" } }, "sha512-K0kHzM6afW/MbeWYWLjoHQv1sgg2Q9EccHEDzSkxiP/EaagNzCm7T/WMKZ3rjMbvIpvBiZgwR3dKMygtA4mG1Q=="], + + "micromark-util-combine-extensions": ["micromark-util-combine-extensions@2.0.1", "", { "dependencies": { "micromark-util-chunked": "^2.0.0", "micromark-util-types": "^2.0.0" } }, "sha512-OnAnH8Ujmy59JcyZw8JSbK9cGpdVY44NKgSM7E9Eh7DiLS2E9RNQf0dONaGDzEG9yjEl5hcqeIsj4hfRkLH/Bg=="], + + "micromark-util-decode-numeric-character-reference": ["micromark-util-decode-numeric-character-reference@2.0.2", "", { "dependencies": { "micromark-util-symbol": "^2.0.0" } }, "sha512-ccUbYk6CwVdkmCQMyr64dXz42EfHGkPQlBj5p7YVGzq8I7CtjXZJrubAYezf7Rp+bjPseiROqe7G6foFd+lEuw=="], + + "micromark-util-decode-string": ["micromark-util-decode-string@2.0.1", "", { "dependencies": { "decode-named-character-reference": "^1.0.0", "micromark-util-character": "^2.0.0", "micromark-util-decode-numeric-character-reference": "^2.0.0", "micromark-util-symbol": "^2.0.0" } }, "sha512-nDV/77Fj6eH1ynwscYTOsbK7rR//Uj0bZXBwJZRfaLEJ1iGBR6kIfNmlNqaqJf649EP0F3NWNdeJi03elllNUQ=="], + + "micromark-util-encode": ["micromark-util-encode@2.0.1", "", {}, "sha512-c3cVx2y4KqUnwopcO9b/SCdo2O67LwJJ/UyqGfbigahfegL9myoEFoDYZgkT7f36T0bLrM9hZTAaAyH+PCAXjw=="], + + "micromark-util-html-tag-name": ["micromark-util-html-tag-name@2.0.1", "", {}, "sha512-2cNEiYDhCWKI+Gs9T0Tiysk136SnR13hhO8yW6BGNyhOC4qYFnwF1nKfD3HFAIXA5c45RrIG1ub11GiXeYd1xA=="], + + "micromark-util-normalize-identifier": ["micromark-util-normalize-identifier@2.0.1", "", { "dependencies": { "micromark-util-symbol": "^2.0.0" } }, "sha512-sxPqmo70LyARJs0w2UclACPUUEqltCkJ6PhKdMIDuJ3gSf/Q+/GIe3WKl0Ijb/GyH9lOpUkRAO2wp0GVkLvS9Q=="], + + "micromark-util-resolve-all": ["micromark-util-resolve-all@2.0.1", "", { "dependencies": { "micromark-util-types": "^2.0.0" } }, "sha512-VdQyxFWFT2/FGJgwQnJYbe1jjQoNTS4RjglmSjTUlpUMa95Htx9NHeYW4rGDJzbjvCsl9eLjMQwGeElsqmzcHg=="], + + "micromark-util-sanitize-uri": ["micromark-util-sanitize-uri@2.0.1", "", { "dependencies": { "micromark-util-character": "2.1.1", "micromark-util-encode": "2.0.1", "micromark-util-symbol": "2.0.1" } }, "sha512-9N9IomZ/YuGGZZmQec1MbgxtlgougxTodVwDzzEouPKo3qFWvymFHWcnDi2vzV1ff6kas9ucW+o3yzJK9YB1AQ=="], + + "micromark-util-subtokenize": ["micromark-util-subtokenize@2.1.0", "", { "dependencies": { "devlop": "^1.0.0", "micromark-util-chunked": "^2.0.0", "micromark-util-symbol": "^2.0.0", "micromark-util-types": "^2.0.0" } }, "sha512-XQLu552iSctvnEcgXw6+Sx75GflAPNED1qx7eBJ+wydBb2KCbRZe+NwvIEEMM83uml1+2WSXpBAcp9IUCgCYWA=="], + + "micromark-util-symbol": ["micromark-util-symbol@2.0.1", "", {}, "sha512-vs5t8Apaud9N28kgCrRUdEed4UJ+wWNvicHLPxCa9ENlYuAY31M0ETy5y1vA33YoNPDFTghEbnh6efaE8h4x0Q=="], + + "micromark-util-types": ["micromark-util-types@2.0.2", "", {}, "sha512-Yw0ECSpJoViF1qTU4DC6NwtC4aWGt1EkzaQB8KPPyCRR8z9TWeV0HbEFGTO+ZY1wB22zmxnJqhPyTpOVCpeHTA=="], + + "mrmime": ["mrmime@2.0.1", "", {}, "sha512-Y3wQdFg2Va6etvQ5I82yUhGdsKrcYox6p7FfL1LbK2J4V01F9TGlepTIhnK24t7koZibmg82KGglhA1XK5IsLQ=="], + + "ms": ["ms@2.1.3", "", {}, "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA=="], + + "muggle-string": ["muggle-string@0.4.1", "", {}, "sha512-VNTrAak/KhO2i8dqqnqnAHOa3cYBwXEZe9h+D5h/1ZqFSTEFHdM65lR7RoIqq3tBBYavsOXV84NoHXZ0AkPyqQ=="], + + "nanoid": ["nanoid@3.3.19", "", { "bin": { "nanoid": "bin/nanoid.cjs" } }, "sha512-Y2tUNy4ouw6tq5oDSKeQYGOyhkUBhNOcGV/02KC+6kd9eDGqdZd++mjMiIDilrBYvjEnCYvVtsuHCuP+okSfug=="], + + "neotraverse": ["neotraverse@1.0.1", "", {}, "sha512-WmmLty1YWwJl9yZi77v2dVIV6X2kuYV8YYBI/G3LWGKdGHmHUvL1z7FW0iDvEvGAwNEoc5x1tOOOyDnf5jJw/w=="], + + "nlcst-to-string": ["nlcst-to-string@4.0.0", "", { "dependencies": { "@types/nlcst": "2.0.3" } }, "sha512-YKLBCcUYKAg0FNlOBT6aI91qFmSiFKiluk655WzPF+DDMA02qIyy8uiRqI8QXtcFpEvll12LpL5MXqEmAZ+dcA=="], + + "node-fetch-native": ["node-fetch-native@1.6.7", "", {}, "sha512-g9yhqoedzIUm0nTnTqAQvueMPVOuIY16bqgAJJC8XOOubYFNwz6IER9qs0Gq2Xd0+CecCKFjtdDTMA4u4xG06Q=="], + + "node-mock-http": ["node-mock-http@1.0.5", "", {}, "sha512-KQyt/wLjG3TAc7DOUhpqWzgd4ERxR80JOlTK5VE5R1S12IaPVN5qkj4klBce9HPG1Njuup4Sb5bljaT34lIyjw=="], + + "normalize-path": ["normalize-path@3.0.0", "", {}, "sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA=="], + + "nth-check": ["nth-check@2.1.1", "", { "dependencies": { "boolbase": "1.0.0" } }, "sha512-lqjrjmaOoAnWfMmBPL+XNnynZh2+swxiX3WUE0s4yEHI6m+AwrK2UZOimIRl3X/4QctVqS8AiZjFqyOGrMXb/w=="], + + "obug": ["obug@2.2.1", "", {}, "sha512-XrsrhT5sybtKI6wakr2SPOlGZWWYbUXZ7a0jT8/QOeAPau+1X/bSegNe5YR75oJmEZQbKningirmGOEJCIk61Q=="], + + "ofetch": ["ofetch@1.5.1", "", { "dependencies": { "destr": "2.0.5", "node-fetch-native": "1.6.7", "ufo": "1.6.4" } }, "sha512-2W4oUZlVaqAPAil6FUg/difl6YhqhUR7x2eZY4bQCko22UXg3hptq9KLQdqFClV+Wu85UX7hNtdGTngi/1BxcA=="], + + "ohash": ["ohash@2.0.12", "", {}, "sha512-65S/5gk9YSsaRjcyf7Nfa6h/d3E8/1gslpXfI4W7Dxn/oap8IKRuNT5VXkLQ1YFKIEg4apRY4Pj6aiwFzrDdmw=="], + + "oniguruma-parser": ["oniguruma-parser@0.12.2", "", {}, "sha512-6HVa5oIrgMC6aA6WF6XyyqbhRPJrKR02L20+2+zpDtO5QAzGHAUGw5TKQvwi5vctNnRHkJYmjAhRVQF2EKdTQw=="], + + "oniguruma-to-es": ["oniguruma-to-es@4.3.6", "", { "dependencies": { "oniguruma-parser": "0.12.2", "regex": "6.1.0", "regex-recursion": "6.0.2" } }, "sha512-csuQ9x3Yr0cEIs/Zgx/OEt9iBw9vqIunAPQkx19R/fiMq2oGVTgcMqO/V3Ybqefr1TBvosI6jU539ksaBULJyA=="], + + "p-limit": ["p-limit@7.3.2", "", { "dependencies": { "yocto-queue": "1.2.2" } }, "sha512-Ll0w3fU24vYpXoZmjjZIee6bJQDgG0oAyo1PdmFYI8UDwJJddaHAypxIH9avUu+t+lSsAwKVsb1jDCMIIChliw=="], + + "p-queue": ["p-queue@9.3.3", "", { "dependencies": { "eventemitter3": "5.0.4", "p-timeout": "7.0.2" } }, "sha512-NXAOdnEe5FsZJfT4oK84lE1Y5cFFdWlRuOo5tww8DyNMxyRXwn39fIkUtNLKppcPC+UYU/bXujNCUGDv01y7CA=="], + + "p-timeout": ["p-timeout@7.0.2", "", {}, "sha512-prbX4Z3YszrFNgH+MW5Zoeq3baXrMtP/MQnFeET90UB/GtGcGDQ5Usg9OCy6ETjTTntOw1SL2z9fMPUppN3Guw=="], + + "package-manager-detector": ["package-manager-detector@1.8.0", "", {}, "sha512-yQA4H19AmPEoMUeavPMDIe1higySl/gH/yaQrkT/s07Qp+7pp2hYz30N3z2l5BkjVkF9Ow6o0wjJamm2y7Sn0A=="], + + "pagefind": ["pagefind@1.5.2", "", { "optionalDependencies": { "@pagefind/darwin-arm64": "1.5.2", "@pagefind/darwin-x64": "1.5.2", "@pagefind/freebsd-x64": "1.5.2", "@pagefind/linux-arm64": "1.5.2", "@pagefind/linux-x64": "1.5.2", "@pagefind/windows-arm64": "1.5.2", "@pagefind/windows-x64": "1.5.2" }, "bin": { "pagefind": "lib/runner/bin.cjs" } }, "sha512-XTUaK0hXMCu2jszWE584JGQT7y284TmMV9l/HX3rnG5uo3rHI/uHU56XTyyyPFjeWEBxECbAi0CaFDJOONtG0Q=="], + + "parse-entities": ["parse-entities@4.0.2", "", { "dependencies": { "@types/unist": "^2.0.0", "character-entities-legacy": "^3.0.0", "character-reference-invalid": "^2.0.0", "decode-named-character-reference": "^1.0.0", "is-alphanumerical": "^2.0.0", "is-decimal": "^2.0.0", "is-hexadecimal": "^2.0.0" } }, "sha512-GG2AQYWoLgL877gQIKeRPGO1xF9+eG1ujIb5soS5gPvLQ1y2o8FL90w2QWNdf9I361Mpp7726c+lj3U0qK1uGw=="], + + "path-browserify": ["path-browserify@1.0.1", "", {}, "sha512-b7uo2UCUOYZcnF/3ID0lulOJi/bafxa1xPe7ZPsammBSpjSWQkjNxlt635YGS2MiR9GjvuXCtz2emr3jbsz98g=="], + + "piccolore": ["piccolore@0.1.3", "", {}, "sha512-o8bTeDWjE086iwKrROaDf31K0qC/BENdm15/uH9usSC/uZjJOKb2YGiVHfLY4GhwsERiPI1jmwI2XrA7ACOxVw=="], + + "picocolors": ["picocolors@1.1.1", "", {}, "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA=="], + + "picomatch": ["picomatch@4.0.7", "", {}, "sha512-qcJu88Q2IWqJsDD529JKMdwGm/dvInW4HvQnRwiH9JtihJvzGOscDtHE3x1pBKeUOTysQ8kVmLnJ2kJu7yhcGA=="], + + "postcss": ["postcss@8.5.28", "", { "dependencies": { "nanoid": "3.3.19", "picocolors": "1.1.1", "source-map-js": "1.2.1" } }, "sha512-RRuzqDtt5Y9h3quz5hWhK+TPnsmVs6WwSU6LkJMeY4HstUEDuYTG8UJSdawMRzmzAtV+KEoG8N3Qg2qLy5vM/A=="], + + "postcss-nested": ["postcss-nested@6.2.0", "", { "dependencies": { "postcss-selector-parser": "^6.1.1" }, "peerDependencies": { "postcss": "^8.2.14" } }, "sha512-HQbt28KulC5AJzG+cZtj9kvKB93CFCdLvog1WFLf1D+xmMvPGlBstkpTEZfK5+AN9hfJocyBFCNiqyS48bpgzQ=="], + + "postcss-selector-parser": ["postcss-selector-parser@6.1.4", "", { "dependencies": { "cssesc": "^3.0.0", "util-deprecate": "^1.0.2" } }, "sha512-bIoJLOmjCO1S9XdY/DcnR5hJxvrDir1PbGChrzXG3vw0/FOliy/fA3dmdhQ441kah4gKv+TwckGzex6wNS5cnQ=="], + + "prettier": ["prettier@3.9.7", "", { "bin": { "prettier": "bin/prettier.cjs" } }, "sha512-T3mF5P7HFzZVLDQuCUNtJj6WK1pcpLMweMNUVwGb01bLNkH9AkKxtZvmInw8K6bnn2O3d6/5RHl6zSHiBAD0Og=="], + + "prismjs": ["prismjs@1.30.0", "", {}, "sha512-DEvV2ZF2r2/63V+tK8hQvrR2ZGn10srHbXviTlcv7Kpzw8jWiNTqbVgjO3IY8RxrrOUF8VPMQQFysYYYv0YZxw=="], + + "process-ancestry": ["process-ancestry@0.1.0", "", {}, "sha512-tGqJW/UnclpYASFcM6Xh8D8l/BMtaQ9+CSG0vlJSJTcdMM4lDRv4c6H0Pdcsfted+bVczdYSfk2fdukg2gQkZg=="], + + "property-information": ["property-information@7.2.0", "", {}, "sha512-IAtzIB6sUiWaJYrX9smp3V46pBGbBeLFRGdh25kg1334VcBlD8HzhPeNIWQH9zhGmo2itIe25EHt9dQP7G5hmg=="], + + "radix3": ["radix3@1.1.2", "", {}, "sha512-b484I/7b8rDEdSDKckSSBA8knMpcdsXudlE/LNL639wFoHKwLbEkQFZHWEYwDC0wa0FKUcCY+GAF73Z7wxNVFA=="], + + "readdirp": ["readdirp@4.1.2", "", {}, "sha512-GDhwkLfywWL2s6vEjyhri+eXmfH6j1L7JE27WhqLeYzoh/A3DBaYGEj2H/HFZCn/kMfim73FXxEJTw06WtxQwg=="], + + "regex": ["regex@6.1.0", "", { "dependencies": { "regex-utilities": "2.3.0" } }, "sha512-6VwtthbV4o/7+OaAF9I5L5V3llLEsoPyq9P1JVXkedTP33c7MfCG0/5NOPcSJn0TzXcG9YUrR0gQSWioew3LDg=="], + + "regex-recursion": ["regex-recursion@6.0.2", "", { "dependencies": { "regex-utilities": "2.3.0" } }, "sha512-0YCaSCq2VRIebiaUviZNs0cBz1kg5kVS2UKUfNIx8YVs1cN3AV7NTctO5FOKBA+UT2BPJIWZauYHPqJODG50cg=="], + + "regex-utilities": ["regex-utilities@2.3.0", "", {}, "sha512-8VhliFJAWRaUiVvREIiW2NXXTmHs4vMNnSzuJVhscgmGav3g9VDxLrQndI3dZZVVdp0ZO/5v0xmX516/7M9cng=="], + + "rehype-expressive-code": ["rehype-expressive-code@0.44.2", "", { "dependencies": { "expressive-code": "^0.44.2" } }, "sha512-jvjQpsfWKBquDrEl5YQA3CJybRRIuDOYsui1BJTs5oKDUK8pPkJSSxY8FjxNlIFIdtgrTjC1zuahuY4Cc1j9SQ=="], + + "remark-directive": ["remark-directive@4.0.0", "", { "dependencies": { "@types/mdast": "^4.0.0", "mdast-util-directive": "^3.0.0", "micromark-extension-directive": "^4.0.0", "unified": "^11.0.0" } }, "sha512-7sxn4RfF1o3izevPV1DheyGDD6X4c9hrGpfdUpm7uC++dqrnJxIZVkk7CoKqcLm0VUMAuOol7Mno3m6g8cfMuA=="], + + "request-light": ["request-light@0.7.0", "", {}, "sha512-lMbBMrDoxgsyO+yB3sDcrDuX85yYt7sS8BfQd11jtbW/z5ZWgLZRcEGLsLoYw7I0WSUGQBs8CC8ScIxkTX1+6Q=="], + + "require-from-string": ["require-from-string@2.0.2", "", {}, "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw=="], + + "resolve-pkg-maps": ["resolve-pkg-maps@1.0.0", "", {}, "sha512-seS2Tj26TBVOC2NIc2rOe2y2ZO7efxITtLZcGSOnHHNOQ7CkiUBfw0Iw2ck6xkIhPwLhKNLS8BO+hEpngQlqzw=="], + + "retext-smartypants": ["retext-smartypants@6.2.0", "", { "dependencies": { "@types/nlcst": "2.0.3", "nlcst-to-string": "4.0.0", "unist-util-visit": "5.1.0" } }, "sha512-kk0jOU7+zGv//kfjXEBjdIryL1Acl4i9XNkHxtM7Tm5lFiCog576fjNC9hjoR7LTKQ0DsPWy09JummSsH1uqfQ=="], + + "rolldown": ["rolldown@1.2.8", "", { "dependencies": { "@oxc-project/types": "0.149.0", "@rolldown/pluginutils": "1.0.1" }, "optionalDependencies": { "@rolldown/binding-android-arm-eabi": "1.2.8", "@rolldown/binding-android-arm64": "1.2.8", "@rolldown/binding-darwin-arm64": "1.2.8", "@rolldown/binding-darwin-x64": "1.2.8", "@rolldown/binding-freebsd-x64": "1.2.8", "@rolldown/binding-linux-arm-gnueabihf": "1.2.8", "@rolldown/binding-linux-arm64-gnu": "1.2.8", "@rolldown/binding-linux-arm64-musl": "1.2.8", "@rolldown/binding-linux-ppc64-gnu": "1.2.8", "@rolldown/binding-linux-s390x-gnu": "1.2.8", "@rolldown/binding-linux-x64-gnu": "1.2.8", "@rolldown/binding-linux-x64-musl": "1.2.8", "@rolldown/binding-openharmony-arm64": "1.2.8", "@rolldown/binding-win32-arm64-msvc": "1.2.8", "@rolldown/binding-win32-x64-msvc": "1.2.8" }, "bin": { "rolldown": "./bin/cli.mjs" } }, "sha512-Z67nTmhZe7anqnM/EjI392w5i/ANUinjip7QYsOyN37oayduxt3ksdX0hf5OOamkAd53BiIHfbfSzfUmzKFQqQ=="], + + "satteri": ["satteri@0.10.5", "", { "dependencies": { "@types/estree-jsx": "1.0.5", "@types/hast": "3.0.5", "@types/mdast": "4.0.4", "@types/unist": "3.0.3" }, "optionalDependencies": { "@bruits/satteri-darwin-arm64": "0.10.5", "@bruits/satteri-darwin-x64": "0.10.5", "@bruits/satteri-linux-arm64-gnu": "0.10.5", "@bruits/satteri-linux-arm64-musl": "0.10.5", "@bruits/satteri-linux-x64-gnu": "0.10.5", "@bruits/satteri-linux-x64-musl": "0.10.5", "@bruits/satteri-wasm32-wasi": "0.10.5", "@bruits/satteri-win32-arm64-msvc": "0.10.5", "@bruits/satteri-win32-x64-msvc": "0.10.5" } }, "sha512-Ao1LKpAEa9Wdg0otgbVKViZHEq9ebdXe4DMrp3s9vQAU0HNIuHnFEuMuOcm0ZIXyV0Yzxj91NvhLpvXZJO/5ZQ=="], + + "sax": ["sax@1.6.1", "", {}, "sha512-42tBVwLWnaQvW5zc4HbZrTuWccECCZfBi92FDuwtqxasH+JbPB3/FOKb1m222K42R4WxuxzzMsTswfzgtSu64Q=="], + + "semver": ["semver@7.8.5", "", { "bin": { "semver": "bin/semver.js" } }, "sha512-Y7/KDsb8LjooZpwaqGyulO6DQlksgCncchHGk+sZIY4SBvUocMBEFH5Ur1fI4dV+Jvl0w6cjvucaIi40puRioA=="], + + "sharp": ["sharp@0.35.4", "", { "dependencies": { "@img/colour": "1.1.0", "detect-libc": "2.1.2", "semver": "7.8.5" }, "optionalDependencies": { "@img/sharp-darwin-arm64": "0.35.4", "@img/sharp-darwin-x64": "0.35.4", "@img/sharp-freebsd-wasm32": "0.35.4", "@img/sharp-libvips-darwin-arm64": "1.3.3", "@img/sharp-libvips-darwin-x64": "1.3.3", "@img/sharp-libvips-linux-arm": "1.3.3", "@img/sharp-libvips-linux-arm64": "1.3.3", "@img/sharp-libvips-linux-ppc64": "1.3.3", "@img/sharp-libvips-linux-riscv64": "1.3.3", "@img/sharp-libvips-linux-s390x": "1.3.3", "@img/sharp-libvips-linux-x64": "1.3.3", "@img/sharp-libvips-linuxmusl-arm64": "1.3.3", "@img/sharp-libvips-linuxmusl-x64": "1.3.3", "@img/sharp-linux-arm": "0.35.4", "@img/sharp-linux-arm64": "0.35.4", "@img/sharp-linux-ppc64": "0.35.4", "@img/sharp-linux-riscv64": "0.35.4", "@img/sharp-linux-s390x": "0.35.4", "@img/sharp-linux-x64": "0.35.4", "@img/sharp-linuxmusl-arm64": "0.35.4", "@img/sharp-linuxmusl-x64": "0.35.4", "@img/sharp-webcontainers-wasm32": "0.35.4", "@img/sharp-win32-arm64": "0.35.4", "@img/sharp-win32-ia32": "0.35.4", "@img/sharp-win32-x64": "0.35.4" } }, "sha512-n++8XWcj+jCOr2IOl7h8LbKnGBDY4aPbmprMONBNFdn0ImXqpGVv5zliDs0V9HbmbCQLpbuo2ej9rAoOQTvMDA=="], + + "shiki": ["shiki@4.4.3", "", { "dependencies": { "@shikijs/core": "4.4.3", "@shikijs/engine-javascript": "4.4.3", "@shikijs/engine-oniguruma": "4.4.3", "@shikijs/langs": "4.4.3", "@shikijs/themes": "4.4.3", "@shikijs/types": "4.4.3", "@shikijs/vscode-textmate": "10.0.2", "@types/hast": "3.0.5" } }, "sha512-Mb/GvXPHBAXdgGIcnfU5L3ldpn1XcxrGkPHwqgRx17/I2XRfqlFKk2vGkHWINn1kdXvzJZeuO3is6I9KLPFm0g=="], + + "sisteransi": ["sisteransi@1.0.5", "", {}, "sha512-bLGGlR1QxBcynn2d5YmDX4MGjlZvy2MRBDRNHLJ8VI6l6+9FUiyTFNJ0IveOSP0bcXgVDPRcfGqA0pjaqUpfVg=="], + + "sitemap": ["sitemap@9.0.1", "", { "dependencies": { "@types/node": "^24.9.2", "@types/sax": "^1.2.1", "arg": "^5.0.0", "sax": "^1.4.1" }, "bin": { "sitemap": "dist/esm/cli.js" } }, "sha512-S6hzjGJSG3d6if0YoF5kTyeRJvia6FSTBroE5fQ0bu1QNxyJqhhinfUsXi9fH3MgtXODWvwo2BDyQSnhPQ88uQ=="], + + "smol-toml": ["smol-toml@1.8.0", "", {}, "sha512-kCZr2V3ch9i00x8zXRhjUNVcjG9ijES5dDudkXvUVCT5QlJNQWElSJdZqyPemffHoLNUYwOcou0Fy+ojN0uHSQ=="], + + "source-map-js": ["source-map-js@1.2.1", "", {}, "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA=="], + + "space-separated-tokens": ["space-separated-tokens@2.0.2", "", {}, "sha512-PEGlAwrG8yXGXRjW32fGbg66JAlOAwbObuqVoJpv/mRgoWDQfgH1wDPvtzWyUSNAXBGSk8h755YDbbcEy3SH2Q=="], + + "string-width": ["string-width@8.2.2", "", { "dependencies": { "get-east-asian-width": "^1.5.0", "strip-ansi": "^7.1.2" } }, "sha512-GaPUh5gfdrYzqeVNZvUfT23vYYxXzKYidUcnMtJg/3rxRV63EFZy3k6xfKlmfeJD0176lnUV/Usr3XcwSvFzpg=="], + + "stringify-entities": ["stringify-entities@4.0.4", "", { "dependencies": { "character-entities-html4": "2.1.0", "character-entities-legacy": "3.0.0" } }, "sha512-IwfBptatlO+QCJUo19AqvrPNqlVMpW9YEL2LIVY+Rpv2qsjCGxaDLNRgeGsQWJhfItebuJhsGSLjaBbNSQ+ieg=="], + + "strip-ansi": ["strip-ansi@7.2.0", "", { "dependencies": { "ansi-regex": "^6.2.2" } }, "sha512-yDPMNjp4WyfYBkHnjIRLfca1i6KMyGCtsVgoKe/z1+6vukgaENdgGBZt+ZmKPc4gavvEZ5OgHfHdrazhgNyG7w=="], + + "supports-color": ["supports-color@7.2.0", "", { "dependencies": { "has-flag": "^4.0.0" } }, "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw=="], + + "svgo": ["svgo@4.1.0", "", { "dependencies": { "commander": "11.1.0", "css-select": "6.0.0", "css-tree": "3.2.1", "css-what": "7.0.0", "csso": "5.0.5", "picocolors": "1.1.1", "sax": "1.6.1" }, "bin": { "svgo": "bin/svgo.js" } }, "sha512-bkxnTg1kSU0guhIBmibA6UUhrQmPVA1XsQLN+ylCd+UWzbnLkySOcXpyk1mrl05f+pcaCx2eHb+sp6BgMZWX+Q=="], + + "tiny-inflate": ["tiny-inflate@1.0.3", "", {}, "sha512-pkY1fj1cKHb2seWDy0B16HeWyczlJA9/WW3u3c4z/NiWDsO3DOU5D7nhTLE9CF0yXv/QZFY7sEJmj24dK+Rrqw=="], + + "tinyclip": ["tinyclip@0.1.15", "", {}, "sha512-uo33abH+Ays0xYaDysoBt494Hb3hsEczMpcC0MwFl773pazORx4fmvKhclhR1wonUbB6vvpRsvVMwnhfqeMc+A=="], + + "tinyexec": ["tinyexec@1.3.1", "", {}, "sha512-GCvB3aoys96IuDFBMcTB46JOR6mdMtAToqwiW8JlWhsoh1mhHi/xn9ss/Dg7N555GiJyEt2qzoG/NHCwM6h1EA=="], + + "tinyglobby": ["tinyglobby@0.2.17", "", { "dependencies": { "fdir": "6.5.0", "picomatch": "4.0.7" } }, "sha512-wXR/dYpcqKmfWpEdZjiKJOwCNFndD0DMnrW/cYjVGttEkBfVgcLFHoNrlj47mjOVic9yyNu65alsgF4NQyTa2g=="], + + "trim-lines": ["trim-lines@3.0.1", "", {}, "sha512-kRj8B+YHZCc9kQYdWfJB2/oUl9rA99qbowYYBtr4ui4mZyAQ2JpvVBd/6U2YloATfqBhBTSMhTpgBHtU0Mf3Rg=="], + + "trough": ["trough@2.2.0", "", {}, "sha512-tmMpK00BjZiUyVyvrBK7knerNgmgvcV/KLVyuma/SC+TQN167GrMRciANTz09+k3zW8L8t60jWO1GpfkZdjTaw=="], + + "tslib": ["tslib@2.8.1", "", {}, "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w=="], + + "typesafe-path": ["typesafe-path@0.2.2", "", {}, "sha512-OJabfkAg1WLZSqJAJ0Z6Sdt3utnbzr/jh+NAHoyWHJe8CMSy79Gm085094M9nvTPy22KzTVn5Zq5mbapCI/hPA=="], + + "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="], + + "typescript-auto-import-cache": ["typescript-auto-import-cache@0.3.6", "", { "dependencies": { "semver": "^7.3.8" } }, "sha512-RpuHXrknHdVdK7wv/8ug3Fr0WNsNi5l5aB8MYYuXhq2UH5lnEB1htJ1smhtD5VeCsGr2p8mUDtd83LCQDFVgjQ=="], + + "ufo": ["ufo@1.6.4", "", {}, "sha512-JFNbkD1Svwe0KvGi8GOeLcP4kAWQ609twvCdcHxq1oSL8svv39ZuSvajcD8B+5D0eL4+s1Is2D/O6KN3qcTeRA=="], + + "ultrahtml": ["ultrahtml@1.7.0", "", {}, "sha512-2xRd0VHoAQE4M+vF/DvFFB7pUV0ZxTW1TLi7lHQWnF/Sb5TPeEUV/l+hxcNnGO00ZXGnR0voCMmYRKQf+rvJ2g=="], + + "uncrypto": ["uncrypto@0.1.3", "", {}, "sha512-Ql87qFHB3s/De2ClA9e0gsnS6zXG27SkTiSJwjCc9MebbfapQfuPzumMIUMi38ezPZVNFcHI9sUIepeQfw8J8Q=="], + + "undici": ["undici@8.10.2", "", {}, "sha512-/y4/bH9YNU5hi9NIrpOuvGXFcxrj3CMrV+/AYpowAYTpHn8gX/XPFjNy766FPoYY0miQhdW977JFWKGNhBdwyQ=="], + + "undici-types": ["undici-types@7.18.2", "", {}, "sha512-AsuCzffGHJybSaRrmr5eHr81mwJU3kjw6M+uprWvCXiNeN9SOGwQ3Jn8jb8m3Z6izVgknn1R0FTCEAP2QrLY/w=="], + + "unified": ["unified@11.0.5", "", { "dependencies": { "@types/unist": "3.0.3", "bail": "2.0.2", "devlop": "1.1.0", "extend": "3.0.2", "is-plain-obj": "4.1.0", "trough": "2.2.0", "vfile": "6.0.3" } }, "sha512-xKvGhPWw3k84Qjh8bI3ZeJjqnyadK+GEFtazSfZv/rKeTkTjOJho6mFqh2SM96iIcZokxiOpg78GazTSg8+KHA=="], + + "unifont": ["unifont@0.7.5", "", { "dependencies": { "css-tree": "3.2.1", "ohash": "2.0.12", "undici": "8.10.2" } }, "sha512-ULe/Cs+ZIsq+dcFofNkhqielCrUJnb5mr+Yc4EBM2VlL+6OZR6+cjtI2mT1bJvRBrVncqHAbLURxmPLcCXzWMg=="], + + "unist-util-find-after": ["unist-util-find-after@5.0.0", "", { "dependencies": { "@types/unist": "^3.0.0", "unist-util-is": "^6.0.0" } }, "sha512-amQa0Ep2m6hE2g72AugUItjbuM8X8cGQnFoHk0pGfrFeT9GZhzN5SW8nRsiGKK7Aif4CrACPENkA6P/Lw6fHGQ=="], + + "unist-util-is": ["unist-util-is@6.0.1", "", { "dependencies": { "@types/unist": "3.0.3" } }, "sha512-LsiILbtBETkDz8I9p1dQ0uyRUWuaQzd/cuEeS1hoRSyW5E5XGmTzlwY1OrNzzakGowI9Dr/I8HVaw4hTtnxy8g=="], + + "unist-util-position": ["unist-util-position@5.0.0", "", { "dependencies": { "@types/unist": "3.0.3" } }, "sha512-fucsC7HjXvkB5R3kTCO7kUjRdrS0BJt3M/FPxmHMBOm8JQi2BsHAHFsy27E0EolP8rp0NzXsJ+jNPyDWvOJZPA=="], + + "unist-util-stringify-position": ["unist-util-stringify-position@4.0.0", "", { "dependencies": { "@types/unist": "3.0.3" } }, "sha512-0ASV06AAoKCDkS2+xw5RXJywruurpbC4JZSm7nr7MOt1ojAzvyyaO+UxZf18j8FCF6kmzCZKcAgN/yu2gm2XgQ=="], + + "unist-util-visit": ["unist-util-visit@5.1.0", "", { "dependencies": { "@types/unist": "3.0.3", "unist-util-is": "6.0.1", "unist-util-visit-parents": "6.0.2" } }, "sha512-m+vIdyeCOpdr/QeQCu2EzxX/ohgS8KbnPDgFni4dQsfSCtpz8UqDyY5GjRru8PDKuYn7Fq19j1CQ+nJSsGKOzg=="], + + "unist-util-visit-parents": ["unist-util-visit-parents@6.0.2", "", { "dependencies": { "@types/unist": "3.0.3", "unist-util-is": "6.0.1" } }, "sha512-goh1s1TBrqSqukSc8wrjwWhL0hiJxgA8m4kFxGlQ+8FYQ3C/m11FcTs4YYem7V664AhHVvgoQLk890Ssdsr2IQ=="], + + "unstorage": ["unstorage@1.17.5", "", { "dependencies": { "anymatch": "3.1.3", "chokidar": "5.0.0", "destr": "2.0.5", "h3": "1.15.11", "lru-cache": "11.5.2", "node-fetch-native": "1.6.7", "ofetch": "1.5.1", "ufo": "1.6.4" } }, "sha512-0i3iqvRfx29hkNntHyQvJTpf5W9dQ9ZadSoRU8+xVlhVtT7jAX57fazYO9EHvcRCfBCyi5YRya7XCDOsbTgkPg=="], + + "url-extras": ["url-extras@0.1.0", "", {}, "sha512-8tzwTeXFPuX/5PHuCDQE5Dd9Ts4rwoq2t9aIT+HS4iAVpmj5l4Ao7Q+BuuFjvWRqrLswBhQDk8O96ZicgCqQqw=="], + + "util-deprecate": ["util-deprecate@1.0.2", "", {}, "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw=="], + + "vfile": ["vfile@6.0.3", "", { "dependencies": { "@types/unist": "3.0.3", "vfile-message": "4.0.3" } }, "sha512-KzIbH/9tXat2u30jf+smMwFCsno4wHVdNmzFyL+T/L3UGqqk6JKfVqOFOZEpZSHADH1k40ab6NUIXZq422ov3Q=="], + + "vfile-message": ["vfile-message@4.0.3", "", { "dependencies": { "@types/unist": "3.0.3", "unist-util-stringify-position": "4.0.0" } }, "sha512-QTHzsGd1EhbZs4AsQ20JX1rC3cOlt/IWJruk893DfLRr57lcnOeMaWG4K0JrRta4mIJZKth2Au3mM3u03/JWKw=="], + + "vite": ["vite@8.3.0", "", { "dependencies": { "lightningcss": "1.33.0", "picomatch": "4.0.7", "postcss": "8.5.28", "rolldown": "1.2.8", "tinyglobby": "0.2.17" }, "optionalDependencies": { "esbuild": "0.28.2", "fsevents": "2.3.3" }, "bin": { "vite": "bin/vite.js" } }, "sha512-lhZBVvEHefgE+HQZC9O7EBJgCU/nVzFNl7vkS4RE0APtWLP02/8QVIkQtzBxPquh7lq5/78NHipTj7ODQ6XuyQ=="], + + "vitefu": ["vitefu@1.1.3", "", { "optionalDependencies": { "vite": "8.3.0" } }, "sha512-ub4okH7Z5KLjb6hDyjqrGXqWtWvoYdU3IGm/NorpgHncKoLTCfRIbvlhBm7r0YstIaQRYlp4yEbFqDcKSzXSSg=="], + + "volar-service-css": ["volar-service-css@0.0.71", "", { "dependencies": { "vscode-css-languageservice": "^6.3.0", "vscode-languageserver-textdocument": "^1.0.11", "vscode-uri": "^3.0.8" }, "peerDependencies": { "@volar/language-service": "~2.4.0" }, "optionalPeers": ["@volar/language-service"] }, "sha512-wRRFt9BpjMKCazcgOh67MSjUjiWUCAh99DyYSDIOTuxaRjEtDC7PpB0k1Y1wbJIW/pVtMUSVbpPo3UGSm0Byxw=="], + + "volar-service-emmet": ["volar-service-emmet@0.0.71", "", { "dependencies": { "@emmetio/css-parser": "^0.4.1", "@emmetio/html-matcher": "^1.3.0", "@vscode/emmet-helper": "^2.9.3", "vscode-uri": "^3.0.8" }, "peerDependencies": { "@volar/language-service": "~2.4.0" }, "optionalPeers": ["@volar/language-service"] }, "sha512-zqjzt6bN95e3CUstBm0PBFAJnrfz0ZAARka87fart46/gNCLLuP3Vujy8V/J8HEziTFLnfkgIASLFYPUhonJcA=="], + + "volar-service-html": ["volar-service-html@0.0.71", "", { "dependencies": { "vscode-html-languageservice": "^5.3.0", "vscode-languageserver-textdocument": "^1.0.11", "vscode-uri": "^3.0.8" }, "peerDependencies": { "@volar/language-service": "~2.4.0" }, "optionalPeers": ["@volar/language-service"] }, "sha512-e8tHPhgQ7ooLfudAEIku+kgd9pWkq3SSz8RbnQDI1+Eb8wbenkLGHqoirLqz5ORLV6wIMr2Iv08RWBG5eOcgpw=="], + + "volar-service-prettier": ["volar-service-prettier@0.0.71", "", { "dependencies": { "vscode-uri": "^3.0.8" }, "peerDependencies": { "@volar/language-service": "~2.4.0", "prettier": "^2.2 || ^3.0" }, "optionalPeers": ["@volar/language-service", "prettier"] }, "sha512-Rz7JVH3qD108UCdmIEiZvOBNljMt2nLFdbN8AXcDfn7xD9F5I2aCIsDVqBbXw21PsnxG0b7MfwtNF+zPS/NKUg=="], + + "volar-service-typescript": ["volar-service-typescript@0.0.71", "", { "dependencies": { "path-browserify": "^1.0.1", "semver": "^7.6.2", "typescript-auto-import-cache": "^0.3.5", "vscode-languageserver-textdocument": "^1.0.11", "vscode-nls": "^5.2.0", "vscode-uri": "^3.0.8" }, "peerDependencies": { "@volar/language-service": "~2.4.0" }, "optionalPeers": ["@volar/language-service"] }, "sha512-yTtM/BVT6hoyEYnDtaCyAtNhdNeS/mhTTABlBOdw3NNiRBUin3IznFJpgfjer4c6RYopiPjjQjc9VFhxVl1mLw=="], + + "volar-service-typescript-twoslash-queries": ["volar-service-typescript-twoslash-queries@0.0.71", "", { "dependencies": { "vscode-uri": "^3.0.8" }, "peerDependencies": { "@volar/language-service": "~2.4.0" }, "optionalPeers": ["@volar/language-service"] }, "sha512-9K2k72s4n7rV9s4bX0MyjbX9iBribvKZbBJKuEmTCZfeWJXs6Yh7bGpY4eoc7UufAjvpheBqwyZCOIPBvxCv0A=="], + + "volar-service-yaml": ["volar-service-yaml@0.0.71", "", { "dependencies": { "vscode-uri": "^3.0.8", "yaml-language-server": "~1.23.0" }, "peerDependencies": { "@volar/language-service": "~2.4.0" }, "optionalPeers": ["@volar/language-service"] }, "sha512-qYGWGuVpUTnZGu5P/CR4KLK4aIR8RrcVnmfZ2eRcj9q/I8VZCoC5yy9FtEvfNvnDp4MU17yhdJcvpQPIqhJS2Q=="], + + "vscode-css-languageservice": ["vscode-css-languageservice@6.3.10", "", { "dependencies": { "@vscode/l10n": "^0.0.18", "vscode-languageserver-textdocument": "^1.0.12", "vscode-languageserver-types": "3.17.5", "vscode-uri": "^3.1.0" } }, "sha512-eq5N9Er3fC4vA9zd9EFhyBG90wtCCuXgRSpAndaOgXMh1Wgep5lBgRIeDgjZBW9pa+332yC9+49cZMW8jcL3MA=="], + + "vscode-html-languageservice": ["vscode-html-languageservice@5.6.2", "", { "dependencies": { "@vscode/l10n": "^0.0.18", "vscode-languageserver-textdocument": "^1.0.12", "vscode-languageserver-types": "^3.17.5", "vscode-uri": "^3.1.0" } }, "sha512-ulCrSnFnfQ16YzvwnYUgEbUEl/ZG7u2eV27YhvLObSHKkb8fw1Z9cgsnUwjTEeDIdJDoTDTDpxuhQwoenoLNMg=="], + + "vscode-json-languageservice": ["vscode-json-languageservice@4.1.8", "", { "dependencies": { "jsonc-parser": "^3.0.0", "vscode-languageserver-textdocument": "^1.0.1", "vscode-languageserver-types": "^3.16.0", "vscode-nls": "^5.0.0", "vscode-uri": "^3.0.2" } }, "sha512-0vSpg6Xd9hfV+eZAaYN63xVVMOTmJ4GgHxXnkLCh+9RsQBkWKIghzLhW2B9ebfG+LQQg8uLtsQ2aUKjTgE+QOg=="], + + "vscode-jsonrpc": ["vscode-jsonrpc@8.2.0", "", {}, "sha512-C+r0eKJUIfiDIfwJhria30+TYWPtuHJXHtI7J0YlOmKAo7ogxP20T0zxB7HZQIFhIyvoBPwWskjxrvAtfjyZfA=="], + + "vscode-languageserver": ["vscode-languageserver@9.0.1", "", { "dependencies": { "vscode-languageserver-protocol": "3.17.5" }, "bin": { "installServerIntoExtension": "bin/installServerIntoExtension" } }, "sha512-woByF3PDpkHFUreUa7Hos7+pUWdeWMXRd26+ZX2A8cFx6v/JPTtd4/uN0/jB6XQHYaOlHbio03NTHCqrgG5n7g=="], + + "vscode-languageserver-protocol": ["vscode-languageserver-protocol@3.17.5", "", { "dependencies": { "vscode-jsonrpc": "8.2.0", "vscode-languageserver-types": "3.17.5" } }, "sha512-mb1bvRJN8SVznADSGWM9u/b07H7Ecg0I3OgXDuLdn307rl/J3A9YD6/eYOssqhecL27hK1IPZAsaqh00i/Jljg=="], + + "vscode-languageserver-textdocument": ["vscode-languageserver-textdocument@1.0.14", "", {}, "sha512-EQyqJMi552E4ZTf46izQ4Fj6XquqxCySR3J5ZSD1SisMf6RfpeOWHxGBE8Gr6V0/3GHIGdAzDn8F8+1nTGCnoQ=="], + + "vscode-languageserver-types": ["vscode-languageserver-types@3.18.3", "", {}, "sha512-XIlzJ7Qp/jzSI1ds7/FwPAWrPeTZA7pAtlW4hdJ1J6xXWJL6dR9QYnDhJOdLzdKhUQ5Mm6mvUMw+3DcOQQasPw=="], + + "vscode-nls": ["vscode-nls@5.2.0", "", {}, "sha512-RAaHx7B14ZU04EU31pT+rKz2/zSl7xMsfIZuo8pd+KZO6PXtQmpevpq3vxvWNcrGbdmhM/rr5Uw5Mz+NBfhVng=="], + + "vscode-uri": ["vscode-uri@3.2.0", "", {}, "sha512-m2gXo3bn0G1kT9InzMf07fTbqMbGtyckj3bH5ktLO+1Ssv+yiATZ4dhwaQv9UZWxJh6E9IFGnQyjgWVDWVBDrg=="], + + "wrap-ansi": ["wrap-ansi@9.0.2", "", { "dependencies": { "ansi-styles": "^6.2.1", "string-width": "^7.0.0", "strip-ansi": "^7.1.0" } }, "sha512-42AtmgqjV+X1VpdOfyTGOYRi0/zsoLqtXQckTmqTeybT+BDIbM/Guxo7x3pE2vtpr1ok6xRqM9OpBe+Jyoqyww=="], + + "xxhash-wasm": ["xxhash-wasm@1.1.0", "", {}, "sha512-147y/6YNh+tlp6nd/2pWq38i9h6mz/EuQ6njIrmW8D1BS5nCqs0P6DG+m6zTGnNz5I+uhZ0SHxBs9BsPrwcKDA=="], + + "y18n": ["y18n@5.0.8", "", {}, "sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA=="], + + "yaml": ["yaml@2.9.1", "", { "bin": { "yaml": "bin.mjs" } }, "sha512-3NxN8+78OdzbT7C/WjGsyfPAtJaN3FNDsWxv7Y7mcDsT/oOmgW8BpyQQFFBnvZE3j9Y2Sdz1ULFLezL7Eb2yFw=="], + + "yaml-language-server": ["yaml-language-server@1.23.0", "", { "dependencies": { "@vscode/l10n": "^0.0.18", "ajv": "^8.17.1", "ajv-draft-04": "^1.0.0", "ajv-i18n": "^4.2.0", "prettier": "^3.8.1", "request-light": "^0.5.7", "vscode-json-languageservice": "4.1.8", "vscode-languageserver": "^9.0.0", "vscode-languageserver-textdocument": "^1.0.1", "vscode-languageserver-types": "^3.16.0", "vscode-uri": "^3.0.2", "yaml": "2.8.3" }, "bin": { "yaml-language-server": "bin/yaml-language-server" } }, "sha512-3qVyCOexLCWw06PQa5kRPwvMWMZ/eZeCRWUvgD6a0OkqL/4iCnxy2WumbWifa937Uo5xhyWJ0uxlU39ljhNh7A=="], + + "yargs": ["yargs@18.1.0", "", { "dependencies": { "cliui": "^9.0.1", "escalade": "^3.1.1", "get-caller-file": "^2.0.5", "string-width": "^8.2.1", "y18n": "^5.0.5", "yargs-parser": "^22.0.0" } }, "sha512-2rAgRKu54VsHkqI0/tYkmluGXHD4KW7yZoycuqDQ15QOTnc2VVfy0nN/1eMhnQLO00A+dwtK20xuCnc1YGeUyg=="], + + "yargs-parser": ["yargs-parser@22.0.0", "", {}, "sha512-rwu/ClNdSMpkSrUb+d6BRsSkLUq1fmfsY6TOpYzTwvwkg1/NRG85KBy3kq++A8LKQwX6lsu+aWad+2khvuXrqw=="], + + "yocto-queue": ["yocto-queue@1.2.2", "", {}, "sha512-4LCcse/U2MHZ63HAJVE+v71o7yOdIe4cZ70Wpf8D/IyjDKYQLV5GD46B+hSTjJsvV5PztjvHoU580EftxjDZFQ=="], + + "zod": ["zod@4.6.5", "", {}, "sha512-v5l/aFXZQeai4awLbOpSoHecE9UiMrnfx75tEXLjNonXVARxQ5mOeipTjROUchszUNCqnE+hqAMujRsRHsut2Q=="], + + "zwitch": ["zwitch@2.0.4", "", {}, "sha512-bXE4cR/kVZhKZX/RjPEflHaKVhUVl85noU3v6b8apfQEc1x4A+zBxjZ4lN8LqGd6WZ3dl98pY4o717VFmoPp+A=="], + + "@img/sharp-wasm32/@emnapi/runtime": ["@emnapi/runtime@1.11.3", "", { "dependencies": { "tslib": "2.8.1" } }, "sha512-Xz4Tpyki7XyrpbUK1jR1AhdAdaXyhhY4lZ3neLodmhpuWfy2PAQN5B46sAiU4liOXGLkHypn/qU+jvfWSCYYLA=="], + + "@vscode/emmet-helper/jsonc-parser": ["jsonc-parser@2.3.1", "", {}, "sha512-H8jvkz1O50L3dMZCsLqiuB2tA7muqbSg1AtGEkN0leAqGjsUzDJir3Zwr02BhqdcITPg3ei3mZ+HjMocAknhhg=="], + + "anymatch/picomatch": ["picomatch@2.3.2", "", {}, "sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA=="], + + "cliui/string-width": ["string-width@7.2.0", "", { "dependencies": { "emoji-regex": "^10.3.0", "get-east-asian-width": "^1.0.0", "strip-ansi": "^7.1.0" } }, "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ=="], + + "csso/css-tree": ["css-tree@2.2.1", "", { "dependencies": { "mdn-data": "2.0.28", "source-map-js": "1.2.1" } }, "sha512-OA0mILzGc1kCOCSJerOeqDxDQ4HOh+G8NbOJFOTgOCzpw7fCBubk0fEyxp8AgOL/jvLgYA/uV0cMbe43ElF1JA=="], + + "parse-entities/@types/unist": ["@types/unist@2.0.11", "", {}, "sha512-CmBKiL6NNo/OqgmMn95Fk9Whlp2mtvIv+KNpQKN2F4SjvrEesubTRWGYSg+BnWZOnlCaSTU1sMpsBOzgbYhnsA=="], + + "unstorage/chokidar": ["chokidar@5.0.0", "", { "dependencies": { "readdirp": "5.1.1" } }, "sha512-TQMmc3w+5AxjpL8iIiwebF73dRDF4fBIieAqGn9RGCWaEVwQ6Fb2cGe31Yns0RRIzii5goJ1Y7xbMwo1TxMplw=="], + + "vscode-css-languageservice/vscode-languageserver-types": ["vscode-languageserver-types@3.17.5", "", {}, "sha512-Ld1VelNuX9pdF39h2Hgaeb5hEZM2Z3jUrrMgWQAu82jMtZp7p3vJT3BzToKtZI7NgQssZje5o0zryOrhQvzQAg=="], + + "vscode-languageserver-protocol/vscode-languageserver-types": ["vscode-languageserver-types@3.17.5", "", {}, "sha512-Ld1VelNuX9pdF39h2Hgaeb5hEZM2Z3jUrrMgWQAu82jMtZp7p3vJT3BzToKtZI7NgQssZje5o0zryOrhQvzQAg=="], + + "wrap-ansi/string-width": ["string-width@7.2.0", "", { "dependencies": { "emoji-regex": "^10.3.0", "get-east-asian-width": "^1.0.0", "strip-ansi": "^7.1.0" } }, "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ=="], + + "yaml-language-server/request-light": ["request-light@0.5.8", "", {}, "sha512-3Zjgh+8b5fhRJBQZoy+zbVKpAQGLyka0MPgW3zruTF4dFFJ8Fqcfu9YsAvi/rvdcaTeWG3MkbZv4WKxAn/84Lg=="], + + "yaml-language-server/yaml": ["yaml@2.8.3", "", { "bin": { "yaml": "bin.mjs" } }, "sha512-AvbaCLOO2Otw/lW5bmh9d/WEdcDFdQp2Z2ZUH3pX9U2ihyUY0nvLv7J6TrWowklRGPYbB/IuIMfYgxaCPg5Bpg=="], + + "csso/css-tree/mdn-data": ["mdn-data@2.0.28", "", {}, "sha512-aylIc7Z9y4yzHYAJNuESG3hfhC+0Ibp/MAMiaOZgNv4pmEdFyfZhhhny4MNiAfWdBQ1RQ2mfDWmM1x8SvGyp8g=="], + + "unstorage/chokidar/readdirp": ["readdirp@5.1.1", "", {}, "sha512-Kko+Y5XQ6fM+Ce3dq3m9YGxnacYZYl9cA1wZjaF3Vbry2L3i1qVg8+CAgNPsXRArPMUMCaOR7oa9Nqntc43JKA=="], + } +} diff --git a/docs/examples/area.blade.php b/docs/examples/area.blade.php new file mode 100644 index 0000000..d28719b --- /dev/null +++ b/docs/examples/area.blade.php @@ -0,0 +1,18 @@ + diff --git a/docs/examples/bar.blade.php b/docs/examples/bar.blade.php new file mode 100644 index 0000000..fe84f1d --- /dev/null +++ b/docs/examples/bar.blade.php @@ -0,0 +1,19 @@ + diff --git a/docs/examples/candlestick.blade.php b/docs/examples/candlestick.blade.php new file mode 100644 index 0000000..14c82aa --- /dev/null +++ b/docs/examples/candlestick.blade.php @@ -0,0 +1,23 @@ + diff --git a/docs/examples/contribution-heatmap.blade.php b/docs/examples/contribution-heatmap.blade.php new file mode 100644 index 0000000..9dc2f70 --- /dev/null +++ b/docs/examples/contribution-heatmap.blade.php @@ -0,0 +1,15 @@ + diff --git a/docs/examples/donut.blade.php b/docs/examples/donut.blade.php new file mode 100644 index 0000000..2c8bc0d --- /dev/null +++ b/docs/examples/donut.blade.php @@ -0,0 +1,9 @@ + diff --git a/docs/examples/fixtures.php b/docs/examples/fixtures.php new file mode 100644 index 0000000..d0ea6a4 --- /dev/null +++ b/docs/examples/fixtures.php @@ -0,0 +1,124 @@ + 'revenue', + 'name' => 'Revenue', + 'color' => '#ED3F16', + 'points' => [ + ['id' => 'jan', 'label' => 'January', 'value' => 18], + ['id' => 'feb', 'label' => 'February', 'value' => 26], + ['id' => 'mar', 'label' => 'March', 'value' => 31], + ], +]]; + +$segments = [ + ['id' => 'web', 'label' => 'Web', 'value' => 68, 'color' => '#ED3F16'], + ['id' => 'store', 'label' => 'Store', 'value' => 32, 'color' => '#2563EB'], +]; + +return [ + 'line' => [ + 'element' => LineChart::class, + 'attributes' => ['series' => $cartesianSeries, 'theme' => 'system', 'preset' => 'default', 'error-label' => 'Revenue chart unavailable', 'a11y-label' => 'Revenue by month'], + ], + 'area' => [ + 'element' => AreaChart::class, + 'attributes' => ['series' => $cartesianSeries, 'area-mode' => 'stacked', 'style' => ['area' => ['opacity' => 0.35]], 'a11y-label' => 'Revenue magnitude by month'], + ], + 'bar' => [ + 'element' => BarChart::class, + 'attributes' => ['series' => $cartesianSeries, 'mode' => 'grouped', 'orientation' => 'vertical', 'style' => ['bar' => ['radius' => 6, 'width' => 18]], 'a11y-label' => 'Revenue by month'], + ], + 'scatter' => [ + 'element' => ScatterChart::class, + 'attributes' => ['series' => [[ + 'id' => 'observed', 'name' => 'Observed', 'color' => '#ED3F16', + 'points' => [ + ['id' => 'one', 'label' => 'One', 'x' => 1, 'value' => 8], + ['id' => 'two', 'label' => 'Two', 'x' => 2, 'value' => 13], + ], + ]], 'x-axis' => ['type' => 'number'], 'style' => ['points' => ['size' => 7]], 'a11y-label' => 'Response time compared with request volume'], + ], + 'pie' => [ + 'element' => PieChart::class, + 'attributes' => ['segments' => $segments, 'style' => ['segment' => ['gap' => 2, 'cornerRadius' => 4]], 'a11y-label' => 'Revenue share by channel'], + ], + 'donut' => [ + 'element' => DonutChart::class, + 'attributes' => ['segments' => $segments, 'inner-radius-ratio' => 0.62, 'a11y-label' => 'Spending by category'], + ], + 'radar' => [ + 'element' => RadarChart::class, + 'attributes' => [ + 'axes' => [ + ['id' => 'speed', 'label' => 'Speed', 'maximum' => 100], + ['id' => 'quality', 'label' => 'Quality', 'maximum' => 10], + ['id' => 'cost', 'label' => 'Cost', 'maximum' => 500], + ], + 'series' => [[ + 'id' => 'nativephp', 'name' => 'NativePHP', 'color' => '#ED3F16', + 'values' => [ + ['axis' => 'speed', 'value' => 88], + ['axis' => 'quality', 'value' => 9], + ['axis' => 'cost', 'value' => 220], + ], + ]], + 'grid-levels' => 4, + 'fill-opacity' => 0.3, + 'a11y-label' => 'Platform capability profile', + ], + ], + 'candlestick' => [ + 'element' => CandlestickChart::class, + 'attributes' => [ + 'x-axis' => ['type' => 'date'], + 'series' => [[ + 'id' => 'nio-usd', 'name' => 'NIO/USD', 'color' => '#2563EB', + 'points' => [[ + 'id' => '2026-09-16', 'label' => '16 Sep', 'x' => '2026-09-16', + 'open' => 36.72, 'high' => 36.91, 'low' => 36.68, 'close' => 36.84, + ]], + ]], + 'a11y-label' => 'Daily NIO to USD price range', + ], + ], + 'progress' => [ + 'element' => ProgressChart::class, + 'attributes' => [ + 'metrics' => [ + ['id' => 'build', 'label' => 'Build', 'value' => 0.92, 'color' => '#ED3F16'], + ['id' => 'tests', 'label' => 'Tests', 'value' => 0.78, 'color' => '#2563EB'], + ], + 'center-label' => 'Release readiness', + 'a11y-label' => 'Release readiness by gate', + ], + ], + 'contribution_heatmap' => [ + 'element' => ContributionHeatmap::class, + 'attributes' => [ + 'values' => [ + ['id' => '2026-09-15', 'date' => '2026-09-15', 'value' => 8, 'label' => 'Eight contributions'], + ['id' => '2026-09-16', 'date' => '2026-09-16', 'value' => 12, 'label' => 'Twelve contributions'], + ], + 'end-date' => '2026-09-16', + 'days' => 180, + 'week-starts-on' => 1, + 'colors' => ['#FFD0BE', '#FF8A5C', '#ED3F16', '#8F2108'], + 'empty-color' => '#ECEAE7', + 'show-month-labels' => true, + 'show-weekday-labels' => true, + 'a11y-label' => 'Daily contributions for the last 180 days', + ], + ], +]; diff --git a/docs/examples/line.blade.php b/docs/examples/line.blade.php new file mode 100644 index 0000000..0682e9e --- /dev/null +++ b/docs/examples/line.blade.php @@ -0,0 +1,19 @@ + diff --git a/docs/examples/pie.blade.php b/docs/examples/pie.blade.php new file mode 100644 index 0000000..9e8b92f --- /dev/null +++ b/docs/examples/pie.blade.php @@ -0,0 +1,9 @@ + diff --git a/docs/examples/progress.blade.php b/docs/examples/progress.blade.php new file mode 100644 index 0000000..cda9b55 --- /dev/null +++ b/docs/examples/progress.blade.php @@ -0,0 +1,9 @@ + diff --git a/docs/examples/radar.blade.php b/docs/examples/radar.blade.php new file mode 100644 index 0000000..067e3db --- /dev/null +++ b/docs/examples/radar.blade.php @@ -0,0 +1,23 @@ + diff --git a/docs/examples/scatter.blade.php b/docs/examples/scatter.blade.php new file mode 100644 index 0000000..60b6731 --- /dev/null +++ b/docs/examples/scatter.blade.php @@ -0,0 +1,17 @@ + diff --git a/docs/googlee7f2b3e372cd2895.html b/docs/googlee7f2b3e372cd2895.html deleted file mode 100644 index 664e592..0000000 --- a/docs/googlee7f2b3e372cd2895.html +++ /dev/null @@ -1 +0,0 @@ -google-site-verification: googlee7f2b3e372cd2895.html \ No newline at end of file diff --git a/docs/guides/cartesian-charts/index.html b/docs/guides/cartesian-charts/index.html deleted file mode 100644 index 009ac05..0000000 --- a/docs/guides/cartesian-charts/index.html +++ /dev/null @@ -1,90 +0,0 @@ - - - - - - - Native Line, Area, Bar, and Scatter Charts for NativePHP - - - - - - - - - - - - - - - - -
-
-
-

Cartesian charts for NativePHP

-

Compare change, volume, and observations natively.

-

Line, area, bar, and scatter charts share an ordered series contract, localized axes, native - selection, and one Blade API across iOS and Android.

-
-
-
-
-
-

Choose the chart that answers the question

-
    -
  • Line: change over an ordered sequence.
  • -
  • Area: cumulative or layered magnitude with overlay or stacked fills.
  • -
  • Bar: grouped comparisons across categories.
  • -
  • Scatter: independent observations with numeric, date, or datetime spacing. -
  • -
-

Start with a typed series

-
<native:bar-chart
-    class="w-full h-72"
-    :series="$revenueSeries"
-    :legend="['visible' => true, 'position' => 'top']"
-    :x-axis="['type' => 'category']"
-    :y-axis="['valueFormat' => 'currency', 'currencyCode' => 'USD']"
-    _select="pointSelected"
-    a11y-label="Revenue by channel"
-/>
-

Make selection stable

-

Give series and points stable IDs before enabling callbacks or frequently inserting and - reordering data. Native selection and tooltip updates happen on-device; the PHP callback - receives a versioned selection payload.

-

Format for people, not renderers

-

Use the locale, x-axis, y-axis, legend, and style contracts instead of Swift or Compose-specific - properties. The same semantic input produces native platform output.

-
- -
-
-
- - - - - \ No newline at end of file diff --git a/docs/guides/installation/index.html b/docs/guides/installation/index.html deleted file mode 100644 index 2bae3c5..0000000 --- a/docs/guides/installation/index.html +++ /dev/null @@ -1,98 +0,0 @@ - - - - - - - Install NativePHP Charts and Render Your First Native Chart - - - - - - - - - - - - - - - - - -
-
-
-

NativePHP Charts installation

-

Your first native chart from PHP.

-

Install the plugin in a NativePHP Mobile app, register its native renderers, and render an accessible chart - directly from an EDGE Blade view.

-
-
-
-
-
-

Install and register the plugin

-

NativePHP Charts is a compiled native UI plugin. Install it with Composer, publish the provider, register - the plugin, and validate its manifest before rebuilding your selected target.

-
-
Terminal
-
composer require donmanueldev/nativephp-charts:^1.0
-php artisan vendor:publish --tag=nativephp-plugins-provider --no-interaction
-php artisan native:plugin:register donmanueldev/nativephp-charts --no-interaction
-php artisan native:plugin:list
-php artisan native:plugin:validate
-
-

Render a first chart

-

Charts are leaf elements. Place one in a NativeComponent EDGE view, give it an explicit height, and - describe its purpose for VoiceOver and TalkBack.

-
<native:line-chart
-    class="w-full h-80"
-    :series="[[
-        'id' => 'monthly-sales',
-        'name' => 'Sales',
-        'color' => '#0F766E',
-        'points' => [
-            ['id' => 'jan', 'label' => 'Jan', 'value' => 42000],
-            ['id' => 'feb', 'label' => 'Feb', 'value' => 51800],
-        ],
-    ]]"
-    a11y-label="Monthly sales"
-/>
-

Rebuild the selected native target

-

The Swift and Kotlin renderers compile into your app. After installation or an update, rebuild the platform - you are developing for. The package supports NativePHP Mobile 4.x, PHP 8.4+, iOS 18.2+, and Android API 26+. -

-
- -
-
-
- - - - - \ No newline at end of file diff --git a/docs/guides/radar-candlestick/index.html b/docs/guides/radar-candlestick/index.html deleted file mode 100644 index 8b267ec..0000000 --- a/docs/guides/radar-candlestick/index.html +++ /dev/null @@ -1,95 +0,0 @@ - - - - - - - Native Radar and Candlestick Charts for NativePHP - - - - - - - - - - - - - - - - -
-
-
-

Radar and candlestick charts for NativePHP

-

Native contracts for capability and OHLC data.

-

NativePHP Charts exposes dedicated radar and candlestick Blade components. Use their distinct data - contracts rather than adapting a Cartesian series into a misleading visualization.

-
-
-
-
-
-

Candlestick charts use OHLC points

-

A candlestick series represents ordered open, high, low, and close values. Provide an explicit - date x-axis and stable point IDs when selection matters.

-
<native:candlestick-chart
-    class="w-full h-80"
-    :series="[[
-        'id' => 'nio-usd', 'name' => 'NIO/USD', 'color' => '#2563EB',
-        'points' => [[
-            'id' => '2026-08-29', 'x' => '2026-08-29', 'label' => '29 Aug',
-            'open' => 36.72, 'high' => 36.91, 'low' => 36.68, 'close' => 36.84,
-        ]],
-    ]]"
-    :x-axis="['type' => 'date']"
-    a11y-label="Daily NIO to USD exchange rate"
-/>
-

Radar charts use named axes

-

Define ordered axes with meaningful maximums, then supply values by axis ID. Radar is for - comparing a shared capability profile, not for time-series data.

-
<native:radar-chart
-    class="w-full h-80"
-    :axes="[['id' => 'speed', 'label' => 'Speed', 'maximum' => 100]]"
-    :series="[['id' => 'nativephp', 'name' => 'NativePHP', 'color' => '#6366F1',
-        'values' => [['axis' => 'speed', 'value' => 88]]]]"
-    :grid-levels="4"
-    a11y-label="NativePHP capability profile"
-/>
-

Validate on your target devices

-

These are documented native components. Validate visual geometry, interaction, text scaling, and - assistive technology on the devices relevant to your release before making performance or - accessibility claims.

-
- -
-
-
- - - - - \ No newline at end of file diff --git a/docs/guides/radial-charts/index.html b/docs/guides/radial-charts/index.html deleted file mode 100644 index 1fad6ad..0000000 --- a/docs/guides/radial-charts/index.html +++ /dev/null @@ -1,87 +0,0 @@ - - - - - - - Native Pie and Donut Charts for NativePHP Mobile - - - - - - - - - - - - - - - - -
-
-
-

Pie and donut charts for NativePHP

-

Make composition visible in native mobile UI.

-

Pie and donut charts render ordered segments directly on iOS and Android. Use them when the - relationship between parts and their whole is the story.

-
-
-
-
-
-

Use ordered, meaningful segments

-

Every segment has a stable ID, label, non-negative finite value, and color. A non-empty radial - chart must contain at least one positive value.

-
<native:donut-chart
-    class="w-full h-80"
-    :segments="[
-        ['id' => 'subscriptions', 'label' => 'Subscriptions', 'value' => 48200, 'color' => '#2563EB'],
-        ['id' => 'services', 'label' => 'Services', 'value' => 31750, 'color' => '#7C3AED'],
-        ['id' => 'partners', 'label' => 'Partners', 'value' => 9650, 'color' => '#F59E0B'],
-    ]"
-    :inner-radius-ratio="0.62"
-    :legend="['visible' => true, 'position' => 'bottom']"
-    _select="pointSelected"
-    a11y-label="Quarterly revenue by channel"
-/>
-

Pie or donut?

-

Pie charts use a fixed inner radius of zero. Donut charts default to a 0.6 cutout and accept an - inner-radius-ratio from 0.2 through 0.85. Both use the same ordered segment - contract.

-

Keep values understandable

-

Set locale and value formatting for the audience. Add a visible legend where labels cannot fit in - the chart and use a purposeful a11y-label for assistive technology.

-
- -
-
-
- - - - - \ No newline at end of file diff --git a/docs/index.html b/docs/index.html deleted file mode 100644 index 6e55de5..0000000 --- a/docs/index.html +++ /dev/null @@ -1,1022 +0,0 @@ - - - - - - - NativePHP Charts for Laravel and NativePHP Mobile - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
-
-

Native mobile analytics from Laravel and PHP

-

Ship native charts
without leaving PHP.

-

Give your NativePHP Mobile app iOS and Android charts through one platform-neutral Blade API—without a - WebView or JavaScript chart runtime.

- -
    -
  • NativePHP Mobile 4
  • -
  • PHP 8.4+
  • -
  • iOS 18.2+
  • -
  • Android API 26+
  • -
-
- -
-
- Android Biyuyo budget showing native bar and donut charts -
Android · Biyuyo budget
-
-
- iOS Biyuyo savings goal showing native line and donut charts -
iOS · Biyuyo goal
-
-
-
-
- -
-
-
-

Install once.
Render natively.

-

The package provides native iOS and Android renderers behind a validated PHP contract. Register it, rebuild - your chosen target, and render charts directly from Blade.

-
- -
-
-
- Terminal - -
-
composer require donmanueldev/nativephp-charts:^1.0
-php artisan vendor:publish --tag=nativephp-plugins-provider --no-interaction
-php artisan native:plugin:register donmanueldev/nativephp-charts --no-interaction
-php artisan native:plugin:list
-php artisan native:plugin:validate
-
-
-
PHP8.4 or newer
-
NativePHP Mobile4.x
-
iOS18.2 or newer
-
AndroidAPI 26 or newer
-
-
-
-
- -
-
-
-

Supported charts.
One native API.

-

Line, area, bar, scatter, candlestick, radar, pie, and donut render on iOS and Android as real native - components — never a WebView. The gallery shows current simulator captures; the API section documents every - registered component.

-
- -
-
-
Android weekly traffic forecast after refreshing the native line series
-
LineAndroid
-
-
-
Android stacked area chart comparing strength and cardio training load
-
AreaAndroid
-
-
-
Android sprint throughput bar chart with the Web value selected
-
BarAndroid
-
-
-
iOS multi-series scatter chart with a selected observation
-
ScatteriOS
-
-
-
iOS pie chart displaying the listening mix by format -
-
PieiOS
-
-
-
iOS listening mix donut chart with the Music segment selected
-
DonutiOS
-
-
- -
-
LineNative captures on iOS and Android
-
AreaNative captures on iOS and Android
-
BarNative captures on iOS and Android
-
ScatterNative captures on iOS and Android
-
PieNative captures on iOS and Android
-
DonutNative captures on iOS and Android
-
CandlestickDocumented native component and Blade contract
-
RadarDocumented native component and Blade contract
-
- -
-
- -
- - Native runtime evidence - Browse platform captures - Application showcases, dense-data runs, and Biyuyo product flows on iOS and Android. - - - -
- - - - - -
-
- -
-
-
-

Blade in.
Native UI out.

-

See how to render every supported chart with platform-neutral contracts for data, axes, legends, - formatting, selection, and accessibility.

-
- -
-
-
- - - - - - - - -
- -
-
-
sales-overview.blade.php
-
<native:line-chart
-    class="w-full h-80"
-    :series="[[
-        'id' => 'monthly-sales',
-        'name' => 'Ventas',
-        'color' => '#0F766E',
-        'points' => [
-            ['id' => 'jan', 'label' => 'Ene', 'value' => 42000],
-            ['id' => 'feb', 'label' => 'Feb', 'value' => 51800],
-            ['id' => 'mar', 'label' => 'Mar', 'value' => 62400],
-        ],
-    ]]"
-    locale="es-NI"
-    value-format="currency"
-    currency-code="NIO"
-    :maximum-fraction-digits="0"
-    a11y-label="Ventas mensuales en córdobas"
-/>
-
-
- - - - - - - - - - - - - - -
- -
-
-
-
-
iOS · update
-
-
-
-
Android · update
-
-
- - - - - -

Captures from installed iOS and Android apps. No browser runtime.

-
-
- -
-
- 01 -

Data

-

Ordered series and points for Cartesian charts, axes and values for radar, and - segments for pie and donut.

-
-
- 02 -

Axes & formats

-

Category, number, date, and datetime x-axes with localized number, currency, percent, and date output. -

-
-
- 03 -

Interaction

-

Stable identities, immediate native highlights and tooltips, plus versioned PHP selection callbacks.

-
-
- 04 -

Semantic styles

-

Platform-neutral line, area, bar, candlestick, point, grid, axis, legend, and radial segment - configuration.

-
-
- - -
-
- -
-
-
-

Accessibility in the contract,
explicit in every chart.

-

The renderers provide localized values, bounded summaries, and stable selection identity. Validate - VoiceOver and TalkBack behavior on your target devices as part of release acceptance.

-
-
-
-
Purpose
-
Application-defined a11y-label
-
-
-
Values
-
Localized with the chart formatter
-
-
-
Selection
-
Stable series, point, or segment identity
-
-
-
-
- -
-
-
-

Questions answered

-

NativePHP Charts,
in plain terms.

-
-
-
- What is NativePHP Charts? -

It is an independent community plugin that adds native chart components to NativePHP Mobile applications - built with Laravel and PHP.

-
-
- Which charts are supported? -

Line, area, bar, scatter, candlestick, radar, pie, and donut charts are available through native Blade - elements.

-
-
- Does it use a WebView or JavaScript chart library? -

No. iOS uses Swift Charts and SwiftUI Canvas; Android uses Jetpack Compose Canvas. The public API stays - platform-neutral.

-
-
- How do I make charts accessible? -

Give every chart a localized a11y-label. The renderers provide localized values and bounded - summaries; validate VoiceOver and TalkBack on your target devices.

-
-
- How do I install it? -

Install it through Composer, register the plugin, validate the manifest, and rebuild your selected iOS or - Android native target. Follow the installation guide for the complete - path.

-
-
-
-
- -
-
-

Render native charts
without leaving Laravel.

- -
-
-
- - - - - diff --git a/docs/package.json b/docs/package.json new file mode 100644 index 0000000..5c5daff --- /dev/null +++ b/docs/package.json @@ -0,0 +1,26 @@ +{ + "name": "nativephp-charts-docs", + "type": "module", + "version": "0.0.1", + "engines": { + "node": ">=22.12.0" + }, + "scripts": { + "dev": "astro dev", + "build": "astro build", + "check": "astro check", + "preview": "astro preview", + "astro": "astro" + }, + "dependencies": { + "@astrojs/starlight": "^0.42.1", + "astro": "^7.3.2" + }, + "devDependencies": { + "@astrojs/check": "^0.9.6", + "typescript": "^5.9.2" + }, + "allowScripts": { + "esbuild": true + } +} \ No newline at end of file diff --git a/docs/pnpm-lock.yaml b/docs/pnpm-lock.yaml new file mode 100644 index 0000000..0c84ee9 --- /dev/null +++ b/docs/pnpm-lock.yaml @@ -0,0 +1,4086 @@ +lockfileVersion: '9.0' + +settings: + autoInstallPeers: true + excludeLinksFromLockfile: false + +importers: + + .: + dependencies: + '@astrojs/starlight': + specifier: ^0.42.1 + version: 0.42.1(astro@7.3.2(@emnapi/core@1.11.1)(@emnapi/runtime@1.11.3)(@types/node@24.13.4)(yaml@2.9.1))(typescript@5.9.3) + astro: + specifier: ^7.3.2 + version: 7.3.2(@emnapi/core@1.11.1)(@emnapi/runtime@1.11.3)(@types/node@24.13.4)(yaml@2.9.1) + devDependencies: + '@astrojs/check': + specifier: ^0.9.6 + version: 0.9.10(prettier@3.9.6)(typescript@5.9.3) + typescript: + specifier: ^5.9.2 + version: 5.9.3 + +packages: + + '@astrojs/check@0.9.10': + resolution: {integrity: sha512-zgx/UQMozdjOa3bOxjgeCFdtpE3c9rRX6xHwa+2QXvy8z8Akifu2AtubHyv/zzC2znO8dl8fFWL4K+Ba9kS8HQ==} + hasBin: true + peerDependencies: + typescript: ^5.0.0 || ^6.0.0 + + '@astrojs/compiler-binding-android-arm64@0.4.1': + resolution: {integrity: sha512-Wtx2DZORuNTLASLLZ8hlrjFaJe1LUloatcCn9EPq7knBhRpjMGXeJANIJMeBZG4igvz7x+3nyAJM2iwCSW9xog==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [android] + + '@astrojs/compiler-binding-darwin-arm64@0.4.1': + resolution: {integrity: sha512-7iwXcU+hB60Y1SvOfnWHNioT72gDsDQKaDipXh2Onwp/TvQMozhbvhy13wJR8Af940a0h6PbddCeJFpj791UDA==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [darwin] + + '@astrojs/compiler-binding-darwin-x64@0.4.1': + resolution: {integrity: sha512-pifjICos49RXhSVKSDu5gDB0/8j0O7DmxSp1DaWW2PyLG5ekwSkcrfOZto5JqhdI7QYMZB3XOiXpsdOXpS4npA==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [darwin] + + '@astrojs/compiler-binding-linux-arm64-gnu@0.4.1': + resolution: {integrity: sha512-hsZMlNWc6LqWHh9LlSwTq1/XCY7pxA5rkkKIdZRV8mgbOz9OwLvjEoe5Jry13eIZjMUQO8XnQyzk8o/Pjw2YFA==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [linux] + libc: [glibc] + + '@astrojs/compiler-binding-linux-arm64-musl@0.4.1': + resolution: {integrity: sha512-a3EW27f+Z9uf57vYmpLgUriA1y9wDhKz57PT8D8XlFZt2HZEWhUxKuxI1jvKVI9p8okYee11WXEm/FHY1G9yoQ==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [linux] + libc: [musl] + + '@astrojs/compiler-binding-linux-x64-gnu@0.4.1': + resolution: {integrity: sha512-XruPTKB/SS4DFzeAjQ1ZyM0ieHDjapHkOSnnzRApZ4FXY2YAI7UY3mETjfJiIS/acyZyrnPH5jObv1gATTdUJQ==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [linux] + libc: [glibc] + + '@astrojs/compiler-binding-linux-x64-musl@0.4.1': + resolution: {integrity: sha512-E8j7lGanqNpudtkUbsFaOLJhmwFe4Ecqux7K9hkj4wULIPNZRM2bYZNcMSj8r1oWvaUiwZl8LaaNwv3+14jqhw==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [linux] + libc: [musl] + + '@astrojs/compiler-binding-wasm32-wasi@0.4.1': + resolution: {integrity: sha512-vNLxIv41ZE+nmPFtw24cRW5ZXG+ZPcAGtgigtjCP8lvcxKI7u2GrXoMsCgEH5fMw8WCEJpwLvsVBg15rJKAkyA==} + engines: {node: '>=14.0.0'} + cpu: [wasm32] + + '@astrojs/compiler-binding-win32-arm64-msvc@0.4.1': + resolution: {integrity: sha512-/xTDgRsFDoTh0/+KFXJ74DY4Jqn8CoSHwa8UP5RAblHfnRHkenwfSl4zYDET61O9vXKLk09UzHjjq09yP20/AQ==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [win32] + + '@astrojs/compiler-binding-win32-x64-msvc@0.4.1': + resolution: {integrity: sha512-0x5J6iHZO0Fjo/CVzoIbXKzWnGESftDbEUQ/oXQ61HhUAFoR7+T1jfToZSNAS+gYyBXHSTpMWYC7lzarbhClcg==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [win32] + + '@astrojs/compiler-binding@0.4.1': + resolution: {integrity: sha512-ZYVDW1P58OXyxqZbOMp+/2U9KA7y2esIx9r4pWdpZ/l6fCZhaw4ul+D7EgpRVxYLkyTWqzANbTTUFGPFP8zDHA==} + engines: {node: ^20.19.0 || >=22.12.0} + + '@astrojs/compiler-rs@0.4.1': + resolution: {integrity: sha512-//NmAuRhy7eU9iP0ceI5Pymy55M+nUZ//kS6XeOyhBWdDib2KbJOyFaVJ52k7sDkJwTKVox7oPu3SpYiVnGm5A==} + engines: {node: '>=22.12.0'} + + '@astrojs/compiler@2.13.1': + resolution: {integrity: sha512-f3FN83d2G/v32ipNClRKgYv30onQlMZX1vCeZMjPsMMPl1mDpmbl0+N5BYo4S/ofzqJyS5hvwacEo0CCVDn/Qg==} + + '@astrojs/internal-helpers@0.11.0': + resolution: {integrity: sha512-3rzxJ+xbo0+8YyqOzLziIN32wmsHdCjEVz2sGOpRxJ+Ben/KiLph4ItxBy1abEL+E8fkRzqjg0rfXmaHJGw9JA==} + + '@astrojs/language-server@2.16.16': + resolution: {integrity: sha512-KuS17AOOqH/M5mHXPmKvtp8L+NNteARC7Xjf395+9R9dtJOBndqdStwU4V+OKzYZpgZ+hliV13knzx/oMtFl7Q==} + hasBin: true + peerDependencies: + prettier: ^3.0.0 + prettier-plugin-astro: '>=0.11.0' + peerDependenciesMeta: + prettier: + optional: true + prettier-plugin-astro: + optional: true + + '@astrojs/markdown-satteri@0.4.1': + resolution: {integrity: sha512-EniHbFNa6SQHDih7JnpPos3NWXO6hdt4raBcOosfGmlfc3gP9CI/sESA3VOf1PgJZ7SFfewlZW9Livn0JugEZg==} + + '@astrojs/mdx@8.0.1': + resolution: {integrity: sha512-VKodp/f3+XE6L0950K+ZOAolY47vdt0R78Ao+L2RdJ1hfAdYffL7IEjc/MsoyuS7CPVvCsd5/I3RP0ZyAIewdQ==} + engines: {node: '>=22.12.0'} + peerDependencies: + '@astrojs/markdown-remark': ^7.3.0 + '@astrojs/markdown-satteri': ^0.4.0 + astro: ^7.2.6 + peerDependenciesMeta: + '@astrojs/markdown-remark': + optional: true + + '@astrojs/prism@4.0.2': + resolution: {integrity: sha512-KTivpmnz6lDsC6o9H4+DNm2SrE/GHzw8cNAvEJwAvUT+eoaEnn/4NtbDNfRRaxaJHdp15gf+tfHAWiXR4wB3BA==} + engines: {node: '>=22.12.0'} + + '@astrojs/sitemap@3.7.4': + resolution: {integrity: sha512-LbKNC24bdUWcQf/pThB6qLlSqHojxGjZDURIzFocY8rlWnAn2t74nnhnK6S5x0NHriHoAduLEpVjRykmeGiVvA==} + + '@astrojs/starlight@0.42.1': + resolution: {integrity: sha512-ABS/A0IfbJeMbuhCKVkrAcO3EWxhpeLveFuL28+7+BQje7ZHa9OXZbUoiLXdYUhH7XFaiAQjAg44RiF2uuZPJw==} + peerDependencies: + '@astrojs/markdown-remark': ^7.3.0 + astro: ^7.2.10 + peerDependenciesMeta: + '@astrojs/markdown-remark': + optional: true + + '@astrojs/telemetry@3.3.3': + resolution: {integrity: sha512-C1TLn5sPJr0x4vk56piHWKbnqlEB8BKyte5Y45V02U+D7BGO5eMqZDH5aPjnkXQWJggvmsTXxH03QMZ9NgWLzQ==} + engines: {node: 18.20.8 || ^20.3.0 || >=22.0.0} + + '@astrojs/yaml2ts@0.2.4': + resolution: {integrity: sha512-8oddpOae35pJsXPQXhTkM0ypfKPskVsh2bCxRtbf7e+/Epw2nReakFYpLKjZMEr75CsoF203PMnCocpfz0s69A==} + + '@babel/helper-string-parser@7.29.7': + resolution: {integrity: sha512-Pb5ijPrZ89GDH8223L4UP8i6QApWxs04RbPQJTeWDV0/keR2E36MeKnyr6LYmUUvqRRI+Iv87SuF1W6ErINzYw==} + engines: {node: '>=6.9.0'} + + '@babel/helper-validator-identifier@7.29.7': + resolution: {integrity: sha512-qehxGkRj55h/ff8EMaJ+cYhyaKlHIxqYDn682wQD7RNp9UujOQsHog2uS0r2vzr4pW+sXf90NeeayjcNaX3fFg==} + engines: {node: '>=6.9.0'} + + '@babel/parser@7.29.8': + resolution: {integrity: sha512-E8lTAYNB1KW+FH+VGJuZM1ioAx2E6oVlvQFRrf5P8ZZmsiJXYAD9vTFV7yyEURNzgh1dFqMZuO6tUwcARbqFCA==} + engines: {node: '>=6.0.0'} + hasBin: true + + '@babel/types@7.29.8': + resolution: {integrity: sha512-Vj1jF3cPfxg7OAfoI7QnVKLoILlm2JF9pnVHrX8qx7AHMiYWT+NDAA7jChlNgRS4WTLc/fD1lXLmPixluj+3Gg==} + engines: {node: '>=6.9.0'} + + '@bruits/satteri-darwin-arm64@0.10.5': + resolution: {integrity: sha512-27KTVl4TJkVahMy/ohyA7qd4938G5UNneFUz/PsScYfpIhj0IVAS23mpcJXdPF44sa6nva198lmV/cKIb2YPyA==} + cpu: [arm64] + os: [darwin] + + '@bruits/satteri-darwin-x64@0.10.5': + resolution: {integrity: sha512-IjnLe3nKspq6qaeqGgjT7MT8VrTV74yWRlaag7ZdNsI8TDAYZ0iPxMCo+9KQZHUk5EyVB+reBI/PFWL5KuFw9Q==} + cpu: [x64] + os: [darwin] + + '@bruits/satteri-linux-arm64-gnu@0.10.5': + resolution: {integrity: sha512-glkYXZCJywjP13v67eAyAMSJdF+ncvEbYvgi/wOtffL9tQ27lr/zsyzUfgs+ovjJ9d8JNQKiXeiArJcX8PJL9w==} + cpu: [arm64] + os: [linux] + libc: [glibc] + + '@bruits/satteri-linux-arm64-musl@0.10.5': + resolution: {integrity: sha512-yWdgG1g17Nh2QyGVlFUxGRa3FEFwiMcpZEyMNWkbM3deC94cmVc+/i9OuyFpdKuWo3GkgoCtYVOoxk1uCnCZIA==} + cpu: [arm64] + os: [linux] + libc: [musl] + + '@bruits/satteri-linux-x64-gnu@0.10.5': + resolution: {integrity: sha512-FVaLoPT1fBgGl0J+AYebyyXJYBachGl8Oyyrf1lye4RTqCB4S0Gwkj1uM9RJyThUOvx5VUmAT1CnNh1SFHA+kw==} + cpu: [x64] + os: [linux] + libc: [glibc] + + '@bruits/satteri-linux-x64-musl@0.10.5': + resolution: {integrity: sha512-EHpVAx2bqW3GINHTKkljtxVfQmVDGWIuwOYOP5YghTj+0PkBa2o8oKPRtQ9Kbsr1Fye8jtUcDjhwj2jMNugZKg==} + cpu: [x64] + os: [linux] + libc: [musl] + + '@bruits/satteri-wasm32-wasi@0.10.5': + resolution: {integrity: sha512-ypz8c/Zmipxp4IoeDa228Gstv6TLzVmNs3yC6wKCoNSOjx1iwpgzu87Y3hTkXFdwChVGU85qeUDuOIarGUZQLw==} + engines: {node: '>=14.0.0'} + cpu: [wasm32] + + '@bruits/satteri-win32-arm64-msvc@0.10.5': + resolution: {integrity: sha512-siTV88nb0LRqNpkL2gXboqCwVdq95sLtzMHS1/3eONV2gLbB3NAK46wmSMvCO/yquBvI2lvaFIfd8P12ecsxBw==} + cpu: [arm64] + os: [win32] + + '@bruits/satteri-win32-x64-msvc@0.10.5': + resolution: {integrity: sha512-C3IfPvfvMXmlzBxaMPKFS1XiuV9pu2mC7YqkPk7PSvTgPZ8gbdASIpHpztDLvTTQjqZ0z1Ol8tK5X+V6XXC0wQ==} + cpu: [x64] + os: [win32] + + '@capsizecss/unpack@4.0.1': + resolution: {integrity: sha512-CuNiSqg7+e1cO/GjffyMOm5Tt2jUF9CWHHnvQ/UkqvtkGfHdgwEC0wpmq7fkN3gxwpRnrAN0WzO3vREKmNolMQ==} + engines: {node: '>=18'} + + '@clack/core@1.5.1': + resolution: {integrity: sha512-iHTrHA8MtVuLl2TfZySmcKv1qO2PoyC9Z7pfSDozEuV5vtY3/wcOPKJXlqJ5Oq2Cx5DDGQGAMVx6HZfRRoVEbQ==} + engines: {node: '>= 20.12.0'} + + '@clack/prompts@1.8.1': + resolution: {integrity: sha512-dlT1m5e/0yUL0kRNcQn7yGLVThkgbB0Ga/1AmfDDC/8ik6AIiSf2QLQO2zPYvefsHP0aFgxO93cVLCCfDp7kzQ==} + engines: {node: '>= 20.12.0'} + + '@ctrl/tinycolor@4.2.1': + resolution: {integrity: sha512-Vh5uy9Y1JBMId6J1f68TMXnZrTCvNdo9Fu2k0d1YnJngR+sM5kWTKl441c/3TFs+cG0NWOjRWgQ/iaWhbYx+7A==} + engines: {node: '>=14'} + + '@emmetio/abbreviation@2.3.3': + resolution: {integrity: sha512-mgv58UrU3rh4YgbE/TzgLQwJ3pFsHHhCLqY20aJq+9comytTXUDNGG/SMtSeMJdkpxgXSXunBGLD8Boka3JyVA==} + + '@emmetio/css-abbreviation@2.1.8': + resolution: {integrity: sha512-s9yjhJ6saOO/uk1V74eifykk2CBYi01STTK3WlXWGOepyKa23ymJ053+DNQjpFcy1ingpaO7AxCcwLvHFY9tuw==} + + '@emmetio/css-parser@0.4.1': + resolution: {integrity: sha512-2bC6m0MV/voF4CTZiAbG5MWKbq5EBmDPKu9Sb7s7nVcEzNQlrZP6mFFFlIaISM8X6514H9shWMme1fCm8cWAfQ==} + + '@emmetio/html-matcher@1.3.0': + resolution: {integrity: sha512-NTbsvppE5eVyBMuyGfVu2CRrLvo7J4YHb6t9sBFLyY03WYhXET37qA4zOYUjBWFCRHO7pS1B9khERtY0f5JXPQ==} + + '@emmetio/scanner@1.0.4': + resolution: {integrity: sha512-IqRuJtQff7YHHBk4G8YZ45uB9BaAGcwQeVzgj/zj8/UdOhtQpEIupUhSk8dys6spFIWVZVeK20CzGEnqR5SbqA==} + + '@emmetio/stream-reader-utils@0.1.0': + resolution: {integrity: sha512-ZsZ2I9Vzso3Ho/pjZFsmmZ++FWeEd/txqybHTm4OgaZzdS8V9V/YYWQwg5TC38Z7uLWUV1vavpLLbjJtKubR1A==} + + '@emmetio/stream-reader@2.2.0': + resolution: {integrity: sha512-fXVXEyFA5Yv3M3n8sUGT7+fvecGrZP4k6FnWWMSZVQf69kAq0LLpaBQLGcPR30m3zMmKYhECP4k/ZkzvhEW5kw==} + + '@emnapi/core@1.11.1': + resolution: {integrity: sha512-RSvbQmHzdKzNsLYa/wHrbc3KN4sYLKAdPZxqiM2HATqv/SBk2/ENSHpvXGaLOMcsAyz0poEGqkmmKYG3OWiJEQ==} + + '@emnapi/runtime@1.11.1': + resolution: {integrity: sha512-vgj7R3y3Wgx24IQaGPA/R6YFXLHVMOZ0uVEyIQPaWs+rd1AzfEMXlAC22FYwO1XkKR6NPsq7mUandH8oIRdZFw==} + + '@emnapi/runtime@1.11.3': + resolution: {integrity: sha512-Xz4Tpyki7XyrpbUK1jR1AhdAdaXyhhY4lZ3neLodmhpuWfy2PAQN5B46sAiU4liOXGLkHypn/qU+jvfWSCYYLA==} + + '@emnapi/wasi-threads@1.2.2': + resolution: {integrity: sha512-c95qOXkHdydNKhscBTebqEC1CVAZpyqOfVfBzQ1qgzyl3gfeldUjIggDbIZgDKsHLgnsM+igH7TJ/eAasaVuMA==} + + '@esbuild/aix-ppc64@0.28.2': + resolution: {integrity: sha512-XExcO+dvLKvVtNTibSTBej1NCAbaGhWn9Ww1ZPx80qsahhPFe/8jgWP0IchNe0F3HwkU7n8ejhH8bjonqht8mQ==} + engines: {node: '>=18'} + cpu: [ppc64] + os: [aix] + + '@esbuild/android-arm64@0.28.2': + resolution: {integrity: sha512-5YfKeeI8qWfBZIX+u2xZC3Zlb3Os/gLS2sbEKM+I4ZOcsWmHS2WLysCcQZDAFRslDUU5Oiq44gf6PYN1vGwG5A==} + engines: {node: '>=18'} + cpu: [arm64] + os: [android] + + '@esbuild/android-arm@0.28.2': + resolution: {integrity: sha512-kXXoiPVVGQcnIYGOeaovwOURpniDBpSq4A03qkQ+BMQqtGG6HYap3xne9C1O1yo4TR3qxlCX5IqqmX6fFo2Lqg==} + engines: {node: '>=18'} + cpu: [arm] + os: [android] + + '@esbuild/android-x64@0.28.2': + resolution: {integrity: sha512-O387ite7SzUyCcy3JQX4P4bLtEA7bLLkx+esve5JHnyYfNTxcVpXZo9jhdB0lTKN44gztELTdU7nS8Nr16Fs1Q==} + engines: {node: '>=18'} + cpu: [x64] + os: [android] + + '@esbuild/darwin-arm64@0.28.2': + resolution: {integrity: sha512-n4KqkOQrraxHJcgjM1RvwbigfQKIKJVpM7xp+KsxiyUSrRdIXnt73VhrPAx0fV44hgfmIVKjxMN9J1t5jySVkw==} + engines: {node: '>=18'} + cpu: [arm64] + os: [darwin] + + '@esbuild/darwin-x64@0.28.2': + resolution: {integrity: sha512-uq6suIWYP37qzGddBKPw5QEQPi6HiLGsO7UmkpfyaYNQ3D+rN6w6WfwH+nuqcGXWvawGwxOEroO4YGnFh95azw==} + engines: {node: '>=18'} + cpu: [x64] + os: [darwin] + + '@esbuild/freebsd-arm64@0.28.2': + resolution: {integrity: sha512-n+I0BTSRIoy+d6RPKnEVwql5UwBJolytvY4mAOIEJorKlqgPII8ix6slVVrfZ5Tnj7glIZvloylbB/EJPMWEXw==} + engines: {node: '>=18'} + cpu: [arm64] + os: [freebsd] + + '@esbuild/freebsd-x64@0.28.2': + resolution: {integrity: sha512-78XJTJkvPs0kz2w61301PJjXl4g7q3JqiYMZ/M/yVI73EHBrCRTgkhu9oqG7vPqq+a/yadEW8aD+agKlk5xrmg==} + engines: {node: '>=18'} + cpu: [x64] + os: [freebsd] + + '@esbuild/linux-arm64@0.28.2': + resolution: {integrity: sha512-pW4AC0P3it8c7do9MVM4p51FzHzdM/TZrerurgRcHJ2WTa1VQ1CIq18xncfpBJw4ojkiZZrKW2yIBWBP92j6Ug==} + engines: {node: '>=18'} + cpu: [arm64] + os: [linux] + + '@esbuild/linux-arm@0.28.2': + resolution: {integrity: sha512-XlDnu2q5yoqems+xay6wSAcg9DDD7K9RLKZEBOMZm3ckNpJBvOX20tSfby8KfrrhINDyv9V2YVZKY/SpoGJI8w==} + engines: {node: '>=18'} + cpu: [arm] + os: [linux] + + '@esbuild/linux-ia32@0.28.2': + resolution: {integrity: sha512-CYbnj78HsIeA+DhgUKgFCfvNsTHFhMMrinUrMZpDXJXKN8T3XViTZ/+wtHeVxEWY8ewSzTFN+nRmSwO2tZaLUQ==} + engines: {node: '>=18'} + cpu: [ia32] + os: [linux] + + '@esbuild/linux-loong64@0.28.2': + resolution: {integrity: sha512-buwkd8nsph4R+ajRvw0qM5Hja/TXQow3ptzWO2EbG/cqcIkHloRrdlBtQlshyYGTNFvfkfJ5tpPLVkY4DtsPfQ==} + engines: {node: '>=18'} + cpu: [loong64] + os: [linux] + + '@esbuild/linux-mips64el@0.28.2': + resolution: {integrity: sha512-ZVykbDyk7519VwiNb9Lcj9m8XM6v5V9uKPvrEMkkEedVewf+0itkhahp4HDpgERXhwLRpWFypsGbG/J8s0QjJA==} + engines: {node: '>=18'} + cpu: [mips64el] + os: [linux] + + '@esbuild/linux-ppc64@0.28.2': + resolution: {integrity: sha512-CAXl+Dtd9UUuJd8pKKdwh6MLm3MUMiqMPmhZ3tTSXPqfyQ3vDl6R5hZdZ/kYojK4ofXtdfSv1tFq8XzWx3heNQ==} + engines: {node: '>=18'} + cpu: [ppc64] + os: [linux] + + '@esbuild/linux-riscv64@0.28.2': + resolution: {integrity: sha512-GeXCej4IQtU1B+QlDV8W/RRvbzI3O/Stss+/bCXv4lZls5WGRtu2a+3JkA3i4qIUlMXpcHebWpF8AkJhATowuA==} + engines: {node: '>=18'} + cpu: [riscv64] + os: [linux] + + '@esbuild/linux-s390x@0.28.2': + resolution: {integrity: sha512-3H1weTYZPxt/WOhByszQZybS9w5lKzUn1FDMsgEChbHWQwHYQQRfBxgCcZvPhjHfKyJjIievvMmEUawJrdY9Dg==} + engines: {node: '>=18'} + cpu: [s390x] + os: [linux] + + '@esbuild/linux-x64@0.28.2': + resolution: {integrity: sha512-4xTZr1FUmSoQW4XIWmit3tzQrUTZM+N3P0XV8xROKYF50XfI7xeO90+1bZvNwxIufQ9hDQVRJH5YhgPVF8A/HQ==} + engines: {node: '>=18'} + cpu: [x64] + os: [linux] + + '@esbuild/netbsd-arm64@0.28.2': + resolution: {integrity: sha512-sSATRjPeDBg3pdgHoQfoYBob11Kk1FGa9lui5RIHZCoCkJa9QKlvl3/vKz2usCmYYjs7ymJR/2Nnsqe+Hjt5nw==} + engines: {node: '>=18'} + cpu: [arm64] + os: [netbsd] + + '@esbuild/netbsd-x64@0.28.2': + resolution: {integrity: sha512-lqnzCV+mM0gIADaKihiCg6ifgfU2L3h5E33rNQBN1Y4MaVGnzryzmvvf7UHxprpQdE8hpqLolJ9Rl+SkIRDpyw==} + engines: {node: '>=18'} + cpu: [x64] + os: [netbsd] + + '@esbuild/openbsd-arm64@0.28.2': + resolution: {integrity: sha512-AL2qJILH7lNjrDmCQDvdxMfAUIv8KMNZOvrwAQ8i8//ntL9FflhOyMJ8OZSMBb8/AWXe3/5v5S20y3zCoZWKoQ==} + engines: {node: '>=18'} + cpu: [arm64] + os: [openbsd] + + '@esbuild/openbsd-x64@0.28.2': + resolution: {integrity: sha512-QtiuPytchRyC4rwUKhexJdQKvDuZ6hWloi3igqPQNUJCS1/v9EiO3UTOXR6A3FoMo4fnAKbWJdqaIwhOzh8qEw==} + engines: {node: '>=18'} + cpu: [x64] + os: [openbsd] + + '@esbuild/openharmony-arm64@0.28.2': + resolution: {integrity: sha512-WkhYDmpTjLvGlScA1rwjRUmhl4k8oXR3cIbtqWmELgU/dFeHHlEllxDvdWcNJV9rbzCexB5vz8gtNewWLgCT7Q==} + engines: {node: '>=18'} + cpu: [arm64] + os: [openharmony] + + '@esbuild/sunos-x64@0.28.2': + resolution: {integrity: sha512-GPMSkTOtMnv2U2F8gxe4Io6qmVs+YKyp832Etqqxr0hFngmXQ3rzwytelm3GIn7T4VviRUlf3sOgBOiTdvaf7g==} + engines: {node: '>=18'} + cpu: [x64] + os: [sunos] + + '@esbuild/win32-arm64@0.28.2': + resolution: {integrity: sha512-PIhhEkE9uPBleRBrQEJpUn7MBnibZzbGzYWPmY3x+YoVg/95zbjB4CxPPOQ8l5tYYM4mMaCthF8/1DIfBQQyWQ==} + engines: {node: '>=18'} + cpu: [arm64] + os: [win32] + + '@esbuild/win32-ia32@0.28.2': + resolution: {integrity: sha512-YmJbfTlvU7Sdn9BB+4PRES4oB6pxgS37MAONj+hBr/cpXS1aBPKXxNnDbu+QCWPj0o9dgyxeq79g6c5P8KeuYA==} + engines: {node: '>=18'} + cpu: [ia32] + os: [win32] + + '@esbuild/win32-x64@0.28.2': + resolution: {integrity: sha512-5ebpxr3nWMzrL/rnUI755Jkuee0bHL/Gq0WTF9lvcpv73wAp5eu8MfBUgWK9bhWvZjj7yX8etf/8tI8Ney695g==} + engines: {node: '>=18'} + cpu: [x64] + os: [win32] + + '@expressive-code/core@0.44.2': + resolution: {integrity: sha512-Yw5KonQCD1HoOO2P89y4wifqS9qrJcGVY0LkVMUsVZjhi++bhz4WwQ37inenKFNOEVo50P7cjoVsCdaVnUbq8w==} + + '@expressive-code/plugin-frames@0.44.2': + resolution: {integrity: sha512-gVLm6TQMNIRWIaM7o+mCtxkGNjLZY5/2faSTLoXeo9wv/Pkj/0QAtZyXPVPrRsPARqiipATNFmfvQFLJudxPHQ==} + + '@expressive-code/plugin-shiki@0.44.2': + resolution: {integrity: sha512-ebWIvCDzXvjyD8rH6T6DfytYJw1GoArLR4nusIAE4VxXrCQf3d+owytiv010KU/dUg+SRLZskDn0N+HaFXeuSg==} + + '@expressive-code/plugin-text-markers@0.44.2': + resolution: {integrity: sha512-SNI7EgUSiADqbqUzzMbj1ZeC/r2pa5eg3KyFOGAd3a7EsIA4qzjXQLp+ODWQtHVDKFCdGs4J3ovSJUqvKIK96g==} + + '@img/colour@1.1.0': + resolution: {integrity: sha512-Td76q7j57o/tLVdgS746cYARfSyxk8iEfRxewL9h4OMzYhbW4TAcppl0mT4eyqXddh6L/jwoM75mo7ixa/pCeQ==} + engines: {node: '>=18'} + + '@img/sharp-darwin-arm64@0.35.4': + resolution: {integrity: sha512-Uhfl4V4lhP2nbUVF9+hyH1+luj86f1gUFeo8ALYxFoULoU+G87D43BfeMP8XHsk9boxAnCY/bf2EHwhA7MuGsA==} + engines: {node: '>=20.9.0'} + cpu: [arm64] + os: [darwin] + + '@img/sharp-darwin-x64@0.35.4': + resolution: {integrity: sha512-hWniXY3bG5qKpkKrAwPe4y+VTPmf086YQAnkxWh7uA1YrlRouWGa0M0Mxj3ZjnXFkv7/TD1bTy9lGUK26vRvWw==} + engines: {node: '>=20.9.0'} + cpu: [x64] + os: [darwin] + + '@img/sharp-freebsd-wasm32@0.35.4': + resolution: {integrity: sha512-lIsKw/BU+kjB4eZjxrYrZmwOJYi3Ajrv66iAlBmUPyKc3HpnloevB1g3wxGD9P/5BbQ1brBGl65VRRrCvQDEqA==} + engines: {node: '>=20.9.0'} + os: [freebsd] + + '@img/sharp-libvips-darwin-arm64@1.3.3': + resolution: {integrity: sha512-suTBPTDGrI9WodccaDdwZItTSaBYASlBk1NSfElSHrUfzu3szG6lvIF58+WiFvnfzuK8ZBFS5zE00PxqxnRiPg==} + cpu: [arm64] + os: [darwin] + + '@img/sharp-libvips-darwin-x64@1.3.3': + resolution: {integrity: sha512-FVJZ5mITMobmXIz/hPDTw0EintTW5H3WfrxwLqEqjiIihlu+hVRyGrFQ60xl0Lxn7Bt3zdpevPaQi0HEzqz9fw==} + cpu: [x64] + os: [darwin] + + '@img/sharp-libvips-linux-arm64@1.3.3': + resolution: {integrity: sha512-0DaL0A6Xu6sQSQFwe4iVCrKWU2cCTItnRsYsCdxAMm9NF6twAA9BKnoqy4hqz4+azQ0JHuA26qiUKsf1XJ/v5A==} + cpu: [arm64] + os: [linux] + libc: [glibc] + + '@img/sharp-libvips-linux-arm@1.3.3': + resolution: {integrity: sha512-3rbU4vqXXc3hY/OiXdl52xZvT0F1yEngWfvqudtPJg/KkyiaQw2DRsFrNzpmLvfavbwOq3qXn36GP8obHRULQA==} + cpu: [arm] + os: [linux] + libc: [glibc] + + '@img/sharp-libvips-linux-ppc64@1.3.3': + resolution: {integrity: sha512-cdn1OvUBwsXhbC0zSzJnNzf5MZ/mTrobawDvNXBTxe8VtqKAm0sRuEY2Evzovb/w9JMk4TvRxqt1mekSuJz64w==} + cpu: [ppc64] + os: [linux] + libc: [glibc] + + '@img/sharp-libvips-linux-riscv64@1.3.3': + resolution: {integrity: sha512-HjPVx7yKz+0lqdhDlTw1tt90wamBoxhiXpvl1XZpJLiHH4RCJ5yDTqH+VlYPv2fwFs89JFw4c1IexYOcQUi4IQ==} + cpu: [riscv64] + os: [linux] + libc: [glibc] + + '@img/sharp-libvips-linux-s390x@1.3.3': + resolution: {integrity: sha512-neWLh+3yCNThxnfy3c4BbVBeGgt9aftno+XbT56iK28RgeDs3UOFWviLWlUu0bArYVYJaFDK+RRohbicUNCm8Q==} + cpu: [s390x] + os: [linux] + libc: [glibc] + + '@img/sharp-libvips-linux-x64@1.3.3': + resolution: {integrity: sha512-4vKmvAst9nrowcqquKFAyZJUDolUaIp8uRiN0mWFguJ1IplC9/pitXtlnnlU4aa/eJw3J7i67V+pwUL+wZGdsA==} + cpu: [x64] + os: [linux] + libc: [glibc] + + '@img/sharp-libvips-linuxmusl-arm64@1.3.3': + resolution: {integrity: sha512-Y9kQaLMuNoB0bPYOOdcZMaseNrFpPodIWWMrx+CZyydf2xn68j9WYc6sWWRrDwNkzCQjKYfc68L7jKjGlHMibw==} + cpu: [arm64] + os: [linux] + libc: [musl] + + '@img/sharp-libvips-linuxmusl-x64@1.3.3': + resolution: {integrity: sha512-fj8Mv0HHfD1Rr+4I68+3agJynxDWtBFgicTbSOb9Bke6pIwzGcJ+RX/yHjmiEGFMCavY/dxvem7MyNaJF+wDiw==} + cpu: [x64] + os: [linux] + libc: [musl] + + '@img/sharp-linux-arm64@0.35.4': + resolution: {integrity: sha512-De4jpEnAU8Hd5oT0j1G3uL4ZvTuipVMn7YC6vPaJhy6/7EwEae0SVAoBrUMYQbkLGDm85taVWwuPc1a44LTzCQ==} + engines: {node: '>=20.9.0'} + cpu: [arm64] + os: [linux] + libc: [glibc] + + '@img/sharp-linux-arm@0.35.4': + resolution: {integrity: sha512-7OAS8gI0EReKGVN2HssHlM6umJgxF5VI3xN0p9FA91p/YO+ou5hiNghLdZ5BEHztwaaK5+bLKRf8x/o2L2nk9A==} + engines: {node: '>=20.9.0'} + cpu: [arm] + os: [linux] + libc: [glibc] + + '@img/sharp-linux-ppc64@0.35.4': + resolution: {integrity: sha512-2oYZJeIl4kCcMGk4ouZVjnkCtFrpQFlNEtJ6GbxzhHQchwH0NH/qEb9ykmOl29dqwMq+JhFdZn+1ak2FKhI9fQ==} + engines: {node: '>=20.9.0'} + cpu: [ppc64] + os: [linux] + libc: [glibc] + + '@img/sharp-linux-riscv64@0.35.4': + resolution: {integrity: sha512-cPbNChoRURAWdebDIHSenxRpgEdy7JkPydSnUxRm9VvKD7m0/xVaR/8Fzlu81pk5nHEvHH87UZUA7cTtwnbJSA==} + engines: {node: '>=20.9.0'} + cpu: [riscv64] + os: [linux] + libc: [glibc] + + '@img/sharp-linux-s390x@0.35.4': + resolution: {integrity: sha512-RY0JFY8Fd6RonCBtHz+DvadaPkXDSI1AUn6yWL9TipqkZ1vY8w8evqdgyDFnkm4/K1ve1TvZiaePP5oSd4+WVQ==} + engines: {node: '>=20.9.0'} + cpu: [s390x] + os: [linux] + libc: [glibc] + + '@img/sharp-linux-x64@0.35.4': + resolution: {integrity: sha512-9qvvEAuk8k89TfWUoX2htWjbAMX8p+NxCppjpcg5k6xMsjhBQPTsoIh36h9Qde4WRuGpJeYnOjdosDn/cnv+OA==} + engines: {node: '>=20.9.0'} + cpu: [x64] + os: [linux] + libc: [glibc] + + '@img/sharp-linuxmusl-arm64@0.35.4': + resolution: {integrity: sha512-KB5jxpfWQTr0nc3xdHtWChdbifHrBGsd2SM62Eyxrl8afikm+f5qGBU75SJIZBT/S1MC8XyacdlXBMSWq6OURA==} + engines: {node: '>=20.9.0'} + cpu: [arm64] + os: [linux] + libc: [musl] + + '@img/sharp-linuxmusl-x64@0.35.4': + resolution: {integrity: sha512-f+eZJZIQNEEd26RPSW+76chwOf1XtA2Y/O+5ocVyLliHkeih3e+jhLVBdNTd2rS3IbNXK8+ug93Vf5ZXtF5Lxg==} + engines: {node: '>=20.9.0'} + cpu: [x64] + os: [linux] + libc: [musl] + + '@img/sharp-wasm32@0.35.4': + resolution: {integrity: sha512-zQnl4Kwp7Q6NHsENtU2T/00Zi+w3AQNwz3+UaTyVBy2FpXrzXzGjndpK61onhZjRtRpQXxCTeqw19bVyXOh7jA==} + engines: {node: '>=20.9.0'} + + '@img/sharp-webcontainers-wasm32@0.35.4': + resolution: {integrity: sha512-ESfNkywmCfPNyaZjxooddJQiQ+l/nTpGEOGthxiLnIHXC/CmcBixnfwUleX9mCz9ovrUUvKMap/pm8RYbzfwaA==} + engines: {node: '>=20.9.0'} + cpu: [wasm32] + + '@img/sharp-win32-arm64@0.35.4': + resolution: {integrity: sha512-iNdlBX9gLVvqe2I3uIJSIKTq6wckP/DYxZtcqxm09x5Gi24DnFBmPAWZmr60ZyYMG0xlzo6goG3670ar+RXvRw==} + engines: {node: '>=20.9.0'} + cpu: [arm64] + os: [win32] + + '@img/sharp-win32-ia32@0.35.4': + resolution: {integrity: sha512-kqRsbaa5CS6KHlpxnN7WhE6vAAugXyZButpRdvDWetlv6Qv4N9WTcrWzF7tXfB9T7MsoadqdI8hmwLq6UlLvtw==} + engines: {node: ^20.9.0} + cpu: [ia32] + os: [win32] + + '@img/sharp-win32-x64@0.35.4': + resolution: {integrity: sha512-XtmnYhBcrORsJ4XJngyzr/EWP0hRZLAZRFaApdKuviyqF78+ylxh2y06ZmtULAMOnObJ3ucpN0AcwSWnMowTRg==} + engines: {node: '>=20.9.0'} + cpu: [x64] + os: [win32] + + '@jridgewell/sourcemap-codec@1.6.0': + resolution: {integrity: sha512-T7jf+5zgsZHwNJ4lvQ7/aezbyk0nNX+zJVWpmHA7VYsEx7a7qr5Rg5IbtJFqkgze5Y2sruq1RUY8Q837Od7iFw==} + + '@napi-rs/wasm-runtime@1.2.4': + resolution: {integrity: sha512-AJxoUD2/15ESHbvpcyjU274nsAPLuOtPHCk0vKJM5pj//Fg/B1FXNWjPnXTT9PymCYYiHo4zPj0ZomXBKhoy7g==} + engines: {node: ^20.19.0 || ^22.13.0 || >=23.5.0} + peerDependencies: + '@emnapi/core': ^1.7.1 || ^2.0.0-alpha.4 + '@emnapi/runtime': ^1.7.1 || ^2.0.0-alpha.4 + + '@oslojs/encoding@1.1.0': + resolution: {integrity: sha512-70wQhgYmndg4GCPxPPxPGevRKqTIJ2Nh4OkiMWmDAVYsTQ+Ta7Sq+rPevXyXGdzr30/qZBnyOalCszoMxlyldQ==} + + '@oxc-project/types@0.149.0': + resolution: {integrity: sha512-Efcc+iF0j3Bf67YjEqIqWXbX5XddXoK/Mw4K1/JuXwRCZ8N16VR7iT23nlCc9XrveFVh/E5Rqs2StT0V8v9LdA==} + + '@pagefind/darwin-arm64@1.5.2': + resolution: {integrity: sha512-MXpI+7HsAdPkvJ0gk9xj9g541BCqBZOBbdwj9g6lB5LCj6kSV6nqDSjzcAJwvOsfu0fjwvC8hQU+ecfhp+MpiQ==} + cpu: [arm64] + os: [darwin] + + '@pagefind/darwin-x64@1.5.2': + resolution: {integrity: sha512-IojxFWMEJe0RQ7PQ3KXQsPIImNsbpPYpoZ+QUDrL8fAl/O27IX+LVLs74/UzEZy5uA2LD8Nz1AiwKr72vrkZQw==} + cpu: [x64] + os: [darwin] + + '@pagefind/default-ui@1.5.2': + resolution: {integrity: sha512-pm1LMnQg8N2B3n2TnjKlhaFihpz6zTiA4HiGQ6/slKO/+8K9CAU5kcjdSSPgpuk1PMuuN4hxLipUIifnrkl3Sg==} + + '@pagefind/freebsd-x64@1.5.2': + resolution: {integrity: sha512-7EVzo9+0w+2cbe671BtMj10UlNo83I+HrLVLfRxO731svHRJKUfJ/mo05gU14pe9PCfpKNQT8FS3Xc/oDN6pOA==} + cpu: [x64] + os: [freebsd] + + '@pagefind/linux-arm64@1.5.2': + resolution: {integrity: sha512-Ovt9+K35sqzn8H3ZMXGwls4TD/wMJuvRtShHIsmUQREmaxjrDEX7gHckRCrwYJ4XE1H1p6HkLz3wukrAnsfXQw==} + cpu: [arm64] + os: [linux] + + '@pagefind/linux-x64@1.5.2': + resolution: {integrity: sha512-V+tFqHKXhQKq/WqPBD67AFy7scn1/aZID00ws4fSDd+1daSi5UHR9VVlRrOUYKxn3VuFQYRD7lYXdZK1WED1YA==} + cpu: [x64] + os: [linux] + + '@pagefind/windows-arm64@1.5.2': + resolution: {integrity: sha512-hN9Nh90fNW61nNRCW9ZyQrAj/mD0eRvmJ8NlTUzkbuW8kIzGJUi3cxjFkEcMZ5h/8FsKWD/VcouZl4yo1F7B6g==} + cpu: [arm64] + os: [win32] + + '@pagefind/windows-x64@1.5.2': + resolution: {integrity: sha512-Fa2Iyw7kaDRzGMfNYNUXNW2zbL5FQVDgSOcbDHdzBrDEdpqOqg8TcZ68F22ol6NJ9IGzvUdmeyZypLW5dyhqsg==} + cpu: [x64] + os: [win32] + + '@rolldown/binding-android-arm-eabi@1.2.8': + resolution: {integrity: sha512-tN5aztYkKCte4i5SIrrz5yK/HMjEuCqCSCJa418jOV8tZ1cBY3YF2otxB1ktPxzsLA1BeTqwapK0bfjxNvHJVw==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm] + os: [android] + + '@rolldown/binding-android-arm64@1.2.8': + resolution: {integrity: sha512-dIYTWl9XprMUiQFoc55KUyk/oS8SKYH3zFl0LTR7RT0Xj4hgSVyuJcroH8JUu8RcpF8fTB6E0aOwCkZoYPcDSQ==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [android] + + '@rolldown/binding-darwin-arm64@1.2.8': + resolution: {integrity: sha512-PCSDQGXD2IyTEFrcgPyBM8jJuGmrbCMuoIOXdbEGVemruKACXoLQJrb+A45Z0L5t1RQkdfJprAYPkikbh7dzdA==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [darwin] + + '@rolldown/binding-darwin-x64@1.2.8': + resolution: {integrity: sha512-Uk7lRsGhPFHVX/sAUC6D5H9Ol30dFHd6iquokll2th3LpdJ3F5CzQB+7DHn0Ri2mG+U7k2zXiPHDrwZenXhwSA==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [darwin] + + '@rolldown/binding-freebsd-x64@1.2.8': + resolution: {integrity: sha512-DjszaTEVogPqA5bYzsEeqDCQxbcp2fexQwKcRspYji2yzR68fCf+e4fx6kBSRDwX5/brZaHw/hWS9+A/+/w9sQ==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [freebsd] + + '@rolldown/binding-linux-arm-gnueabihf@1.2.8': + resolution: {integrity: sha512-zmwa7FTmdzB6aaEEuuls18H6Ap5JmJPSoPTuXixeJZV6tG40SyLkApQtz1g8ptZtiEKqj9OM0oNLPh1AgvE31Q==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm] + os: [linux] + + '@rolldown/binding-linux-arm64-gnu@1.2.8': + resolution: {integrity: sha512-KdYQDPHwJVnbFwdTGMgxsI9SqblBlz6STGM+w1We/d5B8OWWidYH0MwkU/uA1wM5fIpO2MkOVxXrNzzuZhw9ew==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [linux] + libc: [glibc] + + '@rolldown/binding-linux-arm64-musl@1.2.8': + resolution: {integrity: sha512-jFJTifHnNPY+yzOoNZQfSIysrVyXzEQPhPnOUjmD1bcQGHH6s7c8cViKWar8YplQImE5N9JRqMCLrM2CdxOrZA==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [linux] + libc: [musl] + + '@rolldown/binding-linux-ppc64-gnu@1.2.8': + resolution: {integrity: sha512-FhiOziBDWPBjbcmRzfLyIJnaP7AVMFXT7YCXPjXxj7wKU3vx24RjrCNN/zjvVa+N2vVoHJwCoUBvsrN/DG3zIA==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [ppc64] + os: [linux] + libc: [glibc] + + '@rolldown/binding-linux-s390x-gnu@1.2.8': + resolution: {integrity: sha512-WnHfADMzOV2Y55wlx1hzzQnar/wDt/VdvWSD99r18Mz9ylNieIGOkRx3UV21h7m/eJvjySYJkO26VvGNFkwsIQ==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [s390x] + os: [linux] + libc: [glibc] + + '@rolldown/binding-linux-x64-gnu@1.2.8': + resolution: {integrity: sha512-H9tRr5ibfXFVLxbPOseVewewFpl28zcEdjRDt2FTUZU7odxP0gEv1ki4/kGmcGOh78oRwZuuQllGLZ9zTJp84g==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [linux] + libc: [glibc] + + '@rolldown/binding-linux-x64-musl@1.2.8': + resolution: {integrity: sha512-UefiqfM3D6IVNlZ8tSGs9+Ejjud2T+oxO0IHADU45Y+lyEjD2dVFyZHbkfX0LUb5Zugo/oIv1eCO/KVYhgYJYA==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [linux] + libc: [musl] + + '@rolldown/binding-openharmony-arm64@1.2.8': + resolution: {integrity: sha512-637Ke4kWSy6rp9cxQ9gMOXlxPgIw/c1beASV4M//3+9I4uwBVOOl74G+e3zyU3u19U7RkRl/HuewixZ/Z6+Rjg==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [openharmony] + + '@rolldown/binding-win32-arm64-msvc@1.2.8': + resolution: {integrity: sha512-xWBkPOF1Q9k/Gv1nQXnVdLxKu74jXppuOM4Z3mnypVUJJJwLsMl7hNJGRAUJoG8A5MgOI1ACKM+wBFxSJzKy4A==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [win32] + + '@rolldown/binding-win32-x64-msvc@1.2.8': + resolution: {integrity: sha512-uz2ZvfgXbxqNwijjjbxrnvALwpyODDcgc1T1N8N3rf/DXKQmaFwmB4LX4yyjggpwN2obdQLb2rgirX5ffCWYng==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [win32] + + '@rolldown/pluginutils@1.0.1': + resolution: {integrity: sha512-2j9bGt5Jh8hj+vPtgzPtl72j0yRxHAyumoo6TNfAjsLB04UtpSvPbPcDcBMxz7n+9CYB0c1GxQFxYRg2jimqGw==} + + '@shikijs/core@4.4.3': + resolution: {integrity: sha512-QCR4q2ZO/ILJEuwiBMel4wdcTDb1JGwfjKTxPDF6x8ixOaluPrVqIn06C99AcRPhmYlBR56d/Fb+GN58GzExpg==} + engines: {node: '>=20'} + + '@shikijs/engine-javascript@4.4.3': + resolution: {integrity: sha512-FbOjFJp9VLdo1Wevs10BBtVxiTWwNLqZh5Gkhjgda/ioL15YOgeSl9n+6XMa3qRlPQzfhFNe641SrynFHYG0nQ==} + engines: {node: '>=20'} + + '@shikijs/engine-oniguruma@4.4.3': + resolution: {integrity: sha512-EcOQkxdxGQrc1Row/cC2c96/v1dbZqGnEVu1qTuT/MJmp6+cXCvQussowVmCv5Tqr3KuY3c7IbM6HTW3LJ1k9w==} + engines: {node: '>=20'} + + '@shikijs/langs@4.4.3': + resolution: {integrity: sha512-ePic0yfAJGOF83D5wBHK/00EjK65oahBYxFk5epgq33WRv7X9UuxLEV8PtR0szC0z8dl7INIpIodB99JRFlR+A==} + engines: {node: '>=20'} + + '@shikijs/primitive@4.4.3': + resolution: {integrity: sha512-m0wBeLDQDeIxRdUmrCPdQqfuUamDwRL5isCfYbguKD6NiaKpVbsv+3J81DyIKgNW5h4WAIIr8T4EkgQrBBxvaQ==} + engines: {node: '>=20'} + + '@shikijs/themes@4.4.3': + resolution: {integrity: sha512-w8UHjeUnIR965KMWJHUPXOc2mNJUnK3vpVLYLvw5IYU2mnTTJ89E24OrJDBNiJDQ0qzb0tc4l7mrIXx5cFeIyw==} + engines: {node: '>=20'} + + '@shikijs/types@4.4.3': + resolution: {integrity: sha512-UEJxmRR++MAGR6hugn0vgVS2W/6lWAts84FFSrnlH9sP0LNol7E5+NQ792pH8liWUhyMyjhTgSUH3k7iD7tc5g==} + engines: {node: '>=20'} + + '@shikijs/vscode-textmate@10.0.2': + resolution: {integrity: sha512-83yeghZ2xxin3Nj8z1NMd/NCuca+gsYXswywDy5bHvwlWL8tpTQmzGeUuHd9FC3E/SBEMvzJRwWEOz5gGes9Qg==} + + '@tybys/wasm-util@0.10.4': + resolution: {integrity: sha512-W3c4gRigFS0T/Ma4qIYF3GDAc5AQdHb1yL5znJT1Zv1YaD9Kitx656wBjvr19qbiosmZT8lWDM5BEMynUqX65A==} + + '@types/debug@4.1.13': + resolution: {integrity: sha512-KSVgmQmzMwPlmtljOomayoR89W4FynCAi3E8PPs7vmDVPe84hT+vGPKkJfThkmXs0x0jAaa9U8uW8bbfyS2fWw==} + + '@types/estree-jsx@1.0.5': + resolution: {integrity: sha512-52CcUVNFyfb1A2ALocQw/Dd1BQFNmSdkuC3BkZ6iqhdMfQz7JWOFRuJFloOzjk+6WijU56m9oKXFAXc7o3Towg==} + + '@types/estree@1.0.9': + resolution: {integrity: sha512-GhdPgy1el4/ImP05X05Uw4cw2/M93BCUmnEvWZNStlCzEKME4Fkk+YpoA5OiHNQmoS7Cafb8Xa3Pya8m1Qrzeg==} + + '@types/hast@3.0.5': + resolution: {integrity: sha512-rp/ezSWaD1m44dPKICGhiskI13nVr7qTloFwDa/IYkhhf5nzwP+zIQcIJh3WIFSBOy/H1PzB40jPjMDksN4F+g==} + + '@types/js-yaml@4.0.9': + resolution: {integrity: sha512-k4MGaQl5TGo/iipqb2UDG2UwjXziSWkh0uysQelTlJpX1qGlpUZYm8PnO4DxG1qBomtJUdYJ6qR6xdIah10JLg==} + + '@types/mdast@4.0.4': + resolution: {integrity: sha512-kGaNbPh1k7AFzgpud/gMdvIm5xuECykRR+JnWKQno9TAXVa6WIVCGTPvYGekIDL4uwCZQSYbUxNBSb1aUo79oA==} + + '@types/ms@2.1.0': + resolution: {integrity: sha512-GsCCIZDE/p3i96vtEqx+7dBUGXrc7zeSK3wwPHIaRThS+9OhWIXRqzs4d6k1SVU8g91DrNRWxWUGhp5KXQb2VA==} + + '@types/nlcst@2.0.3': + resolution: {integrity: sha512-vSYNSDe6Ix3q+6Z7ri9lyWqgGhJTmzRjZRqyq15N0Z/1/UnVsno9G/N40NBijoYx2seFDIl0+B2mgAb9mezUCA==} + + '@types/node@24.13.4': + resolution: {integrity: sha512-YJ7EqCstVTzIr0fMr7qul/977en+pQHrfmuKIo6Zr9i75Be21dr3MovcfvGtyvi2HAUrRerWps5sMO9I7WaxDw==} + + '@types/sax@1.2.7': + resolution: {integrity: sha512-rO73L89PJxeYM3s3pPPjiPgVVcymqU490g0YO5n5By0k2Erzj6tay/4lr1CHAAU4JyOWd1rpQ8bCf6cZfHU96A==} + + '@types/unist@2.0.11': + resolution: {integrity: sha512-CmBKiL6NNo/OqgmMn95Fk9Whlp2mtvIv+KNpQKN2F4SjvrEesubTRWGYSg+BnWZOnlCaSTU1sMpsBOzgbYhnsA==} + + '@types/unist@3.0.3': + resolution: {integrity: sha512-ko/gIFJRv177XgZsZcBwnqJN5x/Gien8qNOn0D5bQU/zAzVf9Zt3BlcUiLqhV9y4ARk0GbT3tnUiPNgnTXzc/Q==} + + '@ungap/structured-clone@1.4.0': + resolution: {integrity: sha512-1mEZtMKPM09vDmQt5y7YvmN2+DFTP7Tg0EWXdic8/C6VRnpb33e4ghisCIE3WZjsE2N8mf+QV1Zqh7ZFYLWInQ==} + + '@volar/kit@2.4.28': + resolution: {integrity: sha512-cKX4vK9dtZvDRaAzeoUdaAJEew6IdxHNCRrdp5Kvcl6zZOqb6jTOfk3kXkIkG3T7oTFXguEMt5+9ptyqYR84Pg==} + peerDependencies: + typescript: '*' + + '@volar/language-core@2.4.28': + resolution: {integrity: sha512-w4qhIJ8ZSitgLAkVay6AbcnC7gP3glYM3fYwKV3srj8m494E3xtrCv6E+bWviiK/8hs6e6t1ij1s2Endql7vzQ==} + + '@volar/language-server@2.4.28': + resolution: {integrity: sha512-NqcLnE5gERKuS4PUFwlhMxf6vqYo7hXtbMFbViXcbVkbZ905AIVWhnSo0ZNBC2V127H1/2zP7RvVOVnyITFfBw==} + + '@volar/language-service@2.4.28': + resolution: {integrity: sha512-Rh/wYCZJrI5vCwMk9xyw/Z+MsWxlJY1rmMZPsxUoJKfzIRjS/NF1NmnuEcrMbEVGja00aVpCsInJfixQTMdvLw==} + + '@volar/source-map@2.4.28': + resolution: {integrity: sha512-yX2BDBqJkRXfKw8my8VarTyjv48QwxdJtvRgUpNE5erCsgEUdI2DsLbpa+rOQVAJYshY99szEcRDmyHbF10ggQ==} + + '@volar/typescript@2.4.28': + resolution: {integrity: sha512-Ja6yvWrbis2QtN4ClAKreeUZPVYMARDYZl9LMEv1iQ1QdepB6wn0jTRxA9MftYmYa4DQ4k/DaSZpFPUfxl8giw==} + + '@vscode/emmet-helper@2.11.0': + resolution: {integrity: sha512-QLxjQR3imPZPQltfbWRnHU6JecWTF1QSWhx3GAKQpslx7y3Dp6sIIXhKjiUJ/BR9FX8PVthjr9PD6pNwOJfAzw==} + + '@vscode/l10n@0.0.18': + resolution: {integrity: sha512-KYSIHVmslkaCDyw013pphY+d7x1qV8IZupYfeIfzNA+nsaWHbn5uPuQRvdRFsa9zFzGeudPuoGoZ1Op4jrJXIQ==} + + ajv-draft-04@1.0.0: + resolution: {integrity: sha512-mv00Te6nmYbRp5DCwclxtt7yV/joXJPGS7nM+97GdxvuttCOfgI3K4U25zboyeX0O+myI8ERluxQe5wljMmVIw==} + peerDependencies: + ajv: ^8.5.0 + peerDependenciesMeta: + ajv: + optional: true + + ajv-i18n@4.2.0: + resolution: {integrity: sha512-v/ei2UkCEeuKNXh8RToiFsUclmU+G57LO1Oo22OagNMENIw+Yb8eMwvHu7Vn9fmkjJyv6XclhJ8TbuigSglPkg==} + peerDependencies: + ajv: ^8.0.0-beta.0 + + ajv@8.20.0: + resolution: {integrity: sha512-Thbli+OlOj+iMPYFBVBfJ3OmCAnaSyNn4M1vz9T6Gka5Jt9ba/HIR56joy65tY6kx/FCF5VXNB819Y7/GUrBGA==} + + am-i-vibing@0.4.0: + resolution: {integrity: sha512-MxT4XZL7pzLHpuvhDKdMaQHMGGkJDLluKBLsbstn+8wv9sWcFT6h+0ve9qkml95amVTZtZV83gQe2hY+ojgHLg==} + hasBin: true + + ansi-regex@6.3.0: + resolution: {integrity: sha512-WpDfL7NO6j7tH88IDBNVdUJxDh9nmCteAVW9dsep846XdwF4naCBK+/tGLX3KJgcpgMRXCFlTM2hKGoK9FsdrQ==} + engines: {node: '>=12'} + + ansi-styles@6.2.3: + resolution: {integrity: sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==} + engines: {node: '>=12'} + + anymatch@3.1.3: + resolution: {integrity: sha512-KMReFUr0B4t+D+OBkjR3KYqvocp2XaSzO55UcB6mgQMd3KbcE+mWTyvVV7D/zsdEbNnV6acZUutkiHQXvTr1Rw==} + engines: {node: '>= 8'} + + arg@5.0.2: + resolution: {integrity: sha512-PYjyFOLKQ9y57JvQ6QLo8dAgNqswh8M1RMJYdQduT6xbWSgK36P/Z/v+p888pM69jMMfS8Xd8F6I1kQ/I9HUGg==} + + argparse@2.0.1: + resolution: {integrity: sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==} + + aria-query@5.3.2: + resolution: {integrity: sha512-COROpnaoap1E2F000S62r6A60uHZnmlvomhfyT2DlTcrY1OrBKn2UhH7qn5wTC9zMvD0AY7csdPSNwKP+7WiQw==} + engines: {node: '>= 0.4'} + + astro-expressive-code@0.44.2: + resolution: {integrity: sha512-avop7nZcRwC7quvIxVguhwEZ9Tp6IoTzKUCLwP30Fb7+er+pWQgcysP01dcuzRIJo81kLGg30q/YAI2Yb1Sdzg==} + peerDependencies: + astro: ^4.0.0-beta || ^5.0.0-beta || ^3.3.0 || ^6.0.0-beta || ^7.0.0 + + astro@7.3.2: + resolution: {integrity: sha512-ysTcdpGP61XZpHoMRYC/CK19DQ94qkBvzXMtXEo0gEqPNkmOU/Tv++CtWmzaI4nF2Ck8RXFdiWvdlTWa2oOr9w==} + engines: {node: '>=22.12.0', npm: '>=9.6.5', pnpm: '>=7.1.0'} + hasBin: true + peerDependencies: + '@astrojs/markdown-remark': ^7.3.0 + peerDependenciesMeta: + '@astrojs/markdown-remark': + optional: true + + axobject-query@4.1.0: + resolution: {integrity: sha512-qIj0G9wZbMGNLjLmg1PT6v2mE9AH2zlnADJD/2tC6E00hgmhUOfEB6greHPAfLRSufHqROIUTkw6E+M3lH0PTQ==} + engines: {node: '>= 0.4'} + + bail@2.0.2: + resolution: {integrity: sha512-0xO6mYd7JB2YesxDKplafRpsiOzPt9V02ddPCLbY1xYGPOX24NTyN50qnUxgCPcSoYMhKpAuBTjQoRZCAkUDRw==} + + bcp-47-match@2.0.3: + resolution: {integrity: sha512-JtTezzbAibu8G0R9op9zb3vcWZd9JF6M0xOYGPn0fNCd7wOpRB1mU2mH9T8gaBGbAAyIIVgB2G7xG0GP98zMAQ==} + + bcp-47@2.1.1: + resolution: {integrity: sha512-KLw+H/gd2p4zly1X7Yh/qziuyae5/w/QFnvTng9eZL5fvszL7Whl3MBoWF8yxL7ksUjBfOD+OxkytiqbBpG+Fw==} + + boolbase@1.0.0: + resolution: {integrity: sha512-JZOSA7Mo9sNGB8+UjSgzdLtokWAky1zbztM3WRLCbZ70/3cTANmQmOdR7y2g+J0e2WXywy1yS468tY+IruqEww==} + + ccount@2.0.1: + resolution: {integrity: sha512-eyrF0jiFpY+3drT6383f1qhkbGsLSifNAjA61IUjZjmLCWjItY6LB9ft9YhoDgwfmclB2zhu51Lc7+95b8NRAg==} + + character-entities-html4@2.1.0: + resolution: {integrity: sha512-1v7fgQRj6hnSwFpq1Eu0ynr/CDEw0rXo2B61qXrLNdHZmPKgb7fqS1a2JwF0rISo9q77jDI8VMEHoApn8qDoZA==} + + character-entities-legacy@3.0.0: + resolution: {integrity: sha512-RpPp0asT/6ufRm//AJVwpViZbGM/MkjQFxJccQRHmISF/22NBtsHqAWmL+/pmkPWoIUJdWyeVleTl1wydHATVQ==} + + character-entities@2.0.2: + resolution: {integrity: sha512-shx7oQ0Awen/BRIdkjkvz54PnEEI/EjwXDSIZp86/KKdbafHh1Df/RYGBhn4hbe2+uKC9FnT5UCEdyPz3ai9hQ==} + + character-reference-invalid@2.0.1: + resolution: {integrity: sha512-iBZ4F4wRbyORVsu0jPV7gXkOsGYjGHPmAyv+HiHG8gi5PtC9KI2j1+v8/tlibRvjoWX027ypmG/n0HtO5t7unw==} + + chokidar@4.0.3: + resolution: {integrity: sha512-Qgzu8kfBvo+cA4962jnP1KkS6Dop5NS6g7R5LFYJr4b8Ub94PPQXUksCw9PvXoeXPRRddRNC5C1JQUR2SMGtnA==} + engines: {node: '>= 14.16.0'} + + chokidar@5.0.0: + resolution: {integrity: sha512-TQMmc3w+5AxjpL8iIiwebF73dRDF4fBIieAqGn9RGCWaEVwQ6Fb2cGe31Yns0RRIzii5goJ1Y7xbMwo1TxMplw==} + engines: {node: '>= 20.19.0'} + + ci-info@4.4.0: + resolution: {integrity: sha512-77PSwercCZU2Fc4sX94eF8k8Pxte6JAwL4/ICZLFjJLqegs7kCuAsqqj/70NQF6TvDpgFjkubQB2FW2ZZddvQg==} + engines: {node: '>=8'} + + cliui@9.0.1: + resolution: {integrity: sha512-k7ndgKhwoQveBL+/1tqGJYNz097I7WOvwbmmU2AR5+magtbjPWQTS1C5vzGkBC8Ym8UWRzfKUzUUqFLypY4Q+w==} + engines: {node: '>=20'} + + clsx@2.1.1: + resolution: {integrity: sha512-eYm0QWBtUrBWZWG0d386OGAw16Z995PiOVo2B7bjWSbHedGl5e0ZWaq65kOGgUSNesEIDkB9ISbTg/JK9dhCZA==} + engines: {node: '>=6'} + + comma-separated-tokens@2.0.3: + resolution: {integrity: sha512-Fu4hJdvzeylCfQPp9SGWidpzrMs7tTrlu6Vb8XGaRGck8QSNZJJp538Wrb60Lax4fPwR64ViY468OIUTbRlGZg==} + + commander@11.1.0: + resolution: {integrity: sha512-yPVavfyCcRhmorC7rWlkHn15b4wDVgVmBA7kV4QVBsF7kv/9TKJAbAXVTxvTnwP8HHKjRCJDClKbciiYS7p0DQ==} + engines: {node: '>=16'} + + common-ancestor-path@2.0.0: + resolution: {integrity: sha512-dnN3ibLeoRf2HNC+OlCiNc5d2zxbLJXOtiZUudNFSXZrNSydxcCsSpRzXwfu7BBWCIfHPw+xTayeBvJCP/D8Ng==} + engines: {node: '>= 18'} + + cookie-es@1.2.3: + resolution: {integrity: sha512-lXVyvUvrNXblMqzIRrxHb57UUVmqsSWlxqt3XIjCkUP0wDAf6uicO6KMbEgYrMNtEvWgWHwe42CKxPu9MYAnWw==} + + cookie@2.0.1: + resolution: {integrity: sha512-yuToqVvRrj6pfDXREyQAAv8SkAEk/8GS3jQRTiUMm66TVtBYmqQeoEjL2Lmq8Rpo6271vH76InTChTitEAm65w==} + engines: {node: '>=22'} + + crossws@0.3.5: + resolution: {integrity: sha512-ojKiDvcmByhwa8YYqbQI/hg7MEU0NC03+pSdEq4ZUnZR9xXpwk7E43SMNGkn+JxJGPFtNvQ48+vV2p+P1ml5PA==} + + css-select@6.0.0: + resolution: {integrity: sha512-rZZVSLle8v0+EY8QAkDWrKhpgt6SA5OtHsgBnsj6ZaLb5dmDVOWUDtQitd9ydxxvEjhewNudS6eTVU7uOyzvXw==} + + css-selector-parser@3.3.0: + resolution: {integrity: sha512-Y2asgMGFqJKF4fq4xHDSlFYIkeVfRsm69lQC1q9kbEsH5XtnINTMrweLkjYMeaUgiXBy/uvKeO/a1JHTNnmB2g==} + + css-tree@2.2.1: + resolution: {integrity: sha512-OA0mILzGc1kCOCSJerOeqDxDQ4HOh+G8NbOJFOTgOCzpw7fCBubk0fEyxp8AgOL/jvLgYA/uV0cMbe43ElF1JA==} + engines: {node: ^10 || ^12.20.0 || ^14.13.0 || >=15.0.0, npm: '>=7.0.0'} + + css-tree@3.2.1: + resolution: {integrity: sha512-X7sjQzceUhu1u7Y/ylrRZFU2FS6LRiFVp6rKLPg23y3x3c3DOKAwuXGDp+PAGjh6CSnCjYeAul8pcT8bAl+lSA==} + engines: {node: ^10 || ^12.20.0 || ^14.13.0 || >=15.0.0} + + css-what@7.0.0: + resolution: {integrity: sha512-wD5oz5xibMOPHzy13CyGmogB3phdvcDaB5t0W/Nr5Z2O/agcB8YwOz6e2Lsp10pNDzBoDO9nVa3RGs/2BttpHQ==} + engines: {node: '>= 6'} + + cssesc@3.0.0: + resolution: {integrity: sha512-/Tb/JcjK111nNScGob5MNtsntNM1aCNUDipB/TkwZFhyDrrE47SOx/18wF2bbjgc3ZzCSKW1T5nt5EbFoAz/Vg==} + engines: {node: '>=4'} + hasBin: true + + csso@5.0.5: + resolution: {integrity: sha512-0LrrStPOdJj+SPCCrGhzryycLjwcgUSHBtxNA8aIDxf0GLsRh1cKYhB00Gd1lDOS4yGH69+SNn13+TWbVHETFQ==} + engines: {node: ^10 || ^12.20.0 || ^14.13.0 || >=15.0.0, npm: '>=7.0.0'} + + debug@4.4.3: + resolution: {integrity: sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==} + engines: {node: '>=6.0'} + peerDependencies: + supports-color: '*' + peerDependenciesMeta: + supports-color: + optional: true + + decode-named-character-reference@1.3.0: + resolution: {integrity: sha512-GtpQYB283KrPp6nRw50q3U9/VfOutZOe103qlN7BPP6Ad27xYnOIWv4lPzo8HCAL+mMZofJ9KEy30fq6MfaK6Q==} + + defu@6.1.7: + resolution: {integrity: sha512-7z22QmUWiQ/2d0KkdYmANbRUVABpZ9SNYyH5vx6PZ+nE5bcC0l7uFvEfHlyld/HcGBFTL536ClDt3DEcSlEJAQ==} + + dequal@2.0.3: + resolution: {integrity: sha512-0je+qPKHEMohvfRTCEo3CrPG6cAzAYgmzKyxRiYSSDkS6eGJdyVJm7WaYA5ECaAD9wLB2T4EEeymA5aFVcYXCA==} + engines: {node: '>=6'} + + destr@2.0.5: + resolution: {integrity: sha512-ugFTXCtDZunbzasqBxrK93Ik/DRYsO6S/fedkWEMKqt04xZ4csmnmwGDBAb07QWNaGMAmnTIemsYZCksjATwsA==} + + detect-libc@2.1.2: + resolution: {integrity: sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==} + engines: {node: '>=8'} + + devalue@5.9.2: + resolution: {integrity: sha512-po4PAY5c53tw5XMocSnf8A/5OHhbbUftpr93aEN6BBoAdntUmK7vu7wOATqvt7cXO7m1Cl4gMVn6p7n6n4mj0w==} + + devlop@1.1.0: + resolution: {integrity: sha512-RWmIqhcFf1lRYBvNmr7qTNuyCt/7/ns2jbpp1+PalgE/rDQcBT0fioSMUpJ93irlUhC5hrg4cYqe6U+0ImW0rA==} + + diff@9.0.0: + resolution: {integrity: sha512-svtcdpS8CgJyqAjEQIXdb3OjhFVVYjzGAPO8WGCmRbrml64SPw/jJD4GoE98aR7r25A0XcgrK3F02yw9R/vhQw==} + engines: {node: '>=0.3.1'} + + direction@2.0.1: + resolution: {integrity: sha512-9S6m9Sukh1cZNknO1CWAr2QAWsbKLafQiyM5gZ7VgXHeuaoUwffKN4q6NC4A/Mf9iiPlOXQEKW/Mv/mh9/3YFA==} + hasBin: true + + dom-serializer@2.0.0: + resolution: {integrity: sha512-wIkAryiqt/nV5EQKqQpo3SToSOV9J0DnbJqwK7Wv/Trc92zIAYZ4FlMu+JPFW1DfGFt81ZTCGgDEabffXeLyJg==} + + domelementtype@2.3.0: + resolution: {integrity: sha512-OLETBj6w0OsagBwdXnPdN0cnMfF9opN69co+7ZrbfPGrdpPVNBUj02spi6B1N7wChLQiPn4CSH/zJvXw56gmHw==} + + domhandler@5.0.3: + resolution: {integrity: sha512-cgwlv/1iFQiFnU96XXgROh8xTeetsnJiDsTc7TYCLFd9+/WNkIqPTxiM/8pSd8VIrhXGTf1Ny1q1hquVqDJB5w==} + engines: {node: '>= 4'} + + domutils@3.2.2: + resolution: {integrity: sha512-6kZKyUajlDuqlHKVX1w7gyslj9MPIXzIFiz/rGu35uC1wMi+kMhQwGhl4lt9unC9Vb9INnY9Z3/ZA3+FhASLaw==} + + dset@3.1.4: + resolution: {integrity: sha512-2QF/g9/zTaPDc3BjNcVTGoBbXBgYfMTTceLaYcFJ/W9kggFUkhxD/hMEeuLKbugyef9SqAx8cpgwlIP/jinUTA==} + engines: {node: '>=4'} + + emmet@2.4.11: + resolution: {integrity: sha512-23QPJB3moh/U9sT4rQzGgeyyGIrcM+GH5uVYg2C6wZIxAIJq7Ng3QLT79tl8FUwDXhyq9SusfknOrofAKqvgyQ==} + + emoji-regex@10.6.0: + resolution: {integrity: sha512-toUI84YS5YmxW219erniWD0CIVOo46xGKColeNQRgOzDorgBi1v4D71/OFzgD9GO2UGKIv1C3Sp8DAn0+j5w7A==} + + entities@4.5.0: + resolution: {integrity: sha512-V0hjH4dGPh9Ao5p0MoRY6BVqtwCjhz6vI5LT8AJ55H+4g9/4vbHx1I54fS0XuclLhDHArPQCiMjDxjaL8fPxhw==} + engines: {node: '>=0.12'} + + es-module-lexer@2.3.2: + resolution: {integrity: sha512-poHGpORABojJJucnV9KbOavETW8lBVnphkW77ER5/BQ5Fz7oXSoCNek7IH3vR5nRjdsEz926ibFYX8KtLQmdyw==} + + esbuild@0.28.2: + resolution: {integrity: sha512-HKVLS8dvII+xoKW9kmqxbRKrnWEXfJJr/FZhhJmiqIB0e053QNYFqOBouTMO/k5sID4MvCiUCvv8b9M4h32wIA==} + engines: {node: '>=18'} + hasBin: true + + escalade@3.2.0: + resolution: {integrity: sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==} + engines: {node: '>=6'} + + eventemitter3@5.0.4: + resolution: {integrity: sha512-mlsTRyGaPBjPedk6Bvw+aqbsXDtoAyAzm5MO7JgU+yVRyMQ5O8bD4Kcci7BS85f93veegeCPkL8R4GLClnjLFw==} + + expressive-code@0.44.2: + resolution: {integrity: sha512-MLNghkvhyFgVW4oCD5DxBuYnnTXIf0PygzGmfT6OZeOOYWh/D4sH1j931biElkA5RG/J9wY/iuSMGAPF5vzHOg==} + + extend@3.0.2: + resolution: {integrity: sha512-fjquC59cD7CyW6urNXK0FBufkZcoiGG80wTuPujX590cB5Ttln20E2UB4S/WARVqhXffZl2LNgS+gQdPIIim/g==} + + fast-deep-equal@3.1.3: + resolution: {integrity: sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==} + + fast-string-truncated-width@3.0.3: + resolution: {integrity: sha512-0jjjIEL6+0jag3l2XWWizO64/aZVtpiGE3t0Zgqxv0DPuxiMjvB3M24fCyhZUO4KomJQPj3LTSUnDP3GpdwC0g==} + + fast-string-width@3.0.2: + resolution: {integrity: sha512-gX8LrtNEI5hq8DVUfRQMbr5lpaS4nMIWV+7XEbXk2b8kiQIizgnlr12B4dA3ZEx3308ze0O4Q1R+cHts8kyUJg==} + + fast-uri@3.1.8: + resolution: {integrity: sha512-GZMtZUTNRpOVIECoXwLNZS5xUGE+mVNbTB8h/7Rwh2TFWcBQiPzTgyZi05BF9UMZKkLJv8XBRJTlU7zg8+ZfMg==} + + fast-wrap-ansi@0.2.2: + resolution: {integrity: sha512-7F2Fl+TjRSenLqlU3UjSH0iyqopqoZIu7eZVpEirP2g1GtWa2G/ecEmBdgz31+Mxr+ELclgg6sokpSFIQiZ02Q==} + + fdir@6.5.0: + resolution: {integrity: sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==} + engines: {node: '>=12.0.0'} + peerDependencies: + picomatch: ^3 || ^4 + peerDependenciesMeta: + picomatch: + optional: true + + find-proc@0.1.0: + resolution: {integrity: sha512-OaOpEYv2PiQ7SQ5LIrl+deA1XaWcxEjnpM6VuWXTUvn+teIXxeFTLDmu18/zDQpFmHN4o3oDBX+BT0AGwEhemg==} + engines: {node: ^20.19.0 || >=22.12.0} + + flattie@1.1.1: + resolution: {integrity: sha512-9UbaD6XdAL97+k/n+N7JwX46K/M6Zc6KcFYskrYL8wbBV/Uyk0CTAMY0VT+qiK5PM7AIc9aTWYtq65U7T+aCNQ==} + engines: {node: '>=8'} + + fontace@0.4.1: + resolution: {integrity: sha512-lDMvbAzSnHmbYMTEld5qdtvNH2/pWpICOqpean9IgC7vUbUJc3k+k5Dokp85CegamqQpFbXf0rAVkbzpyTA8aw==} + + fontkitten@1.0.3: + resolution: {integrity: sha512-Wp1zXWPVUPBmfoa3Cqc9ctaKuzKAV6uLstRqlR56kSjplf5uAce+qeyYym7F+PHbGTk+tCEdkCW6RD7DX/gBZw==} + engines: {node: '>=20'} + + fsevents@2.3.3: + resolution: {integrity: sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==} + engines: {node: ^8.16.0 || ^10.6.0 || >=11.0.0} + os: [darwin] + + get-caller-file@2.0.5: + resolution: {integrity: sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==} + engines: {node: 6.* || 8.* || >= 10.*} + + get-east-asian-width@1.6.0: + resolution: {integrity: sha512-QRbvDIbx6YklUe6RxeTeleMR0yv3cYH6PsPZHcnVn7xv7zO1BHN8r0XETu8n6Ye3Q+ahtSarc3WgtNWmehIBfA==} + engines: {node: '>=18'} + + get-tsconfig@5.0.0-beta.4: + resolution: {integrity: sha512-7nF7C9fIPFEMHgEMEfgIlO9wDdZ8CyHw27rWciFZfHvHDReIiPhsYuzPRXsfvBCqFy1l8RRyyWV7QLM+ZhUJsQ==} + engines: {node: '>=20.20.0'} + + github-slugger@2.0.0: + resolution: {integrity: sha512-IaOQ9puYtjrkq7Y0Ygl9KDZnrf/aiUJYUpVf89y8kyaxbRG7Y1SrX/jaumrv81vc61+kiMempujsM3Yw7w5qcw==} + + h3@1.15.11: + resolution: {integrity: sha512-L3THSe2MPeBwgIZVSH5zLdBBU90TOxarvhK9d04IDY2AmVS8j2Jz2LIWtwsGOU3lu2I5jCN7FNvVfY2+XyF+mg==} + + hast-util-embedded@3.0.0: + resolution: {integrity: sha512-naH8sld4Pe2ep03qqULEtvYr7EjrLK2QHY8KJR6RJkTUjPGObe1vnx585uzem2hGra+s1q08DZZpfgDVYRbaXA==} + + hast-util-format@1.1.0: + resolution: {integrity: sha512-yY1UDz6bC9rDvCWHpx12aIBGRG7krurX0p0Fm6pT547LwDIZZiNr8a+IHDogorAdreULSEzP82Nlv5SZkHZcjA==} + + hast-util-has-property@3.0.0: + resolution: {integrity: sha512-MNilsvEKLFpV604hwfhVStK0usFY/QmM5zX16bo7EjnAEGofr5YyI37kzopBlZJkHD4t887i+q/C8/tr5Q94cA==} + + hast-util-is-body-ok-link@3.0.1: + resolution: {integrity: sha512-0qpnzOBLztXHbHQenVB8uNuxTnm/QBFUOmdOSsEn7GnBtyY07+ENTWVFBAnXd/zEgd9/SUG3lRY7hSIBWRgGpQ==} + + hast-util-is-element@3.0.0: + resolution: {integrity: sha512-Val9mnv2IWpLbNPqc/pUem+a7Ipj2aHacCwgNfTiK0vJKl0LF+4Ba4+v1oPHFpf3bLYmreq0/l3Gud9S5OH42g==} + + hast-util-minify-whitespace@1.0.1: + resolution: {integrity: sha512-L96fPOVpnclQE0xzdWb/D12VT5FabA7SnZOUMtL1DbXmYiHJMXZvFkIZfiMmTCNJHUeO2K9UYNXoVyfz+QHuOw==} + + hast-util-parse-selector@4.0.0: + resolution: {integrity: sha512-wkQCkSYoOGCRKERFWcxMVMOcYE2K1AaNLU8DXS9arxnLOUEWbOXKXiJUNzEpqZ3JOKpnha3jkFrumEjVliDe7A==} + + hast-util-phrasing@3.0.1: + resolution: {integrity: sha512-6h60VfI3uBQUxHqTyMymMZnEbNl1XmEGtOxxKYL7stY2o601COo62AWAYBQR9lZbYXYSBoxag8UpPRXK+9fqSQ==} + + hast-util-select@6.0.4: + resolution: {integrity: sha512-RqGS1ZgI0MwxLaKLDxjprynNzINEkRHY2i8ln4DDjgv9ZhcYVIHN9rlpiYsqtFwrgpYU361SyWDQcGNIBVu3lw==} + + hast-util-to-html@9.0.5: + resolution: {integrity: sha512-OguPdidb+fbHQSU4Q4ZiLKnzWo8Wwsf5bZfbvu7//a9oTYoqD/fWpe96NuHkoS9h0ccGOTe0C4NGXdtS0iObOw==} + + hast-util-to-string@3.0.1: + resolution: {integrity: sha512-XelQVTDWvqcl3axRfI0xSeoVKzyIFPwsAGSLIsKdJKQMXDYJS4WYrBNF/8J7RdhIcFI2BOHgAifggsvsxp/3+A==} + + hast-util-to-text@4.0.2: + resolution: {integrity: sha512-KK6y/BN8lbaq654j7JgBydev7wuNMcID54lkRav1P0CaE1e47P72AWWPiGKXTJU271ooYzcvTAn/Zt0REnvc7A==} + + hast-util-whitespace@3.0.0: + resolution: {integrity: sha512-88JUN06ipLwsnv+dVn+OIYOvAuvBMy/Qoi6O7mQHxdPXpjy+Cd6xRkWwux7DKO+4sYILtLBRIKgsdpS2gQc7qw==} + + hastscript@9.0.1: + resolution: {integrity: sha512-g7df9rMFX/SPi34tyGCyUBREQoKkapwdY/T04Qn9TDWfHhAYt4/I0gMVirzK5wEzeUqIjEB+LXC/ypb7Aqno5w==} + + html-escaper@3.0.3: + resolution: {integrity: sha512-RuMffC89BOWQoY0WKGpIhn5gX3iI54O6nRA0yC124NYVtzjmFWBIiFd8M0x+ZdX0P9R4lADg1mgP8C7PxGOWuQ==} + + html-void-elements@3.0.0: + resolution: {integrity: sha512-bEqo66MRXsUGxWHV5IP0PUiAWwoEjba4VCzg0LjFJBpchPaTfyfCKTG6bc5F8ucKec3q5y6qOdGyYTSBEvhCrg==} + + html-whitespace-sensitive-tag-names@3.0.1: + resolution: {integrity: sha512-q+310vW8zmymYHALr1da4HyXUQ0zgiIwIicEfotYPWGN0OJVEN/58IJ3A4GBYcEq3LGAZqKb+ugvP0GNB9CEAA==} + + http-cache-semantics@4.2.0: + resolution: {integrity: sha512-dTxcvPXqPvXBQpq5dUr6mEMJX4oIEFv6bwom3FDwKRDsuIjjJGANqhBuoAn9c1RQJIdAKav33ED65E2ys+87QQ==} + + i18next@26.4.2: + resolution: {integrity: sha512-RX+R0VLg13IbvRuJSxnqykUFS9vQZTl8wYpWPCIUDWVrSGjsQywB5Y+pjzrkboxGAuYfJZVH1InFTdgBdxq6ug==} + peerDependencies: + typescript: ^5 || ^6 || ^7 + peerDependenciesMeta: + typescript: + optional: true + + iron-webcrypto@1.2.1: + resolution: {integrity: sha512-feOM6FaSr6rEABp/eDfVseKyTMDt+KGpeB35SkVn9Tyn0CqvVsY3EwI0v5i8nMHyJnzCIQf7nsy3p41TPkJZhg==} + + is-alphabetical@2.0.1: + resolution: {integrity: sha512-FWyyY60MeTNyeSRpkM2Iry0G9hpr7/9kD40mD/cGQEuilcZYS4okz8SN2Q6rLCJ8gbCt6fN+rC+6tMGS99LaxQ==} + + is-alphanumerical@2.0.1: + resolution: {integrity: sha512-hmbYhX/9MUMF5uh7tOXyK/n0ZvWpad5caBA17GsC6vyuCqaWliRG5K1qS9inmUhEMaOBIW7/whAnSwveW/LtZw==} + + is-decimal@2.0.1: + resolution: {integrity: sha512-AAB9hiomQs5DXWcRB1rqsxGUstbRroFOPPVAomNk/3XHR5JyEZChOyTWe2oayKnsSsr/kcGqF+z6yuH6HHpN0A==} + + is-docker@4.0.0: + resolution: {integrity: sha512-LHE+wROyG/Y/0ZnbktRCoTix2c1RhgWaZraMZ8o1Q7zCh0VSrICJQO5oqIIISrcSBtrXv0o233w1IYwsWCjTzA==} + engines: {node: '>=20'} + hasBin: true + + is-hexadecimal@2.0.1: + resolution: {integrity: sha512-DgZQp241c8oO6cA1SbTEWiXeoxV42vlcJxgH+B3hi1AiqqKruZR3ZGF8In3fj4+/y/7rHvlOZLZtgJ/4ttYGZg==} + + is-plain-obj@4.1.0: + resolution: {integrity: sha512-+Pgi+vMuUNkJyExiMBt5IlFoMyKnr5zhJ4Uspz58WOhBF5QoIZkFyNHIbBAtHwzVAgk5RtndVNsDRN61/mmDqg==} + engines: {node: '>=12'} + + js-yaml@4.3.2: + resolution: {integrity: sha512-SFNOvSJ+Dgf/9An904Yx+CgSlIPCkIpao4qo51lpee25TIRejdH3rhR4EZMGoNx3/TP3O+wzWuiTFl4sqbltzA==} + hasBin: true + + json-schema-traverse@1.0.0: + resolution: {integrity: sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==} + + jsonc-parser@2.3.1: + resolution: {integrity: sha512-H8jvkz1O50L3dMZCsLqiuB2tA7muqbSg1AtGEkN0leAqGjsUzDJir3Zwr02BhqdcITPg3ei3mZ+HjMocAknhhg==} + + jsonc-parser@3.3.1: + resolution: {integrity: sha512-HUgH65KyejrUFPvHFPbqOY0rsFip3Bo5wb4ngvdi1EpCYWUQDC5V+Y7mZws+DLkr4M//zQJoanu1SP+87Dv1oQ==} + + kleur@4.1.5: + resolution: {integrity: sha512-o+NO+8WrRiQEE4/7nwRJhN1HWpVmJm511pBHUxPLtp0BUISzlBplORYSmTclCnJvQq2tKu/sgl3xVpkc7ZWuQQ==} + engines: {node: '>=6'} + + klona@2.0.6: + resolution: {integrity: sha512-dhG34DXATL5hSxJbIexCft8FChFXtmskoZYnoPWjXQuebWYCNkVeV3KkGegCK9CP1oswI/vQibS2GY7Em/sJJA==} + engines: {node: '>= 8'} + + lightningcss-android-arm64@1.33.0: + resolution: {integrity: sha512-gEpRTalKdosp4Bb8qWtc2iOgE5SeIHlpS1up9bFq2wAyYhl1UdTObYiHe98zEM9SQvSoqQZ1IQD0JNpg3Ml5pg==} + engines: {node: '>= 12.0.0'} + cpu: [arm64] + os: [android] + + lightningcss-darwin-arm64@1.33.0: + resolution: {integrity: sha512-Sciaz8eenNTKn9b3t7+xr0ipTp9YxKQY4npwQ3mrRuL0BAVHBLyZxofhaKBAVtzmtRZ/zTyo0/to4B1uWG/Djg==} + engines: {node: '>= 12.0.0'} + cpu: [arm64] + os: [darwin] + + lightningcss-darwin-x64@1.33.0: + resolution: {integrity: sha512-Z5UPAxzrjlWNNyGy6i65cJzzvgJ5D3T6wMvs+gWpY9d7qRhANrxqAp6LhxIgZhWEw18RfJTGcRxjuLIBr+m8XQ==} + engines: {node: '>= 12.0.0'} + cpu: [x64] + os: [darwin] + + lightningcss-freebsd-x64@1.33.0: + resolution: {integrity: sha512-QQM/Ti/hQajJwCY+RiWuCZ9sdtI/XQk7nDK5vC8kkdwixezOlDgvDx7+RT+QjK6FcFT4MpsuoBnHIo/O3StRRg==} + engines: {node: '>= 12.0.0'} + cpu: [x64] + os: [freebsd] + + lightningcss-linux-arm-gnueabihf@1.33.0: + resolution: {integrity: sha512-N7FVBe6iS24MlM6R/4RBTxGhQheZGs7tiQ9U32UtF75NzP5Q7xWPRqLBCKxlRQRk3rY1jCIPLzx7WzOhuUIRLQ==} + engines: {node: '>= 12.0.0'} + cpu: [arm] + os: [linux] + + lightningcss-linux-arm64-gnu@1.33.0: + resolution: {integrity: sha512-j2v/itmy4HlNxlc6voKXYgBqNi0Ng2LShg4z7GufpEgs05P+2suBVyi9I6YHq5uoVFx9ETin3eCEhLVyXGQnKg==} + engines: {node: '>= 12.0.0'} + cpu: [arm64] + os: [linux] + libc: [glibc] + + lightningcss-linux-arm64-musl@1.33.0: + resolution: {integrity: sha512-yiO5ROMuYQgXbC60yjZU5CYSFZGKXL0HFATXt9mHJn1+zW55oCtMI9NfcVhYLMFDL7gV7oBPon/EmMMGg2OvtQ==} + engines: {node: '>= 12.0.0'} + cpu: [arm64] + os: [linux] + libc: [musl] + + lightningcss-linux-x64-gnu@1.33.0: + resolution: {integrity: sha512-ar+Ju7LmcN0Jo4FpL4hpFybwNG9/3A/Br5KW2n2jyODg3MEZXaDYADdemoNS+BDNfMgKvylJLj4S5tyRActuAg==} + engines: {node: '>= 12.0.0'} + cpu: [x64] + os: [linux] + libc: [glibc] + + lightningcss-linux-x64-musl@1.33.0: + resolution: {integrity: sha512-RYiYbkokw0trfKqqzfF55lginwEPrD3OJDfTuJzFs1MK6iFnDenaz1fqLLtX4ITG3OktJQXOeTaw1awrBAlZPw==} + engines: {node: '>= 12.0.0'} + cpu: [x64] + os: [linux] + libc: [musl] + + lightningcss-win32-arm64-msvc@1.33.0: + resolution: {integrity: sha512-1K+MPfLSFVpphzpdbfkhlWk6wBrTObBzS2T6db10PNOZgR9GoVsAWzwNyuhUYYbTp23j+4RrncfujZ4uAzXvwA==} + engines: {node: '>= 12.0.0'} + cpu: [arm64] + os: [win32] + + lightningcss-win32-x64-msvc@1.33.0: + resolution: {integrity: sha512-OlEICDx/Xl0FqSp4bry8zFnCvGpig3Gl4gCquvYwHuqJKEC1+n9NgDniFvqHGmMv1ZkqDJrDqKKSykTDX+ehuA==} + engines: {node: '>= 12.0.0'} + cpu: [x64] + os: [win32] + + lightningcss@1.33.0: + resolution: {integrity: sha512-WkUDrojuJs0xkgGf2udWxa3yGBRxPtxUkB79i6aCZLRgc7PM8fZe9TosfPDcvEpQZbuFASnHYmRLBLUbmLOIIA==} + engines: {node: '>= 12.0.0'} + + longest-streak@3.1.0: + resolution: {integrity: sha512-9Ri+o0JYgehTaVBBDoMqIl8GXtbWg711O3srftcHhZ0dqnETqLaoIK0x17fUw9rFSlK/0NlsKe0Ahhyl5pXE2g==} + + lru-cache@11.5.2: + resolution: {integrity: sha512-4pfM1Ff0x50o0tQwb5ucw/RzNyD0/YJME6IVcStalZuMWxdt3sR3huStTtxz4PUmvZfRguvDejasvQ2kifR11g==} + engines: {node: 20 || >=22} + + magic-string@1.4.1: + resolution: {integrity: sha512-8lyCu36ErXR0J9uaGKlKQoiLZKmtI63YGLE8G2o9jyRPdr4X47LusSOwgOJOzcVtp81fTAAjxR7BwKz682Jhow==} + + magicast@0.5.5: + resolution: {integrity: sha512-UicdXN8zQ3JHlxVq+28afMXPr1z7WNY6+7EJnzTdQWkTAlMLF5fNCCKxJHBQwGaNGR11581EiQmQzx73+MvszA==} + + mdast-util-directive@3.1.0: + resolution: {integrity: sha512-I3fNFt+DHmpWCYAT7quoM6lHf9wuqtI+oCOfvILnoicNIqjh5E3dEJWiXuYME2gNe8vl1iMQwyUHa7bgFmak6Q==} + + mdast-util-from-markdown@2.0.3: + resolution: {integrity: sha512-W4mAWTvSlKvf8L6J+VN9yLSqQ9AOAAvHuoDAmPkz4dHf553m5gVj2ejadHJhoJmcmxEnOv6Pa8XJhpxE93kb8Q==} + + mdast-util-phrasing@4.1.0: + resolution: {integrity: sha512-TqICwyvJJpBwvGAMZjj4J2n0X8QWp21b9l0o7eXyVJ25YNWYbJDVIyD1bZXE6WtV6RmKJVYmQAKWa0zWOABz2w==} + + mdast-util-to-hast@13.2.1: + resolution: {integrity: sha512-cctsq2wp5vTsLIcaymblUriiTcZd0CwWtCbLvrOzYCDZoWyMNV8sZ7krj09FSnsiJi3WVsHLM4k6Dq/yaPyCXA==} + + mdast-util-to-markdown@2.1.2: + resolution: {integrity: sha512-xj68wMTvGXVOKonmog6LwyJKrYXZPvlwabaryTjLh9LuvovB/KAH+kvi8Gjj+7rJjsFi23nkUxRQv1KqSroMqA==} + + mdast-util-to-string@4.0.0: + resolution: {integrity: sha512-0H44vDimn51F0YwvxSJSm0eCDOJTRlmN0R1yBh4HLj9wiV1Dn0QoXGbvFAWj2hSItVTlCmBF1hqKlIyUBVFLPg==} + + mdn-data@2.0.28: + resolution: {integrity: sha512-aylIc7Z9y4yzHYAJNuESG3hfhC+0Ibp/MAMiaOZgNv4pmEdFyfZhhhny4MNiAfWdBQ1RQ2mfDWmM1x8SvGyp8g==} + + mdn-data@2.27.1: + resolution: {integrity: sha512-9Yubnt3e8A0OKwxYSXyhLymGW4sCufcLG6VdiDdUGVkPhpqLxlvP5vl1983gQjJl3tqbrM731mjaZaP68AgosQ==} + + micromark-core-commonmark@2.0.3: + resolution: {integrity: sha512-RDBrHEMSxVFLg6xvnXmb1Ayr2WzLAWjeSATAoxwKYJV94TeNavgoIdA0a9ytzDSVzBy2YKFK+emCPOEibLeCrg==} + + micromark-extension-directive@4.0.0: + resolution: {integrity: sha512-/C2nqVmXXmiseSSuCdItCMho7ybwwop6RrrRPk0KbOHW21JKoCldC+8rFOaundDoRBUWBnJJcxeA/Kvi34WQXg==} + + micromark-factory-destination@2.0.1: + resolution: {integrity: sha512-Xe6rDdJlkmbFRExpTOmRj9N3MaWmbAgdpSrBQvCFqhezUn4AHqJHbaEnfbVYYiexVSs//tqOdY/DxhjdCiJnIA==} + + micromark-factory-label@2.0.1: + resolution: {integrity: sha512-VFMekyQExqIW7xIChcXn4ok29YE3rnuyveW3wZQWWqF4Nv9Wk5rgJ99KzPvHjkmPXF93FXIbBp6YdW3t71/7Vg==} + + micromark-factory-space@2.0.1: + resolution: {integrity: sha512-zRkxjtBxxLd2Sc0d+fbnEunsTj46SWXgXciZmHq0kDYGnck/ZSGj9/wULTV95uoeYiK5hRXP2mJ98Uo4cq/LQg==} + + micromark-factory-title@2.0.1: + resolution: {integrity: sha512-5bZ+3CjhAd9eChYTHsjy6TGxpOFSKgKKJPJxr293jTbfry2KDoWkhBb6TcPVB4NmzaPhMs1Frm9AZH7OD4Cjzw==} + + micromark-factory-whitespace@2.0.1: + resolution: {integrity: sha512-Ob0nuZ3PKt/n0hORHyvoD9uZhr+Za8sFoP+OnMcnWK5lngSzALgQYKMr9RJVOWLqQYuyn6ulqGWSXdwf6F80lQ==} + + micromark-util-character@2.1.1: + resolution: {integrity: sha512-wv8tdUTJ3thSFFFJKtpYKOYiGP2+v96Hvk4Tu8KpCAsTMs6yi+nVmGh1syvSCsaxz45J6Jbw+9DD6g97+NV67Q==} + + micromark-util-chunked@2.0.1: + resolution: {integrity: sha512-QUNFEOPELfmvv+4xiNg2sRYeS/P84pTW0TCgP5zc9FpXetHY0ab7SxKyAQCNCc1eK0459uoLI1y5oO5Vc1dbhA==} + + micromark-util-classify-character@2.0.1: + resolution: {integrity: sha512-K0kHzM6afW/MbeWYWLjoHQv1sgg2Q9EccHEDzSkxiP/EaagNzCm7T/WMKZ3rjMbvIpvBiZgwR3dKMygtA4mG1Q==} + + micromark-util-combine-extensions@2.0.1: + resolution: {integrity: sha512-OnAnH8Ujmy59JcyZw8JSbK9cGpdVY44NKgSM7E9Eh7DiLS2E9RNQf0dONaGDzEG9yjEl5hcqeIsj4hfRkLH/Bg==} + + micromark-util-decode-numeric-character-reference@2.0.2: + resolution: {integrity: sha512-ccUbYk6CwVdkmCQMyr64dXz42EfHGkPQlBj5p7YVGzq8I7CtjXZJrubAYezf7Rp+bjPseiROqe7G6foFd+lEuw==} + + micromark-util-decode-string@2.0.1: + resolution: {integrity: sha512-nDV/77Fj6eH1ynwscYTOsbK7rR//Uj0bZXBwJZRfaLEJ1iGBR6kIfNmlNqaqJf649EP0F3NWNdeJi03elllNUQ==} + + micromark-util-encode@2.0.1: + resolution: {integrity: sha512-c3cVx2y4KqUnwopcO9b/SCdo2O67LwJJ/UyqGfbigahfegL9myoEFoDYZgkT7f36T0bLrM9hZTAaAyH+PCAXjw==} + + micromark-util-html-tag-name@2.0.1: + resolution: {integrity: sha512-2cNEiYDhCWKI+Gs9T0Tiysk136SnR13hhO8yW6BGNyhOC4qYFnwF1nKfD3HFAIXA5c45RrIG1ub11GiXeYd1xA==} + + micromark-util-normalize-identifier@2.0.1: + resolution: {integrity: sha512-sxPqmo70LyARJs0w2UclACPUUEqltCkJ6PhKdMIDuJ3gSf/Q+/GIe3WKl0Ijb/GyH9lOpUkRAO2wp0GVkLvS9Q==} + + micromark-util-resolve-all@2.0.1: + resolution: {integrity: sha512-VdQyxFWFT2/FGJgwQnJYbe1jjQoNTS4RjglmSjTUlpUMa95Htx9NHeYW4rGDJzbjvCsl9eLjMQwGeElsqmzcHg==} + + micromark-util-sanitize-uri@2.0.1: + resolution: {integrity: sha512-9N9IomZ/YuGGZZmQec1MbgxtlgougxTodVwDzzEouPKo3qFWvymFHWcnDi2vzV1ff6kas9ucW+o3yzJK9YB1AQ==} + + micromark-util-subtokenize@2.1.0: + resolution: {integrity: sha512-XQLu552iSctvnEcgXw6+Sx75GflAPNED1qx7eBJ+wydBb2KCbRZe+NwvIEEMM83uml1+2WSXpBAcp9IUCgCYWA==} + + micromark-util-symbol@2.0.1: + resolution: {integrity: sha512-vs5t8Apaud9N28kgCrRUdEed4UJ+wWNvicHLPxCa9ENlYuAY31M0ETy5y1vA33YoNPDFTghEbnh6efaE8h4x0Q==} + + micromark-util-types@2.0.2: + resolution: {integrity: sha512-Yw0ECSpJoViF1qTU4DC6NwtC4aWGt1EkzaQB8KPPyCRR8z9TWeV0HbEFGTO+ZY1wB22zmxnJqhPyTpOVCpeHTA==} + + micromark@4.0.2: + resolution: {integrity: sha512-zpe98Q6kvavpCr1NPVSCMebCKfD7CA2NqZ+rykeNhONIJBpc1tFKt9hucLGwha3jNTNI8lHpctWJWoimVF4PfA==} + + mrmime@2.0.1: + resolution: {integrity: sha512-Y3wQdFg2Va6etvQ5I82yUhGdsKrcYox6p7FfL1LbK2J4V01F9TGlepTIhnK24t7koZibmg82KGglhA1XK5IsLQ==} + engines: {node: '>=10'} + + ms@2.1.3: + resolution: {integrity: sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==} + + muggle-string@0.4.1: + resolution: {integrity: sha512-VNTrAak/KhO2i8dqqnqnAHOa3cYBwXEZe9h+D5h/1ZqFSTEFHdM65lR7RoIqq3tBBYavsOXV84NoHXZ0AkPyqQ==} + + nanoid@3.3.19: + resolution: {integrity: sha512-Y2tUNy4ouw6tq5oDSKeQYGOyhkUBhNOcGV/02KC+6kd9eDGqdZd++mjMiIDilrBYvjEnCYvVtsuHCuP+okSfug==} + engines: {node: ^10 || ^12 || ^13.7 || ^14 || >=15.0.1} + hasBin: true + + neotraverse@1.0.1: + resolution: {integrity: sha512-WmmLty1YWwJl9yZi77v2dVIV6X2kuYV8YYBI/G3LWGKdGHmHUvL1z7FW0iDvEvGAwNEoc5x1tOOOyDnf5jJw/w==} + engines: {node: '>= 10'} + + nlcst-to-string@4.0.0: + resolution: {integrity: sha512-YKLBCcUYKAg0FNlOBT6aI91qFmSiFKiluk655WzPF+DDMA02qIyy8uiRqI8QXtcFpEvll12LpL5MXqEmAZ+dcA==} + + node-fetch-native@1.6.7: + resolution: {integrity: sha512-g9yhqoedzIUm0nTnTqAQvueMPVOuIY16bqgAJJC8XOOubYFNwz6IER9qs0Gq2Xd0+CecCKFjtdDTMA4u4xG06Q==} + + node-mock-http@1.0.5: + resolution: {integrity: sha512-KQyt/wLjG3TAc7DOUhpqWzgd4ERxR80JOlTK5VE5R1S12IaPVN5qkj4klBce9HPG1Njuup4Sb5bljaT34lIyjw==} + + normalize-path@3.0.0: + resolution: {integrity: sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==} + engines: {node: '>=0.10.0'} + + nth-check@2.1.1: + resolution: {integrity: sha512-lqjrjmaOoAnWfMmBPL+XNnynZh2+swxiX3WUE0s4yEHI6m+AwrK2UZOimIRl3X/4QctVqS8AiZjFqyOGrMXb/w==} + + obug@2.2.1: + resolution: {integrity: sha512-XrsrhT5sybtKI6wakr2SPOlGZWWYbUXZ7a0jT8/QOeAPau+1X/bSegNe5YR75oJmEZQbKningirmGOEJCIk61Q==} + engines: {node: '>=12.20.0'} + + ofetch@1.5.1: + resolution: {integrity: sha512-2W4oUZlVaqAPAil6FUg/difl6YhqhUR7x2eZY4bQCko22UXg3hptq9KLQdqFClV+Wu85UX7hNtdGTngi/1BxcA==} + + ohash@2.0.12: + resolution: {integrity: sha512-65S/5gk9YSsaRjcyf7Nfa6h/d3E8/1gslpXfI4W7Dxn/oap8IKRuNT5VXkLQ1YFKIEg4apRY4Pj6aiwFzrDdmw==} + + oniguruma-parser@0.12.2: + resolution: {integrity: sha512-6HVa5oIrgMC6aA6WF6XyyqbhRPJrKR02L20+2+zpDtO5QAzGHAUGw5TKQvwi5vctNnRHkJYmjAhRVQF2EKdTQw==} + + oniguruma-to-es@4.3.6: + resolution: {integrity: sha512-csuQ9x3Yr0cEIs/Zgx/OEt9iBw9vqIunAPQkx19R/fiMq2oGVTgcMqO/V3Ybqefr1TBvosI6jU539ksaBULJyA==} + + p-limit@7.3.2: + resolution: {integrity: sha512-Ll0w3fU24vYpXoZmjjZIee6bJQDgG0oAyo1PdmFYI8UDwJJddaHAypxIH9avUu+t+lSsAwKVsb1jDCMIIChliw==} + engines: {node: '>=20'} + + p-queue@9.3.3: + resolution: {integrity: sha512-NXAOdnEe5FsZJfT4oK84lE1Y5cFFdWlRuOo5tww8DyNMxyRXwn39fIkUtNLKppcPC+UYU/bXujNCUGDv01y7CA==} + engines: {node: '>=20'} + + p-timeout@7.0.2: + resolution: {integrity: sha512-prbX4Z3YszrFNgH+MW5Zoeq3baXrMtP/MQnFeET90UB/GtGcGDQ5Usg9OCy6ETjTTntOw1SL2z9fMPUppN3Guw==} + engines: {node: '>=20'} + + package-manager-detector@1.8.0: + resolution: {integrity: sha512-yQA4H19AmPEoMUeavPMDIe1higySl/gH/yaQrkT/s07Qp+7pp2hYz30N3z2l5BkjVkF9Ow6o0wjJamm2y7Sn0A==} + + pagefind@1.5.2: + resolution: {integrity: sha512-XTUaK0hXMCu2jszWE584JGQT7y284TmMV9l/HX3rnG5uo3rHI/uHU56XTyyyPFjeWEBxECbAi0CaFDJOONtG0Q==} + hasBin: true + + parse-entities@4.0.2: + resolution: {integrity: sha512-GG2AQYWoLgL877gQIKeRPGO1xF9+eG1ujIb5soS5gPvLQ1y2o8FL90w2QWNdf9I361Mpp7726c+lj3U0qK1uGw==} + + path-browserify@1.0.1: + resolution: {integrity: sha512-b7uo2UCUOYZcnF/3ID0lulOJi/bafxa1xPe7ZPsammBSpjSWQkjNxlt635YGS2MiR9GjvuXCtz2emr3jbsz98g==} + + piccolore@0.1.3: + resolution: {integrity: sha512-o8bTeDWjE086iwKrROaDf31K0qC/BENdm15/uH9usSC/uZjJOKb2YGiVHfLY4GhwsERiPI1jmwI2XrA7ACOxVw==} + + picocolors@1.1.1: + resolution: {integrity: sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==} + + picomatch@2.3.2: + resolution: {integrity: sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA==} + engines: {node: '>=8.6'} + + picomatch@4.0.7: + resolution: {integrity: sha512-qcJu88Q2IWqJsDD529JKMdwGm/dvInW4HvQnRwiH9JtihJvzGOscDtHE3x1pBKeUOTysQ8kVmLnJ2kJu7yhcGA==} + engines: {node: '>=12'} + + postcss-nested@6.2.0: + resolution: {integrity: sha512-HQbt28KulC5AJzG+cZtj9kvKB93CFCdLvog1WFLf1D+xmMvPGlBstkpTEZfK5+AN9hfJocyBFCNiqyS48bpgzQ==} + engines: {node: '>=12.0'} + peerDependencies: + postcss: ^8.2.14 + + postcss-selector-parser@6.1.4: + resolution: {integrity: sha512-bIoJLOmjCO1S9XdY/DcnR5hJxvrDir1PbGChrzXG3vw0/FOliy/fA3dmdhQ441kah4gKv+TwckGzex6wNS5cnQ==} + engines: {node: '>=4'} + + postcss@8.5.28: + resolution: {integrity: sha512-RRuzqDtt5Y9h3quz5hWhK+TPnsmVs6WwSU6LkJMeY4HstUEDuYTG8UJSdawMRzmzAtV+KEoG8N3Qg2qLy5vM/A==} + engines: {node: ^10 || ^12 || >=14} + + prettier@3.9.6: + resolution: {integrity: sha512-OpN0zzVdiaiAhxpuuj5efpIS4sY9j7bY6uR5mnj5yPzGkdkjNKSJeUThPb60Jw29QuAZgA4o+/iB49kFiaBX6g==} + engines: {node: '>=14'} + hasBin: true + + prismjs@1.30.0: + resolution: {integrity: sha512-DEvV2ZF2r2/63V+tK8hQvrR2ZGn10srHbXviTlcv7Kpzw8jWiNTqbVgjO3IY8RxrrOUF8VPMQQFysYYYv0YZxw==} + engines: {node: '>=6'} + + process-ancestry@0.1.0: + resolution: {integrity: sha512-tGqJW/UnclpYASFcM6Xh8D8l/BMtaQ9+CSG0vlJSJTcdMM4lDRv4c6H0Pdcsfted+bVczdYSfk2fdukg2gQkZg==} + engines: {node: '>=18.0.0'} + + property-information@7.2.0: + resolution: {integrity: sha512-IAtzIB6sUiWaJYrX9smp3V46pBGbBeLFRGdh25kg1334VcBlD8HzhPeNIWQH9zhGmo2itIe25EHt9dQP7G5hmg==} + + radix3@1.1.2: + resolution: {integrity: sha512-b484I/7b8rDEdSDKckSSBA8knMpcdsXudlE/LNL639wFoHKwLbEkQFZHWEYwDC0wa0FKUcCY+GAF73Z7wxNVFA==} + + readdirp@4.1.2: + resolution: {integrity: sha512-GDhwkLfywWL2s6vEjyhri+eXmfH6j1L7JE27WhqLeYzoh/A3DBaYGEj2H/HFZCn/kMfim73FXxEJTw06WtxQwg==} + engines: {node: '>= 14.18.0'} + + readdirp@5.1.1: + resolution: {integrity: sha512-Kko+Y5XQ6fM+Ce3dq3m9YGxnacYZYl9cA1wZjaF3Vbry2L3i1qVg8+CAgNPsXRArPMUMCaOR7oa9Nqntc43JKA==} + engines: {node: '>= 20.19.0'} + + regex-recursion@6.0.2: + resolution: {integrity: sha512-0YCaSCq2VRIebiaUviZNs0cBz1kg5kVS2UKUfNIx8YVs1cN3AV7NTctO5FOKBA+UT2BPJIWZauYHPqJODG50cg==} + + regex-utilities@2.3.0: + resolution: {integrity: sha512-8VhliFJAWRaUiVvREIiW2NXXTmHs4vMNnSzuJVhscgmGav3g9VDxLrQndI3dZZVVdp0ZO/5v0xmX516/7M9cng==} + + regex@6.1.0: + resolution: {integrity: sha512-6VwtthbV4o/7+OaAF9I5L5V3llLEsoPyq9P1JVXkedTP33c7MfCG0/5NOPcSJn0TzXcG9YUrR0gQSWioew3LDg==} + + rehype-expressive-code@0.44.2: + resolution: {integrity: sha512-jvjQpsfWKBquDrEl5YQA3CJybRRIuDOYsui1BJTs5oKDUK8pPkJSSxY8FjxNlIFIdtgrTjC1zuahuY4Cc1j9SQ==} + + remark-directive@4.0.0: + resolution: {integrity: sha512-7sxn4RfF1o3izevPV1DheyGDD6X4c9hrGpfdUpm7uC++dqrnJxIZVkk7CoKqcLm0VUMAuOol7Mno3m6g8cfMuA==} + + request-light@0.5.8: + resolution: {integrity: sha512-3Zjgh+8b5fhRJBQZoy+zbVKpAQGLyka0MPgW3zruTF4dFFJ8Fqcfu9YsAvi/rvdcaTeWG3MkbZv4WKxAn/84Lg==} + + request-light@0.7.0: + resolution: {integrity: sha512-lMbBMrDoxgsyO+yB3sDcrDuX85yYt7sS8BfQd11jtbW/z5ZWgLZRcEGLsLoYw7I0WSUGQBs8CC8ScIxkTX1+6Q==} + + require-from-string@2.0.2: + resolution: {integrity: sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==} + engines: {node: '>=0.10.0'} + + resolve-pkg-maps@1.0.0: + resolution: {integrity: sha512-seS2Tj26TBVOC2NIc2rOe2y2ZO7efxITtLZcGSOnHHNOQ7CkiUBfw0Iw2ck6xkIhPwLhKNLS8BO+hEpngQlqzw==} + + retext-smartypants@6.2.0: + resolution: {integrity: sha512-kk0jOU7+zGv//kfjXEBjdIryL1Acl4i9XNkHxtM7Tm5lFiCog576fjNC9hjoR7LTKQ0DsPWy09JummSsH1uqfQ==} + + rolldown@1.2.8: + resolution: {integrity: sha512-Z67nTmhZe7anqnM/EjI392w5i/ANUinjip7QYsOyN37oayduxt3ksdX0hf5OOamkAd53BiIHfbfSzfUmzKFQqQ==} + engines: {node: ^20.19.0 || >=22.12.0} + hasBin: true + + satteri@0.10.5: + resolution: {integrity: sha512-Ao1LKpAEa9Wdg0otgbVKViZHEq9ebdXe4DMrp3s9vQAU0HNIuHnFEuMuOcm0ZIXyV0Yzxj91NvhLpvXZJO/5ZQ==} + + sax@1.6.1: + resolution: {integrity: sha512-42tBVwLWnaQvW5zc4HbZrTuWccECCZfBi92FDuwtqxasH+JbPB3/FOKb1m222K42R4WxuxzzMsTswfzgtSu64Q==} + engines: {node: '>=11.0.0'} + + semver@7.8.5: + resolution: {integrity: sha512-Y7/KDsb8LjooZpwaqGyulO6DQlksgCncchHGk+sZIY4SBvUocMBEFH5Ur1fI4dV+Jvl0w6cjvucaIi40puRioA==} + engines: {node: '>=10'} + hasBin: true + + sharp@0.35.4: + resolution: {integrity: sha512-n++8XWcj+jCOr2IOl7h8LbKnGBDY4aPbmprMONBNFdn0ImXqpGVv5zliDs0V9HbmbCQLpbuo2ej9rAoOQTvMDA==} + engines: {node: '>=20.9.0'} + peerDependencies: + '@types/node': '*' + peerDependenciesMeta: + '@types/node': + optional: true + + shiki@4.4.3: + resolution: {integrity: sha512-Mb/GvXPHBAXdgGIcnfU5L3ldpn1XcxrGkPHwqgRx17/I2XRfqlFKk2vGkHWINn1kdXvzJZeuO3is6I9KLPFm0g==} + engines: {node: '>=20'} + + sisteransi@1.0.5: + resolution: {integrity: sha512-bLGGlR1QxBcynn2d5YmDX4MGjlZvy2MRBDRNHLJ8VI6l6+9FUiyTFNJ0IveOSP0bcXgVDPRcfGqA0pjaqUpfVg==} + + sitemap@9.0.1: + resolution: {integrity: sha512-S6hzjGJSG3d6if0YoF5kTyeRJvia6FSTBroE5fQ0bu1QNxyJqhhinfUsXi9fH3MgtXODWvwo2BDyQSnhPQ88uQ==} + engines: {node: '>=20.19.5', npm: '>=10.8.2'} + hasBin: true + + smol-toml@1.8.0: + resolution: {integrity: sha512-kCZr2V3ch9i00x8zXRhjUNVcjG9ijES5dDudkXvUVCT5QlJNQWElSJdZqyPemffHoLNUYwOcou0Fy+ojN0uHSQ==} + engines: {node: '>= 18'} + + source-map-js@1.2.1: + resolution: {integrity: sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==} + engines: {node: '>=0.10.0'} + + space-separated-tokens@2.0.2: + resolution: {integrity: sha512-PEGlAwrG8yXGXRjW32fGbg66JAlOAwbObuqVoJpv/mRgoWDQfgH1wDPvtzWyUSNAXBGSk8h755YDbbcEy3SH2Q==} + + string-width@7.2.0: + resolution: {integrity: sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ==} + engines: {node: '>=18'} + + string-width@8.2.2: + resolution: {integrity: sha512-GaPUh5gfdrYzqeVNZvUfT23vYYxXzKYidUcnMtJg/3rxRV63EFZy3k6xfKlmfeJD0176lnUV/Usr3XcwSvFzpg==} + engines: {node: '>=20'} + + stringify-entities@4.0.4: + resolution: {integrity: sha512-IwfBptatlO+QCJUo19AqvrPNqlVMpW9YEL2LIVY+Rpv2qsjCGxaDLNRgeGsQWJhfItebuJhsGSLjaBbNSQ+ieg==} + + strip-ansi@7.2.0: + resolution: {integrity: sha512-yDPMNjp4WyfYBkHnjIRLfca1i6KMyGCtsVgoKe/z1+6vukgaENdgGBZt+ZmKPc4gavvEZ5OgHfHdrazhgNyG7w==} + engines: {node: '>=12'} + + svgo@4.1.0: + resolution: {integrity: sha512-bkxnTg1kSU0guhIBmibA6UUhrQmPVA1XsQLN+ylCd+UWzbnLkySOcXpyk1mrl05f+pcaCx2eHb+sp6BgMZWX+Q==} + engines: {node: '>=16'} + hasBin: true + + tiny-inflate@1.0.3: + resolution: {integrity: sha512-pkY1fj1cKHb2seWDy0B16HeWyczlJA9/WW3u3c4z/NiWDsO3DOU5D7nhTLE9CF0yXv/QZFY7sEJmj24dK+Rrqw==} + + tinyclip@0.1.15: + resolution: {integrity: sha512-uo33abH+Ays0xYaDysoBt494Hb3hsEczMpcC0MwFl773pazORx4fmvKhclhR1wonUbB6vvpRsvVMwnhfqeMc+A==} + engines: {node: ^16.14.0 || >= 17.3.0} + + tinyexec@1.3.1: + resolution: {integrity: sha512-GCvB3aoys96IuDFBMcTB46JOR6mdMtAToqwiW8JlWhsoh1mhHi/xn9ss/Dg7N555GiJyEt2qzoG/NHCwM6h1EA==} + engines: {node: '>=18'} + + tinyglobby@0.2.17: + resolution: {integrity: sha512-wXR/dYpcqKmfWpEdZjiKJOwCNFndD0DMnrW/cYjVGttEkBfVgcLFHoNrlj47mjOVic9yyNu65alsgF4NQyTa2g==} + engines: {node: '>=12.0.0'} + + trim-lines@3.0.1: + resolution: {integrity: sha512-kRj8B+YHZCc9kQYdWfJB2/oUl9rA99qbowYYBtr4ui4mZyAQ2JpvVBd/6U2YloATfqBhBTSMhTpgBHtU0Mf3Rg==} + + trough@2.2.0: + resolution: {integrity: sha512-tmMpK00BjZiUyVyvrBK7knerNgmgvcV/KLVyuma/SC+TQN167GrMRciANTz09+k3zW8L8t60jWO1GpfkZdjTaw==} + + tslib@2.8.1: + resolution: {integrity: sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==} + + typesafe-path@0.2.2: + resolution: {integrity: sha512-OJabfkAg1WLZSqJAJ0Z6Sdt3utnbzr/jh+NAHoyWHJe8CMSy79Gm085094M9nvTPy22KzTVn5Zq5mbapCI/hPA==} + + typescript-auto-import-cache@0.3.6: + resolution: {integrity: sha512-RpuHXrknHdVdK7wv/8ug3Fr0WNsNi5l5aB8MYYuXhq2UH5lnEB1htJ1smhtD5VeCsGr2p8mUDtd83LCQDFVgjQ==} + + typescript@5.9.3: + resolution: {integrity: sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==} + engines: {node: '>=14.17'} + hasBin: true + + ufo@1.6.4: + resolution: {integrity: sha512-JFNbkD1Svwe0KvGi8GOeLcP4kAWQ609twvCdcHxq1oSL8svv39ZuSvajcD8B+5D0eL4+s1Is2D/O6KN3qcTeRA==} + + ultrahtml@1.7.0: + resolution: {integrity: sha512-2xRd0VHoAQE4M+vF/DvFFB7pUV0ZxTW1TLi7lHQWnF/Sb5TPeEUV/l+hxcNnGO00ZXGnR0voCMmYRKQf+rvJ2g==} + + uncrypto@0.1.3: + resolution: {integrity: sha512-Ql87qFHB3s/De2ClA9e0gsnS6zXG27SkTiSJwjCc9MebbfapQfuPzumMIUMi38ezPZVNFcHI9sUIepeQfw8J8Q==} + + undici-types@7.18.2: + resolution: {integrity: sha512-AsuCzffGHJybSaRrmr5eHr81mwJU3kjw6M+uprWvCXiNeN9SOGwQ3Jn8jb8m3Z6izVgknn1R0FTCEAP2QrLY/w==} + + undici@8.10.2: + resolution: {integrity: sha512-/y4/bH9YNU5hi9NIrpOuvGXFcxrj3CMrV+/AYpowAYTpHn8gX/XPFjNy766FPoYY0miQhdW977JFWKGNhBdwyQ==} + engines: {node: '>=22.19.0'} + + unified@11.0.5: + resolution: {integrity: sha512-xKvGhPWw3k84Qjh8bI3ZeJjqnyadK+GEFtazSfZv/rKeTkTjOJho6mFqh2SM96iIcZokxiOpg78GazTSg8+KHA==} + + unifont@0.7.5: + resolution: {integrity: sha512-ULe/Cs+ZIsq+dcFofNkhqielCrUJnb5mr+Yc4EBM2VlL+6OZR6+cjtI2mT1bJvRBrVncqHAbLURxmPLcCXzWMg==} + + unist-util-find-after@5.0.0: + resolution: {integrity: sha512-amQa0Ep2m6hE2g72AugUItjbuM8X8cGQnFoHk0pGfrFeT9GZhzN5SW8nRsiGKK7Aif4CrACPENkA6P/Lw6fHGQ==} + + unist-util-is@6.0.1: + resolution: {integrity: sha512-LsiILbtBETkDz8I9p1dQ0uyRUWuaQzd/cuEeS1hoRSyW5E5XGmTzlwY1OrNzzakGowI9Dr/I8HVaw4hTtnxy8g==} + + unist-util-position@5.0.0: + resolution: {integrity: sha512-fucsC7HjXvkB5R3kTCO7kUjRdrS0BJt3M/FPxmHMBOm8JQi2BsHAHFsy27E0EolP8rp0NzXsJ+jNPyDWvOJZPA==} + + unist-util-stringify-position@4.0.0: + resolution: {integrity: sha512-0ASV06AAoKCDkS2+xw5RXJywruurpbC4JZSm7nr7MOt1ojAzvyyaO+UxZf18j8FCF6kmzCZKcAgN/yu2gm2XgQ==} + + unist-util-visit-parents@6.0.2: + resolution: {integrity: sha512-goh1s1TBrqSqukSc8wrjwWhL0hiJxgA8m4kFxGlQ+8FYQ3C/m11FcTs4YYem7V664AhHVvgoQLk890Ssdsr2IQ==} + + unist-util-visit@5.1.0: + resolution: {integrity: sha512-m+vIdyeCOpdr/QeQCu2EzxX/ohgS8KbnPDgFni4dQsfSCtpz8UqDyY5GjRru8PDKuYn7Fq19j1CQ+nJSsGKOzg==} + + unstorage@1.17.5: + resolution: {integrity: sha512-0i3iqvRfx29hkNntHyQvJTpf5W9dQ9ZadSoRU8+xVlhVtT7jAX57fazYO9EHvcRCfBCyi5YRya7XCDOsbTgkPg==} + peerDependencies: + '@azure/app-configuration': ^1.8.0 + '@azure/cosmos': ^4.2.0 + '@azure/data-tables': ^13.3.0 + '@azure/identity': ^4.6.0 + '@azure/keyvault-secrets': ^4.9.0 + '@azure/storage-blob': ^12.26.0 + '@capacitor/preferences': ^6 || ^7 || ^8 + '@deno/kv': '>=0.9.0' + '@netlify/blobs': ^6.5.0 || ^7.0.0 || ^8.1.0 || ^9.0.0 || ^10.0.0 + '@planetscale/database': ^1.19.0 + '@upstash/redis': ^1.34.3 + '@vercel/blob': '>=0.27.1' + '@vercel/functions': ^2.2.12 || ^3.0.0 + '@vercel/kv': ^1 || ^2 || ^3 + aws4fetch: ^1.0.20 + db0: '>=0.2.1' + idb-keyval: ^6.2.1 + ioredis: ^5.4.2 + uploadthing: ^7.4.4 + peerDependenciesMeta: + '@azure/app-configuration': + optional: true + '@azure/cosmos': + optional: true + '@azure/data-tables': + optional: true + '@azure/identity': + optional: true + '@azure/keyvault-secrets': + optional: true + '@azure/storage-blob': + optional: true + '@capacitor/preferences': + optional: true + '@deno/kv': + optional: true + '@netlify/blobs': + optional: true + '@planetscale/database': + optional: true + '@upstash/redis': + optional: true + '@vercel/blob': + optional: true + '@vercel/functions': + optional: true + '@vercel/kv': + optional: true + aws4fetch: + optional: true + db0: + optional: true + idb-keyval: + optional: true + ioredis: + optional: true + uploadthing: + optional: true + + url-extras@0.1.0: + resolution: {integrity: sha512-8tzwTeXFPuX/5PHuCDQE5Dd9Ts4rwoq2t9aIT+HS4iAVpmj5l4Ao7Q+BuuFjvWRqrLswBhQDk8O96ZicgCqQqw==} + engines: {node: '>=20'} + + util-deprecate@1.0.2: + resolution: {integrity: sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==} + + vfile-message@4.0.3: + resolution: {integrity: sha512-QTHzsGd1EhbZs4AsQ20JX1rC3cOlt/IWJruk893DfLRr57lcnOeMaWG4K0JrRta4mIJZKth2Au3mM3u03/JWKw==} + + vfile@6.0.3: + resolution: {integrity: sha512-KzIbH/9tXat2u30jf+smMwFCsno4wHVdNmzFyL+T/L3UGqqk6JKfVqOFOZEpZSHADH1k40ab6NUIXZq422ov3Q==} + + vite@8.3.0: + resolution: {integrity: sha512-lhZBVvEHefgE+HQZC9O7EBJgCU/nVzFNl7vkS4RE0APtWLP02/8QVIkQtzBxPquh7lq5/78NHipTj7ODQ6XuyQ==} + engines: {node: ^20.19.0 || >=22.12.0} + hasBin: true + peerDependencies: + '@types/node': ^20.19.0 || >=22.12.0 + '@vitejs/devtools': ^0.7.1 + esbuild: ^0.27.0 || ^0.28.0 + jiti: '>=1.21.0' + less: ^4.0.0 + sass: ^1.70.0 + sass-embedded: ^1.70.0 + stylus: '>=0.54.8' + sugarss: ^5.0.0 + terser: ^5.16.0 + tsx: ^4.8.1 + yaml: ^2.4.2 + peerDependenciesMeta: + '@types/node': + optional: true + '@vitejs/devtools': + optional: true + esbuild: + optional: true + jiti: + optional: true + less: + optional: true + sass: + optional: true + sass-embedded: + optional: true + stylus: + optional: true + sugarss: + optional: true + terser: + optional: true + tsx: + optional: true + yaml: + optional: true + + vitefu@1.1.3: + resolution: {integrity: sha512-ub4okH7Z5KLjb6hDyjqrGXqWtWvoYdU3IGm/NorpgHncKoLTCfRIbvlhBm7r0YstIaQRYlp4yEbFqDcKSzXSSg==} + peerDependencies: + vite: ^3.0.0 || ^4.0.0 || ^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0 + peerDependenciesMeta: + vite: + optional: true + + volar-service-css@0.0.71: + resolution: {integrity: sha512-wRRFt9BpjMKCazcgOh67MSjUjiWUCAh99DyYSDIOTuxaRjEtDC7PpB0k1Y1wbJIW/pVtMUSVbpPo3UGSm0Byxw==} + peerDependencies: + '@volar/language-service': ~2.4.0 + peerDependenciesMeta: + '@volar/language-service': + optional: true + + volar-service-emmet@0.0.71: + resolution: {integrity: sha512-zqjzt6bN95e3CUstBm0PBFAJnrfz0ZAARka87fart46/gNCLLuP3Vujy8V/J8HEziTFLnfkgIASLFYPUhonJcA==} + peerDependencies: + '@volar/language-service': ~2.4.0 + peerDependenciesMeta: + '@volar/language-service': + optional: true + + volar-service-html@0.0.71: + resolution: {integrity: sha512-e8tHPhgQ7ooLfudAEIku+kgd9pWkq3SSz8RbnQDI1+Eb8wbenkLGHqoirLqz5ORLV6wIMr2Iv08RWBG5eOcgpw==} + peerDependencies: + '@volar/language-service': ~2.4.0 + peerDependenciesMeta: + '@volar/language-service': + optional: true + + volar-service-prettier@0.0.71: + resolution: {integrity: sha512-Rz7JVH3qD108UCdmIEiZvOBNljMt2nLFdbN8AXcDfn7xD9F5I2aCIsDVqBbXw21PsnxG0b7MfwtNF+zPS/NKUg==} + peerDependencies: + '@volar/language-service': ~2.4.0 + prettier: ^2.2 || ^3.0 + peerDependenciesMeta: + '@volar/language-service': + optional: true + prettier: + optional: true + + volar-service-typescript-twoslash-queries@0.0.71: + resolution: {integrity: sha512-9K2k72s4n7rV9s4bX0MyjbX9iBribvKZbBJKuEmTCZfeWJXs6Yh7bGpY4eoc7UufAjvpheBqwyZCOIPBvxCv0A==} + peerDependencies: + '@volar/language-service': ~2.4.0 + peerDependenciesMeta: + '@volar/language-service': + optional: true + + volar-service-typescript@0.0.71: + resolution: {integrity: sha512-yTtM/BVT6hoyEYnDtaCyAtNhdNeS/mhTTABlBOdw3NNiRBUin3IznFJpgfjer4c6RYopiPjjQjc9VFhxVl1mLw==} + peerDependencies: + '@volar/language-service': ~2.4.0 + peerDependenciesMeta: + '@volar/language-service': + optional: true + + volar-service-yaml@0.0.71: + resolution: {integrity: sha512-qYGWGuVpUTnZGu5P/CR4KLK4aIR8RrcVnmfZ2eRcj9q/I8VZCoC5yy9FtEvfNvnDp4MU17yhdJcvpQPIqhJS2Q==} + peerDependencies: + '@volar/language-service': ~2.4.0 + peerDependenciesMeta: + '@volar/language-service': + optional: true + + vscode-css-languageservice@6.3.10: + resolution: {integrity: sha512-eq5N9Er3fC4vA9zd9EFhyBG90wtCCuXgRSpAndaOgXMh1Wgep5lBgRIeDgjZBW9pa+332yC9+49cZMW8jcL3MA==} + + vscode-html-languageservice@5.6.2: + resolution: {integrity: sha512-ulCrSnFnfQ16YzvwnYUgEbUEl/ZG7u2eV27YhvLObSHKkb8fw1Z9cgsnUwjTEeDIdJDoTDTDpxuhQwoenoLNMg==} + + vscode-json-languageservice@4.1.8: + resolution: {integrity: sha512-0vSpg6Xd9hfV+eZAaYN63xVVMOTmJ4GgHxXnkLCh+9RsQBkWKIghzLhW2B9ebfG+LQQg8uLtsQ2aUKjTgE+QOg==} + engines: {npm: '>=7.0.0'} + + vscode-jsonrpc@8.2.0: + resolution: {integrity: sha512-C+r0eKJUIfiDIfwJhria30+TYWPtuHJXHtI7J0YlOmKAo7ogxP20T0zxB7HZQIFhIyvoBPwWskjxrvAtfjyZfA==} + engines: {node: '>=14.0.0'} + + vscode-jsonrpc@9.0.2: + resolution: {integrity: sha512-SbQSV9yRemARxeXw6LU5sS6Zq0e9/DgCCX5yelH263ZQWukbTk8EF8fjTrr1dziasf4GwlJbvTwFnTrnQFWZXQ==} + engines: {node: '>=14.0.0'} + + vscode-languageserver-protocol@3.17.5: + resolution: {integrity: sha512-mb1bvRJN8SVznADSGWM9u/b07H7Ecg0I3OgXDuLdn307rl/J3A9YD6/eYOssqhecL27hK1IPZAsaqh00i/Jljg==} + + vscode-languageserver-protocol@3.18.3: + resolution: {integrity: sha512-DF49+WeV5py4zO5hhobp60jjsDSK0lAqA0OuKBLBvp423HPWQcCbhZz3JgyfIewsEz2f8U+X75xNIFHdiXZm2w==} + + vscode-languageserver-textdocument@1.0.14: + resolution: {integrity: sha512-EQyqJMi552E4ZTf46izQ4Fj6XquqxCySR3J5ZSD1SisMf6RfpeOWHxGBE8Gr6V0/3GHIGdAzDn8F8+1nTGCnoQ==} + + vscode-languageserver-types@3.17.5: + resolution: {integrity: sha512-Ld1VelNuX9pdF39h2Hgaeb5hEZM2Z3jUrrMgWQAu82jMtZp7p3vJT3BzToKtZI7NgQssZje5o0zryOrhQvzQAg==} + + vscode-languageserver-types@3.18.3: + resolution: {integrity: sha512-XIlzJ7Qp/jzSI1ds7/FwPAWrPeTZA7pAtlW4hdJ1J6xXWJL6dR9QYnDhJOdLzdKhUQ5Mm6mvUMw+3DcOQQasPw==} + + vscode-languageserver@9.0.1: + resolution: {integrity: sha512-woByF3PDpkHFUreUa7Hos7+pUWdeWMXRd26+ZX2A8cFx6v/JPTtd4/uN0/jB6XQHYaOlHbio03NTHCqrgG5n7g==} + hasBin: true + + vscode-nls@5.2.0: + resolution: {integrity: sha512-RAaHx7B14ZU04EU31pT+rKz2/zSl7xMsfIZuo8pd+KZO6PXtQmpevpq3vxvWNcrGbdmhM/rr5Uw5Mz+NBfhVng==} + + vscode-uri@3.2.0: + resolution: {integrity: sha512-m2gXo3bn0G1kT9InzMf07fTbqMbGtyckj3bH5ktLO+1Ssv+yiATZ4dhwaQv9UZWxJh6E9IFGnQyjgWVDWVBDrg==} + + wrap-ansi@9.0.2: + resolution: {integrity: sha512-42AtmgqjV+X1VpdOfyTGOYRi0/zsoLqtXQckTmqTeybT+BDIbM/Guxo7x3pE2vtpr1ok6xRqM9OpBe+Jyoqyww==} + engines: {node: '>=18'} + + xxhash-wasm@1.1.0: + resolution: {integrity: sha512-147y/6YNh+tlp6nd/2pWq38i9h6mz/EuQ6njIrmW8D1BS5nCqs0P6DG+m6zTGnNz5I+uhZ0SHxBs9BsPrwcKDA==} + + y18n@5.0.8: + resolution: {integrity: sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==} + engines: {node: '>=10'} + + yaml-language-server@1.23.0: + resolution: {integrity: sha512-3qVyCOexLCWw06PQa5kRPwvMWMZ/eZeCRWUvgD6a0OkqL/4iCnxy2WumbWifa937Uo5xhyWJ0uxlU39ljhNh7A==} + hasBin: true + + yaml@2.8.3: + resolution: {integrity: sha512-AvbaCLOO2Otw/lW5bmh9d/WEdcDFdQp2Z2ZUH3pX9U2ihyUY0nvLv7J6TrWowklRGPYbB/IuIMfYgxaCPg5Bpg==} + engines: {node: '>= 14.6'} + hasBin: true + + yaml@2.9.1: + resolution: {integrity: sha512-3NxN8+78OdzbT7C/WjGsyfPAtJaN3FNDsWxv7Y7mcDsT/oOmgW8BpyQQFFBnvZE3j9Y2Sdz1ULFLezL7Eb2yFw==} + engines: {node: '>= 14.6'} + hasBin: true + + yargs-parser@22.0.0: + resolution: {integrity: sha512-rwu/ClNdSMpkSrUb+d6BRsSkLUq1fmfsY6TOpYzTwvwkg1/NRG85KBy3kq++A8LKQwX6lsu+aWad+2khvuXrqw==} + engines: {node: ^20.19.0 || ^22.12.0 || >=23} + + yargs@18.1.0: + resolution: {integrity: sha512-2rAgRKu54VsHkqI0/tYkmluGXHD4KW7yZoycuqDQ15QOTnc2VVfy0nN/1eMhnQLO00A+dwtK20xuCnc1YGeUyg==} + engines: {node: ^20.19.0 || ^22.12.0 || >=23} + + yocto-queue@1.2.2: + resolution: {integrity: sha512-4LCcse/U2MHZ63HAJVE+v71o7yOdIe4cZ70Wpf8D/IyjDKYQLV5GD46B+hSTjJsvV5PztjvHoU580EftxjDZFQ==} + engines: {node: '>=12.20'} + + zod@4.6.5: + resolution: {integrity: sha512-v5l/aFXZQeai4awLbOpSoHecE9UiMrnfx75tEXLjNonXVARxQ5mOeipTjROUchszUNCqnE+hqAMujRsRHsut2Q==} + + zwitch@2.0.4: + resolution: {integrity: sha512-bXE4cR/kVZhKZX/RjPEflHaKVhUVl85noU3v6b8apfQEc1x4A+zBxjZ4lN8LqGd6WZ3dl98pY4o717VFmoPp+A==} + +snapshots: + + '@astrojs/check@0.9.10(prettier@3.9.6)(typescript@5.9.3)': + dependencies: + '@astrojs/language-server': 2.16.16(prettier@3.9.6)(typescript@5.9.3) + chokidar: 4.0.3 + kleur: 4.1.5 + typescript: 5.9.3 + yargs: 18.1.0 + transitivePeerDependencies: + - prettier + - prettier-plugin-astro + + '@astrojs/compiler-binding-android-arm64@0.4.1': + optional: true + + '@astrojs/compiler-binding-darwin-arm64@0.4.1': + optional: true + + '@astrojs/compiler-binding-darwin-x64@0.4.1': + optional: true + + '@astrojs/compiler-binding-linux-arm64-gnu@0.4.1': + optional: true + + '@astrojs/compiler-binding-linux-arm64-musl@0.4.1': + optional: true + + '@astrojs/compiler-binding-linux-x64-gnu@0.4.1': + optional: true + + '@astrojs/compiler-binding-linux-x64-musl@0.4.1': + optional: true + + '@astrojs/compiler-binding-wasm32-wasi@0.4.1(@emnapi/core@1.11.1)(@emnapi/runtime@1.11.3)': + dependencies: + '@napi-rs/wasm-runtime': 1.2.4(@emnapi/core@1.11.1)(@emnapi/runtime@1.11.3) + transitivePeerDependencies: + - '@emnapi/core' + - '@emnapi/runtime' + optional: true + + '@astrojs/compiler-binding-win32-arm64-msvc@0.4.1': + optional: true + + '@astrojs/compiler-binding-win32-x64-msvc@0.4.1': + optional: true + + '@astrojs/compiler-binding@0.4.1(@emnapi/core@1.11.1)(@emnapi/runtime@1.11.3)': + optionalDependencies: + '@astrojs/compiler-binding-android-arm64': 0.4.1 + '@astrojs/compiler-binding-darwin-arm64': 0.4.1 + '@astrojs/compiler-binding-darwin-x64': 0.4.1 + '@astrojs/compiler-binding-linux-arm64-gnu': 0.4.1 + '@astrojs/compiler-binding-linux-arm64-musl': 0.4.1 + '@astrojs/compiler-binding-linux-x64-gnu': 0.4.1 + '@astrojs/compiler-binding-linux-x64-musl': 0.4.1 + '@astrojs/compiler-binding-wasm32-wasi': 0.4.1(@emnapi/core@1.11.1)(@emnapi/runtime@1.11.3) + '@astrojs/compiler-binding-win32-arm64-msvc': 0.4.1 + '@astrojs/compiler-binding-win32-x64-msvc': 0.4.1 + transitivePeerDependencies: + - '@emnapi/core' + - '@emnapi/runtime' + + '@astrojs/compiler-rs@0.4.1(@emnapi/core@1.11.1)(@emnapi/runtime@1.11.3)': + dependencies: + '@astrojs/compiler-binding': 0.4.1(@emnapi/core@1.11.1)(@emnapi/runtime@1.11.3) + transitivePeerDependencies: + - '@emnapi/core' + - '@emnapi/runtime' + + '@astrojs/compiler@2.13.1': {} + + '@astrojs/internal-helpers@0.11.0': + dependencies: + '@types/hast': 3.0.5 + '@types/mdast': 4.0.4 + js-yaml: 4.3.2 + picomatch: 4.0.7 + retext-smartypants: 6.2.0 + shiki: 4.4.3 + smol-toml: 1.8.0 + unified: 11.0.5 + + '@astrojs/language-server@2.16.16(prettier@3.9.6)(typescript@5.9.3)': + dependencies: + '@astrojs/compiler': 2.13.1 + '@astrojs/yaml2ts': 0.2.4 + '@jridgewell/sourcemap-codec': 1.6.0 + '@volar/kit': 2.4.28(typescript@5.9.3) + '@volar/language-core': 2.4.28 + '@volar/language-server': 2.4.28 + '@volar/language-service': 2.4.28 + muggle-string: 0.4.1 + tinyglobby: 0.2.17 + volar-service-css: 0.0.71(@volar/language-service@2.4.28) + volar-service-emmet: 0.0.71(@volar/language-service@2.4.28) + volar-service-html: 0.0.71(@volar/language-service@2.4.28) + volar-service-prettier: 0.0.71(@volar/language-service@2.4.28)(prettier@3.9.6) + volar-service-typescript: 0.0.71(@volar/language-service@2.4.28) + volar-service-typescript-twoslash-queries: 0.0.71(@volar/language-service@2.4.28) + volar-service-yaml: 0.0.71(@volar/language-service@2.4.28) + vscode-html-languageservice: 5.6.2 + vscode-uri: 3.2.0 + optionalDependencies: + prettier: 3.9.6 + transitivePeerDependencies: + - typescript + + '@astrojs/markdown-satteri@0.4.1': + dependencies: + '@astrojs/internal-helpers': 0.11.0 + '@astrojs/prism': 4.0.2 + github-slugger: 2.0.0 + satteri: 0.10.5 + + '@astrojs/mdx@8.0.1(@astrojs/markdown-satteri@0.4.1)(astro@7.3.2(@emnapi/core@1.11.1)(@emnapi/runtime@1.11.3)(@types/node@24.13.4)(yaml@2.9.1))': + dependencies: + '@astrojs/internal-helpers': 0.11.0 + '@astrojs/markdown-satteri': 0.4.1 + astro: 7.3.2(@emnapi/core@1.11.1)(@emnapi/runtime@1.11.3)(@types/node@24.13.4)(yaml@2.9.1) + es-module-lexer: 2.3.2 + + '@astrojs/prism@4.0.2': + dependencies: + prismjs: 1.30.0 + + '@astrojs/sitemap@3.7.4': + dependencies: + sitemap: 9.0.1 + zod: 4.6.5 + + '@astrojs/starlight@0.42.1(astro@7.3.2(@emnapi/core@1.11.1)(@emnapi/runtime@1.11.3)(@types/node@24.13.4)(yaml@2.9.1))(typescript@5.9.3)': + dependencies: + '@astrojs/markdown-satteri': 0.4.1 + '@astrojs/mdx': 8.0.1(@astrojs/markdown-satteri@0.4.1)(astro@7.3.2(@emnapi/core@1.11.1)(@emnapi/runtime@1.11.3)(@types/node@24.13.4)(yaml@2.9.1)) + '@astrojs/sitemap': 3.7.4 + '@pagefind/default-ui': 1.5.2 + '@types/hast': 3.0.5 + '@types/js-yaml': 4.0.9 + '@types/mdast': 4.0.4 + astro: 7.3.2(@emnapi/core@1.11.1)(@emnapi/runtime@1.11.3)(@types/node@24.13.4)(yaml@2.9.1) + astro-expressive-code: 0.44.2(astro@7.3.2(@emnapi/core@1.11.1)(@emnapi/runtime@1.11.3)(@types/node@24.13.4)(yaml@2.9.1)) + bcp-47: 2.1.1 + hast-util-format: 1.1.0 + hast-util-select: 6.0.4 + hast-util-to-html: 9.0.5 + hast-util-to-string: 3.0.1 + hastscript: 9.0.1 + i18next: 26.4.2(typescript@5.9.3) + js-yaml: 4.3.2 + klona: 2.0.6 + magic-string: 1.4.1 + mdast-util-directive: 3.1.0 + mdast-util-to-markdown: 2.1.2 + mdast-util-to-string: 4.0.0 + pagefind: 1.5.2 + remark-directive: 4.0.0 + satteri: 0.10.5 + ultrahtml: 1.7.0 + unified: 11.0.5 + unist-util-visit: 5.1.0 + vfile: 6.0.3 + transitivePeerDependencies: + - supports-color + - typescript + + '@astrojs/telemetry@3.3.3': + dependencies: + ci-info: 4.4.0 + dset: 3.1.4 + is-docker: 4.0.0 + package-manager-detector: 1.8.0 + + '@astrojs/yaml2ts@0.2.4': + dependencies: + yaml: 2.9.1 + + '@babel/helper-string-parser@7.29.7': {} + + '@babel/helper-validator-identifier@7.29.7': {} + + '@babel/parser@7.29.8': + dependencies: + '@babel/types': 7.29.8 + + '@babel/types@7.29.8': + dependencies: + '@babel/helper-string-parser': 7.29.7 + '@babel/helper-validator-identifier': 7.29.7 + + '@bruits/satteri-darwin-arm64@0.10.5': + optional: true + + '@bruits/satteri-darwin-x64@0.10.5': + optional: true + + '@bruits/satteri-linux-arm64-gnu@0.10.5': + optional: true + + '@bruits/satteri-linux-arm64-musl@0.10.5': + optional: true + + '@bruits/satteri-linux-x64-gnu@0.10.5': + optional: true + + '@bruits/satteri-linux-x64-musl@0.10.5': + optional: true + + '@bruits/satteri-wasm32-wasi@0.10.5': + dependencies: + '@emnapi/core': 1.11.1 + '@emnapi/runtime': 1.11.1 + '@napi-rs/wasm-runtime': 1.2.4(@emnapi/core@1.11.1)(@emnapi/runtime@1.11.1) + optional: true + + '@bruits/satteri-win32-arm64-msvc@0.10.5': + optional: true + + '@bruits/satteri-win32-x64-msvc@0.10.5': + optional: true + + '@capsizecss/unpack@4.0.1': + dependencies: + fontkitten: 1.0.3 + + '@clack/core@1.5.1': + dependencies: + fast-wrap-ansi: 0.2.2 + sisteransi: 1.0.5 + + '@clack/prompts@1.8.1': + dependencies: + '@clack/core': 1.5.1 + fast-string-width: 3.0.2 + fast-wrap-ansi: 0.2.2 + sisteransi: 1.0.5 + + '@ctrl/tinycolor@4.2.1': {} + + '@emmetio/abbreviation@2.3.3': + dependencies: + '@emmetio/scanner': 1.0.4 + + '@emmetio/css-abbreviation@2.1.8': + dependencies: + '@emmetio/scanner': 1.0.4 + + '@emmetio/css-parser@0.4.1': + dependencies: + '@emmetio/stream-reader': 2.2.0 + '@emmetio/stream-reader-utils': 0.1.0 + + '@emmetio/html-matcher@1.3.0': + dependencies: + '@emmetio/scanner': 1.0.4 + + '@emmetio/scanner@1.0.4': {} + + '@emmetio/stream-reader-utils@0.1.0': {} + + '@emmetio/stream-reader@2.2.0': {} + + '@emnapi/core@1.11.1': + dependencies: + '@emnapi/wasi-threads': 1.2.2 + tslib: 2.8.1 + optional: true + + '@emnapi/runtime@1.11.1': + dependencies: + tslib: 2.8.1 + optional: true + + '@emnapi/runtime@1.11.3': + dependencies: + tslib: 2.8.1 + optional: true + + '@emnapi/wasi-threads@1.2.2': + dependencies: + tslib: 2.8.1 + optional: true + + '@esbuild/aix-ppc64@0.28.2': + optional: true + + '@esbuild/android-arm64@0.28.2': + optional: true + + '@esbuild/android-arm@0.28.2': + optional: true + + '@esbuild/android-x64@0.28.2': + optional: true + + '@esbuild/darwin-arm64@0.28.2': + optional: true + + '@esbuild/darwin-x64@0.28.2': + optional: true + + '@esbuild/freebsd-arm64@0.28.2': + optional: true + + '@esbuild/freebsd-x64@0.28.2': + optional: true + + '@esbuild/linux-arm64@0.28.2': + optional: true + + '@esbuild/linux-arm@0.28.2': + optional: true + + '@esbuild/linux-ia32@0.28.2': + optional: true + + '@esbuild/linux-loong64@0.28.2': + optional: true + + '@esbuild/linux-mips64el@0.28.2': + optional: true + + '@esbuild/linux-ppc64@0.28.2': + optional: true + + '@esbuild/linux-riscv64@0.28.2': + optional: true + + '@esbuild/linux-s390x@0.28.2': + optional: true + + '@esbuild/linux-x64@0.28.2': + optional: true + + '@esbuild/netbsd-arm64@0.28.2': + optional: true + + '@esbuild/netbsd-x64@0.28.2': + optional: true + + '@esbuild/openbsd-arm64@0.28.2': + optional: true + + '@esbuild/openbsd-x64@0.28.2': + optional: true + + '@esbuild/openharmony-arm64@0.28.2': + optional: true + + '@esbuild/sunos-x64@0.28.2': + optional: true + + '@esbuild/win32-arm64@0.28.2': + optional: true + + '@esbuild/win32-ia32@0.28.2': + optional: true + + '@esbuild/win32-x64@0.28.2': + optional: true + + '@expressive-code/core@0.44.2': + dependencies: + '@ctrl/tinycolor': 4.2.1 + hast-util-select: 6.0.4 + hast-util-to-html: 9.0.5 + hast-util-to-text: 4.0.2 + hastscript: 9.0.1 + postcss: 8.5.28 + postcss-nested: 6.2.0(postcss@8.5.28) + unist-util-visit: 5.1.0 + unist-util-visit-parents: 6.0.2 + + '@expressive-code/plugin-frames@0.44.2': + dependencies: + '@expressive-code/core': 0.44.2 + + '@expressive-code/plugin-shiki@0.44.2': + dependencies: + '@expressive-code/core': 0.44.2 + shiki: 4.4.3 + + '@expressive-code/plugin-text-markers@0.44.2': + dependencies: + '@expressive-code/core': 0.44.2 + + '@img/colour@1.1.0': + optional: true + + '@img/sharp-darwin-arm64@0.35.4': + optionalDependencies: + '@img/sharp-libvips-darwin-arm64': 1.3.3 + optional: true + + '@img/sharp-darwin-x64@0.35.4': + optionalDependencies: + '@img/sharp-libvips-darwin-x64': 1.3.3 + optional: true + + '@img/sharp-freebsd-wasm32@0.35.4': + dependencies: + '@img/sharp-wasm32': 0.35.4 + optional: true + + '@img/sharp-libvips-darwin-arm64@1.3.3': + optional: true + + '@img/sharp-libvips-darwin-x64@1.3.3': + optional: true + + '@img/sharp-libvips-linux-arm64@1.3.3': + optional: true + + '@img/sharp-libvips-linux-arm@1.3.3': + optional: true + + '@img/sharp-libvips-linux-ppc64@1.3.3': + optional: true + + '@img/sharp-libvips-linux-riscv64@1.3.3': + optional: true + + '@img/sharp-libvips-linux-s390x@1.3.3': + optional: true + + '@img/sharp-libvips-linux-x64@1.3.3': + optional: true + + '@img/sharp-libvips-linuxmusl-arm64@1.3.3': + optional: true + + '@img/sharp-libvips-linuxmusl-x64@1.3.3': + optional: true + + '@img/sharp-linux-arm64@0.35.4': + optionalDependencies: + '@img/sharp-libvips-linux-arm64': 1.3.3 + optional: true + + '@img/sharp-linux-arm@0.35.4': + optionalDependencies: + '@img/sharp-libvips-linux-arm': 1.3.3 + optional: true + + '@img/sharp-linux-ppc64@0.35.4': + optionalDependencies: + '@img/sharp-libvips-linux-ppc64': 1.3.3 + optional: true + + '@img/sharp-linux-riscv64@0.35.4': + optionalDependencies: + '@img/sharp-libvips-linux-riscv64': 1.3.3 + optional: true + + '@img/sharp-linux-s390x@0.35.4': + optionalDependencies: + '@img/sharp-libvips-linux-s390x': 1.3.3 + optional: true + + '@img/sharp-linux-x64@0.35.4': + optionalDependencies: + '@img/sharp-libvips-linux-x64': 1.3.3 + optional: true + + '@img/sharp-linuxmusl-arm64@0.35.4': + optionalDependencies: + '@img/sharp-libvips-linuxmusl-arm64': 1.3.3 + optional: true + + '@img/sharp-linuxmusl-x64@0.35.4': + optionalDependencies: + '@img/sharp-libvips-linuxmusl-x64': 1.3.3 + optional: true + + '@img/sharp-wasm32@0.35.4': + dependencies: + '@emnapi/runtime': 1.11.3 + optional: true + + '@img/sharp-webcontainers-wasm32@0.35.4': + dependencies: + '@img/sharp-wasm32': 0.35.4 + optional: true + + '@img/sharp-win32-arm64@0.35.4': + optional: true + + '@img/sharp-win32-ia32@0.35.4': + optional: true + + '@img/sharp-win32-x64@0.35.4': + optional: true + + '@jridgewell/sourcemap-codec@1.6.0': {} + + '@napi-rs/wasm-runtime@1.2.4(@emnapi/core@1.11.1)(@emnapi/runtime@1.11.1)': + dependencies: + '@emnapi/core': 1.11.1 + '@emnapi/runtime': 1.11.1 + '@tybys/wasm-util': 0.10.4 + optional: true + + '@napi-rs/wasm-runtime@1.2.4(@emnapi/core@1.11.1)(@emnapi/runtime@1.11.3)': + dependencies: + '@emnapi/core': 1.11.1 + '@emnapi/runtime': 1.11.3 + '@tybys/wasm-util': 0.10.4 + optional: true + + '@oslojs/encoding@1.1.0': {} + + '@oxc-project/types@0.149.0': {} + + '@pagefind/darwin-arm64@1.5.2': + optional: true + + '@pagefind/darwin-x64@1.5.2': + optional: true + + '@pagefind/default-ui@1.5.2': {} + + '@pagefind/freebsd-x64@1.5.2': + optional: true + + '@pagefind/linux-arm64@1.5.2': + optional: true + + '@pagefind/linux-x64@1.5.2': + optional: true + + '@pagefind/windows-arm64@1.5.2': + optional: true + + '@pagefind/windows-x64@1.5.2': + optional: true + + '@rolldown/binding-android-arm-eabi@1.2.8': + optional: true + + '@rolldown/binding-android-arm64@1.2.8': + optional: true + + '@rolldown/binding-darwin-arm64@1.2.8': + optional: true + + '@rolldown/binding-darwin-x64@1.2.8': + optional: true + + '@rolldown/binding-freebsd-x64@1.2.8': + optional: true + + '@rolldown/binding-linux-arm-gnueabihf@1.2.8': + optional: true + + '@rolldown/binding-linux-arm64-gnu@1.2.8': + optional: true + + '@rolldown/binding-linux-arm64-musl@1.2.8': + optional: true + + '@rolldown/binding-linux-ppc64-gnu@1.2.8': + optional: true + + '@rolldown/binding-linux-s390x-gnu@1.2.8': + optional: true + + '@rolldown/binding-linux-x64-gnu@1.2.8': + optional: true + + '@rolldown/binding-linux-x64-musl@1.2.8': + optional: true + + '@rolldown/binding-openharmony-arm64@1.2.8': + optional: true + + '@rolldown/binding-win32-arm64-msvc@1.2.8': + optional: true + + '@rolldown/binding-win32-x64-msvc@1.2.8': + optional: true + + '@rolldown/pluginutils@1.0.1': {} + + '@shikijs/core@4.4.3': + dependencies: + '@shikijs/primitive': 4.4.3 + '@shikijs/types': 4.4.3 + '@shikijs/vscode-textmate': 10.0.2 + '@types/hast': 3.0.5 + hast-util-to-html: 9.0.5 + + '@shikijs/engine-javascript@4.4.3': + dependencies: + '@shikijs/types': 4.4.3 + '@shikijs/vscode-textmate': 10.0.2 + oniguruma-to-es: 4.3.6 + + '@shikijs/engine-oniguruma@4.4.3': + dependencies: + '@shikijs/types': 4.4.3 + '@shikijs/vscode-textmate': 10.0.2 + + '@shikijs/langs@4.4.3': + dependencies: + '@shikijs/types': 4.4.3 + + '@shikijs/primitive@4.4.3': + dependencies: + '@shikijs/types': 4.4.3 + '@shikijs/vscode-textmate': 10.0.2 + '@types/hast': 3.0.5 + + '@shikijs/themes@4.4.3': + dependencies: + '@shikijs/types': 4.4.3 + + '@shikijs/types@4.4.3': + dependencies: + '@shikijs/vscode-textmate': 10.0.2 + '@types/hast': 3.0.5 + + '@shikijs/vscode-textmate@10.0.2': {} + + '@tybys/wasm-util@0.10.4': + dependencies: + tslib: 2.8.1 + optional: true + + '@types/debug@4.1.13': + dependencies: + '@types/ms': 2.1.0 + + '@types/estree-jsx@1.0.5': + dependencies: + '@types/estree': 1.0.9 + + '@types/estree@1.0.9': {} + + '@types/hast@3.0.5': + dependencies: + '@types/unist': 3.0.3 + + '@types/js-yaml@4.0.9': {} + + '@types/mdast@4.0.4': + dependencies: + '@types/unist': 3.0.3 + + '@types/ms@2.1.0': {} + + '@types/nlcst@2.0.3': + dependencies: + '@types/unist': 3.0.3 + + '@types/node@24.13.4': + dependencies: + undici-types: 7.18.2 + + '@types/sax@1.2.7': + dependencies: + '@types/node': 24.13.4 + + '@types/unist@2.0.11': {} + + '@types/unist@3.0.3': {} + + '@ungap/structured-clone@1.4.0': {} + + '@volar/kit@2.4.28(typescript@5.9.3)': + dependencies: + '@volar/language-service': 2.4.28 + '@volar/typescript': 2.4.28 + typesafe-path: 0.2.2 + typescript: 5.9.3 + vscode-languageserver-textdocument: 1.0.14 + vscode-uri: 3.2.0 + + '@volar/language-core@2.4.28': + dependencies: + '@volar/source-map': 2.4.28 + + '@volar/language-server@2.4.28': + dependencies: + '@volar/language-core': 2.4.28 + '@volar/language-service': 2.4.28 + '@volar/typescript': 2.4.28 + path-browserify: 1.0.1 + request-light: 0.7.0 + vscode-languageserver: 9.0.1 + vscode-languageserver-protocol: 3.18.3 + vscode-languageserver-textdocument: 1.0.14 + vscode-uri: 3.2.0 + + '@volar/language-service@2.4.28': + dependencies: + '@volar/language-core': 2.4.28 + vscode-languageserver-protocol: 3.18.3 + vscode-languageserver-textdocument: 1.0.14 + vscode-uri: 3.2.0 + + '@volar/source-map@2.4.28': {} + + '@volar/typescript@2.4.28': + dependencies: + '@volar/language-core': 2.4.28 + path-browserify: 1.0.1 + vscode-uri: 3.2.0 + + '@vscode/emmet-helper@2.11.0': + dependencies: + emmet: 2.4.11 + jsonc-parser: 2.3.1 + vscode-languageserver-textdocument: 1.0.14 + vscode-languageserver-types: 3.18.3 + vscode-uri: 3.2.0 + + '@vscode/l10n@0.0.18': {} + + ajv-draft-04@1.0.0(ajv@8.20.0): + optionalDependencies: + ajv: 8.20.0 + + ajv-i18n@4.2.0(ajv@8.20.0): + dependencies: + ajv: 8.20.0 + + ajv@8.20.0: + dependencies: + fast-deep-equal: 3.1.3 + fast-uri: 3.1.8 + json-schema-traverse: 1.0.0 + require-from-string: 2.0.2 + + am-i-vibing@0.4.0: + dependencies: + process-ancestry: 0.1.0 + + ansi-regex@6.3.0: {} + + ansi-styles@6.2.3: {} + + anymatch@3.1.3: + dependencies: + normalize-path: 3.0.0 + picomatch: 2.3.2 + + arg@5.0.2: {} + + argparse@2.0.1: {} + + aria-query@5.3.2: {} + + astro-expressive-code@0.44.2(astro@7.3.2(@emnapi/core@1.11.1)(@emnapi/runtime@1.11.3)(@types/node@24.13.4)(yaml@2.9.1)): + dependencies: + astro: 7.3.2(@emnapi/core@1.11.1)(@emnapi/runtime@1.11.3)(@types/node@24.13.4)(yaml@2.9.1) + rehype-expressive-code: 0.44.2 + url-extras: 0.1.0 + + astro@7.3.2(@emnapi/core@1.11.1)(@emnapi/runtime@1.11.3)(@types/node@24.13.4)(yaml@2.9.1): + dependencies: + '@astrojs/compiler-rs': 0.4.1(@emnapi/core@1.11.1)(@emnapi/runtime@1.11.3) + '@astrojs/internal-helpers': 0.11.0 + '@astrojs/markdown-satteri': 0.4.1 + '@astrojs/telemetry': 3.3.3 + '@capsizecss/unpack': 4.0.1 + '@clack/prompts': 1.8.1 + '@oslojs/encoding': 1.1.0 + am-i-vibing: 0.4.0 + aria-query: 5.3.2 + axobject-query: 4.1.0 + ci-info: 4.4.0 + clsx: 2.1.1 + common-ancestor-path: 2.0.0 + cookie: 2.0.1 + devalue: 5.9.2 + diff: 9.0.0 + dset: 3.1.4 + es-module-lexer: 2.3.2 + esbuild: 0.28.2 + find-proc: 0.1.0 + flattie: 1.1.1 + fontace: 0.4.1 + get-tsconfig: 5.0.0-beta.4 + github-slugger: 2.0.0 + html-escaper: 3.0.3 + http-cache-semantics: 4.2.0 + js-yaml: 4.3.2 + jsonc-parser: 3.3.1 + magic-string: 1.4.1 + magicast: 0.5.5 + mrmime: 2.0.1 + neotraverse: 1.0.1 + obug: 2.2.1 + p-limit: 7.3.2 + p-queue: 9.3.3 + package-manager-detector: 1.8.0 + piccolore: 0.1.3 + picomatch: 4.0.7 + semver: 7.8.5 + shiki: 4.4.3 + smol-toml: 1.8.0 + svgo: 4.1.0 + tinyclip: 0.1.15 + tinyexec: 1.3.1 + tinyglobby: 0.2.17 + ultrahtml: 1.7.0 + unifont: 0.7.5 + unstorage: 1.17.5 + vite: 8.3.0(@types/node@24.13.4)(esbuild@0.28.2)(yaml@2.9.1) + vitefu: 1.1.3(vite@8.3.0(@types/node@24.13.4)(esbuild@0.28.2)(yaml@2.9.1)) + xxhash-wasm: 1.1.0 + yargs-parser: 22.0.0 + zod: 4.6.5 + optionalDependencies: + sharp: 0.35.4(@types/node@24.13.4) + transitivePeerDependencies: + - '@azure/app-configuration' + - '@azure/cosmos' + - '@azure/data-tables' + - '@azure/identity' + - '@azure/keyvault-secrets' + - '@azure/storage-blob' + - '@capacitor/preferences' + - '@deno/kv' + - '@emnapi/core' + - '@emnapi/runtime' + - '@netlify/blobs' + - '@planetscale/database' + - '@types/node' + - '@upstash/redis' + - '@vercel/blob' + - '@vercel/functions' + - '@vercel/kv' + - '@vitejs/devtools' + - aws4fetch + - db0 + - idb-keyval + - ioredis + - jiti + - less + - sass + - sass-embedded + - stylus + - sugarss + - terser + - tsx + - uploadthing + - yaml + + axobject-query@4.1.0: {} + + bail@2.0.2: {} + + bcp-47-match@2.0.3: {} + + bcp-47@2.1.1: + dependencies: + is-alphabetical: 2.0.1 + is-alphanumerical: 2.0.1 + is-decimal: 2.0.1 + + boolbase@1.0.0: {} + + ccount@2.0.1: {} + + character-entities-html4@2.1.0: {} + + character-entities-legacy@3.0.0: {} + + character-entities@2.0.2: {} + + character-reference-invalid@2.0.1: {} + + chokidar@4.0.3: + dependencies: + readdirp: 4.1.2 + + chokidar@5.0.0: + dependencies: + readdirp: 5.1.1 + + ci-info@4.4.0: {} + + cliui@9.0.1: + dependencies: + string-width: 7.2.0 + strip-ansi: 7.2.0 + wrap-ansi: 9.0.2 + + clsx@2.1.1: {} + + comma-separated-tokens@2.0.3: {} + + commander@11.1.0: {} + + common-ancestor-path@2.0.0: {} + + cookie-es@1.2.3: {} + + cookie@2.0.1: {} + + crossws@0.3.5: + dependencies: + uncrypto: 0.1.3 + + css-select@6.0.0: + dependencies: + boolbase: 1.0.0 + css-what: 7.0.0 + domhandler: 5.0.3 + domutils: 3.2.2 + nth-check: 2.1.1 + + css-selector-parser@3.3.0: {} + + css-tree@2.2.1: + dependencies: + mdn-data: 2.0.28 + source-map-js: 1.2.1 + + css-tree@3.2.1: + dependencies: + mdn-data: 2.27.1 + source-map-js: 1.2.1 + + css-what@7.0.0: {} + + cssesc@3.0.0: {} + + csso@5.0.5: + dependencies: + css-tree: 2.2.1 + + debug@4.4.3: + dependencies: + ms: 2.1.3 + + decode-named-character-reference@1.3.0: + dependencies: + character-entities: 2.0.2 + + defu@6.1.7: {} + + dequal@2.0.3: {} + + destr@2.0.5: {} + + detect-libc@2.1.2: {} + + devalue@5.9.2: {} + + devlop@1.1.0: + dependencies: + dequal: 2.0.3 + + diff@9.0.0: {} + + direction@2.0.1: {} + + dom-serializer@2.0.0: + dependencies: + domelementtype: 2.3.0 + domhandler: 5.0.3 + entities: 4.5.0 + + domelementtype@2.3.0: {} + + domhandler@5.0.3: + dependencies: + domelementtype: 2.3.0 + + domutils@3.2.2: + dependencies: + dom-serializer: 2.0.0 + domelementtype: 2.3.0 + domhandler: 5.0.3 + + dset@3.1.4: {} + + emmet@2.4.11: + dependencies: + '@emmetio/abbreviation': 2.3.3 + '@emmetio/css-abbreviation': 2.1.8 + + emoji-regex@10.6.0: {} + + entities@4.5.0: {} + + es-module-lexer@2.3.2: {} + + esbuild@0.28.2: + optionalDependencies: + '@esbuild/aix-ppc64': 0.28.2 + '@esbuild/android-arm': 0.28.2 + '@esbuild/android-arm64': 0.28.2 + '@esbuild/android-x64': 0.28.2 + '@esbuild/darwin-arm64': 0.28.2 + '@esbuild/darwin-x64': 0.28.2 + '@esbuild/freebsd-arm64': 0.28.2 + '@esbuild/freebsd-x64': 0.28.2 + '@esbuild/linux-arm': 0.28.2 + '@esbuild/linux-arm64': 0.28.2 + '@esbuild/linux-ia32': 0.28.2 + '@esbuild/linux-loong64': 0.28.2 + '@esbuild/linux-mips64el': 0.28.2 + '@esbuild/linux-ppc64': 0.28.2 + '@esbuild/linux-riscv64': 0.28.2 + '@esbuild/linux-s390x': 0.28.2 + '@esbuild/linux-x64': 0.28.2 + '@esbuild/netbsd-arm64': 0.28.2 + '@esbuild/netbsd-x64': 0.28.2 + '@esbuild/openbsd-arm64': 0.28.2 + '@esbuild/openbsd-x64': 0.28.2 + '@esbuild/openharmony-arm64': 0.28.2 + '@esbuild/sunos-x64': 0.28.2 + '@esbuild/win32-arm64': 0.28.2 + '@esbuild/win32-ia32': 0.28.2 + '@esbuild/win32-x64': 0.28.2 + + escalade@3.2.0: {} + + eventemitter3@5.0.4: {} + + expressive-code@0.44.2: + dependencies: + '@expressive-code/core': 0.44.2 + '@expressive-code/plugin-frames': 0.44.2 + '@expressive-code/plugin-shiki': 0.44.2 + '@expressive-code/plugin-text-markers': 0.44.2 + + extend@3.0.2: {} + + fast-deep-equal@3.1.3: {} + + fast-string-truncated-width@3.0.3: {} + + fast-string-width@3.0.2: + dependencies: + fast-string-truncated-width: 3.0.3 + + fast-uri@3.1.8: {} + + fast-wrap-ansi@0.2.2: + dependencies: + fast-string-width: 3.0.2 + + fdir@6.5.0(picomatch@4.0.7): + optionalDependencies: + picomatch: 4.0.7 + + find-proc@0.1.0: {} + + flattie@1.1.1: {} + + fontace@0.4.1: + dependencies: + fontkitten: 1.0.3 + + fontkitten@1.0.3: + dependencies: + tiny-inflate: 1.0.3 + + fsevents@2.3.3: + optional: true + + get-caller-file@2.0.5: {} + + get-east-asian-width@1.6.0: {} + + get-tsconfig@5.0.0-beta.4: + dependencies: + resolve-pkg-maps: 1.0.0 + + github-slugger@2.0.0: {} + + h3@1.15.11: + dependencies: + cookie-es: 1.2.3 + crossws: 0.3.5 + defu: 6.1.7 + destr: 2.0.5 + iron-webcrypto: 1.2.1 + node-mock-http: 1.0.5 + radix3: 1.1.2 + ufo: 1.6.4 + uncrypto: 0.1.3 + + hast-util-embedded@3.0.0: + dependencies: + '@types/hast': 3.0.5 + hast-util-is-element: 3.0.0 + + hast-util-format@1.1.0: + dependencies: + '@types/hast': 3.0.5 + hast-util-embedded: 3.0.0 + hast-util-minify-whitespace: 1.0.1 + hast-util-phrasing: 3.0.1 + hast-util-whitespace: 3.0.0 + html-whitespace-sensitive-tag-names: 3.0.1 + unist-util-visit-parents: 6.0.2 + + hast-util-has-property@3.0.0: + dependencies: + '@types/hast': 3.0.5 + + hast-util-is-body-ok-link@3.0.1: + dependencies: + '@types/hast': 3.0.5 + + hast-util-is-element@3.0.0: + dependencies: + '@types/hast': 3.0.5 + + hast-util-minify-whitespace@1.0.1: + dependencies: + '@types/hast': 3.0.5 + hast-util-embedded: 3.0.0 + hast-util-is-element: 3.0.0 + hast-util-whitespace: 3.0.0 + unist-util-is: 6.0.1 + + hast-util-parse-selector@4.0.0: + dependencies: + '@types/hast': 3.0.5 + + hast-util-phrasing@3.0.1: + dependencies: + '@types/hast': 3.0.5 + hast-util-embedded: 3.0.0 + hast-util-has-property: 3.0.0 + hast-util-is-body-ok-link: 3.0.1 + hast-util-is-element: 3.0.0 + + hast-util-select@6.0.4: + dependencies: + '@types/hast': 3.0.5 + '@types/unist': 3.0.3 + bcp-47-match: 2.0.3 + comma-separated-tokens: 2.0.3 + css-selector-parser: 3.3.0 + devlop: 1.1.0 + direction: 2.0.1 + hast-util-has-property: 3.0.0 + hast-util-to-string: 3.0.1 + hast-util-whitespace: 3.0.0 + nth-check: 2.1.1 + property-information: 7.2.0 + space-separated-tokens: 2.0.2 + unist-util-visit: 5.1.0 + zwitch: 2.0.4 + + hast-util-to-html@9.0.5: + dependencies: + '@types/hast': 3.0.5 + '@types/unist': 3.0.3 + ccount: 2.0.1 + comma-separated-tokens: 2.0.3 + hast-util-whitespace: 3.0.0 + html-void-elements: 3.0.0 + mdast-util-to-hast: 13.2.1 + property-information: 7.2.0 + space-separated-tokens: 2.0.2 + stringify-entities: 4.0.4 + zwitch: 2.0.4 + + hast-util-to-string@3.0.1: + dependencies: + '@types/hast': 3.0.5 + + hast-util-to-text@4.0.2: + dependencies: + '@types/hast': 3.0.5 + '@types/unist': 3.0.3 + hast-util-is-element: 3.0.0 + unist-util-find-after: 5.0.0 + + hast-util-whitespace@3.0.0: + dependencies: + '@types/hast': 3.0.5 + + hastscript@9.0.1: + dependencies: + '@types/hast': 3.0.5 + comma-separated-tokens: 2.0.3 + hast-util-parse-selector: 4.0.0 + property-information: 7.2.0 + space-separated-tokens: 2.0.2 + + html-escaper@3.0.3: {} + + html-void-elements@3.0.0: {} + + html-whitespace-sensitive-tag-names@3.0.1: {} + + http-cache-semantics@4.2.0: {} + + i18next@26.4.2(typescript@5.9.3): + optionalDependencies: + typescript: 5.9.3 + + iron-webcrypto@1.2.1: {} + + is-alphabetical@2.0.1: {} + + is-alphanumerical@2.0.1: + dependencies: + is-alphabetical: 2.0.1 + is-decimal: 2.0.1 + + is-decimal@2.0.1: {} + + is-docker@4.0.0: {} + + is-hexadecimal@2.0.1: {} + + is-plain-obj@4.1.0: {} + + js-yaml@4.3.2: + dependencies: + argparse: 2.0.1 + + json-schema-traverse@1.0.0: {} + + jsonc-parser@2.3.1: {} + + jsonc-parser@3.3.1: {} + + kleur@4.1.5: {} + + klona@2.0.6: {} + + lightningcss-android-arm64@1.33.0: + optional: true + + lightningcss-darwin-arm64@1.33.0: + optional: true + + lightningcss-darwin-x64@1.33.0: + optional: true + + lightningcss-freebsd-x64@1.33.0: + optional: true + + lightningcss-linux-arm-gnueabihf@1.33.0: + optional: true + + lightningcss-linux-arm64-gnu@1.33.0: + optional: true + + lightningcss-linux-arm64-musl@1.33.0: + optional: true + + lightningcss-linux-x64-gnu@1.33.0: + optional: true + + lightningcss-linux-x64-musl@1.33.0: + optional: true + + lightningcss-win32-arm64-msvc@1.33.0: + optional: true + + lightningcss-win32-x64-msvc@1.33.0: + optional: true + + lightningcss@1.33.0: + dependencies: + detect-libc: 2.1.2 + optionalDependencies: + lightningcss-android-arm64: 1.33.0 + lightningcss-darwin-arm64: 1.33.0 + lightningcss-darwin-x64: 1.33.0 + lightningcss-freebsd-x64: 1.33.0 + lightningcss-linux-arm-gnueabihf: 1.33.0 + lightningcss-linux-arm64-gnu: 1.33.0 + lightningcss-linux-arm64-musl: 1.33.0 + lightningcss-linux-x64-gnu: 1.33.0 + lightningcss-linux-x64-musl: 1.33.0 + lightningcss-win32-arm64-msvc: 1.33.0 + lightningcss-win32-x64-msvc: 1.33.0 + + longest-streak@3.1.0: {} + + lru-cache@11.5.2: {} + + magic-string@1.4.1: + dependencies: + '@jridgewell/sourcemap-codec': 1.6.0 + + magicast@0.5.5: + dependencies: + '@babel/parser': 7.29.8 + '@babel/types': 7.29.8 + source-map-js: 1.2.1 + + mdast-util-directive@3.1.0: + dependencies: + '@types/mdast': 4.0.4 + '@types/unist': 3.0.3 + ccount: 2.0.1 + devlop: 1.1.0 + mdast-util-from-markdown: 2.0.3 + mdast-util-to-markdown: 2.1.2 + parse-entities: 4.0.2 + stringify-entities: 4.0.4 + unist-util-visit-parents: 6.0.2 + transitivePeerDependencies: + - supports-color + + mdast-util-from-markdown@2.0.3: + dependencies: + '@types/mdast': 4.0.4 + '@types/unist': 3.0.3 + decode-named-character-reference: 1.3.0 + devlop: 1.1.0 + mdast-util-to-string: 4.0.0 + micromark: 4.0.2 + micromark-util-decode-numeric-character-reference: 2.0.2 + micromark-util-decode-string: 2.0.1 + micromark-util-normalize-identifier: 2.0.1 + micromark-util-symbol: 2.0.1 + micromark-util-types: 2.0.2 + unist-util-stringify-position: 4.0.0 + transitivePeerDependencies: + - supports-color + + mdast-util-phrasing@4.1.0: + dependencies: + '@types/mdast': 4.0.4 + unist-util-is: 6.0.1 + + mdast-util-to-hast@13.2.1: + dependencies: + '@types/hast': 3.0.5 + '@types/mdast': 4.0.4 + '@ungap/structured-clone': 1.4.0 + devlop: 1.1.0 + micromark-util-sanitize-uri: 2.0.1 + trim-lines: 3.0.1 + unist-util-position: 5.0.0 + unist-util-visit: 5.1.0 + vfile: 6.0.3 + + mdast-util-to-markdown@2.1.2: + dependencies: + '@types/mdast': 4.0.4 + '@types/unist': 3.0.3 + longest-streak: 3.1.0 + mdast-util-phrasing: 4.1.0 + mdast-util-to-string: 4.0.0 + micromark-util-classify-character: 2.0.1 + micromark-util-decode-string: 2.0.1 + unist-util-visit: 5.1.0 + zwitch: 2.0.4 + + mdast-util-to-string@4.0.0: + dependencies: + '@types/mdast': 4.0.4 + + mdn-data@2.0.28: {} + + mdn-data@2.27.1: {} + + micromark-core-commonmark@2.0.3: + dependencies: + decode-named-character-reference: 1.3.0 + devlop: 1.1.0 + micromark-factory-destination: 2.0.1 + micromark-factory-label: 2.0.1 + micromark-factory-space: 2.0.1 + micromark-factory-title: 2.0.1 + micromark-factory-whitespace: 2.0.1 + micromark-util-character: 2.1.1 + micromark-util-chunked: 2.0.1 + micromark-util-classify-character: 2.0.1 + micromark-util-html-tag-name: 2.0.1 + micromark-util-normalize-identifier: 2.0.1 + micromark-util-resolve-all: 2.0.1 + micromark-util-subtokenize: 2.1.0 + micromark-util-symbol: 2.0.1 + micromark-util-types: 2.0.2 + + micromark-extension-directive@4.0.0: + dependencies: + devlop: 1.1.0 + micromark-factory-space: 2.0.1 + micromark-factory-whitespace: 2.0.1 + micromark-util-character: 2.1.1 + micromark-util-symbol: 2.0.1 + micromark-util-types: 2.0.2 + parse-entities: 4.0.2 + + micromark-factory-destination@2.0.1: + dependencies: + micromark-util-character: 2.1.1 + micromark-util-symbol: 2.0.1 + micromark-util-types: 2.0.2 + + micromark-factory-label@2.0.1: + dependencies: + devlop: 1.1.0 + micromark-util-character: 2.1.1 + micromark-util-symbol: 2.0.1 + micromark-util-types: 2.0.2 + + micromark-factory-space@2.0.1: + dependencies: + micromark-util-character: 2.1.1 + micromark-util-types: 2.0.2 + + micromark-factory-title@2.0.1: + dependencies: + micromark-factory-space: 2.0.1 + micromark-util-character: 2.1.1 + micromark-util-symbol: 2.0.1 + micromark-util-types: 2.0.2 + + micromark-factory-whitespace@2.0.1: + dependencies: + micromark-factory-space: 2.0.1 + micromark-util-character: 2.1.1 + micromark-util-symbol: 2.0.1 + micromark-util-types: 2.0.2 + + micromark-util-character@2.1.1: + dependencies: + micromark-util-symbol: 2.0.1 + micromark-util-types: 2.0.2 + + micromark-util-chunked@2.0.1: + dependencies: + micromark-util-symbol: 2.0.1 + + micromark-util-classify-character@2.0.1: + dependencies: + micromark-util-character: 2.1.1 + micromark-util-symbol: 2.0.1 + micromark-util-types: 2.0.2 + + micromark-util-combine-extensions@2.0.1: + dependencies: + micromark-util-chunked: 2.0.1 + micromark-util-types: 2.0.2 + + micromark-util-decode-numeric-character-reference@2.0.2: + dependencies: + micromark-util-symbol: 2.0.1 + + micromark-util-decode-string@2.0.1: + dependencies: + decode-named-character-reference: 1.3.0 + micromark-util-character: 2.1.1 + micromark-util-decode-numeric-character-reference: 2.0.2 + micromark-util-symbol: 2.0.1 + + micromark-util-encode@2.0.1: {} + + micromark-util-html-tag-name@2.0.1: {} + + micromark-util-normalize-identifier@2.0.1: + dependencies: + micromark-util-symbol: 2.0.1 + + micromark-util-resolve-all@2.0.1: + dependencies: + micromark-util-types: 2.0.2 + + micromark-util-sanitize-uri@2.0.1: + dependencies: + micromark-util-character: 2.1.1 + micromark-util-encode: 2.0.1 + micromark-util-symbol: 2.0.1 + + micromark-util-subtokenize@2.1.0: + dependencies: + devlop: 1.1.0 + micromark-util-chunked: 2.0.1 + micromark-util-symbol: 2.0.1 + micromark-util-types: 2.0.2 + + micromark-util-symbol@2.0.1: {} + + micromark-util-types@2.0.2: {} + + micromark@4.0.2: + dependencies: + '@types/debug': 4.1.13 + debug: 4.4.3 + decode-named-character-reference: 1.3.0 + devlop: 1.1.0 + micromark-core-commonmark: 2.0.3 + micromark-factory-space: 2.0.1 + micromark-util-character: 2.1.1 + micromark-util-chunked: 2.0.1 + micromark-util-combine-extensions: 2.0.1 + micromark-util-decode-numeric-character-reference: 2.0.2 + micromark-util-encode: 2.0.1 + micromark-util-normalize-identifier: 2.0.1 + micromark-util-resolve-all: 2.0.1 + micromark-util-sanitize-uri: 2.0.1 + micromark-util-subtokenize: 2.1.0 + micromark-util-symbol: 2.0.1 + micromark-util-types: 2.0.2 + transitivePeerDependencies: + - supports-color + + mrmime@2.0.1: {} + + ms@2.1.3: {} + + muggle-string@0.4.1: {} + + nanoid@3.3.19: {} + + neotraverse@1.0.1: {} + + nlcst-to-string@4.0.0: + dependencies: + '@types/nlcst': 2.0.3 + + node-fetch-native@1.6.7: {} + + node-mock-http@1.0.5: {} + + normalize-path@3.0.0: {} + + nth-check@2.1.1: + dependencies: + boolbase: 1.0.0 + + obug@2.2.1: {} + + ofetch@1.5.1: + dependencies: + destr: 2.0.5 + node-fetch-native: 1.6.7 + ufo: 1.6.4 + + ohash@2.0.12: {} + + oniguruma-parser@0.12.2: {} + + oniguruma-to-es@4.3.6: + dependencies: + oniguruma-parser: 0.12.2 + regex: 6.1.0 + regex-recursion: 6.0.2 + + p-limit@7.3.2: + dependencies: + yocto-queue: 1.2.2 + + p-queue@9.3.3: + dependencies: + eventemitter3: 5.0.4 + p-timeout: 7.0.2 + + p-timeout@7.0.2: {} + + package-manager-detector@1.8.0: {} + + pagefind@1.5.2: + optionalDependencies: + '@pagefind/darwin-arm64': 1.5.2 + '@pagefind/darwin-x64': 1.5.2 + '@pagefind/freebsd-x64': 1.5.2 + '@pagefind/linux-arm64': 1.5.2 + '@pagefind/linux-x64': 1.5.2 + '@pagefind/windows-arm64': 1.5.2 + '@pagefind/windows-x64': 1.5.2 + + parse-entities@4.0.2: + dependencies: + '@types/unist': 2.0.11 + character-entities-legacy: 3.0.0 + character-reference-invalid: 2.0.1 + decode-named-character-reference: 1.3.0 + is-alphanumerical: 2.0.1 + is-decimal: 2.0.1 + is-hexadecimal: 2.0.1 + + path-browserify@1.0.1: {} + + piccolore@0.1.3: {} + + picocolors@1.1.1: {} + + picomatch@2.3.2: {} + + picomatch@4.0.7: {} + + postcss-nested@6.2.0(postcss@8.5.28): + dependencies: + postcss: 8.5.28 + postcss-selector-parser: 6.1.4 + + postcss-selector-parser@6.1.4: + dependencies: + cssesc: 3.0.0 + util-deprecate: 1.0.2 + + postcss@8.5.28: + dependencies: + nanoid: 3.3.19 + picocolors: 1.1.1 + source-map-js: 1.2.1 + + prettier@3.9.6: {} + + prismjs@1.30.0: {} + + process-ancestry@0.1.0: {} + + property-information@7.2.0: {} + + radix3@1.1.2: {} + + readdirp@4.1.2: {} + + readdirp@5.1.1: {} + + regex-recursion@6.0.2: + dependencies: + regex-utilities: 2.3.0 + + regex-utilities@2.3.0: {} + + regex@6.1.0: + dependencies: + regex-utilities: 2.3.0 + + rehype-expressive-code@0.44.2: + dependencies: + expressive-code: 0.44.2 + + remark-directive@4.0.0: + dependencies: + '@types/mdast': 4.0.4 + mdast-util-directive: 3.1.0 + micromark-extension-directive: 4.0.0 + unified: 11.0.5 + transitivePeerDependencies: + - supports-color + + request-light@0.5.8: {} + + request-light@0.7.0: {} + + require-from-string@2.0.2: {} + + resolve-pkg-maps@1.0.0: {} + + retext-smartypants@6.2.0: + dependencies: + '@types/nlcst': 2.0.3 + nlcst-to-string: 4.0.0 + unist-util-visit: 5.1.0 + + rolldown@1.2.8: + dependencies: + '@oxc-project/types': 0.149.0 + '@rolldown/pluginutils': 1.0.1 + optionalDependencies: + '@rolldown/binding-android-arm-eabi': 1.2.8 + '@rolldown/binding-android-arm64': 1.2.8 + '@rolldown/binding-darwin-arm64': 1.2.8 + '@rolldown/binding-darwin-x64': 1.2.8 + '@rolldown/binding-freebsd-x64': 1.2.8 + '@rolldown/binding-linux-arm-gnueabihf': 1.2.8 + '@rolldown/binding-linux-arm64-gnu': 1.2.8 + '@rolldown/binding-linux-arm64-musl': 1.2.8 + '@rolldown/binding-linux-ppc64-gnu': 1.2.8 + '@rolldown/binding-linux-s390x-gnu': 1.2.8 + '@rolldown/binding-linux-x64-gnu': 1.2.8 + '@rolldown/binding-linux-x64-musl': 1.2.8 + '@rolldown/binding-openharmony-arm64': 1.2.8 + '@rolldown/binding-win32-arm64-msvc': 1.2.8 + '@rolldown/binding-win32-x64-msvc': 1.2.8 + + satteri@0.10.5: + dependencies: + '@types/estree-jsx': 1.0.5 + '@types/hast': 3.0.5 + '@types/mdast': 4.0.4 + '@types/unist': 3.0.3 + optionalDependencies: + '@bruits/satteri-darwin-arm64': 0.10.5 + '@bruits/satteri-darwin-x64': 0.10.5 + '@bruits/satteri-linux-arm64-gnu': 0.10.5 + '@bruits/satteri-linux-arm64-musl': 0.10.5 + '@bruits/satteri-linux-x64-gnu': 0.10.5 + '@bruits/satteri-linux-x64-musl': 0.10.5 + '@bruits/satteri-wasm32-wasi': 0.10.5 + '@bruits/satteri-win32-arm64-msvc': 0.10.5 + '@bruits/satteri-win32-x64-msvc': 0.10.5 + + sax@1.6.1: {} + + semver@7.8.5: {} + + sharp@0.35.4(@types/node@24.13.4): + dependencies: + '@img/colour': 1.1.0 + detect-libc: 2.1.2 + semver: 7.8.5 + optionalDependencies: + '@img/sharp-darwin-arm64': 0.35.4 + '@img/sharp-darwin-x64': 0.35.4 + '@img/sharp-freebsd-wasm32': 0.35.4 + '@img/sharp-libvips-darwin-arm64': 1.3.3 + '@img/sharp-libvips-darwin-x64': 1.3.3 + '@img/sharp-libvips-linux-arm': 1.3.3 + '@img/sharp-libvips-linux-arm64': 1.3.3 + '@img/sharp-libvips-linux-ppc64': 1.3.3 + '@img/sharp-libvips-linux-riscv64': 1.3.3 + '@img/sharp-libvips-linux-s390x': 1.3.3 + '@img/sharp-libvips-linux-x64': 1.3.3 + '@img/sharp-libvips-linuxmusl-arm64': 1.3.3 + '@img/sharp-libvips-linuxmusl-x64': 1.3.3 + '@img/sharp-linux-arm': 0.35.4 + '@img/sharp-linux-arm64': 0.35.4 + '@img/sharp-linux-ppc64': 0.35.4 + '@img/sharp-linux-riscv64': 0.35.4 + '@img/sharp-linux-s390x': 0.35.4 + '@img/sharp-linux-x64': 0.35.4 + '@img/sharp-linuxmusl-arm64': 0.35.4 + '@img/sharp-linuxmusl-x64': 0.35.4 + '@img/sharp-webcontainers-wasm32': 0.35.4 + '@img/sharp-win32-arm64': 0.35.4 + '@img/sharp-win32-ia32': 0.35.4 + '@img/sharp-win32-x64': 0.35.4 + '@types/node': 24.13.4 + optional: true + + shiki@4.4.3: + dependencies: + '@shikijs/core': 4.4.3 + '@shikijs/engine-javascript': 4.4.3 + '@shikijs/engine-oniguruma': 4.4.3 + '@shikijs/langs': 4.4.3 + '@shikijs/themes': 4.4.3 + '@shikijs/types': 4.4.3 + '@shikijs/vscode-textmate': 10.0.2 + '@types/hast': 3.0.5 + + sisteransi@1.0.5: {} + + sitemap@9.0.1: + dependencies: + '@types/node': 24.13.4 + '@types/sax': 1.2.7 + arg: 5.0.2 + sax: 1.6.1 + + smol-toml@1.8.0: {} + + source-map-js@1.2.1: {} + + space-separated-tokens@2.0.2: {} + + string-width@7.2.0: + dependencies: + emoji-regex: 10.6.0 + get-east-asian-width: 1.6.0 + strip-ansi: 7.2.0 + + string-width@8.2.2: + dependencies: + get-east-asian-width: 1.6.0 + strip-ansi: 7.2.0 + + stringify-entities@4.0.4: + dependencies: + character-entities-html4: 2.1.0 + character-entities-legacy: 3.0.0 + + strip-ansi@7.2.0: + dependencies: + ansi-regex: 6.3.0 + + svgo@4.1.0: + dependencies: + commander: 11.1.0 + css-select: 6.0.0 + css-tree: 3.2.1 + css-what: 7.0.0 + csso: 5.0.5 + picocolors: 1.1.1 + sax: 1.6.1 + + tiny-inflate@1.0.3: {} + + tinyclip@0.1.15: {} + + tinyexec@1.3.1: {} + + tinyglobby@0.2.17: + dependencies: + fdir: 6.5.0(picomatch@4.0.7) + picomatch: 4.0.7 + + trim-lines@3.0.1: {} + + trough@2.2.0: {} + + tslib@2.8.1: + optional: true + + typesafe-path@0.2.2: {} + + typescript-auto-import-cache@0.3.6: + dependencies: + semver: 7.8.5 + + typescript@5.9.3: {} + + ufo@1.6.4: {} + + ultrahtml@1.7.0: {} + + uncrypto@0.1.3: {} + + undici-types@7.18.2: {} + + undici@8.10.2: {} + + unified@11.0.5: + dependencies: + '@types/unist': 3.0.3 + bail: 2.0.2 + devlop: 1.1.0 + extend: 3.0.2 + is-plain-obj: 4.1.0 + trough: 2.2.0 + vfile: 6.0.3 + + unifont@0.7.5: + dependencies: + css-tree: 3.2.1 + ohash: 2.0.12 + undici: 8.10.2 + + unist-util-find-after@5.0.0: + dependencies: + '@types/unist': 3.0.3 + unist-util-is: 6.0.1 + + unist-util-is@6.0.1: + dependencies: + '@types/unist': 3.0.3 + + unist-util-position@5.0.0: + dependencies: + '@types/unist': 3.0.3 + + unist-util-stringify-position@4.0.0: + dependencies: + '@types/unist': 3.0.3 + + unist-util-visit-parents@6.0.2: + dependencies: + '@types/unist': 3.0.3 + unist-util-is: 6.0.1 + + unist-util-visit@5.1.0: + dependencies: + '@types/unist': 3.0.3 + unist-util-is: 6.0.1 + unist-util-visit-parents: 6.0.2 + + unstorage@1.17.5: + dependencies: + anymatch: 3.1.3 + chokidar: 5.0.0 + destr: 2.0.5 + h3: 1.15.11 + lru-cache: 11.5.2 + node-fetch-native: 1.6.7 + ofetch: 1.5.1 + ufo: 1.6.4 + + url-extras@0.1.0: {} + + util-deprecate@1.0.2: {} + + vfile-message@4.0.3: + dependencies: + '@types/unist': 3.0.3 + unist-util-stringify-position: 4.0.0 + + vfile@6.0.3: + dependencies: + '@types/unist': 3.0.3 + vfile-message: 4.0.3 + + vite@8.3.0(@types/node@24.13.4)(esbuild@0.28.2)(yaml@2.9.1): + dependencies: + lightningcss: 1.33.0 + picomatch: 4.0.7 + postcss: 8.5.28 + rolldown: 1.2.8 + tinyglobby: 0.2.17 + optionalDependencies: + '@types/node': 24.13.4 + esbuild: 0.28.2 + fsevents: 2.3.3 + yaml: 2.9.1 + + vitefu@1.1.3(vite@8.3.0(@types/node@24.13.4)(esbuild@0.28.2)(yaml@2.9.1)): + optionalDependencies: + vite: 8.3.0(@types/node@24.13.4)(esbuild@0.28.2)(yaml@2.9.1) + + volar-service-css@0.0.71(@volar/language-service@2.4.28): + dependencies: + vscode-css-languageservice: 6.3.10 + vscode-languageserver-textdocument: 1.0.14 + vscode-uri: 3.2.0 + optionalDependencies: + '@volar/language-service': 2.4.28 + + volar-service-emmet@0.0.71(@volar/language-service@2.4.28): + dependencies: + '@emmetio/css-parser': 0.4.1 + '@emmetio/html-matcher': 1.3.0 + '@vscode/emmet-helper': 2.11.0 + vscode-uri: 3.2.0 + optionalDependencies: + '@volar/language-service': 2.4.28 + + volar-service-html@0.0.71(@volar/language-service@2.4.28): + dependencies: + vscode-html-languageservice: 5.6.2 + vscode-languageserver-textdocument: 1.0.14 + vscode-uri: 3.2.0 + optionalDependencies: + '@volar/language-service': 2.4.28 + + volar-service-prettier@0.0.71(@volar/language-service@2.4.28)(prettier@3.9.6): + dependencies: + vscode-uri: 3.2.0 + optionalDependencies: + '@volar/language-service': 2.4.28 + prettier: 3.9.6 + + volar-service-typescript-twoslash-queries@0.0.71(@volar/language-service@2.4.28): + dependencies: + vscode-uri: 3.2.0 + optionalDependencies: + '@volar/language-service': 2.4.28 + + volar-service-typescript@0.0.71(@volar/language-service@2.4.28): + dependencies: + path-browserify: 1.0.1 + semver: 7.8.5 + typescript-auto-import-cache: 0.3.6 + vscode-languageserver-textdocument: 1.0.14 + vscode-nls: 5.2.0 + vscode-uri: 3.2.0 + optionalDependencies: + '@volar/language-service': 2.4.28 + + volar-service-yaml@0.0.71(@volar/language-service@2.4.28): + dependencies: + vscode-uri: 3.2.0 + yaml-language-server: 1.23.0 + optionalDependencies: + '@volar/language-service': 2.4.28 + + vscode-css-languageservice@6.3.10: + dependencies: + '@vscode/l10n': 0.0.18 + vscode-languageserver-textdocument: 1.0.14 + vscode-languageserver-types: 3.17.5 + vscode-uri: 3.2.0 + + vscode-html-languageservice@5.6.2: + dependencies: + '@vscode/l10n': 0.0.18 + vscode-languageserver-textdocument: 1.0.14 + vscode-languageserver-types: 3.18.3 + vscode-uri: 3.2.0 + + vscode-json-languageservice@4.1.8: + dependencies: + jsonc-parser: 3.3.1 + vscode-languageserver-textdocument: 1.0.14 + vscode-languageserver-types: 3.18.3 + vscode-nls: 5.2.0 + vscode-uri: 3.2.0 + + vscode-jsonrpc@8.2.0: {} + + vscode-jsonrpc@9.0.2: {} + + vscode-languageserver-protocol@3.17.5: + dependencies: + vscode-jsonrpc: 8.2.0 + vscode-languageserver-types: 3.17.5 + + vscode-languageserver-protocol@3.18.3: + dependencies: + vscode-jsonrpc: 9.0.2 + vscode-languageserver-types: 3.18.3 + + vscode-languageserver-textdocument@1.0.14: {} + + vscode-languageserver-types@3.17.5: {} + + vscode-languageserver-types@3.18.3: {} + + vscode-languageserver@9.0.1: + dependencies: + vscode-languageserver-protocol: 3.17.5 + + vscode-nls@5.2.0: {} + + vscode-uri@3.2.0: {} + + wrap-ansi@9.0.2: + dependencies: + ansi-styles: 6.2.3 + string-width: 7.2.0 + strip-ansi: 7.2.0 + + xxhash-wasm@1.1.0: {} + + y18n@5.0.8: {} + + yaml-language-server@1.23.0: + dependencies: + '@vscode/l10n': 0.0.18 + ajv: 8.20.0 + ajv-draft-04: 1.0.0(ajv@8.20.0) + ajv-i18n: 4.2.0(ajv@8.20.0) + prettier: 3.9.6 + request-light: 0.5.8 + vscode-json-languageservice: 4.1.8 + vscode-languageserver: 9.0.1 + vscode-languageserver-textdocument: 1.0.14 + vscode-languageserver-types: 3.18.3 + vscode-uri: 3.2.0 + yaml: 2.8.3 + + yaml@2.8.3: {} + + yaml@2.9.1: {} + + yargs-parser@22.0.0: {} + + yargs@18.1.0: + dependencies: + cliui: 9.0.1 + escalade: 3.2.0 + get-caller-file: 2.0.5 + string-width: 8.2.2 + y18n: 5.0.8 + yargs-parser: 22.0.0 + + yocto-queue@1.2.2: {} + + zod@4.6.5: {} + + zwitch@2.0.4: {} diff --git a/docs/assets/brand/apple-touch-icon.png b/docs/public/brand/apple-touch-icon.png similarity index 100% rename from docs/assets/brand/apple-touch-icon.png rename to docs/public/brand/apple-touch-icon.png diff --git a/docs/assets/brand/favicon.svg b/docs/public/brand/favicon.svg similarity index 100% rename from docs/assets/brand/favicon.svg rename to docs/public/brand/favicon.svg diff --git a/docs/assets/brand/nativephp-charts-16.png b/docs/public/brand/nativephp-charts-16.png similarity index 100% rename from docs/assets/brand/nativephp-charts-16.png rename to docs/public/brand/nativephp-charts-16.png diff --git a/docs/assets/brand/nativephp-charts-192.png b/docs/public/brand/nativephp-charts-192.png similarity index 100% rename from docs/assets/brand/nativephp-charts-192.png rename to docs/public/brand/nativephp-charts-192.png diff --git a/docs/assets/brand/nativephp-charts-256.png b/docs/public/brand/nativephp-charts-256.png similarity index 100% rename from docs/assets/brand/nativephp-charts-256.png rename to docs/public/brand/nativephp-charts-256.png diff --git a/docs/assets/brand/nativephp-charts-32.png b/docs/public/brand/nativephp-charts-32.png similarity index 100% rename from docs/assets/brand/nativephp-charts-32.png rename to docs/public/brand/nativephp-charts-32.png diff --git a/docs/assets/brand/nativephp-charts-512.png b/docs/public/brand/nativephp-charts-512.png similarity index 100% rename from docs/assets/brand/nativephp-charts-512.png rename to docs/public/brand/nativephp-charts-512.png diff --git a/docs/assets/brand/nativephp-charts-lockup-dark.svg b/docs/public/brand/nativephp-charts-lockup-dark.svg similarity index 100% rename from docs/assets/brand/nativephp-charts-lockup-dark.svg rename to docs/public/brand/nativephp-charts-lockup-dark.svg diff --git a/docs/assets/brand/nativephp-charts-lockup.svg b/docs/public/brand/nativephp-charts-lockup.svg similarity index 100% rename from docs/assets/brand/nativephp-charts-lockup.svg rename to docs/public/brand/nativephp-charts-lockup.svg diff --git a/docs/assets/brand/nativephp-charts-mark-black.svg b/docs/public/brand/nativephp-charts-mark-black.svg similarity index 100% rename from docs/assets/brand/nativephp-charts-mark-black.svg rename to docs/public/brand/nativephp-charts-mark-black.svg diff --git a/docs/assets/brand/nativephp-charts-mark-white.svg b/docs/public/brand/nativephp-charts-mark-white.svg similarity index 100% rename from docs/assets/brand/nativephp-charts-mark-white.svg rename to docs/public/brand/nativephp-charts-mark-white.svg diff --git a/docs/assets/brand/nativephp-charts-mark.svg b/docs/public/brand/nativephp-charts-mark.svg similarity index 100% rename from docs/assets/brand/nativephp-charts-mark.svg rename to docs/public/brand/nativephp-charts-mark.svg diff --git a/docs/public/evidence/android/area-selected.png b/docs/public/evidence/android/area-selected.png new file mode 100644 index 0000000..3da3a74 Binary files /dev/null and b/docs/public/evidence/android/area-selected.png differ diff --git a/docs/public/evidence/android/area.png b/docs/public/evidence/android/area.png new file mode 100644 index 0000000..07763d3 Binary files /dev/null and b/docs/public/evidence/android/area.png differ diff --git a/docs/public/evidence/android/bar-selected.png b/docs/public/evidence/android/bar-selected.png new file mode 100644 index 0000000..3a4f889 Binary files /dev/null and b/docs/public/evidence/android/bar-selected.png differ diff --git a/docs/public/evidence/android/bar.png b/docs/public/evidence/android/bar.png new file mode 100644 index 0000000..b5443ee Binary files /dev/null and b/docs/public/evidence/android/bar.png differ diff --git a/docs/assets/screenshots/bar-android-640.webp b/docs/public/evidence/android/bar.webp similarity index 100% rename from docs/assets/screenshots/bar-android-640.webp rename to docs/public/evidence/android/bar.webp diff --git a/docs/assets/runtime/android/biyuyo-budget-charts-768.webp b/docs/public/evidence/android/biyuyo-budget-charts.webp similarity index 100% rename from docs/assets/runtime/android/biyuyo-budget-charts-768.webp rename to docs/public/evidence/android/biyuyo-budget-charts.webp diff --git a/docs/public/evidence/android/candlestick-selected.png b/docs/public/evidence/android/candlestick-selected.png new file mode 100644 index 0000000..7ecf03a Binary files /dev/null and b/docs/public/evidence/android/candlestick-selected.png differ diff --git a/docs/public/evidence/android/candlestick.png b/docs/public/evidence/android/candlestick.png new file mode 100644 index 0000000..faabe06 Binary files /dev/null and b/docs/public/evidence/android/candlestick.png differ diff --git a/docs/public/evidence/android/contribution-heatmap-selected.png b/docs/public/evidence/android/contribution-heatmap-selected.png new file mode 100644 index 0000000..9045793 Binary files /dev/null and b/docs/public/evidence/android/contribution-heatmap-selected.png differ diff --git a/docs/public/evidence/android/contribution-heatmap.png b/docs/public/evidence/android/contribution-heatmap.png new file mode 100644 index 0000000..362d714 Binary files /dev/null and b/docs/public/evidence/android/contribution-heatmap.png differ diff --git a/docs/public/evidence/android/donut-selected.png b/docs/public/evidence/android/donut-selected.png new file mode 100644 index 0000000..41d5d9a Binary files /dev/null and b/docs/public/evidence/android/donut-selected.png differ diff --git a/docs/public/evidence/android/donut.png b/docs/public/evidence/android/donut.png new file mode 100644 index 0000000..ec9c135 Binary files /dev/null and b/docs/public/evidence/android/donut.png differ diff --git a/docs/assets/screenshots/donut-android-640.webp b/docs/public/evidence/android/donut.webp similarity index 100% rename from docs/assets/screenshots/donut-android-640.webp rename to docs/public/evidence/android/donut.webp diff --git a/docs/public/evidence/android/line-selected.png b/docs/public/evidence/android/line-selected.png new file mode 100644 index 0000000..fc5fb4d Binary files /dev/null and b/docs/public/evidence/android/line-selected.png differ diff --git a/docs/public/evidence/android/line.png b/docs/public/evidence/android/line.png new file mode 100644 index 0000000..0a3f92b Binary files /dev/null and b/docs/public/evidence/android/line.png differ diff --git a/docs/assets/screenshots/line-android-640.webp b/docs/public/evidence/android/line.webp similarity index 100% rename from docs/assets/screenshots/line-android-640.webp rename to docs/public/evidence/android/line.webp diff --git a/docs/public/evidence/android/native-shell-home.png b/docs/public/evidence/android/native-shell-home.png new file mode 100644 index 0000000..87a171e Binary files /dev/null and b/docs/public/evidence/android/native-shell-home.png differ diff --git a/docs/public/evidence/android/native-shell-line-selected.png b/docs/public/evidence/android/native-shell-line-selected.png new file mode 100644 index 0000000..67bb79a Binary files /dev/null and b/docs/public/evidence/android/native-shell-line-selected.png differ diff --git a/docs/public/evidence/android/pie-selected.png b/docs/public/evidence/android/pie-selected.png new file mode 100644 index 0000000..161f07c Binary files /dev/null and b/docs/public/evidence/android/pie-selected.png differ diff --git a/docs/public/evidence/android/pie.png b/docs/public/evidence/android/pie.png new file mode 100644 index 0000000..caf22a4 Binary files /dev/null and b/docs/public/evidence/android/pie.png differ diff --git a/docs/public/evidence/android/progress-selected.png b/docs/public/evidence/android/progress-selected.png new file mode 100644 index 0000000..06e4c4b Binary files /dev/null and b/docs/public/evidence/android/progress-selected.png differ diff --git a/docs/public/evidence/android/progress.png b/docs/public/evidence/android/progress.png new file mode 100644 index 0000000..25ed7de Binary files /dev/null and b/docs/public/evidence/android/progress.png differ diff --git a/docs/public/evidence/android/radar-selected.png b/docs/public/evidence/android/radar-selected.png new file mode 100644 index 0000000..cbfacfa Binary files /dev/null and b/docs/public/evidence/android/radar-selected.png differ diff --git a/docs/public/evidence/android/radar.png b/docs/public/evidence/android/radar.png new file mode 100644 index 0000000..2c701f5 Binary files /dev/null and b/docs/public/evidence/android/radar.png differ diff --git a/docs/public/evidence/android/scatter-selected.png b/docs/public/evidence/android/scatter-selected.png new file mode 100644 index 0000000..51b7047 Binary files /dev/null and b/docs/public/evidence/android/scatter-selected.png differ diff --git a/docs/public/evidence/android/scatter.png b/docs/public/evidence/android/scatter.png new file mode 100644 index 0000000..b3acc74 Binary files /dev/null and b/docs/public/evidence/android/scatter.png differ diff --git a/docs/public/evidence/ios/area-selected.png b/docs/public/evidence/ios/area-selected.png new file mode 100644 index 0000000..491746d Binary files /dev/null and b/docs/public/evidence/ios/area-selected.png differ diff --git a/docs/public/evidence/ios/area.png b/docs/public/evidence/ios/area.png new file mode 100644 index 0000000..72b21ad Binary files /dev/null and b/docs/public/evidence/ios/area.png differ diff --git a/docs/public/evidence/ios/bar-selected.png b/docs/public/evidence/ios/bar-selected.png new file mode 100644 index 0000000..b5e3a9b Binary files /dev/null and b/docs/public/evidence/ios/bar-selected.png differ diff --git a/docs/public/evidence/ios/bar.png b/docs/public/evidence/ios/bar.png new file mode 100644 index 0000000..5313806 Binary files /dev/null and b/docs/public/evidence/ios/bar.png differ diff --git a/docs/assets/screenshots/bar-ios-320.webp b/docs/public/evidence/ios/bar.webp similarity index 100% rename from docs/assets/screenshots/bar-ios-320.webp rename to docs/public/evidence/ios/bar.webp diff --git a/docs/assets/runtime/ios/biyuyo-goal-charts-402.webp b/docs/public/evidence/ios/biyuyo-goal-charts.webp similarity index 100% rename from docs/assets/runtime/ios/biyuyo-goal-charts-402.webp rename to docs/public/evidence/ios/biyuyo-goal-charts.webp diff --git a/docs/public/evidence/ios/candlestick-selected.png b/docs/public/evidence/ios/candlestick-selected.png new file mode 100644 index 0000000..c7d06e6 Binary files /dev/null and b/docs/public/evidence/ios/candlestick-selected.png differ diff --git a/docs/public/evidence/ios/candlestick.png b/docs/public/evidence/ios/candlestick.png new file mode 100644 index 0000000..21cd54d Binary files /dev/null and b/docs/public/evidence/ios/candlestick.png differ diff --git a/docs/public/evidence/ios/contribution-heatmap-selected.png b/docs/public/evidence/ios/contribution-heatmap-selected.png new file mode 100644 index 0000000..f8b4cd2 Binary files /dev/null and b/docs/public/evidence/ios/contribution-heatmap-selected.png differ diff --git a/docs/public/evidence/ios/contribution-heatmap.png b/docs/public/evidence/ios/contribution-heatmap.png new file mode 100644 index 0000000..c18f8c2 Binary files /dev/null and b/docs/public/evidence/ios/contribution-heatmap.png differ diff --git a/docs/public/evidence/ios/donut-selected.png b/docs/public/evidence/ios/donut-selected.png new file mode 100644 index 0000000..dcecf52 Binary files /dev/null and b/docs/public/evidence/ios/donut-selected.png differ diff --git a/docs/public/evidence/ios/donut.png b/docs/public/evidence/ios/donut.png new file mode 100644 index 0000000..4dd1653 Binary files /dev/null and b/docs/public/evidence/ios/donut.png differ diff --git a/docs/assets/screenshots/donut-ios-320.webp b/docs/public/evidence/ios/donut.webp similarity index 100% rename from docs/assets/screenshots/donut-ios-320.webp rename to docs/public/evidence/ios/donut.webp diff --git a/docs/public/evidence/ios/line-selected.png b/docs/public/evidence/ios/line-selected.png new file mode 100644 index 0000000..3b80328 Binary files /dev/null and b/docs/public/evidence/ios/line-selected.png differ diff --git a/docs/public/evidence/ios/line.png b/docs/public/evidence/ios/line.png new file mode 100644 index 0000000..0f1ed8b Binary files /dev/null and b/docs/public/evidence/ios/line.png differ diff --git a/docs/public/evidence/ios/line.webp b/docs/public/evidence/ios/line.webp new file mode 100644 index 0000000..8b6d928 Binary files /dev/null and b/docs/public/evidence/ios/line.webp differ diff --git a/docs/public/evidence/ios/native-shell-home.jpg b/docs/public/evidence/ios/native-shell-home.jpg new file mode 100644 index 0000000..8b250bb Binary files /dev/null and b/docs/public/evidence/ios/native-shell-home.jpg differ diff --git a/docs/public/evidence/ios/pie-selected.png b/docs/public/evidence/ios/pie-selected.png new file mode 100644 index 0000000..bf32095 Binary files /dev/null and b/docs/public/evidence/ios/pie-selected.png differ diff --git a/docs/public/evidence/ios/pie.png b/docs/public/evidence/ios/pie.png new file mode 100644 index 0000000..59ffc99 Binary files /dev/null and b/docs/public/evidence/ios/pie.png differ diff --git a/docs/public/evidence/ios/progress-selected.png b/docs/public/evidence/ios/progress-selected.png new file mode 100644 index 0000000..aed705e Binary files /dev/null and b/docs/public/evidence/ios/progress-selected.png differ diff --git a/docs/public/evidence/ios/progress.png b/docs/public/evidence/ios/progress.png new file mode 100644 index 0000000..1bdb701 Binary files /dev/null and b/docs/public/evidence/ios/progress.png differ diff --git a/docs/public/evidence/ios/radar-selected.png b/docs/public/evidence/ios/radar-selected.png new file mode 100644 index 0000000..129422e Binary files /dev/null and b/docs/public/evidence/ios/radar-selected.png differ diff --git a/docs/public/evidence/ios/radar.png b/docs/public/evidence/ios/radar.png new file mode 100644 index 0000000..b212b3f Binary files /dev/null and b/docs/public/evidence/ios/radar.png differ diff --git a/docs/public/evidence/ios/scatter-selected.png b/docs/public/evidence/ios/scatter-selected.png new file mode 100644 index 0000000..4e3aa54 Binary files /dev/null and b/docs/public/evidence/ios/scatter-selected.png differ diff --git a/docs/public/evidence/ios/scatter.png b/docs/public/evidence/ios/scatter.png new file mode 100644 index 0000000..96401b3 Binary files /dev/null and b/docs/public/evidence/ios/scatter.png differ diff --git a/docs/public/favicon.ico b/docs/public/favicon.ico new file mode 100644 index 0000000..7f48a94 Binary files /dev/null and b/docs/public/favicon.ico differ diff --git a/docs/public/favicon.svg b/docs/public/favicon.svg new file mode 100644 index 0000000..f157bd1 --- /dev/null +++ b/docs/public/favicon.svg @@ -0,0 +1,9 @@ + + + + diff --git a/docs/public/site.js b/docs/public/site.js new file mode 100644 index 0000000..2a55891 --- /dev/null +++ b/docs/public/site.js @@ -0,0 +1,54 @@ +document.addEventListener('DOMContentLoaded', () => { + const codeResizeObserver = new ResizeObserver((entries) => { + entries.forEach(({ target }) => { + target.tabIndex = target.scrollWidth > target.clientWidth || target.scrollHeight > target.clientHeight ? 0 : -1; + }); + }); + document.querySelectorAll('pre').forEach((block) => codeResizeObserver.observe(block)); + + document.querySelectorAll('[data-code-tabs]').forEach((container) => { + const tabs = [...container.querySelectorAll('[role="tab"]')]; + const panels = [...container.querySelectorAll('[role="tabpanel"]')]; + const copyButton = container.querySelector('[data-copy-current]'); + const copyStatus = container.querySelector('[data-copy-status]'); + + const activate = (selected, moveFocus = false) => { + tabs.forEach((tab) => { + const active = tab === selected; + tab.setAttribute('aria-selected', String(active)); + tab.tabIndex = active ? 0 : -1; + }); + panels.forEach((panel) => { + panel.hidden = panel.id !== selected.getAttribute('aria-controls'); + }); + copyStatus.textContent = ''; + if (moveFocus) selected.focus(); + }; + + tabs.forEach((tab, index) => { + tab.addEventListener('click', () => activate(tab)); + tab.addEventListener('keydown', (event) => { + let targetIndex; + if (event.key === 'ArrowRight') targetIndex = (index + 1) % tabs.length; + if (event.key === 'ArrowLeft') targetIndex = (index - 1 + tabs.length) % tabs.length; + if (event.key === 'Home') targetIndex = 0; + if (event.key === 'End') targetIndex = tabs.length - 1; + if (targetIndex === undefined) return; + event.preventDefault(); + activate(tabs[targetIndex], true); + }); + }); + + copyButton.addEventListener('click', async () => { + const selected = tabs.find((tab) => tab.getAttribute('aria-selected') === 'true'); + const panel = panels.find((candidate) => candidate.id === selected.getAttribute('aria-controls')); + const code = panel.querySelector('pre code').textContent; + try { + await navigator.clipboard.writeText(code); + copyStatus.textContent = 'Copied'; + } catch { + copyStatus.textContent = 'Copy unavailable. Select the code to copy it.'; + } + }); + }); +}); diff --git a/docs/robots.txt b/docs/robots.txt deleted file mode 100644 index 31a7c90..0000000 --- a/docs/robots.txt +++ /dev/null @@ -1,4 +0,0 @@ -User-agent: * -Allow: / - -Sitemap: https://donmanueldev.github.io/nativephp-charts/sitemap.xml diff --git a/docs/sitemap.xml b/docs/sitemap.xml deleted file mode 100644 index 1059d51..0000000 --- a/docs/sitemap.xml +++ /dev/null @@ -1,8 +0,0 @@ - - - https://donmanueldev.github.io/nativephp-charts/ - https://donmanueldev.github.io/nativephp-charts/guides/installation/ - https://donmanueldev.github.io/nativephp-charts/guides/cartesian-charts/ - https://donmanueldev.github.io/nativephp-charts/guides/radial-charts/ - https://donmanueldev.github.io/nativephp-charts/guides/radar-candlestick/ - diff --git a/docs/src/content.config.ts b/docs/src/content.config.ts new file mode 100644 index 0000000..2588d18 --- /dev/null +++ b/docs/src/content.config.ts @@ -0,0 +1,8 @@ +import { defineCollection } from "astro:content"; +import { docsLoader, i18nLoader } from "@astrojs/starlight/loaders"; +import { docsSchema, i18nSchema } from "@astrojs/starlight/schema"; + +export const collections = { + docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }), + i18n: defineCollection({ loader: i18nLoader(), schema: i18nSchema() }), +}; diff --git a/docs/src/content/docs/apps.md b/docs/src/content/docs/apps.md new file mode 100644 index 0000000..ab3cdd6 --- /dev/null +++ b/docs/src/content/docs/apps.md @@ -0,0 +1,17 @@ +--- +title: Apps using NativePHP Charts +description: Apps built with NativePHP Mobile that use NativePHP Charts. +--- + +## Despertá + +[Despertá](https://desperta.momotombo.dev/) is an Android alarm app built with NativePHP Mobile that uses NativePHP Charts. + +Users set a repeating alarm, answer three questions to dismiss it, and track their habit history. Alarms and habits are stored locally on the device; no account is required. + +- [Visit the Despertá website](https://desperta.momotombo.dev/) +- [View Despertá on Google Play](https://play.google.com/store/apps/details?id=dev.momotombo.desperta) + +## Add charts to your app + +Follow the [installation guide](/nativephp-charts/getting-started/installation/) to register the plugin and create a native screen, or [choose a chart type](/nativephp-charts/getting-started/overview/#choose-a-chart) for your data. diff --git a/docs/src/content/docs/charts/area.mdx b/docs/src/content/docs/charts/area.mdx new file mode 100644 index 0000000..bc478cb --- /dev/null +++ b/docs/src/content/docs/charts/area.mdx @@ -0,0 +1,56 @@ +--- +title: Area chart +description: Emphasize magnitude or composition across an ordered domain. +sidebar: { order: 2 } +--- + +import { Code } from "@astrojs/starlight/components"; +import example from "../../../../examples/area.blade.php?raw"; + +Use area for magnitude over time. Stacking answers composition questions; overlaying answers direct trend comparison. + +## When to use + +Choose area when magnitude is part of the message. Choose line when the filled baseline would exaggerate differences. + +## Minimal example + +Add this element to a native Blade view after [installing the package](/nativephp-charts/getting-started/installation/). The example includes its data; replace the values with your own. + + + +## Native preview + +
Area chart rendered by NativePHP Charts on a physical Samsung device
Android
Area chart after selecting a point on a physical Samsung device
Android · Point selection
Area chart running in the generated NativePHP iOS shell
iOS
Area chart after selecting a point in the generated NativePHP iOS shell
iOS · Point selection
+ +## Variants + +`area-mode="overlay"` compares shapes; `area-mode="stacked"` shows a changing total and its composition. + +## Customization + +The area fill, boundary line, points, grid, axes, theme, and preset remain semantic across both renderers. + +See the [style options reference](/nativephp-charts/reference/api/#style-options) for supported keys and ranges. + +## Interaction + +To handle selection, add `_select="selectPoint"` and define the method shown in [Callbacks and interactions](/nativephp-charts/guides/callbacks-interactions/). + +Use stable point IDs for selection and use a numeric, date, or datetime viewport only when users need to pan or zoom. + +## Empty and error states + +Empty series render `empty-label`. Invalid PHP data raises an `InvalidArgumentException`; a snapshot rejected by the native renderer displays `error-label`. + +## Accessibility + +Describe each series and its unit. Do not rely on fill color alone; preserve distinct legend names. + +## API + +Area adds `area-mode` (or `stacking`) and the `area` style section to the common Cartesian contract. + +## Troubleshooting + +If a stack appears wrong, confirm every series uses the same ordered x domain. See [themes](/nativephp-charts/guides/themes/) and [accessibility](/nativephp-charts/guides/accessibility/). diff --git a/docs/src/content/docs/charts/bar.mdx b/docs/src/content/docs/charts/bar.mdx new file mode 100644 index 0000000..99ac28d --- /dev/null +++ b/docs/src/content/docs/charts/bar.mdx @@ -0,0 +1,57 @@ +--- +title: Bar chart +description: Compare categories with grouped or stacked bars. +sidebar: { order: 3 } +--- + +import { Code } from "@astrojs/starlight/components"; +import example from "../../../../examples/bar.blade.php?raw"; + +Use bars when precise comparison matters more than trend continuity. + +## When to use + +Choose bar for discrete categories, rankings, grouped comparisons, or compositions with a shared baseline. + +## Minimal example + +Add this element to a native Blade view after [installing the package](/nativephp-charts/getting-started/installation/). The example includes its data; replace the values with your own. + + + +## Native preview + +
Bar chart rendered by NativePHP Charts on a physical Samsung device
Android
Bar chart after selecting a bar on a physical Samsung device
Android · Bar selection
Bar chart running in the generated NativePHP iOS shell
iOS
Bar chart after selecting a bar in the generated NativePHP iOS shell
iOS · Bar selection
+ +## Variants + +- `mode="grouped"` compares peers; `mode="stacked"` compares totals and composition. +- `orientation="horizontal"` helps long category labels. + +## Customization + +Set bar radius and width through `style.bar`. Series colors and styles override the chart defaults; individual points do not accept style overrides. + +See the [style options reference](/nativephp-charts/reference/api/#style-options) for supported keys and ranges. + +## Interaction + +To handle selection, add `_select="selectPoint"` and define the method shown in [Callbacks and interactions](/nativephp-charts/guides/callbacks-interactions/). + +Selection emits one completed callback with stable series and point IDs. Horizontal charts keep the same selection contract. + +## Empty and error states + +Empty data renders `empty-label`; malformed or duplicate IDs are rejected. Native contract failures render `error-label`. + +## Accessibility + +Use complete category labels and an `a11y-label` that names the measure and grouping. + +## API + +Bar adds `mode="grouped|stacked"`, `orientation="vertical|horizontal"`, and the `bar` style section to the Cartesian API. + +## Troubleshooting + +If labels collide, prefer horizontal orientation or fewer categories. Avoid stacked bars when users need exact internal comparisons. diff --git a/docs/src/content/docs/charts/candlestick.mdx b/docs/src/content/docs/charts/candlestick.mdx new file mode 100644 index 0000000..aa7806c --- /dev/null +++ b/docs/src/content/docs/charts/candlestick.mdx @@ -0,0 +1,60 @@ +--- +title: Candlestick chart +description: Render one ordered OHLC series without hiding price extremes. +sidebar: { order: 8 } +--- + +import { Code } from "@astrojs/starlight/components"; +import example from "../../../../examples/candlestick.blade.php?raw"; + +Use candlestick for ordered open, high, low, and close observations. The package validates every OHLC range. + +## When to use + +Choose candlestick for market sessions where the relationship between open, high, low, and close matters. + +## Minimal example + +Add this element to a native Blade view after [installing the package](/nativephp-charts/getting-started/installation/). The example includes its data; replace the values with your own. + + + +Each series contains a stable `id`, a `name`, and points with `id`, `label`, typed `x`, `open`, `high`, `low`, and `close`. + +## Native preview + +
Candlestick chart rendered by NativePHP Charts on a physical Samsung device
Android
Candlestick chart with a selected session tooltip on a physical Samsung device
Android · Candle selection
Candlestick chart with a focused OHLC domain in the generated NativePHP iOS shell
iOS
Candlestick chart after selecting a candle in the generated NativePHP iOS shell
iOS · Candle selection
+ +LTTB sampling is intentionally rejected because it can hide OHLC extremes. Selection reports close as the primary value while preserving the OHLC fields in the chart contract. + +## Variants + +Use date or datetime x values. Version 1 supports one ordered series so each candle remains unambiguous. + +## Customization + +Set rising, falling, and neutral colors plus wick width through the `candlestick` style section. + +See the [style options reference](/nativephp-charts/reference/api/#style-options) for supported keys and ranges. + +## Interaction + +To handle selection, add `_select="selectPoint"` and define the method shown in [Callbacks and interactions](/nativephp-charts/guides/callbacks-interactions/). + +Tap or scrub returns the point identity and close as the primary selection value; viewport pan and zoom use the Cartesian contract. + +## Empty and error states + +No sessions renders `empty-label`. Invalid OHLC ranges and multiple series are rejected; native contract failures render `error-label`. + +## Accessibility + +Use labels that identify the trading session and provide nearby detail when users need all four OHLC values. + +## API + +Each point requires `label`, `open`, `high`, `low`, `close`, and a typed `x` for non-category axes. Add an explicit `id` to retain selection when points are reordered. + +## Troubleshooting + +If a point is rejected, verify `low < high` and `low ≤ open/close ≤ high`. LTTB is unavailable by design. diff --git a/docs/src/content/docs/charts/contribution-heatmap.mdx b/docs/src/content/docs/charts/contribution-heatmap.mdx new file mode 100644 index 0000000..377fe51 --- /dev/null +++ b/docs/src/content/docs/charts/contribution-heatmap.mdx @@ -0,0 +1,60 @@ +--- +title: Contribution heatmap +description: Show daily activity intensity across a bounded calendar window. +sidebar: { order: 10 } +--- + +import { Code } from "@astrojs/starlight/components"; +import example from "../../../../examples/contribution-heatmap.blade.php?raw"; + +Use a contribution heatmap to reveal streaks, seasonality, and gaps. Do not use it when exact comparison between distant days is the main task. + +## When to use + +Choose a heatmap for daily intensity, streaks, gaps, and seasonal patterns across a bounded window. + +## Minimal example + +Add this element to a native Blade view after [installing the package](/nativephp-charts/getting-started/installation/). The example includes its data; replace the values with your own. + + + +Each value contains a stable `id`, ISO `date`, non-negative `value`, and optional label. + +## Native preview + +
Contribution heatmap rendered by NativePHP Charts on a physical Samsung device
Android
Contribution heatmap after selecting a day on a physical Samsung device
Android · Day selection
Contribution heatmap running in the generated NativePHP iOS shell
iOS
Contribution heatmap after selecting a day in the generated NativePHP iOS shell
iOS · Day selection
+ +The native accessibility representation exposes each populated visible day as one selectable item. Duplicate dates, negative values, or invalid ISO dates reject the snapshot; valid dates outside the configured window remain outside the visible grid. + +## Variants + +Choose a 7–371 day window, Sunday or Monday week start, and independent month and weekday labels. + +## Customization + +Provide 2–9 scale colors, an empty color, theme, preset, and semantic cell size, gap, and radius. + +See the [style options reference](/nativephp-charts/reference/api/#style-options) for supported keys and ranges. + +## Interaction + +To handle selection, add `_select="selectPoint"` and define the method shown in [Callbacks and interactions](/nativephp-charts/guides/callbacks-interactions/). + +`_select` returns the stable day ID, ISO date x value, raw count, localized value, and label. + +## Empty and error states + +No visible values renders `empty-label`. Duplicate dates and negative values are rejected; out-of-window dates are ignored by the visible grid, and native failures render `error-label`. + +## Accessibility + +Every populated day is a native selectable item. Provide labels that include enough date and count context outside color intensity. + +## API + +Required `values` contain `id`, ISO `date`, non-negative `value`, and optional `label`. Specialized props are `end-date`, `days`, `week-starts-on`, `colors`, `empty-color`, `show-month-labels`, and `show-weekday-labels`. + +## Troubleshooting + +If a day is missing, verify it falls within the inclusive window ending at `end-date` and uses `YYYY-MM-DD`. diff --git a/docs/src/content/docs/charts/donut.mdx b/docs/src/content/docs/charts/donut.mdx new file mode 100644 index 0000000..d7d2a21 --- /dev/null +++ b/docs/src/content/docs/charts/donut.mdx @@ -0,0 +1,58 @@ +--- +title: Donut chart +description: Show part-to-whole data with space for a central summary. +sidebar: { order: 6 } +--- + +import { Code } from "@astrojs/starlight/components"; +import example from "../../../../examples/donut.blade.php?raw"; + +Donut uses the same validated segment contract as pie and adds a configurable inner radius. + +## When to use + +Choose donut for a small part-to-whole view when the center carries a short total or status. + +## Minimal example + +Add this element to a native Blade view after [installing the package](/nativephp-charts/getting-started/installation/). The example includes its data; replace the values with your own. + + + +## Native preview + +
Donut chart rendered by NativePHP Charts on a physical Samsung device
Android
Donut chart after selecting a segment on a physical Samsung device
Android · Segment selection
Donut chart running in the generated NativePHP iOS shell
iOS
Donut chart after selecting a segment in the generated NativePHP iOS shell
iOS · Segment selection
+ +Use stable segment IDs to retain selection after value updates. The center is visual context, not a replacement for an accessible label or legend. + +## Variants + +Use pie for a fuller mark or adjust `inner-radius-ratio` to change the ring weight without changing data. + +## Customization + +Theme, preset, segment styles, legend, formatting, and per-segment colors share the pie contract. + +See the [style options reference](/nativephp-charts/reference/api/#style-options) for supported keys and ranges. + +## Interaction + +To handle selection, add `_select="selectPoint"` and define the method shown in [Callbacks and interactions](/nativephp-charts/guides/callbacks-interactions/). + +`_select` returns the stable segment ID, label, value, localized value, and original index. + +## Empty and error states + +Empty segments render `empty-label`; invalid totals or IDs fail PHP validation; rejected native snapshots render `error-label`. + +## Accessibility + +Do not rely on center text alone. Supply `a11y-label` and meaningful segment labels. + +## API + +Donut requires `segments` and adds `inner-radius-ratio` to the common radial API. + +## Troubleshooting + +If labels become hard to associate, enable the legend or use a bar chart. diff --git a/docs/src/content/docs/charts/line.mdx b/docs/src/content/docs/charts/line.mdx new file mode 100644 index 0000000..2427cbf --- /dev/null +++ b/docs/src/content/docs/charts/line.mdx @@ -0,0 +1,62 @@ +--- +title: Line chart +description: Show change, trends, and multiple ordered series. +sidebar: { order: 1 } +--- + +import { Code } from "@astrojs/starlight/components"; +import example from "../../../../examples/line.blade.php?raw"; + +Use a line chart for an ordered trend. Use explicit `series.id` and `point.id` values whenever selection must survive insertion or reordering. + +## When to use + +Choose line for change across time or another continuous ordered domain. Choose bar when the x values are independent categories. + +## Minimal example + +Add this element to a native Blade view after [installing the package](/nativephp-charts/getting-started/installation/). The example includes its data; replace the values with your own. + + + +`series` is an ordered list of series with `id`, `name`, `color`, and `points`. Each point contains `id`, `label`, `value`, and an optional typed `x`. + +## Native preview + +
Line chart rendered by NativePHP Charts on a physical Samsung device
Android
Line chart after selecting a point on a physical Samsung device
Android · Point selection
Line chart running in the generated NativePHP iOS shell
iOS
Line chart after selecting a point in the generated NativePHP iOS shell
iOS · Point selection
+ +## Variants + +Use multiple series for direct trend comparison, and a date, datetime, or numeric x axis for continuous data. + +## Customization + +Set `theme`, `preset`, or semantic `style` sections for line width, points, grid, and axes. A series color overrides the preset palette for that series. Do not use a line chart for unordered categories. + +See the [style options reference](/nativephp-charts/reference/api/#style-options) for supported keys and ranges. + +## Interaction + +To handle selection, add `_select="selectPoint"` and define the method shown in [Callbacks and interactions](/nativephp-charts/guides/callbacks-interactions/). + +- `_select` receives one completed `PointSelection`, never an event for every animation frame. +- Number, date, and datetime axes may enable a [viewport](/nativephp-charts/guides/viewport-gestures/). +- `on-viewport-change` reports a settled pan or zoom on continuous axes. + +## Empty and error states + +An empty list renders `empty-label`. An unsupported or corrupt native snapshot renders `error-label`; invalid PHP input is rejected before rendering. + +## Accessibility + +Supply a task-oriented `a11y-label`, not a visual description such as “blue line.” Keep point labels meaningful outside the drawing. + +## API + +Line-specific style uses `line` and `points`. Cartesian attributes include `series`, `x-axis`, `y-axis`, `interaction`, `viewport`, `sampling`, and `annotations`. + +## Troubleshooting + +If selection moves after an update, replace compatibility-derived IDs with explicit stable point IDs. If vertical scrolling stalls, review [gesture ownership](/nativephp-charts/guides/viewport-gestures/). + +See the [common and Cartesian API](/nativephp-charts/reference/api/#cartesian-charts). diff --git a/docs/src/content/docs/charts/pie.mdx b/docs/src/content/docs/charts/pie.mdx new file mode 100644 index 0000000..e4d3f85 --- /dev/null +++ b/docs/src/content/docs/charts/pie.mdx @@ -0,0 +1,60 @@ +--- +title: Pie chart +description: Show a small part-to-whole snapshot. +sidebar: { order: 5 } +--- + +import { Code } from "@astrojs/starlight/components"; +import example from "../../../../examples/pie.blade.php?raw"; + +Use pie only for a small number of non-negative segments with one clear total. + +## When to use + +Choose pie for a compact part-to-whole snapshot with few segments. Choose bar when exact comparison matters. + +## Minimal example + +Add this element to a native Blade view after [installing the package](/nativephp-charts/getting-started/installation/). The example includes its data; replace the values with your own. + + + +Each segment requires a stable `id`, non-empty `label`, non-negative `value`, and an optional CSS hex `color`. At least one value must be greater than zero. + +## Native preview + +
Pie chart rendered by NativePHP Charts on a physical Samsung device
Android
Pie chart after selecting a segment on a physical Samsung device
Android · Segment selection
Pie chart running in the generated NativePHP iOS shell
iOS
Pie chart after selecting a segment in the generated NativePHP iOS shell
iOS · Segment selection
+ +Selection emits the segment ID, label, value, and index. Prefer bar charts when exact comparison matters or when the legend becomes long. + +## Variants + +Use [donut](/nativephp-charts/charts/donut/) when a central summary adds context; the data contract stays the same. + +## Customization + +Configure segment gap, corner radius, opacity, theme, preset, legend, and per-segment colors. + +See the [style options reference](/nativephp-charts/reference/api/#style-options) for supported keys and ranges. + +## Interaction + +To handle selection, add `_select="selectPoint"` and define the method shown in [Callbacks and interactions](/nativephp-charts/guides/callbacks-interactions/). + +`_select` emits one `PointSelection`; the segment ID is both the series and point ID. + +## Empty and error states + +No segments renders `empty-label`. All-zero, negative, duplicate, or malformed segments are rejected; native failures render `error-label`. + +## Accessibility + +Keep labels unique and meaningful, expose the total in nearby text, and never communicate a segment by color alone. + +## API + +Required `segments` contain `id`, `label`, `value`, and optional `color`. Pie accepts the common radial `segment` style. + +## Troubleshooting + +If the legend dominates the chart, reduce segment count or switch to bar. diff --git a/docs/src/content/docs/charts/progress.mdx b/docs/src/content/docs/charts/progress.mdx new file mode 100644 index 0000000..ae44ae9 --- /dev/null +++ b/docs/src/content/docs/charts/progress.mdx @@ -0,0 +1,56 @@ +--- +title: Progress chart +description: Compare several bounded completion values as concentric rings. +sidebar: { order: 9 } +--- + +import { Code } from "@astrojs/starlight/components"; +import example from "../../../../examples/progress.blade.php?raw"; + +Use progress for a small ordered set of values between `0` and `1`. It is not a replacement for an indeterminate loading indicator. + +## When to use + +Choose progress for several bounded goals that share a clear completion scale. + +## Minimal example + +Add this element to a native Blade view after [installing the package](/nativephp-charts/getting-started/installation/). The example includes its data; replace the values with your own. + + + +## Native preview + +
Progress chart rendered by NativePHP Charts on a physical Samsung device
Android
Progress chart with a selected ring on a physical Samsung device
Android · Ring selection
Progress chart running in the generated NativePHP iOS shell
iOS
Progress chart after selecting a ring in the generated NativePHP iOS shell
iOS · Ring selection
+ +## Variants + +Use one ring for a single goal or concentric rings for a short ordered set of related metrics. + +## Customization + +Configure semantic track color, ring thickness, spacing, and line termination through `style`. Theme and preset values apply before metric-level color overrides. + +See the [style options reference](/nativephp-charts/reference/api/#style-options) for supported keys and ranges. + +## Interaction + +To handle selection, add `_select="selectPoint"` and define the method shown in [Callbacks and interactions](/nativephp-charts/guides/callbacks-interactions/). + +`_select` emits the stable metric ID, label, value, localized value, and original index. + +## Empty and error states + +No metrics renders `empty-label`. Values outside `0...1`, duplicate IDs, and malformed colors are rejected; native failures render `error-label`. + +## Accessibility + +Metric labels must make sense without the ring. Keep `center-label` concise and include the chart purpose in `a11y-label`. + +## API + +Required `metrics` contain `id`, `label`, `value`, and optional `color`. Specialized props are `center-label` and the `ring` style section. + +## Troubleshooting + +If a percentage is rejected, pass its normalized value (`0.92`), not the displayed percentage (`92`). diff --git a/docs/src/content/docs/charts/radar.mdx b/docs/src/content/docs/charts/radar.mdx new file mode 100644 index 0000000..52e66ec --- /dev/null +++ b/docs/src/content/docs/charts/radar.mdx @@ -0,0 +1,56 @@ +--- +title: Radar chart +description: Compare profiles across three or more declared axes. +sidebar: { order: 7 } +--- + +import { Code } from "@astrojs/starlight/components"; +import example from "../../../../examples/radar.blade.php?raw"; + +Radar requires **at least three axes**. Every series must supply one value for every axis in declared order. + +## When to use + +Choose radar for profile comparison across a stable set of dimensions, not for precise ranking. + +## Minimal example + +Add this element to a native Blade view after [installing the package](/nativephp-charts/getting-started/installation/). The example includes its data; replace the values with your own. + + + +## Native preview + +
Radar chart rendered by NativePHP Charts on a physical Samsung device
Android
Radar chart with a selected axis tooltip on a physical Samsung device
Android · Axis selection
Radar chart running in the generated NativePHP iOS shell
iOS
Radar chart after selecting an axis in the generated NativePHP iOS shell
iOS · Axis selection
+ +## Variants + +Compare a small number of series against the same ordered axes. Keep axis order fixed between renders. + +## Customization + +Theme and preset colors apply before series overrides; configure grid levels, fill opacity, lines, points, and grid styles semantically. + +See the [style options reference](/nativephp-charts/reference/api/#style-options) for supported keys and ranges. + +## Interaction + +To handle selection, add `_select="selectPoint"` and define the method shown in [Callbacks and interactions](/nativephp-charts/guides/callbacks-interactions/). + +`_select` identifies the series and selected axis value with stable series and axis IDs. + +## Empty and error states + +An empty series list with at least three valid axes renders the empty state. Fewer than three axes and incomplete, out-of-order, or out-of-range values are rejected atomically. + +## Accessibility + +Keep labels short, units explicit, and ordering consistent. Pair exact comparisons with a table. + +## API + +Radar requires `axes` and `series`; specialized props are `grid-levels` and `fill-opacity`. + +## Troubleshooting + +If validation says values are out of order, match each series value list exactly to the declared axis order. diff --git a/docs/src/content/docs/charts/scatter.mdx b/docs/src/content/docs/charts/scatter.mdx new file mode 100644 index 0000000..4c1e12f --- /dev/null +++ b/docs/src/content/docs/charts/scatter.mdx @@ -0,0 +1,56 @@ +--- +title: Scatter chart +description: Show correlation, clustering, and outliers. +sidebar: { order: 4 } +--- + +import { Code } from "@astrojs/starlight/components"; +import example from "../../../../examples/scatter.blade.php?raw"; + +Scatter points require numeric `x` values by default. Give every observation a stable point ID. + +## When to use + +Choose scatter to inspect correlation, clusters, gaps, and outliers between two measures. + +## Minimal example + +Add this element to a native Blade view after [installing the package](/nativephp-charts/getting-started/installation/). The example includes its data; replace the values with your own. + + + +## Native preview + +
Scatter chart rendered by NativePHP Charts on a physical Samsung device
Android
Scatter chart after selecting a point on a physical Samsung device
Android · Point selection
Scatter chart running in the generated NativePHP iOS shell
iOS
Scatter chart after selecting a point in the generated NativePHP iOS shell
iOS · Point selection
+ +## Variants + +Use multiple series to compare cohorts. Numeric and datetime x axes support continuous viewports. + +## Customization + +Use point size and color to distinguish series without encoding critical meaning through color alone. + +See the [style options reference](/nativephp-charts/reference/api/#style-options) for supported keys and ranges. + +## Interaction + +To handle selection, add `_select="selectPoint"` and define the method shown in [Callbacks and interactions](/nativephp-charts/guides/callbacks-interactions/). + +A selection reports the series, point, x value, numeric value, and label. Pan and zoom are available for continuous axes. + +## Empty and error states + +An empty series list renders `empty-label`. Missing numeric x values are invalid; a rejected native snapshot uses `error-label`. + +## Accessibility + +Give every point a useful label and provide a text summary for dense distributions or important outliers. + +## API + +Scatter uses the Cartesian contract, defaults x to `number`, and accepts `points`, `grid`, and `axis` style sections. + +## Troubleshooting + +For dense plots, reduce the displayed range or measure a sampling strategy before hiding observations. See [performance and evidence](/nativephp-charts/guides/performance-evidence/). diff --git a/docs/src/content/docs/getting-started/installation.md b/docs/src/content/docs/getting-started/installation.md new file mode 100644 index 0000000..8a66730 --- /dev/null +++ b/docs/src/content/docs/getting-started/installation.md @@ -0,0 +1,106 @@ +--- +title: Installation +description: Install the plugin and render your first chart in a NativePHP Mobile screen. +sidebar: + order: 2 +--- + +## Requirements + +Start with an existing NativePHP Mobile application and a working native development environment. + +| Dependency | Required version | +| --- | --- | +| PHP | 8.4 or newer within PHP 8 | +| NativePHP Mobile | 4.x | +| iOS deployment target | 18.2 or newer | +| Android minimum SDK | API 26 or newer | + +Charts render inside NativePHP Mobile native screens. NativePHP Desktop and browser or WebView rendering are not supported. + +## Install and register + +Run these commands from your application's root directory: + +```bash +composer require donmanueldev/nativephp-charts +php artisan vendor:publish --tag=nativephp-plugins-provider --no-interaction +php artisan native:plugin:register donmanueldev/nativephp-charts --no-interaction +php artisan native:plugin:list +php artisan native:plugin:validate +``` + +Publishing creates `app/Providers/NativeServiceProvider.php` if it does not already exist. Registration adds `NativePHPChartsServiceProvider::class` to that provider's `plugins()` list so the native build includes the renderers. Composer installation alone does not enable the plugin. + +Confirm that `native:plugin:list` shows `donmanueldev/nativephp-charts` as registered, and resolve any validation errors before building. + +## Create a native screen + +Create `app/NativeComponents/SalesDashboard.php`: + +```php + + Monthly revenue + + + +``` + +Give the chart an explicit height. Keep series and point IDs stable when updating values so a selection can still identify the same item. + +## Build and open the screen + +Run the command for your target platform: + +| Target | Command | +| --- | --- | +| iOS | `php artisan native:run ios --start-url=/sales` | +| Android | `php artisan native:run android --start-url=/sales` | + +Rebuild after installing or updating the package: hot reload cannot add or replace compiled native renderer code. The screen should display three revenue points. + +If the chart does not appear, check its height, plugin registration, and build output. See [troubleshooting](/nativephp-charts/guides/troubleshooting/) for the next steps, or add a [selection callback](/nativephp-charts/guides/callbacks-interactions/) to the example. diff --git a/docs/src/content/docs/getting-started/overview.md b/docs/src/content/docs/getting-started/overview.md new file mode 100644 index 0000000..cf60c64 --- /dev/null +++ b/docs/src/content/docs/getting-started/overview.md @@ -0,0 +1,39 @@ +--- +title: Overview +description: Add native charts to NativePHP Mobile screens with Blade and PHP. +sidebar: + order: 1 +--- + +NativePHP Charts adds ten chart types to NativePHP Mobile. Declare charts in Blade, pass data from PHP, and handle selections in your `NativeComponent`. Rendering uses Swift Charts and SwiftUI on iOS, and Jetpack Compose Canvas on Android. + +## Start here + +1. [Install the plugin](/nativephp-charts/getting-started/installation/) and create a native screen. +2. Choose a chart below and adapt its data example. +3. Add [selection callbacks](/nativephp-charts/guides/callbacks-interactions/) and [theme presets](/nativephp-charts/guides/themes/) as needed. + +## Choose a chart + +| What you want to show | Chart | +| --- | --- | +| Change over time | [Line](/nativephp-charts/charts/line/) or [area](/nativephp-charts/charts/area/) | +| Comparison between categories | [Bar](/nativephp-charts/charts/bar/) | +| Relationship between numeric values | [Scatter](/nativephp-charts/charts/scatter/) | +| Parts of a total | [Pie](/nativephp-charts/charts/pie/) or [donut](/nativephp-charts/charts/donut/) | +| Comparison across several dimensions | [Radar](/nativephp-charts/charts/radar/) | +| Open, high, low, and close prices | [Candlestick](/nativephp-charts/charts/candlestick/) | +| Progress toward goals | [Progress](/nativephp-charts/charts/progress/) | +| Daily activity over a date range | [Contribution heatmap](/nativephp-charts/charts/contribution-heatmap/) | + +## Data and updates + +Chart data is validated in PHP before rendering. Each chart guide documents its required fields and supported options; invalid values raise an `InvalidArgumentException`. Empty data is supported and displays the chart's `empty-label`. + +Use explicit, stable IDs for series and their points, segments, metrics, or days. Callbacks return those IDs so your application can identify an item after values change or data is reordered. Update the component's data and let its next render update the chart. + +## Platform scope + +The plugin targets NativePHP Mobile 4.x, iOS 18.2+, and Android API 26+. It renders native views and does not supply a browser chart or NativePHP Desktop integration. + +Use the [API reference](/nativephp-charts/reference/api/) to look up shared properties, and each chart's guide for chart-specific options and platform limitations. diff --git a/docs/src/content/docs/guides/accessibility.md b/docs/src/content/docs/guides/accessibility.md new file mode 100644 index 0000000..05dc17e --- /dev/null +++ b/docs/src/content/docs/guides/accessibility.md @@ -0,0 +1,28 @@ +--- +title: Accessibility +description: Build charts that remain understandable with assistive technology and reduced motion. +sidebar: { order: 4 } +--- + +Charts expose native accessibility elements to VoiceOver and TalkBack. Provide context with `a11y-label` and an actionable failure with `error-label`. + +```blade + +``` + +## Checklist + +- Describe the measure and domain, not color or geometry. +- Give each series, point, segment, metric, and day a stable meaningful label. +- Do not make color the only distinction; keep legend names explicit. +- Verify focus after data insertion, reordering, deletion, and emptying. +- Verify enlarged text and screen-reader traversal in a scroll container. +- Respect the operating system's reduced-motion preference even when `animated` is enabled. +- Pair dense or comparison-critical visualizations with a readable text summary or table. + +Accessibility metadata in source is only a contract. Record separate VoiceOver and TalkBack evidence from installed native builds. diff --git a/docs/src/content/docs/guides/callbacks-interactions.md b/docs/src/content/docs/guides/callbacks-interactions.md new file mode 100644 index 0000000..77a5d37 --- /dev/null +++ b/docs/src/content/docs/guides/callbacks-interactions.md @@ -0,0 +1,79 @@ +--- +title: Callbacks and interactions +description: Handle chart selections in a NativeComponent and configure Cartesian chart gestures. +sidebar: { order: 2 } +--- + +Bind `_select` to a public method on the `NativeComponent` that renders the chart. The method receives the selection as a JSON string. Native selection and tooltip updates do not need to wait for PHP. + +## Handle a selection + +Start with the `SalesDashboard` screen from [installation](/nativephp-charts/getting-started/installation/). Add this import to `app/NativeComponents/SalesDashboard.php`: + +```php +use Donmanueldev\NativephpCharts\PointSelection; +``` + +Add the property and method inside the `SalesDashboard` class, alongside `render()`: + +```php +public ?string $selectedPoint = null; + +public function selectPoint(string $payload): void +{ + $selection = PointSelection::fromJson($payload); + + $this->selectedPoint = "{$selection->label}: {$selection->localizedValue}"; +} +``` + +Add `_select="selectPoint"` to the existing `` in `resources/views/native/sales-dashboard.blade.php`. Place this text below the chart, inside the same ``: + +```blade +@if ($selectedPoint !== null) + {{ $selectedPoint }} +@endif +``` + +Tapping a point now updates the text below the chart. For charts created with the fluent PHP interface, use `->onSelect('selectPoint')`. + +## Selection payload + +`PointSelection::fromJson()` validates the JSON and returns a typed object. Invalid JSON, unsupported versions, missing fields, and invalid field values raise an `InvalidArgumentException`. + +| Object property | Meaning | +| --- | --- | +| `version` | Payload version; currently `1` | +| `chartType` | Chart family, such as `line` or `contribution_heatmap` | +| `seriesId`, `seriesName` | Selected series identity and display name | +| `pointId` | Stable selected item ID | +| `pointIndex` | Original zero-based index in the source data, including after sampling | +| `xType`, `x` | X type (`category`, `number`, `date`, `datetime`) and its value | +| `label` | Selected item's display label | +| `value` | Raw numeric value | +| `localizedValue` | Formatted value for display | + +Use IDs, `value`, and `x` for application logic. Use `localizedValue` only as presentation text. + +Pie and donut use the segment ID for both `seriesId` and `pointId`. Progress uses the metric ID for both. Contribution heatmap uses the day ID for both and a `date` x value. + +## Cartesian interaction options + +Line, area, bar, scatter, and candlestick charts accept an `interaction` map. Add it to the chart alongside its existing data attributes: + +```blade + :interaction="['mode' => 'tap', 'crosshair' => 'x', 'tooltip' => 'single']" +``` + +| Option | Values | Default | +| --- | --- | --- | +| `enabled` | Boolean; disables selection interaction when `false` | `true` | +| `mode` | `tap` or `scrub` | `tap` | +| `crosshair` | `none`, `x`, `y`, or `both` | `x` | +| `tooltip` | `single` or `shared` | `single` | + +`tap` selects one item. `scrub` previews nearby values while dragging and emits a callback when the gesture completes. `shared` tooltips show values from multiple series at the selected x position. Crosshair and tooltip options apply to Cartesian charts; radial and other chart families use their own selection presentation. + +A selection callback is not a per-frame gesture stream. For a chart inside a scrolling screen, start with `tap`. Scrubbing cannot be combined with an enabled panning viewport; see [viewport and gestures](/nativephp-charts/guides/viewport-gestures/). + +Use explicit IDs for interactive data. Automatically generated point IDs can change when the data is reordered. diff --git a/docs/src/content/docs/guides/migration.md b/docs/src/content/docs/guides/migration.md new file mode 100644 index 0000000..0f190ba --- /dev/null +++ b/docs/src/content/docs/guides/migration.md @@ -0,0 +1,23 @@ +--- +title: Migration +description: Adopt stable identities, versioned callbacks, themes, and new chart families safely. +sidebar: { order: 7 } +--- + +## Existing 1.x charts + +Existing chart tags remain valid. Migrate interactive data first: + +1. Add stable `series.id` and `point.id` values. +2. Decode callbacks with `PointSelection::fromJson()` instead of parsing ad hoc JSON. +3. Add `empty-label`, `error-label`, and a task-oriented `a11y-label`. +4. Choose `theme="system"` and a registered preset; retain existing semantic style overrides. +5. Rebuild and validate both native targets. + +Compatibility-generated point IDs remain available in 1.x, but selection retention after reordering requires explicit IDs. + +## New chart families + +Progress and contribution heatmap use the same version 1 selection envelope as existing charts. Consumers can extend an exhaustive `chart_type` match with `progress` and `contribution_heatmap` without changing callback transport. + +Publish native plugin updates through the platform compilation and native runtime validation workflow. diff --git a/docs/src/content/docs/guides/performance-evidence.md b/docs/src/content/docs/guides/performance-evidence.md new file mode 100644 index 0000000..d98327c --- /dev/null +++ b/docs/src/content/docs/guides/performance-evidence.md @@ -0,0 +1,42 @@ +--- +title: Performance and validation +description: Size datasets, profile native rendering, and validate interactions in your app. +sidebar: { order: 5 } +--- + +Chart performance depends on the device, number of points, labels, animation, and enabled gestures. Measure the chart inside your app's actual screen and scrolling layout. + +## Start with the visible data + +- Send the date range or categories the screen needs, rather than the full history. +- Limit labels and visible series when they make the chart difficult to read. +- Disable animation with `:animated="false"` when frequently replacing a large dataset. +- Use a [viewport](/nativephp-charts/guides/viewport-gestures/) when users need to inspect a continuous range. A viewport controls the visible domain; it does not fetch or paginate data. + +## Sampling + +LTTB reduces the points drawn in supported line, area, and scatter charts. It can change which observations are visible, so compare the sampled result against the original data before enabling it. Source IDs and indices identify the original selected point. + +Bar, candlestick, and stacked area charts reject LTTB. In particular, removing a candle could hide a price extreme. See the [sampling options](/nativephp-charts/reference/api/#sampling) for supported values and limits. + +## Profile representative datasets + +Measure a small dataset, your typical dataset, and the largest dataset the app allows. Keep the device, build configuration, data, and interaction sequence fixed when comparing changes. + +| Measure | What to check | +| --- | --- | +| Payload size | Serialized bytes passed from PHP to the native renderer | +| First render | Time until the chart appears after opening the screen | +| Frame timing | Slow frames during updates, scrolling, selection, pan, and zoom | +| Memory | Peak usage and whether it recovers after leaving the screen | +| Callbacks | One selection callback per completed interaction, without duplicate application updates | + +Use Android Studio's profiler or Perfetto on Android and Instruments on iOS. Simulator timings are useful for diagnosing changes, but measure final frame and memory behavior on the devices you support. + +## Validate in your app + +PHP validation checks data shapes and options. A successful native build checks compilation. Neither verifies how gestures, scrolling, or accessibility behave in your screen. + +Before shipping, test empty and populated data, updates and reordered IDs, selection, navigation away and back, and enabled viewport gestures. Check VoiceOver or TalkBack, larger text, light and dark appearance, and reduced motion on each platform you support. + +The chart guides show native previews of default and selected states. Those images demonstrate appearance; they are not a performance benchmark or a guarantee for your app's device and dataset. diff --git a/docs/src/content/docs/guides/themes.md b/docs/src/content/docs/guides/themes.md new file mode 100644 index 0000000..5869c9d --- /dev/null +++ b/docs/src/content/docs/guides/themes.md @@ -0,0 +1,73 @@ +--- +title: Themes and presets +description: Choose light or dark appearance, use built-in palettes, and define application presets. +sidebar: { order: 1 } +--- + +Every chart accepts a `theme` and a `preset`: + +| Property | Accepted values | Default | +| --- | --- | --- | +| `theme` | `light`, `dark`, `system` | `system` | +| `preset` | `default`, `spectrum`, `contrast`, or a registered application preset | `default` | + +`system` follows the host appearance. A preset supplies colors for both appearances, including the chart background, text, grid, and data palette. + +In the [installation example](/nativephp-charts/getting-started/installation/#add-the-chart), add these attributes to the existing line chart: + +```blade + theme="system" + preset="spectrum" + :style="['line' => ['width' => 3]]" +``` + +Remove the series' explicit `color` if you want it to use the preset palette. + +## Register an application preset + +Publish the configuration from your application's root directory: + +```bash +php artisan vendor:publish --tag=nativephp-charts-config --no-interaction +``` + +Add your preset to `presets` in `config/nativephp-charts.php`: + +```php + [ + 'product' => [ + 'light' => [ + 'background' => '#FFFFFF', + 'foreground' => '#111111', + 'palette' => ['#ED3F16', '#2563EB', '#0F766E'], + ], + 'dark' => [ + 'background' => '#080808', + 'foreground' => '#FFFFFF', + 'palette' => ['#FF7A4D', '#60A5FA', '#2DD4BF'], + ], + ], + ], +]; +``` + +Use `preset="product"` on a chart. A new preset inherits unspecified values from `default`; an application preset named `spectrum`, for example, overrides the built-in `spectrum` values instead. You can override either or both appearances. + +## Available tokens + +| Token | Purpose | +| --- | --- | +| `background` | Chart background | +| `foreground` | Primary text | +| `muted` | Secondary text | +| `grid` | Grid lines | +| `track` | Unfilled progress track | +| `error` | Error-state text | +| `palette` | Ordered list of 1–24 data colors | + +Colors accept CSS hex (`#RGB`, `#RRGGBB`, or `#RRGGBBAA`), `black`, `white`, and `transparent`. Tailwind color names and CSS functions such as `rgb()` are not accepted by chart presets. + +Explicit series, segment, or metric colors override the palette. Chart-specific `style` options control geometry such as line width and point size; see the [style options reference](/nativephp-charts/reference/api/#style-options) for supported keys and values. Unknown preset names, unsupported appearance tokens, invalid colors, and empty palettes raise an `InvalidArgumentException`. diff --git a/docs/src/content/docs/guides/troubleshooting.md b/docs/src/content/docs/guides/troubleshooting.md new file mode 100644 index 0000000..1810d53 --- /dev/null +++ b/docs/src/content/docs/guides/troubleshooting.md @@ -0,0 +1,29 @@ +--- +title: Troubleshooting +description: Diagnose registration, validation, rendering, payload, and interaction problems. +sidebar: { order: 6 } +--- + +## The component is missing + +Run `php artisan native:plugin:list` and `php artisan native:plugin:validate`, then rebuild the native target. Hot reload cannot install native renderers. + +## The chart shows “Chart unavailable” + +The renderer rejected an unsupported contract version, corrupt file-backed payload, or invalid snapshot. Check structured application logs without logging the complete payload or user data. Keep `error-label` actionable for users. + +## The chart is empty + +Confirm the collection is non-empty and follows the exact shape for the chart. Empty data intentionally renders `empty-label`; it is not treated as a failure. + +## Selection changes after updating data + +Use explicit stable IDs for every series and point. Compatibility-derived point IDs preserve older code but do not guarantee retention after reordering. + +## Pan or scrub blocks page scrolling + +Do not combine scrub with one-finger viewport pan. Reproduce inside the real scroll container and verify gesture cancellation on both platforms. + +## Theme colors do not match + +Check precedence: built-in preset, application preset, chart style, then item override. Ensure colors use CSS hex syntax and rebuild after changing native package code. diff --git a/docs/src/content/docs/guides/viewport-gestures.md b/docs/src/content/docs/guides/viewport-gestures.md new file mode 100644 index 0000000..8cf9f45 --- /dev/null +++ b/docs/src/content/docs/guides/viewport-gestures.md @@ -0,0 +1,90 @@ +--- +title: Viewport and gestures +description: Configure x-axis pan and zoom, range limits, and settled viewport callbacks. +sidebar: { order: 3 } +--- + +Line, area, bar, scatter, and candlestick charts support an initial viewport on `number`, `date`, or `datetime` x axes. Category axes do not support viewports. + +## Set an initial range + +Each point must include a date `x`, such as `'2026-01-15'`. This example opens January through March and limits zoom to a seven-day span: + +```blade + +``` + +| Option | Type and behavior | Default | +| --- | --- | --- | +| `enabled` | Boolean; enables the configured range | `false` | +| `minimum`, `maximum` | Bounds matching the x-axis type; supply both with `minimum < maximum` | Required when enabled | +| `pan` | Boolean; enables one-finger viewport panning | `true` | +| `zoom` | Boolean; enables pinch zoom | `true` | +| `minimumSpan` | Positive number no greater than the initial range | One thousandth of the full domain, with a floor of `0.000001` axis units | + +`minimumSpan` uses **axis units for number axes and seconds for date/datetime axes**. Seven days is `604800`, not `7`. A numeric axis with `minimumSpan: 7` uses seven numeric units. + +## Handle a range change + +The renderer emits one callback after the gesture settles. Import `ViewportChange` before your `NativeComponent` class, and add the property and method inside the class, as in the [selection callback guide](/nativephp-charts/guides/callbacks-interactions/#handle-a-selection): + +```php +use Donmanueldev\NativephpCharts\ViewportChange; + +public array $visibleRange = []; + +public function viewportChanged(string $payload): void +{ + $change = ViewportChange::fromJson($payload); + + $this->visibleRange = [ + 'minimum' => $change->minimum, + 'maximum' => $change->maximum, + ]; +} +``` + +The decoded event exposes `chartType`, `axis`, `reason`, `xType`, `minimum`, and `maximum`. Version 1 reports only the `x` axis, with reason `pan`, `zoom`, or `pan_zoom`. Bounds retain the declared x type. Invalid payloads throw `InvalidArgumentException`. + +Use the callback to store the visible range or load additional data. It is not a per-frame gesture stream. + +## Combine selection and scrolling + +Tap selection is the default and can be combined with viewport pan and zoom. Scrub selection uses the same one-finger gesture as panning, so the package rejects `interaction.mode: 'scrub'` together with an enabled viewport and `pan: true`. + +To allow scrub selection and pinch zoom, disable panning: + +```blade +:interaction="['mode' => 'scrub']" +:viewport="[ + 'enabled' => true, + 'minimum' => '2026-01-01', + 'maximum' => '2026-03-31', + 'pan' => false, + 'zoom' => true, +]" +``` + +When the chart is inside a scroll container, verify vertical scrolling, horizontal panning, pinch zoom, and interrupted gestures on the app's target devices. The enclosing layout determines how those gestures compete. See [callbacks and interactions](/nativephp-charts/guides/callbacks-interactions/) for selection payloads. diff --git a/docs/src/content/docs/reference/api.md b/docs/src/content/docs/reference/api.md new file mode 100644 index 0000000..1a6145d --- /dev/null +++ b/docs/src/content/docs/reference/api.md @@ -0,0 +1,191 @@ +--- +title: API reference +description: Blade attributes, data requirements, defaults, and chart-specific options. +--- + +Use self-closing `` elements inside a NativePHP Mobile view. Bind PHP arrays, numbers, and booleans with `:`; pass literal strings without it. + +```blade + +``` + +Start with [installation](/nativephp-charts/getting-started/installation/) for a complete first chart. These tables describe public Blade attributes; the package handles native JSON fields. + +## Common attributes + +These attributes are accepted by all ten chart elements. + +| Attribute | Accepted value | Default | +| --- | --- | --- | +| `animated` | Boolean; system reduced-motion settings take precedence | `true` | +| `empty-label` | Non-empty text for an empty dataset | `No data` | +| `error-label` | Non-empty text for a snapshot rejected by the native renderer | `Chart unavailable` | +| `a11y-label` | Non-empty chart description for assistive technology | `Chart` | +| `theme` | `light`, `dark`, `system` | `system` | +| `preset` | Built-in or application-defined preset name | `default` | +| `style` | Array of chart-specific style sections; see below | `[]` | +| `legend` | Array of visibility, placement, and text options | Automatic visibility | +| `locale` | BCP-47 locale tag, such as `en-US` or `es-NI` | System locale | +| `value-format` | `number`, `currency`, `percent` | `number` | +| `currency-code` | Three-letter currency code; required for `currency` | Unset | +| `minimum-fraction-digits` | Integer from `0` to `8` | Native formatter default | +| `maximum-fraction-digits` | Integer from `0` to `8`; must be at least the configured minimum | Native formatter default | +| `_select` | Callback method name | No callback | + +Colors accept `#RGB`, `#RRGGBB`, CSS `#RRGGBBAA`, `black`, `white`, or `transparent`. Omit a series, segment, or metric color to use the preset palette. See [themes and presets](/nativephp-charts/guides/themes/) for overrides. + +### Legend + +For charts with series, segments, or metrics, `visible: 'auto'` shows the legend when there is more than one item. The contribution heatmap has no series legend. + +| Key | Accepted value | Default | +| --- | --- | --- | +| `visible` | `true`, `false`, `'auto'` | `'auto'` | +| `position` | `top`, `bottom`, `leading`, `trailing` | `bottom` | +| `alignment` | `start`, `center`, `end` | `center` | +| `style` | `font`, `fontSize`, `labelColor`, `markerSize` | Preset/native defaults | + +`fontSize` and `markerSize` must be greater than `0` and at most `32`. + +## Cartesian charts + +[Line](/nativephp-charts/charts/line/), [area](/nativephp-charts/charts/area/), [bar](/nativephp-charts/charts/bar/), [scatter](/nativephp-charts/charts/scatter/), and [candlestick](/nativephp-charts/charts/candlestick/) accept these shared attributes. + +| Attribute | Purpose and default | +| --- | --- | +| `series` | Ordered list of series; defaults to `[]` | +| `x-axis` | Category, numeric, or temporal axis; defaults to `category`, except scatter (`number`) | +| `y-axis` | Numeric scale and formatting; defaults to number formatting | +| `show-grid` | Grid visibility; defaults to `true` | +| `begin-at-zero` | Include zero in the automatic value domain; defaults to `true`, except candlestick (`false`) | +| `interaction` | Selection settings; defaults to enabled tap, x crosshair, single tooltip | +| `viewport` | Initial x-axis range and gestures; disabled by default | +| `on-viewport-change` | Callback after a viewport gesture settles; unset by default | +| `sampling` | Point reduction; defaults to `['mode' => 'none', 'threshold' => 1000]` | +| `annotations` | Ordered list of reference lines or bands, with optional labels; defaults to `[]` | + +### Series and points + +Each series requires a unique, non-empty `id`, a non-empty `name`, and an ordered `points` list. `color` and `style` are optional. Series styles cannot override chart-level `grid` or `axis` settings. + +Regular points require a non-empty `label` and a finite numeric `value`. A point `id` is optional, but use explicit IDs to keep selections stable when data changes. Point IDs must be unique within their series. Without an ID, the package derives one from the series, label, and point position. + +| `x-axis.type` | Point `x` | +| --- | --- | +| `category` | Optional non-empty string; defaults to `label` | +| `number` | Required finite integer or float | +| `date` | Required `YYYY-MM-DD` string or PHP `DateTimeInterface` | +| `datetime` | Required RFC 3339 string with `Z` or an explicit offset, or PHP `DateTimeInterface` | + +Numeric strings are not accepted as numbers. Integers must be within the exact cross-platform range of `−9,007,199,254,740,991` to `9,007,199,254,740,991`. + +Candlestick points use `open`, `high`, `low`, and `close` instead of `value`. Both open and close must lie between low and high, and `low` must be strictly less than `high`. The chart accepts zero or one series. + +### Axes + +Both axis arrays accept `visible`, `title`, `labelCount` (`2`–`12`), `minimum`, `maximum`, `baseline`, and a positive `interval`. Category x axes reject `minimum`, `maximum`, `baseline`, and `interval`. Continuous x bounds use the same types as point `x`; y bounds are numbers. When both bounds are supplied, minimum must be less than maximum, and a supplied baseline must be within them. + +The x axis also accepts `dateFormat`: `short`, `medium` (default), `long`, `full`, or `time`; and `timeZone`: an IANA name such as `America/Managua`. + +The y axis also accepts `valueFormat`, `currencyCode`, `minimumFractionDigits`, `maximumFractionDigits`, and `beginAtZero`. Formatting follows the common attribute rules above; y-axis settings override matching top-level formatting settings when both are supplied. + +### Family-specific options + +| Chart | Options and restrictions | +| --- | --- | +| Line | `show-points` defaults to `true`; optional series `fill_to` references another series ID | +| Area | `area-mode`: `overlay` (default) or `stacked`; `show-points` defaults to `true`; supports `fill_to` | +| Bar | `mode`: `grouped` (default) or `stacked`; `orientation`: `vertical` (default) or `horizontal` | +| Scatter | Numeric x axis by default; point appearance uses `style.points` | +| Candlestick | At most one OHLC series; automatic value domain excludes zero by default | + +### Sampling + +LTTB sampling (`mode: 'lttb'`) is available only for line, area, and scatter. Set `threshold` to an integer from `3` to `100000`. LTTB cannot be combined with `fill_to` or stacked area mode. Bar and candlestick reject LTTB because removing observations would change their meaning. + +### Annotations + +Add reference lines or bands to any Cartesian chart. Each annotation requires a unique, non-empty `id`, a `type` (`line` or `band`), and an `axis` (`x` or `y`). For example, add a revenue target and a target range to the line chart above: + +```blade +:annotations="[ + ['id' => 'target', 'type' => 'line', 'axis' => 'y', 'value' => 5000, 'label' => 'Target'], + ['id' => 'range', 'type' => 'band', 'axis' => 'y', 'from' => 4000, 'to' => 6000, 'opacity' => 0.1], +]" +``` + +| Type | Required values | Optional appearance | +| --- | --- | --- | +| `line` | `value` | `width`: `0.000001`–`16`, default `1` | +| `band` | `from`, `to`; continuous axes require `from < to` | `opacity`: `0`–`1`, default `0.12` | + +Both types accept a non-empty `label` and a `color` (default `#6366F1`). Y-axis values are finite numbers; x-axis values match the declared x type, including category strings. A line does not accept band options, and a band does not accept `value` or `width`. + +## Radial and specialized charts + +All data below uses ordered lists. Empty data displays `empty-label`; radar still requires its declared axes. + +| Element | Data requirements | Additional attributes | +| --- | --- | --- | +| [Pie](/nativephp-charts/charts/pie/) | `segments`: unique `id`, `label`, non-negative `value`, optional `color`; a non-empty list needs a positive value | None | +| [Donut](/nativephp-charts/charts/donut/) | Same `segments` contract as pie | `inner-radius-ratio`: `0.2`–`0.85`, default `0.6` | +| [Radar](/nativephp-charts/charts/radar/) | `axes`: `3`–`24` unique axes with `id`, `label`, positive `maximum`; `series`: `id`, `name`, optional `color`, and one `{axis, value}` entry per axis, in declared order; values range from zero to the axis maximum | `grid-levels`: `2`–`10`, default `5`; `fill-opacity`: `0`–`1`, default `0.22` | +| [Progress](/nativephp-charts/charts/progress/) | `metrics`: up to `24` entries with unique `id`, `label`, `value` from `0` to `1`, optional `color` | `center-label`: optional text | +| [Contribution heatmap](/nativephp-charts/charts/contribution-heatmap/) | `values`: up to `10000` entries with unique `id` and `date` (`YYYY-MM-DD`), non-negative `value`, optional `label` | See the heatmap page for the date window, color scale, and label settings | + +## Style sections + +Use only the sections listed for the chart family. Unsupported sections and keys are rejected. + +| Chart | Accepted `style` sections | +| --- | --- | +| Line | `line`, `points`, `grid`, `axis` | +| Area, radar | `line`, `area`, `points`, `grid`, `axis` | +| Bar | `bar`, `grid`, `axis` | +| Scatter | `points`, `grid`, `axis` | +| Candlestick | `bar`, `candlestick`, `grid`, `axis` | +| Pie, donut | `segment` | +| Progress | `ring` | +| Contribution heatmap | `cell`, `axis` | + +### Style options + +Each section is an array. All options are optional; omitted values use the preset or renderer defaults. Colors follow the formats listed under [common attributes](#common-attributes). Numeric values must be finite PHP integers or floats. Ranges below include both endpoints unless shown as `> 0`. + +| Section | Supported keys and values | +| --- | --- | +| `line` | `color`; `width`: `> 0` to `16`; `interpolation`: `linear`, `smooth`, `step_before`, `step_after`; `dash`: an ordered list of `2`, `4`, `6`, or `8` numbers, each `> 0` to `128` | +| `area` | `opacity`: `0`–`1`; `gradient`: boolean | +| `bar` | `radius`: `0`–`32`; `width`: `> 0` to `128` | +| `candlestick` | `risingColor`, `fallingColor`, `neutralColor`; `wickWidth`: `> 0` to `8` | +| `segment` | `gap`: `0`–`12`; `cornerRadius`: `0`–`20`; `opacity`: `0`–`1` | +| `ring` | `trackColor`; `width`: `> 0` to `64`; `gap`: `0`–`32`; `cap`: `round` or `butt` | +| `cell` | `size`: `> 0` to `64`; `gap`: `0`–`16`; `cornerRadius`: `0`–`16` | +| `points` | `visible`: boolean; `color`; `size`: `> 0` to `24` | +| `grid` | `visible`: boolean; `color`; `width`: `> 0` to `8` | +| `axis` | `visible`: boolean; `color`, `labelColor`; `font`: non-empty font name; `fontSize`: `> 0` to `32`; `labelCount`: integer `2`–`12` | + +Radar rejects `axis.labelCount`. The camelCase keys in this table also accept snake_case aliases, such as `wick_width` and `label_color`. `bar.radius` also accepts `cornerRadius` or `corner_radius`. + +For an area chart, configure the outline and fill together: + +```blade +:style="[ + 'line' => ['width' => 2, 'interpolation' => 'smooth'], + 'area' => ['opacity' => 0.25, 'gradient' => true], + 'points' => ['visible' => false], +]" +``` + +Use the family table above before combining sections: for example, `area` is valid for area and radar charts but rejected by line charts. + +## Callbacks and validation + +Use `PointSelection::fromJson($payload)` for `_select` callbacks and `ViewportChange::fromJson($payload)` for settled x-axis changes. Both validate version 1 payloads and throw `InvalidArgumentException` for invalid input. See [callbacks and interactions](/nativephp-charts/guides/callbacks-interactions/) and [viewport and gestures](/nativephp-charts/guides/viewport-gestures/) for handlers and configuration. + +Invalid PHP data or options throw `InvalidArgumentException` before rendering. `error-label` applies to a snapshot rejected by the native renderer; it does not catch PHP exceptions. Empty lists are valid except where a chart requires structural data, such as radar axes. diff --git a/docs/src/content/i18n/en.yml b/docs/src/content/i18n/en.yml new file mode 100644 index 0000000..fbee46c --- /dev/null +++ b/docs/src/content/i18n/en.yml @@ -0,0 +1 @@ +404.text: Page not found. Check the URL or return to the documentation. diff --git a/docs/src/layouts/Layout.astro b/docs/src/layouts/Layout.astro new file mode 100644 index 0000000..7935edd --- /dev/null +++ b/docs/src/layouts/Layout.astro @@ -0,0 +1,33 @@ +--- +const base = import.meta.env.BASE_URL.replace(/\/$/, ""); +--- + + + + + + + + + + + NativePHP Charts — documentation and examples + + + + + + + + + diff --git a/docs/src/pages/404.astro b/docs/src/pages/404.astro new file mode 100644 index 0000000..7103827 --- /dev/null +++ b/docs/src/pages/404.astro @@ -0,0 +1,63 @@ +--- +import Layout from "../layouts/Layout.astro"; + +const base = import.meta.env.BASE_URL.replace(/\/$/, ""); +--- + + +
+

404

+

Page not found

+

+ The page may have moved. Return to the documentation to find the chart or + guide you need. +

+ Open the documentation +
+
+ + diff --git a/docs/src/pages/index.astro b/docs/src/pages/index.astro new file mode 100644 index 0000000..3002757 --- /dev/null +++ b/docs/src/pages/index.astro @@ -0,0 +1,253 @@ +--- +import Layout from "../layouts/Layout.astro"; +import lineExample from "../../examples/line.blade.php?raw"; +import "../styles/landing.css"; + +const base = import.meta.env.BASE_URL.replace(/\/$/, ""); +const charts = [ + { name: "Line", description: "Time series and trends", slug: "line", icon: "M4 35 18 23 31 29 45 10 60 17 76 4" }, + { name: "Area", description: "Magnitude and composition", slug: "area", icon: "M4 40V30L18 20 31 25 45 8 60 16 76 4V40Z" }, + { name: "Bar", description: "Category comparisons", slug: "bar", icon: "M10 40V24H20V40M34 40V8H44V40M58 40V17H68V40" }, + { name: "Scatter", description: "Correlation and outliers", slug: "scatter", icon: "M12 32h1M23 22h1M34 29h1M42 14h1M55 20h1M67 7h1" }, + { name: "Pie", description: "Part-to-whole snapshots", slug: "pie", icon: "M40 22V3A19 19 0 1 0 59 22ZM45 17H64A19 19 0 0 0 45 0Z" }, + { name: "Donut", description: "Part-to-whole with a center", slug: "donut", icon: "M40 3a19 19 0 1 0 .1 0M40 13a9 9 0 1 1-.1 0" }, + { name: "Radar", description: "Multi-axis profiles", slug: "radar", icon: "M40 2 62 17 54 40H26L18 17ZM40 9 55 19 48 32 30 36 25 19Z" }, + { name: "Candlestick", description: "OHLC financial ranges", slug: "candlestick", icon: "M17 4V39M12 14H22V29H12ZM40 1V33M35 8H45V21H35ZM63 11V42M58 19H68V34H58Z" }, + { name: "Progress", description: "Concentric completion rings", slug: "progress", icon: "M54 7A19 19 0 1 0 59 23M45 14A10 10 0 1 0 49 25" }, + { name: "Contribution heatmap", description: "Daily activity over time", slug: "contribution-heatmap", icon: "M9 8h8v8H9ZM26 8h8v8H26ZM43 8h8v8H43ZM60 8h8v8H60ZM9 27h8v8H9ZM26 27h8v8H26ZM43 27h8v8H43ZM60 27h8v8H60Z" }, +]; + +--- + + + + +
+
+
+

Native charts for
NativePHP Mobile.

+

+ Render line, bar, pie, and seven other chart types with Swift Charts on iOS and Jetpack Compose on Android. Configure data, styles, and selection callbacks in PHP. +

+ +
    +
  • NativePHP Mobile 4
  • PHP 8.4+
  • iOS 18.2+
  • + Android API 26+ +
  • +
+
+
+
+
+ iOSSwift Charts +
+ Native iOS line chart with the March value selected +
+
+
+ AndroidJetpack Compose +
+ Native Android chart showing the temperature in Managua through the afternoon +
+
+
+ +
+
+

Add a chart in Blade.

+

+ Start with a complete chart and its data. Then customize its + appearance or handle point selections in PHP. +

+ Create your first native screen +
+
+
+ + + +
+
+
{lineExample}
+
+ + +
+ + +
+
+
+ +
+
+

Chart types

+ Each guide includes a data example, native previews, supported options, + and selection behavior. +

+
+
+ { + charts.map(({ name, description, slug, icon }) => ( + + + + {name} + {description} + + + + )) + } +
+
+ +
+
+

Apps using NativePHP Charts

+

See the package in apps built with NativePHP Mobile.

+ Explore apps +
+
+ Android +

Despertá

+

An alarm app with question challenges and habit tracking. Alarms and habit history are stored on the device, without an account.

+ Visit Despertá +
+
+
+ + +
diff --git a/docs/src/styles/docs.css b/docs/src/styles/docs.css new file mode 100644 index 0000000..b128d45 --- /dev/null +++ b/docs/src/styles/docs.css @@ -0,0 +1,139 @@ +:root { + --sl-content-width: 54rem; + --sl-color-accent-low: #401207; + --sl-color-accent: #ed3f16; + --sl-color-accent-high: #ffd7c7; + --sl-color-white: #fff; + --sl-color-gray-1: #e9e7e4; + --sl-color-gray-2: #c4c0bc; + --sl-color-gray-3: #8c8782; + --sl-color-gray-4: #57534f; + --sl-color-gray-5: #302e2c; + --sl-color-gray-6: #1d1c1b; + --sl-color-black: #0b0b0b; + --sl-font: Inter, ui-sans-serif, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; + --sl-font-mono: "SFMono-Regular", Consolas, monospace +} + +:root[data-theme='light'] { + --sl-color-accent-low: #ffe0d4; + --sl-color-accent: #a52608; + --sl-color-accent-high: #4a1408; + --sl-color-white: #171615; + --sl-color-gray-1: #262321; + --sl-color-gray-2: #403c38; + --sl-color-gray-3: #5d5752; + --sl-color-gray-4: #8c847c; + --sl-color-gray-5: #d7d3cf; + --sl-color-gray-6: #eeece9; + --sl-color-gray-7: #f7f6f4; + --sl-color-black: #fff +} + +.site-title { + font-weight: 850; + letter-spacing: -.025em +} + +.hero h1 { + letter-spacing: -.05em +} + +.sl-markdown-content h2 { + letter-spacing: -.03em +} + +.chart-proof { + display: grid; + grid-template-columns: repeat(2, minmax(0, 1fr)); + gap: 1rem; + margin-block: 1.5rem 2rem +} + +.chart-proof figure { + min-width: 0; + margin: 0; + overflow: hidden; + border: 1px solid var(--sl-color-gray-5); + border-radius: 1rem; + background: var(--sl-color-gray-6) +} + +.chart-proof img { + display: block; + width: 100%; + height: 420px; + margin: 0; + padding: 1.25rem; + object-fit: contain +} + +.chart-proof figcaption { + margin: 0; + padding: .9rem 1.1rem; + border-top: 1px solid var(--sl-color-gray-5); + background: var(--sl-color-black); + color: var(--sl-color-gray-2); + font-size: .85rem; + font-weight: 600; + line-height: 1.5 +} + +.proof-pending { + display: grid; + min-height: 220px; + place-items: center; + padding: 2rem; + border: 1px dashed var(--sl-color-gray-4); + border-radius: .75rem; + color: var(--sl-color-gray-2); + text-align: center +} + +.api-table { + font-size: .9rem +} + +.api-table code { + white-space: nowrap +} + +.status-callout { + padding: 1rem 1.2rem; + border-left: 4px solid var(--sl-color-accent); + background: var(--sl-color-accent-low) +} + +@media(max-width:600px) { + .chart-proof { + grid-template-columns: minmax(0, 1fr) + } + + .chart-proof img { + height: 380px + } +} + +@media(max-width:390px) { + .sl-container { + padding-inline: .85rem + } + + .api-table { + display: block; + max-width: 100%; + overflow-x: auto + } +} + +@media(prefers-reduced-motion:reduce) { + html { + scroll-behavior: auto !important + } + + * { + animation-duration: .01ms !important; + animation-iteration-count: 1 !important; + transition-duration: .01ms !important + } +} diff --git a/docs/src/styles/landing.css b/docs/src/styles/landing.css new file mode 100644 index 0000000..0c86e64 --- /dev/null +++ b/docs/src/styles/landing.css @@ -0,0 +1,637 @@ +:root { + --ink: #080808; + --paper: #fff; + --muted: #aaa7a4; + --line: #292929; + --ember: #b72c0b; + --ember-dark: #982407; + --page-gutter: max(24px, calc((100vw - 1280px) / 2)); + font-family: Inter, ui-sans-serif, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; + color-scheme: dark; +} + +* { + box-sizing: border-box +} + +html { + scroll-behavior: smooth; + scroll-padding-top: 96px +} + +body { + margin: 0; + background: var(--ink); + color: var(--paper); + font-size: 16px; + line-height: 1.55 +} + +a { + color: inherit +} + +img { + display: block; + max-width: 100% +} + +.skip-link { + position: fixed; + z-index: 99; + top: 12px; + left: 12px; + padding: .7rem 1rem; + background: #fff; + color: #080808; + transform: translateY(-160%) +} + +.skip-link:focus { + transform: none +} + +:focus-visible { + outline: 3px solid #ff9b67; + outline-offset: 4px +} + +.site-header { + position: sticky; + z-index: 50; + top: 0; + display: flex; + min-height: 72px; + align-items: center; + justify-content: space-between; + padding: 0 var(--page-gutter); + border-bottom: 1px solid #262626; + background: rgb(8 8 8/.9); + backdrop-filter: blur(18px) +} + +.brand { + display: flex; + align-items: center; + gap: 10px; + font-weight: 800; + text-decoration: none +} + +.site-header nav { + display: flex; + gap: clamp(18px, 3vw, 38px) +} + +.site-header nav a { + color: #c9c7c4; + font-size: .9rem; + font-weight: 700; + text-decoration: none +} + +.site-header nav a:hover { + color: #fff +} + +.grid-surface { + background-image: linear-gradient(rgb(255 255 255/.025) 1px, transparent 1px), linear-gradient(90deg, rgb(255 255 255/.025) 1px, transparent 1px); + background-size: 48px 48px +} + +.hero { + display: grid; + grid-template-columns: minmax(0, 1fr) minmax(0, 1.1fr); + align-items: center; + gap: clamp(32px, 4vw, 64px); + padding: 88px var(--page-gutter) 96px +} + +.hero-copy { + max-width: 760px +} + +.hero h1, +.native-contract h2, +.chart-index h2, +.apps-section h2 { + margin: 0; + font-size: clamp(3rem, 4.7vw, 4.5rem); + font-weight: 850; + letter-spacing: -.055em; + line-height: 1.02; + text-wrap: balance +} + +.lede { + max-width: 440px; + margin: 24px 0 0; + color: #b8b4af; + font-size: 1.15rem +} + +.actions { + display: flex; + flex-wrap: wrap; + gap: 12px; + margin-top: 34px +} + +.button { + display: inline-flex; + min-height: 50px; + align-items: center; + justify-content: center; + padding: 12px 21px; + border: 1px solid #3a3a3a; + border-radius: 8px; + font-weight: 800; + text-decoration: none +} + +.button.primary { + border-color: var(--ember); + background: var(--ember) +} + +.button.primary:hover { + background: var(--ember-dark) +} + +.button.secondary:hover { + border-color: #777 +} + +.compatibility { + display: flex; + flex-wrap: wrap; + gap: 8px 20px; + padding: 0; + margin: 38px 0 0; + color: #9e9a96; + font-size: .78rem; + list-style: none +} + +.hero-media { + display: grid; + grid-template-columns: 1fr 1fr; + align-items: center; + gap: 20px; + padding-block: 24px +} + +.chart-preview { + min-width: 0; + margin: 0; + overflow: hidden; + border: 1px solid #45413d; + border-radius: 14px; + background: #f7f4ec; + box-shadow: 0 20px 50px rgb(0 0 0 / .25) +} + +.chart-preview.ios { + transform: translateY(30px) +} + +.chart-preview.android { + transform: translateY(-24px) +} + +.preview-heading { + display: flex; + align-items: center; + justify-content: space-between; + gap: 8px; + padding: 13px 14px; + border-bottom: 1px solid #45413d; + background: #181818; + color: #fff; + font-size: .75rem; + font-weight: 650 +} + +.preview-heading span + span { + color: #b8b4af; + font-size: .65rem; + font-weight: 400 +} + +.chart-preview img { + width: 100%; + height: auto +} + +.native-contract { + display: grid; + grid-template-columns: 1fr 1fr; + gap: clamp(40px, 6vw, 96px); + padding: 96px var(--page-gutter); + background: #fff; + color: #151515 +} + +.native-contract h2, +.chart-index h2, +.apps-section h2 { + font-size: clamp(2.2rem, 3.5vw, 3.6rem) +} + +.native-contract > div > p, +.chart-index header p, +.apps-section p { + max-width: 650px; + color: #68635e; + font-size: 1.15rem +} + +.chart-index { + padding: 96px var(--page-gutter); + background: #f4f3f1; + color: #151515 +} + +.chart-index header { + display: grid; + grid-template-columns: 1fr .7fr; + align-items: end; + gap: 40px; + margin-bottom: 64px +} + +.chart-list { + display: grid; + grid-template-columns: 1fr 1fr; + column-gap: 48px +} + +.chart-list a { + display: grid; + grid-template-columns: 72px 1fr 20px; + align-items: center; + gap: 24px; + padding: 26px 0; + border-top: 1px solid #cbc7c2; + text-decoration: none; + transition: color .18s +} + +.chart-list a:hover { + color: var(--ember-dark) +} + +.chart-icon { + width: 72px; + height: 44px; + color: var(--ember) +} + +.chart-description { + display: grid; + gap: 4px +} + +.chart-description strong { + font-size: 1.1rem; + line-height: 1.3 +} + +.chart-description > span { + color: #68635e; + font-size: .9rem +} + +.chart-arrow { + color: #68635e; + font-size: 1.2rem +} + +.apps-section { + display: grid; + grid-template-columns: 1fr 1fr; + align-items: start; + gap: 64px; + padding: 80px var(--page-gutter); + background: #fff; + color: #151515 +} + +.text-link { + color: var(--ember-dark); + text-underline-offset: 4px; + font-weight: 600 +} + +.app-card { + padding: 28px; + border: 1px solid #d7d3cf; + border-radius: 12px +} + +.app-platform { + color: #68635e; + font-size: .85rem +} + +.app-card h3 { + margin: 8px 0; + font-size: 1.75rem; + letter-spacing: -.03em +} + +.app-card p { + font-size: 1rem +} + +.app-card a { + display: inline-block; + padding-block: 8px; + color: var(--ember-dark); + text-underline-offset: 4px; + font-weight: 600 +} + +.text-link:hover, +.app-card a:hover { + color: #151515 +} + +.site-footer { + display: flex; + align-items: center; + justify-content: space-between; + gap: 24px; + padding: 34px var(--page-gutter); + background: var(--ink); + color: #8f8b87; + font-size: .82rem +} + +.footer-credit { + display: flex; + align-items: center; + flex-wrap: wrap; + gap: 4px +} + +.footer-credit a { + display: inline-flex; + align-items: center; + gap: 8px; + color: #dedad5; + text-decoration: none +} + +.site-footer a:hover { + text-decoration: underline; + text-underline-offset: 5px +} + +.site-footer strong { + font-weight: 750 +} + +.site-footer img { + flex-shrink: 0; + object-fit: contain +} + +@media(max-width:1000px) { + .hero { + grid-template-columns: 1fr; + gap: 40px; + padding-block: 64px + } + + .hero-copy { + max-width: 640px + } + + .hero-media { + width: 100%; + max-width: 600px; + justify-self: center + } + + .native-contract { + grid-template-columns: 1fr + } + + .chart-index header { + grid-template-columns: 1fr; + gap: 16px; + margin-bottom: 40px + } + + .chart-list { + column-gap: 28px + } + + .chart-list a { + gap: 16px + } +} + +@media(max-width:600px) { + :root { + --page-gutter: 20px + } + + .site-header { + min-height: 68px; + flex-wrap: wrap; + gap: 8px 16px; + padding-block: 12px + } + + .brand { + gap: 8px; + font-size: .85rem + } + + .brand img { + width: 24px; + height: 24px + } + + .site-header nav { + gap: 14px + } + + .site-header nav a { + font-size: .8rem + } + + .hero h1 { + font-size: clamp(2.75rem, 11vw, 4rem) + } + + .hero-media { + gap: 12px + } + + .preview-heading { + padding: 10px; + font-size: .7rem + } + + .preview-heading span + span { + display: none + } + + .chart-preview { + border-radius: 10px + } + + .native-contract, + .chart-index, + .apps-section { + padding-block: 64px + } + + .chart-list { + grid-template-columns: 1fr + } + + .apps-section { + grid-template-columns: 1fr; + gap: 24px + } + + .site-footer { + flex-direction: column; + align-items: flex-start; + gap: 8px + } + +} + +@media(prefers-reduced-motion:reduce) { + html { + scroll-behavior: auto + } + + * { + animation: none !important; + transition: none !important + } +} + .contract-explorer { + align-self: center; + min-width: 0; + overflow: hidden; + border-radius: 16px; + background: #151515; + box-shadow: 0 24px 70px rgb(41 25 18 / 16%); + } + + .contract-tabs { + display: flex; + gap: 4px; + padding: 8px 8px 0; + border-bottom: 1px solid #343434; + } + + .contract-tabs button, + .contract-toolbar button { + border: 0; + font: + 800 0.78rem/1 Inter, + ui-sans-serif, + -apple-system, + BlinkMacSystemFont, + "Segoe UI", + sans-serif; + } + + .contract-tabs button { + min-height: 42px; + padding: 0 16px; + border-radius: 9px 9px 0 0; + background: transparent; + color: #9f9b97; + cursor: pointer; + } + + .contract-tabs button[aria-selected="true"] { + background: #292929; + color: #fff; + } + + .contract-tabs button:hover { + color: #fff; + } + + .contract-panel pre { + height: 360px; + max-width: 100%; + overflow: auto; + padding: 28px; + margin: 0; + border-radius: 0; + background: #151515; + color: #f7f3ee; + font: + clamp(0.72rem, 1.15vw, 0.95rem)/1.75 "SFMono-Regular", + Consolas, + monospace; + } + + .contract-toolbar { + display: flex; + min-height: 52px; + align-items: center; + justify-content: flex-end; + gap: 14px; + padding: 8px 12px; + border-top: 1px solid #343434; + } + + .contract-toolbar [data-copy-status] { + color: #b9b5b0; + font-size: 0.78rem; + } + + .contract-toolbar button { + min-height: 36px; + padding: 0 14px; + border-radius: 7px; + background: #f7f3ee; + color: #171513; + cursor: pointer; + } + + .contract-toolbar button:hover { + background: #fff; + } + + @media (max-width: 560px) { + .contract-tabs button { + padding-inline: 12px; + } + + .contract-panel pre { + height: 360px; + padding: 22px 18px; + } + } + +.example-note { + padding: 20px 28px 0; + margin: 0; + color: #c4c0bc; + font-size: .85rem; + overflow-wrap: anywhere +} + +#example-theme pre { + height: auto +} + +.example-link { + display: inline-block; + margin: 0 28px 24px; + color: #ff9b67; + text-underline-offset: 4px +} diff --git a/docs/tsconfig.json b/docs/tsconfig.json new file mode 100644 index 0000000..8bf91d3 --- /dev/null +++ b/docs/tsconfig.json @@ -0,0 +1,5 @@ +{ + "extends": "astro/tsconfigs/strict", + "include": [".astro/types.d.ts", "**/*"], + "exclude": ["dist"] +} diff --git a/nativephp.json b/nativephp.json index 99382e8..a7e9e0b 100644 --- a/nativephp.json +++ b/nativephp.json @@ -71,6 +71,22 @@ "android_renderer": "com.donmanueldev.plugins.nativephp_charts.ui.NativePHPChartsRadarChartRenderer", "ios_renderer": "NativePHPChartsRadarChartRenderer", "self_closing": true + }, + { + "type": "progress_chart", + "element": "Donmanueldev\\NativephpCharts\\Elements\\ProgressChart", + "blade": "Donmanueldev\\NativephpCharts\\Components\\ProgressChart", + "android_renderer": "com.donmanueldev.plugins.nativephp_charts.ui.NativePHPChartsProgressChartRenderer", + "ios_renderer": "NativePHPChartsProgressChartRenderer", + "self_closing": true + }, + { + "type": "contribution_heatmap", + "element": "Donmanueldev\\NativephpCharts\\Elements\\ContributionHeatmap", + "blade": "Donmanueldev\\NativephpCharts\\Components\\ContributionHeatmap", + "android_renderer": "com.donmanueldev.plugins.nativephp_charts.ui.NativePHPChartsContributionHeatmapRenderer", + "ios_renderer": "NativePHPChartsContributionHeatmapRenderer", + "self_closing": true } ], "android": { diff --git a/resources/android/src/core/NativePHPChartsContract.kt b/resources/android/src/core/NativePHPChartsContract.kt new file mode 100644 index 0000000..e16a396 --- /dev/null +++ b/resources/android/src/core/NativePHPChartsContract.kt @@ -0,0 +1,102 @@ +package com.donmanueldev.plugins.nativephp_charts.ui + +import android.util.Log +import androidx.compose.foundation.layout.Box +import androidx.compose.foundation.layout.fillMaxSize +import androidx.compose.foundation.layout.padding +import androidx.compose.material3.Text +import androidx.compose.runtime.Composable +import androidx.compose.runtime.LaunchedEffect +import androidx.compose.runtime.getValue +import androidx.compose.runtime.mutableStateOf +import androidx.compose.runtime.remember +import androidx.compose.runtime.setValue +import androidx.compose.ui.Modifier +import androidx.compose.ui.semantics.clearAndSetSemantics +import androidx.compose.ui.semantics.contentDescription +import androidx.compose.ui.unit.dp +import kotlinx.coroutines.CoroutineDispatcher +import kotlinx.coroutines.Dispatchers +import kotlinx.coroutines.withContext +import java.util.concurrent.ConcurrentHashMap + +internal const val NATIVEPHP_CHARTS_CONTRACT_VERSION = 1 + +internal sealed interface NativePHPChartsDecodeResult { + data class Success(val value: Value) : NativePHPChartsDecodeResult + data class Failure(val code: String, val cause: Throwable? = null) : NativePHPChartsDecodeResult +} + +internal fun nativePHPChartsContractFailure(version: Int): NativePHPChartsDecodeResult.Failure? = + if (version == NATIVEPHP_CHARTS_CONTRACT_VERSION) null + else NativePHPChartsDecodeResult.Failure("unsupported_contract_version") + +/** Logs only bounded error metadata; wire payloads and filesystem paths are never logged. */ +internal object NativePHPChartsDiagnostics { + private const val WINDOW_MILLIS = 60_000L + private val lastLoggedAt = ConcurrentHashMap() + + fun report(chartType: String, failure: NativePHPChartsDecodeResult.Failure) { + val key = "$chartType:${failure.code}" + val now = System.currentTimeMillis() + var shouldLog = false + lastLoggedAt.compute(key) { _, previous -> + if (previous == null || now - previous >= WINDOW_MILLIS) { + shouldLog = true + now + } else { + previous + } + } + if (shouldLog) Log.w("NativePHPCharts", "chart_type=$chartType code=${failure.code}") + } +} + +internal sealed interface NativePHPChartsAsyncState { + data object Loading : NativePHPChartsAsyncState + data class Ready(val value: Value) : NativePHPChartsAsyncState + data class Unavailable(val failure: NativePHPChartsDecodeResult.Failure) : NativePHPChartsAsyncState +} + +/** + * Decodes immutable wire snapshots away from the main thread. A previous valid + * value remains visible while a replacement is loading; failures replace it + * with the explicit unavailable state so stale data is never presented as new. + */ +@Composable +internal fun rememberNativePHPChartsDecodedState( + key: Key, + chartType: String, + dispatcher: CoroutineDispatcher = Dispatchers.IO, + decode: suspend (Key) -> NativePHPChartsDecodeResult, +): NativePHPChartsAsyncState { + var state by remember { mutableStateOf>(NativePHPChartsAsyncState.Loading) } + LaunchedEffect(key) { + val result = withContext(dispatcher) { + NativePHPChartsPerformance.traceSuspending("NPC.decode.$chartType") { decode(key) } + } + when (result) { + is NativePHPChartsDecodeResult.Success -> state = NativePHPChartsAsyncState.Ready(result.value) + is NativePHPChartsDecodeResult.Failure -> { + NativePHPChartsDiagnostics.report(chartType, result) + state = NativePHPChartsAsyncState.Unavailable(result) + } + } + } + return state +} + +@Composable +internal fun NativePHPChartsUnavailable( + modifier: Modifier, + accessibilityLabel: String, + errorLabel: String, +) { + Box( + modifier = modifier + .fillMaxSize() + .clearAndSetSemantics { contentDescription = "$accessibilityLabel: $errorLabel" }, + ) { + Text(errorLabel, Modifier.padding(16.dp)) + } +} diff --git a/resources/android/src/core/NativePHPChartsDecoder.kt b/resources/android/src/core/NativePHPChartsDecoder.kt index 8e27953..2b63b44 100644 --- a/resources/android/src/core/NativePHPChartsDecoder.kt +++ b/resources/android/src/core/NativePHPChartsDecoder.kt @@ -20,14 +20,26 @@ internal object NativePHPChartsDecoder { * Series-level style remains nullable so rendering can preserve the explicit * precedence of series override, global style, then platform fallback. */ - fun decode(input: NativePHPChartsWireInput, kind: NativePHPChartsKind): NativePHPChartsConfiguration { + suspend fun decode( + input: NativePHPChartsWireInput, + kind: NativePHPChartsKind, + systemDark: Boolean, + ): NativePHPChartsDecodeResult { + nativePHPChartsContractFailure(input.contractVersion)?.let { return it } + val seriesJson = when (val resolved = NativePHPChartsWireInput.resolveSeriesJson(input)) { + is NativePHPChartsDecodeResult.Success -> resolved.value + is NativePHPChartsDecodeResult.Failure -> return resolved + } + val theme = nativePHPChartsTheme(input.themeJson, input.themeMode, systemDark) + val series = decodeSeries(seriesJson, theme, kind) + ?: return NativePHPChartsDecodeResult.Failure("malformed_series_snapshot") val styleRoot = input.styleJson.asObject() val legacyAxis = styleRoot.optJSONObject("axis") - return NativePHPChartsConfiguration( + return NativePHPChartsDecodeResult.Success(NativePHPChartsConfiguration( kind = kind, - series = decodeSeries(input.seriesJson), - style = decodeStyle(styleRoot, kind), + series = series, + style = decodeStyle(styleRoot, kind, theme), xAxis = decodeXAxis(input.xAxisJson.asObject(), legacyAxis), yAxis = decodeYAxis(input.yAxisJson.asObject(), legacyAxis, input), legend = decodeLegend(input.legendJson.asObject()), @@ -42,38 +54,47 @@ internal object NativePHPChartsDecoder { beginAtZero = input.beginAtZero, animated = input.animated, emptyLabel = input.emptyLabel, + errorLabel = input.errorLabel, accessibilityLabel = input.accessibilityLabel, + backgroundColor = chartColor(theme.background, Color.Transparent), locale = input.locale, onSelect = input.onSelect, onViewportChange = input.onViewportChange, - ) + )) } - private fun decodeSeries(json: String): List = try { + private fun decodeSeries( + json: String, + theme: NativePHPChartsTheme, + kind: NativePHPChartsKind, + ): List? = try { val root = JSONArray(json) buildList { for (seriesIndex in 0 until root.length()) { val item = root.optJSONObject(seriesIndex) - if (item == null) { - continue - } + if (item == null) return null val id = item.optString("id", "series-$seriesIndex") val points = item.optJSONArray("points") ?: JSONArray() add( NativePHPChartsSeries( id = id, name = item.optString("name", id), - color = chartColor(item.optString("color"), Color(0xFF6366F1)), + color = item.optionalString("color")?.let { chartColor(it, Color(0xFF6366F1)) } + ?: theme.color(seriesIndex, Color(0xFF6366F1)), points = buildList { for (pointIndex in 0 until points.length()) { val point = points.optJSONObject(pointIndex) - if (point == null) { - continue - } + if (point == null) return null val value = point.optDouble("value", Double.NaN) - if (!value.isFinite()) { - continue - } + if (!value.isFinite()) return null + val open = point.doubleOrNull("open") + val high = point.doubleOrNull("high") + val low = point.doubleOrNull("low") + val close = point.doubleOrNull("close") + if (kind == NativePHPChartsKind.Candlestick && + (open == null || high == null || low == null || close == null || + low > minOf(open, close) || high < maxOf(open, close) || low > high) + ) return null add( NativePHPChartsPoint( id = point.optString("id", "$id-$pointIndex"), @@ -83,10 +104,10 @@ internal object NativePHPChartsDecoder { index = point.optInt("source_index", pointIndex), errorMin = point.doubleOrNull("error_min"), errorMax = point.doubleOrNull("error_max"), - open = point.doubleOrNull("open"), - high = point.doubleOrNull("high"), - low = point.doubleOrNull("low"), - close = point.doubleOrNull("close"), + open = open, + high = high, + low = low, + close = close, ), ) } @@ -99,7 +120,7 @@ internal object NativePHPChartsDecoder { } } } catch (_: Exception) { - emptyList() + null } private fun decodeSeriesStyle(root: JSONObject): NativePHPChartsSeriesStyle { @@ -128,7 +149,11 @@ internal object NativePHPChartsDecoder { ) } - private fun decodeStyle(root: JSONObject, kind: NativePHPChartsKind): NativePHPChartsStyle { + private fun decodeStyle( + root: JSONObject, + kind: NativePHPChartsKind, + theme: NativePHPChartsTheme, + ): NativePHPChartsStyle { val line = root.optJSONObject("line") val points = root.optJSONObject("points") val grid = root.optJSONObject("grid") @@ -145,7 +170,7 @@ internal object NativePHPChartsDecoder { pointColor = points?.optString("color")?.takeIf(String::isNotBlank), pointSize = points.float("size", defaultPointSize(kind)), pointsVisible = points.booleanOrNull("visible"), - gridColor = grid?.optString("color")?.takeIf(String::isNotBlank), + gridColor = grid?.optString("color")?.takeIf(String::isNotBlank) ?: theme.grid, gridVisible = grid.booleanOrNull("visible"), gridWidth = grid.float("width", 1f), areaOpacity = area.float("opacity", 0.28f).coerceIn(0f, 1f), @@ -157,11 +182,11 @@ internal object NativePHPChartsDecoder { candlestickNeutralColor = candlestick?.optionalString("neutral_color"), candlestickWickWidth = candlestick.float("wick_width", 1.5f), axisVisible = axis.booleanOrNull("visible"), - axisColor = axis?.optString("color")?.takeIf(String::isNotBlank), + axisColor = axis?.optString("color")?.takeIf(String::isNotBlank) ?: theme.muted, axisLabelCount = axis.intOrNull("label_count"), axisFont = axis?.optString("font")?.takeIf(String::isNotBlank), axisFontSize = axis.float("font_size", 10f), - axisLabelColor = axis?.optString("label_color")?.takeIf(String::isNotBlank), + axisLabelColor = axis?.optString("label_color")?.takeIf(String::isNotBlank) ?: theme.foreground, ) } diff --git a/resources/android/src/core/NativePHPChartsLayout.kt b/resources/android/src/core/NativePHPChartsLayout.kt index 95a4370..ba96b4b 100644 --- a/resources/android/src/core/NativePHPChartsLayout.kt +++ b/resources/android/src/core/NativePHPChartsLayout.kt @@ -36,17 +36,21 @@ internal object NativePHPChartsLayoutEngine { axisLabelHeight: Float, viewportOverride: NativePHPChartsDomain? = null, ): NativePHPChartsLayout { - val values = when { + val allPoints = configuration.series.flatMap(NativePHPChartsSeries::points) + val geometryRequiresZero = configuration.kind == NativePHPChartsKind.Area + val automaticDomain = NativePHPChartsPerformance.trace("NPC.layout.values") { when { configuration.kind == NativePHPChartsKind.Area && configuration.areaMode == "stacked" || configuration.kind == NativePHPChartsKind.Bar && configuration.barMode == "stacked" -> { - stackedGeometryValues(configuration.series, formatting) - } - else -> configuration.series.flatMap { series -> - series.points.flatMap { point -> listOfNotNull(point.value, point.errorMin, point.errorMax) } + domain( + stackedGeometryValues(configuration.series, formatting), + configuration.beginAtZero || geometryRequiresZero, + ) } - } - val geometryRequiresZero = configuration.kind == NativePHPChartsKind.Area - val automaticDomain = domain(values, configuration.beginAtZero || geometryRequiresZero) + else -> pointDomain( + allPoints, + configuration.beginAtZero || geometryRequiresZero, + ) + } } val domain = explicitDomain( automaticDomain, configuration.yAxis.minimum, @@ -56,11 +60,20 @@ internal object NativePHPChartsLayoutEngine { val xAxisVisible = configuration.xAxis.visible ?: configuration.style.axisVisible ?: legacyAxisVisible val yAxisVisible = configuration.yAxis.visible ?: configuration.style.axisVisible ?: legacyAxisVisible val isHorizontalBar = configuration.kind == NativePHPChartsKind.Bar && configuration.barOrientation == "horizontal" - val categories = configuration.series.flatMap(NativePHPChartsSeries::points) - .distinctBy { it.x?.toString() ?: it.label } - val categoryIndexes = categories.mapIndexed { index, point -> - (point.x?.toString() ?: point.label) to index - }.toMap() + val needsCategories = configuration.xAxis.type == NativePHPChartsXType.Category || + configuration.kind == NativePHPChartsKind.Bar + val categories = NativePHPChartsPerformance.trace("NPC.layout.categories") { + if (needsCategories) { + allPoints.distinctBy { it.x?.toString() ?: it.label } + } else { + emptyList() + } + } + val categoryIndexes = NativePHPChartsPerformance.trace("NPC.layout.category-index") { + categories.mapIndexed { index, point -> + (point.x?.toString() ?: point.label) to index + }.toMap() + } val yLabelCount = configuration.yAxis.labelCount.coerceIn(2, 12) val yLabelValues = configuration.yAxis.interval?.let { interval -> ticks(domain, interval).asReversed() @@ -98,11 +111,16 @@ internal object NativePHPChartsLayoutEngine { val plot = Rect(left, top, right, bottom) val baselineValue = configuration.yAxis.baseline ?: 0.0 val baselineY = yFor(baselineValue, domain, plot).coerceIn(plot.top, plot.bottom) - val numericX = configuration.series.flatMap(NativePHPChartsSeries::points).mapNotNull(formatting::xNumeric) - val xMinimum = numericX.minOrNull() - val xMaximum = numericX.maxOrNull() + val numericPoints = NativePHPChartsPerformance.trace("NPC.layout.numeric-x") { + allPoints.mapNotNull { point -> formatting.xNumeric(point)?.let { it to point } } + } + val xMinimum = numericPoints.minOfOrNull(Pair::first) + val xMaximum = numericPoints.maxOfOrNull(Pair::first) val numericPadding = if (configuration.kind == NativePHPChartsKind.Bar) { - numericX.distinct().sorted().zipWithNext { first, second -> second - first } + numericPoints.map(Pair::first) + .distinct() + .sorted() + .zipWithNext { first, second -> second - first } .filter { it > 0.0 } .minOrNull() ?.div(2.0) @@ -154,60 +172,65 @@ internal object NativePHPChartsLayoutEngine { fun valueX(value: Double): Float = plot.left + (((value - domain.minimum) / domain.span).toFloat() * plot.width) - val data = when (configuration.kind) { - NativePHPChartsKind.Bar -> if (isHorizontalBar && configuration.barMode == "stacked") { - stackedHorizontalBars(configuration, formatting, plot, density, ::categoryY, ::valueX) - } else if (isHorizontalBar) { - groupedHorizontalBars(configuration, plot, categoryIndexes, density, ::categoryY, ::valueX) - } else if (configuration.barMode == "stacked") { - stackedBars(configuration, formatting, plot, domain, density, ::xFor) - } else { - groupedBars( + val data = NativePHPChartsPerformance.trace("NPC.layout.data") { + val rawData = when (configuration.kind) { + NativePHPChartsKind.Bar -> if (isHorizontalBar && configuration.barMode == "stacked") { + stackedHorizontalBars(configuration, formatting, plot, density, ::categoryY, ::valueX) + } else if (isHorizontalBar) { + groupedHorizontalBars(configuration, plot, categoryIndexes, density, ::categoryY, ::valueX) + } else if (configuration.barMode == "stacked") { + stackedBars(configuration, formatting, plot, domain, density, ::xFor) + } else { + groupedBars( + configuration, + plot, + domain, + categoryIndexes, + density, + ::xFor, + ) + } + NativePHPChartsKind.Area -> areaData(configuration, formatting, domain, plot, ::xFor) + NativePHPChartsKind.Candlestick -> candlestickData( configuration, plot, domain, - categoryIndexes, density, - ::xFor, + xFor = ::xFor, ) - } - NativePHPChartsKind.Area -> areaData(configuration, formatting, domain, plot, ::xFor) - NativePHPChartsKind.Candlestick -> candlestickData( - configuration = configuration, - plot = plot, - domain = domain, - density = density, - xFor = ::xFor, - ) - NativePHPChartsKind.Line, NativePHPChartsKind.Scatter -> configuration.series.flatMap { series -> - series.points.map { point -> - NativePHPChartsDatum(series, point, Offset(xFor(point), yFor(point.value, domain, plot))) + NativePHPChartsKind.Line, NativePHPChartsKind.Scatter -> configuration.series.flatMap { series -> + series.points.map { point -> + NativePHPChartsDatum(series, point, Offset(xFor(point), yFor(point.value, domain, plot))) + } } } - }.map { datum -> - if (isHorizontalBar) { - datum.copy( - errorMinX = datum.point.errorMin?.let(::valueX), - errorMaxX = datum.point.errorMax?.let(::valueX), - ) + if (allPoints.none { it.errorMin != null || it.errorMax != null }) { + rawData } else { - datum.copy( - errorMinY = datum.point.errorMin?.let { yFor(it, domain, plot) }, - errorMaxY = datum.point.errorMax?.let { yFor(it, domain, plot) }, - ) + rawData.map { datum -> + if (isHorizontalBar) { + datum.copy( + errorMinX = datum.point.errorMin?.let(::valueX), + errorMaxX = datum.point.errorMax?.let(::valueX), + ) + } else { + datum.copy( + errorMinY = datum.point.errorMin?.let { yFor(it, domain, plot) }, + errorMaxY = datum.point.errorMax?.let { yFor(it, domain, plot) }, + ) + } + } } } - val xLabelPoints = if (configuration.xAxis.type == NativePHPChartsXType.Category) { + val xLabelPoints = NativePHPChartsPerformance.trace("NPC.layout.label-points") { if (configuration.xAxis.type == NativePHPChartsXType.Category) { categories } else { - configuration.series - .flatMap(NativePHPChartsSeries::points) - .mapNotNull { point -> formatting.xNumeric(point)?.let { value -> value to point } } + numericPoints .filter { (value, _) -> xDomain == null || value in xDomain.minimum..xDomain.maximum } - .sortedBy { (value, _) -> value } + .let(::nativePHPChartsEnsureSortedNumericPoints) .distinctBy { (value, _) -> value } .map { (_, point) -> point } - } + } } val desiredLabels = configuration.xAxis.labelCount .coerceIn(2, 12) .coerceAtMost(xLabelPoints.size.coerceAtLeast(1)) @@ -289,6 +312,13 @@ internal object NativePHPChartsLayoutEngine { NativePHPChartsAnnotationGeometry(annotation, physicalAxis, min(start, end), max(start, end)) } + val dataBySeries = NativePHPChartsPerformance.trace("NPC.layout.group-series") { + data.groupBy { it.series.id } + } + val hitIndex = NativePHPChartsPerformance.trace("NPC.layout.hit-index") { + NativePHPChartsHitIndex.build(data) + } + return NativePHPChartsLayout( plot = plot, domain = domain, @@ -297,11 +327,11 @@ internal object NativePHPChartsLayoutEngine { valueBaselineX = valueBaselineX, baselineY = baselineY, data = data, - dataBySeries = data.groupBy { it.series.id }, + dataBySeries = dataBySeries, xLabels = labels, yLabels = yLabels, annotations = annotationGeometry, - hitIndex = NativePHPChartsHitIndex.build(data), + hitIndex = hitIndex, ) } @@ -549,8 +579,16 @@ internal object NativePHPChartsLayoutEngine { } private fun domain(values: List, beginAtZero: Boolean): NativePHPChartsDomain { - var minimum = values.minOrNull() ?: 0.0 - var maximum = values.maxOrNull() ?: 0.0 + return paddedDomain(values.minOrNull() ?: 0.0, values.maxOrNull() ?: 0.0, beginAtZero) + } + + private fun paddedDomain( + initialMinimum: Double, + initialMaximum: Double, + beginAtZero: Boolean, + ): NativePHPChartsDomain { + var minimum = initialMinimum + var maximum = initialMaximum if (beginAtZero) { minimum = min(minimum, 0.0) maximum = max(maximum, 0.0) @@ -567,6 +605,23 @@ internal object NativePHPChartsLayoutEngine { return NativePHPChartsDomain(minimum, maximum) } + private fun pointDomain( + points: List, + beginAtZero: Boolean, + ): NativePHPChartsDomain { + if (points.isEmpty()) return domain(emptyList(), beginAtZero) + + var minimum = Double.POSITIVE_INFINITY + var maximum = Double.NEGATIVE_INFINITY + points.forEach { point -> + minimum = min(minimum, point.value) + maximum = max(maximum, point.value) + point.errorMin?.let { minimum = min(minimum, it) } + point.errorMax?.let { maximum = max(maximum, it) } + } + return paddedDomain(minimum, maximum, beginAtZero) + } + private fun explicitDomain( automatic: NativePHPChartsDomain, minimum: Double?, @@ -621,3 +676,15 @@ internal object NativePHPChartsLayoutEngine { return (0 until count).map { index -> (index * (size - 1).toFloat() / (count - 1)).toInt() }.distinct() } } + +private fun nativePHPChartsEnsureSortedNumericPoints( + points: List>, +): List> { + for (index in 1 until points.size) { + if (points[index - 1].first > points[index].first) { + return points.sortedBy(Pair::first) + } + } + + return points +} diff --git a/resources/android/src/core/NativePHPChartsModels.kt b/resources/android/src/core/NativePHPChartsModels.kt index 093453e..fbddb3c 100644 --- a/resources/android/src/core/NativePHPChartsModels.kt +++ b/resources/android/src/core/NativePHPChartsModels.kt @@ -172,7 +172,9 @@ internal data class NativePHPChartsConfiguration( val beginAtZero: Boolean, val animated: Boolean, val emptyLabel: String, + val errorLabel: String, val accessibilityLabel: String, + val backgroundColor: Color, val locale: String, val onSelect: Int, val onViewportChange: Int, diff --git a/resources/android/src/core/NativePHPChartsPerformance.kt b/resources/android/src/core/NativePHPChartsPerformance.kt new file mode 100644 index 0000000..d854fde --- /dev/null +++ b/resources/android/src/core/NativePHPChartsPerformance.kt @@ -0,0 +1,35 @@ +package com.donmanueldev.plugins.nativephp_charts.ui + +import android.os.Trace +import androidx.compose.runtime.staticCompositionLocalOf + +/** + * Internal harness hook invoked only after a validated Cartesian snapshot has been drawn. + * + * Production renderers leave this unset. Keeping the observer in a CompositionLocal avoids adding + * a public prop or renderer argument solely for profiling while allowing physical captures to + * distinguish a loading placeholder from the first chart frame. + */ +internal val LocalNativePHPChartsDrawObserver = + staticCompositionLocalOf<((NativePHPChartsKind, Int) -> Unit)?> { null } + +/** Bounded sections consumed by Perfetto; no payload values or labels are recorded. */ +internal object NativePHPChartsPerformance { + fun trace(section: String, block: () -> Value): Value { + Trace.beginSection(section.take(127)) + return try { + block() + } finally { + Trace.endSection() + } + } + + suspend fun traceSuspending(section: String, block: suspend () -> Value): Value { + Trace.beginSection(section.take(127)) + return try { + block() + } finally { + Trace.endSection() + } + } +} diff --git a/resources/android/src/core/NativePHPChartsRadarModels.kt b/resources/android/src/core/NativePHPChartsRadarModels.kt index 578a95e..ec73eb2 100644 --- a/resources/android/src/core/NativePHPChartsRadarModels.kt +++ b/resources/android/src/core/NativePHPChartsRadarModels.kt @@ -68,6 +68,7 @@ internal data class NativePHPChartsRadarConfiguration( val maximumFractionDigits: Int, val animated: Boolean, val emptyLabel: String, + val errorLabel: String, val accessibilityLabel: String, val onSelect: Int, val gridLevels: Int, diff --git a/resources/android/src/core/NativePHPChartsRadialDecoder.kt b/resources/android/src/core/NativePHPChartsRadialDecoder.kt index 7bd3676..c9320d1 100644 --- a/resources/android/src/core/NativePHPChartsRadialDecoder.kt +++ b/resources/android/src/core/NativePHPChartsRadialDecoder.kt @@ -20,16 +20,21 @@ internal object NativePHPChartsRadialDecoder { fun decode( input: NativePHPChartsRadialWireInput, kind: NativePHPChartsRadialKind, - ): NativePHPChartsRadialConfiguration { + systemDark: Boolean, + ): NativePHPChartsDecodeResult { + nativePHPChartsContractFailure(input.contractVersion)?.let { return it } + val theme = nativePHPChartsTheme(input.themeJson, input.themeMode, systemDark) + val segments = decodeSegments(input.segmentsJson, theme) + ?: return NativePHPChartsDecodeResult.Failure("malformed_segments_snapshot") val styleRoot = radialObject(input.styleJson) val segmentStyle = styleRoot.optJSONObject("segment") ?: JSONObject() val innerRadiusRatio = when (kind) { NativePHPChartsRadialKind.Pie -> 0f NativePHPChartsRadialKind.Donut -> input.innerRadiusRatio.coerceIn(0.2f, 0.85f) } - return NativePHPChartsRadialConfiguration( + return NativePHPChartsDecodeResult.Success(NativePHPChartsRadialConfiguration( kind = kind, - segments = decodeSegments(input.segmentsJson), + segments = segments, style = NativePHPChartsRadialStyle( gap = segmentStyle.optDouble("gap", 2.0).toFloat().coerceIn(0f, 12f), cornerRadius = segmentStyle.optDouble("corner_radius", 0.0).toFloat().coerceIn(0f, 20f), @@ -43,38 +48,37 @@ internal object NativePHPChartsRadialDecoder { maximumFractionDigits = input.maximumFractionDigits, animated = input.animated, emptyLabel = input.emptyLabel, + errorLabel = input.errorLabel, accessibilityLabel = input.accessibilityLabel, onSelect = input.onSelect, innerRadiusRatio = innerRadiusRatio, - ) + )) } - private fun decodeSegments(json: String): List = try { + private fun decodeSegments(json: String, theme: NativePHPChartsTheme): List? = try { val root = JSONArray(json) buildList { for (index in 0 until root.length()) { val item = root.optJSONObject(index) - if (item == null) { - continue - } + if (item == null) return null val value = item.optDouble("value", Double.NaN) - if (!value.isFinite() || value < 0.0) { - continue - } + if (!value.isFinite() || value < 0.0) return null val id = item.optString("id", "segment-$index") add( NativePHPChartsRadialSegment( id = id, label = item.optString("label", id), value = value, - color = chartColor(item.optString("color"), fallbackColors[index % fallbackColors.size]), + color = item.optionalRadialString("color") + ?.let { chartColor(it, fallbackColors[index % fallbackColors.size]) } + ?: theme.color(index, fallbackColors[index % fallbackColors.size]), index = index, ), ) } } } catch (_: Exception) { - emptyList() + null } private fun decodeRadialLegend(root: JSONObject): NativePHPChartsLegend { @@ -100,3 +104,6 @@ private fun radialObject(json: String): JSONObject = try { } catch (_: Exception) { JSONObject() } + +private fun JSONObject.optionalRadialString(name: String): String? = + optString(name).takeIf(String::isNotBlank) diff --git a/resources/android/src/core/NativePHPChartsRadialModels.kt b/resources/android/src/core/NativePHPChartsRadialModels.kt index 7737aca..5847302 100644 --- a/resources/android/src/core/NativePHPChartsRadialModels.kt +++ b/resources/android/src/core/NativePHPChartsRadialModels.kt @@ -35,6 +35,7 @@ internal data class NativePHPChartsRadialConfiguration( val maximumFractionDigits: Int, val animated: Boolean, val emptyLabel: String, + val errorLabel: String, val accessibilityLabel: String, val onSelect: Int, val innerRadiusRatio: Float, diff --git a/resources/android/src/core/NativePHPChartsRadialWireInput.kt b/resources/android/src/core/NativePHPChartsRadialWireInput.kt index 0af223b..890f5c7 100644 --- a/resources/android/src/core/NativePHPChartsRadialWireInput.kt +++ b/resources/android/src/core/NativePHPChartsRadialWireInput.kt @@ -9,8 +9,12 @@ import com.nativephp.mobile.ui.nativerender.NativeUINode * the single place that applies radial defaults, filtering, and clamping. */ internal data class NativePHPChartsRadialWireInput( + val contractVersion: Int, val segmentsJson: String, val styleJson: String, + val themeMode: String, + val themeJson: String, + val preset: String, val legendJson: String, val locale: String, val valueFormat: String, @@ -19,6 +23,7 @@ internal data class NativePHPChartsRadialWireInput( val maximumFractionDigits: Int, val animated: Boolean, val emptyLabel: String, + val errorLabel: String, val accessibilityLabel: String, val onSelect: Int, val innerRadiusRatio: Float, @@ -28,8 +33,12 @@ internal data class NativePHPChartsRadialWireInput( fun from(node: NativeUINode): NativePHPChartsRadialWireInput { val props = node.props return NativePHPChartsRadialWireInput( + contractVersion = props.getInt("contract_version", 0), segmentsJson = props.getString("segments_json", "[]"), styleJson = props.getString("style_json", "{}"), + themeMode = props.getString("theme_mode", "system"), + themeJson = props.getString("theme_json", "{}"), + preset = props.getString("preset", "default"), legendJson = props.getString("legend_json", "{}"), locale = props.getString("locale", ""), valueFormat = props.getString("value_format", "number"), @@ -38,6 +47,7 @@ internal data class NativePHPChartsRadialWireInput( maximumFractionDigits = props.getInt("maximum_fraction_digits", -1), animated = props.getBool("animated", true), emptyLabel = props.getString("empty_label", "No data"), + errorLabel = props.getString("error_label", "Chart unavailable"), accessibilityLabel = props.getString("a11y_label", "Chart"), onSelect = props.getCallbackId("on_select"), innerRadiusRatio = props.getFloat("inner_radius_ratio", 0.6f), diff --git a/resources/android/src/core/NativePHPChartsSpecialModels.kt b/resources/android/src/core/NativePHPChartsSpecialModels.kt new file mode 100644 index 0000000..4bfd240 --- /dev/null +++ b/resources/android/src/core/NativePHPChartsSpecialModels.kt @@ -0,0 +1,309 @@ +package com.donmanueldev.plugins.nativephp_charts.ui + +import androidx.compose.ui.graphics.Color +import com.nativephp.mobile.ui.nativerender.NativeUINode +import org.json.JSONArray +import org.json.JSONObject +import java.time.LocalDate +import java.time.ZoneOffset + +internal data class NativePHPChartsProgressMetric( + val id: String, + val label: String, + val value: Double, + val color: Color, + val index: Int, +) + +internal data class NativePHPChartsProgressConfiguration( + val metrics: List, + val centerLabel: String, + val trackColor: Color, + val backgroundColor: Color, + val ringWidth: Float, + val ringGap: Float, + val ringCap: String, + val animated: Boolean, + val emptyLabel: String, + val errorLabel: String, + val accessibilityLabel: String, + val onSelect: Int, + val locale: String, + val minimumFractionDigits: Int, + val maximumFractionDigits: Int, + val legendVisible: Boolean, +) { + val animationKey: Int = metrics.hashCode() +} + +internal data class NativePHPChartsProgressWireInput( + val contractVersion: Int, + val metricsJson: String, + val centerLabel: String, + val styleJson: String, + val legendJson: String, + val themeMode: String, + val themeJson: String, + val preset: String, + val locale: String, + val minimumFractionDigits: Int, + val maximumFractionDigits: Int, + val animated: Boolean, + val emptyLabel: String, + val errorLabel: String, + val accessibilityLabel: String, + val onSelect: Int, +) { + companion object { + fun from(node: NativeUINode): NativePHPChartsProgressWireInput = node.props.let { props -> + NativePHPChartsProgressWireInput( + contractVersion = props.getInt("contract_version", 0), + metricsJson = props.getString("metrics_json", "[]"), + centerLabel = props.getString("center_label", ""), + styleJson = props.getString("style_json", "{}"), + legendJson = props.getString("legend_json", "{}"), + themeMode = props.getString("theme_mode", "system"), + themeJson = props.getString("theme_json", "{}"), + preset = props.getString("preset", "default"), + locale = props.getString("locale", ""), + minimumFractionDigits = props.getInt("minimum_fraction_digits", -1), + maximumFractionDigits = props.getInt("maximum_fraction_digits", -1), + animated = props.getBool("animated", true), + emptyLabel = props.getString("empty_label", "No data"), + errorLabel = props.getString("error_label", "Chart unavailable"), + accessibilityLabel = props.getString("a11y_label", "Progress chart"), + onSelect = props.getCallbackId("on_select"), + ) + } + } +} + +internal fun decodeNativePHPChartsProgress( + input: NativePHPChartsProgressWireInput, + systemDark: Boolean, +): NativePHPChartsDecodeResult { + nativePHPChartsContractFailure(input.contractVersion)?.let { return it } + val theme = nativePHPChartsTheme(input.themeJson, input.themeMode, systemDark) + val ring = input.styleJson.asObject()?.optJSONObject("ring") + val legend = input.legendJson.asObject() + val root = runCatching { JSONArray(input.metricsJson) }.getOrNull() + ?: return NativePHPChartsDecodeResult.Failure("malformed_progress_snapshot") + val seen = mutableSetOf() + val fallback = listOf( + Color(0xFF6366F1), Color(0xFF14B8A6), Color(0xFFF59E0B), Color(0xFFEC4899), + ) + val metrics = buildList { + for (index in 0 until root.length()) { + val item = root.optJSONObject(index) + ?: return NativePHPChartsDecodeResult.Failure("malformed_progress_snapshot") + val id = item.optString("id") + val label = item.optString("label") + val value = item.optDouble("value", Double.NaN) + if (id.isBlank() || label.isBlank() || !seen.add(id) || !value.isFinite() || value !in 0.0..1.0) { + return NativePHPChartsDecodeResult.Failure("invalid_progress_metric") + } + val base = fallback[index % fallback.size] + add( + NativePHPChartsProgressMetric( + id = id, + label = label, + value = value, + color = item.optString("color").takeIf(String::isNotBlank)?.let { chartColor(it, base) } + ?: theme.color(index, base), + index = index, + ), + ) + } + } + return NativePHPChartsDecodeResult.Success( + NativePHPChartsProgressConfiguration( + metrics = metrics, + centerLabel = input.centerLabel, + trackColor = chartColor(theme.track, Color.Gray.copy(alpha = 0.18f)), + backgroundColor = chartColor(theme.background, Color.Transparent), + ringWidth = ring?.optDouble("width", 12.0)?.toFloat()?.coerceAtLeast(1f) ?: 12f, + ringGap = ring?.optDouble("gap", 7.0)?.toFloat()?.coerceAtLeast(0f) ?: 7f, + ringCap = ring?.optString("cap", "round") ?: "round", + animated = input.animated, + emptyLabel = input.emptyLabel, + errorLabel = input.errorLabel, + accessibilityLabel = input.accessibilityLabel, + onSelect = input.onSelect, + locale = input.locale, + minimumFractionDigits = input.minimumFractionDigits, + maximumFractionDigits = input.maximumFractionDigits, + legendVisible = when (legend?.opt("visible")) { is Boolean -> legend.optBoolean("visible"); else -> metrics.size > 1 }, + ), + ) +} + +internal data class NativePHPChartsContributionValue( + val id: String, + val date: LocalDate, + val value: Double, + val label: String, + val index: Int, +) + +internal data class NativePHPChartsContributionConfiguration( + val values: List, + val endDate: LocalDate, + val days: Int, + val weekStartsOn: Int, + val colors: List, + val emptyColor: Color, + val backgroundColor: Color, + val cellSize: Float?, + val cellGap: Float, + val showMonthLabels: Boolean, + val showWeekdayLabels: Boolean, + val animated: Boolean, + val emptyLabel: String, + val errorLabel: String, + val accessibilityLabel: String, + val onSelect: Int, + val locale: String, + val minimumFractionDigits: Int, + val maximumFractionDigits: Int, +) { + val startDate: LocalDate = endDate.minusDays((days - 1).toLong()) + val visibleValues: List = values.filter { it.date in startDate..endDate } + val animationKey: Int = 31 * visibleValues.hashCode() + endDate.hashCode() +} + +internal data class NativePHPChartsContributionWireInput( + val contractVersion: Int, + val valuesJson: String, + val styleJson: String, + val endDate: String, + val days: Int, + val weekStartsOn: Int, + val colorsJson: String, + val emptyColor: String, + val showMonthLabels: Boolean, + val showWeekdayLabels: Boolean, + val themeMode: String, + val themeJson: String, + val preset: String, + val locale: String, + val minimumFractionDigits: Int, + val maximumFractionDigits: Int, + val animated: Boolean, + val emptyLabel: String, + val errorLabel: String, + val accessibilityLabel: String, + val onSelect: Int, +) { + companion object { + fun from(node: NativeUINode): NativePHPChartsContributionWireInput = node.props.let { props -> + NativePHPChartsContributionWireInput( + contractVersion = props.getInt("contract_version", 0), + valuesJson = props.getString("values_json", "[]"), + styleJson = props.getString("style_json", "{}"), + endDate = props.getString("end_date", ""), + days = props.getInt("days", 365), + weekStartsOn = props.getInt("week_starts_on", 0), + colorsJson = props.getString("colors_json", "[]"), + emptyColor = props.getString("empty_color", ""), + showMonthLabels = props.getBool("show_month_labels", true), + showWeekdayLabels = props.getBool("show_weekday_labels", true), + themeMode = props.getString("theme_mode", "system"), + themeJson = props.getString("theme_json", "{}"), + preset = props.getString("preset", "default"), + locale = props.getString("locale", ""), + minimumFractionDigits = props.getInt("minimum_fraction_digits", -1), + maximumFractionDigits = props.getInt("maximum_fraction_digits", -1), + animated = props.getBool("animated", true), + emptyLabel = props.getString("empty_label", "No data"), + errorLabel = props.getString("error_label", "Chart unavailable"), + accessibilityLabel = props.getString("a11y_label", "Contribution heatmap"), + onSelect = props.getCallbackId("on_select"), + ) + } + } +} + +internal fun decodeNativePHPChartsContribution( + input: NativePHPChartsContributionWireInput, + systemDark: Boolean, +): NativePHPChartsDecodeResult { + nativePHPChartsContractFailure(input.contractVersion)?.let { return it } + if (input.days !in 7..371 || input.weekStartsOn !in 0..6) { + return NativePHPChartsDecodeResult.Failure("invalid_heatmap_range") + } + val resolvedEndDate = input.endDate.ifBlank { LocalDate.now(ZoneOffset.UTC).toString() } + val endDate = runCatching { LocalDate.parse(resolvedEndDate) }.getOrNull() + ?: return NativePHPChartsDecodeResult.Failure("invalid_heatmap_end_date") + val root = runCatching { JSONArray(input.valuesJson) }.getOrNull() + ?: return NativePHPChartsDecodeResult.Failure("malformed_heatmap_snapshot") + val seenIds = mutableSetOf() + val seenDates = mutableSetOf() + val values = buildList { + for (index in 0 until root.length()) { + val item = root.optJSONObject(index) + ?: return NativePHPChartsDecodeResult.Failure("malformed_heatmap_snapshot") + val id = item.optString("id") + val date = runCatching { LocalDate.parse(item.optString("date")) }.getOrNull() + val value = item.optDouble("value", Double.NaN) + if (id.isBlank() || date == null || !seenIds.add(id) || !seenDates.add(date) || !value.isFinite() || value < 0.0) { + return NativePHPChartsDecodeResult.Failure("invalid_heatmap_value") + } + add(NativePHPChartsContributionValue(id, date, value, item.optString("label", date.toString()), index)) + } + } + val theme = nativePHPChartsTheme(input.themeJson, input.themeMode, systemDark) + val cell = input.styleJson.asObject()?.optJSONObject("cell") + val defaultColors = listOf("#DCFCE7", "#86EFAC", "#22C55E", "#15803D") + val colorStrings = runCatching { JSONArray(input.colorsJson) }.getOrNull()?.let { array -> + (0 until array.length()).mapNotNull { array.optString(it).takeIf(String::isNotBlank) } + }.orEmpty().ifEmpty { theme.palette.ifEmpty { defaultColors } } + val colors = colorStrings.mapIndexed { index, value -> + chartColor(value, chartColor(defaultColors[index % defaultColors.size], Color(0xFF22C55E))) + } + return NativePHPChartsDecodeResult.Success( + NativePHPChartsContributionConfiguration( + values = values, + endDate = endDate, + days = input.days, + weekStartsOn = input.weekStartsOn, + colors = colors, + emptyColor = chartColor(input.emptyColor.ifBlank { theme.track }, Color.Gray.copy(alpha = 0.16f)), + backgroundColor = chartColor(theme.background, Color.Transparent), + cellSize = cell?.takeIf { it.has("size") }?.optDouble("size")?.toFloat()?.coerceAtLeast(1f), + cellGap = cell?.optDouble("gap", 3.0)?.toFloat()?.coerceAtLeast(0f) ?: 3f, + showMonthLabels = input.showMonthLabels, + showWeekdayLabels = input.showWeekdayLabels, + animated = input.animated, + emptyLabel = input.emptyLabel, + errorLabel = input.errorLabel, + accessibilityLabel = input.accessibilityLabel, + onSelect = input.onSelect, + locale = input.locale, + minimumFractionDigits = input.minimumFractionDigits, + maximumFractionDigits = input.maximumFractionDigits, + ), + ) +} + +internal fun nativePHPChartsSpecialSelectionPayload( + chartType: String, + id: String, + label: String, + index: Int, + x: String, + value: Double, + localizedValue: String, + xType: String = "category", +): Map = linkedMapOf( + "version" to 1, + "chart_type" to chartType, + "series_id" to id, + "series_name" to label, + "point_id" to id, + "point_index" to index, + "x_type" to xType, + "x" to x, + "label" to label, + "value" to value, + "localized_value" to localizedValue, +) diff --git a/resources/android/src/core/NativePHPChartsTheme.kt b/resources/android/src/core/NativePHPChartsTheme.kt new file mode 100644 index 0000000..133f5b2 --- /dev/null +++ b/resources/android/src/core/NativePHPChartsTheme.kt @@ -0,0 +1,48 @@ +package com.donmanueldev.plugins.nativephp_charts.ui + +import androidx.compose.ui.graphics.Color +import org.json.JSONObject + +internal data class NativePHPChartsTheme( + val background: String? = null, + val foreground: String? = null, + val muted: String? = null, + val grid: String? = null, + val track: String? = null, + val error: String? = null, + val palette: List = emptyList(), +) { + fun color(index: Int, fallback: Color): Color = + palette.takeIf { it.isNotEmpty() }?.let { colors -> + chartColor(colors[index.mod(colors.size)], fallback) + } ?: fallback +} + +internal fun nativePHPChartsTheme(json: String, mode: String, systemDark: Boolean): NativePHPChartsTheme { + val root = runCatching { JSONObject(json) }.getOrNull() ?: return NativePHPChartsTheme() + val resolvedMode = when (mode) { + "dark" -> "dark" + "light" -> "light" + else -> if (systemDark) "dark" else "light" + } + val value = root.optJSONObject(resolvedMode) ?: return NativePHPChartsTheme() + val palette = value.optJSONArray("palette")?.let { values -> + buildList { + for (index in 0 until values.length()) { + values.optString(index).takeIf(String::isNotBlank)?.let(::add) + } + } + }.orEmpty() + return NativePHPChartsTheme( + background = value.optionalThemeColor("background"), + foreground = value.optionalThemeColor("foreground"), + muted = value.optionalThemeColor("muted"), + grid = value.optionalThemeColor("grid"), + track = value.optionalThemeColor("track"), + error = value.optionalThemeColor("error"), + palette = palette, + ) +} + +private fun JSONObject.optionalThemeColor(name: String): String? = + optString(name).takeIf(String::isNotBlank) diff --git a/resources/android/src/core/NativePHPChartsWireInput.kt b/resources/android/src/core/NativePHPChartsWireInput.kt index 7602e1b..fd8684a 100644 --- a/resources/android/src/core/NativePHPChartsWireInput.kt +++ b/resources/android/src/core/NativePHPChartsWireInput.kt @@ -1,8 +1,9 @@ package com.donmanueldev.plugins.nativephp_charts.ui -import android.util.LruCache import com.nativephp.mobile.ui.nativerender.NativeUINode import java.io.File +import kotlinx.coroutines.Dispatchers +import kotlinx.coroutines.withContext /** * Raw Cartesian contract captured from a single [NativeUINode] render. @@ -16,7 +17,12 @@ import java.io.File internal data class NativePHPChartsWireInput( val contractVersion: Int, val seriesJson: String, + val seriesTransport: String, + val seriesJsonFile: String, val styleJson: String, + val themeMode: String, + val themeJson: String, + val preset: String, val xAxisJson: String, val yAxisJson: String, val legendJson: String, @@ -28,6 +34,7 @@ internal data class NativePHPChartsWireInput( val barMode: String, val barOrientation: String, val emptyLabel: String, + val errorLabel: String, val accessibilityLabel: String, val locale: String, val valueFormat: String, @@ -42,8 +49,6 @@ internal data class NativePHPChartsWireInput( val onViewportChange: Int, ) { companion object { - private val seriesFileCache = LruCache(8) - /** * Snapshots the wire props so Compose can key decoding with value equality. * Missing scalar props receive the legacy-compatible defaults used by PHP. @@ -53,8 +58,13 @@ internal data class NativePHPChartsWireInput( return NativePHPChartsWireInput( contractVersion = props.getInt("contract_version", 0), - seriesJson = resolveSeriesJson(node), + seriesJson = props.getString("series_json", "[]"), + seriesTransport = props.getString("series_transport", "inline-v1"), + seriesJsonFile = props.getString("series_json_file", ""), styleJson = props.getString("style_json", "{}"), + themeMode = props.getString("theme_mode", "system"), + themeJson = props.getString("theme_json", "{}"), + preset = props.getString("preset", "default"), xAxisJson = props.getString("x_axis_json", "{}"), yAxisJson = props.getString("y_axis_json", "{}"), legendJson = props.getString("legend_json", "{}"), @@ -66,6 +76,7 @@ internal data class NativePHPChartsWireInput( barMode = props.getString("bar_mode", "grouped"), barOrientation = props.getString("bar_orientation", "vertical"), emptyLabel = props.getString("empty_label", "No data"), + errorLabel = props.getString("error_label", "Chart unavailable"), accessibilityLabel = props.getString("a11y_label", "Chart"), locale = props.getString("locale", ""), valueFormat = props.getString("value_format", "number"), @@ -81,20 +92,19 @@ internal data class NativePHPChartsWireInput( ) } - private fun resolveSeriesJson(node: NativeUINode): String { - val inline = node.props.getString("series_json", "[]") - val transport = node.props.getString("series_transport", "inline-v1") - val path = node.props.getString("series_json_file", "") - if (transport != "file-v1" || path.isBlank()) return inline - - seriesFileCache.get(path)?.let { return it } - - // A stale or unreadable payload must render the normal empty state, - // never retain data from a different path or crash composition. - return try { - File(path).readText(Charsets.UTF_8).also { seriesFileCache.put(path, it) } - } catch (_: Exception) { - "[]" + suspend fun resolveSeriesJson(input: NativePHPChartsWireInput): NativePHPChartsDecodeResult { + if (input.seriesTransport != "file-v1") { + return NativePHPChartsDecodeResult.Success(input.seriesJson) + } + if (input.seriesJsonFile.isBlank()) { + return NativePHPChartsDecodeResult.Failure("missing_payload_file") + } + return withContext(Dispatchers.IO) { + runCatching { File(input.seriesJsonFile).readText(Charsets.UTF_8) } + .fold( + onSuccess = { NativePHPChartsDecodeResult.Success(it) }, + onFailure = { NativePHPChartsDecodeResult.Failure("unreadable_payload_file", it) }, + ) } } } diff --git a/resources/android/src/entrypoints/NativePHPChartsContributionHeatmapRenderer.kt b/resources/android/src/entrypoints/NativePHPChartsContributionHeatmapRenderer.kt new file mode 100644 index 0000000..509ca17 --- /dev/null +++ b/resources/android/src/entrypoints/NativePHPChartsContributionHeatmapRenderer.kt @@ -0,0 +1,12 @@ +package com.donmanueldev.plugins.nativephp_charts.ui + +import androidx.compose.runtime.Composable +import androidx.compose.ui.Modifier +import com.nativephp.mobile.ui.nativerender.NativeUINode + +object NativePHPChartsContributionHeatmapRenderer { + @Composable + fun Render(node: NativeUINode, modifier: Modifier) { + NativePHPChartsContributionRender(node, modifier) + } +} diff --git a/resources/android/src/entrypoints/NativePHPChartsProgressChartRenderer.kt b/resources/android/src/entrypoints/NativePHPChartsProgressChartRenderer.kt new file mode 100644 index 0000000..9e133a1 --- /dev/null +++ b/resources/android/src/entrypoints/NativePHPChartsProgressChartRenderer.kt @@ -0,0 +1,12 @@ +package com.donmanueldev.plugins.nativephp_charts.ui + +import androidx.compose.runtime.Composable +import androidx.compose.ui.Modifier +import com.nativephp.mobile.ui.nativerender.NativeUINode + +object NativePHPChartsProgressChartRenderer { + @Composable + fun Render(node: NativeUINode, modifier: Modifier) { + NativePHPChartsProgressRender(node, modifier) + } +} diff --git a/resources/android/src/interaction/NativePHPChartsHitTesting.kt b/resources/android/src/interaction/NativePHPChartsHitTesting.kt index 9556c3b..d8122de 100644 --- a/resources/android/src/interaction/NativePHPChartsHitTesting.kt +++ b/resources/android/src/interaction/NativePHPChartsHitTesting.kt @@ -89,12 +89,24 @@ internal class NativePHPChartsHitIndex private constructor( } companion object { - fun build(data: List): NativePHPChartsHitIndex = NativePHPChartsHitIndex( - dataSortedByX = data.sortedBy { it.center.x }, - maximumMarkHalfWidth = data.maxOfOrNull { - max(it.bar?.width?.div(2f) ?: 0f, it.candlestick?.body?.width?.div(2f) ?: 0f) - } ?: 0f, - ) + fun build(data: List): NativePHPChartsHitIndex { + var sorted = true + var maximumMarkHalfWidth = 0f + data.forEachIndexed { index, datum -> + if (index > 0 && data[index - 1].center.x > datum.center.x) { + sorted = false + } + maximumMarkHalfWidth = max( + maximumMarkHalfWidth, + max(datum.bar?.width?.div(2f) ?: 0f, datum.candlestick?.body?.width?.div(2f) ?: 0f), + ) + } + + return NativePHPChartsHitIndex( + dataSortedByX = if (sorted) data else data.sortedBy { it.center.x }, + maximumMarkHalfWidth = maximumMarkHalfWidth, + ) + } } } diff --git a/resources/android/src/rendering/NativePHPChartsContributionRenderer.kt b/resources/android/src/rendering/NativePHPChartsContributionRenderer.kt new file mode 100644 index 0000000..3a0d121 --- /dev/null +++ b/resources/android/src/rendering/NativePHPChartsContributionRenderer.kt @@ -0,0 +1,243 @@ +package com.donmanueldev.plugins.nativephp_charts.ui + +import android.graphics.Paint +import androidx.compose.animation.core.Animatable +import androidx.compose.animation.core.tween +import androidx.compose.foundation.Canvas +import androidx.compose.foundation.background +import androidx.compose.foundation.gestures.detectTapGestures +import androidx.compose.foundation.isSystemInDarkTheme +import androidx.compose.runtime.Composable +import androidx.compose.runtime.LaunchedEffect +import androidx.compose.runtime.getValue +import androidx.compose.runtime.mutableStateOf +import androidx.compose.runtime.remember +import androidx.compose.runtime.setValue +import androidx.compose.ui.Modifier +import androidx.compose.ui.geometry.Offset +import androidx.compose.ui.geometry.Rect +import androidx.compose.ui.graphics.drawscope.Fill +import androidx.compose.ui.graphics.nativeCanvas +import androidx.compose.ui.input.pointer.pointerInput +import androidx.compose.ui.layout.onSizeChanged +import androidx.compose.ui.platform.LocalContext +import androidx.compose.ui.platform.LocalDensity +import androidx.compose.ui.semantics.CustomAccessibilityAction +import androidx.compose.ui.semantics.contentDescription +import androidx.compose.ui.semantics.customActions +import androidx.compose.ui.semantics.onClick +import androidx.compose.ui.semantics.semantics +import androidx.compose.ui.semantics.stateDescription +import androidx.compose.ui.unit.IntSize +import androidx.compose.ui.unit.dp +import androidx.compose.ui.unit.sp +import com.nativephp.mobile.ui.nativerender.NativeUIBridge +import com.nativephp.mobile.ui.nativerender.NativeUINode +import org.json.JSONObject +import java.text.NumberFormat +import java.time.LocalDate +import java.time.format.TextStyle +import java.util.Locale +import kotlin.math.ceil +import kotlin.math.max + +internal data class NativePHPChartsContributionCell( + val date: LocalDate, + val rect: Rect, + val value: NativePHPChartsContributionValue?, + val column: Int, + val row: Int, +) + +internal data class NativePHPChartsContributionLayout( + val cells: List, + val columns: Int, +) { + fun cellAt(location: Offset): NativePHPChartsContributionCell? = cells.firstOrNull { it.rect.contains(location) } +} + +internal fun nativePHPChartsContributionLayout( + configuration: NativePHPChartsContributionConfiguration, + size: IntSize, + density: Float, +): NativePHPChartsContributionLayout { + if (size.width <= 0 || size.height <= 0) return NativePHPChartsContributionLayout(emptyList(), 0) + val startOffset = ((configuration.startDate.dayOfWeek.value % 7) - configuration.weekStartsOn + 7) % 7 + val columns = ceil((startOffset + configuration.days) / 7.0).toInt().coerceAtLeast(1) + val left = if (configuration.showWeekdayLabels) 30f * density else 0f + val top = if (configuration.showMonthLabels) 20f * density else 0f + val gap = configuration.cellGap * density + val available = minOf( + (size.width - left - gap * (columns - 1)).coerceAtLeast(1f) / columns, + (size.height - top - gap * 6).coerceAtLeast(1f) / 7f, + ).coerceAtLeast(1f) + val cell = minOf(configuration.cellSize?.times(density) ?: available, available) + val byDate = configuration.visibleValues.associateBy { it.date } + val cells = (0 until configuration.days).map { dayIndex -> + val slot = startOffset + dayIndex + val column = slot / 7 + val row = slot % 7 + val date = configuration.startDate.plusDays(dayIndex.toLong()) + val origin = Offset(left + column * (cell + gap), top + row * (cell + gap)) + NativePHPChartsContributionCell( + date = date, + rect = Rect(origin, androidx.compose.ui.geometry.Size(cell, cell)), + value = byDate[date], + column = column, + row = row, + ) + } + return NativePHPChartsContributionLayout(cells, columns) +} + +@Composable +internal fun NativePHPChartsContributionRender(node: NativeUINode, modifier: Modifier) { + val input = NativePHPChartsContributionWireInput.from(node) + val systemDark = isSystemInDarkTheme() + val decoded = rememberNativePHPChartsDecodedState(input to systemDark, "contribution_heatmap") { + decodeNativePHPChartsContribution(it.first, it.second) + } + when (decoded) { + NativePHPChartsAsyncState.Loading -> return + is NativePHPChartsAsyncState.Unavailable -> { + NativePHPChartsUnavailable(modifier, input.accessibilityLabel, input.errorLabel) + return + } + is NativePHPChartsAsyncState.Ready -> Unit + } + val configuration = (decoded as NativePHPChartsAsyncState.Ready).value + if (configuration.visibleValues.isEmpty()) { + NativePHPChartsEmpty(modifier, configuration.accessibilityLabel, configuration.emptyLabel) + return + } + NativePHPChartsContributionPlot(node, configuration, modifier) +} + +@Composable +private fun NativePHPChartsContributionPlot( + node: NativeUINode, + configuration: NativePHPChartsContributionConfiguration, + modifier: Modifier, +) { + val density = LocalDensity.current + val context = LocalContext.current + val shouldAnimate = configuration.animated && remember(context) { nativePHPChartsAnimationsEnabled(context) } + val progress = remember { Animatable(if (shouldAnimate) 0f else 1f) } + val interactionReady = progress.value >= 0.999f + var canvasSize by remember { mutableStateOf(IntSize.Zero) } + var selectedId by remember { mutableStateOf(null) } + val layout = remember(configuration, canvasSize, density.density) { + nativePHPChartsContributionLayout(configuration, canvasSize, density.density) + } + val selected = configuration.visibleValues.firstOrNull { it.id == selectedId } + val formatter = remember(configuration.locale, configuration.minimumFractionDigits, configuration.maximumFractionDigits) { + NumberFormat.getNumberInstance(configuration.locale.takeIf(String::isNotBlank)?.let(Locale::forLanguageTag) ?: Locale.getDefault()).apply { + if (configuration.minimumFractionDigits >= 0) minimumFractionDigits = configuration.minimumFractionDigits + if (configuration.maximumFractionDigits >= 0) maximumFractionDigits = configuration.maximumFractionDigits + } + } + val labelPaint = remember(density) { + Paint(Paint.ANTI_ALIAS_FLAG).apply { + color = android.graphics.Color.GRAY + textSize = with(density) { 10.sp.toPx() } + } + } + LaunchedEffect(configuration.animationKey, shouldAnimate) { + if (shouldAnimate) { + progress.snapTo(0f) + progress.animateTo(1f, tween(520)) + } else progress.snapTo(1f) + } + LaunchedEffect(configuration.visibleValues, selectedId) { + if (selectedId != null && selected == null) selectedId = null + } + + fun select(value: NativePHPChartsContributionValue): Boolean { + selectedId = value.id + if (configuration.onSelect > 0) { + val payload = nativePHPChartsSpecialSelectionPayload( + "contribution_heatmap", value.id, value.label, value.index, + value.date.toString(), value.value, formatter.format(value.value), + xType = "date", + ) + NativeUIBridge.sendTextChangeEvent(configuration.onSelect, node.id, JSONObject(payload).toString()) + } + return true + } + + val ordered = configuration.visibleValues.sortedBy { it.date } + val selectedIndex = ordered.indexOfFirst { it.id == selectedId } + val previous = ordered.getOrNull(selectedIndex - 1) + val next = ordered.getOrNull(if (selectedIndex < 0) 0 else selectedIndex + 1) + val summary = remember(configuration) { + buildString { + append(configuration.accessibilityLabel) + ordered.take(18).forEach { append(". ${it.label}: ${formatter.format(it.value)}") } + if (ordered.size > 18) append(". (+${ordered.size - 18})") + } + } + val maximum = max(configuration.visibleValues.maxOfOrNull { it.value } ?: 0.0, 1.0) + + Canvas( + modifier.background(configuration.backgroundColor) + .onSizeChanged { canvasSize = it } + .semantics { + contentDescription = summary + selected?.let { stateDescription = "${it.label}, ${formatter.format(it.value)}" } + onClick(label = selected?.label ?: configuration.accessibilityLabel) { + (selected ?: ordered.firstOrNull())?.let(::select) ?: false + } + customActions = listOfNotNull( + previous?.let { CustomAccessibilityAction("${it.label}, ${formatter.format(it.value)}") { select(it) } }, + next?.let { CustomAccessibilityAction("${it.label}, ${formatter.format(it.value)}") { select(it) } }, + ) + } + .pointerInput(layout, interactionReady) { + detectTapGestures { location -> + if (!interactionReady) return@detectTapGestures + layout.cellAt(location)?.value?.let(::select) + } + }, + ) { + val visibleColumns = ceil(layout.columns * progress.value).toInt() + layout.cells.filter { it.column < visibleColumns }.forEach { cell -> + val value = cell.value + val color = if (value == null || value.value <= 0.0) { + configuration.emptyColor + } else { + val fraction = (value.value / maximum).coerceIn(0.0, 1.0) + val index = ceil(fraction * configuration.colors.size).toInt().coerceIn(1, configuration.colors.size) - 1 + configuration.colors[index] + } + drawRoundRect(color, cell.rect.topLeft, cell.rect.size, androidx.compose.ui.geometry.CornerRadius(2.dp.toPx()), style = Fill) + if (value?.id == selectedId) { + drawRoundRect( + color = androidx.compose.ui.graphics.Color.White, + topLeft = cell.rect.topLeft, + size = cell.rect.size, + cornerRadius = androidx.compose.ui.geometry.CornerRadius(2.dp.toPx()), + style = androidx.compose.ui.graphics.drawscope.Stroke(2.dp.toPx()), + ) + } + } + if (configuration.showWeekdayLabels) { + val rows = listOf(0, 2, 4, 6) + rows.forEach { row -> + val date = configuration.startDate.plusDays(((row - (((configuration.startDate.dayOfWeek.value % 7) - configuration.weekStartsOn + 7) % 7) + 7) % 7).toLong()) + val cell = layout.cells.firstOrNull { it.row == row } ?: return@forEach + drawContext.canvas.nativeCanvas.drawText( + date.dayOfWeek.getDisplayName(TextStyle.NARROW, Locale.getDefault()), + 2.dp.toPx(), cell.rect.center.y - labelPaint.fontMetrics.ascent / 2, labelPaint, + ) + } + } + if (configuration.showMonthLabels) { + layout.cells.filter { it.row == 0 }.distinctBy { it.date.month }.forEach { cell -> + drawContext.canvas.nativeCanvas.drawText( + cell.date.month.getDisplayName(TextStyle.SHORT, Locale.getDefault()), + cell.rect.left, 12.dp.toPx(), labelPaint, + ) + } + } + } +} diff --git a/resources/android/src/rendering/NativePHPChartsDrawing.kt b/resources/android/src/rendering/NativePHPChartsDrawing.kt index 8450b72..02ec093 100644 --- a/resources/android/src/rendering/NativePHPChartsDrawing.kt +++ b/resources/android/src/rendering/NativePHPChartsDrawing.kt @@ -16,6 +16,7 @@ import androidx.compose.ui.graphics.nativeCanvas import androidx.compose.ui.graphics.toArgb import androidx.compose.ui.unit.dp import com.nativephp.plugins.native_ui.ui.NativeUIFontResolver +import kotlin.math.floor import kotlin.math.max import kotlin.math.min @@ -64,9 +65,17 @@ internal class NativePHPChartsPathCache private constructor( val interpolation = series.style?.interpolation ?: configuration.style.interpolation val target = series.fillTo?.let(renderDataBySeries::get) + val lineData = if ( + interpolation == "linear" && + (series.style?.dash ?: configuration.style.dash).isEmpty() + ) { + nativePHPChartsCoalesceLinearToPixels(data) + } else { + data + } NativePHPChartsSeriesPaths( data = data, - line = nativePHPChartsPath(data, interpolation, 1f, layout), + line = nativePHPChartsPath(lineData, interpolation, 1f, layout), area = if (includeArea) nativePHPChartsAreaPath(data, interpolation, 1f, layout) else null, fillBetween = target?.let { nativePHPChartsBetweenPath(data, it, interpolation, 1f, layout) }, fillTarget = target, @@ -77,6 +86,50 @@ internal class NativePHPChartsPathCache private constructor( } } +/** + * Reduces only sub-pixel linear geometry sent to HWUI. The full data list is + * retained by [NativePHPChartsSeriesPaths] for hit-testing and callbacks. For + * each physical x column, endpoints and vertical extrema remain in source + * order so no screen-visible peak or trough is discarded. + */ +internal fun nativePHPChartsCoalesceLinearToPixels( + data: List, +): List { + if (data.size <= 4) return data + + val result = ArrayList(data.size) + var groupStart = 0 + + fun appendGroup(start: Int, endExclusive: Int) { + if (endExclusive - start <= 4) { + for (index in start until endExclusive) result.add(data[index]) + return + } + + var minimumIndex = start + var maximumIndex = start + for (index in start + 1 until endExclusive) { + if (data[index].center.y < data[minimumIndex].center.y) minimumIndex = index + if (data[index].center.y > data[maximumIndex].center.y) maximumIndex = index + } + listOf(start, minimumIndex, maximumIndex, endExclusive - 1) + .distinct() + .sorted() + .forEach { result.add(data[it]) } + } + + for (index in 1..data.size) { + val groupEnded = index == data.size || + floor(data[index].center.x) != floor(data[groupStart].center.x) + if (groupEnded) { + appendGroup(groupStart, index) + groupStart = index + } + } + + return result +} + /** * Removes marks irrelevant to the horizontal viewport while retaining one * neighbor on each side and every segment that crosses the visible plot. @@ -99,13 +152,15 @@ internal fun nativePHPChartsCullToPlot( if (datum.center.x in plot.left..plot.right) { include(index) } - } - data.zipWithNext().forEachIndexed { index, (start, end) -> - val segmentMinimum = min(start.center.x, end.center.x) - val segmentMaximum = max(start.center.x, end.center.x) - if (segmentMinimum <= plot.right && segmentMaximum >= plot.left) { - include(index) - include(index + 1) + + if (index + 1 < data.size) { + val next = data[index + 1] + val segmentMinimum = min(datum.center.x, next.center.x) + val segmentMaximum = max(datum.center.x, next.center.x) + if (segmentMinimum <= plot.right && segmentMaximum >= plot.left) { + include(index) + include(index + 1) + } } } diff --git a/resources/android/src/rendering/NativePHPChartsEmpty.kt b/resources/android/src/rendering/NativePHPChartsEmpty.kt new file mode 100644 index 0000000..b8434b5 --- /dev/null +++ b/resources/android/src/rendering/NativePHPChartsEmpty.kt @@ -0,0 +1,22 @@ +package com.donmanueldev.plugins.nativephp_charts.ui + +import androidx.compose.foundation.layout.Box +import androidx.compose.foundation.layout.fillMaxSize +import androidx.compose.foundation.layout.padding +import androidx.compose.material3.Text +import androidx.compose.runtime.Composable +import androidx.compose.ui.Modifier +import androidx.compose.ui.semantics.clearAndSetSemantics +import androidx.compose.ui.semantics.contentDescription +import androidx.compose.ui.unit.dp + +@Composable +internal fun NativePHPChartsEmpty(modifier: Modifier, accessibilityLabel: String, emptyLabel: String) { + Box( + modifier.fillMaxSize().clearAndSetSemantics { + contentDescription = "$accessibilityLabel: $emptyLabel" + }, + ) { + Text(emptyLabel, Modifier.padding(16.dp)) + } +} diff --git a/resources/android/src/rendering/NativePHPChartsPlot.kt b/resources/android/src/rendering/NativePHPChartsPlot.kt index 3253816..28b503b 100644 --- a/resources/android/src/rendering/NativePHPChartsPlot.kt +++ b/resources/android/src/rendering/NativePHPChartsPlot.kt @@ -105,6 +105,10 @@ internal fun NativePHPChartsPlot( var selectedIdentity by remember { mutableStateOf(null) } val animationKey = remember(configuration) { configuration.animationKey } val progress = remember { Animatable(if (shouldAnimate) 0f else 1f) } + val interactionReady = progress.value >= 0.999f + val pointCount = remember(configuration.series) { configuration.series.sumOf { it.points.size } } + val drawObserver = LocalNativePHPChartsDrawObserver.current + val traceSuffix = "${configuration.kind.name.lowercase()}.$pointCount" LaunchedEffect(animationKey, shouldAnimate) { if (shouldAnimate) { progress.snapTo(0f) @@ -113,17 +117,23 @@ internal fun NativePHPChartsPlot( progress.snapTo(1f) } } - val summary = remember(configuration, formatting) { configuration.accessibilitySummary(formatting) } + val summary = remember(configuration, formatting) { + NativePHPChartsPerformance.trace("NPC.accessibility.$traceSuffix") { + configuration.accessibilitySummary(formatting) + } + } val baseLayout = remember(configuration, formatting, canvasSize, density, drawingResources.axisLabelPaint) { - val fontMetrics = drawingResources.axisLabelPaint.fontMetrics - NativePHPChartsLayoutEngine.build( - configuration = configuration, - formatting = formatting, - size = canvasSize, - density = density, - measureAxisLabel = drawingResources.axisLabelPaint::measureText, - axisLabelHeight = fontMetrics.descent - fontMetrics.ascent, - ) + NativePHPChartsPerformance.trace("NPC.layout.$traceSuffix") { + val fontMetrics = drawingResources.axisLabelPaint.fontMetrics + NativePHPChartsLayoutEngine.build( + configuration = configuration, + formatting = formatting, + size = canvasSize, + density = density, + measureAxisLabel = drawingResources.axisLabelPaint::measureText, + axisLabelHeight = fontMetrics.descent - fontMetrics.ascent, + ) + } } val configuredViewport = remember(configuration.viewport, formatting) { if (!configuration.viewport.enabled) { @@ -149,25 +159,29 @@ internal fun NativePHPChartsPlot( if (!configuration.viewport.enabled || viewportDomain == null) { baseLayout } else { - val fontMetrics = drawingResources.axisLabelPaint.fontMetrics - NativePHPChartsLayoutEngine.build( - configuration = configuration, - formatting = formatting, - size = canvasSize, - density = density, - measureAxisLabel = drawingResources.axisLabelPaint::measureText, - axisLabelHeight = fontMetrics.descent - fontMetrics.ascent, - viewportOverride = viewportDomain, - ) + NativePHPChartsPerformance.trace("NPC.viewport-layout.$traceSuffix") { + val fontMetrics = drawingResources.axisLabelPaint.fontMetrics + NativePHPChartsLayoutEngine.build( + configuration = configuration, + formatting = formatting, + size = canvasSize, + density = density, + measureAxisLabel = drawingResources.axisLabelPaint::measureText, + axisLabelHeight = fontMetrics.descent - fontMetrics.ascent, + viewportOverride = viewportDomain, + ) + } } } val pathCache = remember(layout, configuration) { if (configuration.kind == NativePHPChartsKind.Line || configuration.kind == NativePHPChartsKind.Area) { - NativePHPChartsPathCache.build( - layout = layout, - configuration = configuration, - includeArea = configuration.kind == NativePHPChartsKind.Area, - ) + NativePHPChartsPerformance.trace("NPC.path-cache.$traceSuffix") { + NativePHPChartsPathCache.build( + layout = layout, + configuration = configuration, + includeArea = configuration.kind == NativePHPChartsKind.Area, + ) + } } else { null } @@ -334,8 +348,8 @@ internal fun NativePHPChartsPlot( }, ) } - .pointerInput(configuration.interaction.enabled, configuration.interaction.mode, density) { - if (!configuration.interaction.enabled) return@pointerInput + .pointerInput(configuration.interaction.enabled, configuration.interaction.mode, density, interactionReady) { + if (!configuration.interaction.enabled || !interactionReady) return@pointerInput if (configuration.interaction.mode == "scrub") { var pending: NativePHPChartsDatum? = null @@ -357,34 +371,37 @@ internal fun NativePHPChartsPlot( } }, ) { - drawNativePHPChartsAxes(configuration, layout, drawingResources) - clipRect(layout.plot.left, layout.plot.top, layout.plot.right, layout.plot.bottom) { - drawNativePHPChartsAnnotations(layout) - when (configuration.kind) { - NativePHPChartsKind.Line -> drawNativePHPChartsLines( - configuration, layout, progress.value, false, drawingResources, requireNotNull(pathCache), - ) - NativePHPChartsKind.Area -> drawNativePHPChartsLines( - configuration, layout, progress.value, true, drawingResources, requireNotNull(pathCache), - ) - NativePHPChartsKind.Bar -> drawNativePHPChartsBars(configuration, layout, progress.value) - NativePHPChartsKind.Scatter -> drawNativePHPChartsScatter( - configuration, layout, progress.value, drawingResources, - ) - NativePHPChartsKind.Candlestick -> drawNativePHPChartsCandlesticks(configuration, layout, progress.value) - } - selected?.let { - drawNativePHPChartsSelectionOverlay( - it, selectedData, configuration.interaction, layout, drawingResources, - ) - } - selected?.takeIf { configuration.interaction.tooltip != "none" }?.let { - drawNativePHPChartsTooltip( - it, selectedData, configuration.interaction, formatting, layout, drawingResources, - ) + NativePHPChartsPerformance.trace("NPC.draw.$traceSuffix") { + drawNativePHPChartsAxes(configuration, layout, drawingResources) + clipRect(layout.plot.left, layout.plot.top, layout.plot.right, layout.plot.bottom) { + drawNativePHPChartsAnnotations(layout) + when (configuration.kind) { + NativePHPChartsKind.Line -> drawNativePHPChartsLines( + configuration, layout, progress.value, false, drawingResources, requireNotNull(pathCache), + ) + NativePHPChartsKind.Area -> drawNativePHPChartsLines( + configuration, layout, progress.value, true, drawingResources, requireNotNull(pathCache), + ) + NativePHPChartsKind.Bar -> drawNativePHPChartsBars(configuration, layout, progress.value) + NativePHPChartsKind.Scatter -> drawNativePHPChartsScatter( + configuration, layout, progress.value, drawingResources, + ) + NativePHPChartsKind.Candlestick -> drawNativePHPChartsCandlesticks(configuration, layout, progress.value) + } + selected?.let { + drawNativePHPChartsSelectionOverlay( + it, selectedData, configuration.interaction, layout, drawingResources, + ) + } + selected?.takeIf { configuration.interaction.tooltip != "none" }?.let { + drawNativePHPChartsTooltip( + it, selectedData, configuration.interaction, formatting, layout, drawingResources, + ) + } } + drawNativePHPChartsAnnotationLabels(layout, drawingResources) } - drawNativePHPChartsAnnotationLabels(layout, drawingResources) + drawObserver?.invoke(configuration.kind, pointCount) } } diff --git a/resources/android/src/rendering/NativePHPChartsProgressRenderer.kt b/resources/android/src/rendering/NativePHPChartsProgressRenderer.kt new file mode 100644 index 0000000..01b406d --- /dev/null +++ b/resources/android/src/rendering/NativePHPChartsProgressRenderer.kt @@ -0,0 +1,192 @@ +package com.donmanueldev.plugins.nativephp_charts.ui + +import androidx.compose.animation.core.Animatable +import androidx.compose.animation.core.tween +import androidx.compose.foundation.Canvas +import androidx.compose.foundation.background +import androidx.compose.foundation.isSystemInDarkTheme +import androidx.compose.foundation.layout.Box +import androidx.compose.foundation.layout.Column +import androidx.compose.foundation.layout.fillMaxSize +import androidx.compose.material3.Text +import androidx.compose.runtime.Composable +import androidx.compose.runtime.LaunchedEffect +import androidx.compose.runtime.getValue +import androidx.compose.runtime.mutableStateOf +import androidx.compose.runtime.remember +import androidx.compose.runtime.setValue +import androidx.compose.ui.Alignment +import androidx.compose.ui.Modifier +import androidx.compose.ui.geometry.Offset +import androidx.compose.ui.geometry.Rect +import androidx.compose.ui.geometry.Size +import androidx.compose.ui.graphics.StrokeCap +import androidx.compose.ui.graphics.drawscope.Stroke +import androidx.compose.ui.input.pointer.pointerInput +import androidx.compose.foundation.gestures.detectTapGestures +import androidx.compose.ui.platform.LocalContext +import androidx.compose.ui.platform.LocalDensity +import androidx.compose.ui.semantics.CustomAccessibilityAction +import androidx.compose.ui.semantics.contentDescription +import androidx.compose.ui.semantics.customActions +import androidx.compose.ui.semantics.onClick +import androidx.compose.ui.semantics.semantics +import androidx.compose.ui.semantics.stateDescription +import androidx.compose.ui.unit.dp +import com.nativephp.mobile.ui.nativerender.NativeUIBridge +import com.nativephp.mobile.ui.nativerender.NativeUINode +import org.json.JSONObject +import java.text.NumberFormat +import java.util.Locale +import kotlin.math.abs +import kotlin.math.min + +@Composable +internal fun NativePHPChartsProgressRender(node: NativeUINode, modifier: Modifier) { + val input = NativePHPChartsProgressWireInput.from(node) + val systemDark = isSystemInDarkTheme() + val decoded = rememberNativePHPChartsDecodedState(input to systemDark, "progress") { + decodeNativePHPChartsProgress(it.first, it.second) + } + when (decoded) { + NativePHPChartsAsyncState.Loading -> return + is NativePHPChartsAsyncState.Unavailable -> { + NativePHPChartsUnavailable(modifier, input.accessibilityLabel, input.errorLabel) + return + } + is NativePHPChartsAsyncState.Ready -> Unit + } + val configuration = (decoded as NativePHPChartsAsyncState.Ready).value + if (configuration.metrics.isEmpty()) { + NativePHPChartsEmpty(modifier, configuration.accessibilityLabel, configuration.emptyLabel) + return + } + NativePHPChartsProgressPlot(node, configuration, modifier) +} + +@Composable +private fun NativePHPChartsProgressPlot( + node: NativeUINode, + configuration: NativePHPChartsProgressConfiguration, + modifier: Modifier, +) { + val density = LocalDensity.current.density + val context = LocalContext.current + val shouldAnimate = configuration.animated && remember(context) { nativePHPChartsAnimationsEnabled(context) } + val progress = remember { Animatable(if (shouldAnimate) 0f else 1f) } + val interactionReady = progress.value >= 0.999f + var selectedId by remember { mutableStateOf(null) } + val selected = configuration.metrics.firstOrNull { it.id == selectedId } + val percent = remember(configuration.locale) { NumberFormat.getPercentInstance(configuration.locale.takeIf(String::isNotBlank)?.let(Locale::forLanguageTag) ?: Locale.getDefault()) } + LaunchedEffect(configuration.animationKey, shouldAnimate) { + if (shouldAnimate) { + progress.snapTo(0f) + progress.animateTo(1f, tween(500)) + } else progress.snapTo(1f) + } + LaunchedEffect(configuration.metrics, selectedId) { + if (selectedId != null && selected == null) selectedId = null + } + + fun select(metric: NativePHPChartsProgressMetric): Boolean { + selectedId = metric.id + if (configuration.onSelect > 0) { + val payload = nativePHPChartsSpecialSelectionPayload( + "progress", metric.id, metric.label, metric.index, metric.label, + metric.value, percent.format(metric.value), + ) + NativeUIBridge.sendTextChangeEvent(configuration.onSelect, node.id, JSONObject(payload).toString()) + } + return true + } + + val summary = remember(configuration) { + configuration.accessibilityLabel + configuration.metrics.joinToString(separator = ". ", prefix = ". ") { + "${it.label}: ${percent.format(it.value)}" + } + } + val selectedIndex = configuration.metrics.indexOfFirst { it.id == selectedId } + val previous = configuration.metrics.getOrNull(selectedIndex - 1) + val next = configuration.metrics.getOrNull(if (selectedIndex < 0) 0 else selectedIndex + 1) + + Column(modifier.fillMaxSize().background(configuration.backgroundColor)) { + Box(Modifier.weight(1f), contentAlignment = Alignment.Center) { + Canvas( + Modifier.fillMaxSize() + .semantics { + contentDescription = summary + selected?.let { stateDescription = "${it.label}, ${percent.format(it.value)}" } + onClick(label = selected?.label ?: configuration.accessibilityLabel) { + (selected ?: configuration.metrics.firstOrNull())?.let(::select) ?: false + } + customActions = listOfNotNull( + previous?.let { CustomAccessibilityAction("${it.label}, ${percent.format(it.value)}") { select(it) } }, + next?.let { CustomAccessibilityAction("${it.label}, ${percent.format(it.value)}") { select(it) } }, + ) + } + .pointerInput(configuration.metrics, interactionReady) { + detectTapGestures { location -> + if (!interactionReady) return@detectTapGestures + progressMetricAt(configuration.metrics, size.width, size.height, density, configuration.ringWidth, configuration.ringGap, location)?.let(::select) + } + }, + ) { + val ringWidth = configuration.ringWidth.dp.toPx().coerceAtMost(min(size.width, size.height) / (configuration.metrics.size * 2f + 1f)) + val gap = configuration.ringGap.dp.toPx() + val cap = when (configuration.ringCap) { "butt" -> StrokeCap.Butt; "square" -> StrokeCap.Square; else -> StrokeCap.Round } + val outerRadius = (min(size.width, size.height) / 2f) - ringWidth + configuration.metrics.forEachIndexed { index, metric -> + val radius = outerRadius - index * (ringWidth + gap) + if (radius <= ringWidth) return@forEachIndexed + val bounds = Rect(center - Offset(radius, radius), Size(radius * 2, radius * 2)) + drawArc(configuration.trackColor, -90f, 360f, false, bounds.topLeft, bounds.size, style = Stroke(ringWidth, cap = cap)) + drawArc( + metric.color, + -90f, + (360f * metric.value * progress.value).toFloat(), + false, + bounds.topLeft, + bounds.size, + style = Stroke(ringWidth, cap = cap), + ) + if (metric.id == selectedId) { + drawArc(metric.color.copy(alpha = 0.28f), -90f, 360f, false, bounds.topLeft, bounds.size, style = Stroke(ringWidth + 6.dp.toPx())) + } + } + } + if (configuration.centerLabel.isNotBlank()) Text(configuration.centerLabel) + } + if (configuration.legendVisible) configuration.metrics.forEach { metric -> Text("${metric.label}: ${percent.format(metric.value)}") } + } +} + +internal fun progressMetricIndexAt( + metricCount: Int, + width: Float, + height: Float, + density: Float, + location: Offset, + ringWidthDp: Float = 12f, + gapDp: Float = 7f, +): Int? { + if (metricCount <= 0 || width <= 0 || height <= 0) return null + val ringWidth = (ringWidthDp * density).coerceAtMost(min(width, height) / (metricCount * 2f + 1f)) + val gap = gapDp * density + val outerRadius = min(width, height) / 2f - ringWidth + val distance = (location - Offset(width / 2f, height / 2f)).getDistance() + return (0 until metricCount).firstOrNull { index -> + val radius = outerRadius - index * (ringWidth + gap) + radius > ringWidth && abs(distance - radius) <= (ringWidth + gap) / 2f + } +} + +private fun progressMetricAt( + metrics: List, + width: Int, + height: Int, + density: Float, + ringWidthDp: Float, + gapDp: Float, + location: Offset, +): NativePHPChartsProgressMetric? = + progressMetricIndexAt(metrics.size, width.toFloat(), height.toFloat(), density, location, ringWidthDp, gapDp)?.let(metrics::getOrNull) diff --git a/resources/android/src/rendering/NativePHPChartsRadarRenderer.kt b/resources/android/src/rendering/NativePHPChartsRadarRenderer.kt index 242b988..5e79f4b 100644 --- a/resources/android/src/rendering/NativePHPChartsRadarRenderer.kt +++ b/resources/android/src/rendering/NativePHPChartsRadarRenderer.kt @@ -4,6 +4,7 @@ import android.graphics.Paint import androidx.compose.animation.core.Animatable import androidx.compose.animation.core.tween import androidx.compose.foundation.Canvas +import androidx.compose.foundation.isSystemInDarkTheme import androidx.compose.foundation.background import androidx.compose.foundation.gestures.detectTapGestures import androidx.compose.foundation.horizontalScroll @@ -205,6 +206,56 @@ internal fun nativePHPChartsRadarTooltipLayout( ) } +internal data class NativePHPChartsRadarWireInput( + val contractVersion: Int, + val axesJson: String, + val seriesJson: String, + val styleJson: String, + val themeMode: String, + val themeJson: String, + val preset: String, + val legendJson: String, + val locale: String, + val valueFormat: String, + val currencyCode: String, + val minimumFractionDigits: Int, + val maximumFractionDigits: Int, + val animated: Boolean, + val emptyLabel: String, + val errorLabel: String, + val accessibilityLabel: String, + val onSelect: Int, + val gridLevels: Int, + val fillOpacity: Float, +) { + companion object { + fun from(node: NativeUINode): NativePHPChartsRadarWireInput = node.props.let { props -> + NativePHPChartsRadarWireInput( + contractVersion = props.getInt("contract_version", 0), + axesJson = props.getString("axes_json", "[]"), + seriesJson = props.getString("series_json", "[]"), + styleJson = props.getString("style_json", "{}"), + themeMode = props.getString("theme_mode", "system"), + themeJson = props.getString("theme_json", "{}"), + preset = props.getString("preset", "default"), + legendJson = props.getString("legend_json", "{}"), + locale = props.getString("locale", ""), + valueFormat = props.getString("value_format", "number"), + currencyCode = props.getString("currency_code", ""), + minimumFractionDigits = props.getInt("minimum_fraction_digits", -1), + maximumFractionDigits = props.getInt("maximum_fraction_digits", -1), + animated = props.getBool("animated", true), + emptyLabel = props.getString("empty_label", "No data"), + errorLabel = props.getString("error_label", "Chart unavailable"), + accessibilityLabel = props.getString("a11y_label", "Chart"), + onSelect = props.getCallbackId("on_select"), + gridLevels = props.getInt("grid_levels", 5), + fillOpacity = props.getFloat("fill_opacity", 0.22f), + ) + } + } +} + /** * Radar renderer boundary from NativePHP props to normalized Compose state. * @@ -214,18 +265,18 @@ internal fun nativePHPChartsRadarTooltipLayout( */ @Composable internal fun NativePHPChartsRadarRender(node: NativeUINode, modifier: Modifier) { - val props = node.props - val wireKey = listOf( - props.getString("axes_json", "[]"), props.getString("series_json", "[]"), - props.getString("style_json", "{}"), props.getString("legend_json", "{}"), - props.getString("locale", ""), props.getString("value_format", "number"), - props.getString("currency_code", ""), props.getInt("minimum_fraction_digits", -1), - props.getInt("maximum_fraction_digits", -1), props.getBool("animated", true), - props.getString("empty_label", "No data"), props.getString("a11y_label", "Chart"), - props.getCallbackId("on_select"), props.getInt("grid_levels", 5), - props.getFloat("fill_opacity", 0.22f), - ) - val configuration = remember(wireKey) { decodeRadarConfiguration(node) } + val wireInput = NativePHPChartsRadarWireInput.from(node) + val systemDark = isSystemInDarkTheme() + val decoded = rememberNativePHPChartsDecodedState(wireInput to systemDark, "radar") { + decodeRadarConfiguration(it.first, it.second) + } + if (decoded !is NativePHPChartsAsyncState.Ready) { + if (decoded is NativePHPChartsAsyncState.Unavailable) { + NativePHPChartsUnavailable(modifier, wireInput.accessibilityLabel, wireInput.errorLabel) + } + return + } + val configuration = decoded.value val formatting = remember(configuration) { NativePHPChartsRadarFormatting(configuration) } if (!configuration.hasData) { @@ -294,6 +345,7 @@ private fun NativePHPChartsRadarPlot( var selectedId by remember { mutableStateOf(null) } val selected = configuration.selections.firstOrNull { it.id == selectedId } val progress = remember { Animatable(if (shouldAnimate) 0f else 1f) } + val interactionReady = progress.value >= 0.999f LaunchedEffect(configuration.animationKey, shouldAnimate) { if (shouldAnimate) { @@ -365,8 +417,9 @@ private fun NativePHPChartsRadarPlot( }, ) } - .pointerInput(configuration.selections, size) { + .pointerInput(configuration.selections, size, interactionReady) { detectTapGestures { location -> + if (!interactionReady) return@detectTapGestures selectedId = nativePHPChartsRadarSelectedIdAfterTap( selections = radarSelections(configuration, size, 1f), location = location, @@ -609,33 +662,47 @@ private fun radarPath(points: List, interpolation: String): Path = Path( * Collection decoding is fail-soft, visual fallbacks mirror the public defaults, * opacity is bounded to 0...1, and grid levels are bounded to 2...10. */ -private fun decodeRadarConfiguration(node: NativeUINode): NativePHPChartsRadarConfiguration { - val props = node.props - val axes = radarArray(props.getString("axes_json", "[]")) { item, _ -> +private fun decodeRadarConfiguration( + input: NativePHPChartsRadarWireInput, + systemDark: Boolean, +): NativePHPChartsDecodeResult { + nativePHPChartsContractFailure(input.contractVersion)?.let { return it } + val theme = nativePHPChartsTheme(input.themeJson, input.themeMode, systemDark) + val axes = radarArray(input.axesJson) { item, _ -> NativePHPChartsRadarAxis(item.getString("id"), item.getString("label"), item.getDouble("maximum")) - } - val series = radarArray(props.getString("series_json", "[]")) { item, _ -> + } ?: return NativePHPChartsDecodeResult.Failure("malformed_radar_axes") + val series = radarArray(input.seriesJson) { item, seriesIndex -> NativePHPChartsRadarSeries( id = item.getString("id"), name = item.getString("name"), - color = chartColor(item.getString("color"), Color(0xFF6366F1)), + color = item.optString("color").takeIf(String::isNotBlank) + ?.let { chartColor(it, Color(0xFF6366F1)) } + ?: theme.color(seriesIndex, Color(0xFF6366F1)), values = radarArray(item.getJSONArray("values")) { value, _ -> NativePHPChartsRadarValue(value.getString("axis"), value.getDouble("value")) - }, + } ?: throw IllegalArgumentException("invalid radar values"), ) - } - val styleRoot = radarObject(props.getString("style_json", "{}")) + } ?: return NativePHPChartsDecodeResult.Failure("malformed_radar_series") + if (axes.any { it.id.isBlank() || it.label.isBlank() || !it.maximum.isFinite() || it.maximum <= 0.0 } || + (axes.isNotEmpty() && axes.size < 3) || + series.any { item -> + item.id.isBlank() || item.name.isBlank() || item.values.size != axes.size || + item.values.zip(axes).any { (value, axis) -> + value.axis != axis.id || !value.value.isFinite() || value.value < 0.0 || value.value > axis.maximum + } + } + ) return NativePHPChartsDecodeResult.Failure("invalid_radar_snapshot") + val styleRoot = radarObject(input.styleJson) val line = styleRoot.optJSONObject("line") val area = styleRoot.optJSONObject("area") val points = styleRoot.optJSONObject("points") val grid = styleRoot.optJSONObject("grid") val axis = styleRoot.optJSONObject("axis") - val legendRoot = radarObject(props.getString("legend_json", "{}")) + val legendRoot = radarObject(input.legendJson) val legendStyle = legendRoot.optJSONObject("style") - val fillOpacity = area?.optDouble("opacity", props.getFloat("fill_opacity", 0.22f).toDouble())?.toFloat() - ?: props.getFloat("fill_opacity", 0.22f) + val fillOpacity = area?.optDouble("opacity", input.fillOpacity.toDouble())?.toFloat() ?: input.fillOpacity - return NativePHPChartsRadarConfiguration( + return NativePHPChartsDecodeResult.Success(NativePHPChartsRadarConfiguration( axes = axes, series = series, style = NativePHPChartsRadarStyle( @@ -651,11 +718,11 @@ private fun decodeRadarConfiguration(node: NativeUINode): NativePHPChartsRadarCo pointColor = points?.optString("color")?.takeIf(String::isNotBlank), pointSize = points?.optDouble("size", 7.0)?.toFloat() ?: 7f, gridVisible = grid?.optBoolean("visible", true) ?: true, - gridColor = grid?.optString("color")?.takeIf(String::isNotBlank), + gridColor = grid?.optString("color")?.takeIf(String::isNotBlank) ?: theme.grid, gridWidth = grid?.optDouble("width", 1.0)?.toFloat() ?: 1f, axisVisible = axis?.optBoolean("visible", true) ?: true, - axisColor = axis?.optString("color")?.takeIf(String::isNotBlank), - axisLabelColor = axis?.optString("label_color")?.takeIf(String::isNotBlank), + axisColor = axis?.optString("color")?.takeIf(String::isNotBlank) ?: theme.muted, + axisLabelColor = axis?.optString("label_color")?.takeIf(String::isNotBlank) ?: theme.foreground, axisFont = axis?.optString("font")?.takeIf(String::isNotBlank), axisFontSize = axis?.optDouble("font_size", 10.0)?.toFloat() ?: 10f, ), @@ -668,17 +735,18 @@ private fun decodeRadarConfiguration(node: NativeUINode): NativePHPChartsRadarCo font = legendStyle?.optString("font")?.takeIf(String::isNotBlank), labelColor = legendStyle?.optString("label_color")?.takeIf(String::isNotBlank), ), - locale = props.getString("locale", ""), - valueFormat = props.getString("value_format", "number"), - currencyCode = props.getString("currency_code", ""), - minimumFractionDigits = props.getInt("minimum_fraction_digits", -1), - maximumFractionDigits = props.getInt("maximum_fraction_digits", -1), - animated = props.getBool("animated", true), - emptyLabel = props.getString("empty_label", "No data"), - accessibilityLabel = props.getString("a11y_label", "Chart"), - onSelect = props.getCallbackId("on_select"), - gridLevels = props.getInt("grid_levels", 5).coerceIn(2, 10), - ) + locale = input.locale, + valueFormat = input.valueFormat, + currencyCode = input.currencyCode, + minimumFractionDigits = input.minimumFractionDigits, + maximumFractionDigits = input.maximumFractionDigits, + animated = input.animated, + emptyLabel = input.emptyLabel, + errorLabel = input.errorLabel, + accessibilityLabel = input.accessibilityLabel, + onSelect = input.onSelect, + gridLevels = input.gridLevels.coerceIn(2, 10), + )) } private fun radarObject(json: String): JSONObject = runCatching { JSONObject(json) }.getOrDefault(JSONObject()) @@ -686,13 +754,14 @@ private fun radarObject(json: String): JSONObject = runCatching { JSONObject(jso private fun radarArray( json: String, transform: (JSONObject, Int) -> Value?, -): List = runCatching { radarArray(JSONArray(json), transform) }.getOrElse { - emptyList() -} +): List? = runCatching { radarArray(JSONArray(json), transform) }.getOrNull() private fun radarArray( array: JSONArray, transform: (JSONObject, Int) -> Value?, -): List = buildList { - for (index in 0 until array.length()) array.optJSONObject(index)?.let { transform(it, index) }?.let(::add) +): List? = buildList { + for (index in 0 until array.length()) { + val item = array.optJSONObject(index) ?: return null + add(transform(item, index) ?: return null) + } } diff --git a/resources/android/src/rendering/NativePHPChartsRadialPlot.kt b/resources/android/src/rendering/NativePHPChartsRadialPlot.kt index dc994b1..4bd945f 100644 --- a/resources/android/src/rendering/NativePHPChartsRadialPlot.kt +++ b/resources/android/src/rendering/NativePHPChartsRadialPlot.kt @@ -50,6 +50,7 @@ internal fun NativePHPChartsRadialPlot( } val selected = layout.data.firstOrNull { it.segment.id == selectedId } val progress = remember { Animatable(if (shouldAnimate) 0f else 1f) } + val interactionReady = progress.value >= 0.999f LaunchedEffect(configuration.animationKey, shouldAnimate) { if (shouldAnimate) { progress.snapTo(0f) @@ -119,8 +120,10 @@ internal fun NativePHPChartsRadialPlot( }, ) } - .pointerInput(layout, configuration.onSelect) { - detectTapGestures { location -> layout.segmentAt(location)?.let(::select) } + .pointerInput(layout, configuration.onSelect, interactionReady) { + detectTapGestures { location -> + if (interactionReady) layout.segmentAt(location)?.let(::select) + } }, ) { val revealAngle = 360f * progress.value diff --git a/resources/android/src/rendering/NativePHPChartsRadialRenderer.kt b/resources/android/src/rendering/NativePHPChartsRadialRenderer.kt index af96c0a..0c09629 100644 --- a/resources/android/src/rendering/NativePHPChartsRadialRenderer.kt +++ b/resources/android/src/rendering/NativePHPChartsRadialRenderer.kt @@ -1,6 +1,7 @@ package com.donmanueldev.plugins.nativephp_charts.ui import androidx.compose.foundation.layout.Box +import androidx.compose.foundation.isSystemInDarkTheme import androidx.compose.foundation.layout.Column import androidx.compose.foundation.layout.Row import androidx.compose.foundation.layout.fillMaxSize @@ -26,7 +27,17 @@ internal fun NativePHPChartsRadialRender( kind: NativePHPChartsRadialKind, ) { val wireInput = NativePHPChartsRadialWireInput.from(node) - val configuration = remember(wireInput, kind) { NativePHPChartsRadialDecoder.decode(wireInput, kind) } + val systemDark = isSystemInDarkTheme() + val decoded = rememberNativePHPChartsDecodedState(wireInput to systemDark, kind.name.lowercase()) { + NativePHPChartsRadialDecoder.decode(it.first, kind, it.second) + } + if (decoded !is NativePHPChartsAsyncState.Ready) { + if (decoded is NativePHPChartsAsyncState.Unavailable) { + NativePHPChartsUnavailable(modifier, wireInput.accessibilityLabel, wireInput.errorLabel) + } + return + } + val configuration = decoded.value val formatting = remember(configuration) { NativePHPChartsRadialFormatting(configuration) } if (!configuration.hasData) { Box( diff --git a/resources/android/src/rendering/NativePHPChartsRenderer.kt b/resources/android/src/rendering/NativePHPChartsRenderer.kt index 0361188..6c52abd 100644 --- a/resources/android/src/rendering/NativePHPChartsRenderer.kt +++ b/resources/android/src/rendering/NativePHPChartsRenderer.kt @@ -1,12 +1,14 @@ package com.donmanueldev.plugins.nativephp_charts.ui import androidx.compose.foundation.layout.Box +import androidx.compose.foundation.background import androidx.compose.foundation.layout.Column import androidx.compose.foundation.layout.Row import androidx.compose.foundation.layout.fillMaxSize import androidx.compose.foundation.layout.fillMaxWidth import androidx.compose.foundation.layout.padding import androidx.compose.material3.Text +import androidx.compose.foundation.isSystemInDarkTheme import androidx.compose.runtime.Composable import androidx.compose.runtime.remember import androidx.compose.ui.Modifier @@ -25,7 +27,18 @@ import com.nativephp.mobile.ui.nativerender.NativeUINode @Composable internal fun NativePHPChartsRender(node: NativeUINode, modifier: Modifier, kind: NativePHPChartsKind) { val wireInput = NativePHPChartsWireInput.from(node) - val configuration = remember(wireInput, kind) { NativePHPChartsDecoder.decode(wireInput, kind) } + val systemDark = isSystemInDarkTheme() + val decodeKey = wireInput to systemDark + val decoded = rememberNativePHPChartsDecodedState(decodeKey, kind.name.lowercase()) { + NativePHPChartsDecoder.decode(it.first, kind, it.second) + } + if (decoded !is NativePHPChartsAsyncState.Ready) { + if (decoded is NativePHPChartsAsyncState.Unavailable) { + NativePHPChartsUnavailable(modifier, wireInput.accessibilityLabel, wireInput.errorLabel) + } + return + } + val configuration = decoded.value val formatting = remember(configuration) { NativePHPChartsFormatting(configuration) } if (!configuration.hasData) { @@ -53,13 +66,13 @@ private fun NativePHPChartsContent( ) { val position = configuration.legend.position if (configuration.legendVisible && position in setOf("leading", "trailing")) { - Row(modifier = modifier.fillMaxSize()) { + Row(modifier = modifier.fillMaxSize().background(configuration.backgroundColor)) { if (position == "leading") NativePHPChartsLegendView(configuration, false) NativePHPChartsPlot(node, configuration, formatting, Modifier.weight(1f).fillMaxSize()) if (position == "trailing") NativePHPChartsLegendView(configuration, false) } } else { - Column(modifier = modifier.fillMaxSize()) { + Column(modifier = modifier.fillMaxSize().background(configuration.backgroundColor)) { if (configuration.legendVisible && position == "top") NativePHPChartsLegendView(configuration, true) NativePHPChartsPlot(node, configuration, formatting, Modifier.weight(1f).fillMaxWidth()) if (configuration.legendVisible && position != "top") NativePHPChartsLegendView(configuration, true) diff --git a/resources/ios/Sources/ContributionHeatmapRenderer.swift b/resources/ios/Sources/ContributionHeatmapRenderer.swift new file mode 100644 index 0000000..426c14c --- /dev/null +++ b/resources/ios/Sources/ContributionHeatmapRenderer.swift @@ -0,0 +1,339 @@ +import SwiftUI + +struct NativePHPChartsContributionValue: Decodable, Identifiable, Sendable { + let id: String + let date: String + let value: Double + let label: String? + let color: String? + let sourceIndex: Int + + private enum CodingKeys: String, CodingKey { case id, date, value, label, color } + init(from decoder: Decoder) throws { + let container = try decoder.container(keyedBy: CodingKeys.self) + id = try container.decode(String.self, forKey: .id) + date = try container.decode(String.self, forKey: .date) + value = try container.decode(Double.self, forKey: .value) + label = try container.decodeIfPresent(String.self, forKey: .label) + color = try container.decodeIfPresent(String.self, forKey: .color) + sourceIndex = decoder.codingPath.last?.intValue ?? 0 + } + + init(id: String, date: String, value: Double, label: String?, color: String? = nil, sourceIndex: Int) { + self.id = id; self.date = date; self.value = value; self.label = label; self.color = color; self.sourceIndex = sourceIndex + } +} + +struct NativePHPChartsContributionWireInput: Equatable, Sendable { + let contractVersion: Int + let valuesJSON: String + let styleJSON: String + let endDate: String + let days: Int + let weekStartsOn: Int + let colorsJSON: String + let emptyColor: String + let showMonthLabels: Bool + let showWeekdayLabels: Bool + let themeMode: String + let preset: String + let themeJSON: String + let locale: String + let minimumFractionDigits: Int + let maximumFractionDigits: Int + let errorLabel: String + let emptyLabel: String + let accessibilityLabel: String + let animated: Bool + let onSelect: Int + + init(node: NativeUINode) { + contractVersion = node.props.getInt("contract_version", default: 0) + valuesJSON = node.props.getString("values_json", default: "[]") + styleJSON = node.props.getString("style_json", default: "{}") + endDate = node.props.getString("end_date", default: "") + days = node.props.getInt("days", default: 365) + weekStartsOn = node.props.getInt("week_starts_on", default: 0) + colorsJSON = node.props.getString("colors_json", default: "[]") + emptyColor = node.props.getString("empty_color", default: "") + showMonthLabels = node.props.getBool("show_month_labels", default: true) + showWeekdayLabels = node.props.getBool("show_weekday_labels", default: true) + themeMode = node.props.getString("theme_mode", default: "system") + preset = node.props.getString("preset", default: "default") + themeJSON = node.props.getString("theme_json", default: "{}") + locale = node.props.getString("locale", default: "") + minimumFractionDigits = node.props.getInt("minimum_fraction_digits", default: -1) + maximumFractionDigits = node.props.getInt("maximum_fraction_digits", default: -1) + errorLabel = node.props.getString("error_label", default: "Chart unavailable") + emptyLabel = node.props.getString("empty_label", default: "No data") + accessibilityLabel = node.props.getString("a11y_label", default: "Contribution heatmap") + animated = node.props.getBool("animated", default: true) + onSelect = node.props.getInt("on_select", default: 0) + } + + static func testing(contractVersion: Int = 1, valuesJSON: String) -> Self { + Self(contractVersion: contractVersion, valuesJSON: valuesJSON) + } + + private init(contractVersion: Int, valuesJSON: String) { + self.contractVersion = contractVersion; self.valuesJSON = valuesJSON + styleJSON = "{}"; endDate = "2026-12-31"; days = 365; weekStartsOn = 0; colorsJSON = "[]"; emptyColor = "" + showMonthLabels = true; showWeekdayLabels = true; themeMode = "system"; preset = "default"; themeJSON = "{}"; locale = ""; minimumFractionDigits = -1; maximumFractionDigits = -1 + errorLabel = "Chart unavailable"; emptyLabel = "No data"; accessibilityLabel = "Contribution heatmap" + animated = true; onSelect = 0 + } +} + +struct NativePHPChartsContributionSnapshot: @unchecked Sendable { + let availability: NativePHPChartsAvailability + let values: [NativePHPChartsContributionValue] + let valuesByDate: [String: NativePHPChartsContributionValue] + let input: NativePHPChartsContributionWireInput + let colors: [String] + let theme: NativePHPChartsTheme? + let endDate: Date? + let animationID: Int + let style: NativePHPChartsContributionStyle + + init(input: NativePHPChartsContributionWireInput) { + self.input = input + theme = NativePHPChartsTheme.decode(input.themeJSON) + style = NativePHPChartsContributionStyle.decode(input.styleJSON) + colors = input.colorsJSON.data(using: .utf8).flatMap { try? JSONDecoder().decode([String].self, from: $0) } ?? [] + let decoded = input.valuesJSON.data(using: .utf8).flatMap { try? JSONDecoder().decode([NativePHPChartsContributionValue].self, from: $0) } + let parsedEnd = input.endDate.isEmpty ? Self.todayUTC() : Self.parseDate(input.endDate) + endDate = parsedEnd + if input.contractVersion != NativePHPChartsRuntime.supportedContractVersion { + availability = .unsupportedContract; values = [] + } else if let decoded, parsedEnd != nil, (7...371).contains(input.days), (0...6).contains(input.weekStartsOn), Self.validate(decoded) { + availability = .available; values = decoded + } else { + availability = .invalidPayload; values = [] + } + valuesByDate = Dictionary(uniqueKeysWithValues: values.map { ($0.date, $0) }) + var hasher = Hasher() + values.forEach { hasher.combine($0.id); hasher.combine($0.date); hasher.combine($0.value); hasher.combine($0.color) } + animationID = hasher.finalize() + NativePHPChartsRuntime.diagnose(availability, chartType: "contribution_heatmap") + } + + @concurrent static func load(input: NativePHPChartsContributionWireInput) async -> Self { Self(input: input) } + + static func parseDate(_ value: String) -> Date? { + guard value.range(of: #"^\d{4}-\d{2}-\d{2}$"#, options: .regularExpression) != nil else { return nil } + var calendar = Calendar(identifier: .gregorian); calendar.timeZone = TimeZone(secondsFromGMT: 0)! + let parts = value.split(separator: "-").compactMap { Int($0) } + guard parts.count == 3 else { return nil } + guard let date = calendar.date(from: DateComponents(year: parts[0], month: parts[1], day: parts[2])), + dateString(date) == value + else { return nil } + return date + } + + static func dateString(_ date: Date) -> String { + var calendar = Calendar(identifier: .gregorian); calendar.timeZone = TimeZone(secondsFromGMT: 0)! + let components = calendar.dateComponents([.year, .month, .day], from: date) + return String(format: "%04d-%02d-%02d", components.year ?? 0, components.month ?? 0, components.day ?? 0) + } + + private static func todayUTC() -> Date { + var calendar = Calendar(identifier: .gregorian); calendar.timeZone = TimeZone(secondsFromGMT: 0)! + return calendar.startOfDay(for: Date()) + } + + private static func validate(_ values: [NativePHPChartsContributionValue]) -> Bool { + Set(values.map(\.id)).count == values.count && Set(values.map(\.date)).count == values.count && values.allSatisfy { + $0.id.isEmpty == false && $0.value.isFinite && $0.value >= 0 && parseDate($0.date) != nil + } + } +} + +struct NativePHPChartsContributionStyle: Decodable { + struct Cell: Decodable { + let size: CGFloat? + let gap: CGFloat? + let cornerRadius: CGFloat? + enum CodingKeys: String, CodingKey { case size, gap; case cornerRadius = "corner_radius" } + } + let cell: Cell? + let axis: NativePHPChartsStyle.Axis? + + static func decode(_ json: String) -> Self { + guard let data = json.data(using: .utf8), let value = try? JSONDecoder().decode(Self.self, from: data) else { + return Self(cell: nil, axis: nil) + } + return value + } +} + +enum NativePHPChartsContributionSelection { + static func payload(value: NativePHPChartsContributionValue, localizedValue: String? = nil) -> NativePHPChartsSelectionPayload { + let label = value.label ?? value.date + return NativePHPChartsSelectionPayload( + chartType: "contribution_heatmap", + seriesID: value.id, + seriesName: label, + pointID: value.id, + pointIndex: value.sourceIndex, + xType: "date", + x: .string(value.date), + label: label, + value: value.value, + localizedValue: localizedValue ?? value.value.formatted() + ) + } +} + +struct NativePHPChartsContributionHeatmapRenderer: View { + let node: NativeUINode + @State private var snapshot: NativePHPChartsContributionSnapshot + @State private var selectedID: String? + @State private var revealProgress = 0.0 + @Environment(\.accessibilityReduceMotion) private var reduceMotion + @Environment(\.colorScheme) private var colorScheme + + init(node: NativeUINode) { + self.node = node + _snapshot = State(initialValue: .init(input: .testing(valuesJSON: "[]"))) + } + private var wireInput: NativePHPChartsContributionWireInput { .init(node: node) } + + var body: some View { + Group { + if snapshot.availability != .available { unavailableState } + else if hasVisibleValues == false { emptyState } + else { content } + } + .task(id: wireInput) { + let updated = await NativePHPChartsContributionSnapshot.load(input: wireInput) + guard Task.isCancelled == false else { return } + snapshot = updated + selectedID = updated.values.contains { $0.id == selectedID } ? selectedID : nil + } + } + + private var content: some View { + GeometryReader { geometry in + let layout = cells(in: geometry.size) + Canvas { context, _ in + for cell in layout { + let fill = color(for: cell.value) + let radius = min(snapshot.style.cell?.cornerRadius ?? 3, cell.frame.width / 2) + context.fill(Path(roundedRect: cell.frame, cornerRadius: radius), with: .color(fill.opacity(cell.dayOffsetFraction <= revealProgress ? 1 : 0.12))) + if cell.value?.id == selectedID { context.stroke(Path(roundedRect: cell.frame.insetBy(dx: -1, dy: -1), cornerRadius: radius), with: .color(.primary), lineWidth: 2) } + if snapshot.input.showMonthLabels, cell.isFirstOfMonth { + context.draw(Text(cell.monthLabel).font(.caption2).foregroundStyle(axisLabelColor), at: CGPoint(x: cell.frame.minX, y: 6), anchor: .leading) + } + if snapshot.input.showWeekdayLabels, cell.column == 0, [1, 3, 5].contains(cell.row) { + context.draw(Text(cell.weekdayLabel).font(.caption2).foregroundStyle(axisLabelColor), at: CGPoint(x: 0, y: cell.frame.midY), anchor: .leading) + } + } + } + .contentShape(Rectangle()) + .gesture(SpatialTapGesture().onEnded { tap in + select(layout.first { $0.frame.insetBy(dx: -3, dy: -3).contains(tap.location) }?.value) + }) + } + .frame(minHeight: 150) + .animation(NativePHPChartsAnimation.resolved(enabled: snapshot.input.animated, reduceMotion: reduceMotion), value: revealProgress) + .task(id: snapshot.animationID) { + revealProgress = reduceMotion || snapshot.input.animated == false ? 1 : 0 + guard revealProgress == 0 else { return } + await Task.yield() + withAnimation { revealProgress = 1 } + } + .accessibilityRepresentation { + NativePHPChartsAccessibilityRepresentation(label: snapshot.input.accessibilityLabel, value: accessibilitySummary, actions: accessibilityActions, onSelect: select) + } + } + + private var hasVisibleValues: Bool { + guard let end = snapshot.endDate else { return false } + var calendar = Calendar(identifier: .gregorian); calendar.timeZone = TimeZone(secondsFromGMT: 0)! + guard let start = calendar.date(byAdding: .day, value: -(snapshot.input.days - 1), to: end) else { return false } + return snapshot.values.contains { value in + NativePHPChartsContributionSnapshot.parseDate(value.date).map { $0 >= start && $0 <= end } ?? false + } + } + + private struct Cell { + let frame: CGRect + let value: NativePHPChartsContributionValue? + let dayOffsetFraction: Double + let column: Int + let row: Int + let isFirstOfMonth: Bool + let monthLabel: String + let weekdayLabel: String + } + + private func cells(in size: CGSize) -> [Cell] { + guard let end = snapshot.endDate else { return [] } + var calendar = Calendar(identifier: .gregorian); calendar.timeZone = TimeZone(secondsFromGMT: 0)! + let start = calendar.date(byAdding: .day, value: -(snapshot.input.days - 1), to: end)! + let weekday = calendar.component(.weekday, from: start) - 1 + let leading = (weekday - snapshot.input.weekStartsOn + 7) % 7 + let columns = Int(ceil(Double(leading + snapshot.input.days) / 7.0)) + let labelWidth: CGFloat = snapshot.input.showWeekdayLabels ? 28 : 0 + let labelHeight: CGFloat = snapshot.input.showMonthLabels ? 18 : 0 + let gap: CGFloat = snapshot.style.cell?.gap ?? 3 + let available = max(4, min((size.width - labelWidth - CGFloat(max(columns - 1, 0)) * gap) / CGFloat(max(columns, 1)), (size.height - labelHeight - 6 * gap) / 7)) + let cell = min(snapshot.style.cell?.size ?? available, available) + return (0.. Color { + guard let value else { return parsed(snapshot.input.emptyColor.isEmpty ? variant?.track : snapshot.input.emptyColor, fallback: .secondary.opacity(0.15)) } + if let explicit = value.color { return parsed(explicit, fallback: .green) } + let palette = snapshot.colors.isEmpty ? (variant?.palette ?? []) : snapshot.colors + let resolved = palette.isEmpty ? ["#DCFCE7", "#86EFAC", "#22C55E", "#15803D"] : palette + let maxValue = snapshot.values.map(\.value).max() ?? 0 + let index = maxValue > 0 ? min(Int((value.value / maxValue) * Double(resolved.count - 1)), resolved.count - 1) : 0 + return parsed(resolved[index], fallback: .green) + } + private func parsed(_ value: String?, fallback: Color) -> Color { value.map { Color(argb: ColorParser.parse($0, default: 0xFF22C55E)) } ?? fallback } + + private func select(_ value: NativePHPChartsContributionValue?) { + guard selectedID != value?.id else { return } + selectedID = value?.id + guard let value, snapshot.input.onSelect > 0, + let json = NativePHPChartsContributionSelection.payload(value: value, localizedValue: formatted(value.value)).json() + else { return } + NativeElementBridge.sendTextChangeEvent(snapshot.input.onSelect, nodeId: node.id, text: json) + } + + private var formatter: NumberFormatter { + let formatter = NumberFormatter(); formatter.numberStyle = .decimal + formatter.locale = snapshot.input.locale.isEmpty ? .current : Locale(identifier: snapshot.input.locale) + if snapshot.input.minimumFractionDigits >= 0 { formatter.minimumFractionDigits = snapshot.input.minimumFractionDigits } + if snapshot.input.maximumFractionDigits >= 0 { formatter.maximumFractionDigits = snapshot.input.maximumFractionDigits } + return formatter + } + private func formatted(_ value: Double) -> String { formatter.string(from: NSNumber(value: value)) ?? value.formatted() } + private var accessibilitySummary: String { snapshot.values.prefix(31).map { "\($0.label ?? $0.date): \(formatted($0.value))" }.joined(separator: ". ") } + private var accessibilityActions: [NativePHPChartsAccessibilityAction] { + let index = snapshot.values.firstIndex { $0.id == selectedID } + let previous = index.flatMap { $0 > 0 ? snapshot.values[$0 - 1] : nil } + let next = index.map { $0 + 1 }.flatMap { $0 < snapshot.values.count ? snapshot.values[$0] : nil } ?? (index == nil ? snapshot.values.first : nil) + return [(previous, NativePHPChartsAccessibilityAction.Direction.previous), (next, .next)].compactMap { value, direction in + value.map { .init(dataID: snapshot.animationID, direction: direction, targetID: $0.id, label: "\($0.label ?? $0.date), \(formatted($0.value))", target: $0) } + } + } + + private var emptyState: some View { ContentUnavailableView(snapshot.input.emptyLabel, systemImage: "square.grid.3x3") } + private var unavailableState: some View { ContentUnavailableView(snapshot.input.errorLabel, systemImage: "exclamationmark.triangle") } +} + +// Keep compatibility with either renderer naming convention while the manifest remains source compatible. +typealias NativePHPChartsContributionHeatmapChartRenderer = NativePHPChartsContributionHeatmapRenderer diff --git a/resources/ios/Sources/Core/NativePHPChartsConfiguration.swift b/resources/ios/Sources/Core/NativePHPChartsConfiguration.swift index ab571a6..8a27654 100644 --- a/resources/ios/Sources/Core/NativePHPChartsConfiguration.swift +++ b/resources/ios/Sources/Core/NativePHPChartsConfiguration.swift @@ -6,11 +6,11 @@ import Foundation /// supplies defaults because a partially upgraded generated shell can omit newer /// properties. Large Cartesian series may arrive by `file-v1`; a missing or unreadable /// file deliberately resolves to an empty series instead of rendering stale data. -struct NativePHPChartsWireInput: Equatable { - nonisolated(unsafe) private static let seriesFileCache = NSCache() - +struct NativePHPChartsWireInput: Equatable, Sendable { let contractVersion: Int let seriesJSON: String + let seriesTransport: String + let seriesJSONFile: String? let styleJSON: String let xAxisJSON: String let yAxisJSON: String @@ -29,7 +29,11 @@ struct NativePHPChartsWireInput: Equatable { let beginAtZero: Bool let animated: Bool let emptyLabel: String + let errorLabel: String let accessibilityLabel: String + let themeMode: String + let preset: String + let themeJSON: String let onSelect: Int let onViewportChange: Int let areaMode: String @@ -38,7 +42,10 @@ struct NativePHPChartsWireInput: Equatable { init(node: NativeUINode) { contractVersion = node.props.getInt("contract_version", default: 0) - seriesJSON = Self.resolveSeriesJSON(node: node) + seriesJSON = node.props.getString("series_json", default: "[]") + seriesTransport = node.props.getString("series_transport", default: "inline-v1") + let file = node.props.getString("series_json_file", default: "") + seriesJSONFile = file.isEmpty ? nil : file styleJSON = node.props.getString("style_json", default: "{}") xAxisJSON = node.props.getString("x_axis_json", default: "{}") yAxisJSON = node.props.getString("y_axis_json", default: "{}") @@ -57,7 +64,11 @@ struct NativePHPChartsWireInput: Equatable { beginAtZero = node.props.getBool("begin_at_zero", default: true) animated = node.props.getBool("animated", default: true) emptyLabel = node.props.getString("empty_label", default: "No data") + errorLabel = node.props.getString("error_label", default: "Chart unavailable") accessibilityLabel = node.props.getString("a11y_label", default: "Chart") + themeMode = node.props.getString("theme_mode", default: "system") + preset = node.props.getString("preset", default: "default") + themeJSON = node.props.getString("theme_json", default: "{}") onSelect = node.props.getInt("on_select", default: 0) onViewportChange = node.props.getInt("on_viewport_change", default: 0) areaMode = node.props.getString("area_mode", default: "overlay") @@ -65,29 +76,31 @@ struct NativePHPChartsWireInput: Equatable { barOrientation = node.props.getString("bar_orientation", default: "vertical") } - /// Resolves the mutually exclusive inline and file-backed series transports. - /// - /// File contents are immutable and content-addressed on the PHP side, so caching by - /// path is safe for the lifetime of the renderer process. - private static func resolveSeriesJSON(node: NativeUINode) -> String { - let inline = node.props.getString("series_json", default: "[]") - let transport = node.props.getString("series_transport", default: "inline-v1") - let path = node.props.getString("series_json_file", default: "") - guard transport == "file-v1", !path.isEmpty else { return inline } - - if let cached = seriesFileCache.object(forKey: path as NSString) { - return cached as String - } - - guard let data = FileManager.default.contents(atPath: path), - let value = String(data: data, encoding: .utf8) - else { - return "[]" - } + static func testing(contractVersion: Int = 1, seriesJSON: String) -> Self { + Self( + contractVersion: contractVersion, + seriesJSON: seriesJSON, + seriesTransport: "inline-v1", + seriesJSONFile: nil + ) + } - seriesFileCache.setObject(value as NSString, forKey: path as NSString) - return value + private init(contractVersion: Int, seriesJSON: String, seriesTransport: String, seriesJSONFile: String?) { + self.contractVersion = contractVersion + self.seriesJSON = seriesJSON + self.seriesTransport = seriesTransport + self.seriesJSONFile = seriesJSONFile + styleJSON = "{}"; xAxisJSON = "{}"; yAxisJSON = "{}"; legendJSON = "{}" + annotationsJSON = "[]"; interactionJSON = "{}"; viewportJSON = "{}"; samplingJSON = "{}" + locale = ""; valueFormat = "number"; currencyCode = "" + minimumFractionDigits = -1; maximumFractionDigits = -1 + showGrid = true; showPoints = true; beginAtZero = true; animated = true + emptyLabel = "No data"; errorLabel = "Chart unavailable"; accessibilityLabel = "Chart" + themeMode = "system"; preset = "default"; themeJSON = "{}" + onSelect = 0; onViewportChange = 0 + areaMode = "overlay"; barMode = "grouped"; barOrientation = "vertical" } + } /// Decodes either axis contract into the scalar plot coordinate used by Swift Charts. @@ -401,13 +414,15 @@ struct NativePHPChartsConfiguration { let areaMode: NativePHPChartsAreaMode let barMode: NativePHPChartsBarMode let barOrientation: NativePHPChartsBarOrientation + let theme: NativePHPChartsTheme.Variant? + let palette: [String] /// Merges the versioned structured contract with legacy scalar properties. /// /// Malformed optional JSON falls back section-by-section. This is a compatibility /// boundary, not the primary validator: invalid application input should already have /// been rejected by the PHP normalizers before it reaches the native tree. - static func decode(_ input: NativePHPChartsWireInput, kind: NativePHPChartsKind) -> NativePHPChartsConfiguration { + static func decode(_ input: NativePHPChartsWireInput, kind: NativePHPChartsKind, colorSchemeIsDark: Bool = false) -> NativePHPChartsConfiguration { let legacyYFormat = NativePHPChartsNumberFormat( style: input.valueFormat, currencyCode: input.currencyCode.isEmpty ? nil : input.currencyCode, @@ -423,6 +438,8 @@ struct NativePHPChartsConfiguration { fallback: NativePHPChartsAxisConfiguration(format: legacyYFormat, beginAtZero: input.beginAtZero) ) + let theme = NativePHPChartsTheme.decode(input.themeJSON)?.variant(mode: input.themeMode, colorSchemeIsDark: colorSchemeIsDark) + let palette = theme?.palette.isEmpty == false ? (theme?.palette ?? []) : NativePHPChartsRuntime.palette(preset: input.preset) return NativePHPChartsConfiguration( xAxis: xAxis, yAxis: yAxis, @@ -441,7 +458,9 @@ struct NativePHPChartsConfiguration { onViewportChange: input.onViewportChange, areaMode: NativePHPChartsAreaMode(rawValue: input.areaMode) ?? .overlay, barMode: NativePHPChartsBarMode(rawValue: input.barMode) ?? .grouped, - barOrientation: NativePHPChartsBarOrientation(rawValue: input.barOrientation) ?? .vertical + barOrientation: NativePHPChartsBarOrientation(rawValue: input.barOrientation) ?? .vertical, + theme: theme, + palette: palette ) } } @@ -452,20 +471,43 @@ struct NativePHPChartsConfiguration { /// on the resolved axis. Domain calculation then consumes those exact instances, keeping /// marks, axes, hit testing, and callback serialization in the same coordinate system. struct NativePHPChartsSnapshot { + let availability: NativePHPChartsAvailability let configuration: NativePHPChartsConfiguration let formatter: NativePHPChartsFormatter let data: NativePHPChartsDataSet let domain: NativePHPChartsDomain - init(input: NativePHPChartsWireInput, kind: NativePHPChartsKind) { - let configuration = NativePHPChartsConfiguration.decode(input, kind: kind) + init( + input: NativePHPChartsWireInput, + kind: NativePHPChartsKind, + resolvedSeriesJSON: String? = nil, + decodedSeries: [NativePHPChartsWireSeries]? = nil, + colorSchemeIsDark: Bool = false + ) { + let configuration = NativePHPChartsConfiguration.decode(input, kind: kind, colorSchemeIsDark: colorSchemeIsDark) let formatter = NativePHPChartsFormatter(input: input, configuration: configuration) - let data = NativePHPChartsDataSet.decode( - seriesJSON: input.seriesJSON, - xAxis: configuration.xAxis, - formatter: formatter - ) + let json = resolvedSeriesJSON ?? input.seriesJSON + let payloadValid = decodedSeries.map { + NativePHPChartsDataSet.validate(series: $0, xAxis: configuration.xAxis, formatter: formatter, kind: kind) + } ?? NativePHPChartsDataSet.validate(seriesJSON: json, xAxis: configuration.xAxis, formatter: formatter, kind: kind) + let availability: NativePHPChartsAvailability + if input.contractVersion != NativePHPChartsRuntime.supportedContractVersion { + availability = .unsupportedContract + } else if payloadValid == false { + availability = .invalidPayload + } else { + availability = .available + } + let data: NativePHPChartsDataSet + if availability != .available { + data = NativePHPChartsDataSet(series: [], xType: configuration.xAxis.type, categoryLabels: [:]) + } else if let decodedSeries { + data = NativePHPChartsDataSet.decode(series: decodedSeries, xAxis: configuration.xAxis, formatter: formatter, palette: configuration.palette) + } else { + data = NativePHPChartsDataSet.decode(seriesJSON: json, xAxis: configuration.xAxis, formatter: formatter, palette: configuration.palette) + } + self.availability = availability self.configuration = configuration self.formatter = formatter self.data = data @@ -475,5 +517,22 @@ struct NativePHPChartsSnapshot { formatter: formatter, kind: kind ) + NativePHPChartsRuntime.diagnose(availability, chartType: kind.rawValue) + } + + @concurrent + static func load(input: NativePHPChartsWireInput, kind: NativePHPChartsKind, colorSchemeIsDark: Bool = false) async -> NativePHPChartsSnapshot? { + do { + let json = try await NativePHPChartsPayloadLoader.seriesJSON(for: input) + try Task.checkCancellation() + let decoded = await NativePHPChartsDecodedSeriesCache.shared.series(for: json) + try Task.checkCancellation() + return NativePHPChartsSnapshot(input: input, kind: kind, resolvedSeriesJSON: json, decodedSeries: decoded, colorSchemeIsDark: colorSchemeIsDark) + } catch is CancellationError { + return nil + } catch { + NativePHPChartsRuntime.diagnose(.unavailable, chartType: kind.rawValue) + return NativePHPChartsSnapshot(input: input, kind: kind, resolvedSeriesJSON: "{", colorSchemeIsDark: colorSchemeIsDark) + } } } diff --git a/resources/ios/Sources/Core/NativePHPChartsModels.swift b/resources/ios/Sources/Core/NativePHPChartsModels.swift index 3b69ac8..6968a27 100644 --- a/resources/ios/Sources/Core/NativePHPChartsModels.swift +++ b/resources/ios/Sources/Core/NativePHPChartsModels.swift @@ -20,7 +20,7 @@ enum NativePHPChartsXAxisType: String, Codable { /// /// Keeping numbers and strings distinct preserves category/date identities while allowing /// numeric-looking strings to participate in numeric compatibility fallbacks. -enum NativePHPChartsWireValue: Hashable, Codable { +enum NativePHPChartsWireValue: Hashable, Codable, Sendable { case string(String) case number(Double) @@ -60,7 +60,7 @@ enum NativePHPChartsWireValue: Hashable, Codable { } } -struct NativePHPChartsWirePoint: Decodable { +struct NativePHPChartsWirePoint: Decodable, Sendable { let id: String? let label: String let value: Double @@ -81,10 +81,10 @@ struct NativePHPChartsWirePoint: Decodable { } } -struct NativePHPChartsWireSeries: Decodable { +struct NativePHPChartsWireSeries: Decodable, Sendable { let id: String let name: String - let color: String + let color: String? let points: [NativePHPChartsWirePoint] let style: NativePHPChartsStyle? let fillTo: String? @@ -372,14 +372,25 @@ struct NativePHPChartsDataSet { static func decode( seriesJSON: String, xAxis: NativePHPChartsAxisConfiguration, - formatter: NativePHPChartsFormatter + formatter: NativePHPChartsFormatter, + palette: [String] = NativePHPChartsRuntime.palette(preset: "default") ) -> NativePHPChartsDataSet { - guard let data = seriesJSON.data(using: .utf8), - let decoded = try? JSONDecoder().decode([NativePHPChartsWireSeries].self, from: data) + guard let decoded = decodeWireSeries(seriesJSON) else { return NativePHPChartsDataSet(series: [], xType: xAxis.type, categoryLabels: [:]) } + return decode(series: decoded, xAxis: xAxis, formatter: formatter, palette: palette) + } + + static func decode( + series decoded: [NativePHPChartsWireSeries], + xAxis: NativePHPChartsAxisConfiguration, + formatter: NativePHPChartsFormatter, + palette: [String] + ) -> NativePHPChartsDataSet { + + let effectivePalette = palette.isEmpty ? NativePHPChartsRuntime.palette(preset: "default") : palette var categoryIndexes: [String: Int] = [:] var categoryLabels: [Int: String] = [:] @@ -432,7 +443,7 @@ struct NativePHPChartsDataSet { return NativePHPChartsSeries( id: wireSeries.id, name: wireSeries.name, - colorValue: wireSeries.color, + colorValue: wireSeries.color ?? effectivePalette[seriesIndex % effectivePalette.count], points: points, index: seriesIndex, style: wireSeries.style, @@ -442,4 +453,58 @@ struct NativePHPChartsDataSet { return NativePHPChartsDataSet(series: series, xType: xAxis.type, categoryLabels: categoryLabels) } + + static func validate( + seriesJSON: String, + xAxis: NativePHPChartsAxisConfiguration, + formatter: NativePHPChartsFormatter, + kind: NativePHPChartsKind + ) -> Bool { + guard let decoded = decodeWireSeries(seriesJSON) else { return false } + return validate(series: decoded, xAxis: xAxis, formatter: formatter, kind: kind) + } + + static func validate( + series decoded: [NativePHPChartsWireSeries], + xAxis: NativePHPChartsAxisConfiguration, + formatter: NativePHPChartsFormatter, + kind: NativePHPChartsKind + ) -> Bool { + + var seriesIDs: Set = [] + var selectionIDs: Set = [] + for series in decoded { + guard series.id.isEmpty == false, seriesIDs.insert(series.id).inserted else { return false } + for (index, point) in series.points.enumerated() { + let pointID = (point.id?.isEmpty == false ? point.id : nil) ?? "compat-\(series.id)-\(index)" + let selectionID = "\(series.id.utf8.count):\(series.id)\(pointID)" + guard selectionIDs.insert(selectionID).inserted, + point.value.isFinite, + [point.errorMin, point.errorMax, point.open, point.high, point.low, point.close] + .compactMap({ $0 }).allSatisfy(\.isFinite) + else { return false } + + switch xAxis.type { + case .category: + break + case .number: + guard point.x?.numberValue?.isFinite == true else { return false } + case .date, .datetime: + guard point.x.flatMap({ formatter.date(from: $0, type: xAxis.type) }) != nil else { return false } + } + + if kind == .candlestick { + guard let open = point.open, let high = point.high, let low = point.low, let close = point.close, + low <= min(open, close), high >= max(open, close), low <= high + else { return false } + } + } + } + return true + } + + static func decodeWireSeries(_ json: String) -> [NativePHPChartsWireSeries]? { + guard let data = json.data(using: .utf8) else { return nil } + return try? JSONDecoder().decode([NativePHPChartsWireSeries].self, from: data) + } } diff --git a/resources/ios/Sources/Core/NativePHPChartsRadialConfiguration.swift b/resources/ios/Sources/Core/NativePHPChartsRadialConfiguration.swift index 766175d..860bfac 100644 --- a/resources/ios/Sources/Core/NativePHPChartsRadialConfiguration.swift +++ b/resources/ios/Sources/Core/NativePHPChartsRadialConfiguration.swift @@ -10,7 +10,7 @@ enum NativePHPChartsRadialKind: String { /// Missing fields retain cross-version defaults. PHP is the authoritative validator, while /// the native configuration still clamps visual ratios so a stale shell cannot create /// degenerate geometry. -struct NativePHPChartsRadialWireInput: Equatable { +struct NativePHPChartsRadialWireInput: Equatable, Sendable { let contractVersion: Int let segmentsJSON: String let styleJSON: String @@ -22,12 +22,16 @@ struct NativePHPChartsRadialWireInput: Equatable { let maximumFractionDigits: Int let animated: Bool let emptyLabel: String + let errorLabel: String let accessibilityLabel: String + let themeMode: String + let preset: String + let themeJSON: String let onSelect: Int let innerRadiusRatio: Double init(node: NativeUINode, kind: NativePHPChartsRadialKind) { - contractVersion = node.props.getInt("contract_version", default: 1) + contractVersion = node.props.getInt("contract_version", default: 0) segmentsJSON = node.props.getString("segments_json", default: "[]") styleJSON = node.props.getString("style_json", default: "{}") legendJSON = node.props.getString("legend_json", default: "{}") @@ -38,12 +42,29 @@ struct NativePHPChartsRadialWireInput: Equatable { maximumFractionDigits = node.props.getInt("maximum_fraction_digits", default: -1) animated = node.props.getBool("animated", default: true) emptyLabel = node.props.getString("empty_label", default: "No data") + errorLabel = node.props.getString("error_label", default: "Chart unavailable") accessibilityLabel = node.props.getString("a11y_label", default: "Chart") + themeMode = node.props.getString("theme_mode", default: "system") + preset = node.props.getString("preset", default: "default") + themeJSON = node.props.getString("theme_json", default: "{}") onSelect = node.props.getInt("on_select", default: 0) let defaultRatio: Float = kind == .donut ? 0.6 : 0 innerRadiusRatio = Double(node.props.getFloat("inner_radius_ratio", default: defaultRatio)) } + + static func testing(contractVersion: Int = 1, segmentsJSON: String) -> Self { + Self(contractVersion: contractVersion, segmentsJSON: segmentsJSON) + } + + private init(contractVersion: Int, segmentsJSON: String) { + self.contractVersion = contractVersion; self.segmentsJSON = segmentsJSON + styleJSON = "{}"; legendJSON = "{}"; locale = ""; valueFormat = "number"; currencyCode = "" + minimumFractionDigits = -1; maximumFractionDigits = -1; animated = true + emptyLabel = "No data"; errorLabel = "Chart unavailable"; accessibilityLabel = "Chart" + themeMode = "system"; preset = "default"; themeJSON = "{}" + onSelect = 0; innerRadiusRatio = 0 + } } struct NativePHPChartsRadialStyle: Decodable { @@ -111,14 +132,18 @@ struct NativePHPChartsRadialConfiguration { let accessibilityLabel: String let onSelect: Int let innerRadiusRatio: Double + let theme: NativePHPChartsTheme.Variant? + let palette: [String] - init(input: NativePHPChartsRadialWireInput, kind: NativePHPChartsRadialKind) { + init(input: NativePHPChartsRadialWireInput, kind: NativePHPChartsRadialKind, colorSchemeIsDark: Bool = false) { legend = NativePHPChartsLegendConfiguration.decode(input.legendJSON) style = NativePHPChartsRadialStyle.decode(input.styleJSON) animated = input.animated emptyLabel = input.emptyLabel accessibilityLabel = input.accessibilityLabel onSelect = input.onSelect + theme = NativePHPChartsTheme.decode(input.themeJSON)?.variant(mode: input.themeMode, colorSchemeIsDark: colorSchemeIsDark) + palette = theme?.palette.isEmpty == false ? (theme?.palette ?? []) : NativePHPChartsRuntime.palette(preset: input.preset) switch kind { case .pie: @@ -131,13 +156,28 @@ struct NativePHPChartsRadialConfiguration { /// Immutable radial configuration, formatter, and cumulative angular data for one node revision. struct NativePHPChartsRadialSnapshot { + let availability: NativePHPChartsAvailability let configuration: NativePHPChartsRadialConfiguration let formatter: NativePHPChartsRadialFormatter let data: NativePHPChartsRadialDataSet - init(input: NativePHPChartsRadialWireInput, kind: NativePHPChartsRadialKind) { - configuration = NativePHPChartsRadialConfiguration(input: input, kind: kind) + init(input: NativePHPChartsRadialWireInput, kind: NativePHPChartsRadialKind, colorSchemeIsDark: Bool = false) { + configuration = NativePHPChartsRadialConfiguration(input: input, kind: kind, colorSchemeIsDark: colorSchemeIsDark) formatter = NativePHPChartsRadialFormatter(input: input) - data = NativePHPChartsRadialDataSet.decode(input.segmentsJSON) + if input.contractVersion != NativePHPChartsRuntime.supportedContractVersion { + availability = .unsupportedContract + data = NativePHPChartsRadialDataSet(segments: [], total: 0) + } else if NativePHPChartsRadialDataSet.validate(input.segmentsJSON) == false { + availability = .invalidPayload + data = NativePHPChartsRadialDataSet(segments: [], total: 0) + } else { + availability = .available + data = NativePHPChartsRadialDataSet.decode(input.segmentsJSON, palette: configuration.palette) + } + NativePHPChartsRuntime.diagnose(availability, chartType: kind.rawValue) + } + + @concurrent static func load(input: NativePHPChartsRadialWireInput, kind: NativePHPChartsRadialKind, colorSchemeIsDark: Bool = false) async -> Self { + Self(input: input, kind: kind, colorSchemeIsDark: colorSchemeIsDark) } } diff --git a/resources/ios/Sources/Core/NativePHPChartsRadialModels.swift b/resources/ios/Sources/Core/NativePHPChartsRadialModels.swift index c8bc93b..0b835cd 100644 --- a/resources/ios/Sources/Core/NativePHPChartsRadialModels.swift +++ b/resources/ios/Sources/Core/NativePHPChartsRadialModels.swift @@ -5,7 +5,7 @@ private struct NativePHPChartsWireSegment: Decodable { let id: String let label: String let value: Double - let color: String + let color: String? } /// A radial segment in the cumulative value domain `[0, total]`. @@ -87,13 +87,14 @@ struct NativePHPChartsRadialDataSet { /// /// Duplicate ids, non-finite values, negative values, and overflowing totals are ignored /// defensively. PHP rejects those cases before transport; malformed JSON becomes empty state. - static func decode(_ json: String) -> NativePHPChartsRadialDataSet { + static func decode(_ json: String, palette: [String] = NativePHPChartsRuntime.palette(preset: "default")) -> NativePHPChartsRadialDataSet { guard let data = json.data(using: .utf8), let decoded = try? JSONDecoder().decode([NativePHPChartsWireSegment].self, from: data) else { return NativePHPChartsRadialDataSet(segments: [], total: 0) } + let effectivePalette = palette.isEmpty ? NativePHPChartsRuntime.palette(preset: "default") : palette var seenIDs: Set = [] var cumulative = 0.0 var segments: [NativePHPChartsRadialSegment] = [] @@ -118,7 +119,7 @@ struct NativePHPChartsRadialDataSet { id: wire.id, label: wire.label, value: wire.value, - colorValue: wire.color, + colorValue: wire.color ?? effectivePalette[index % effectivePalette.count], index: index, lowerBound: lowerBound, upperBound: cumulative @@ -128,4 +129,22 @@ struct NativePHPChartsRadialDataSet { return NativePHPChartsRadialDataSet(segments: segments, total: cumulative) } + + static func validate(_ json: String) -> Bool { + guard let data = json.data(using: .utf8), + let decoded = try? JSONDecoder().decode([NativePHPChartsWireSegment].self, from: data) + else { return false } + var ids: Set = [] + var total = 0.0 + for segment in decoded { + guard segment.id.isEmpty == false, + ids.insert(segment.id).inserted, + segment.value.isFinite, + segment.value >= 0 + else { return false } + total += segment.value + guard total.isFinite else { return false } + } + return true + } } diff --git a/resources/ios/Sources/Core/NativePHPChartsRuntime.swift b/resources/ios/Sources/Core/NativePHPChartsRuntime.swift new file mode 100644 index 0000000..1b501b9 --- /dev/null +++ b/resources/ios/Sources/Core/NativePHPChartsRuntime.swift @@ -0,0 +1,162 @@ +import Foundation +import CryptoKit +import OSLog + +enum NativePHPChartsAvailability: Equatable, Sendable { + case available + case unsupportedContract + case invalidPayload + case unavailable +} + +enum NativePHPChartsRuntime { + static let supportedContractVersion = 1 + private static let logger = Logger(subsystem: "dev.donmanuel.nativephp-charts", category: "runtime") + + static func diagnose(_ availability: NativePHPChartsAvailability, chartType: String) { + guard availability != .available else { return } + logger.error("chart unavailable type=\(chartType, privacy: .public) reason=\(String(describing: availability), privacy: .public)") + } + + static func palette(preset: String) -> [String] { + switch preset { + case "spectrum": ["#6366F1", "#06B6D4", "#22C55E", "#F59E0B", "#EF4444", "#A855F7"] + case "contrast": ["#0057B8", "#D1495B", "#00876C", "#7A5195", "#A15C00"] + default: ["#6366F1", "#06B6D4", "#22C55E", "#F59E0B", "#EF4444"] + } + } +} + +/// Bounded cache for immutable, content-addressed file payloads. +/// +/// Entries are capped both by count and UTF-8 cost. No chart contents, paths, labels, or values +/// are logged. The actor owns all mutation and returns immutable strings across the boundary. +actor NativePHPChartsPayloadCache { + static let shared = NativePHPChartsPayloadCache() + + private let maximumEntries = 64 + private let maximumCost = 8 * 1_024 * 1_024 + private var values: [String: String] = [:] + private var costs: [String: Int] = [:] + private var order: [String] = [] + private var totalCost = 0 + + func value(for path: String) -> String? { + guard let value = values[path] else { return nil } + order.removeAll { $0 == path } + order.append(path) + return value + } + + func insert(_ value: String, for path: String) { + let cost = value.utf8.count + guard cost <= maximumCost else { return } + + if let previous = costs[path] { totalCost -= previous } + values[path] = value + costs[path] = cost + totalCost += cost + order.removeAll { $0 == path } + order.append(path) + + while order.count > maximumEntries || totalCost > maximumCost { + guard let oldest = order.first else { break } + order.removeFirst() + values.removeValue(forKey: oldest) + totalCost -= costs.removeValue(forKey: oldest) ?? 0 + } + } +} + +/// Bounded cache for the expensive JSON-to-wire-model stage of large Cartesian snapshots. +actor NativePHPChartsDecodedSeriesCache { + static let shared = NativePHPChartsDecodedSeriesCache() + private let maximumEntries = 32 + private let maximumPoints = 100_000 + private var values: [String: [NativePHPChartsWireSeries]] = [:] + private var costs: [String: Int] = [:] + private var order: [String] = [] + private var totalPoints = 0 + + func series(for json: String) -> [NativePHPChartsWireSeries]? { + let data = Data(json.utf8) + let key = SHA256.hash(data: data).map { String(format: "%02x", $0) }.joined() + if let cached = values[key] { + order.removeAll { $0 == key }; order.append(key) + return cached + } + guard let decoded = try? JSONDecoder().decode([NativePHPChartsWireSeries].self, from: data) else { return nil } + let cost = decoded.reduce(0) { $0 + $1.points.count } + guard cost <= maximumPoints else { return decoded } + values[key] = decoded; costs[key] = cost; totalPoints += cost; order.append(key) + while order.count > maximumEntries || totalPoints > maximumPoints { + guard let oldest = order.first else { break } + order.removeFirst(); values.removeValue(forKey: oldest) + totalPoints -= costs.removeValue(forKey: oldest) ?? 0 + } + return decoded + } +} + +enum NativePHPChartsPayloadLoader { + @concurrent + static func seriesJSON(for input: NativePHPChartsWireInput) async throws -> String { + guard input.seriesTransport == "file-v1" else { return input.seriesJSON } + guard let path = input.seriesJSONFile, path.isEmpty == false else { + throw CocoaError(.fileNoSuchFile) + } + if let cached = await NativePHPChartsPayloadCache.shared.value(for: path) { + return cached + } + + try Task.checkCancellation() + let data = try Data(contentsOf: URL(fileURLWithPath: path), options: [.mappedIfSafe]) + try Task.checkCancellation() + guard let value = String(data: data, encoding: .utf8) else { + throw CocoaError(.fileReadInapplicableStringEncoding) + } + await NativePHPChartsPayloadCache.shared.insert(value, for: path) + return value + } +} + +struct NativePHPChartsTheme: Decodable, Sendable { + struct Variant: Decodable, Sendable { + let background: String? + let foreground: String? + let muted: String? + let grid: String? + let track: String? + let error: String? + let palette: [String] + + init(from decoder: Decoder) throws { + let container = try decoder.container(keyedBy: CodingKeys.self) + background = try container.decodeIfPresent(String.self, forKey: .background) + foreground = try container.decodeIfPresent(String.self, forKey: .foreground) + muted = try container.decodeIfPresent(String.self, forKey: .muted) + grid = try container.decodeIfPresent(String.self, forKey: .grid) + track = try container.decodeIfPresent(String.self, forKey: .track) + error = try container.decodeIfPresent(String.self, forKey: .error) + palette = try container.decodeIfPresent([String].self, forKey: .palette) ?? [] + } + + private enum CodingKeys: String, CodingKey { case background, foreground, muted, grid, track, error, palette } + } + + let light: Variant? + let dark: Variant? + + static func decode(_ json: String) -> NativePHPChartsTheme? { + guard let data = json.data(using: .utf8) else { return nil } + return try? JSONDecoder().decode(Self.self, from: data) + } + + func variant(mode: String, colorSchemeIsDark: Bool) -> Variant? { + switch mode { + case "light": light ?? dark + case "dark": dark ?? light + default: colorSchemeIsDark ? (dark ?? light) : (light ?? dark) + } + } +} diff --git a/resources/ios/Sources/Interaction/NativePHPChartsAccessibilityAction.swift b/resources/ios/Sources/Interaction/NativePHPChartsAccessibilityAction.swift index 702ea8a..a0484a5 100644 --- a/resources/ios/Sources/Interaction/NativePHPChartsAccessibilityAction.swift +++ b/resources/ios/Sources/Interaction/NativePHPChartsAccessibilityAction.swift @@ -49,17 +49,21 @@ struct NativePHPChartsAccessibilityRepresentation: View { } var body: some View { - Text(value) - .accessibilityElement(children: .ignore) - .accessibilityLabel(label) - .accessibilityValue(value) - .accessibilityActions { - ForEach(actions) { action in - Button(action.label) { - onSelect(action.target) + GeometryReader { _ in + Rectangle() + .fill(.clear) + .contentShape(Rectangle()) + .accessibilityElement(children: .ignore) + .accessibilityLabel(label) + .accessibilityValue(value) + .accessibilityActions { + ForEach(actions) { action in + Button(action.label) { + onSelect(action.target) + } } } - } - .id(identity) + .id(identity) + } } } diff --git a/resources/ios/Sources/Interaction/NativePHPChartsSelectionOverlay.swift b/resources/ios/Sources/Interaction/NativePHPChartsSelectionOverlay.swift index ea249e0..e889dc5 100644 --- a/resources/ios/Sources/Interaction/NativePHPChartsSelectionOverlay.swift +++ b/resources/ios/Sources/Interaction/NativePHPChartsSelectionOverlay.swift @@ -132,7 +132,9 @@ struct NativePHPChartsSelectionOverlay: View { private func resolvedCandlestickBodyWidth(proxy: ChartProxy, plotWidth: CGFloat) -> CGFloat? { guard kind == .candlestick, let series = snapshot.data.series.first else { return nil } let style = candlestickStyle(for: series) - let width = style.width.map(NativePHPChartsCandlestickBodyWidth.fixed) ?? .ratio(0.62) + let width = NativePHPChartsCandlestickBodyWidth.fixed( + style.width ?? NativePHPChartsCandlestickBodyWidth.defaultWidth + ) return candlestickBodyWidth(width, proxy: proxy, plotWidth: plotWidth) } diff --git a/resources/ios/Sources/ProgressChartRenderer.swift b/resources/ios/Sources/ProgressChartRenderer.swift new file mode 100644 index 0000000..1a83ec0 --- /dev/null +++ b/resources/ios/Sources/ProgressChartRenderer.swift @@ -0,0 +1,292 @@ +import SwiftUI + +struct NativePHPChartsProgressMetric: Decodable, Identifiable, Sendable { + let id: String + let label: String + let value: Double + let color: String? + let sourceIndex: Int + + private enum CodingKeys: String, CodingKey { case id, label, value, color } + + init(from decoder: Decoder) throws { + let container = try decoder.container(keyedBy: CodingKeys.self) + id = try container.decode(String.self, forKey: .id) + label = try container.decode(String.self, forKey: .label) + value = try container.decode(Double.self, forKey: .value) + color = try container.decodeIfPresent(String.self, forKey: .color) + sourceIndex = decoder.codingPath.last?.intValue ?? 0 + } + + init(id: String, label: String, value: Double, color: String? = nil, sourceIndex: Int) { + self.id = id; self.label = label; self.value = value; self.color = color; self.sourceIndex = sourceIndex + } +} + +struct NativePHPChartsProgressWireInput: Equatable, Sendable { + let contractVersion: Int + let metricsJSON: String + let centerLabel: String + let styleJSON: String + let legendJSON: String + let themeMode: String + let preset: String + let themeJSON: String + let locale: String + let minimumFractionDigits: Int + let maximumFractionDigits: Int + let errorLabel: String + let emptyLabel: String + let accessibilityLabel: String + let animated: Bool + let onSelect: Int + + init(node: NativeUINode) { + contractVersion = node.props.getInt("contract_version", default: 0) + metricsJSON = node.props.getString("metrics_json", default: "[]") + centerLabel = node.props.getString("center_label", default: "") + styleJSON = node.props.getString("style_json", default: "{}") + legendJSON = node.props.getString("legend_json", default: "{}") + themeMode = node.props.getString("theme_mode", default: "system") + preset = node.props.getString("preset", default: "default") + themeJSON = node.props.getString("theme_json", default: "{}") + locale = node.props.getString("locale", default: "") + minimumFractionDigits = node.props.getInt("minimum_fraction_digits", default: -1) + maximumFractionDigits = node.props.getInt("maximum_fraction_digits", default: -1) + errorLabel = node.props.getString("error_label", default: "Chart unavailable") + emptyLabel = node.props.getString("empty_label", default: "No data") + accessibilityLabel = node.props.getString("a11y_label", default: "Progress chart") + animated = node.props.getBool("animated", default: true) + onSelect = node.props.getInt("on_select", default: 0) + } + + static func testing(contractVersion: Int = 1, metricsJSON: String) -> Self { + Self(contractVersion: contractVersion, metricsJSON: metricsJSON) + } + + private init(contractVersion: Int, metricsJSON: String) { + self.contractVersion = contractVersion; self.metricsJSON = metricsJSON + centerLabel = ""; styleJSON = "{}"; legendJSON = "{}"; themeMode = "system"; preset = "default"; themeJSON = "{}"; locale = ""; minimumFractionDigits = -1; maximumFractionDigits = -1 + errorLabel = "Chart unavailable"; emptyLabel = "No data"; accessibilityLabel = "Progress chart" + animated = true; onSelect = 0 + } +} + +struct NativePHPChartsProgressSnapshot: @unchecked Sendable { + let availability: NativePHPChartsAvailability + let metrics: [NativePHPChartsProgressMetric] + let input: NativePHPChartsProgressWireInput + let theme: NativePHPChartsTheme? + let animationID: Int + let style: NativePHPChartsProgressStyle + let legend: NativePHPChartsLegendConfiguration + + init(input: NativePHPChartsProgressWireInput) { + self.input = input + theme = NativePHPChartsTheme.decode(input.themeJSON) + style = NativePHPChartsProgressStyle.decode(input.styleJSON) + legend = NativePHPChartsLegendConfiguration.decode(input.legendJSON) + let decoded = input.metricsJSON.data(using: .utf8).flatMap { + try? JSONDecoder().decode([NativePHPChartsProgressMetric].self, from: $0) + } + if input.contractVersion != NativePHPChartsRuntime.supportedContractVersion { + availability = .unsupportedContract; metrics = [] + } else if let decoded, Self.validate(decoded) { + availability = .available; metrics = decoded + } else { + availability = .invalidPayload; metrics = [] + } + var hasher = Hasher() + metrics.forEach { hasher.combine($0.id); hasher.combine($0.value); hasher.combine($0.color) } + animationID = hasher.finalize() + NativePHPChartsRuntime.diagnose(availability, chartType: "progress") + } + + @concurrent static func load(input: NativePHPChartsProgressWireInput) async -> Self { Self(input: input) } + + private static func validate(_ metrics: [NativePHPChartsProgressMetric]) -> Bool { + Set(metrics.map(\.id)).count == metrics.count && metrics.allSatisfy { + $0.id.isEmpty == false && $0.label.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty == false + && $0.value.isFinite && (0...1).contains($0.value) + } + } +} + +struct NativePHPChartsProgressStyle: Decodable, Sendable { + struct Ring: Decodable, Sendable { + let trackColor: String? + let width: CGFloat? + let gap: CGFloat? + let cap: String? + enum CodingKeys: String, CodingKey { case width, gap, cap; case trackColor = "track_color" } + } + let ring: Ring? + + static func decode(_ json: String) -> Self { + guard let data = json.data(using: .utf8), let value = try? JSONDecoder().decode(Self.self, from: data) else { + return Self(ring: nil) + } + return value + } +} + +enum NativePHPChartsProgressSelection { + static func payload(metric: NativePHPChartsProgressMetric) -> NativePHPChartsSelectionPayload { + NativePHPChartsSelectionPayload( + chartType: "progress", + seriesID: metric.id, + seriesName: metric.label, + pointID: metric.id, + pointIndex: metric.sourceIndex, + xType: "category", + x: .string(metric.label), + label: metric.label, + value: metric.value, + localizedValue: metric.value.formatted(.percent) + ) + } +} + +struct NativePHPChartsProgressChartRenderer: View { + let node: NativeUINode + @State private var snapshot: NativePHPChartsProgressSnapshot + @State private var selectedID: String? + @State private var revealProgress = 0.0 + @Environment(\.accessibilityReduceMotion) private var reduceMotion + @Environment(\.colorScheme) private var colorScheme + + init(node: NativeUINode) { + self.node = node + _snapshot = State(initialValue: .init(input: .testing(metricsJSON: "[]"))) + } + + private var wireInput: NativePHPChartsProgressWireInput { .init(node: node) } + + var body: some View { + Group { + if snapshot.availability != .available { unavailableState } + else if snapshot.metrics.isEmpty { emptyState } + else { content } + } + .task(id: wireInput) { + let updated = await NativePHPChartsProgressSnapshot.load(input: wireInput) + guard Task.isCancelled == false else { return } + snapshot = updated + selectedID = updated.metrics.contains { $0.id == selectedID } ? selectedID : nil + } + } + + private var content: some View { + VStack(spacing: 12) { + GeometryReader { geometry in + ZStack { + ForEach(Array(snapshot.metrics.enumerated()), id: \.element.id) { index, metric in + let inset = CGFloat(index) * ringStep + Circle().stroke(trackColor, lineWidth: ringWidth).padding(inset) + Circle() + .trim(from: 0, to: metric.value * revealProgress) + .stroke(color(for: metric, index: index), style: StrokeStyle(lineWidth: ringWidth, lineCap: lineCap)) + .rotationEffect(.degrees(-90)).padding(inset) + .opacity(selectedID == nil || selectedID == metric.id ? 1 : 0.48) + } + if snapshot.input.centerLabel.isEmpty == false { + Text(snapshot.input.centerLabel).font(.headline).multilineTextAlignment(.center) + } + } + .contentShape(Rectangle()) + .gesture(SpatialTapGesture().onEnded { select(metric(at: $0.location, size: geometry.size)) }) + } + .aspectRatio(1, contentMode: .fit) + if snapshot.legend.visible ?? (snapshot.metrics.count > 1) { legend } + } + .animation(animation, value: revealProgress) + .task(id: snapshot.animationID) { + revealProgress = reduceMotion || snapshot.input.animated == false ? 1 : 0 + guard revealProgress == 0 else { return } + await Task.yield() + withAnimation(animation) { revealProgress = 1 } + } + .accessibilityRepresentation { + NativePHPChartsAccessibilityRepresentation( + label: snapshot.input.accessibilityLabel, + value: accessibilitySummary, + actions: accessibilityActions, + onSelect: select + ) + } + } + + private var legend: some View { + VStack(alignment: .leading, spacing: 6) { + ForEach(Array(snapshot.metrics.enumerated()), id: \.element.id) { index, metric in + HStack { Circle().fill(color(for: metric, index: index)).frame(width: 8, height: 8); Text(metric.label); Spacer(); Text(metric.value, format: .percent.precision(.fractionLength(0))) } + .font(.caption) + } + } + } + + private var variant: NativePHPChartsTheme.Variant? { + snapshot.theme?.variant(mode: snapshot.input.themeMode, colorSchemeIsDark: colorScheme == .dark) + } + private var trackColor: Color { color(snapshot.style.ring?.trackColor ?? variant?.track, fallback: .secondary.opacity(0.18)) } + private var ringWidth: CGFloat { snapshot.style.ring?.width ?? 12 } + private var ringStep: CGFloat { ringWidth + (snapshot.style.ring?.gap ?? 8) } + private var lineCap: CGLineCap { + switch snapshot.style.ring?.cap { case "butt": .butt; case "square": .square; default: .round } + } + private var animation: Animation? { NativePHPChartsAnimation.resolved(enabled: snapshot.input.animated, reduceMotion: reduceMotion) } + + private func color(for metric: NativePHPChartsProgressMetric, index: Int) -> Color { + let palette = variant?.palette ?? [] + let preset = snapshot.input.preset == "contrast" ? ["#0057B8", "#D1495B", "#00876C", "#7A5195"] : ["#6366F1", "#06B6D4", "#22C55E", "#F59E0B"] + return color(metric.color ?? palette[safe: index] ?? preset[index % preset.count], fallback: .indigo) + } + + private func color(_ value: String?, fallback: Color) -> Color { + value.map { Color(argb: ColorParser.parse($0, default: 0xFF6366F1)) } ?? fallback + } + + private func metric(at point: CGPoint, size: CGSize) -> NativePHPChartsProgressMetric? { + let center = CGPoint(x: size.width / 2, y: size.height / 2) + let distance = hypot(point.x - center.x, point.y - center.y) + let outerRadius = min(size.width, size.height) / 2 - ringWidth / 2 + return snapshot.metrics.enumerated().min { lhs, rhs in + abs((outerRadius - CGFloat(lhs.offset) * ringStep) - distance) < abs((outerRadius - CGFloat(rhs.offset) * ringStep) - distance) + }.flatMap { abs((outerRadius - CGFloat($0.offset) * ringStep) - distance) <= 22 ? $0.element : nil } + } + + private func select(_ metric: NativePHPChartsProgressMetric?) { + guard selectedID != metric?.id else { return } + selectedID = metric?.id + guard let metric, snapshot.input.onSelect > 0, + let json = NativePHPChartsProgressSelection.payload(metric: metric).json() + else { return } + NativeElementBridge.sendTextChangeEvent(snapshot.input.onSelect, nodeId: node.id, text: json) + } + + private var formatter: NumberFormatter { + let formatter = NumberFormatter(); formatter.numberStyle = .percent + formatter.locale = snapshot.input.locale.isEmpty ? .current : Locale(identifier: snapshot.input.locale) + if snapshot.input.minimumFractionDigits >= 0 { formatter.minimumFractionDigits = snapshot.input.minimumFractionDigits } + if snapshot.input.maximumFractionDigits >= 0 { formatter.maximumFractionDigits = snapshot.input.maximumFractionDigits } + return formatter + } + private func formatted(_ value: Double) -> String { formatter.string(from: NSNumber(value: value)) ?? value.formatted(.percent) } + private var accessibilitySummary: String { snapshot.metrics.map { "\($0.label): \(formatted($0.value))" }.joined(separator: ". ") } + private var accessibilityActions: [NativePHPChartsAccessibilityAction] { + let index = snapshot.metrics.firstIndex { $0.id == selectedID } + let previous = index.flatMap { $0 > 0 ? snapshot.metrics[$0 - 1] : nil } + let next = index.map { $0 + 1 }.flatMap { $0 < snapshot.metrics.count ? snapshot.metrics[$0] : nil } + ?? (index == nil ? snapshot.metrics.first : nil) + return [(previous, NativePHPChartsAccessibilityAction.Direction.previous), (next, .next)].compactMap { metric, direction in + metric.map { .init(dataID: snapshot.animationID, direction: direction, targetID: $0.id, label: "\($0.label), \(formatted($0.value))", target: $0) } + } + } + + private var emptyState: some View { ContentUnavailableView(snapshot.input.emptyLabel, systemImage: "chart.pie") } + private var unavailableState: some View { ContentUnavailableView(snapshot.input.errorLabel, systemImage: "exclamationmark.triangle") } +} + +private extension Array { + subscript(safe index: Int) -> Element? { indices.contains(index) ? self[index] : nil } +} diff --git a/resources/ios/Sources/Radar/NativePHPChartsRadarModels.swift b/resources/ios/Sources/Radar/NativePHPChartsRadarModels.swift index 66d2e6b..ff4d647 100644 --- a/resources/ios/Sources/Radar/NativePHPChartsRadarModels.swift +++ b/resources/ios/Sources/Radar/NativePHPChartsRadarModels.swift @@ -23,6 +23,18 @@ struct NativePHPChartsRadarSeries: Decodable, Hashable, Identifiable { case colorValue = "color" } + init(id: String, name: String, colorValue: String, values: [NativePHPChartsRadarValue]) { + self.id = id; self.name = name; self.colorValue = colorValue; self.values = values + } + + init(from decoder: Decoder) throws { + let container = try decoder.container(keyedBy: CodingKeys.self) + id = try container.decode(String.self, forKey: .id) + name = try container.decode(String.self, forKey: .name) + colorValue = try container.decodeIfPresent(String.self, forKey: .colorValue) ?? "" + values = try container.decode([NativePHPChartsRadarValue].self, forKey: .values) + } + var color: Color { Color(argb: ColorParser.parse(colorValue, default: 0xFF6366F1)) } } @@ -39,7 +51,8 @@ struct NativePHPChartsRadarSelection: Hashable, Identifiable { /// /// Axes and values use separate JSON lists, but PHP guarantees that each series repeats every /// axis exactly once and in declaration order. Defaults keep older generated shells readable. -struct NativePHPChartsRadarWireInput: Equatable { +struct NativePHPChartsRadarWireInput: Equatable, Sendable { + let contractVersion: Int let axesJSON: String let seriesJSON: String let styleJSON: String @@ -51,12 +64,17 @@ struct NativePHPChartsRadarWireInput: Equatable { let maximumFractionDigits: Int let animated: Bool let emptyLabel: String + let errorLabel: String let accessibilityLabel: String + let themeMode: String + let preset: String + let themeJSON: String let onSelect: Int let gridLevels: Int let fillOpacity: Double init( + contractVersion: Int = 1, axesJSON: String = "[]", seriesJSON: String = "[]", styleJSON: String = "{}", @@ -68,11 +86,16 @@ struct NativePHPChartsRadarWireInput: Equatable { maximumFractionDigits: Int = -1, animated: Bool = true, emptyLabel: String = "No data", + errorLabel: String = "Chart unavailable", accessibilityLabel: String = "Chart", + themeMode: String = "system", + preset: String = "default", + themeJSON: String = "{}", onSelect: Int = 0, gridLevels: Int = 5, fillOpacity: Double = 0.22 ) { + self.contractVersion = contractVersion self.axesJSON = axesJSON self.seriesJSON = seriesJSON self.styleJSON = styleJSON @@ -84,7 +107,11 @@ struct NativePHPChartsRadarWireInput: Equatable { self.maximumFractionDigits = maximumFractionDigits self.animated = animated self.emptyLabel = emptyLabel + self.errorLabel = errorLabel self.accessibilityLabel = accessibilityLabel + self.themeMode = themeMode + self.preset = preset + self.themeJSON = themeJSON self.onSelect = onSelect self.gridLevels = gridLevels self.fillOpacity = fillOpacity @@ -92,6 +119,7 @@ struct NativePHPChartsRadarWireInput: Equatable { init(node: NativeUINode) { self.init( + contractVersion: node.props.getInt("contract_version", default: 0), axesJSON: node.props.getString("axes_json", default: "[]"), seriesJSON: node.props.getString("series_json", default: "[]"), styleJSON: node.props.getString("style_json", default: "{}"), @@ -103,7 +131,11 @@ struct NativePHPChartsRadarWireInput: Equatable { maximumFractionDigits: node.props.getInt("maximum_fraction_digits", default: -1), animated: node.props.getBool("animated", default: true), emptyLabel: node.props.getString("empty_label", default: "No data"), + errorLabel: node.props.getString("error_label", default: "Chart unavailable"), accessibilityLabel: node.props.getString("a11y_label", default: "Chart"), + themeMode: node.props.getString("theme_mode", default: "system"), + preset: node.props.getString("preset", default: "default"), + themeJSON: node.props.getString("theme_json", default: "{}"), onSelect: node.props.getInt("on_select", default: 0), gridLevels: node.props.getInt("grid_levels", default: 5), fillOpacity: Double(node.props.getFloat("fill_opacity", default: 0.22)) @@ -117,6 +149,7 @@ struct NativePHPChartsRadarWireInput: Equatable { /// array index exists and its axis id matches the declared spoke. Malformed JSON or misaligned /// values therefore become empty/partial native state instead of connecting the wrong axes. struct NativePHPChartsRadarSnapshot { + let availability: NativePHPChartsAvailability let axes: [NativePHPChartsRadarAxis] let series: [NativePHPChartsRadarSeries] let style: NativePHPChartsStyle @@ -130,10 +163,26 @@ struct NativePHPChartsRadarSnapshot { let fillOpacity: Double let animationID: Int let selections: [NativePHPChartsRadarSelection] + let theme: NativePHPChartsTheme.Variant? + let palette: [String] - init(input: NativePHPChartsRadarWireInput) { - let decodedAxes = Self.decode([NativePHPChartsRadarAxis].self, input.axesJSON) - let decodedSeries = Self.decode([NativePHPChartsRadarSeries].self, input.seriesJSON) + init(input: NativePHPChartsRadarWireInput, colorSchemeIsDark: Bool = false) { + let axesResult = Self.decode([NativePHPChartsRadarAxis].self, input.axesJSON) + let seriesResult = Self.decode([NativePHPChartsRadarSeries].self, input.seriesJSON) + let valid = input.contractVersion == NativePHPChartsRuntime.supportedContractVersion + && axesResult != nil && seriesResult != nil + && Self.validate(axes: axesResult ?? [], series: seriesResult ?? []) + availability = input.contractVersion != NativePHPChartsRuntime.supportedContractVersion + ? .unsupportedContract + : (valid ? .available : .invalidPayload) + let decodedAxes = valid ? (axesResult ?? []) : [] + let resolvedTheme = NativePHPChartsTheme.decode(input.themeJSON)?.variant(mode: input.themeMode, colorSchemeIsDark: colorSchemeIsDark) + let resolvedPalette = resolvedTheme?.palette.isEmpty == false ? (resolvedTheme?.palette ?? []) : NativePHPChartsRuntime.palette(preset: input.preset) + theme = resolvedTheme + palette = resolvedPalette + let decodedSeries = valid ? (seriesResult ?? []).enumerated().map { index, item in + NativePHPChartsRadarSeries(id: item.id, name: item.name, colorValue: item.colorValue.isEmpty ? resolvedPalette[index % resolvedPalette.count] : item.colorValue, values: item.values) + } : [] let decodedStyle = NativePHPChartsStyle.decode(input.styleJSON) axes = decodedAxes @@ -160,6 +209,7 @@ struct NativePHPChartsRadarSnapshot { hasher.combine(decodedAxes) hasher.combine(decodedSeries) animationID = hasher.finalize() + NativePHPChartsRuntime.diagnose(availability, chartType: "radar") } var isEmpty: Bool { axes.count < 3 || series.allSatisfy(\.values.isEmpty) } @@ -169,11 +219,29 @@ struct NativePHPChartsRadarSnapshot { selections.first { $0.id == id } } - private static func decode(_ type: Value.Type, _ json: String) -> Value where Value: RangeReplaceableCollection { - guard let data = json.data(using: .utf8), let value = try? JSONDecoder().decode(type, from: data) else { - return Value() + @concurrent static func load(input: NativePHPChartsRadarWireInput, colorSchemeIsDark: Bool = false) async -> Self { + Self(input: input, colorSchemeIsDark: colorSchemeIsDark) + } + + private static func decode(_ type: Value.Type, _ json: String) -> Value? { + guard let data = json.data(using: .utf8) else { return nil } + return try? JSONDecoder().decode(type, from: data) + } + + private static func validate(axes: [NativePHPChartsRadarAxis], series: [NativePHPChartsRadarSeries]) -> Bool { + if axes.isEmpty { return series.isEmpty } + guard axes.count >= 3, + Set(axes.map(\.id)).count == axes.count, + axes.allSatisfy({ $0.id.isEmpty == false && $0.maximum.isFinite && $0.maximum > 0 }), + Set(series.map(\.id)).count == series.count, + series.allSatisfy({ $0.id.isEmpty == false && $0.values.count == axes.count }) + else { return false } + + return series.allSatisfy { item in + zip(item.values, axes).allSatisfy { value, axis in + value.axis == axis.id && value.value.isFinite && value.value >= 0 && value.value <= axis.maximum + } } - return value } } diff --git a/resources/ios/Sources/RadarChartRenderer.swift b/resources/ios/Sources/RadarChartRenderer.swift index ed369ea..48d9ed4 100644 --- a/resources/ios/Sources/RadarChartRenderer.swift +++ b/resources/ios/Sources/RadarChartRenderer.swift @@ -96,28 +96,36 @@ enum NativePHPChartsRadarAxisLabelLayout { } struct NativePHPChartsRadarChartRenderer: View { + private struct LoadKey: Equatable { let input: NativePHPChartsRadarWireInput; let isDark: Bool } let node: NativeUINode @State private var snapshot: NativePHPChartsRadarSnapshot @State private var selectedID: String? + @Environment(\.colorScheme) private var colorScheme init(node: NativeUINode) { self.node = node - _snapshot = State(initialValue: NativePHPChartsRadarSnapshot(input: NativePHPChartsRadarWireInput(node: node))) + _snapshot = State(initialValue: NativePHPChartsRadarSnapshot(input: NativePHPChartsRadarWireInput())) } var body: some View { Group { - if snapshot.isEmpty { emptyState } else { content } + if snapshot.availability != .available { unavailableState } + else if snapshot.isEmpty { emptyState } + else { content } } - .onChange(of: wireInput) { _, input in - let updated = NativePHPChartsRadarSnapshot(input: input) + .background(snapshot.style.color(snapshot.theme?.background, fallback: .clear)) + .foregroundStyle(snapshot.style.color(snapshot.theme?.foreground, fallback: .primary)) + .task(id: loadKey) { + let updated = await NativePHPChartsRadarSnapshot.load(input: wireInput, colorSchemeIsDark: colorScheme == .dark) + guard Task.isCancelled == false else { return } snapshot = updated - if updated.selection(id: selectedID) == nil { selectedID = nil } + selectedID = updated.selection(id: selectedID)?.id } } private var wireInput: NativePHPChartsRadarWireInput { NativePHPChartsRadarWireInput(node: node) } + private var loadKey: LoadKey { LoadKey(input: wireInput, isDark: colorScheme == .dark) } @ViewBuilder private var content: some View { @@ -144,6 +152,13 @@ struct NativePHPChartsRadarChartRenderer: View { .accessibilityLabel(snapshot.accessibilityLabel) .accessibilityValue(snapshot.emptyLabel) } + + private var unavailableState: some View { + ContentUnavailableView { Label(wireInput.errorLabel, systemImage: "exclamationmark.triangle") } + .accessibilityElement(children: .ignore) + .accessibilityLabel(snapshot.accessibilityLabel) + .accessibilityValue(wireInput.errorLabel) + } } /// Draws radar data directly in Canvas coordinates and owns committed selection state. @@ -251,8 +266,8 @@ private struct NativePHPChartsRadarPlot: View { ) { let center = CGPoint(x: size.width / 2, y: size.height / 2) let radius = min(size.width, size.height) * 0.34 - let gridColor = snapshot.style.color(snapshot.style.grid.color, fallback: .secondary.opacity(0.2)) - let axisColor = snapshot.style.color(snapshot.style.axis.color, fallback: .secondary.opacity(0.28)) + let gridColor = snapshot.style.color(snapshot.style.grid.color, fallback: snapshot.style.color(snapshot.theme?.grid, fallback: .secondary.opacity(0.2))) + let axisColor = snapshot.style.color(snapshot.style.axis.color, fallback: snapshot.style.color(snapshot.theme?.muted, fallback: .secondary.opacity(0.28))) if snapshot.style.grid.visible ?? true { for level in 1...snapshot.gridLevels { @@ -272,7 +287,7 @@ private struct NativePHPChartsRadarPlot: View { axisCount: snapshot.axes.count ) { let labelPoint = point(index: index, ratio: 1.17, center: center, radius: radius) - let labelColor = snapshot.style.color(snapshot.style.axis.labelColor, fallback: .secondary) + let labelColor = snapshot.style.color(snapshot.style.axis.labelColor, fallback: snapshot.style.color(snapshot.theme?.foreground, fallback: .secondary)) context.draw( context.resolve(Text(displayLabel).font(snapshot.style.axisFont(scale: axisFontScale)).foregroundStyle(labelColor)), at: labelPoint diff --git a/resources/ios/Sources/Rendering/NativePHPChartsMarks.swift b/resources/ios/Sources/Rendering/NativePHPChartsMarks.swift index 919ad39..7f4e326 100644 --- a/resources/ios/Sources/Rendering/NativePHPChartsMarks.swift +++ b/resources/ios/Sources/Rendering/NativePHPChartsMarks.swift @@ -2,6 +2,8 @@ import Charts import SwiftUI enum NativePHPChartsCandlestickBodyWidth: Equatable { + static let defaultWidth: CGFloat = 12 + case fixed(CGFloat) case ratio(CGFloat) @@ -55,7 +57,10 @@ struct NativePHPChartsCandlestickGeometry: Equatable { self.high = high self.low = low self.close = close - bodyWidth = style.width.map(NativePHPChartsCandlestickBodyWidth.fixed) ?? .ratio(0.62) + // Swift Charts treats ratio widths as a fraction of a continuous date unit, which + // collapses OHLC bodies to a hairline. A point width remains legible for category, + // number, and date axes while preserving an explicit application override. + bodyWidth = .fixed(style.width ?? NativePHPChartsCandlestickBodyWidth.defaultWidth) cornerRadius = style.radius ?? 5 } } diff --git a/resources/ios/Sources/Rendering/NativePHPChartsPlot.swift b/resources/ios/Sources/Rendering/NativePHPChartsPlot.swift index ca92275..fdbfe7f 100644 --- a/resources/ios/Sources/Rendering/NativePHPChartsPlot.swift +++ b/resources/ios/Sources/Rendering/NativePHPChartsPlot.swift @@ -468,21 +468,21 @@ struct NativePHPChartsPlot: View { private var gridColor: Color { snapshot.configuration.style.color( snapshot.configuration.style.grid.color, - fallback: .secondary.opacity(0.16) + fallback: snapshot.configuration.style.color(snapshot.configuration.theme?.grid, fallback: .secondary.opacity(0.16)) ) } private var axisColor: Color { snapshot.configuration.style.color( snapshot.configuration.style.axis.color, - fallback: .secondary.opacity(0.35) + fallback: snapshot.configuration.style.color(snapshot.configuration.theme?.muted, fallback: .secondary.opacity(0.35)) ) } private var axisLabelColor: Color { snapshot.configuration.style.color( snapshot.configuration.style.axis.labelColor, - fallback: .secondary + fallback: snapshot.configuration.style.color(snapshot.configuration.theme?.foreground, fallback: .secondary) ) } diff --git a/resources/ios/Sources/Rendering/NativePHPChartsRadialRenderer.swift b/resources/ios/Sources/Rendering/NativePHPChartsRadialRenderer.swift index facd016..fc83586 100644 --- a/resources/ios/Sources/Rendering/NativePHPChartsRadialRenderer.swift +++ b/resources/ios/Sources/Rendering/NativePHPChartsRadialRenderer.swift @@ -4,18 +4,20 @@ import SwiftUI /// /// A selected id survives presentation-only updates but is cleared when its segment disappears. struct NativePHPChartsRadialRenderer: View { + private struct LoadKey: Equatable { let input: NativePHPChartsRadialWireInput; let isDark: Bool } let node: NativeUINode let kind: NativePHPChartsRadialKind @State private var snapshot: NativePHPChartsRadialSnapshot @State private var selectedSegmentID: String? + @Environment(\.colorScheme) private var colorScheme init(node: NativeUINode, kind: NativePHPChartsRadialKind) { self.node = node self.kind = kind _snapshot = State( initialValue: NativePHPChartsRadialSnapshot( - input: NativePHPChartsRadialWireInput(node: node, kind: kind), + input: .testing(segmentsJSON: "[]"), kind: kind ) ) @@ -23,19 +25,21 @@ struct NativePHPChartsRadialRenderer: View { var body: some View { Group { - if snapshot.data.isEmpty { + if snapshot.availability != .available { + unavailableState + } else if snapshot.data.isEmpty { emptyState } else { content } } - .onChange(of: wireInput) { _, input in - let updated = NativePHPChartsRadialSnapshot(input: input, kind: kind) + .background(themeColor(snapshot.configuration.theme?.background, fallback: .clear)) + .foregroundStyle(themeColor(snapshot.configuration.theme?.foreground, fallback: .primary)) + .task(id: loadKey) { + let updated = await NativePHPChartsRadialSnapshot.load(input: wireInput, kind: kind, colorSchemeIsDark: colorScheme == .dark) + guard Task.isCancelled == false else { return } snapshot = updated - - if updated.data.segment(id: selectedSegmentID) == nil { - selectedSegmentID = nil - } + selectedSegmentID = updated.data.segment(id: selectedSegmentID)?.id } } @@ -43,6 +47,12 @@ struct NativePHPChartsRadialRenderer: View { NativePHPChartsRadialWireInput(node: node, kind: kind) } + private var loadKey: LoadKey { LoadKey(input: wireInput, isDark: colorScheme == .dark) } + + private func themeColor(_ value: String?, fallback: Color) -> Color { + value.map { Color(argb: ColorParser.parse($0, default: 0xFF6366F1)) } ?? fallback + } + @ViewBuilder private var content: some View { let plot = NativePHPChartsRadialPlot( @@ -89,6 +99,13 @@ struct NativePHPChartsRadialRenderer: View { .accessibilityValue(snapshot.configuration.emptyLabel) } + private var unavailableState: some View { + ContentUnavailableView { Label(wireInput.errorLabel, systemImage: "exclamationmark.triangle") } + .accessibilityElement(children: .ignore) + .accessibilityLabel(snapshot.configuration.accessibilityLabel) + .accessibilityValue(wireInput.errorLabel) + } + private var emptyIcon: String { kind == .donut ? "chart.pie.fill" : "chart.pie" } diff --git a/resources/ios/Sources/Rendering/NativePHPChartsRenderer.swift b/resources/ios/Sources/Rendering/NativePHPChartsRenderer.swift index 0188f94..b7b4aaa 100644 --- a/resources/ios/Sources/Rendering/NativePHPChartsRenderer.swift +++ b/resources/ios/Sources/Rendering/NativePHPChartsRenderer.swift @@ -5,33 +5,38 @@ import SwiftUI /// Selection identity survives unrelated property updates when the point still exists. It is /// cleared when a new payload removes the selected point, preventing stale tooltips and events. struct NativePHPChartsRenderer: View { + private struct LoadKey: Equatable { let input: NativePHPChartsWireInput; let isDark: Bool } let node: NativeUINode let kind: NativePHPChartsKind @State private var snapshot: NativePHPChartsSnapshot @State private var selectedPointID: String? + @Environment(\.colorScheme) private var colorScheme init(node: NativeUINode, kind: NativePHPChartsKind) { self.node = node self.kind = kind - _snapshot = State(initialValue: NativePHPChartsSnapshot(input: NativePHPChartsWireInput(node: node), kind: kind)) + _snapshot = State(initialValue: NativePHPChartsSnapshot(input: .testing(seriesJSON: "[]"), kind: kind)) } var body: some View { Group { - if snapshot.data.isEmpty { + if snapshot.availability != .available { + unavailableState + } else if snapshot.data.isEmpty { emptyState } else { content } } - .onChange(of: wireInput) { _, input in - let updated = NativePHPChartsSnapshot(input: input, kind: kind) + .background(snapshot.configuration.style.color(snapshot.configuration.theme?.background, fallback: .clear)) + .foregroundStyle(snapshot.configuration.style.color(snapshot.configuration.theme?.foreground, fallback: .primary)) + .task(id: loadKey) { + guard let updated = await NativePHPChartsSnapshot.load(input: wireInput, kind: kind, colorSchemeIsDark: colorScheme == .dark), + Task.isCancelled == false + else { return } snapshot = updated - - if updated.data.point(selectionID: selectedPointID) == nil { - selectedPointID = nil - } + selectedPointID = updated.data.point(selectionID: selectedPointID)?.selectionID } } @@ -39,6 +44,8 @@ struct NativePHPChartsRenderer: View { NativePHPChartsWireInput(node: node) } + private var loadKey: LoadKey { LoadKey(input: wireInput, isDark: colorScheme == .dark) } + @ViewBuilder private var content: some View { let plot = NativePHPChartsPlot( @@ -86,6 +93,15 @@ struct NativePHPChartsRenderer: View { .accessibilityValue(snapshot.configuration.emptyLabel) } + private var unavailableState: some View { + ContentUnavailableView { + Label(wireInput.errorLabel, systemImage: "exclamationmark.triangle") + } + .accessibilityElement(children: .ignore) + .accessibilityLabel(snapshot.configuration.accessibilityLabel) + .accessibilityValue(wireInput.errorLabel) + } + private var emptyIcon: String { switch kind { case .line: "chart.line.flattrend.xyaxis" diff --git a/resources/ios/Sources/Rendering/NativePHPChartsStyle.swift b/resources/ios/Sources/Rendering/NativePHPChartsStyle.swift index 0ea983a..90088b0 100644 --- a/resources/ios/Sources/Rendering/NativePHPChartsStyle.swift +++ b/resources/ios/Sources/Rendering/NativePHPChartsStyle.swift @@ -6,7 +6,7 @@ import SwiftUI /// Missing sections inherit empty option groups so mark-specific defaults can be resolved at /// the rendering boundary. Invalid JSON falls back to the complete default style rather than /// mixing partially decoded presentation state. -struct NativePHPChartsStyle: Decodable { +struct NativePHPChartsStyle: Decodable, Sendable { let line: Line let area: Area let bar: Bar @@ -58,7 +58,7 @@ struct NativePHPChartsStyle: Decodable { return style } - struct Line: Decodable { + struct Line: Decodable, Sendable { let color: String? let width: CGFloat? let interpolation: String? @@ -72,7 +72,7 @@ struct NativePHPChartsStyle: Decodable { } } - struct Area: Decodable { + struct Area: Decodable, Sendable { let opacity: Double? let gradient: Bool? @@ -82,7 +82,7 @@ struct NativePHPChartsStyle: Decodable { } } - struct Bar: Decodable { + struct Bar: Decodable, Sendable { let radius: CGFloat? let width: CGFloat? @@ -104,7 +104,7 @@ struct NativePHPChartsStyle: Decodable { } } - struct Candlestick: Decodable, Equatable { + struct Candlestick: Decodable, Equatable, Sendable { let risingColor: String? let fallingColor: String? let neutralColor: String? @@ -152,7 +152,7 @@ struct NativePHPChartsStyle: Decodable { var resolvedWickWidth: CGFloat { wickWidth ?? 1.5 } } - struct Points: Decodable { + struct Points: Decodable, Sendable { let visible: Bool? let color: String? let size: CGFloat? @@ -164,7 +164,7 @@ struct NativePHPChartsStyle: Decodable { } } - struct Grid: Decodable { + struct Grid: Decodable, Sendable { let visible: Bool? let color: String? let width: CGFloat? @@ -176,7 +176,7 @@ struct NativePHPChartsStyle: Decodable { } } - struct Axis: Decodable { + struct Axis: Decodable, Sendable { let visible: Bool? let color: String? let labelColor: String? diff --git a/resources/ios/Tests/NativePHPChartsCandlestickGeometryTests.swift b/resources/ios/Tests/NativePHPChartsCandlestickGeometryTests.swift index e6e6dbe..6376dca 100644 --- a/resources/ios/Tests/NativePHPChartsCandlestickGeometryTests.swift +++ b/resources/ios/Tests/NativePHPChartsCandlestickGeometryTests.swift @@ -20,7 +20,7 @@ final class NativePHPChartsCandlestickGeometryTests: XCTestCase { XCTAssertEqual(geometry.cornerRadius, 7) } - func testGeometryUsesTheSameDefaultBodyRatioAsRenderingAndRejectsIncompleteOHLC() throws { + func testGeometryUsesTheSameDefaultBodyWidthAsRenderingAndRejectsIncompleteOHLC() throws { let complete = makePoint(open: 12, high: 14, low: 8, close: 10) let incomplete = makePoint(open: 12, high: nil, low: 8, close: 10) @@ -33,7 +33,7 @@ final class NativePHPChartsCandlestickGeometryTests: XCTestCase { ) XCTAssertEqual(geometry.bodyBounds, 10...12) - XCTAssertEqual(geometry.bodyWidth, .ratio(0.62)) + XCTAssertEqual(geometry.bodyWidth, .fixed(12)) XCTAssertNil( NativePHPChartsCandlestickGeometry( point: incomplete, diff --git a/resources/ios/Tests/NativePHPChartsContractStabilityTests.swift b/resources/ios/Tests/NativePHPChartsContractStabilityTests.swift new file mode 100644 index 0000000..ae46cbc --- /dev/null +++ b/resources/ios/Tests/NativePHPChartsContractStabilityTests.swift @@ -0,0 +1,101 @@ +import Foundation +import Testing +@testable import NativePHPChartsRendererCompileHarness + +struct NativePHPChartsContractStabilityTests { + @Test("Cartesian rejects unsupported contract versions") + func cartesianContractVersion() { + let snapshot = NativePHPChartsSnapshot( + input: .testing(contractVersion: 2, seriesJSON: "[]"), + kind: .line + ) + + #expect(snapshot.availability == .unsupportedContract) + #expect(snapshot.data.isEmpty) + } + + @Test("Cartesian distinguishes malformed payloads from empty data") + func cartesianMalformedVersusEmpty() { + let empty = NativePHPChartsSnapshot(input: .testing(seriesJSON: "[]"), kind: .line) + let malformed = NativePHPChartsSnapshot(input: .testing(seriesJSON: "{"), kind: .line) + + #expect(empty.availability == .available) + #expect(empty.data.isEmpty) + #expect(malformed.availability == .invalidPayload) + } + + @Test("Radial rejects an entire snapshot when one segment is invalid") + func radialWholeSnapshotRejection() { + let snapshot = NativePHPChartsRadialSnapshot( + input: .testing(segmentsJSON: """ + [ + {"id":"ok","label":"OK","value":1,"color":"#000000"}, + {"id":"bad","label":"Bad","value":-1,"color":"#000000"} + ] + """), + kind: .pie + ) + + #expect(snapshot.availability == .invalidPayload) + #expect(snapshot.data.segments.isEmpty) + } + + @Test("Radar rejects misaligned series instead of rendering a partial polygon") + func radarWholeSnapshotRejection() { + let input = NativePHPChartsRadarWireInput( + axesJSON: """ + [{"id":"a","label":"A","maximum":10},{"id":"b","label":"B","maximum":10},{"id":"c","label":"C","maximum":10}] + """, + seriesJSON: """ + [{"id":"s","name":"S","color":"#000000","values":[{"axis":"a","value":1},{"axis":"wrong","value":2},{"axis":"c","value":3}]}] + """ + ) + + let snapshot = NativePHPChartsRadarSnapshot(input: input) + #expect(snapshot.availability == .invalidPayload) + #expect(snapshot.selections.isEmpty) + } + + @Test("Explicit point identity survives reordering and disappears on deletion") + func cartesianSelectionMutation() throws { + let first = NativePHPChartsSnapshot(input: .testing(seriesJSON: series(points: [("a", 1), ("b", 2)])), kind: .line) + let selectionID = try #require(first.data.points.last).selectionID + let reordered = NativePHPChartsSnapshot(input: .testing(seriesJSON: series(points: [("b", 3), ("a", 4)])), kind: .line) + let removed = NativePHPChartsSnapshot(input: .testing(seriesJSON: series(points: [("a", 4)])), kind: .line) + + #expect(reordered.data.point(selectionID: selectionID)?.id == "b") + #expect(removed.data.point(selectionID: selectionID) == nil) + } + + @Test("Radial selection identity survives updates and clears after removal") + func radialSelectionMutation() { + let updated = NativePHPChartsRadialSnapshot(input: .testing(segmentsJSON: """ + [{"id":"b","label":"B","value":8},{"id":"a","label":"A","value":1}] + """), kind: .donut) + let removed = NativePHPChartsRadialSnapshot(input: .testing(segmentsJSON: """ + [{"id":"a","label":"A","value":1}] + """), kind: .donut) + + #expect(updated.data.segment(id: "b")?.value == 8) + #expect(removed.data.segment(id: "b") == nil) + } + + @Test("Missing explicit colors safely fall back when a supplied palette is empty") + func emptyPaletteFallback() throws { + let input = NativePHPChartsWireInput.testing(seriesJSON: series(points: [("a", 1)])) + let configuration = NativePHPChartsConfiguration.decode(input, kind: .line) + let formatter = NativePHPChartsFormatter(input: input, configuration: configuration) + let cartesian = NativePHPChartsDataSet.decode(seriesJSON: series(points: [("a", 1)]), xAxis: configuration.xAxis, formatter: formatter, palette: []) + let radial = NativePHPChartsRadialDataSet.decode(""" + [{"id":"a","label":"A","value":1}] + """, palette: []) + + #expect(try #require(cartesian.series.first).colorValue.isEmpty == false) + #expect(try #require(radial.segments.first).colorValue.isEmpty == false) + } + + private func series(points: [(String, Double)]) -> String { + let encoded = points.map { "{\"id\":\"\($0.0)\",\"label\":\"\($0.0)\",\"value\":\($0.1),\"x\":\"\($0.0)\"}" }.joined(separator: ",") + return "[{\"id\":\"s\",\"name\":\"Series\",\"points\":[\(encoded)]}]" + } +} diff --git a/resources/ios/Tests/NativePHPChartsNewChartContractTests.swift b/resources/ios/Tests/NativePHPChartsNewChartContractTests.swift new file mode 100644 index 0000000..65514ba --- /dev/null +++ b/resources/ios/Tests/NativePHPChartsNewChartContractTests.swift @@ -0,0 +1,73 @@ +import Foundation +import Testing +@testable import NativePHPChartsRendererCompileHarness + +struct NativePHPChartsNewChartContractTests { + @Test("Progress requires stable ids and values in the unit interval") + func progressValidation() throws { + let valid = NativePHPChartsProgressSnapshot(input: .testing(metricsJSON: """ + [{"id":"delivery","label":"Delivery","value":0.75,"color":"#22C55E"}] + """)) + let invalid = NativePHPChartsProgressSnapshot(input: .testing(metricsJSON: """ + [{"id":"delivery","label":"Delivery","value":1.2}] + """)) + + #expect(valid.availability == .available) + #expect(try #require(valid.metrics.first).id == "delivery") + #expect(invalid.availability == .invalidPayload) + } + + @Test("Contribution heatmap validates dates, ids, values, and source order") + func heatmapValidation() throws { + let snapshot = NativePHPChartsContributionSnapshot(input: .testing(valuesJSON: """ + [ + {"id":"day-1","date":"2026-03-01","value":2,"label":"Two"}, + {"id":"day-2","date":"2026-03-02","value":4} + ] + """)) + + #expect(snapshot.availability == .available) + #expect(snapshot.values.map(\.id) == ["day-1", "day-2"]) + #expect(snapshot.values.map(\.sourceIndex) == [0, 1]) + } + + @Test("New chart callbacks retain the PointSelection v1 wire shape", arguments: [ + ("progress", "delivery", "delivery", "Delivery", 0.75), + ("contribution_heatmap", "day-1", "day-1", "2026-03-01", 2.0), + ]) + func selectionPayload(_ chartType: String, _ seriesID: String, _ pointID: String, _ label: String, _ value: Double) throws { + let json = try #require(NativePHPChartsSelectionPayload( + chartType: chartType, + seriesID: seriesID, + seriesName: seriesID, + pointID: pointID, + pointIndex: 0, + xType: "category", + x: .string(pointID), + label: label, + value: value, + localizedValue: String(value) + ).json()) + let object = try #require(JSONSerialization.jsonObject(with: Data(json.utf8)) as? [String: Any]) + + #expect(object["version"] as? Int == 1) + #expect(object["chart_type"] as? String == chartType) + #expect(object["point_id"] as? String == pointID) + } + + @Test("Progress payload repeats stable metric identity and presentation label") + func progressSelectionSemantics() throws { + let snapshot = NativePHPChartsProgressSnapshot(input: .testing(metricsJSON: """ + [{"id":"delivery","label":"Delivery","value":0.75}] + """)) + let metric = try #require(snapshot.metrics.first) + let json = try #require(NativePHPChartsProgressSelection.payload(metric: metric).json()) + let object = try #require(JSONSerialization.jsonObject(with: Data(json.utf8)) as? [String: Any]) + + #expect(object["series_id"] as? String == "delivery") + #expect(object["point_id"] as? String == "delivery") + #expect(object["series_name"] as? String == "Delivery") + #expect(object["x"] as? String == "Delivery") + #expect(object["label"] as? String == "Delivery") + } +} diff --git a/resources/ios/Tests/NativePHPChartsSharedFixtureTests.swift b/resources/ios/Tests/NativePHPChartsSharedFixtureTests.swift new file mode 100644 index 0000000..eaae1a2 --- /dev/null +++ b/resources/ios/Tests/NativePHPChartsSharedFixtureTests.swift @@ -0,0 +1,81 @@ +import Foundation +import Testing +@testable import NativePHPChartsRendererCompileHarness + +struct NativePHPChartsSharedFixtureTests { + @Test("Swift accepts the shared valid v1 fixture with an omitted color") + func validV1() throws { + let item = try #require(try fixtures()["valid_v1"] as? [String: Any]) + let version = try #require(item["contract_version"] as? Int) + let json = try #require(item["series_json"] as? String) + let snapshot = NativePHPChartsSnapshot(input: .testing(contractVersion: version, seriesJSON: json), kind: .line) + + #expect(snapshot.availability == .available) + #expect(try #require(snapshot.data.series.first).colorValue.isEmpty == false) + } + + @Test("Swift rejects the shared unsupported and corrupt fixtures") + func rejectionFixtures() throws { + let fixtures = try fixtures() + let unsupported = try #require(fixtures["unsupported_version"] as? [String: Any]) + let corrupt = try #require(fixtures["corrupt_json"] as? [String: Any]) + + let unsupportedSnapshot = NativePHPChartsSnapshot( + input: .testing(contractVersion: try #require(unsupported["contract_version"] as? Int), seriesJSON: "[]"), + kind: .line + ) + let corruptSnapshot = NativePHPChartsSnapshot( + input: .testing(contractVersion: try #require(corrupt["contract_version"] as? Int), seriesJSON: try #require(corrupt["series_json"] as? String)), + kind: .line + ) + + #expect(unsupportedSnapshot.availability == .unsupportedContract) + #expect(corruptSnapshot.availability == .invalidPayload) + } + + @Test("Swift progress selection equals the shared fixture") + func progressSelection() throws { + let fixture = try #require(try fixtures()["progress_selection"] as? [String: Any]) + let input = try #require(fixture["input"] as? [String: Any]) + let metric = NativePHPChartsProgressMetric( + id: try #require(input["id"] as? String), + label: try #require(input["label"] as? String), + value: try #require(input["value"] as? Double), + sourceIndex: try #require(input["index"] as? Int) + ) + + try expectJSON(NativePHPChartsProgressSelection.payload(metric: metric).json(), equals: fixture["expected"]) + } + + @Test("Swift heatmap selection equals the shared fixture") + func heatmapSelection() throws { + let fixture = try #require(try fixtures()["heatmap_selection"] as? [String: Any]) + let input = try #require(fixture["input"] as? [String: Any]) + let value = NativePHPChartsContributionValue( + id: try #require(input["id"] as? String), + date: try #require(input["date"] as? String), + value: try #require(input["value"] as? Double), + label: try #require(input["label"] as? String), + sourceIndex: try #require(input["index"] as? Int) + ) + + try expectJSON(NativePHPChartsContributionSelection.payload(value: value).json(), equals: fixture["expected"]) + } + + private func fixtures() throws -> [String: Any] { + let root = URL(fileURLWithPath: #filePath) + .deletingLastPathComponent() + .deletingLastPathComponent() + .deletingLastPathComponent() + .deletingLastPathComponent() + let data = try Data(contentsOf: root.appendingPathComponent("tests/Fixtures/chart_contract_fixtures.json")) + return try #require(JSONSerialization.jsonObject(with: data) as? [String: Any]) + } + + private func expectJSON(_ json: String?, equals expectedValue: Any?) throws { + let json = try #require(json) + let actual = try #require(JSONSerialization.jsonObject(with: Data(json.utf8)) as? NSDictionary) + let expected = try #require(expectedValue as? NSDictionary) + #expect(actual == expected) + } +} diff --git a/src/Components/ContributionHeatmap.php b/src/Components/ContributionHeatmap.php new file mode 100644 index 0000000..3b74de7 --- /dev/null +++ b/src/Components/ContributionHeatmap.php @@ -0,0 +1,15 @@ + true, + 'show_points' => true, + 'begin_at_zero' => false, + ]; + /** @param array $series */ public function series(array $series): static { diff --git a/src/Elements/ChartElement.php b/src/Elements/ChartElement.php index 5aff16c..9d19c9b 100644 --- a/src/Elements/ChartElement.php +++ b/src/Elements/ChartElement.php @@ -5,6 +5,7 @@ use Donmanueldev\NativephpCharts\Support\AxisNormalizer; use Donmanueldev\NativephpCharts\Support\CallbackExpression; use Donmanueldev\NativephpCharts\Support\ChartStyleNormalizer; +use Donmanueldev\NativephpCharts\Support\ChartThemeNormalizer; use Donmanueldev\NativephpCharts\Support\LegendNormalizer; use Donmanueldev\NativephpCharts\Support\WireEncoder; use InvalidArgumentException; @@ -17,7 +18,10 @@ abstract class ChartElement extends Element protected array $chartProps = [ 'animated' => true, 'empty_label' => 'No data', + 'error_label' => 'Chart unavailable', 'a11y_label' => 'Chart', + 'theme_mode' => 'system', + 'preset' => 'default', 'locale' => '', 'value_format' => 'number', 'currency_code' => '', @@ -87,6 +91,35 @@ public function emptyLabel(string $emptyLabel): static return $this; } + public function errorLabel(string $errorLabel): static + { + $this->chartProps['error_label'] = $this->requiredText($errorLabel, 'error label'); + $this->invalidateCommonWireSnapshot(); + + return $this; + } + + public function theme(string $theme): static + { + $theme = trim($theme); + if (! in_array($theme, ['light', 'dark', 'system'], true)) { + throw new InvalidArgumentException("The {$this->chartName()} theme must be light, dark, or system."); + } + $this->chartProps['theme_mode'] = $theme; + $this->invalidateCommonWireSnapshot(); + + return $this; + } + + public function preset(string $preset): static + { + ChartThemeNormalizer::resolve($preset, $this->chartName()); + $this->chartProps['preset'] = trim($preset); + $this->invalidateCommonWireSnapshot(); + + return $this; + } + public function a11yLabel(string $a11yLabel): static { $this->chartProps['a11y_label'] = $this->requiredText($a11yLabel, 'accessibility label'); @@ -160,7 +193,10 @@ protected function applyCommonAttributes(array $attrs): void { $this->applyBooleanAttributes($attrs, ['animated'], 'animated'); $this->applyStringAttributes($attrs, ['empty-label', 'emptyLabel'], 'emptyLabel'); + $this->applyStringAttributes($attrs, ['error-label', 'errorLabel'], 'errorLabel'); $this->applyStringAttributes($attrs, ['a11y-label', 'a11yLabel'], 'a11yLabel'); + $this->applyStringAttributes($attrs, ['theme'], 'theme'); + $this->applyStringAttributes($attrs, ['preset'], 'preset'); $this->applyStringAttributes($attrs, ['locale'], 'locale'); $this->applyStringAttributes($attrs, ['value-format', 'valueFormat'], 'valueFormat'); $this->applyStringAttributes($attrs, ['currency-code', 'currencyCode'], 'currencyCode'); @@ -321,6 +357,11 @@ private function commonWireSnapshot(): array return $this->commonWireSnapshot = [ ...$this->chartProps, 'contract_version' => 1, + 'theme_json' => WireEncoder::encode( + ChartThemeNormalizer::resolve((string) $this->chartProps['preset'], $this->chartName()), + $this->chartName(), + emptyAsObject: true, + ), 'style_json' => WireEncoder::encode($this->chartStyle, $this->chartName(), emptyAsObject: true), 'legend_json' => WireEncoder::encode($legend, $this->chartName()), ]; diff --git a/src/Elements/ContributionHeatmap.php b/src/Elements/ContributionHeatmap.php new file mode 100644 index 0000000..b3bae90 --- /dev/null +++ b/src/Elements/ContributionHeatmap.php @@ -0,0 +1,126 @@ +> */ + private array $values = []; + private string $endDate = ''; + private int $days = 365; + private int $weekStartsOn = 1; + /** @var list */ + private array $colors = ['#DBEAFE', '#93C5FD', '#3B82F6', '#1D4ED8']; + private string $emptyColor = '#E2E8F0'; + private bool $showMonthLabels = true; + private bool $showWeekdayLabels = true; + + public function applyAttributes(array $attrs): void + { + $this->applyCommonAttributes($attrs); + $this->applyArrayAttributes($attrs, ['values'], 'values'); + $this->applyStringAttributes($attrs, ['end-date', 'endDate'], 'endDate'); + $this->applyIntegerAttributes($attrs, ['days'], 'days'); + $this->applyIntegerAttributes($attrs, ['week-starts-on', 'weekStartsOn'], 'weekStartsOn'); + $this->applyArrayAttributes($attrs, ['colors'], 'colors'); + $this->applyStringAttributes($attrs, ['empty-color', 'emptyColor'], 'emptyColor'); + $this->applyBooleanAttributes($attrs, ['show-month-labels', 'showMonthLabels'], 'showMonthLabels'); + $this->applyBooleanAttributes($attrs, ['show-weekday-labels', 'showWeekdayLabels'], 'showWeekdayLabels'); + } + + public function values(array $values): static + { + $this->values = ContributionNormalizer::normalize($values); + + return $this; + } + + public function endDate(string $date): static + { + $this->endDate = ContributionNormalizer::date($date, 'end date'); + + return $this; + } + + public function days(int $days): static + { + if ($days < 7 || $days > 371) { + throw new InvalidArgumentException('The contribution heatmap days must be between 7 and 371.'); + } + $this->days = $days; + + return $this; + } + + public function weekStartsOn(int $day): static + { + if ($day < 0 || $day > 6) { + throw new InvalidArgumentException('The contribution heatmap week start must be between 0 and 6.'); + } + $this->weekStartsOn = $day; + + return $this; + } + + public function colors(array $colors): static + { + if (! array_is_list($colors) || count($colors) < 2 || count($colors) > 9) { + throw new InvalidArgumentException('The contribution heatmap colors must be a list of 2 to 9 colors.'); + } + $this->colors = array_map( + fn (mixed $color): string => ColorNormalizer::normalize($color, $this->chartName(), 'color scale'), + $colors, + ); + + return $this; + } + + public function emptyColor(string $color): static + { + $this->emptyColor = ColorNormalizer::normalize($color, $this->chartName(), 'empty color'); + + return $this; + } + + public function showMonthLabels(bool $show): static + { + $this->showMonthLabels = $show; + + return $this; + } + + public function showWeekdayLabels(bool $show): static + { + $this->showWeekdayLabels = $show; + + return $this; + } + + protected function chartType(): string + { + return 'contribution_heatmap'; + } + + protected function resolveProps(CallbackRegistry $registry): array + { + return [ + ...$this->resolveCommonProps($registry), + 'values_json' => WireEncoder::encode($this->values, $this->chartName()), + 'end_date' => $this->endDate, + 'days' => $this->days, + 'week_starts_on' => $this->weekStartsOn, + 'colors_json' => WireEncoder::encode($this->colors, $this->chartName()), + 'empty_color' => $this->emptyColor, + 'show_month_labels' => $this->showMonthLabels, + 'show_weekday_labels' => $this->showWeekdayLabels, + ]; + } +} diff --git a/src/Elements/ProgressChart.php b/src/Elements/ProgressChart.php new file mode 100644 index 0000000..d767370 --- /dev/null +++ b/src/Elements/ProgressChart.php @@ -0,0 +1,58 @@ +> */ + private array $metrics = []; + + private string $centerLabel = ''; + + public function applyAttributes(array $attrs): void + { + $this->applyCommonAttributes($attrs); + $this->applyArrayAttributes($attrs, ['metrics'], 'metrics'); + $this->applyStringAttributes($attrs, ['center-label', 'centerLabel'], 'centerLabel'); + } + + public function metrics(array $metrics): static + { + $this->metrics = ProgressMetricNormalizer::normalize($metrics); + $this->invalidateCommonWireSnapshot(); + + return $this; + } + + public function centerLabel(string $label): static + { + $this->centerLabel = trim($label); + + return $this; + } + + protected function chartType(): string + { + return 'progress'; + } + + protected function resolveProps(CallbackRegistry $registry): array + { + return [ + ...$this->resolveCommonProps($registry), + 'metrics_json' => WireEncoder::encode($this->metrics, $this->chartName()), + 'center_label' => $this->centerLabel, + ]; + } + + protected function legendItemCount(): int + { + return count($this->metrics); + } +} diff --git a/src/Elements/RadialChart.php b/src/Elements/RadialChart.php index 8471982..1120993 100644 --- a/src/Elements/RadialChart.php +++ b/src/Elements/RadialChart.php @@ -8,7 +8,7 @@ abstract class RadialChart extends ChartElement { - /** @var list */ + /** @var list */ protected array $segments = []; protected float $innerRadiusRatio = 0.0; diff --git a/src/NativePHPChartsServiceProvider.php b/src/NativePHPChartsServiceProvider.php index 39198b6..d933bc1 100644 --- a/src/NativePHPChartsServiceProvider.php +++ b/src/NativePHPChartsServiceProvider.php @@ -8,11 +8,13 @@ class NativePHPChartsServiceProvider extends ServiceProvider { public function register(): void { - // + $this->mergeConfigFrom(__DIR__.'/../config/nativephp-charts.php', 'nativephp-charts'); } public function boot(): void { - // + $this->publishes([ + __DIR__.'/../config/nativephp-charts.php' => config_path('nativephp-charts.php'), + ], 'nativephp-charts-config'); } } diff --git a/src/PointSelection.php b/src/PointSelection.php index 2b1a6cd..a315ab7 100644 --- a/src/PointSelection.php +++ b/src/PointSelection.php @@ -73,7 +73,7 @@ public static function fromJson(string $json): self } $chartType = self::string($payload, 'chart_type'); - if (! in_array($chartType, ['line', 'area', 'bar', 'scatter', 'pie', 'donut', 'radar', 'candlestick'], true)) { + if (! in_array($chartType, ['line', 'area', 'bar', 'scatter', 'pie', 'donut', 'radar', 'candlestick', 'progress', 'contribution_heatmap'], true)) { throw new InvalidArgumentException("The point selection chart type '{$chartType}' is not supported."); } @@ -120,6 +120,14 @@ public static function fromJson(string $json): self } } + if ($chartType === 'progress' && ($xType !== 'category' || $seriesId !== $pointId || $seriesName !== $x || $seriesName !== $label)) { + throw new InvalidArgumentException('A progress selection must use its metric id and label consistently.'); + } + + if ($chartType === 'contribution_heatmap' && ($xType !== 'date' || $seriesId !== $pointId || $seriesName !== $label)) { + throw new InvalidArgumentException('A contribution heatmap selection must use its day id, label, and date consistently.'); + } + return new self( version: $version, chartType: $chartType, diff --git a/src/Support/ChartDataNormalizer.php b/src/Support/ChartDataNormalizer.php index 25a14ad..13f01ea 100644 --- a/src/Support/ChartDataNormalizer.php +++ b/src/Support/ChartDataNormalizer.php @@ -65,12 +65,6 @@ public static function normalize( $seriesIds[$id] = true; $name = self::requiredString($item, 'name', "series '{$id}'", $chartName); - $color = ColorNormalizer::normalize( - self::requiredString($item, 'color', "series '{$id}'", $chartName), - $chartName, - "series '{$id}'", - ); - if (! array_key_exists('points', $item) || ! is_array($item['points'])) { throw new InvalidArgumentException("The {$chartName} points for series '{$id}' must be an array."); } @@ -100,7 +94,10 @@ public static function normalize( $points[] = $normalizedPoint; } - $normalizedSeries = ['id' => $id, 'name' => $name, 'color' => $color, 'points' => $points]; + $normalizedSeries = ['id' => $id, 'name' => $name, 'points' => $points]; + if (array_key_exists('color', $item)) { + $normalizedSeries['color'] = ColorNormalizer::normalize($item['color'], $chartName, "series '{$id}'"); + } if (array_key_exists('style', $item)) { if (! is_array($item['style'])) { throw new InvalidArgumentException("The {$chartName} style for series '{$id}' must be an array."); diff --git a/src/Support/ChartStyleNormalizer.php b/src/Support/ChartStyleNormalizer.php index 076be79..63aa154 100644 --- a/src/Support/ChartStyleNormalizer.php +++ b/src/Support/ChartStyleNormalizer.php @@ -16,7 +16,7 @@ final class ChartStyleNormalizer * Normalize only the style sections supported by the selected chart type. * * Possible canonical output sections are `line`, `area`, `bar`, `candlestick`, - * `segment`, `points`, `grid`, and `axis`; the selected chart family determines + * `segment`, `ring`, `cell`, `points`, `grid`, and `axis`; the selected chart family determines * which subset is legal. * * Empty or omitted sections stay absent, allowing native defaults to apply. Radar @@ -35,6 +35,8 @@ public static function normalize(array $style, string $chartType, string $chartN 'bar' => ['radius', 'corner_radius', 'cornerRadius', 'width'], 'candlestick' => ['rising_color', 'risingColor', 'falling_color', 'fallingColor', 'neutral_color', 'neutralColor', 'wick_width', 'wickWidth'], 'segment' => ['gap', 'corner_radius', 'cornerRadius', 'opacity'], + 'ring' => ['track_color', 'trackColor', 'width', 'gap', 'cap'], + 'cell' => ['size', 'gap', 'corner_radius', 'cornerRadius'], 'points' => ['visible', 'color', 'size'], 'grid' => ['visible', 'color', 'width'], 'axis' => ['visible', 'color', 'label_color', 'labelColor', 'font', 'font_size', 'fontSize', 'label_count', 'labelCount'], @@ -47,6 +49,8 @@ public static function normalize(array $style, string $chartType, string $chartN 'candlestick' => ['bar', 'candlestick', 'grid', 'axis'], 'radar' => ['line', 'area', 'points', 'grid', 'axis'], 'pie', 'donut' => ['segment'], + 'progress' => ['ring'], + 'contribution_heatmap' => ['cell', 'axis'], default => throw new InvalidArgumentException("The chart type '{$chartType}' is not supported."), }; @@ -70,6 +74,8 @@ public static function normalize(array $style, string $chartType, string $chartN 'bar' => self::bar($values, $chartName), 'candlestick' => self::candlestick($values, $chartName), 'segment' => self::segment($values, $chartName), + 'ring' => self::ring($values, $chartName), + 'cell' => self::cell($values, $chartName), 'points' => self::points($values, $chartName), 'grid' => self::grid($values, $chartName), 'axis' => self::axis($values, $chartName), @@ -172,6 +178,46 @@ private static function segment(array $style, string $chartName): array return $normalized; } + private static function ring(array $style, string $chartName): array + { + $normalized = []; + $trackColor = $style['track_color'] ?? $style['trackColor'] ?? null; + if ($trackColor !== null) { + $normalized['track_color'] = self::color($trackColor, $chartName, 'ring.trackColor'); + } + if (array_key_exists('width', $style)) { + $normalized['width'] = self::positiveNumber($style['width'], $chartName, 'ring.width', 64.0); + } + if (array_key_exists('gap', $style)) { + $normalized['gap'] = self::numberInRange($style['gap'], $chartName, 'ring.gap', 0, 32); + } + if (array_key_exists('cap', $style)) { + if (! is_string($style['cap']) || ! in_array($style['cap'], ['round', 'butt'], true)) { + throw new InvalidArgumentException("The {$chartName} style ring.cap must be round or butt."); + } + $normalized['cap'] = $style['cap']; + } + + return $normalized; + } + + private static function cell(array $style, string $chartName): array + { + $normalized = []; + if (array_key_exists('size', $style)) { + $normalized['size'] = self::positiveNumber($style['size'], $chartName, 'cell.size', 64.0); + } + if (array_key_exists('gap', $style)) { + $normalized['gap'] = self::numberInRange($style['gap'], $chartName, 'cell.gap', 0, 16); + } + $cornerRadius = $style['corner_radius'] ?? $style['cornerRadius'] ?? null; + if ($cornerRadius !== null) { + $normalized['corner_radius'] = self::numberInRange($cornerRadius, $chartName, 'cell.cornerRadius', 0, 16); + } + + return $normalized; + } + private static function candlestick(array $style, string $chartName): array { $normalized = []; diff --git a/src/Support/ChartThemeNormalizer.php b/src/Support/ChartThemeNormalizer.php new file mode 100644 index 0000000..ffeece5 --- /dev/null +++ b/src/Support/ChartThemeNormalizer.php @@ -0,0 +1,113 @@ + */ + private const COLOR_KEYS = ['background', 'foreground', 'muted', 'grid', 'track', 'error']; + + /** @return array{light: array, dark: array} */ + public static function resolve(string $preset, string $chartName): array + { + $preset = trim($preset); + if ($preset === '') { + throw new InvalidArgumentException("The {$chartName} preset must be a non-empty string."); + } + + $builtIns = self::builtIns(); + $application = []; + if (function_exists('app')) { + $app = app(); + if (is_object($app) && method_exists($app, 'bound') && $app->bound('config')) { + $application = config('nativephp-charts.presets', []); + } + } + if (! is_array($application)) { + throw new InvalidArgumentException('The nativephp-charts preset registry must be an array.'); + } + + if (! array_key_exists($preset, $builtIns) && ! array_key_exists($preset, $application)) { + throw new InvalidArgumentException("The {$chartName} preset '{$preset}' is not registered."); + } + + $base = $builtIns[$preset] ?? $builtIns['default']; + $override = $application[$preset] ?? []; + if (! is_array($override)) { + throw new InvalidArgumentException("The {$chartName} preset '{$preset}' must be an array."); + } + + $resolved = $base; + foreach (['light', 'dark'] as $appearance) { + if (array_key_exists($appearance, $override)) { + if (! is_array($override[$appearance])) { + throw new InvalidArgumentException("The {$chartName} preset '{$preset}.{$appearance}' must be an array."); + } + $resolved[$appearance] = array_replace($base[$appearance], $override[$appearance]); + } + } + + return [ + 'light' => self::appearance($resolved['light'] ?? null, $chartName, $preset, 'light'), + 'dark' => self::appearance($resolved['dark'] ?? null, $chartName, $preset, 'dark'), + ]; + } + + /** @return array, dark: array}> */ + public static function builtIns(): array + { + return [ + 'default' => [ + 'light' => self::tokens('#FFFFFF', '#0F172A', '#64748B', '#E2E8F0', '#E2E8F0', '#DC2626', ['#2563EB', '#0F766E', '#7C3AED', '#EA580C', '#DB2777', '#0891B2']), + 'dark' => self::tokens('#0B1220', '#F8FAFC', '#94A3B8', '#1E293B', '#334155', '#F87171', ['#60A5FA', '#2DD4BF', '#A78BFA', '#FB923C', '#F472B6', '#22D3EE']), + ], + 'spectrum' => [ + 'light' => self::tokens('#FFFFFF', '#18181B', '#71717A', '#E4E4E7', '#E4E4E7', '#E11D48', ['#6366F1', '#06B6D4', '#10B981', '#F59E0B', '#F43F5E', '#A855F7']), + 'dark' => self::tokens('#09090B', '#FAFAFA', '#A1A1AA', '#27272A', '#3F3F46', '#FB7185', ['#818CF8', '#22D3EE', '#34D399', '#FBBF24', '#FB7185', '#C084FC']), + ], + 'contrast' => [ + 'light' => self::tokens('#FFFFFF', '#000000', '#3F3F46', '#71717A', '#D4D4D8', '#B91C1C', ['#0047AB', '#007A3D', '#6B21A8', '#B45309', '#BE123C', '#075985']), + 'dark' => self::tokens('#000000', '#FFFFFF', '#D4D4D8', '#A1A1AA', '#52525B', '#FCA5A5', ['#93C5FD', '#6EE7B7', '#D8B4FE', '#FCD34D', '#FDA4AF', '#67E8F9']), + ], + ]; + } + + /** @return array */ + private static function appearance(mixed $value, string $chartName, string $preset, string $appearance): array + { + if (! is_array($value) || array_is_list($value)) { + throw new InvalidArgumentException("The {$chartName} preset '{$preset}.{$appearance}' must be an object-shaped array."); + } + foreach ($value as $key => $_) { + if (! is_string($key) || (! in_array($key, self::COLOR_KEYS, true) && $key !== 'palette')) { + throw new InvalidArgumentException("The {$chartName} preset option '{$appearance}.{$key}' is not supported."); + } + } + + $normalized = []; + foreach (self::COLOR_KEYS as $key) { + if (! array_key_exists($key, $value)) { + throw new InvalidArgumentException("The {$chartName} preset '{$preset}.{$appearance}.{$key}' is required."); + } + $normalized[$key] = ColorNormalizer::normalize($value[$key], $chartName, "preset {$appearance}.{$key}"); + } + $palette = $value['palette'] ?? null; + if (! is_array($palette) || ! array_is_list($palette) || $palette === [] || count($palette) > 24) { + throw new InvalidArgumentException("The {$chartName} preset '{$preset}.{$appearance}.palette' must be a non-empty list of at most 24 colors."); + } + $normalized['palette'] = array_map( + fn (mixed $color): string => ColorNormalizer::normalize($color, $chartName, "preset {$appearance}.palette"), + $palette, + ); + + return $normalized; + } + + /** @param list $palette */ + private static function tokens(string $background, string $foreground, string $muted, string $grid, string $track, string $error, array $palette): array + { + return compact('background', 'foreground', 'muted', 'grid', 'track', 'error', 'palette'); + } +} diff --git a/src/Support/ContributionNormalizer.php b/src/Support/ContributionNormalizer.php new file mode 100644 index 0000000..e6ddef2 --- /dev/null +++ b/src/Support/ContributionNormalizer.php @@ -0,0 +1,85 @@ + $values + * @return list + */ + public static function normalize(array $values): array + { + if (! array_is_list($values)) { + throw new InvalidArgumentException('The contribution heatmap values must be an ordered list.'); + } + if (count($values) > 10_000) { + throw new InvalidArgumentException('The contribution heatmap supports at most 10,000 values.'); + } + + $normalized = []; + $ids = []; + $dates = []; + foreach ($values as $index => $item) { + if (! is_array($item)) { + throw new InvalidArgumentException("The contribution heatmap value at index {$index} must be an array."); + } + foreach ($item as $key => $_) { + if (! is_string($key) || ! in_array($key, ['id', 'date', 'value', 'label'], true)) { + throw new InvalidArgumentException("The contribution heatmap option '{$key}' at index {$index} is not supported."); + } + } + $id = self::text($item['id'] ?? null, "id at index {$index}"); + if (isset($ids[$id])) { + throw new InvalidArgumentException("The contribution heatmap id '{$id}' must be unique."); + } + $ids[$id] = true; + $date = self::date($item['date'] ?? null, "date at index {$index}"); + if (isset($dates[$date])) { + throw new InvalidArgumentException("The contribution heatmap date '{$date}' must be unique."); + } + $dates[$date] = true; + $value = $item['value'] ?? null; + if ((! is_int($value) && ! is_float($value)) || ! is_finite((float) $value) || $value < 0) { + throw new InvalidArgumentException("The contribution heatmap value at index {$index} must be a non-negative finite number."); + } + if (is_int($value) && $value > 9_007_199_254_740_991) { + throw new InvalidArgumentException("The contribution heatmap value at index {$index} must be within the exact cross-platform integer range."); + } + + $entry = ['id' => $id, 'date' => $date, 'value' => $value]; + if (array_key_exists('label', $item)) { + $entry['label'] = self::text($item['label'], "label at index {$index}"); + } + $normalized[] = $entry; + } + + usort($normalized, static fn (array $left, array $right): int => $left['date'] <=> $right['date']); + + return $normalized; + } + + public static function date(mixed $value, string $property): string + { + if (! is_string($value) || preg_match('/^\d{4}-\d{2}-\d{2}$/', $value) !== 1) { + throw new InvalidArgumentException("The contribution heatmap {$property} must be an ISO date (YYYY-MM-DD)."); + } + $date = DateTimeImmutable::createFromFormat('!Y-m-d', $value); + if ($date === false || $date->format('Y-m-d') !== $value) { + throw new InvalidArgumentException("The contribution heatmap {$property} must be a valid ISO date."); + } + + return $value; + } + + private static function text(mixed $value, string $property): string + { + if (! is_string($value) || trim($value) === '') { + throw new InvalidArgumentException("The contribution heatmap {$property} must be a non-empty string."); + } + + return trim($value); + } +} diff --git a/src/Support/ProgressMetricNormalizer.php b/src/Support/ProgressMetricNormalizer.php new file mode 100644 index 0000000..27ff7ac --- /dev/null +++ b/src/Support/ProgressMetricNormalizer.php @@ -0,0 +1,65 @@ + $metrics + * @return list + */ + public static function normalize(array $metrics): array + { + if (! array_is_list($metrics)) { + throw new InvalidArgumentException('The progress chart metrics must be an ordered list.'); + } + if (count($metrics) > 24) { + throw new InvalidArgumentException('The progress chart supports at most 24 metrics.'); + } + + $normalized = []; + $ids = []; + foreach ($metrics as $index => $metric) { + if (! is_array($metric)) { + throw new InvalidArgumentException("The progress chart metric at index {$index} must be an array."); + } + foreach ($metric as $key => $_) { + if (! is_string($key) || ! in_array($key, ['id', 'label', 'value', 'color'], true)) { + throw new InvalidArgumentException("The progress chart metric option '{$key}' at index {$index} is not supported."); + } + } + + $id = self::text($metric['id'] ?? null, "metric id at index {$index}"); + if (isset($ids[$id])) { + throw new InvalidArgumentException("The progress chart metric id '{$id}' must be unique."); + } + $ids[$id] = true; + $value = $metric['value'] ?? null; + if ((! is_int($value) && ! is_float($value)) || ! is_finite((float) $value) || $value < 0 || $value > 1) { + throw new InvalidArgumentException("The progress chart metric value at index {$index} must be between 0 and 1."); + } + + $item = [ + 'id' => $id, + 'label' => self::text($metric['label'] ?? null, "metric label at index {$index}"), + 'value' => (float) $value, + ]; + if (array_key_exists('color', $metric)) { + $item['color'] = ColorNormalizer::normalize($metric['color'], 'progress chart', "metric '{$id}'"); + } + $normalized[] = $item; + } + + return $normalized; + } + + private static function text(mixed $value, string $property): string + { + if (! is_string($value) || trim($value) === '') { + throw new InvalidArgumentException("The progress chart {$property} must be a non-empty string."); + } + + return trim($value); + } +} diff --git a/src/Support/RadarDataNormalizer.php b/src/Support/RadarDataNormalizer.php index 4405c35..a0af4e4 100644 --- a/src/Support/RadarDataNormalizer.php +++ b/src/Support/RadarDataNormalizer.php @@ -102,12 +102,16 @@ public static function series(array $series, array $axes): array throw new InvalidArgumentException("The radar chart series '{$id}' values must follow the declared axis order."); } - return [ + $normalized = [ 'id' => $id, 'name' => self::text($item['name'] ?? null, "series '{$id}' name"), - 'color' => ColorNormalizer::normalize($item['color'] ?? null, 'radar chart', "series '{$id}'"), 'values' => $normalizedValues, ]; + if (array_key_exists('color', $item)) { + $normalized['color'] = ColorNormalizer::normalize($item['color'], 'radar chart', "series '{$id}'"); + } + + return $normalized; }, $series, array_keys($series)); } diff --git a/src/Support/SegmentNormalizer.php b/src/Support/SegmentNormalizer.php index 841bf2e..4c81468 100644 --- a/src/Support/SegmentNormalizer.php +++ b/src/Support/SegmentNormalizer.php @@ -16,11 +16,11 @@ final class SegmentNormalizer private const int MAX_EXACT_INTEGER = 9_007_199_254_740_991; /** - * Each input segment requires `id`, `label`, `value`, and `color`; no other - * keys are accepted. + * Each input segment requires `id`, `label`, and `value`; `color` is optional + * and otherwise resolved from the semantic theme palette. * * @param array $segments - * @return list + * @return list * * @throws InvalidArgumentException When the ordered segment contract is violated. */ @@ -59,16 +59,15 @@ public static function normalize(array $segments, string $chartName): array } $hasPositiveValue = $hasPositiveValue || $value > 0; - $normalized[] = [ + $item = [ 'id' => $id, 'label' => self::requiredString($segment, 'label', $index, $chartName), 'value' => $value, - 'color' => ColorNormalizer::normalize( - self::requiredString($segment, 'color', $index, $chartName), - $chartName, - "segment '{$id}'", - ), ]; + if (array_key_exists('color', $segment)) { + $item['color'] = ColorNormalizer::normalize($segment['color'], $chartName, "segment '{$id}'"); + } + $normalized[] = $item; } if ($normalized !== [] && ! $hasPositiveValue) { diff --git a/src/Support/WirePayloadStore.php b/src/Support/WirePayloadStore.php index 38755ca..a29a8a6 100644 --- a/src/Support/WirePayloadStore.php +++ b/src/Support/WirePayloadStore.php @@ -17,6 +17,8 @@ final class WirePayloadStore private const RETAINED_PAYLOADS = 64; + private const MINIMUM_RETENTION_SECONDS = 600; + /** * Return the wire attributes for inline JSON or a file-backed payload. * @@ -102,8 +104,9 @@ private static function removeOldPayloads(string $directory, string $currentPath usort($paths, static fn (string $left, string $right): int => filemtime($right) <=> filemtime($left)); + $cutoff = time() - self::MINIMUM_RETENTION_SECONDS; foreach (array_slice($paths, self::RETAINED_PAYLOADS) as $path) { - if ($path !== $currentPath) { + if ($path !== $currentPath && filemtime($path) < $cutoff) { @unlink($path); } } diff --git a/tests/CandlestickChartTest.php b/tests/CandlestickChartTest.php index 7c7a3ff..cdcf243 100644 --- a/tests/CandlestickChartTest.php +++ b/tests/CandlestickChartTest.php @@ -35,7 +35,15 @@ 'close' => 36.84, 'error_min' => 36.68, 'error_max' => 36.91, - ]); + ])->and($props['begin_at_zero'])->toBeFalse(); +}); + +it('allows an explicit zero-based candlestick domain', function () { + $props = CandlestickChart::make() + ->beginAtZero(true) + ->toArray(new CallbackRegistry)['props']; + + expect($props['begin_at_zero'])->toBeTrue(); }); it('publishes neutral candlestick colors and wick width globally and per series', function () { diff --git a/tests/ChartPointSelectionTest.php b/tests/ChartPointSelectionTest.php index 8cb64e3..32caedf 100644 --- a/tests/ChartPointSelectionTest.php +++ b/tests/ChartPointSelectionTest.php @@ -168,3 +168,33 @@ 'different x label' => [['x' => 'Other'], 'series_name, x, and label'], 'different visible label' => [['label' => 'Other'], 'series_name, x, and label'], ]); + +it('preserves progress and contribution selection payloads in contract v1', function (array $payload) { + expect(PointSelection::fromJson(json_encode($payload, JSON_THROW_ON_ERROR))->toArray())->toBe($payload); +})->with([ + 'progress' => [[ + 'version' => 1, 'chart_type' => 'progress', 'series_id' => 'quality', + 'series_name' => 'Quality', 'point_id' => 'quality', 'point_index' => 0, + 'x_type' => 'category', 'x' => 'Quality', 'label' => 'Quality', + 'value' => .86, 'localized_value' => '86%', + ]], + 'contribution heatmap' => [[ + 'version' => 1, 'chart_type' => 'contribution_heatmap', 'series_id' => '2026-09-16', + 'series_name' => 'Four commits', 'point_id' => '2026-09-16', 'point_index' => 4, + 'x_type' => 'date', 'x' => '2026-09-16', 'label' => 'Four commits', + 'value' => 4, 'localized_value' => '4', + ]], +]); + +it('accepts the shared native selection fixtures without changing their version 1 shape', function () { + $fixtures = json_decode( + file_get_contents(__DIR__.'/../tests/Fixtures/chart_contract_fixtures.json'), + true, + flags: JSON_THROW_ON_ERROR, + ); + + foreach (['progress_selection', 'heatmap_selection'] as $key) { + $expected = $fixtures[$key]['expected']; + expect(PointSelection::fromJson(json_encode($expected, JSON_THROW_ON_ERROR))->toArray())->toBe($expected); + } +}); diff --git a/tests/ContributionHeatmapTest.php b/tests/ContributionHeatmapTest.php new file mode 100644 index 0000000..8808f9d --- /dev/null +++ b/tests/ContributionHeatmapTest.php @@ -0,0 +1,51 @@ +applyAttributes([ + 'values' => [ + ['id' => 'second', 'date' => '2026-09-16', 'value' => 4, 'label' => 'Four commits'], + ['id' => 'first', 'date' => '2026-09-15', 'value' => 0], + ], + 'end-date' => '2026-09-30', + 'days' => 180, + 'week-starts-on' => 0, + 'colors' => ['#DCFCE7', '#16A34A'], + 'empty-color' => '#F1F5F9', + 'show-month-labels' => false, + 'show-weekday-labels' => true, + 'style' => ['cell' => ['size' => 11, 'gap' => 2, 'cornerRadius' => 3]], + ]); + $props = $chart->toArray(new CallbackRegistry)['props']; + + expect(json_decode($props['values_json'], true, flags: JSON_THROW_ON_ERROR))->toBe([ + ['id' => 'first', 'date' => '2026-09-15', 'value' => 0], + ['id' => 'second', 'date' => '2026-09-16', 'value' => 4, 'label' => 'Four commits'], + ])->and($props)->toMatchArray([ + 'end_date' => '2026-09-30', + 'days' => 180, + 'week_starts_on' => 0, + 'empty_color' => '#F1F5F9', + 'show_month_labels' => false, + 'show_weekday_labels' => true, + ])->and($props['colors_json'])->toBe('["#DCFCE7","#16A34A"]') + ->and($props['style_json'])->toBe('{"cell":{"size":11,"gap":2,"corner_radius":3}}'); +}); + +it('rejects duplicate dates and invalid calendar dates', function () { + expect(fn () => ContributionHeatmap::make()->values([ + ['id' => 'one', 'date' => '2026-09-16', 'value' => 1], + ['id' => 'two', 'date' => '2026-09-16', 'value' => 2], + ]))->toThrow(InvalidArgumentException::class, "date '2026-09-16' must be unique") + ->and(fn () => ContributionHeatmap::make()->endDate('2026-02-30')) + ->toThrow(InvalidArgumentException::class, 'valid ISO date'); +}); + +it('exposes the self-closing contribution heatmap Blade component', function () { + $method = new ReflectionMethod(ContributionHeatmapComponent::class, 'elementType'); + expect($method->invoke(new ContributionHeatmapComponent))->toBe('contribution_heatmap'); +}); diff --git a/tests/DocumentationExamplesTest.php b/tests/DocumentationExamplesTest.php new file mode 100644 index 0000000..e3fc88a --- /dev/null +++ b/tests/DocumentationExamplesTest.php @@ -0,0 +1,31 @@ +toHaveCount(10); + foreach ($fixtures as $name => $fixture) { + expect($fixture)->toHaveKeys(['element', 'attributes']); + $element = $fixture['element']::make(); + $element->applyAttributes($fixture['attributes']); + $props = $element->toArray(new CallbackRegistry)['props']; + + expect($props['contract_version'])->toBe(1, "The {$name} fixture must emit contract v1.") + ->and($props['a11y_label'])->not->toBe('Chart', "The {$name} fixture needs a specific accessibility label."); + } +}); + +it('compiles all canonical Blade examples', function () { + $compiler = new BladeCompiler(new Filesystem, sys_get_temp_dir()); + $paths = glob(__DIR__.'/../docs/examples/*.blade.php') ?: []; + + expect($paths)->toHaveCount(10); + foreach ($paths as $path) { + $compiled = $compiler->compileString(file_get_contents($path)); + expect($compiled)->toContain('native:'); + } +}); diff --git a/tests/Fixtures/chart_contract_fixtures.json b/tests/Fixtures/chart_contract_fixtures.json new file mode 100644 index 0000000..d9fe12f --- /dev/null +++ b/tests/Fixtures/chart_contract_fixtures.json @@ -0,0 +1,60 @@ +{ + "valid_v1": { + "contract_version": 1, + "series_json": "[{\"id\":\"sales\",\"name\":\"Sales\",\"points\":[{\"id\":\"jan\",\"label\":\"Jan\",\"value\":12,\"source_index\":0}]}]" + }, + "unsupported_version": { + "contract_version": 2, + "expected_error": "unsupported_contract_version" + }, + "corrupt_json": { + "contract_version": 1, + "series_json": "[{", + "expected_error": "malformed_series_snapshot" + }, + "progress_selection": { + "input": { + "id": "completion", + "label": "Completion", + "index": 0, + "value": 0.75, + "localized_value": "75%" + }, + "expected": { + "version": 1, + "chart_type": "progress", + "series_id": "completion", + "series_name": "Completion", + "point_id": "completion", + "point_index": 0, + "x_type": "category", + "x": "Completion", + "label": "Completion", + "value": 0.75, + "localized_value": "75%" + } + }, + "heatmap_selection": { + "input": { + "id": "2026-01-02", + "label": "Jan 2", + "index": 1, + "date": "2026-01-02", + "value": 4, + "localized_value": "4" + }, + "expected": { + "version": 1, + "chart_type": "contribution_heatmap", + "series_id": "2026-01-02", + "series_name": "Jan 2", + "point_id": "2026-01-02", + "point_index": 1, + "x_type": "date", + "x": "2026-01-02", + "label": "Jan 2", + "value": 4, + "localized_value": "4" + } + } +} \ No newline at end of file diff --git a/tests/LineChartTest.php b/tests/LineChartTest.php index 85508bd..089b027 100644 --- a/tests/LineChartTest.php +++ b/tests/LineChartTest.php @@ -102,6 +102,15 @@ ->and($legend['visible'])->toBeTrue(); }); +it('allows the semantic theme palette to supply a missing series color', function () { + $props = LineChart::make()->series([[ + 'id' => 'revenue', 'name' => 'Revenue', + 'points' => [['id' => 'jan', 'label' => 'January', 'value' => 12]], + ]])->toArray(new CallbackRegistry)['props']; + + expect(json_decode($props['series_json'], true, flags: JSON_THROW_ON_ERROR)[0])->not->toHaveKey('color'); +}); + it('maps Blade attributes, axis options, legend style, and selection callback', function () { $registry = new CallbackRegistry; $chart = LineChart::make(); diff --git a/tests/PieChartTest.php b/tests/PieChartTest.php index be21933..8204847 100644 --- a/tests/PieChartTest.php +++ b/tests/PieChartTest.php @@ -10,13 +10,17 @@ expect($props)->toBe([ 'animated' => true, 'empty_label' => 'No data', + 'error_label' => 'Chart unavailable', 'a11y_label' => 'Chart', + 'theme_mode' => 'system', + 'preset' => 'default', 'locale' => '', 'value_format' => 'number', 'currency_code' => '', 'minimum_fraction_digits' => -1, 'maximum_fraction_digits' => -1, 'contract_version' => 1, + 'theme_json' => json_encode(Donmanueldev\NativephpCharts\Support\ChartThemeNormalizer::builtIns()['default'], JSON_THROW_ON_ERROR), 'style_json' => '{}', 'legend_json' => '{"visible":false,"position":"bottom","alignment":"center","style":{}}', 'on_select' => 0, @@ -69,6 +73,14 @@ expect($style)->toBe('{"segment":{"gap":12,"corner_radius":20,"opacity":0}}'); }); +it('allows the semantic theme palette to supply a missing segment color', function () { + $props = PieChart::make()->segments([ + ['id' => 'web', 'label' => 'Web', 'value' => 70], + ])->toArray(new CallbackRegistry)['props']; + + expect(json_decode($props['segments_json'], true, flags: JSON_THROW_ON_ERROR)[0])->not->toHaveKey('color'); +}); + it('rejects malformed segment collections', function (Closure $configure, string $message) { expect(fn () => $configure(PieChart::make()))->toThrow(InvalidArgumentException::class, $message); })->with([ diff --git a/tests/ProgressChartTest.php b/tests/ProgressChartTest.php new file mode 100644 index 0000000..366c892 --- /dev/null +++ b/tests/ProgressChartTest.php @@ -0,0 +1,52 @@ +applyAttributes([ + 'metrics' => [ + ['id' => ' shipped ', 'label' => ' Shipped ', 'value' => .75, 'color' => '#2563EB'], + ['id' => 'quality', 'label' => 'Quality', 'value' => 1], + ], + 'center-label' => '75%', + 'theme' => 'dark', + 'preset' => 'spectrum', + 'error-label' => 'Metrics unavailable', + 'style' => ['ring' => ['trackColor' => '#E2E8F0', 'width' => 12, 'gap' => 4, 'cap' => 'round']], + 'legend' => ['visible' => true], + '_select' => 'selectMetric', + ]); + $props = $chart->toArray($registry)['props']; + + expect(json_decode($props['metrics_json'], true, flags: JSON_THROW_ON_ERROR))->toBe([ + ['id' => 'shipped', 'label' => 'Shipped', 'value' => .75, 'color' => '#2563EB'], + ['id' => 'quality', 'label' => 'Quality', 'value' => 1], + ])->and($props)->toMatchArray([ + 'contract_version' => 1, + 'center_label' => '75%', + 'theme_mode' => 'dark', + 'preset' => 'spectrum', + 'error_label' => 'Metrics unavailable', + ])->and($props['style_json'])->toBe('{"ring":{"track_color":"#E2E8F0","width":12,"gap":4,"cap":"round"}}') + ->and($props['on_select'])->toBe($registry->lookup('selectMetric')); +}); + +it('rejects invalid progress metrics without replacing the last valid state', function () { + $chart = ProgressChart::make()->metrics([ + ['id' => 'one', 'label' => 'One', 'value' => .5], + ]); + $before = $chart->toArray(new CallbackRegistry)['props']; + + expect(fn () => $chart->metrics([['id' => 'one', 'label' => 'One', 'value' => 1.1]])) + ->toThrow(InvalidArgumentException::class, 'between 0 and 1') + ->and($chart->toArray(new CallbackRegistry)['props'])->toBe($before); +}); + +it('exposes the self-closing progress Blade component', function () { + $method = new ReflectionMethod(ProgressChartComponent::class, 'elementType'); + expect($method->invoke(new ProgressChartComponent))->toBe('progress_chart'); +}); diff --git a/tests/ThemeTest.php b/tests/ThemeTest.php new file mode 100644 index 0000000..55674e7 --- /dev/null +++ b/tests/ThemeTest.php @@ -0,0 +1,44 @@ +previousContainer = Container::getInstance(); + $container = new Container; + $container->instance('config', new Repository(['nativephp-charts' => ['presets' => []]])); + Container::setInstance($container); +}); + +afterEach(function () { + Container::setInstance($this->previousContainer); +}); + +it('merges an application preset over the semantic default', function () { + config()->set('nativephp-charts.presets.brand', [ + 'light' => ['background' => '#FAFAFA', 'palette' => ['#123456']], + 'dark' => ['background' => '#101010', 'palette' => ['#ABCDEF']], + ]); + + $props = LineChart::make()->preset('brand')->toArray(new CallbackRegistry)['props']; + $theme = json_decode($props['theme_json'], true, flags: JSON_THROW_ON_ERROR); + + expect($theme['light'])->toMatchArray([ + 'background' => '#FAFAFA', + 'foreground' => '#0F172A', + 'palette' => ['#123456'], + ])->and($theme['dark'])->toMatchArray([ + 'background' => '#101010', + 'foreground' => '#F8FAFC', + 'palette' => ['#ABCDEF'], + ]); +}); + +it('rejects unknown theme modes and presets', function () { + expect(fn () => LineChart::make()->theme('sepia')) + ->toThrow(InvalidArgumentException::class, 'light, dark, or system') + ->and(fn () => LineChart::make()->preset('missing')) + ->toThrow(InvalidArgumentException::class, 'not registered'); +}); diff --git a/tests/WirePayloadStoreTest.php b/tests/WirePayloadStoreTest.php new file mode 100644 index 0000000..b1e1a15 --- /dev/null +++ b/tests/WirePayloadStoreTest.php @@ -0,0 +1,56 @@ + $name) { + $path = "{$directory}/series-expired-{$name}.json"; + file_put_contents($path, '[]'); + touch($path, $now - 700 - $offset); + } + + $method = new ReflectionMethod(WirePayloadStore::class, 'removeOldPayloads'); + $method->invoke(null, $directory, "{$directory}/series-fresh-00.json"); + + expect(glob($directory.'/series-fresh-*.json'))->toHaveCount(65) + ->and(glob($directory.'/series-expired-*.json'))->toBe([]); + } finally { + foreach (glob($directory.'/*') ?: [] as $path) { + unlink($path); + } + rmdir($directory); + } +}); + +it('does not prune an expired cache while it remains within the retained limit', function () { + $directory = sys_get_temp_dir().'/nativephp-charts-retention-'.bin2hex(random_bytes(6)); + mkdir($directory, 0700, true); + + try { + for ($index = 0; $index < 64; $index++) { + $path = sprintf('%s/series-old-%02d.json', $directory, $index); + file_put_contents($path, '[]'); + touch($path, time() - 1_000 - $index); + } + + $method = new ReflectionMethod(WirePayloadStore::class, 'removeOldPayloads'); + $method->invoke(null, $directory, "{$directory}/series-old-00.json"); + + expect(glob($directory.'/series-old-*.json'))->toHaveCount(64); + } finally { + foreach (glob($directory.'/*') ?: [] as $path) { + unlink($path); + } + rmdir($directory); + } +});