@openrails/contentkit-ui 0.0.0-placeholder → 0.68.0

package/dist/urls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"urls.js","names":[],"sources":["../src/urls/index.ts"],"sourcesContent":["// ContentKit content URLs: [/{lang}]/{route}/{CODE}[/{slug}]. The code is the\n// only part the server reads; the slug is decoration. Mirrors Go's contenturl\n// (the two share contenturl/testdata/vectors.json).\n\nexport const CODE_LENGTH = 9;\n\n/** Crockford base32: digits and uppercase letters without I, L, O, U. */\nexport const CODE_ALPHABET = \"0123456789ABCDEFGHJKMNPQRSTVWXYZ\";\n\n/**\n * Reads a code with Crockford's decoding rules (any case, O as 0, I and L as 1,\n * hyphens ignored) and returns its canonical form, or null when the input is\n * not a code. An all-digit result is never a code (it reads as a legacy id).\n */\nexport function parseCode(input: string): string | null {\n  let out = \"\";\n  for (const ch of input) {\n    if (ch === \"-\") continue;\n    if (ch.length !== 1 || ch.charCodeAt(0) > 0x7f) return null;\n    let c = ch.toUpperCase();\n    if (c === \"O\") c = \"0\";\n    else if (c === \"I\" || c === \"L\") c = \"1\";\n    if (!CODE_ALPHABET.includes(c) || out.length === CODE_LENGTH) return null;\n    out += c;\n  }\n  if (out.length !== CODE_LENGTH || !/[A-Z]/.test(out)) return null;\n  return out;\n}\n\n/** Reports whether input is a code in canonical form. */\nexport function isCode(input: string): boolean {\n  return parseCode(input) === input;\n}\n\n/** A resolved content link, as ContentKit and host APIs return it. */\nexport interface ContentLink {\n  content_kind: string;\n  code: string;\n  slug: string;\n  /** Localized slugs keyed by language; the default slug applies otherwise. */\n  slugs?: Record<string, string>;\n}\n\n/** The slug for language, falling back to the default slug. */\nexport function slugFor(link: Pick<ContentLink, \"slug\" | \"slugs\">, language = \"\"): string {\n  return (language && link.slugs?.[language]) || link.slug;\n}\n\nexport type QueryInit = string | URLSearchParams | Record<string, string | number | boolean | null | undefined>;\n\nexport interface PathOptions {\n  /** Language prefix segment; omitted when empty. */\n  language?: string;\n  /** Query string for sub-pages, e.g. { p: 12 }. Null and undefined values are dropped. */\n  query?: QueryInit;\n}\n\nfunction queryString(query: QueryInit | undefined): string {\n  if (query === undefined) return \"\";\n  let params: URLSearchParams;\n  if (typeof query === \"string\" || query instanceof URLSearchParams) {\n    params = new URLSearchParams(query);\n  } else {\n    params = new URLSearchParams();\n    for (const [k, v] of Object.entries(query)) {\n      if (v !== null && v !== undefined) params.append(k, String(v));\n    }\n  }\n  const s = params.toString();\n  return s ? `?${s}` : \"\";\n}\n\n/** Joins [/{language}]/{route}/{code}[/{slug}][?query]. */\nexport function contentPath(route: string, code: string, slug = \"\", options: PathOptions = {}): string {\n  const prefix = options.language ? `/${options.language}` : \"\";\n  return `${prefix}/${route}/${code}${slug ? `/${slug}` : \"\"}${queryString(options.query)}`;\n}\n\nexport interface ContentURLConfig {\n  /** Content kind -> the host's route segment ({ video: \"watch\", gallery: \"g\" }). */\n  routes: Record<string, string>;\n  /** Language segments a path may start with; kept in canonical paths. */\n  languages?: string[];\n  /** The site's origin (\"https://example.com\") for absolute URLs (canonical links, og:url). */\n  origin?: string;\n}\n\nexport interface ParsedContentPath {\n  /** \"\" when unprefixed. */\n  language: string;\n  route: string;\n  /** Canonical form. */\n  code: string;\n  rawCode: string;\n  /** As written; \"\" when absent. */\n  slug: string;\n}\n\nexport interface CanonicalResult {\n  /** The canonical path. */\n  path: string;\n  /** path plus the location's query. */\n  location: string;\n  /** The location's path is not canonical: replace it with location. */\n  redirect: boolean;\n}\n\nexport interface HreflangOptions {\n  /** Languages the content exists in; default every configured language. */\n  languages?: readonly string[];\n  /** The language x-default points at. */\n  defaultLanguage?: string;\n  /** The origin for absolute URLs; default the configured one (throws without either). */\n  origin?: string;\n}\n\nexport interface ContentURLs {\n  /** The configured language segments. */\n  readonly languages: readonly string[];\n  /** The configured origin, without a trailing slash. */\n  readonly origin?: string;\n  /** The canonical path of link; throws when its kind has no route. */\n  path(link: ContentLink, options?: PathOptions): string;\n  /** path() on the configured origin; throws without one. */\n  url(link: ContentLink, options?: PathOptions): string;\n  /** Splits a pathname; null when it is not a content path (or its code is invalid). */\n  parse(pathname: string): ParsedContentPath | null;\n  /**\n   * Compares a location (pathname plus optional ?query and #hash) with link's\n   * canonical path, for a client-side history.replaceState after the page's\n   * data arrives. null when the location is not a content path or link's kind\n   * has no route.\n   */\n  canonical(location: string, link: ContentLink): CanonicalResult | null;\n  /**\n   * hreflang alternates: each language's absolute URL of link (its own\n   * slug), plus x-default; empty when no language is configured.\n   */\n  hreflang(link: ContentLink, options?: HreflangOptions): Record<string, string>;\n}\n\n/** Query parameters that only track a visit: never part of a canonical URL. */\nexport const TRACKING_PARAMS = [\"gclid\", \"gbraid\", \"wbraid\", \"dclid\", \"fbclid\", \"msclkid\", \"yclid\", \"twclid\", \"igshid\", \"mc_cid\", \"mc_eid\", \"_ga\", \"_gl\"];\n\n/**\n * href without tracking parameters (utm_* and TRACKING_PARAMS, plus drop),\n * its fragment or a trailing slash: the canonical URL of a page that is not\n * a content page.\n */\nexport function canonicalURL(href: string, options: { drop?: readonly string[] } = {}): string {\n  const url = new URL(href);\n  const drop = new Set([...TRACKING_PARAMS, ...(options.drop ?? [])]);\n  for (const key of [...url.searchParams.keys()]) if (key.startsWith(\"utm_\") || drop.has(key)) url.searchParams.delete(key);\n  url.hash = \"\";\n  if (url.pathname.length > 1 && url.pathname.endsWith(\"/\")) url.pathname = url.pathname.replace(/\\/+$/, \"\");\n  return url.toString();\n}\n\nconst SEGMENT = /^[a-z0-9][a-z0-9_-]*$/;\n\n/** Builds the URL helpers for one host's routes. */\nexport function createContentURLs(config: ContentURLConfig): ContentURLs {\n  const routes = { ...config.routes };\n  const origin = config.origin?.replace(/\\/+$/, \"\");\n  if (origin !== undefined && !/^https?:\\/\\/[^/?#]+$/.test(origin)) throw new Error(`contentkit-ui/urls: origin ${JSON.stringify(config.origin)} is not an http(s) origin`);\n  const languages = [...(config.languages ?? [])];\n  const routeSet = new Set(Object.values(routes));\n  if (routeSet.size === 0) throw new Error(\"contentkit-ui/urls: routes is empty\");\n  for (const r of [...routeSet, ...languages]) {\n    if (!SEGMENT.test(r)) throw new Error(`contentkit-ui/urls: ${JSON.stringify(r)} is not one lowercase path segment`);\n  }\n  for (const l of languages) {\n    if (routeSet.has(l)) throw new Error(`contentkit-ui/urls: language ${JSON.stringify(l)} is also a route`);\n  }\n\n  const canonicalPath = (link: ContentLink, language: string): string | null => {\n    const route = routes[link.content_kind];\n    return route === undefined ? null : contentPath(route, link.code, slugFor(link, language), { language });\n  };\n\n  const parse = (pathname: string): ParsedContentPath | null => {\n    if (!pathname.startsWith(\"/\")) return null;\n    let rest = pathname.slice(1);\n    if (rest.endsWith(\"/\")) rest = rest.slice(0, -1);\n    let segs = rest.split(\"/\");\n    if (segs.some((s) => s === \"\")) return null;\n    let language = \"\";\n    if (segs.length > 2 && languages.includes(segs[0]!)) {\n      language = segs[0]!;\n      segs = segs.slice(1);\n    }\n    if (segs.length < 2 || segs.length > 3 || !routeSet.has(segs[0]!)) return null;\n    const code = parseCode(segs[1]!);\n    if (code === null) return null;\n    return { language, route: segs[0]!, code, rawCode: segs[1]!, slug: segs[2] ?? \"\" };\n  };\n\n  const path = (link: ContentLink, options: PathOptions = {}): string => {\n    const route = routes[link.content_kind];\n    if (route === undefined) throw new Error(`contentkit-ui/urls: no route for kind ${JSON.stringify(link.content_kind)}`);\n    return contentPath(route, link.code, slugFor(link, options.language), options);\n  };\n\n  return {\n    languages,\n    origin,\n    path,\n    url(link, options) {\n      if (origin === undefined) throw new Error(\"contentkit-ui/urls: url() needs ContentURLConfig.origin\");\n      return origin + path(link, options);\n    },\n    parse,\n    canonical(location, link) {\n      const noHash = location.split(\"#\", 1)[0]!;\n      const q = noHash.indexOf(\"?\");\n      const pathname = q < 0 ? noHash : noHash.slice(0, q);\n      const search = q < 0 ? \"\" : noHash.slice(q + 1);\n      const parsed = parse(pathname);\n      if (parsed === null) return null;\n      const path = canonicalPath(link, parsed.language);\n      if (path === null) return null;\n      return { path, location: search ? `${path}?${search}` : path, redirect: pathname !== path };\n    },\n    hreflang(link, options = {}) {\n      const base = options.origin?.replace(/\\/+$/, \"\") ?? origin;\n      if (base === undefined) throw new Error(\"contentkit-ui/urls: hreflang() needs an origin\");\n      const out: Record<string, string> = {};\n      const langs = (options.languages ?? languages).filter((l) => languages.includes(l));\n      for (const language of langs) out[language] = base + path(link, { language });\n      const def = options.defaultLanguage;\n      if (def && out[def]) out[\"x-default\"] = out[def];\n      return out;\n    },\n  };\n}\n"],"mappings":"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"}

