@goodfellow-cms/admin 0.8.0 → 0.9.0

package/dist/text.d.ts

@@ -0,0 +1,52 @@
+import { r as defaultStrings } from "./strings-CWaRN_0v.js";
+import { AdminTextFile } from "@goodfellow-cms/core";
+import { AdminTextSource } from "@goodfellow-cms/ai";
+//#region src/admin-text-sources.d.ts
+type AdminTextTable = "strings" | "puck" | "labels";
+/** A source's key in one list of every table's: the table, a colon, then its own key, since labels' keys are words. */
+export declare function sourceKey(table: AdminTextTable, key: string): string;
+/** Everything the admin panel says in English, from every table, keyed with `sourceKey()`. */
+export declare function adminTextSources(labels: readonly string[]): AdminTextSource[];
+type SourceState = "missing" | "unusable" | "outdated" | "current";
+/**
+ * Where a string stands in a language's file: not there, there but not
+ * usable (`adminTextProblem()`), made from English that has changed since,
+ * or current. Labels are keyed by their English, so they can't be outdated.
+ */
+export declare function sourceState(file: AdminTextFile | undefined, source: AdminTextSource): SourceState;
+interface LanguageStatus {
+  total: number;
+  current: number;
+  outdated: number;
+  missing: number;
+  unusable: number;
+  /** Current strings someone who speaks the language has read. */
+  reviewed: number;
+}
+/** How much of the admin panel a language's file says. */
+export declare function languageStatus(file: AdminTextFile | undefined, sources: readonly AdminTextSource[]): LanguageStatus;
+/** The strings to translate: those missing or unusable, and with `outdated`, those made from English that has changed. */
+export declare function sourcesToTranslate(file: AdminTextFile | undefined, sources: readonly AdminTextSource[], options?: {
+  outdated?: boolean;
+}): AdminTextSource[];
+//#endregion
+//#region src/languages/en-puck.d.ts
+/**
+ * Puck's own English for the text Goodfellow translates, as its built-in
+ * dictionary has it (Puck doesn't export it), so the admin panel can have
+ * Puck's text translated for a site's own language, and check placeholders
+ * against it. A test keeps its keys the same as the Spanish table's.
+ */
+export declare const PUCK_ENGLISH: Readonly<Record<string, string>>;
+//#endregion
+//#region src/text.d.ts
+/**
+ * The labels Goodfellow's own blocks show, by their English: the built-in
+ * blocks', their groups', the page settings' and Goodfellow's registry
+ * blocks'. A site's own blocks add theirs.
+ */
+export declare const BUILT_IN_LABELS: readonly string[];
+/** Every string the admin panel shows in English, with Goodfellow's own blocks' labels. */
+export declare function goodfellowAdminTextSources(): import("@goodfellow-cms/ai").AdminTextSource[];
+//#endregion
+export { type AdminTextTable, type LanguageStatus, type SourceState, defaultStrings };

package/dist/text.js

@@ -0,0 +1,22 @@
+import { n as labels } from "./es-labels-DBu66eln.js";
+import { n as defaultStrings } from "./strings-D94noZrv.js";
+import { a as languageStatus, c as sourcesToTranslate, d as PUCK_ENGLISH, o as sourceKey, s as sourceState, t as adminTextSources } from "./admin-text-sources-BTZJPlVK.js";
+//#region src/text.ts
+/**
+* The admin panel's English, with nothing to draw: every string a site's own
+* admin text or a language pack translates, by `sourceKey()`, and how much of
+* it a language's file says. For tools and tests outside the admin panel, such
+* as a language pack's own checks, which can't load the admin panel itself.
+*/
+/**
+* The labels Goodfellow's own blocks show, by their English: the built-in
+* blocks', their groups', the page settings' and Goodfellow's registry
+* blocks'. A site's own blocks add theirs.
+*/
+const BUILT_IN_LABELS = Object.keys(labels).sort();
+/** Every string the admin panel shows in English, with Goodfellow's own blocks' labels. */
+function goodfellowAdminTextSources() {
+	return adminTextSources(BUILT_IN_LABELS);
+}
+//#endregion
+export { BUILT_IN_LABELS, PUCK_ENGLISH, adminTextSources, defaultStrings, goodfellowAdminTextSources, languageStatus, sourceKey, sourceState, sourcesToTranslate };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@goodfellow-cms/admin",
-  "version": "0.8.0",
-  "description": "Goodfellow's admin panel: a visual editor for a site's pages, layout and settings.",
+  "version": "0.9.0",
+  "description": "Goodfellow CMS's admin panel: a visual editor for a site's pages, layout and settings.",
   "keywords": [
     "goodfellow",
     "cms",
@@ -12,6 +12,10 @@
   ],
   "homepage": "https://goodfellow-cms.github.io/goodfellow-cms/docs/edit-pages",
   "bugs": "https://github.com/goodfellow-cms/goodfellow-cms/issues",
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/goodfellow-cms"
+  },
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -39,6 +43,10 @@
       "types": "./dist/plugin.d.ts",
       "import": "./dist/plugin.js"
     },
