@gradial/aci 0.1.23 → 0.1.24

package/src/types/renderer.ts

@@ -0,0 +1,83 @@
+import type { PageDocument } from './page.js';
+import type { VaryDimension } from './render-mode.js';
+
+export interface RenderCapabilities {
+  staticRender: boolean;
+  ssr: boolean;
+  ssrIslands: boolean;
+  clientIslands: boolean;
+  fragmentRender: boolean;
+}
+
+export interface Renderer {
+  renderPage(request: RenderPageRequest): Promise<RenderPageResult>;
+  renderFragment?(request: RenderFragmentRequest): Promise<RenderResult>;
+  renderIsland?(request: RenderIslandRequest): Promise<RenderResult>;
+}
+
+export interface RenderPageRequest {
+  page: PageDocument;
+  requestContext?: RequestContext;
+  release: ReleaseContext;
+}
+
+export interface RequestContext {
+  url: string;
+  method: string;
+  headers: Record<string, string>;
+  cookies: Record<string, string>;
+  geo?: GeoContext;
+}
+
+export interface GeoContext {
+  country?: string;
+  region?: string;
+  city?: string;
+}
+
+export interface ReleaseContext {
+  releaseId: string;
+  codeDigest: string;
+  contentSnapshotId: string;
+  assetUrl(logicalPath: string): string;
+}
+
+export interface RenderFragmentRequest {
+  fragmentId: string;
+  content: unknown;
+  release: ReleaseContext;
+}
+
+export interface RenderIslandRequest {
+  islandId: string;
+  component: string;
+  props: Record<string, unknown>;
+  requestContext: RequestContext;
+  release: ReleaseContext;
+}
+
+export interface RenderResult {
+  html: string;
+  status?: number;
+  headers?: Record<string, string>;
+  cachePolicy?: CachePolicy;
+}
+
+export interface RenderPageResult extends RenderResult {
+  islands?: IslandDescriptor[];
+}
+
+export interface IslandDescriptor {
+  islandId: string;
+  component: string;
+  props: Record<string, unknown>;
+  mode: 'ssr' | 'client';
+  varyDimensions?: VaryDimension[];
+}
+
+export interface CachePolicy {
+  scope: 'public' | 'private' | 'no-store';
+  ttl?: number;
+  staleWhileRevalidate?: number;
+  tags?: string[];
+}

package/src/types/rich-text.ts

@@ -0,0 +1,64 @@
+import { z } from 'zod';
+
+// ---------------------------------------------------------------------------
+// Inline content nodes
+// ---------------------------------------------------------------------------
+
+export type InlineContent =
+  | { type: 'text'; text: string }
+  | { type: 'span'; content: InlineContent[]; variant?: string }
+  | { type: 'strong'; content: InlineContent[] }
+  | { type: 'em'; content: InlineContent[] }
+  | { type: 'link'; href: string; content: InlineContent[] };
+
+export type Heading = {
+  type: 'heading';
+  level: 1 | 2 | 3 | 4 | 5 | 6;
+  content: InlineContent[];
+  variant?: string;
+};
+
+export type RichTextValue =
+  | { format: 'html'; html: string }
+  | { format: 'markdown'; markdown: string };
+
+export const InlineContentSchema: z.ZodType<InlineContent> = z.lazy(() => z.object({
+  type: z.literal('text'),
+  text: z.string(),
+}).or(z.object({
+  type: z.literal('span'),
+  content: z.array(InlineContentSchema),
+  variant: z.string().optional(),
+})).or(z.object({
+  type: z.literal('strong'),
+  content: z.array(InlineContentSchema),
+})).or(z.object({
+  type: z.literal('em'),
+  content: z.array(InlineContentSchema),
+})).or(z.object({
+  type: z.literal('link'),
+  href: z.string().min(1),
+  content: z.array(InlineContentSchema),
+})));
+
+export const HeadingSchema = z.object({
+  type: z.literal('heading'),
+  level: z.union([
+    z.literal(1),
+    z.literal(2),
+    z.literal(3),
+    z.literal(4),
+    z.literal(5),
+    z.literal(6),
+  ]),
+  content: z.array(InlineContentSchema),
+  variant: z.string().optional(),
+}) satisfies z.ZodType<Heading>;
+
+export const RichTextValueSchema: z.ZodType<RichTextValue> = z.object({
+  format: z.literal('html'),
+  html: z.string(),
+}).or(z.object({
+  format: z.literal('markdown'),
+  markdown: z.string(),
+}));

