@supersoniks/concorde 4.6.0 → 4.7.3

package/docs/docs-mock-api-sw.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/docs/mock-api/urls.ts", "../src/docs/mock-api/api-config-mock.ts", "../src/docs/mock-api/fixtures.ts", "../src/docs/mock-api/router.ts", "../src/docs/mock-api/service-worker.ts"],
+  "sourcesContent": ["/** Base same-origin pour les d\u00E9mos doc (Service Worker + middleware Vite). */\nexport const DOCS_MOCK_API_BASE = \"/docs-mock-api\";\n\n/** Remplace https://reqres.in \u2014 chemins `api/users`, `api/users/2`, etc. */\nexport const DOCS_MOCK_REQRES_SERVICE = DOCS_MOCK_API_BASE;\n\n/** Remplace https://geo.api.gouv.fr/ \u2014 chemins `communes?\u2026`. */\nexport const DOCS_MOCK_GEO_SERVICE = `${DOCS_MOCK_API_BASE}/geo/`;\n\n/** Remplace https://v2.jokeapi.dev \u2014 chemins `joke/Any?\u2026`. */\nexport const DOCS_MOCK_JOKES_SERVICE = `${DOCS_MOCK_API_BASE}/jokes`;\n", "import { DOCS_MOCK_API_BASE } from \"./urls\";\n\n/** Bearer accept\u00E9 par GET /api/config/protected */\nexport const DOCS_MOCK_TOKEN_VALID = \"docs-mock-valid-token\";\n/** D\u00E9clenche HTTP 498 \u2192 renouvellement via tokenProvider */\nexport const DOCS_MOCK_TOKEN_STALE = \"docs-mock-stale-token\";\n/** \u00C9mis par GET /auth/token apr\u00E8s Basic auth ou eventsApiToken */\nexport const DOCS_MOCK_TOKEN_FRESH = \"docs-mock-fresh-token\";\n\nconst DOCS_MOCK_BASIC_USER = \"demo\";\nconst DOCS_MOCK_BASIC_PASSWORD = \"secret\";\n/** Valeur de l\u2019attribut anc\u00EAtre `eventsApiToken` (Bearer pour /auth/token) */\nexport const DOCS_MOCK_EVENTS_API_TOKEN = \"docs-mock-events-token\";\n\nconst WORDING_CATALOG: Record<string, Record<string, string>> = {\n  \"api-config.greeting\": { fr: \"Bonjour\", en: \"Hello\" },\n  \"api-config.farewell\": { fr: \"Au revoir\", en: \"Goodbye\" },\n  \"api-config.hint\": {\n    fr: \"Libell\u00E9s servis par le mock /wording/labels\",\n    en: \"Labels served by mock /wording/labels\",\n  },\n};\n\nfunction json(body: unknown, init: ResponseInit = {}): Response {\n  const headers = new Headers(init.headers);\n  headers.set(\"Content-Type\", \"application/json; charset=utf-8\");\n  headers.set(\"Access-Control-Allow-Origin\", \"*\");\n  headers.set(\"X-Docs-Mock-Api\", \"concorde-api-config\");\n  return new Response(JSON.stringify(body), { ...init, headers });\n}\n\ntype ParsedAuth =\n  | { kind: \"none\" }\n  | { kind: \"basic\"; user: string; password: string }\n  | { kind: \"bearer\"; token: string };\n\nfunction parseAuthorization(request: Request): ParsedAuth {\n  const header = request.headers.get(\"authorization\");\n  if (!header) return { kind: \"none\" };\n  const basic = header.match(/^Basic\\s+(.+)$/i);\n  if (basic) {\n    try {\n      const decoded = atob(basic[1]);\n      const sep = decoded.indexOf(\":\");\n      if (sep < 0) return { kind: \"none\" };\n      return {\n        kind: \"basic\",\n        user: decoded.slice(0, sep),\n        password: decoded.slice(sep + 1),\n      };\n    } catch {\n      return { kind: \"none\" };\n    }\n  }\n  const bearer = header.match(/^Bearer\\s+(.+)$/i);\n  if (bearer) return { kind: \"bearer\", token: bearer[1].trim() };\n  return { kind: \"none\" };\n}\n\nfunction isValidBasic(auth: ParsedAuth): boolean {\n  return (\n    auth.kind === \"basic\" &&\n    auth.user === DOCS_MOCK_BASIC_USER &&\n    auth.password === DOCS_MOCK_BASIC_PASSWORD\n  );\n}\n\nfunction wordingLabels(url: URL): Response {\n  const lang = url.searchParams.get(\"lang\") || \"fr\";\n  const labels = url.searchParams.getAll(\"labels[]\").length\n    ? url.searchParams.getAll(\"labels[]\")\n    : url.searchParams.getAll(\"labels\");\n  const result: Record<string, string> = {};\n  for (const key of labels) {\n    const entry = WORDING_CATALOG[key];\n    result[key] =\n      entry?.[lang] ?? entry?.en ?? `[missing:${key}]`;\n  }\n  return json({ lang, labels: result, ...result });\n}\n\n/**\n * Routes mock pour la page doc APIConfiguration (token, 498, wording).\n */\nexport function handleApiConfigMockRequest(\n  request: Request,\n  subPath: string,\n  method: string,\n): Response | null {\n  if (subPath === \"/auth/token\" && method === \"GET\") {\n    const auth = parseAuthorization(request);\n    if (isValidBasic(auth)) {\n      return json({\n        token: DOCS_MOCK_TOKEN_FRESH,\n        source: \"basic\",\n        serviceHost: new URL(request.url).searchParams.get(\"serviceHost\"),\n      });\n    }\n    if (\n      auth.kind === \"bearer\" &&\n      auth.token === DOCS_MOCK_EVENTS_API_TOKEN\n    ) {\n      return json({\n        token: DOCS_MOCK_TOKEN_FRESH,\n        source: \"eventsApiToken\",\n      });\n    }\n    return json({ error: \"Unauthorized\" }, { status: 401 });\n  }\n\n  if (subPath === \"/api/config/protected\" && method === \"GET\") {\n    const auth = parseAuthorization(request);\n    if (auth.kind === \"bearer\") {\n      if (auth.token === DOCS_MOCK_TOKEN_STALE) {\n        return json({ error: \"Token expired\", code: \"token_stale\" }, { status: 498 });\n      }\n      if (\n        auth.token === DOCS_MOCK_TOKEN_VALID ||\n        auth.token === DOCS_MOCK_TOKEN_FRESH\n      ) {\n        return json({\n          ok: true,\n          message: \"Protected resource\",\n          tokenUsed: auth.token,\n        });\n      }\n    }\n    if (isValidBasic(auth)) {\n      return json({\n        ok: true,\n        message: \"Protected resource (basic)\",\n        tokenUsed: null,\n      });\n    }\n    return json({ error: \"Unauthorized\" }, { status: 401 });\n  }\n\n  if (\n    (subPath === \"/wording/labels\" || subPath.startsWith(\"/wording/labels\")) &&\n    method === \"GET\"\n  ) {\n    return wordingLabels(new URL(request.url));\n  }\n\n  return null;\n}\n\nexport const API_CONFIG_MOCK_PATHS = [\n  `${DOCS_MOCK_API_BASE}/auth/token`,\n  `${DOCS_MOCK_API_BASE}/api/config/protected`,\n  `${DOCS_MOCK_API_BASE}/wording/labels`,\n] as const;\n", "/** Donn\u00E9es type ReqRes pour les d\u00E9mos doc (sans appel externe). */\n\nexport type ReqresUser = {\n  id: number;\n  email: string;\n  first_name: string;\n  last_name: string;\n  avatar: string;\n};\n\nconst reqresAvatar = (seed: string) =>\n  `https://i.pravatar.cc/150?u=${encodeURIComponent(seed)}`;\n\nconst REQRES_EXTRA_NAMES: [string, string][] = [\n  [\"Michael\", \"Lawson\"],\n  [\"Tobias\", \"Funke\"],\n  [\"Lindsay\", \"Funke\"],\n  [\"Maeby\", \"Funke\"],\n  [\"George\", \"Michael\"],\n  [\"Annye\", \"Vang\"],\n  [\"Rachel\", \"Howe\"],\n  [\"Terry\", \"Medhurst\"],\n  [\"Bette\", \"Haag\"],\n  [\"Lester\", \"Solomon\"],\n  [\"April\", \"Douglas\"],\n  [\"Marian\", \"Roberts\"],\n  [\"Kathryn\", \"Murphy\"],\n  [\"Gloria\", \"Armstrong\"],\n  [\"Adam\", \"Bradley\"],\n  [\"Angela\", \"Hicks\"],\n  [\"Rose\", \"Wheeler\"],\n  [\"Sara\", \"Berry\"],\n  [\"Glen\", \"Kuhn\"],\n  [\"Roger\", \"Cox\"],\n];\n\nfunction buildReqresUser(\n  id: number,\n  first_name: string,\n  last_name: string,\n): ReqresUser {\n  const slug = `${first_name}-${last_name}`.toLowerCase();\n  return {\n    id,\n    email: `${first_name.toLowerCase()}.${last_name.toLowerCase()}@example.com`,\n    first_name,\n    last_name,\n    avatar: reqresAvatar(slug),\n  };\n}\n\n/** Jeu \u00E9tendu pour d\u00E9mos queue / lazyload (pagination par offset). */\nexport const DOCS_REQRES_USERS: ReqresUser[] = [\n  buildReqresUser(1, \"George\", \"Bluth\"),\n  buildReqresUser(2, \"Janet\", \"Weaver\"),\n  buildReqresUser(3, \"Emma\", \"Wong\"),\n  buildReqresUser(4, \"Eve\", \"Holt\"),\n  ...REQRES_EXTRA_NAMES.map(([first_name, last_name], index) =>\n    buildReqresUser(5 + index, first_name, last_name),\n  ),\n];\n\nexport type ReqresUserResponse = { data: ReqresUser };\nexport type ReqresUsersListResponse = {\n  page: number;\n  per_page: number;\n  total: number;\n  total_pages: number;\n  data: ReqresUser[];\n};\n\n/** Filter users for mock search (`q` \u2014 first name, last name, email). Same logic as the TS starter. */\nexport function filterDocsUsers(\n  users: ReqresUser[],\n  query: string | null | undefined,\n): ReqresUser[] {\n  const q = query?.trim().toLowerCase();\n  if (!q) return users;\n  return users.filter((user) => {\n    const haystack =\n      `${user.first_name} ${user.last_name} ${user.email}`.toLowerCase();\n    return haystack.includes(q);\n  });\n}\n\nexport type GeoCommuneRow = { nom: string; code: string };\n\nexport const DOCS_GEO_COMMUNES: GeoCommuneRow[] = [\n  { nom: \"Paris\", code: \"75056\" },\n  { nom: \"Lyon\", code: \"69123\" },\n  { nom: \"Marseille\", code: \"13055\" },\n  { nom: \"Toulouse\", code: \"31555\" },\n  { nom: \"Lille\", code: \"59350\" },\n  { nom: \"Bordeaux\", code: \"33063\" },\n  { nom: \"Nantes\", code: \"44109\" },\n  { nom: \"Strasbourg\", code: \"67482\" },\n  { nom: \"Montpellier\", code: \"34172\" },\n  { nom: \"Rennes\", code: \"35238\" },\n];\n\n/** JokeAPI-style content flags (checkbox / radio / switch blacklist demos). */\nexport type DocsJokeFlagKey =\n  | \"nsfw\"\n  | \"religious\"\n  | \"political\"\n  | \"racist\"\n  | \"sexist\"\n  | \"explicit\";\n\n/** Forme proche de JokeAPI v2 (`key=\"jokes\"` sur sonic-queue / list). */\nexport type DocsJokeItem = {\n  categories: string[];\n  createdAt: string;\n  id: number;\n  joke: string;\n  lang: \"fr\" | \"en\";\n  flags: Record<DocsJokeFlagKey, boolean>;\n  safe: boolean;\n  type: string;\n  setup?: string;\n  delivery?: string;\n};\n\nconst jokeFlags = (\n  partial: Partial<Record<DocsJokeFlagKey, boolean>> = {},\n): Record<DocsJokeFlagKey, boolean> => ({\n  nsfw: false,\n  religious: false,\n  political: false,\n  racist: false,\n  sexist: false,\n  explicit: false,\n  ...partial,\n});\n\nexport type DocsJokeApiResponse = {\n  error: boolean;\n  amount: number;\n  jokes: DocsJokeItem[];\n};\n\nconst SAMPLE_JOKES: DocsJokeItem[] = [\n  {\n    categories: [\"Programming\"],\n    createdAt: \"2020-01-01 00:00:00\",\n    id: 1,\n    lang: \"en\",\n    joke: \"Why do programmers prefer dark mode? Because light attracts bugs.\",\n    flags: jokeFlags(),\n    safe: true,\n    type: \"single\",\n  },\n  {\n    categories: [\"Misc\"],\n    createdAt: \"2020-01-02 00:00:00\",\n    id: 2,\n    lang: \"en\",\n    joke: \"I told my computer I needed a break \u2014 it said: no problem, I'll go to sleep.\",\n    flags: jokeFlags({ nsfw: true }),\n    safe: false,\n    type: \"single\",\n  },\n  {\n    categories: [\"Pun\"],\n    createdAt: \"2020-01-03 00:00:00\",\n    id: 3,\n    lang: \"en\",\n    joke: \"Concorde docs run offline: even the API is a local joke.\",\n    flags: jokeFlags(),\n    safe: true,\n    type: \"single\",\n  },\n  {\n    categories: [\"Animals\"],\n    createdAt: \"2020-01-04 00:00:00\",\n    id: 4,\n    lang: \"en\",\n    joke: \"The dog ate my homework and my pull request.\",\n    flags: jokeFlags({ political: true }),\n    safe: true,\n    type: \"single\",\n  },\n  {\n    categories: [\"Animals\", \"Pun\"],\n    createdAt: \"2020-01-05 00:00:00\",\n    id: 5,\n    lang: \"fr\",\n    joke: \"Quel est le chien pr\u00E9f\u00E9r\u00E9 des d\u00E9veloppeurs ? Le labrador Retriever.\",\n    flags: jokeFlags(),\n    safe: true,\n    type: \"single\",\n  },\n  {\n    categories: [\"Animals\"],\n    createdAt: \"2020-01-06 00:00:00\",\n    id: 6,\n    lang: \"fr\",\n    joke: \"Un chat et un chien discutent de TypeScript : le chien dit \u00AB woof \u00BB, le chat compile.\",\n    flags: jokeFlags({ racist: true }),\n    safe: false,\n    type: \"single\",\n  },\n  {\n    categories: [\"Misc\"],\n    createdAt: \"2020-01-07 00:00:00\",\n    id: 7,\n    lang: \"fr\",\n    joke: \"Pourquoi les blagues offline sont-elles fiables ? Parce qu'elles passent par le Service Worker.\",\n    flags: jokeFlags({ religious: true }),\n    safe: true,\n    type: \"single\",\n  },\n  {\n    categories: [\"Programming\"],\n    createdAt: \"2020-01-08 00:00:00\",\n    id: 8,\n    lang: \"fr\",\n    joke: \"Mon compilateur et mon chien : tous deux ignorent mes commandes jusqu'au build.\",\n    flags: jokeFlags({ sexist: true }),\n    safe: false,\n    type: \"single\",\n  },\n  {\n    categories: [\"Misc\"],\n    createdAt: \"2020-01-09 00:00:00\",\n    id: 9,\n    lang: \"en\",\n    joke: \"A SQL query walks into a bar, walks up to two tables and asks: Can I join you?\",\n    flags: jokeFlags({ explicit: true }),\n    safe: false,\n    type: \"single\",\n  },\n  {\n    categories: [\"Pun\"],\n    createdAt: \"2020-01-10 00:00:00\",\n    id: 10,\n    lang: \"fr\",\n    joke: \"J'ai cherch\u00E9 \u00AB chien \u00BB dans la doc : le mock API a r\u00E9pondu.\",\n    flags: jokeFlags(),\n    safe: true,\n    type: \"single\",\n  },\n  {\n    categories: [\"Misc\"],\n    createdAt: \"2020-01-11 00:00:00\",\n    id: 11,\n    lang: \"en\",\n    joke: \"There are only two hard things in Computer Science: cache invalidation and naming things.\",\n    flags: jokeFlags({ political: true, explicit: true }),\n    safe: false,\n    type: \"single\",\n  },\n  {\n    categories: [\"Animals\"],\n    createdAt: \"2020-01-12 00:00:00\",\n    id: 12,\n    lang: \"fr\",\n    joke: \"Le golden retriever a r\u00E9cup\u00E9r\u00E9 la donn\u00E9e du publisher.\",\n    flags: jokeFlags({ racist: true, sexist: true }),\n    safe: false,\n    type: \"two-liner\",\n    setup: \"Pourquoi le chien aime Concorde ?\",\n    delivery: \"Parce qu'il sait fetch.\",\n  },\n  {\n    categories: [\"Misc\"],\n    createdAt: \"2020-01-13 00:00:00\",\n    id: 13,\n    lang: \"en\",\n    joke: \"My code and my conscience: both have too many warnings.\",\n    flags: jokeFlags(),\n    safe: true,\n    type: \"single\",\n  },\n  {\n    categories: [\"Programming\"],\n    createdAt: \"2020-01-14 00:00:00\",\n    id: 14,\n    lang: \"en\",\n    joke: \"Git blame is just a mirror.\",\n    flags: jokeFlags({ religious: true, political: true }),\n    safe: false,\n    type: \"single\",\n  },\n];\n\n/** `blacklistFlags` from queue filter form (comma-separated or repeated param). */\nexport function parseBlacklistFlags(url: URL): DocsJokeFlagKey[] {\n  const keys = new Set<DocsJokeFlagKey>();\n  const valid: DocsJokeFlagKey[] = [\n    \"nsfw\",\n    \"religious\",\n    \"political\",\n    \"racist\",\n    \"sexist\",\n    \"explicit\",\n  ];\n  const add = (raw: string) => {\n    raw\n      .split(\",\")\n      .map((s) => s.trim().toLowerCase())\n      .forEach((part) => {\n        if (valid.includes(part as DocsJokeFlagKey)) keys.add(part as DocsJokeFlagKey);\n      });\n  };\n  url.searchParams.getAll(\"blacklistFlags\").forEach(add);\n  const single = url.searchParams.get(\"blacklistFlags\");\n  if (single) add(single);\n  return [...keys];\n}\n\n/** Exclude jokes that match any blacklisted flag (JokeAPI-style). */\nexport function applyJokeBlacklist(\n  jokes: DocsJokeItem[],\n  blacklist: DocsJokeFlagKey[],\n): DocsJokeItem[] {\n  if (!blacklist.length) return jokes;\n  return jokes.filter(\n    (j) => !blacklist.some((flag) => j.flags[flag] === true),\n  );\n}\n\n/** Filtre doc joke queue (`contains`, `lang`, `blacklistFlags` via `dataFilterProvider`). */\nexport function filterDocsJokes(\n  jokes: DocsJokeItem[],\n  url: URL,\n): DocsJokeItem[] {\n  let pool = jokes;\n  const contains = url.searchParams.get(\"contains\")?.trim().toLowerCase();\n  if (contains) {\n    pool = pool.filter((j) => {\n      const haystack = [j.joke, j.setup, j.delivery, ...j.categories]\n        .filter(Boolean)\n        .join(\" \")\n        .toLowerCase();\n      return haystack.includes(contains);\n    });\n  }\n  const lang = url.searchParams.get(\"lang\")?.trim().toLowerCase();\n  if (lang === \"fr\" || lang === \"en\") {\n    pool = pool.filter((j) => j.lang === lang);\n  }\n  pool = applyJokeBlacklist(pool, parseBlacklistFlags(url));\n  return pool;\n}\n\n/**\n * R\u00E9ponse type JokeAPI v2.\n * - `amount` : taille du lot si pas de `offset`\n * - `offset` + `limit` / `per_page` : pagination (sonic-queue lazy)\n * - `contains`, `lang`, `blacklistFlags` : filtres formulaire (queue \u00AB Remove following jokes \u00BB)\n */\nexport function buildJokeApiResponse(url: URL): DocsJokeApiResponse {\n  const pool = filterDocsJokes(SAMPLE_JOKES, url);\n  const amount = Math.max(\n    1,\n    parseInt(url.searchParams.get(\"amount\") || \"10\", 10),\n  );\n  const hasOffset = url.searchParams.has(\"offset\");\n  const limit = Math.max(\n    1,\n    parseInt(\n      url.searchParams.get(\"limit\") ||\n        url.searchParams.get(\"per_page\") ||\n        String(amount),\n      10,\n    ),\n  );\n  const offset = Math.max(0, parseInt(url.searchParams.get(\"offset\") || \"0\", 10));\n  const start = hasOffset ? offset : 0;\n  const count = hasOffset ? limit : amount;\n  const jokes = pool.slice(start, start + count).map((j, i) => ({\n    ...j,\n    id: start + i + 1,\n  }));\n  return { error: false, amount: jokes.length, jokes };\n}\n", "import { handleApiConfigMockRequest } from \"./api-config-mock\";\nimport {\n  DOCS_GEO_COMMUNES,\n  DOCS_REQRES_USERS,\n  buildJokeApiResponse,\n  filterDocsUsers,\n  type GeoCommuneRow,\n  type ReqresUserResponse,\n  type ReqresUsersListResponse,\n} from \"./fixtures\";\n\nexport const DOCS_MOCK_API_PREFIX = \"/docs-mock-api\";\n\nfunction json(\n  body: unknown,\n  init: ResponseInit & { delayMs?: number } = {},\n): Promise<Response> {\n  const { delayMs = 0, ...responseInit } = init;\n  const headers = new Headers(responseInit.headers);\n  headers.set(\"Content-Type\", \"application/json; charset=utf-8\");\n  headers.set(\"Access-Control-Allow-Origin\", \"*\");\n  headers.set(\"X-Docs-Mock-Api\", \"concorde\");\n\n  const build = () =>\n    new Response(JSON.stringify(body), { ...responseInit, headers });\n\n  if (delayMs <= 0) return Promise.resolve(build());\n  return new Promise((resolve) =>\n    setTimeout(() => resolve(build()), delayMs),\n  );\n}\n\n/**\n * Liste utilisateurs type ReqRes.\n * - `offset` + `per_page` / `limit` : pagination index\u00E9e (sonic-queue avec `$offset` / `$limit`)\n * - `page` + `per_page` : num\u00E9ro de page 1-based (sonic-fetch, ex. `?page=2`)\n * - `q` : recherche sur pr\u00E9nom, nom, email (sonic-queue + `dataFilterProvider`, champ `name=\"q\"`)\n */\nexport function paginateUsers(url: URL): ReqresUsersListResponse {\n  const perPage = Math.max(\n    1,\n    parseInt(\n      url.searchParams.get(\"per_page\") ||\n        url.searchParams.get(\"limit\") ||\n        \"6\",\n      10,\n    ),\n  );\n  const pool = filterDocsUsers(DOCS_REQRES_USERS, url.searchParams.get(\"q\"));\n  const total = pool.length;\n\n  let start: number;\n  let page: number;\n\n  if (url.searchParams.has(\"offset\")) {\n    start = Math.max(0, parseInt(url.searchParams.get(\"offset\") || \"0\", 10));\n    page = Math.floor(start / perPage) + 1;\n  } else {\n    page = Math.max(1, parseInt(url.searchParams.get(\"page\") || \"1\", 10));\n    start = (page - 1) * perPage;\n  }\n\n  const data = pool.slice(start, start + perPage);\n\n  return {\n    page,\n    per_page: perPage,\n    total,\n    total_pages: Math.max(1, Math.ceil(total / perPage)),\n    data,\n  };\n}\n\nasync function parseRegisterFields(\n  request: Request,\n): Promise<{ email?: string; password?: string }> {\n  const contentType = (request.headers.get(\"content-type\") || \"\").toLowerCase();\n\n  if (contentType.includes(\"multipart/form-data\")) {\n    const fd = await request.formData();\n    return {\n      email: String(fd.get(\"email\") ?? \"\"),\n      password: String(fd.get(\"password\") ?? \"\"),\n    };\n  }\n\n  if (contentType.includes(\"application/x-www-form-urlencoded\")) {\n    const text = await request.text();\n    const params = new URLSearchParams(text);\n    return {\n      email: params.get(\"email\") ?? \"\",\n      password: params.get(\"password\") ?? \"\",\n    };\n  }\n\n  const text = await request.text();\n  if (!text.trim()) return {};\n\n  try {\n    const parsed = JSON.parse(text) as { email?: unknown; password?: unknown };\n    return {\n      email: parsed.email != null ? String(parsed.email) : \"\",\n      password: parsed.password != null ? String(parsed.password) : \"\",\n    };\n  } catch {\n    const params = new URLSearchParams(text);\n    if (params.has(\"email\") || params.has(\"password\")) {\n      return {\n        email: params.get(\"email\") ?? \"\",\n        password: params.get(\"password\") ?? \"\",\n      };\n    }\n    return {};\n  }\n}\n\nfunction registerOkBody(\n  fields: { email: string; password: string },\n  nested = false,\n) {\n  const payload = {\n    id: 4,\n    token: \"docs-mock-register-token\",\n    email: fields.email,\n  };\n  return nested ? { data: payload } : payload;\n}\n\nfunction geoCommunes(url: URL): GeoCommuneRow[] {\n  const limit = Math.max(\n    1,\n    parseInt(url.searchParams.get(\"limit\") || \"5\", 10),\n  );\n  const offset = Math.max(0, parseInt(url.searchParams.get(\"offset\") || \"0\", 10));\n  return DOCS_GEO_COMMUNES.slice(offset, offset + limit);\n}\n\n/**\n * Intercepte les requ\u00EAtes vers /docs-mock-api/* (Service Worker ou middleware Vite).\n */\nexport async function handleDocsMockApiRequest(\n  request: Request,\n): Promise<Response | null> {\n  const url = new URL(request.url);\n  if (!url.pathname.startsWith(DOCS_MOCK_API_PREFIX)) return null;\n\n  const subPath = url.pathname.slice(DOCS_MOCK_API_PREFIX.length) || \"/\";\n  const method = request.method.toUpperCase();\n\n  if (subPath === \"/health\") {\n    return json({ ok: true, service: \"concorde-docs-mock-api\" });\n  }\n\n  const apiConfigResponse = handleApiConfigMockRequest(request, subPath, method);\n  if (apiConfigResponse) return apiConfigResponse;\n\n  if (\n    (subPath === \"/api/register\" || subPath === \"/api/register/nested\") &&\n    method === \"POST\"\n  ) {\n    const body = await parseRegisterFields(request);\n    if (!body.email?.trim() || !body.password?.trim()) {\n      return json(\n        {\n          messages: [\n            {\n              content: \"email and password are required\",\n              status: \"error\",\n            },\n          ],\n        },\n        { status: 400 },\n      );\n    }\n    return json(\n      registerOkBody(\n        { email: body.email!.trim(), password: body.password!.trim() },\n        subPath === \"/api/register/nested\",\n      ),\n    );\n  }\n\n  if (subPath === \"/api/register/echo\" && method === \"GET\") {\n    const email = url.searchParams.get(\"email\") ?? \"\";\n    const password = url.searchParams.get(\"password\") ?? \"\";\n    if (!email.trim() || !password.trim()) {\n      return json(\n        {\n          messages: [\n            {\n              content: \"email and password query params are required\",\n              status: \"error\",\n            },\n          ],\n        },\n        { status: 400 },\n      );\n    }\n    return json({\n      method: \"GET\",\n      query: { email, password },\n      email,\n      note: \"sonic-submit method=\\\"get\\\" appends form fields to the endpoint URL\",\n    });\n  }\n\n  if (method !== \"GET\") {\n    return json({ error: \"Method not allowed\" }, { status: 405 });\n  }\n\n  const userMatch = subPath.match(/^\\/api\\/users\\/(\\d+)$/);\n  if (userMatch) {\n    const id = parseInt(userMatch[1], 10);\n    const user =\n      DOCS_REQRES_USERS.find((u) => u.id === id) ?? DOCS_REQRES_USERS[0];\n    const body: ReqresUserResponse = { data: { ...user, id } };\n    return json(body);\n  }\n\n  if (subPath === \"/api/users\") {\n    return json(paginateUsers(url));\n  }\n\n  if (subPath === \"/geo/communes\" || subPath.startsWith(\"/geo/communes\")) {\n    return json(geoCommunes(url));\n  }\n\n  const jokeMatch = subPath.match(/^\\/jokes\\/joke\\/([^/]+)$/);\n  if (jokeMatch) {\n    return json(buildJokeApiResponse(url));\n  }\n\n  return json({ error: \"Not found\", path: subPath }, { status: 404 });\n}\n", "/// <reference lib=\"webworker\" />\nimport { handleDocsMockApiRequest} from \"./router\";\n\ndeclare const self: ServiceWorkerGlobalScope;\n\nself.addEventListener(\"install\", (event) => {\n  event.waitUntil(self.skipWaiting());\n});\n\nself.addEventListener(\"activate\", (event) => {\n  event.waitUntil(self.clients.claim());\n});\n\nself.addEventListener(\"fetch\", (event) => {\n  const {request} = event;\n  event.respondWith(\n    (async () => {\n      const mocked = await handleDocsMockApiRequest(request);\n      if (mocked) return mocked;\n      return fetch(request);\n    })(),\n  );\n});\n"],
+  "mappings": ";;;AACO,MAAM,qBAAqB;AAM3B,MAAM,wBAAwB,GAAG,kBAAkB;AAGnD,MAAM,0BAA0B,GAAG,kBAAkB;;;ACPrD,MAAM,wBAAwB;AAE9B,MAAM,wBAAwB;AAE9B,MAAM,wBAAwB;AAErC,MAAM,uBAAuB;AAC7B,MAAM,2BAA2B;AAE1B,MAAM,6BAA6B;AAE1C,MAAM,kBAA0D;AAAA,IAC9D,uBAAuB,EAAE,IAAI,WAAW,IAAI,QAAQ;AAAA,IACpD,uBAAuB,EAAE,IAAI,aAAa,IAAI,UAAU;AAAA,IACxD,mBAAmB;AAAA,MACjB,IAAI;AAAA,MACJ,IAAI;AAAA,IACN;AAAA,EACF;AAEA,WAAS,KAAK,MAAe,OAAqB,CAAC,GAAa;AAC9D,UAAM,UAAU,IAAI,QAAQ,KAAK,OAAO;AACxC,YAAQ,IAAI,gBAAgB,iCAAiC;AAC7D,YAAQ,IAAI,+BAA+B,GAAG;AAC9C,YAAQ,IAAI,mBAAmB,qBAAqB;AACpD,WAAO,IAAI,SAAS,KAAK,UAAU,IAAI,GAAG,EAAE,GAAG,MAAM,QAAQ,CAAC;AAAA,EAChE;AAOA,WAAS,mBAAmB,SAA8B;AACxD,UAAM,SAAS,QAAQ,QAAQ,IAAI,eAAe;AAClD,QAAI,CAAC,OAAQ,QAAO,EAAE,MAAM,OAAO;AACnC,UAAM,QAAQ,OAAO,MAAM,iBAAiB;AAC5C,QAAI,OAAO;AACT,UAAI;AACF,cAAM,UAAU,KAAK,MAAM,CAAC,CAAC;AAC7B,cAAM,MAAM,QAAQ,QAAQ,GAAG;AAC/B,YAAI,MAAM,EAAG,QAAO,EAAE,MAAM,OAAO;AACnC,eAAO;AAAA,UACL,MAAM;AAAA,UACN,MAAM,QAAQ,MAAM,GAAG,GAAG;AAAA,UAC1B,UAAU,QAAQ,MAAM,MAAM,CAAC;AAAA,QACjC;AAAA,MACF,QAAQ;AACN,eAAO,EAAE,MAAM,OAAO;AAAA,MACxB;AAAA,IACF;AACA,UAAM,SAAS,OAAO,MAAM,kBAAkB;AAC9C,QAAI,OAAQ,QAAO,EAAE,MAAM,UAAU,OAAO,OAAO,CAAC,EAAE,KAAK,EAAE;AAC7D,WAAO,EAAE,MAAM,OAAO;AAAA,EACxB;AAEA,WAAS,aAAa,MAA2B;AAC/C,WACE,KAAK,SAAS,WACd,KAAK,SAAS,wBACd,KAAK,aAAa;AAAA,EAEtB;AAEA,WAAS,cAAc,KAAoB;AACzC,UAAM,OAAO,IAAI,aAAa,IAAI,MAAM,KAAK;AAC7C,UAAM,SAAS,IAAI,aAAa,OAAO,UAAU,EAAE,SAC/C,IAAI,aAAa,OAAO,UAAU,IAClC,IAAI,aAAa,OAAO,QAAQ;AACpC,UAAM,SAAiC,CAAC;AACxC,eAAW,OAAO,QAAQ;AACxB,YAAM,QAAQ,gBAAgB,GAAG;AACjC,aAAO,GAAG,IACR,QAAQ,IAAI,KAAK,OAAO,MAAM,YAAY,GAAG;AAAA,IACjD;AACA,WAAO,KAAK,EAAE,MAAM,QAAQ,QAAQ,GAAG,OAAO,CAAC;AAAA,EACjD;AAKO,WAAS,2BACd,SACA,SACA,QACiB;AACjB,QAAI,YAAY,iBAAiB,WAAW,OAAO;AACjD,YAAM,OAAO,mBAAmB,OAAO;AACvC,UAAI,aAAa,IAAI,GAAG;AACtB,eAAO,KAAK;AAAA,UACV,OAAO;AAAA,UACP,QAAQ;AAAA,UACR,aAAa,IAAI,IAAI,QAAQ,GAAG,EAAE,aAAa,IAAI,aAAa;AAAA,QAClE,CAAC;AAAA,MACH;AACA,UACE,KAAK,SAAS,YACd,KAAK,UAAU,4BACf;AACA,eAAO,KAAK;AAAA,UACV,OAAO;AAAA,UACP,QAAQ;AAAA,QACV,CAAC;AAAA,MACH;AACA,aAAO,KAAK,EAAE,OAAO,eAAe,GAAG,EAAE,QAAQ,IAAI,CAAC;AAAA,IACxD;AAEA,QAAI,YAAY,2BAA2B,WAAW,OAAO;AAC3D,YAAM,OAAO,mBAAmB,OAAO;AACvC,UAAI,KAAK,SAAS,UAAU;AAC1B,YAAI,KAAK,UAAU,uBAAuB;AACxC,iBAAO,KAAK,EAAE,OAAO,iBAAiB,MAAM,cAAc,GAAG,EAAE,QAAQ,IAAI,CAAC;AAAA,QAC9E;AACA,YACE,KAAK,UAAU,yBACf,KAAK,UAAU,uBACf;AACA,iBAAO,KAAK;AAAA,YACV,IAAI;AAAA,YACJ,SAAS;AAAA,YACT,WAAW,KAAK;AAAA,UAClB,CAAC;AAAA,QACH;AAAA,MACF;AACA,UAAI,aAAa,IAAI,GAAG;AACtB,eAAO,KAAK;AAAA,UACV,IAAI;AAAA,UACJ,SAAS;AAAA,UACT,WAAW;AAAA,QACb,CAAC;AAAA,MACH;AACA,aAAO,KAAK,EAAE,OAAO,eAAe,GAAG,EAAE,QAAQ,IAAI,CAAC;AAAA,IACxD;AAEA,SACG,YAAY,qBAAqB,QAAQ,WAAW,iBAAiB,MACtE,WAAW,OACX;AACA,aAAO,cAAc,IAAI,IAAI,QAAQ,GAAG,CAAC;AAAA,IAC3C;AAEA,WAAO;AAAA,EACT;AAEO,MAAM,wBAAwB;AAAA,IACnC,GAAG,kBAAkB;AAAA,IACrB,GAAG,kBAAkB;AAAA,IACrB,GAAG,kBAAkB;AAAA,EACvB;;;AC7IA,MAAM,eAAe,CAAC,SACpB,+BAA+B,mBAAmB,IAAI,CAAC;AAEzD,MAAM,qBAAyC;AAAA,IAC7C,CAAC,WAAW,QAAQ;AAAA,IACpB,CAAC,UAAU,OAAO;AAAA,IAClB,CAAC,WAAW,OAAO;AAAA,IACnB,CAAC,SAAS,OAAO;AAAA,IACjB,CAAC,UAAU,SAAS;AAAA,IACpB,CAAC,SAAS,MAAM;AAAA,IAChB,CAAC,UAAU,MAAM;AAAA,IACjB,CAAC,SAAS,UAAU;AAAA,IACpB,CAAC,SAAS,MAAM;AAAA,IAChB,CAAC,UAAU,SAAS;AAAA,IACpB,CAAC,SAAS,SAAS;AAAA,IACnB,CAAC,UAAU,SAAS;AAAA,IACpB,CAAC,WAAW,QAAQ;AAAA,IACpB,CAAC,UAAU,WAAW;AAAA,IACtB,CAAC,QAAQ,SAAS;AAAA,IAClB,CAAC,UAAU,OAAO;AAAA,IAClB,CAAC,QAAQ,SAAS;AAAA,IAClB,CAAC,QAAQ,OAAO;AAAA,IAChB,CAAC,QAAQ,MAAM;AAAA,IACf,CAAC,SAAS,KAAK;AAAA,EACjB;AAEA,WAAS,gBACP,IACA,YACA,WACY;AACZ,UAAM,OAAO,GAAG,UAAU,IAAI,SAAS,GAAG,YAAY;AACtD,WAAO;AAAA,MACL;AAAA,MACA,OAAO,GAAG,WAAW,YAAY,CAAC,IAAI,UAAU,YAAY,CAAC;AAAA,MAC7D;AAAA,MACA;AAAA,MACA,QAAQ,aAAa,IAAI;AAAA,IAC3B;AAAA,EACF;AAGO,MAAM,oBAAkC;AAAA,IAC7C,gBAAgB,GAAG,UAAU,OAAO;AAAA,IACpC,gBAAgB,GAAG,SAAS,QAAQ;AAAA,IACpC,gBAAgB,GAAG,QAAQ,MAAM;AAAA,IACjC,gBAAgB,GAAG,OAAO,MAAM;AAAA,IAChC,GAAG,mBAAmB;AAAA,MAAI,CAAC,CAAC,YAAY,SAAS,GAAG,UAClD,gBAAgB,IAAI,OAAO,YAAY,SAAS;AAAA,IAClD;AAAA,EACF;AAYO,WAAS,gBACd,OACA,OACc;AACd,UAAM,IAAI,OAAO,KAAK,EAAE,YAAY;AACpC,QAAI,CAAC,EAAG,QAAO;AACf,WAAO,MAAM,OAAO,CAAC,SAAS;AAC5B,YAAM,WACJ,GAAG,KAAK,UAAU,IAAI,KAAK,SAAS,IAAI,KAAK,KAAK,GAAG,YAAY;AACnE,aAAO,SAAS,SAAS,CAAC;AAAA,IAC5B,CAAC;AAAA,EACH;AAIO,MAAM,oBAAqC;AAAA,IAChD,EAAE,KAAK,SAAS,MAAM,QAAQ;AAAA,IAC9B,EAAE,KAAK,QAAQ,MAAM,QAAQ;AAAA,IAC7B,EAAE,KAAK,aAAa,MAAM,QAAQ;AAAA,IAClC,EAAE,KAAK,YAAY,MAAM,QAAQ;AAAA,IACjC,EAAE,KAAK,SAAS,MAAM,QAAQ;AAAA,IAC9B,EAAE,KAAK,YAAY,MAAM,QAAQ;AAAA,IACjC,EAAE,KAAK,UAAU,MAAM,QAAQ;AAAA,IAC/B,EAAE,KAAK,cAAc,MAAM,QAAQ;AAAA,IACnC,EAAE,KAAK,eAAe,MAAM,QAAQ;AAAA,IACpC,EAAE,KAAK,UAAU,MAAM,QAAQ;AAAA,EACjC;AAyBA,MAAM,YAAY,CAChB,UAAqD,CAAC,OAChB;AAAA,IACtC,MAAM;AAAA,IACN,WAAW;AAAA,IACX,WAAW;AAAA,IACX,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,UAAU;AAAA,IACV,GAAG;AAAA,EACL;AAQA,MAAM,eAA+B;AAAA,IACnC;AAAA,MACE,YAAY,CAAC,aAAa;AAAA,MAC1B,WAAW;AAAA,MACX,IAAI;AAAA,MACJ,MAAM;AAAA,MACN,MAAM;AAAA,MACN,OAAO,UAAU;AAAA,MACjB,MAAM;AAAA,MACN,MAAM;AAAA,IACR;AAAA,IACA;AAAA,MACE,YAAY,CAAC,MAAM;AAAA,MACnB,WAAW;AAAA,MACX,IAAI;AAAA,MACJ,MAAM;AAAA,MACN,MAAM;AAAA,MACN,OAAO,UAAU,EAAE,MAAM,KAAK,CAAC;AAAA,MAC/B,MAAM;AAAA,MACN,MAAM;AAAA,IACR;AAAA,IACA;AAAA,MACE,YAAY,CAAC,KAAK;AAAA,MAClB,WAAW;AAAA,MACX,IAAI;AAAA,MACJ,MAAM;AAAA,MACN,MAAM;AAAA,MACN,OAAO,UAAU;AAAA,MACjB,MAAM;AAAA,MACN,MAAM;AAAA,IACR;AAAA,IACA;AAAA,MACE,YAAY,CAAC,SAAS;AAAA,MACtB,WAAW;AAAA,MACX,IAAI;AAAA,MACJ,MAAM;AAAA,MACN,MAAM;AAAA,MACN,OAAO,UAAU,EAAE,WAAW,KAAK,CAAC;AAAA,MACpC,MAAM;AAAA,MACN,MAAM;AAAA,IACR;AAAA,IACA;AAAA,MACE,YAAY,CAAC,WAAW,KAAK;AAAA,MAC7B,WAAW;AAAA,MACX,IAAI;AAAA,MACJ,MAAM;AAAA,MACN,MAAM;AAAA,MACN,OAAO,UAAU;AAAA,MACjB,MAAM;AAAA,MACN,MAAM;AAAA,IACR;AAAA,IACA;AAAA,MACE,YAAY,CAAC,SAAS;AAAA,MACtB,WAAW;AAAA,MACX,IAAI;AAAA,MACJ,MAAM;AAAA,MACN,MAAM;AAAA,MACN,OAAO,UAAU,EAAE,QAAQ,KAAK,CAAC;AAAA,MACjC,MAAM;AAAA,MACN,MAAM;AAAA,IACR;AAAA,IACA;AAAA,MACE,YAAY,CAAC,MAAM;AAAA,MACnB,WAAW;AAAA,MACX,IAAI;AAAA,MACJ,MAAM;AAAA,MACN,MAAM;AAAA,MACN,OAAO,UAAU,EAAE,WAAW,KAAK,CAAC;AAAA,MACpC,MAAM;AAAA,MACN,MAAM;AAAA,IACR;AAAA,IACA;AAAA,MACE,YAAY,CAAC,aAAa;AAAA,MAC1B,WAAW;AAAA,MACX,IAAI;AAAA,MACJ,MAAM;AAAA,MACN,MAAM;AAAA,MACN,OAAO,UAAU,EAAE,QAAQ,KAAK,CAAC;AAAA,MACjC,MAAM;AAAA,MACN,MAAM;AAAA,IACR;AAAA,IACA;AAAA,MACE,YAAY,CAAC,MAAM;AAAA,MACnB,WAAW;AAAA,MACX,IAAI;AAAA,MACJ,MAAM;AAAA,MACN,MAAM;AAAA,MACN,OAAO,UAAU,EAAE,UAAU,KAAK,CAAC;AAAA,MACnC,MAAM;AAAA,MACN,MAAM;AAAA,IACR;AAAA,IACA;AAAA,MACE,YAAY,CAAC,KAAK;AAAA,MAClB,WAAW;AAAA,MACX,IAAI;AAAA,MACJ,MAAM;AAAA,MACN,MAAM;AAAA,MACN,OAAO,UAAU;AAAA,MACjB,MAAM;AAAA,MACN,MAAM;AAAA,IACR;AAAA,IACA;AAAA,MACE,YAAY,CAAC,MAAM;AAAA,MACnB,WAAW;AAAA,MACX,IAAI;AAAA,MACJ,MAAM;AAAA,MACN,MAAM;AAAA,MACN,OAAO,UAAU,EAAE,WAAW,MAAM,UAAU,KAAK,CAAC;AAAA,MACpD,MAAM;AAAA,MACN,MAAM;AAAA,IACR;AAAA,IACA;AAAA,MACE,YAAY,CAAC,SAAS;AAAA,MACtB,WAAW;AAAA,MACX,IAAI;AAAA,MACJ,MAAM;AAAA,MACN,MAAM;AAAA,MACN,OAAO,UAAU,EAAE,QAAQ,MAAM,QAAQ,KAAK,CAAC;AAAA,MAC/C,MAAM;AAAA,MACN,MAAM;AAAA,MACN,OAAO;AAAA,MACP,UAAU;AAAA,IACZ;AAAA,IACA;AAAA,MACE,YAAY,CAAC,MAAM;AAAA,MACnB,WAAW;AAAA,MACX,IAAI;AAAA,MACJ,MAAM;AAAA,MACN,MAAM;AAAA,MACN,OAAO,UAAU;AAAA,MACjB,MAAM;AAAA,MACN,MAAM;AAAA,IACR;AAAA,IACA;AAAA,MACE,YAAY,CAAC,aAAa;AAAA,MAC1B,WAAW;AAAA,MACX,IAAI;AAAA,MACJ,MAAM;AAAA,MACN,MAAM;AAAA,MACN,OAAO,UAAU,EAAE,WAAW,MAAM,WAAW,KAAK,CAAC;AAAA,MACrD,MAAM;AAAA,MACN,MAAM;AAAA,IACR;AAAA,EACF;AAGO,WAAS,oBAAoB,KAA6B;AAC/D,UAAM,OAAO,oBAAI,IAAqB;AACtC,UAAM,QAA2B;AAAA,MAC/B;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AACA,UAAM,MAAM,CAAC,QAAgB;AAC3B,UACG,MAAM,GAAG,EACT,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,EACjC,QAAQ,CAAC,SAAS;AACjB,YAAI,MAAM,SAAS,IAAuB,EAAG,MAAK,IAAI,IAAuB;AAAA,MAC/E,CAAC;AAAA,IACL;AACA,QAAI,aAAa,OAAO,gBAAgB,EAAE,QAAQ,GAAG;AACrD,UAAM,SAAS,IAAI,aAAa,IAAI,gBAAgB;AACpD,QAAI,OAAQ,KAAI,MAAM;AACtB,WAAO,CAAC,GAAG,IAAI;AAAA,EACjB;AAGO,WAAS,mBACd,OACA,WACgB;AAChB,QAAI,CAAC,UAAU,OAAQ,QAAO;AAC9B,WAAO,MAAM;AAAA,MACX,CAAC,MAAM,CAAC,UAAU,KAAK,CAAC,SAAS,EAAE,MAAM,IAAI,MAAM,IAAI;AAAA,IACzD;AAAA,EACF;AAGO,WAAS,gBACd,OACA,KACgB;AAChB,QAAI,OAAO;AACX,UAAM,WAAW,IAAI,aAAa,IAAI,UAAU,GAAG,KAAK,EAAE,YAAY;AACtE,QAAI,UAAU;AACZ,aAAO,KAAK,OAAO,CAAC,MAAM;AACxB,cAAM,WAAW,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,EAAE,UAAU,EAC3D,OAAO,OAAO,EACd,KAAK,GAAG,EACR,YAAY;AACf,eAAO,SAAS,SAAS,QAAQ;AAAA,MACnC,CAAC;AAAA,IACH;AACA,UAAM,OAAO,IAAI,aAAa,IAAI,MAAM,GAAG,KAAK,EAAE,YAAY;AAC9D,QAAI,SAAS,QAAQ,SAAS,MAAM;AAClC,aAAO,KAAK,OAAO,CAAC,MAAM,EAAE,SAAS,IAAI;AAAA,IAC3C;AACA,WAAO,mBAAmB,MAAM,oBAAoB,GAAG,CAAC;AACxD,WAAO;AAAA,EACT;AAQO,WAAS,qBAAqB,KAA+B;AAClE,UAAM,OAAO,gBAAgB,cAAc,GAAG;AAC9C,UAAM,SAAS,KAAK;AAAA,MAClB;AAAA,MACA,SAAS,IAAI,aAAa,IAAI,QAAQ,KAAK,MAAM,EAAE;AAAA,IACrD;AACA,UAAM,YAAY,IAAI,aAAa,IAAI,QAAQ;AAC/C,UAAM,QAAQ,KAAK;AAAA,MACjB;AAAA,MACA;AAAA,QACE,IAAI,aAAa,IAAI,OAAO,KAC1B,IAAI,aAAa,IAAI,UAAU,KAC/B,OAAO,MAAM;AAAA,QACf;AAAA,MACF;AAAA,IACF;AACA,UAAM,SAAS,KAAK,IAAI,GAAG,SAAS,IAAI,aAAa,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;AAC9E,UAAM,QAAQ,YAAY,SAAS;AACnC,UAAM,QAAQ,YAAY,QAAQ;AAClC,UAAM,QAAQ,KAAK,MAAM,OAAO,QAAQ,KAAK,EAAE,IAAI,CAAC,GAAG,OAAO;AAAA,MAC5D,GAAG;AAAA,MACH,IAAI,QAAQ,IAAI;AAAA,IAClB,EAAE;AACF,WAAO,EAAE,OAAO,OAAO,QAAQ,MAAM,QAAQ,MAAM;AAAA,EACrD;;;AC7WO,MAAM,uBAAuB;AAEpC,WAASA,MACP,MACA,OAA4C,CAAC,GAC1B;AACnB,UAAM,EAAE,UAAU,GAAG,GAAG,aAAa,IAAI;AACzC,UAAM,UAAU,IAAI,QAAQ,aAAa,OAAO;AAChD,YAAQ,IAAI,gBAAgB,iCAAiC;AAC7D,YAAQ,IAAI,+BAA+B,GAAG;AAC9C,YAAQ,IAAI,mBAAmB,UAAU;AAEzC,UAAM,QAAQ,MACZ,IAAI,SAAS,KAAK,UAAU,IAAI,GAAG,EAAE,GAAG,cAAc,QAAQ,CAAC;AAEjE,QAAI,WAAW,EAAG,QAAO,QAAQ,QAAQ,MAAM,CAAC;AAChD,WAAO,IAAI;AAAA,MAAQ,CAAC,YAClB,WAAW,MAAM,QAAQ,MAAM,CAAC,GAAG,OAAO;AAAA,IAC5C;AAAA,EACF;AAQO,WAAS,cAAc,KAAmC;AAC/D,UAAM,UAAU,KAAK;AAAA,MACnB;AAAA,MACA;AAAA,QACE,IAAI,aAAa,IAAI,UAAU,KAC7B,IAAI,aAAa,IAAI,OAAO,KAC5B;AAAA,QACF;AAAA,MACF;AAAA,IACF;AACA,UAAM,OAAO,gBAAgB,mBAAmB,IAAI,aAAa,IAAI,GAAG,CAAC;AACzE,UAAM,QAAQ,KAAK;AAEnB,QAAI;AACJ,QAAI;AAEJ,QAAI,IAAI,aAAa,IAAI,QAAQ,GAAG;AAClC,cAAQ,KAAK,IAAI,GAAG,SAAS,IAAI,aAAa,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;AACvE,aAAO,KAAK,MAAM,QAAQ,OAAO,IAAI;AAAA,IACvC,OAAO;AACL,aAAO,KAAK,IAAI,GAAG,SAAS,IAAI,aAAa,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;AACpE,eAAS,OAAO,KAAK;AAAA,IACvB;AAEA,UAAM,OAAO,KAAK,MAAM,OAAO,QAAQ,OAAO;AAE9C,WAAO;AAAA,MACL;AAAA,MACA,UAAU;AAAA,MACV;AAAA,MACA,aAAa,KAAK,IAAI,GAAG,KAAK,KAAK,QAAQ,OAAO,CAAC;AAAA,MACnD;AAAA,IACF;AAAA,EACF;AAEA,iBAAe,oBACb,SACgD;AAChD,UAAM,eAAe,QAAQ,QAAQ,IAAI,cAAc,KAAK,IAAI,YAAY;AAE5E,QAAI,YAAY,SAAS,qBAAqB,GAAG;AAC/C,YAAM,KAAK,MAAM,QAAQ,SAAS;AAClC,aAAO;AAAA,QACL,OAAO,OAAO,GAAG,IAAI,OAAO,KAAK,EAAE;AAAA,QACnC,UAAU,OAAO,GAAG,IAAI,UAAU,KAAK,EAAE;AAAA,MAC3C;AAAA,IACF;AAEA,QAAI,YAAY,SAAS,mCAAmC,GAAG;AAC7D,YAAMC,QAAO,MAAM,QAAQ,KAAK;AAChC,YAAM,SAAS,IAAI,gBAAgBA,KAAI;AACvC,aAAO;AAAA,QACL,OAAO,OAAO,IAAI,OAAO,KAAK;AAAA,QAC9B,UAAU,OAAO,IAAI,UAAU,KAAK;AAAA,MACtC;AAAA,IACF;AAEA,UAAM,OAAO,MAAM,QAAQ,KAAK;AAChC,QAAI,CAAC,KAAK,KAAK,EAAG,QAAO,CAAC;AAE1B,QAAI;AACF,YAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,aAAO;AAAA,QACL,OAAO,OAAO,SAAS,OAAO,OAAO,OAAO,KAAK,IAAI;AAAA,QACrD,UAAU,OAAO,YAAY,OAAO,OAAO,OAAO,QAAQ,IAAI;AAAA,MAChE;AAAA,IACF,QAAQ;AACN,YAAM,SAAS,IAAI,gBAAgB,IAAI;AACvC,UAAI,OAAO,IAAI,OAAO,KAAK,OAAO,IAAI,UAAU,GAAG;AACjD,eAAO;AAAA,UACL,OAAO,OAAO,IAAI,OAAO,KAAK;AAAA,UAC9B,UAAU,OAAO,IAAI,UAAU,KAAK;AAAA,QACtC;AAAA,MACF;AACA,aAAO,CAAC;AAAA,IACV;AAAA,EACF;AAEA,WAAS,eACP,QACA,SAAS,OACT;AACA,UAAM,UAAU;AAAA,MACd,IAAI;AAAA,MACJ,OAAO;AAAA,MACP,OAAO,OAAO;AAAA,IAChB;AACA,WAAO,SAAS,EAAE,MAAM,QAAQ,IAAI;AAAA,EACtC;AAEA,WAAS,YAAY,KAA2B;AAC9C,UAAM,QAAQ,KAAK;AAAA,MACjB;AAAA,MACA,SAAS,IAAI,aAAa,IAAI,OAAO,KAAK,KAAK,EAAE;AAAA,IACnD;AACA,UAAM,SAAS,KAAK,IAAI,GAAG,SAAS,IAAI,aAAa,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;AAC9E,WAAO,kBAAkB,MAAM,QAAQ,SAAS,KAAK;AAAA,EACvD;AAKA,iBAAsB,yBACpB,SAC0B;AAC1B,UAAM,MAAM,IAAI,IAAI,QAAQ,GAAG;AAC/B,QAAI,CAAC,IAAI,SAAS,WAAW,oBAAoB,EAAG,QAAO;AAE3D,UAAM,UAAU,IAAI,SAAS,MAAM,qBAAqB,MAAM,KAAK;AACnE,UAAM,SAAS,QAAQ,OAAO,YAAY;AAE1C,QAAI,YAAY,WAAW;AACzB,aAAOD,MAAK,EAAE,IAAI,MAAM,SAAS,yBAAyB,CAAC;AAAA,IAC7D;AAEA,UAAM,oBAAoB,2BAA2B,SAAS,SAAS,MAAM;AAC7E,QAAI,kBAAmB,QAAO;AAE9B,SACG,YAAY,mBAAmB,YAAY,2BAC5C,WAAW,QACX;AACA,YAAM,OAAO,MAAM,oBAAoB,OAAO;AAC9C,UAAI,CAAC,KAAK,OAAO,KAAK,KAAK,CAAC,KAAK,UAAU,KAAK,GAAG;AACjD,eAAOA;AAAA,UACL;AAAA,YACE,UAAU;AAAA,cACR;AAAA,gBACE,SAAS;AAAA,gBACT,QAAQ;AAAA,cACV;AAAA,YACF;AAAA,UACF;AAAA,UACA,EAAE,QAAQ,IAAI;AAAA,QAChB;AAAA,MACF;AACA,aAAOA;AAAA,QACL;AAAA,UACE,EAAE,OAAO,KAAK,MAAO,KAAK,GAAG,UAAU,KAAK,SAAU,KAAK,EAAE;AAAA,UAC7D,YAAY;AAAA,QACd;AAAA,MACF;AAAA,IACF;AAEA,QAAI,YAAY,wBAAwB,WAAW,OAAO;AACxD,YAAM,QAAQ,IAAI,aAAa,IAAI,OAAO,KAAK;AAC/C,YAAM,WAAW,IAAI,aAAa,IAAI,UAAU,KAAK;AACrD,UAAI,CAAC,MAAM,KAAK,KAAK,CAAC,SAAS,KAAK,GAAG;AACrC,eAAOA;AAAA,UACL;AAAA,YACE,UAAU;AAAA,cACR;AAAA,gBACE,SAAS;AAAA,gBACT,QAAQ;AAAA,cACV;AAAA,YACF;AAAA,UACF;AAAA,UACA,EAAE,QAAQ,IAAI;AAAA,QAChB;AAAA,MACF;AACA,aAAOA,MAAK;AAAA,QACV,QAAQ;AAAA,QACR,OAAO,EAAE,OAAO,SAAS;AAAA,QACzB;AAAA,QACA,MAAM;AAAA,MACR,CAAC;AAAA,IACH;AAEA,QAAI,WAAW,OAAO;AACpB,aAAOA,MAAK,EAAE,OAAO,qBAAqB,GAAG,EAAE,QAAQ,IAAI,CAAC;AAAA,IAC9D;AAEA,UAAM,YAAY,QAAQ,MAAM,uBAAuB;AACvD,QAAI,WAAW;AACb,YAAM,KAAK,SAAS,UAAU,CAAC,GAAG,EAAE;AACpC,YAAM,OACJ,kBAAkB,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,kBAAkB,CAAC;AACnE,YAAM,OAA2B,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,EAAE;AACzD,aAAOA,MAAK,IAAI;AAAA,IAClB;AAEA,QAAI,YAAY,cAAc;AAC5B,aAAOA,MAAK,cAAc,GAAG,CAAC;AAAA,IAChC;AAEA,QAAI,YAAY,mBAAmB,QAAQ,WAAW,eAAe,GAAG;AACtE,aAAOA,MAAK,YAAY,GAAG,CAAC;AAAA,IAC9B;AAEA,UAAM,YAAY,QAAQ,MAAM,0BAA0B;AAC1D,QAAI,WAAW;AACb,aAAOA,MAAK,qBAAqB,GAAG,CAAC;AAAA,IACvC;AAEA,WAAOA,MAAK,EAAE,OAAO,aAAa,MAAM,QAAQ,GAAG,EAAE,QAAQ,IAAI,CAAC;AAAA,EACpE;;;ACpOA,OAAK,iBAAiB,WAAW,CAAC,UAAU;AAC1C,UAAM,UAAU,KAAK,YAAY,CAAC;AAAA,EACpC,CAAC;AAED,OAAK,iBAAiB,YAAY,CAAC,UAAU;AAC3C,UAAM,UAAU,KAAK,QAAQ,MAAM,CAAC;AAAA,EACtC,CAAC;AAED,OAAK,iBAAiB,SAAS,CAAC,UAAU;AACxC,UAAM,EAAC,QAAO,IAAI;AAClB,UAAM;AAAA,OACH,YAAY;AACX,cAAM,SAAS,MAAM,yBAAyB,OAAO;AACrD,YAAI,OAAQ,QAAO;AACnB,eAAO,MAAM,OAAO;AAAA,MACtB,GAAG;AAAA,IACL;AAAA,EACF,CAAC;",
+  "names": ["json", "text"]
+}