+    "./text": {
+      "types": "./dist/text.d.ts",
+      "import": "./dist/text.js"
+    },
     "./styles.css": "./styles.css",
     "./plugin.css": "./plugin.css",
     "./package.json": "./package.json"
@@ -56,11 +64,12 @@
     "@codemirror/state": "6.7.6",
     "@codemirror/theme-one-dark": "6.1.3",
     "@codemirror/view": "6.43.14",
-    "@goodfellow-cms/ai": "0.8.0",
-    "@goodfellow-cms/core": "0.8.0",
-    "@goodfellow-cms/react": "0.8.0",
-    "@goodfellow-cms/registry": "0.8.0",
+    "@goodfellow-cms/ai": "0.9.0",
+    "@goodfellow-cms/core": "0.9.0",
+    "@goodfellow-cms/react": "0.9.0",
+    "@goodfellow-cms/registry": "0.9.0",
     "codemirror": "6.0.2",
+    "fflate": "0.8.3",
     "lucide-react": "1.52.0",
     "turndown": "7.2.4",
     "turndown-plugin-gfm": "1.0.2"
@@ -71,7 +80,7 @@
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@goodfellow-cms/blocks": "0.8.0",
+    "@goodfellow-cms/blocks": "0.9.0",
     "@puckeditor/core": "0.23.0",
     "@types/react": "^19.2.0",
     "@types/react-dom": "^19.2.0",

package/styles.css

@@ -1502,6 +1502,7 @@ body,
 }
 
 .gfa-media-card {
+  position: relative;
   display: flex;
   flex-direction: column;
   gap: 8px;
@@ -1565,6 +1566,209 @@ body,
   gap: 4px;
 }
 
