ampless 1.0.0-beta.63 → 1.0.0-beta.64

package/dist/index.d.ts

@@ -165,13 +165,55 @@ interface ThemeLinkListField extends Omit<ThemeFieldBase, 'default' | 'cssVar'>
     maxItems?: number;
 }
 type ThemeField = ThemeColorField | ThemeTextField | ThemeSelectField | ThemeImageField | ThemeLengthField | ThemeFontFamilyField | ThemeLinkListField;
+/**
+ * Where a theme-declared custom class can be applied. Only `table` is
+ * supported today: the class goes on the tiptap `table` node and renders
+ * as `tiptap-table--<id>` next to the base `tiptap-table` class.
+ */
+type ThemeCustomClassTarget = 'table';
+/**
+ * A class the theme styles and that editors can opt a block into, e.g.
+ * `{ id: 'compact', label: 'Compact', target: 'table' }` with theme CSS for
+ * `.tiptap-table--compact`. The id must match `CUSTOM_CLASS_ID_PATTERN`.
+ */
+interface ThemeCustomClass {
+    id: string;
+    label: LocalizedString;
+    description?: LocalizedString;
+    target: ThemeCustomClassTarget;
+}
 interface ThemeManifest {
     /** Theme directory name (`themes/<name>/`). */
     name: string;
     label: LocalizedString;
     description?: LocalizedString;
     fields: ReadonlyArray<ThemeField>;
+    /**
+     * Optional classes this theme styles and lets editors apply to blocks
+     * (see `ThemeCustomClass`). The admin editor offers the active theme's
+     * entries; ids stored in posts keep rendering after a theme switch.
+     */
+    customClasses?: ReadonlyArray<ThemeCustomClass>;
 }