package/docs/index.html

@@ -10,8 +10,8 @@
     <!-- <script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"></script>
      -->
     <script src="https://cdn.jsdelivr.net/npm/marked@13.0.3"></script>
-    <script type="module" crossorigin src="./assets/index-CaysOMFz.js"></script>
-    <link rel="stylesheet" crossorigin href="./assets/index-D8mGoXzF.css">
+    <script type="module" crossorigin src="./assets/index-D9pxaQYK.js"></script>
+    <link rel="stylesheet" crossorigin href="./assets/index-t0-i22oI.css">
   </head>
   <body class="px-6 lg:px-20">
     <sonic-theme

package/docs/src/core/components/functional/fetch/fetch.md

@@ -1,6 +1,8 @@
 # Fetch
-The **sonic-fetch** component is used to request and store data from an API.
-Fetch extends the mixins Fetcher and [Subscriber](#docs/_core-concept/subscriber.md/subscriber)
+
+> **New apps:** prefer [@get](#docs/_decorators/get.md/get) for a typed GET on a component, or [List](#core/components/functional/list/list.md/list) / [Queue](#core/components/functional/queue/queue.md/queue) with `fetch` for collections. Use [Local API demos](#docs/_misc/docs-mock-api.md/docs-mock-api) (`serviceURL="/docs-mock-api"`) to try examples offline.
+
+The **sonic-fetch** component requests and stores API data. It extends the Fetcher and [Subscriber](#docs/_core-concept/subscriber.md/subscriber) mixins.
 
 
 
@@ -9,7 +11,7 @@ Fetch extends the mixins Fetcher and [Subscriber](#docs/_core-concept/subscriber
 ## Basic usage
 In order to work properly the <b>sonic-fetch</b> component needs at least the following attributes.  
 - **serviceURL** : A base service url. This attribute can be inherited from an ancestor.
-  *ex : https://reqres.in*
+  *ex : /docs-mock-api*
 - **endPoint** : the specific location where requests for information are sent (see the api docs).  
   *ex : api/users | api/users?page=2 | api/users/2*
 - **dataProvider *(Required)*** : An ID that is used as a reference to the object storing the data returned by the API.
@@ -19,7 +21,7 @@ This attribute can be inherited from an ancestor.
 
 <sonic-code>
   <template>
-    <sonic-fetch serviceURL="https://reqres.in" endPoint="api/users?page=2" dataProvider="myDataObj"></sonic-fetch>
+    <sonic-fetch serviceURL="/docs-mock-api" endPoint="api/users?page=2" dataProvider="myDataObj"></sonic-fetch>
     <sonic-button dataProvider="myDataObj" debug>Hover to see the data</sonic-button>
   </template>
 </sonic-code>
@@ -29,7 +31,7 @@ If no **endPoint** is specified it will be filled by the **dataProvider ID** ins
 
 <sonic-code>
   <template>
-    <sonic-fetch serviceURL="https://reqres.in" dataProvider="api/users?page=2" ></sonic-fetch>
+    <sonic-fetch serviceURL="/docs-mock-api" dataProvider="api/users?page=2" ></sonic-fetch>
     <sonic-button dataProvider="api/users?page=2" debug>Hover to see the data</sonic-button>
   </template>
 </sonic-code>
@@ -46,19 +48,19 @@ For example if the data is `{my:{data:{a:1,b:2}}}` and the key is `key="my.data"
 
 <sonic-code>
   <template>
-    <sonic-fetch serviceURL="https://reqres.in" dataProvider="api/users/2" ></sonic-fetch>
+    <sonic-fetch serviceURL="/docs-mock-api" dataProvider="api/users/2" ></sonic-fetch>
     <sonic-button dataProvider="api/users/2" debug>dataProvider object</sonic-button>
     <!-- Get the user ID -->
-    <sonic-fetch serviceURL="https://reqres.in" dataProvider="id" endPoint="api/users/2" key="data.id"></sonic-fetch>
+    <sonic-fetch serviceURL="/docs-mock-api" dataProvider="id" endPoint="api/users/2" key="data.id"></sonic-fetch>
     <sonic-button dataProvider="id" debug>data.id</sonic-button>
     <!-- Get the user First name -->
-    <sonic-fetch serviceURL="https://reqres.in" dataProvider="first_name" endPoint="api/users/2" key="data.first_name"></sonic-fetch>
+    <sonic-fetch serviceURL="/docs-mock-api" dataProvider="first_name" endPoint="api/users/2" key="data.first_name"></sonic-fetch>
     <sonic-button dataProvider="first_name" debug>data.first_name</sonic-button>
     <!-- Get the user Last name -->
-    <sonic-fetch serviceURL="https://reqres.in" dataProvider="last_name" endPoint="api/users/2" key="data.last_name"></sonic-fetch>
+    <sonic-fetch serviceURL="/docs-mock-api" dataProvider="last_name" endPoint="api/users/2" key="data.last_name"></sonic-fetch>
     <sonic-button dataProvider="last_name" debug>data.last_name</sonic-button>
     <!-- Get the user email -->
-    <sonic-fetch serviceURL="https://reqres.in" dataProvider="email" endPoint="api/users/2" key="data.email"></sonic-fetch>
+    <sonic-fetch serviceURL="/docs-mock-api" dataProvider="email" endPoint="api/users/2" key="data.email"></sonic-fetch>
     <sonic-button dataProvider="email" debug>data.email</sonic-button>
   </template>
 </sonic-code>
@@ -80,7 +82,7 @@ The noLoader attribute disables display of the default loader
 
 <sonic-code>
   <template>
-    <sonic-fetch noLoader serviceURL="https://reqres.in" endPoint="api/users?page=2" dataProvider="myDataObj"></sonic-fetch>
+    <sonic-fetch noLoader serviceURL="/docs-mock-api" endPoint="api/users?page=2" dataProvider="myDataObj"></sonic-fetch>
     <sonic-button dataProvider="myDataObj" debug>Basic fetch with noLoader attribute</sonic-button>
   </template>
 </sonic-code>

package/docs/src/core/components/functional/if/if.md

@@ -1,16 +1,9 @@
 # if
 
-The **sonic-if** component shows its content based on the value of its reactive property names **condition**
+The **sonic-if** component shows its slot when **`.condition`** is true. In Lit, bind `.condition` from store-driven state (`@subscribe` on a `formDataProvider` field) — live preview and **TypeScript source are the same file** (`docs-lit-demo`):
 
-<sonic-code>
-  <template>
-<div dataProvider="visibilitySettings" formDataProvider="visibilitySettings">
-  <sonic-checkbox label="Show evacuation plan" name="togglePlan" unique checked value="true"></sonic-checkbox>
-  <sonic-if  data-bind ::condition="$togglePlan" class="mt-4 block">
-  <sonic-image src="https://www.thebaron.info/assets/mail/concorde-evacuation.jpg" rounded="md" ratio="654/463"></sonic-image>
-  </sonic-if>
-</div>
-  </template>
-</sonic-code>
+<docs-lit-demo for="docs-toggle-if-demo"></docs-lit-demo>
+
+Plain HTML without Lit: [HTML integration](#docs/_misc/html-integration.md/html-integration).
 
 

package/docs/src/core/components/functional/list/list.md

@@ -1,199 +1,65 @@
 # List
 
-The **sonic-list** component creates list items.
-
-
-List extends the mixins  [Subscriber](#docs/_core-concept/subscriber.md/subscriber) and Fetcher : 
-* As a Subscriber it as a **props** reactive property (basically an array of data) and its data is associated to a publisher via its dataProvider attribute.
-* List doesn't Fetch by default (see below for activation).
-
-
-## Template
-
-The list component loops over its template children to render each items of its props data.  
-Consider the following example using **2 templates** and **9 items** :    
-- First template will render the first item.  
-- Second template will render the second item.  
-- Then back to the first template and so on and so forth.
-
-Note that for each line there is a dataProvider found at *[list dataProvider name]/liste-item/[line index or key]*
-You can hover the list items in the examples to see it.
-
-<sonic-code>
-  <template>
-     <sonic-list dataProvider="listTemplateExample" class="grid grid-cols-3 gap-4" props='[{"id": "1"}, {"id": "2"}, {"id": "3"}, {"id": "4"}, {"id": "5"}, {"id": "6"}, {"id": "7"}, {"id": "8"}, {"id": "9"}]' debug>      
-     <template>
-        <div class="bg-neutral-100 text-center p-3">
-          <sonic-value key="id"></sonic-value>
-          <div class="text-xs">1st template</div>
-        </div>
-      </template>
-      <template>
-        <div class="bg-neutral-100 text-info text-center p-3">
-          <sonic-value key="id"></sonic-value>
-          <div class="text-xs">2nd template</div>
-        </div>
-      </template>
-    </sonic-list>
-  </template>
-</sonic-code>
-
-
-
-## TemplateKey / data-value
-
-The **templateKey** attribute allows you to bind a template to a props item.  
-Consider the following example :  
-- The list **templateKey** attribute is set to the value **tpl** (any name would do)
-- Items 4,5 and 6 are each one **referencing** a templates with a matching **data-value** attribute
-
-<sonic-code>
-  <template>
-    <sonic-list
-      templateKey="tpl"
-      class="grid gap-3"
-      dataProvider="TemplateKeyExample"
-      props='[
-        {"id":"1", "default": "The first template with no data-value is used"},
-        {"id":"2", "default": "The second template with no data-value is used"},
-        {"id":"3", "default": "Back to the first template with no data-value"},
-        {"id":"4", "tpl":"custom-tpl-danger"},
-        {"id":"5", "tpl":"custom-tpl-info"},
-        {"id":"6", "tpl":"custom-tpl-success"},
-        {"id":"7", "tpl": "Non-valid tpl name, Back to the first template with no data-value"}
-      ]'
-      debug
-    >
-      <template>
-        <div class="p-2 border rounded text-neutral-900">
-          <sonic-value key="id"> : </sonic-value>
-          <b>First</b> template with no <b>data-value</b> attribute
-        </div>
-      </template>
-      <template data-value="custom-tpl-danger">
-        <div class="p-2 border rounded text-danger">
-          <sonic-value key="id"> : </sonic-value>
-          data-value : <b>custom-tpl-danger</b>
-        </div>
-      </template>
-      <template data-value="custom-tpl-info">
-        <div class="p-2 border rounded text-info">
-          <sonic-value key="id"> : </sonic-value>
-          data-value : <b>custom-tpl-info</b>
-        </div>
-      </template>
-      <template data-value="custom-tpl-success">
-        <div class="p-2 border rounded text-success">
-          <sonic-value key="id"> : </sonic-value>
-          data-value : <b>custom-tpl-success</b>
-        </div>
-      </template>
-      <template>
-        <div class="p-2 border rounded text-neutral-400">
-          <sonic-value key="id"> : </sonic-value>
-          <b>Second</b> template with no <b>data-value</b> attribute <br>
-          This one is used if it <b>follows another data-item</b> with <b>no tpl</b> specified in the props
-        </div>
-      </template>
-    </sonic-list>
-  </template>
-</sonic-code>
-
-## Special templates : list item separator / empty list view
-
-A special template with attribute **data-value="separator"** will act as a separator between each list item
-
-<sonic-code>
-  <template>
-    <sonic-list props='[{"id":"1"},{"id":"2"},{"id":"3"}]' dataProvider="ListSeparatorDemo">
-      <template><sonic-value key="id"></sonic-value></template>
-      <template data-value="separator"> 🤜 </template>
-    </sonic-list>
-  </template>
-</sonic-code>
-
-The same principle can be used to handle empty lists using a template with attribute **data-value="no-item"**
-
-
-## Fetch
-
-Enables the list to get data from an external API in order to fill its **props** attribute with an **array of items**
-See the [Fetch] web component(#core/components/functional/fetch/fetch.md/fetch)
-<sonic-code>
-  <template>
-    <sonic-list 
-    props='["a", "b", "c"]' fetch
-    serviceURL="https://reqres.in"
-    dataProvider="api/users" 
-    key="data"
-    class="grid grid-cols-1" debug>
-        <template>
-          <docs-user></docs-user>
-        </template>
-    </sonic-list>
-  </template>
-</sonic-code>
-
-## Extract Values
-
-Example of using the `extractValues` attribute with a service.
-As in the previous example, the `fetch` attribute indicates that a service call should be made.
-Note that we use:
-* the property `_metadata_` added by the list component to display the key of the extracted value
-* the special property `_self_` that allows targeting the item itself. This is useful here because there is no sub-property; we are directly dealing with a string.
-<sonic-code>
-  <template>
-   <sonic-list
-      debug
-      fetch
-      serviceURL="https://reqres.in"
-      dataProvider="list-extract-values-test"
-      endPoint="api/users/2"
-      key="data"
-      extractValues
-    >
-      <template>
-        <div class="flex items-center">
-          <span data-bind ::inner-html="$_metadata_.key  : " class="bold w-24"></span>
-          <span data-bind ::inner-html="$_self_"></span>
-          <sonic-if data-bind ::condition="|'$_metadata_.key' == 'avatar'">
-            <sonic-image data-bind ::src="$_self_" rounded="full" ratio="1/1" class="w-20 block"></sonic-image>
-          </sonic-if>
-        </div>
-      </template>
-    </sonic-list>
-  </template>
-</sonic-code>
+> **Try offline:** `serviceURL="/docs-mock-api"` and `dataProvider="api/users"` with `key="data"` — see [Local API demos](#docs/_misc/docs-mock-api.md/docs-mock-api). Recommended patterns: [Data flow](#docs/_core-concept/dataFlow.md/dataFlow).
+
+The **sonic-list** component renders one row per entry in **`props`** (array from fetch or set on the element).
+
+List extends [Subscriber](#docs/_core-concept/subscriber.md/subscriber) and **Fetcher**:
+* **Subscriber** — `props` + `dataProvider`
+* **Fetcher** — optional `fetch` + `serviceURL` / `key` (see [Fetch](#core/components/functional/fetch/fetch.md/fetch))
+
+## Row renderer (`items`) — recommended
+
+From a **Lit** parent, pass a function on the **`items`** property (`ListItems`). Each row is wrapped in a `sonic-subscriber` with `dataProvider="…/list-item/n"` (hover rows with `debug`).
+
+```typescript
+private items = ({ first_name, last_name, email, avatar }) => html`
+  <sonic-image src=${avatar} …></sonic-image>
+  <div>${first_name} <b>${last_name}</b></div>
+  <div>${email}</div>
+`;
+
+html`<sonic-list
+  fetch
+  dataProvider="api/users"
+  key="data"
+  serviceURL="/docs-mock-api"
+  .items=${this.items}
+></sonic-list>`;
+```
+
+Use **`.items=${fn}`** (property binding): Lit passes functions only as properties, not as HTML attributes — `@property({ type: Function })` does not change that. Same for **`.noItems`**, **`.separator`**, **`.skeleton`**. The callback receives each row object (replacing `data-bind` / `<sonic-value>` in a `<template>`).
+
+Live demo + TypeScript source (one file, no Markdown copy):
+
+<docs-lit-demo for="docs-users-list"></docs-lit-demo>
+
+Implementation: `src/docs/example/docs-users-list.ts` — row markup in the **`items`** callback (`item.first_name`, …), same idea as replacing `data-bind` / `<sonic-value>` in a `<template>`.
+
+## Alternating row layouts
+
+Use **`metadata`** (`even`, `odd`, `firstChild`, …) or fields on each item (e.g. `tpl` with `templateKey`):
+
+<docs-lit-demo for="docs-list-alternate-demo"></docs-lit-demo>
+
+<docs-lit-demo for="docs-list-template-key-demo"></docs-lit-demo>
+
+## Separator and empty list
+
+<docs-lit-demo for="docs-list-separator-demo"></docs-lit-demo>
+
+## Fetch + `extractValues`
+
+<docs-lit-demo for="docs-list-extract-values-demo"></docs-lit-demo>
+
+## HTML `<template>` children (integration without Lit)
+
+For **plain HTML** hosts, you can still declare **`<template>`** children (and `data-value` for `templateKey`, `separator`, `no-item`). That path is for [HTML integration](#docs/_misc/html-integration.md/html-integration) — not used in Concorde doc live demos.
+
+Each list row still gets `dataProvider="[list]/list-item/[index]"`.
 
 ## Additionnal tips
 
-* If the result of the request is an object, it is nested within an array to ensure functionality.
-* The invalidate() method can be called on its publisher to trigger data reloading.
-* Each list item publisher has a "_parent_" property pointing to the list publisher
-
-
-
-<!-- 
-## FormDataProvider
-
-<sonic-alert status="error" background>À déplacer dans la bonne doc</sonic-alert>
-
-<sonic-code>
-  <template>
-  <div formDataProvider="profileInfos">
-    <form>
-      <sonic-fieldset label="Edit profile">
-        <sonic-form-layout>
-          <sonic-input label="First name" type="text" name="first_name" value="Sponge" size="sm"></sonic-input>
-          <sonic-input label="Last name" type="text" name="last_name" value="Bob" size="sm"></sonic-input>
-          <sonic-input label="email" type="email" name="email" value="bob@krustykrab.com" size="sm"></sonic-input>
-          <sonic-input label="Image url" type="text" name="avatar" value="http://www.bobleponge.fr/goodies/avatars/avatar-bob-eponge_Bob-Eponge-coiffure.jpg" size="sm"></sonic-input>
-        </sonic-form-layout>
-      </sonic-fieldset>
-    </form>
-  </div>
-  <sonic-card  dataProvider="profileInfos">
-    <docs-user ></docs-user>
-  </sonic-card>
-  </template>
-</sonic-code> -->
+* If the request returns an object, it is wrapped in an array (unless `extractValues` is set).
+* Call **`invalidate()`** on the list publisher to reload fetch data.
+* Each row publisher exposes **`_parent_`** pointing at the list publisher.