@jini-ai/admin 0.4.10 → 0.4.12

package/dist/seo/rules.js

@@ -23,7 +23,7 @@ export function sortIssuesBySeverity({ issues }, _optional = {}) {
 /**
  * One edited per-entry override field's outgoing value. An emptied text/URL box means "remove this
  * override so the entry falls back to the site default", which on the wire is `null` — the clear
- * sentinel `SeoExtFieldsPatch` documents (`apps/website/src/features/seo/types.ts`) and
+ * sentinel `SeoExtFieldsPatch` documents (`features/seo/types.ts`) and
  * `setEntrySeoOverrides` implements by `delete`-ing the key.
  *
  * It is NOT `""`. `write-service.ts` stores `""` as a genuine override and `seo.ts` resolves
@@ -46,6 +46,43 @@ export function overrideOrClear({ value }, _optional = {}) {
 export function orEmpty({ value }, _optional = {}) {
     return value ?? "";
 }
+/** One entry's effective X value next to its effective social preview value, per field. Images
+ *  compare by source ref (the resolved URL is resized), falling back to the URL for pasted ones. */
+function xAndSocial({ meta }) {
+    return {
+        twitterTitle: [meta.twitter.title, meta.openGraph.title],
+        twitterDescription: [meta.twitter.description, meta.openGraph.description],
+        twitterImage: [meta.twitter.imageRef ?? meta.twitter.image, meta.openGraph.imageRef ?? meta.openGraph.image],
+    };
+}
+/** Whether this entry's X card differs from its social preview in any field — i.e. an X override
+ *  is in effect, so the "Customize for X/Twitter" disclosure opens on load. (2026-10-15, owner: one
+ *  generic social preview, X only as an optional customization.)
+ *  @complexity O(1). */
+export function xIsCustomized({ meta }, _optional = {}) {
+    return Object.values(xAndSocial({ meta })).some(([x, social]) => x !== social);
+}
+/** An X field's untouched box value, handed to `fieldValue` as its resolved value (so a pending
+ *  edit or clear still wins there). An X value equal to the social preview's is inherited, so the
+ *  box stays empty and its placeholder shows the live social value — typing there is what creates
+ *  an X override.
+ *  @complexity O(1). */
+export function xResolvedValue({ key, meta }, _optional = {}) {
+    const [x, social] = xAndSocial({ meta })[key];
+    return x === social ? '' : x ?? '';
+}
+/** The X field an edit to a social preview field should carry along: when X still shows the
+ *  preview's value and has no pending edit of its own, the edit also clears X's stored override so
+ *  X keeps following the preview after save. Without it, an X override saved equal to the preview
+ *  (indistinguishable here, the screen sees only effective values) would silently pin X to the old
+ *  text. Clearing an override that does not exist is a no-op on the server.
+ *  @complexity O(1). */
+export function inheritedXFor({ key, meta, touched }, _optional = {}) {
+    const xKey = { ogTitle: 'twitterTitle', ogDescription: 'twitterDescription', ogImage: 'twitterImage' }[key];
+    if (!xKey || xKey in touched)
+        return null;
+    return xResolvedValue({ key: xKey, meta }) === '' ? xKey : null;
+}
 /** A pending-action button's label — `react/pages/SeoPage.tsx` uses this for both the save-settings button
  *  ("Saving…"/"Save settings") and the regenerate-sitemap button ("Working…"/"Regenerate
  *  sitemap"), same `pending ? … : …` shape, different copy. Also reused by `SitemapModal.tsx`'s
@@ -89,10 +126,10 @@ export function filterSitemapEntries({ entries, query }, _optional = {}) {
  * `MediaRefField`'s ref-building/preview logic (`ogImage`/`twitterImage`/`defaultOgImage` all
  * share this shape — SPEC intent: "make the OG image selectable, with a preview"). The reference
  * format itself is NOT reinvented here — it is verified, not guessed, against the one function that
- * actually parses it server-side: `resolveSeoImageRef` (`apps/website/src/features/seo/media.ts`)
+ * actually parses it server-side: `resolveSeoImageRef` (`features/seo/media.ts`)
  * accepts either an already-absolute URL, passed through unchanged, or a bare `{assetId}:{transformName}`
  * pair split on the FIRST `:`. `isAbsoluteMediaRef`/`parseMediaRefAssetId` below duplicate that
- * parsing rather than import across the app boundary (apps/admin has no dependency on apps/website)
+ * parsing rather than import across the app boundary (the admin UI has no dependency on the host server)
  * — kept in lockstep by this doc comment naming the source of truth; a change to that split MUST
  * update both.
  */
@@ -101,7 +138,7 @@ export function filterSitemapEntries({ entries, query }, _optional = {}) {
  *  `transformName: "public"` for the identical `{assetId}:{transformName}` shape it writes into a
  *  post body's image node. */
 const SEO_IMAGE_TRANSFORM = "public";
-/** Mirrors `resolveSeoImageRef`'s own `isAbsoluteUrl` (`apps/website/src/features/seo/media.ts`) —
+/** Mirrors `resolveSeoImageRef`'s own `isAbsoluteUrl` (`features/seo/media.ts`) —
  *  see this section's file-header doc for why this is a duplicate, not an import. */
 const ABSOLUTE_URL_PATTERN = /^[a-z][a-z0-9+.-]*:\/\//i;
 function isAbsoluteMediaRef(value) {
@@ -126,10 +163,68 @@ export function isStoredMediaRef({ value }, _optional = {}) {
     // A URL typed one character at a time reaches "https:/" before it reaches "https://".
     return !trimmed.includes(":/") && parseMediaRefAssetId(trimmed) !== null;
 }
+const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/** What an image field shows for its value — the file's name and pixel size — in place of the raw
+ * `{slug}:public` reference or URL (owner, 2026-10-15: a read-only "Selected image" box "looks
+ * useless"). The library row wins when the host can list media; otherwise a readable slug or the
+ * URL's file name stands in, and an opaque id falls back to the translated "Image".
+ * Size prefers the stored dimensions, then the decoded preview's natural size.
+ * @example describeMediaRef({ value: 'sunset:public', media: [{ id: 'a1', slug: 'sunset', title: 'Sunset', width: 1200, height: 630 }] }) // { name: 'Sunset', size: '1200 × 630' }
+ * @complexity O(m) over the media rows; no I/O.
+ */
+export function describeMediaRef({ value, media }, { width, height, t = key => key, extensionFor } = {}) {
+    const trimmed = typeof value === 'string' ? value.trim() : '';
+    if (!trimmed)
+        return null;
+    const key = parseMediaRefAssetId(trimmed);
+    const row = key ? media?.find(item => item.id === key || item.slug === key) : undefined;
+    const name = row?.title ? withExtension({ name: row.title, extension: row.contentType && extensionFor ? extensionFor(row.contentType) : '' }) : fallbackMediaName({ key, value: trimmed, t });
+    return { name, size: pixelSize(row?.width ?? width, row?.height ?? height) };
+}
+/** A library title reads as a file name (owner, 2026-10-15: "it should be testing-page.png or
+ * whatever the extension is"). No original upload name is stored, so the extension comes from the
+ * stored bytes' type; a title that already ends in it is left alone. */
+function withExtension({ name, extension }) {
+    return extension && !name.toLowerCase().endsWith(extension) ? `${name}${extension}` : name;
+}
+/** Whether an entry's social preview image comes from content or the site default, with no override
+ * of its own, so the field shows its source muted. "Using site default" is the original copy (owner,
+ * 2026-10-15). A pending edit is the entry's own, and so is a stored override the host flags
+ * (`imageOverridden`) even when it equals the default. A host without that flag can't tell such an
+ * override apart, so it reads as inherited (same image either way). Returns 'content' for an image
+ * the host identifies as content, 'default' for the site default, and false for an own/absent image.
+ * @complexity O(1). */
+export function ogImageInherited({ meta, defaultOgImage, touched }, _optional = {}) {
+    if ('ogImage' in touched || meta.openGraph.imageOverridden)
+        return false;
+    const image = meta.openGraph.imageRef ?? meta.openGraph.image;
+    if (meta.openGraph.imageSource === 'content' && image)
+        return 'content';
+    return defaultOgImage && image === defaultOgImage ? 'default' : false;
+}
+function fallbackMediaName({ key, value, t }) {
+    if (!key)
+        return urlFileName(value);
+    return UUID_PATTERN.test(key) ? t('Image') : key;
+}
+function pixelSize(width, height) {
+    return width && height ? `${width} × ${height}` : null;
+}
+/** The last path segment of an image URL ("https://cdn.example/a/pic.png" → "pic.png"). */
+function urlFileName(value) {
+    try {
+        const url = new URL(value, 'https://placeholder.invalid');
+        const last = url.pathname.split('/').filter(Boolean).pop();
+        return last ? decodeURIComponent(last) : url.hostname || value;
+    }
+    catch {
+        return value;
+    }
+}
 /** Builds the `{slug}:public` reference `MediaRefField` writes into the field on selection —
  *  prefers the asset's readable slug over its id (readable-slugs S5b, 2026-09-23), matching
  *  `resolveSeoImageRef`'s own id-or-slug lookup server-side (`findMediaByIdOrSlug`,
- *  `apps/website/src/features/seo/media.ts`, S4) so a saved override reads as a slug, not an opaque
+ *  `features/seo/media.ts`, S4) so a saved override reads as a slug, not an opaque
  *  uuid. Falls back to `id` when `slug` is empty — defensive only; a real upload always derives one
  *  (`deriveUniqueMediaSlug`). Same `transformName: "public"` `EmbedInsertControl.tsx` already writes
  *  for an inserted image node. An old stored `{assetId}:public` value keeps resolving regardless
@@ -149,7 +244,7 @@ export function buildMediaRef({ item }, _optional = {}) {
  *  "string"` also resolves to `null` rather than throwing — `MediaRefField`'s `value` prop is a
  *  `fieldValue(key, resolved) ?? ""` fallback chain (`react/pages/SeoPage.tsx`), where `??` does not replace a
  *  non-nullish-but-wrong-typed result from a misbehaving caller; matches `resolveSeoImageRef`'s own
- *  "never throws over one bad reference" contract (`apps/website/src/features/seo/media.ts`).
+ *  "never throws over one bad reference" contract (`features/seo/media.ts`).
  *
  * @complexity O(1) — string parsing only, no I/O (the returned URL is a template; the browser
  * performs the actual fetch only once it is used as an `<img src>`). */
@@ -205,7 +300,7 @@ export function shareImageWarning({ value, previewUrl, width, height, byteSize,
 /** One `FormData` field as a string, with the caller's fallback for an absent field. Its own named
  *  function purely so {@link buildSeoSettingsPatch} below stays readable at a glance: written
  *  inline, the seven fields' `?? `/`||` chains scored the patch builder at the ESLint ceiling
- *  (`apps/admin` enforces 9/9 as a hard error) for no gain in clarity. */
+ *  (the admin lint policy enforces 9/9 as a hard error) for no gain in clarity. */
 function formString(form, key, fallback = "") {
     return String(form.get(key) ?? fallback);
 }
@@ -214,7 +309,7 @@ function formString(form, key, fallback = "") {
  *
  * `null` is what CLEARS a site default: the server registers these three (`default_description`,
  * `default_og_image`, `twitter_site`) as `nullable: true` and `buildScalarWrites`
- * (`apps/website/src/features/seo/settings.ts`) normalizes `null` to the `""` absent-sentinel that
+ * (`features/seo/settings.ts`) normalizes `null` to the `""` absent-sentinel that
  * `getSeoSettings` reads back as `undefined`.
  *
  * It used to return `undefined`, under a comment claiming "an empty box means 'no site default'".
@@ -259,4 +354,35 @@ export const SEO_TAB_IDS = ['defaults', 'sitemap', 'entries'];
 export function resolveSeoTabId({ tabId }, _optional = {}) {
     return SEO_TAB_IDS.find(id => id === tabId) ?? 'defaults';
 }
+/** Colour band for the analysis score pill: the same success/warning/failure tones the issue pills
+ * use, so a 100 reads green and a failing page reads red at a glance.
+ * @example scoreTone({ score: 100 }) // 'success'
+ */
+export function scoreTone({ score }, _optional = {}) {
+    if (score >= 80)
+        return 'success';
+    return score >= 50 ? 'warning' : 'failure';
+}
+/**
+ * Picker rows for the Pages & posts tab. Pages lead because they are fewer and are the usual SEO
+ * targets (home, about, pricing); a published entry carries no pill, so only the exceptions
+ * (draft, scheduled, …) draw the eye. An untitled entry stays pickable by its id.
+ * @example entryPickerOptions({ posts, pages }, { t }) // [{ value: 'p1', label: 'About', group: 'Pages' }, …]
+ */
+export function entryPickerOptions({ posts, pages }, { t = key => key } = {}) {
+    // Two entries can share a title ("Landing Page" twice, owner 2026-10-15); both stay listed and
+    // each duplicate shows its slug as muted secondary text so the operator can tell them apart.
+    const rows = (entries, group) => {
+        const labelOf = (entry) => entry.title.trim() || entry.id;
+        const counts = new Map();
+        for (const entry of entries)
+            counts.set(labelOf(entry), (counts.get(labelOf(entry)) ?? 0) + 1);
+        return entries.map((entry) => ({
+            value: entry.id, label: labelOf(entry), group,
+            ...(entry.status && entry.status !== 'published' ? { badge: t(entry.status) } : {}),
+            ...((counts.get(labelOf(entry)) ?? 0) > 1 ? { detail: entry.slug || entry.id } : {}),
+        }));
+    };
+    return [...rows(pages, t('Pages')), ...rows(posts, t('Posts'))];
+}
 //# sourceMappingURL=rules.js.map

package/dist/seo/seo.module.d.ts

@@ -29,21 +29,24 @@ export declare const seoModule: {
         readonly "Canonical URL": "Canonical URL";
         readonly Noindex: "Noindex";
         readonly Nofollow: "Nofollow";
-        readonly "OG title": "OG title";
-        readonly "OG description": "OG description";
-        readonly "OG image": "OG image";
-        readonly "Twitter title": "Twitter title";
-        readonly "Twitter description": "Twitter description";
-        readonly "Twitter image": "Twitter image";
+        readonly "Preview title": "Preview title";
+        readonly "Preview description": "Preview description";
+        readonly "Preview image": "Preview image";
+        readonly "X/Twitter title": "X/Twitter title";
+        readonly "X/Twitter description": "X/Twitter description";
+        readonly "X/Twitter image": "X/Twitter image";
+        readonly "Customize for X/Twitter (optional)": "Customize for X/Twitter (optional)";
+        readonly "Same as the preview image": "Same as the preview image";
+        readonly "Used by Facebook, LinkedIn, Slack, Discord, iMessage, WhatsApp and X/Twitter": "Used by Facebook, LinkedIn, Slack, Discord, iMessage, WhatsApp and X/Twitter";
         readonly "Saving\u2026": "Saving…";
         readonly "Save overrides": "Save overrides";
         readonly "Per-entry SEO": "Per-entry SEO";
         readonly "Search appearance": "Search appearance";
         readonly "Title template (must contain %s)": "Title template (must contain %s)";
         readonly "Default meta description": "Default meta description";
-        readonly "Social sharing": "Social sharing";
-        readonly "Default Open Graph / Twitter image": "Default Open Graph / Twitter image";
-        readonly "Twitter @site handle": "Twitter @site handle";
+        readonly "Social preview": "Social preview";
+        readonly "Default preview image": "Default preview image";
+        readonly "X/Twitter @handle": "X/Twitter @handle";
         readonly Crawling: "Crawling";
         readonly "Default noindex": "Default noindex";
         readonly "Default nofollow": "Default nofollow";
@@ -56,7 +59,7 @@ export declare const seoModule: {
         readonly "View sitemap": "View sitemap";
         readonly "Loading SEO settings\u2026": "Loading SEO settings…";
         readonly Marketing: "Marketing";
-        readonly "Site-wide defaults for meta titles, descriptions, Open Graph/Twitter cards, and robots directives.": "Site-wide defaults for meta titles, descriptions, Open Graph/Twitter cards, and robots directives.";
+        readonly "Site-wide defaults for meta titles, descriptions, social previews, and robots directives.": "Site-wide defaults for meta titles, descriptions, social previews, and robots directives.";
         readonly "Choose image": "Choose image";
         readonly Remove: "Remove";
         readonly "Sitemap \u00B7 {count} URLs": "Sitemap · {count} URLs";
@@ -84,6 +87,8 @@ export declare const seoModule: {
         readonly "failed to load the sitemap": "failed to load the sitemap";
         readonly "Could not load the sitemap (HTTP {status}).": "Could not load the sitemap (HTTP {status}).";
         readonly "Selected image": "Selected image";
+        readonly "Using site default: {name}": "Using site default: {name}";
+        readonly "Using image from page content: {name}": "Using image from page content: {name}";
     };
     readonly pages: {
         readonly settings: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jini-ai/admin",
-  "version": "0.4.10",
+  "version": "0.4.12",
   "description": "Composable admin surface for Jini-hosted products: framework-free contracts, panel registry, and route model in `/core`; React shell and panels in `/react`. Import only the layers you need.",
   "license": "Apache-2.0",
   "repository": {
@@ -79,6 +79,12 @@
       "./consent/react": "browser"
     },
     "isolation": {
+      "shared": [
+        "src/react/components/DataTable.tsx",
+        "src/react/components/ConfirmDialog",
+        "src/react/components/RowMenu",
+        "src/react/types.ts"
+      ],
       "forbidden": {
         "universal": [
           "node:",
@@ -434,10 +440,10 @@
     "react": "^18.3.0 || ^19.0.0",
     "react-dom": "^18.3.0 || ^19.0.0",
     "@jini-ai/agentic": "^0.4.4",
-    "@jini-ai/ui": "^0.5.1",
+    "@jini-ai/ui": "^0.5.5",
     "@jini-ai/ui-kit": "^0.1.3",
     "@jini-ai/agent-plugins": "^0.4.3",
-    "@jini-ai/cms": "^0.5.11",
+    "@jini-ai/cms": "^0.5.13",
     "@jini-ai/core": "^0.4.3"
   },
   "peerDependenciesMeta": {
@@ -476,12 +482,12 @@
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
     "@testing-library/user-event": "^14.6.1",
-    "@jini-ai/cms": "^0.5.11",
-    "@jini-ai/ui-kit": "^0.1.4",
-    "@jini-ai/core": "^0.4.5",
-    "@jini-ai/ui": "^0.5.1",
     "@jini-ai/agentic": "^0.4.4",
-    "@jini-ai/agent-plugins": "^0.4.6"
+    "@jini-ai/agent-plugins": "^0.4.7",
+    "@jini-ai/ui-kit": "^0.1.4",
+    "@jini-ai/cms": "^0.5.13",
+    "@jini-ai/core": "^0.4.7",
+    "@jini-ai/ui": "^0.5.5"
   },
   "typesVersions": {
     "*": {