+/**
+ * Allowed custom class ids: lowercase letters, digits and hyphens. The
+ * renderers re-check this on every render (post bodies can be written via
+ * MCP / GraphQL, not only through the admin), so an id can never break out
+ * of the `class` attribute.
+ */
+declare const CUSTOM_CLASS_ID_PATTERN: RegExp;
+/** Max length of a custom class id (keeps generated class names sane). */
+declare const CUSTOM_CLASS_ID_MAX_LENGTH = 64;
+/** True when `id` is a string usable as a custom class id. */
+declare function isValidCustomClassId(id: unknown): id is string;
+/** Class name emitted for a table custom class id (`tiptap-table--<id>`). */
+declare function tableCustomClassName(id: string): string;
+/**
+ * Valid `target: 'table'` entries of a manifest, de-duplicated by id
+ * (first wins). Invalid ids are dropped with a console warning so a typo
+ * in a theme never reaches the editor or the markup.
+ */
+declare function themeTableClasses(manifest: Pick<ThemeManifest, 'customClasses' | 'name'>): ThemeCustomClass[];
 declare function defineTheme(m: ThemeManifest): ThemeManifest;
 /**
  * Resolve a `LocalizedString` to a plain string for display.
@@ -2194,4 +2236,4 @@ declare function pickDefaultEntrypoint(files: readonly {
 
 declare const VERSION = "0.0.1";
 
-export { type AiConfig, type AmplessEvent, type AmplessPlugin, type AuthContext, type BoundedScanOptions, type BoundedScanPage, type BoundedScanResult, type BoundedScanTruncation, type BundleExtractResult, type CacheConfig, type CacheStrategy, type Config, type ContentEventPayload, type ContentEventType, type ContentFieldRenderer, type ContentFormat, type ContentTypeDefinition, type CreatePostInput, DEFAULT_ENTRYPOINT, type DateFormat, type EventPayloadOf, type EventType, type ExtractedFile, type FieldDefinition, type FieldType, type HistoryConfig, type ImageDisplay, type KvItem, type KvStore, type LinkListItem, type ListOptions, type ListPostHistoryOptions, type LocalizedString, MAX_BUNDLE_BYTES, type MarkdownEmbedMatch, type Media, type MediaEventPayload, type MediaEventType, type MediaMetadata, type MediaProcessingDefaults, type OgImageConfig, type OgImageFont, type OgImageRenderContext, PLUGIN_KEY_PATTERN, type Page, type PluginBooleanField, type PluginCapability, type PluginCodeField, type PluginEventHandler, type PluginHookResult, type PluginJsonField, type PluginMetadata, type PluginNumberField, type PluginPackageManifest, type PluginPublicRenderContext, type PluginRepeatableField, type PluginRepeatableSubField, type PluginRuntimeContext, type PluginSecretField, type PluginSelectField, type PluginSettingField, type PluginSettingsManifest, type PluginTextField, type PluginTextareaField, type PluginUninstallContext, type PluginUrlField, type Post, type PostIndexEventPayload, type PostIndexEventType, type PostListFilterOptions, type PostListSort, type PostListStatusFilter, type PostMetadata, type PostRevision, type PostRevisionConnection, type PostStatus, type PostSummary, type PostsProvider, type PublicBodyDescriptor, type PublicHeadDescriptor, type PublicPostBodyDescriptor, type PublicPostHtmlDescriptor, type PublicPostHtmlPosition, type PublicPostScriptDescriptor, type Role, SITE_CONFIG_PK, type ScriptStrategy, type SiteSettingsEventPayload, type SiteSettingsEventType, type StaticPostBody, type StaticPostFileMeta, type StreamEventName, type SummaryListOptions, TEXT_EXTENSIONS, type ThemeColorField, type ThemeField, type ThemeFieldType, type ThemeFontFamilyField, type ThemeImageField, type ThemeLengthField, type ThemeLinkListField, type ThemeManifest, type ThemeModule, type ThemeRouteContext, type ThemeSelectField, type ThemeTextField, type TiptapNodeHtmlAdapters, type TiptapNodeMarkdownAdapters, type TiptapNodeToHtml, type TiptapNodeToMarkdown, type TiptapRenderNode, type TrustLevel, type TrustedPluginRuntimeContext, VERSION, type ValidationIssue, bundlePrefix, collectBounded, collectTags, createPost, decodeAwsJson, defineConfig, definePlugin, defineSchema, defineTheme, defineThemeModule, deletePost, deleteSiteSetting, detectContentEvents, encodeAwsJson, escapeXml, extractFirstImageUrl, filterSortPostSummaries, findAbsolutePathRefs, flattenSettings, formatColorPair, formatDate, formatPublicAssetUrl, getKvStore, getPost, getPostById, getSiteSetting, hasKvStore, hasPostsProvider, isTagListUrl, isValidPluginKey, listPostHistory, listPostSummaries, listPosts, listSiteSettings, mimeTypeFor, parseColorPair, parseLinkList, pickDefaultEntrypoint, resolveLocalized, resolvePluginSettings, resolvePublicMcpEndpoint, resolveThemeValues, setKvStore, setPostsProvider, setSiteSetting, stringifyLinkList, stripCommonPrefix, themeSettingKey, unflattenSettings, updatePost, validateBundle, validateBundlePath, validatePluginSettingValue, validatePublicAssetKey, validateThemeValue };
+export { type AiConfig, type AmplessEvent, type AmplessPlugin, type AuthContext, type BoundedScanOptions, type BoundedScanPage, type BoundedScanResult, type BoundedScanTruncation, type BundleExtractResult, CUSTOM_CLASS_ID_MAX_LENGTH, CUSTOM_CLASS_ID_PATTERN, type CacheConfig, type CacheStrategy, type Config, type ContentEventPayload, type ContentEventType, type ContentFieldRenderer, type ContentFormat, type ContentTypeDefinition, type CreatePostInput, DEFAULT_ENTRYPOINT, type DateFormat, type EventPayloadOf, type EventType, type ExtractedFile, type FieldDefinition, type FieldType, type HistoryConfig, type ImageDisplay, type KvItem, type KvStore, type LinkListItem, type ListOptions, type ListPostHistoryOptions, type LocalizedString, MAX_BUNDLE_BYTES, type MarkdownEmbedMatch, type Media, type MediaEventPayload, type MediaEventType, type MediaMetadata, type MediaProcessingDefaults, type OgImageConfig, type OgImageFont, type OgImageRenderContext, PLUGIN_KEY_PATTERN, type Page, type PluginBooleanField, type PluginCapability, type PluginCodeField, type PluginEventHandler, type PluginHookResult, type PluginJsonField, type PluginMetadata, type PluginNumberField, type PluginPackageManifest, type PluginPublicRenderContext, type PluginRepeatableField, type PluginRepeatableSubField, type PluginRuntimeContext, type PluginSecretField, type PluginSelectField, type PluginSettingField, type PluginSettingsManifest, type PluginTextField, type PluginTextareaField, type PluginUninstallContext, type PluginUrlField, type Post, type PostIndexEventPayload, type PostIndexEventType, type PostListFilterOptions, type PostListSort, type PostListStatusFilter, type PostMetadata, type PostRevision, type PostRevisionConnection, type PostStatus, type PostSummary, type PostsProvider, type PublicBodyDescriptor, type PublicHeadDescriptor, type PublicPostBodyDescriptor, type PublicPostHtmlDescriptor, type PublicPostHtmlPosition, type PublicPostScriptDescriptor, type Role, SITE_CONFIG_PK, type ScriptStrategy, type SiteSettingsEventPayload, type SiteSettingsEventType, type StaticPostBody, type StaticPostFileMeta, type StreamEventName, type SummaryListOptions, TEXT_EXTENSIONS, type ThemeColorField, type ThemeCustomClass, type ThemeCustomClassTarget, type ThemeField, type ThemeFieldType, type ThemeFontFamilyField, type ThemeImageField, type ThemeLengthField, type ThemeLinkListField, type ThemeManifest, type ThemeModule, type ThemeRouteContext, type ThemeSelectField, type ThemeTextField, type TiptapNodeHtmlAdapters, type TiptapNodeMarkdownAdapters, type TiptapNodeToHtml, type TiptapNodeToMarkdown, type TiptapRenderNode, type TrustLevel, type TrustedPluginRuntimeContext, VERSION, type ValidationIssue, bundlePrefix, collectBounded, collectTags, createPost, decodeAwsJson, defineConfig, definePlugin, defineSchema, defineTheme, defineThemeModule, deletePost, deleteSiteSetting, detectContentEvents, encodeAwsJson, escapeXml, extractFirstImageUrl, filterSortPostSummaries, findAbsolutePathRefs, flattenSettings, formatColorPair, formatDate, formatPublicAssetUrl, getKvStore, getPost, getPostById, getSiteSetting, hasKvStore, hasPostsProvider, isTagListUrl, isValidCustomClassId, isValidPluginKey, listPostHistory, listPostSummaries, listPosts, listSiteSettings, mimeTypeFor, parseColorPair, parseLinkList, pickDefaultEntrypoint, resolveLocalized, resolvePluginSettings, resolvePublicMcpEndpoint, resolveThemeValues, setKvStore, setPostsProvider, setSiteSetting, stringifyLinkList, stripCommonPrefix, tableCustomClassName, themeSettingKey, themeTableClasses, unflattenSettings, updatePost, validateBundle, validateBundlePath, validatePluginSettingValue, validatePublicAssetKey, validateThemeValue };

package/dist/index.js

@@ -772,6 +772,29 @@ function detectContentEvents(input) {
 }
 
 // src/theme.ts
+var CUSTOM_CLASS_ID_PATTERN = /^[a-z0-9-]+$/;
+var CUSTOM_CLASS_ID_MAX_LENGTH = 64;
+function isValidCustomClassId(id) {
+  return typeof id === "string" && id.length > 0 && id.length <= CUSTOM_CLASS_ID_MAX_LENGTH && CUSTOM_CLASS_ID_PATTERN.test(id);
+}
+function tableCustomClassName(id) {
+  return `tiptap-table--${id}`;
+}
+function themeTableClasses(manifest) {
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const c of manifest.customClasses ?? []) {
+    if (c?.target !== "table") continue;
+    if (!isValidCustomClassId(c.id)) {
+      console.warn(`[ampless] theme "${manifest.name}": ignoring custom class with invalid id ${JSON.stringify(c?.id)}`);
+      continue;
+    }
+    if (seen.has(c.id)) continue;
+    seen.add(c.id);
+    out.push(c);
+  }
+  return out;
+}
 function defineTheme(m) {
   return m;
 }
@@ -924,6 +947,8 @@ function defaultValueAsString(field) {
 // src/index.ts
 var VERSION = "0.0.1";
 export {
+  CUSTOM_CLASS_ID_MAX_LENGTH,
+  CUSTOM_CLASS_ID_PATTERN,
   DEFAULT_ENTRYPOINT,
   MAX_BUNDLE_BYTES,
   PLUGIN_KEY_PATTERN,
@@ -959,6 +984,7 @@ export {
   hasKvStore,
   hasPostsProvider,
   isTagListUrl,
+  isValidCustomClassId,
   isValidPluginKey,
   listPostHistory,
   listPostSummaries,
@@ -977,7 +1003,9 @@ export {
   setSiteSetting,
   stringifyLinkList,
   stripCommonPrefix,
+  tableCustomClassName,
   themeSettingKey,
+  themeTableClasses,
   unflattenSettings,
   updatePost,
   validateBundle,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ampless",
-  "version": "1.0.0-beta.63",
+  "version": "1.0.0-beta.64",
   "description": "Serverless CMS for AWS Amplify",
   "license": "MIT",
   "type": "module",