package/package.json

@@ -1,11 +1,121 @@
 {
   "name": "@openrails/contentkit-ui",
-  "version": "0.0.0-placeholder",
-  "description": "Placeholder; real releases come from the ContentKit repository",
+  "version": "0.68.0",
+  "description": "ContentKit in the browser: client, React hooks and styled components for media, uploads and content URLs.",
+  "type": "module",
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/open-rails/contentkit.git",
     "directory": "sdk/ui"
+  },
+  "homepage": "https://github.com/open-rails/contentkit/tree/master/sdk/ui#readme",
+  "bugs": {
+    "url": "https://github.com/open-rails/contentkit/issues"
+  },
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": [
+    "./dist/index.js",
+    "**/*.css"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "import": "./dist/client.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react.js"
+    },
+    "./urls": {
+      "types": "./dist/urls/index.d.ts",
+      "import": "./dist/urls.js"
+    },
+    "./locales/*": {
+      "types": "./dist/locales/*.d.ts",
+      "import": "./dist/locales/*.js"
+    },
+    "./styles.css": "./dist/styles.css",
+    "./package.json": "./package.json"
+  },
+  "types": "./dist/index.d.ts",
+  "style": "./dist/styles.css",
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "peerDependencies": {
+    "react": ">=19 <20",
+    "react-dom": ">=19 <20"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@base-ui/react": "1.8.0",
+    "@dnd-kit/core": "6.3.1",
+    "@dnd-kit/sortable": "10.0.0",
+    "@dnd-kit/utilities": "3.2.2",
+    "@hugeicons/core-free-icons": "4.3.5",
+    "@hugeicons/react": "1.1.10",
+    "@noble/hashes": "^2.4.0",
+    "class-variance-authority": "0.7.1",
+    "cn": "0.4.0",
+    "hls.js": "1.7.3",
+    "react-easy-crop": "6.2.3"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@playwright/test": "1.60.0",
+    "@tailwindcss/vite": "4.3.3",
+    "@testing-library/dom": "10.4.2",
+    "@testing-library/jest-dom": "6.9.1",
+    "@testing-library/react": "^16.3.3",
+    "@testing-library/user-event": "14.6.7",
+    "@types/node": "^24.13.6",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
+    "@vitejs/plugin-react": "6.1.1",
+    "eslint": "^10.12.0",
+    "eslint-plugin-react-hooks": "^7.1.1",
+    "globals": "^17.13.0",
+    "jsdom": "^29.1.1",
+    "postcss": "8.5.26",
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0",
+    "tailwindcss": "4.3.3",
+    "tw-animate-css": "1.4.0",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.71.1",
+    "vite": "8.3.0",
+    "vite-plugin-dts": "5.1.1",
+    "vitest": "^4.1.11"
+  },
+  "scripts": {
+    "build": "vite build",
+    "typecheck": "tsc --noEmit",
+    "contract": "cd ../.. && GOWORK=off go generate ./internal/contract",
+    "contract:check": "pnpm contract && git diff --exit-code -- src/client/generated ../../api ../../docs/api && test -z \"$(git status --porcelain -- src/client/generated ../../api ../../docs/api)\"",
+    "lint": "eslint .",
+    "test": "vitest run --project unit",
+    "test:integration": "vitest run --project integration",
+    "demo": "vite --config demo/vite.config.ts",
+    "screenshots": "playwright test",
+    "check": "pnpm typecheck && pnpm lint && pnpm test && pnpm build"
   }
-}
+}