package/src/types/video.ts

@@ -0,0 +1,76 @@
+import { z } from 'zod';
+import { ImageSchema, type Image } from './image.js';
+
+// ---------------------------------------------------------------------------
+// Video source variant (format alternatives)
+// ---------------------------------------------------------------------------
+
+export interface VideoSource {
+  src: string;
+  type: string; // MIME type: video/mp4, video/webm
+}
+
+// ---------------------------------------------------------------------------
+// Video — DAM-backed video asset with compiler-resolved derivatives
+//
+// Content authors write: { "$type": "dam.assetRef", ... }
+// or for static files: { "$type": "static.assetRef", "src": "/path" }
+// The compiler resolves both to this Video value.
+// ---------------------------------------------------------------------------
+
+export interface Video {
+  /** Discriminator — always 'gradial.video'. */
+  $type: 'gradial.video';
+  /** DAM asset identifier (or "static:<path>" for non-DAM assets). */
+  assetId: string;
+  /** DAM version identifier (or "static" for non-DAM assets). */
+  versionId: string;
+  /** Accessible description of the video content. */
+  alt: string;
+  /** Primary video URL (compiler-resolved). For embeds, this is the iframe URL. */
+  src: string;
+  /** MIME type (e.g. 'video/mp4'). 'text/html' for external embeds (YouTube, Vimeo). */
+  type: string;
+  /** Intrinsic width in pixels. */
+  width: number;
+  /** Intrinsic height in pixels. */
+  height: number;
+  /** Poster frame — a full Image with responsive srcset. */
+  poster?: Image;
+  /** Format variants (e.g. mp4 + webm). Maps to <video><source> elements. */
+  sources?: VideoSource[];
+  /** Duration in seconds (if known). */
+  duration?: number;
+  /** iframe allow attribute (for embeds only). */
+  allow?: string;
+  /** iframe referrerPolicy (for embeds only). */
+  referrerPolicy?: string;
+  /** iframe allowFullScreen (for embeds only). */
+  allowFullScreen?: boolean;
+}
+
+// ---------------------------------------------------------------------------
+// Zod schema
+// ---------------------------------------------------------------------------
+
+export const VideoSourceSchema = z.object({
+  src: z.string().min(1),
+  type: z.string().min(1),
+});
+
+export const VideoSchema = z.object({
+  $type: z.literal('gradial.video'),
+  assetId: z.string().min(1),
+  versionId: z.string().min(1),
+  alt: z.string(),
+  src: z.string().min(1),
+  type: z.string().min(1),
+  width: z.number().int().nonnegative(),
+  height: z.number().int().nonnegative(),
+  poster: ImageSchema.optional(),
+  sources: z.array(VideoSourceSchema).optional(),
+  duration: z.number().nonnegative().optional(),
+  allow: z.string().optional(),
+  referrerPolicy: z.string().optional(),
+  allowFullScreen: z.boolean().optional(),
+});

package/templates/astro/template/package.json.tmpl

@@ -16,7 +16,7 @@
     "build:storybook": "storybook build"
   },
   "dependencies": {
-    "@gradial/aci": "0.1.22",
+    "@gradial/aci": "0.1.23",
     "js-yaml": "^4.1.0",
     "marked": "^18.0.3",
     "zod": "^4.0.0"

package/templates/nextjs/template/package.json.tmpl

@@ -17,7 +17,7 @@
     "build:storybook": "storybook build"
   },
   "dependencies": {
-    "@gradial/aci": "0.1.22",
+    "@gradial/aci": "0.1.23",
     "js-yaml": "^4.1.1",
     "next": "^15.1.6",
     "react": "^19.0.0",

package/templates/nextjs/template/src/app/gradial/assets/[...path]/route.ts

@@ -0,0 +1,4 @@
+export { GET } from '@gradial/aci/next/asset-route';
+
+export const runtime = 'nodejs';
+export const dynamic = 'force-dynamic';

package/templates/nextjs/template/src/app/gradial/assets/[releaseId]/[...path]/route.ts

@@ -1 +0,0 @@
-export { GET, runtime, dynamic } from '@gradial/aci/next/asset-route';