{
+ test.each([
+ [0, '0'],
+ [1, '1'],
+ [999, '999'],
+ [1234, '1.2K'],
+ [1234567, '1.2M'],
+ [1234567890, '1.2B'],
+ ])('formats %s without confusing thousands and millions', (input, expected) => {
+ expect(formatDownloadCount(input, 'en')).toBe(expected)
+ })
+
+ test.each([
+ null,
+ undefined,
+ NaN,
+ Infinity,
+ -Infinity,
+ -1,
+ 1.5,
+ Number.MAX_SAFE_INTEGER + 1,
+ ])('keeps invalid or unavailable counts separate from zero: %s', (value) =>
+ expect(formatDownloadCount(value)).toBe('—'))
+
+ test('provides exact locale-aware counts for accessible card labels', () => {
+ expect(formatDownloadCount(1234567, 'en', false)).toBe('1,234,567')
+ expect(formatDownloadCount(1234567, 'de', false)).toBe('1.234.567')
+ expect(formatDownloadCount(1234567, 'zh-CN')).not.toBe(formatDownloadCount(1234567, 'en'))
+ })
+})
+
+describe('read-only download statistics', () => {
+ test('distinguishes a successful empty response from unavailable data', async () => {
+ const request = mock(async () => ({ data: { total: 0, versions: [] }, error: null }))
+ expect(await fetchDownloadStatistics(request)).toEqual({ status: 'ready', data: { total: 0, versions: [] } })
+ expect(request).toHaveBeenCalledTimes(1)
+ })
+
+ test('preserves universal and platform counts without local increments', async () => {
+ const request = mock(async () => ({ data: populated }))
+ expect(await fetchDownloadStatistics(request)).toEqual({ status: 'ready', data: populated })
+ expect(populated.total).toBe(1234567)
+ expect(request).toHaveBeenCalledTimes(1)
+ })
+
+ test('does not retry a failed request or substitute zero', async () => {
+ const request = mock(async () => {
+ throw new Error('offline')
+ })
+ expect(await fetchDownloadStatistics(request)).toEqual({ status: 'unavailable' })
+ expect(request).toHaveBeenCalledTimes(1)
+ })
+
+ test('honors an API error even if an old data object is supplied', async () => {
+ expect(await fetchDownloadStatistics(async () => ({ data: populated, error: { status: 503 } }))).toEqual({
+ status: 'unavailable',
+ })
+ })
+
+ test.each([
+ undefined,
+ null,
+ {},
+ [],
+ { total: 0 },
+ { total: -1, versions: [] },
+ { total: '0', versions: [] },
+ { total: Infinity, versions: [] },
+ { total: 0, versions: null },
+ { total: 0, versions: [null] },
+ { total: 0, versions: [{ version: '', total: 0, platforms: {} }] },
+ { total: 0, versions: [{ version: '1.0.0', total: 1.5, platforms: {} }] },
+ { total: 0, versions: [{ version: '1.0.0', total: 0, platforms: [] }] },
+ { total: 0, versions: [{ version: '1.0.0', total: 0, platforms: { universal: -1 } }] },
+ { total: 0, versions: [{ version: '1.0.0', total: 0, platforms: { universal: null } }] },
+ ])('rejects malformed statistics: %j', async (data) => {
+ expect(parseDownloadStatistics(data)).toBeNull()
+ expect(await fetchDownloadStatistics(async () => ({ data }))).toEqual({ status: 'unavailable' })
+ })
+
+ test('copies API data without mutating it or assigning special keys to the prototype', () => {
+ const input = JSON.parse('{"total":1,"versions":[{"version":"1.0.0","total":1,"platforms":{"__proto__":1}}]}')
+ const before = JSON.stringify(input)
+ const result = parseDownloadStatistics(input)
+ expect(result).not.toBe(input)
+ expect(JSON.stringify(input)).toBe(before)
+ expect(Object.hasOwn(result!.versions[0].platforms, '__proto__')).toBe(true)
+ expect(Object.getPrototypeOf(result!.versions[0].platforms)).toBe(Object.prototype)
+ })
+})
diff --git a/apps/website/vercel.json b/apps/website/vercel.json
new file mode 100644
index 0000000..7ba5c26
--- /dev/null
+++ b/apps/website/vercel.json
@@ -0,0 +1,5 @@
+{
+ "$schema": "https://openapi.vercel.sh/vercel.json",
+ "framework": "sveltekit",
+ "outputDirectory": null
+}
diff --git a/deploy/tabularis/README.md b/deploy/tabularis/README.md
new file mode 100644
index 0000000..48d87c6
--- /dev/null
+++ b/deploy/tabularis/README.md
@@ -0,0 +1,22 @@
+# Tabularis registry follow-ups
+
+## Connection field presentation (Tabularis PR #629)
+
+`connection-fields.json` is an **additive operator extension delta**, copied from the host manifest contract at Tabularis commit `d7cb7288a6c7fe6656491ca46ae70fa42924de6e`. It describes presentation metadata only, never credentials or secret values. It is not a new Tabularium core field.
+
+Operator rollout:
+
+1. Back up the current global manifest extensions and `driver` kind configuration.
+2. Merge the delta into the existing global extensions. If `driver` has its own nonempty override, merge it there as well: kind overrides **replace**, rather than extend, the global delta. Never replace the complete configuration with this small fragment.
+3. Preserve all existing required flags and unrelated driver metadata; do not modify or enable the `theme` kind.
+4. Check `/manifest.schema.json?kind=driver`, then use `/api/manifest/validate` to test a complete driver manifest with `connection_fields`. Verify that manifests without the optional field still work and that unknown field names, oversized strings and invalid types are rejected.
+5. Coordinate the supporting Tabularis runtime and the dependent BigQuery plugin release. Schema acceptance does not establish host/keychain compatibility. Do not publish the dependent plugin just because validation passes.
+6. Roll back by restoring the original operator configurations if validation regresses.
+
+The registry's strict authoring endpoint rejects unknown properties; lenient ingestion may strip them. Both are reasons to add the extension before depending on this metadata. Merely deploying this repository does **not** apply the operator delta.
+
+## Download statistics (Tabularis PR #793)
+
+The frontend follow-up shows compact locale-aware counts, exact accessible card labels, and distinct loading/empty/unavailable/populated states. It does not change counting APIs or perform tracked downloads. It can ship independently of theme-package support.
+
+Keep the theme rollout gated: packaged platform acceptance, real runtime/tooling version assignments, old-client/profile protection, staged kind admission, and published author journeys are still separate requirements. Neither this operator delta nor the statistics UI enables themes.
diff --git a/deploy/tabularis/connection-fields.json b/deploy/tabularis/connection-fields.json
new file mode 100644
index 0000000..3901288
--- /dev/null
+++ b/deploy/tabularis/connection-fields.json
@@ -0,0 +1,30 @@
+{
+ "connection_fields": {
+ "type": "object",
+ "description": "Optional presentation overrides for host-owned connection fields. Omitted fields keep the standard Tabularis behavior.",
+ "additionalProperties": false,
+ "patternProperties": {
+ "^(host|port|username|password|database)$": {
+ "type": "object",
+ "additionalProperties": false,
+ "properties": {
+ "hidden": {
+ "type": "boolean",
+ "default": false,
+ "description": "Hide this field for the driver."
+ },
+ "label": {
+ "type": "string",
+ "maxLength": 80,
+ "description": "Driver-specific label."
+ },
+ "placeholder": {
+ "type": "string",
+ "maxLength": 200,
+ "description": "Driver-specific input placeholder."
+ }
+ }
+ }
+ }
+ }
+}
diff --git a/scripts/check-vercel-cache.ts b/scripts/check-vercel-cache.ts
new file mode 100644
index 0000000..bbf2407
--- /dev/null
+++ b/scripts/check-vercel-cache.ts
@@ -0,0 +1,43 @@
+import assert from 'node:assert/strict'
+import { createHash } from 'node:crypto'
+import { mkdtemp, rm } from 'node:fs/promises'
+import { tmpdir } from 'node:os'
+import { resolve, join } from 'node:path'
+import { $ } from 'bun'
+
+const app = process.argv[2]
+assert(app === 'website' || app === 'docs', 'Expected website or docs')
+const root = resolve(import.meta.dir, '..')
+const output = join(root, 'apps', app, '.vercel/output')
+const cache = await mkdtemp(join(tmpdir(), 'tabularium-vercel-cache-'))
+const args = ['run', 'build', `--filter=@tabularium/${app}`, '--cache=local:rw', `--cache-dir=${cache}`]
+
+async function snapshot() {
+ assert.equal((await Bun.file(join(output, 'config.json')).json()).version, 3)
+ const files = []
+ for await (const file of new Bun.Glob('**/*').scan({ cwd: output, onlyFiles: true, followSymlinks: true })) {
+ const hash = createHash('sha256')
+ .update(await Bun.file(join(output, file)).bytes())
+ .digest('hex')
+ files.push(`${file}:${hash}`)
+ }
+ assert(files.length > 1, 'Expected deployment payloads, not only a config file')
+ return files.sort()
+}
+
+try {
+ await $`bunx turbo ${args}`.cwd(root)
+ const before = await snapshot()
+ await rm(output, { recursive: true, force: true })
+ await rm(join(root, 'apps', app, '.svelte-kit'), { recursive: true, force: true })
+ const plan = await $`bunx turbo ${args} --dry=json`.cwd(root).quiet().json()
+ assert.equal(
+ plan.tasks.find((task: { taskId: string }) => task.taskId === `@tabularium/${app}#build`)?.cache.status,
+ 'HIT',
+ )
+ await $`bunx turbo ${args}`.cwd(root)
+ assert.deepEqual(await snapshot(), before, 'Cached build must restore every Vercel output file')
+ console.log(`PASS: ${app} cache hit restored ${before.length} identical deployment files`)
+} finally {
+ await rm(cache, { recursive: true, force: true })
+}
diff --git a/turbo.json b/turbo.json
index 1ea665f..437fd8e 100644
--- a/turbo.json
+++ b/turbo.json
@@ -8,7 +8,7 @@
},
"build": {
"dependsOn": ["^build"],
- "outputs": ["dist/**"]
+ "outputs": ["dist/**", ".svelte-kit/**", ".vercel/output/**"]
},
"test": {
"outputs": [],