+.gfa-media-actions[hidden] {
+  display: none;
+}
+
+/* What an image shows, from the media library's descriptions, cut to two lines. */
+.gfa-media-description {
+  display: -webkit-box;
+  overflow: hidden;
+  font-size: 12px;
+  -webkit-line-clamp: 2;
+  -webkit-box-orient: vertical;
+}
+
+.gfa-media-card-selected {
+  border-color: var(--gfa-accent);
+  box-shadow: 0 0 0 1px var(--gfa-accent);
+}
+
+/* The box that chooses a file to delete with others, over its picture. */
+.gfa-media-check {
+  position: absolute;
+  top: 14px;
+  left: 14px;
+  width: 20px;
+  height: 20px;
+  accent-color: var(--gfa-accent);
+}
+
+.gfa-media-selection {
+  position: sticky;
+  top: 0;
+  z-index: 1;
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 8px;
+  margin-bottom: 12px;
+  padding: 8px 12px;
+  background: var(--gfa-surface);
+  border: 1px solid var(--gfa-border);
+  border-radius: var(--gfa-radius);
+}
+
+.gfa-media-selection > span {
+  margin-right: auto;
+  font-weight: 600;
+}
+
+.gfa-media-tags {
+  overflow: hidden;
+  font-size: 12px;
+  color: var(--gfa-muted);
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+/* An image's focal point: the picture, clicked where it must stay in view, with a dot there. */
+.gfa-focus-picker {
+  position: relative;
+  display: block;
+  width: fit-content;
+  max-width: 100%;
+  padding: 0;
+  cursor: crosshair;
+  background: repeating-conic-gradient(var(--gfa-checker) 0 25%, var(--gfa-checker-alt) 0 50%) 50% / 16px 16px;
+  border: 1px solid var(--gfa-border);
+  border-radius: 4px;
+}
+
+.gfa-focus-picker img {
+  display: block;
+  /* SVGs that give only their shape would otherwise have no width in a box that takes the picture's. */
+  min-width: 200px;
+  max-width: 100%;
+  max-height: 280px;
+  user-select: none;
+}
+
+.gfa-focus-dot {
+  position: absolute;
+  width: 18px;
+  height: 18px;
+  background: var(--gfa-accent);
+  border: 3px solid var(--gfa-surface);
+  border-radius: 50%;
+  box-shadow: 0 0 0 1px var(--gfa-text);
+  transform: translate(-50%, -50%);
+  pointer-events: none;
+}
+
+.gfa-focus-actions {
+  align-items: center;
+  justify-content: flex-start;
+}
+
+.gfa-tags {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+}
+
+.gfa-tag-list {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 6px;
+  margin: 0;
+  padding: 0;
+  list-style: none;
+}
+
+.gfa-tag {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  padding: 2px 4px 2px 10px;
+  font-size: 13px;
+  background: var(--gfa-bg);
+  border: 1px solid var(--gfa-border);
+  border-radius: 999px;
+}
+
+.gfa-tag-remove {
+  width: 22px;
+  height: 22px;
+  padding: 0;
+  font: inherit;
+  line-height: 1;
+  color: var(--gfa-muted);
+  cursor: pointer;
+  background: none;
+  border: 0;
+  border-radius: 50%;
+}
+
+.gfa-tag-remove:hover,
+.gfa-tag-remove:focus-visible {
+  color: var(--gfa-text);
+  background: var(--gfa-surface);
+}
+
+.gfa-tag-filter {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 4px;
+  margin: 0 0 12px;
+  padding: 0;
+  border: 0;
+}
+
+.gfa-tag-filter legend {
+  float: left;
+  margin-right: 8px;
+}
+
+.gfa-crop-tools {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 8px;
+}
+
+/* The picture being cropped, with the box that keeps part of it over it. */
+.gfa-crop-area {
+  position: relative;
+  overflow: hidden;
+  width: fit-content;
+  max-width: 100%;
+  touch-action: none;
+  background: repeating-conic-gradient(var(--gfa-checker) 0 25%, var(--gfa-checker-alt) 0 50%) 50% / 16px 16px;
+}
+
+.gfa-crop-area canvas {
+  display: block;
+  max-width: 100%;
+}
+
+.gfa-crop-box {
+  position: absolute;
+  padding: 0;
+  cursor: move;
+  background: transparent;
+  border: 2px solid var(--gfa-accent-text);
+  outline: 1px solid var(--gfa-accent);
+  box-shadow: 0 0 0 9999px rgb(0 0 0 / 0.5);
+}
+
+.gfa-crop-box:focus-visible {
+  outline: 3px solid var(--gfa-accent);
+}
+
+.gfa-crop-handle {
+  position: absolute;
+  right: -8px;
+  bottom: -8px;
+  width: 16px;
+  height: 16px;
+  cursor: nwse-resize;
+  background: var(--gfa-accent);
+  border: 2px solid var(--gfa-accent-text);
+  border-radius: 3px;
+}
+
 .gfa-media-chooser {
   display: flex;
   align-items: center;
@@ -1648,6 +1852,46 @@ body,
   min-width: 0;
 }
 
+.gfa-table-field-rich {
+  min-height: 2.25em;
+  white-space: pre-wrap;
+  overflow-wrap: anywhere;
+  cursor: text;
+}
+
+.gfa-table-field-rich a {
+  color: var(--gfa-accent);
+  text-decoration: underline;
+}
+
+.gfa-table-field-toolbar {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 4px;
+  margin-bottom: 8px;
+}
+
+.gfa-table-field-tool {
+  padding: 2px 8px;
+  border: 1px solid var(--gfa-border);
+  border-radius: var(--gfa-radius);
+  background: var(--gfa-surface);
+  color: var(--gfa-text);
+  cursor: pointer;
+}
+
+.gfa-table-field-tool:disabled {
+  cursor: default;
+  opacity: 0.4;
+}
+
+.gfa-table-field-link {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 4px;
+  width: 100%;
+}
+
 .gfa-table-field-remove {
   border: 1px solid var(--gfa-border);
   border-radius: var(--gfa-radius);
@@ -2392,6 +2636,73 @@ body,
   border: 0;
 }
 
+/* Links to items: the chosen ones, then a search and what it finds. */
+.gfa-item-picker {
+  display: grid;
+  gap: 6px;
+}
+
+.gfa-item-picker-chosen,
+.gfa-item-picker-matches,
+.gfa-images-field ul {
+  display: grid;
+  gap: 4px;
+  margin: 0;
+  padding: 0;
+  list-style: none;
+}
+
+.gfa-chosen-row {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  padding: 2px 4px 2px 8px;
+  border: 1px solid var(--gfa-border);
+  border-radius: 6px;
+}
+
+.gfa-chosen-row-name {
+  flex: 1;
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.gfa-item-picker-matches {
+  max-height: 200px;
+  overflow-y: auto;
+}
+
+.gfa-item-picker-matches button {
+  width: 100%;
+  padding: 4px 8px;
+  border: 0;
+  border-radius: 4px;
+  background: none;
+  color: inherit;
+  font: inherit;
+  text-align: start;
+  cursor: pointer;
+}
+
+.gfa-item-picker-matches button:hover,
+.gfa-item-picker-matches button:focus-visible {
+  background: var(--gfa-current-bg);
+}
+
+.gfa-images-field {
+  display: grid;
+  gap: 8px;
+}
+
+.gfa-images-field-thumb {
+  width: 40px;
+  height: 40px;
+  object-fit: cover;
+  border-radius: 4px;
+}
+
 .gfa-event-days {
   display: flex;
   flex-wrap: wrap;
@@ -2446,6 +2757,19 @@ body,
   background: var(--gfa-checker);
 }
 
+/* A small picture beside the words, as links with summary cards show. */
+.gfa-share-card-small {
+  display: grid;
+  grid-template-columns: 96px 1fr;
+  align-items: center;
+}
+
+.gfa-share-card-small .gfa-share-image {
+  height: 100%;
+  min-height: 96px;
+  aspect-ratio: 1;
+}
+
 .gfa-share-no-image {
   display: grid;
   place-items: center;
@@ -2594,3 +2918,212 @@ body,
   margin-bottom: 6px;
   font-weight: 600;
 }
+
+/* A synced block on the editor's canvas, drawn read-only in place of its Synced block, with a link to edit it. */
+.gfa-synced-block {
+  outline: 2px dashed var(--gfa-accent);
+  outline-offset: -2px;
+}
+
+.gfa-synced-block-bar {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 4px 12px;
+  align-items: center;
+  justify-content: space-between;
+  padding: 4px 10px;
+  background: var(--gfa-accent);
+  color: var(--gfa-accent-text);
+  font:
+    13px / 1.4 ui-sans-serif,
+    system-ui,
+    sans-serif;
+}
+
+.gfa-synced-block-bar a {
+  color: inherit;
+  font-weight: 600;
+  text-decoration: underline;
+}
+
+.gfa-synced-block-missing p {
+  margin: 0;
+  padding: 16px;
+  color: var(--gfa-text);
+  background: var(--gfa-surface);
+  font:
+    14px / 1.5 ui-sans-serif,
+    system-ui,
+    sans-serif;
+}
+
+/* InfoBubble: an "i" whose words show while it's pointed at or focused, and which opens the documentation. */
+.gfa-info {
+  position: relative;
+  display: inline-flex;
+  vertical-align: middle;
+  margin-inline-start: 6px;
+}
+
+.gfa-info-button {
+  display: inline-flex;
+  color: var(--gfa-muted);
+  border-radius: 999px;
+}
+
+.gfa-info-button:hover,
+.gfa-info-button:focus-visible {
+  color: var(--gfa-accent);
+}
+
+.gfa-info-text {
+  position: absolute;
+  bottom: calc(100% + 8px);
+  left: 50%;
+  z-index: 30;
+  width: max-content;
+  max-width: min(320px, 80vw);
+  padding: 6px 10px;
+  border-radius: var(--gfa-radius);
+  background: var(--gfa-tooltip-bg);
+  color: var(--gfa-tooltip-text);
+  font-size: 13px;
+  font-weight: 400;
+  line-height: 1.4;
+  box-shadow: 0 4px 12px rgb(15 23 42 / 0.18);
+  pointer-events: none;
+  opacity: 0;
+  transform: translate(-50%, 4px);
+  transition:
+    opacity 140ms ease,
+    transform 140ms ease;
+}
+
+.gfa-info:hover .gfa-info-text,
+.gfa-info:focus-within .gfa-info-text {
+  opacity: 1;
+  transform: translate(-50%, 0);
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .gfa-info-text {
+    transition: opacity 140ms ease;
+    transform: translate(-50%, 0);
+  }
+}
+
+/* The site's own fonts on the Colors & fonts tab. */
+.gfa-own-fonts {
+  display: grid;
+  gap: 8px;
+  margin: 0 0 12px;
+  padding: 0;
+  list-style: none;
+}
+
+.gfa-own-font {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  padding: 10px 12px;
+  border: 1px solid var(--gfa-border);
+  border-radius: var(--gfa-radius);
+  background: var(--gfa-surface);
+}
+
+.gfa-own-font-name {
+  flex: 1;
+  font-size: 18px;
+}
+
+.gfa-font-files {
+  width: 100%;
+  border-collapse: collapse;
+  margin: 8px 0 12px;
+}
+
+.gfa-font-files th,
+.gfa-font-files td {
+  padding: 6px 8px 6px 0;
+  text-align: start;
+  vertical-align: middle;
+}
+
+.gfa-font-files th {
+  font-weight: 500;
+  color: var(--gfa-muted);
+  font-size: 13px;
+}
+
+.gfa-font-group {
+  padding: 6px 10px 2px;
+  color: var(--gfa-muted);
+  font-size: 12px;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+}
+
+/* The Go to box (Ctrl+K) and the list of shortcuts (?). */
+.gfa-goto {
+  display: grid;
+  gap: 8px;
+  width: min(520px, calc(100vw - 64px));
+}
+
+.gfa-goto input {
+  width: 100%;
+  padding: 8px 10px;
+  font: inherit;
+  border: 1px solid var(--gfa-border);
+  border-radius: var(--gfa-radius);
+  background: var(--gfa-surface);
+  color: inherit;
+}
+
+.gfa-goto-list {
+  max-height: min(400px, 60vh);
+  overflow-y: auto;
+}
+
+.gfa-goto-option {
+  display: flex;
+  align-items: baseline;
+  justify-content: space-between;
+  gap: 12px;
+  padding: 8px 10px;
+  border-radius: 4px;
+  cursor: pointer;
+}
+
+.gfa-goto-option[aria-selected="true"] {
+  background: var(--gfa-bg);
+}
+
+.gfa-goto-label {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.gfa-goto-option .gfa-hint {
+  flex-shrink: 0;
+  margin: 0;
+}
+
+.gfa-shortcuts td {
+  padding: 6px 12px 6px 0;
+  vertical-align: top;
+}
+
+.gfa-shortcuts kbd {
+  display: inline-block;
+  min-width: 1.6em;
+  padding: 1px 6px;
+  font: inherit;
+  font-size: 13px;
+  text-align: center;
+  border: 1px solid var(--gfa-border);
+  border-radius: 4px;
+  background: var(--gfa-bg);
+}