@gradial/aci 0.1.20-preview.3 → 0.1.20

package/dist/types/media.js

@@ -1,86 +1,17 @@
 import { z } from 'zod';
-import { GradialImageSchema, renderImageHTML } from './image.js';
-import { GradialVideoSchema } from './video.js';
-// ---------------------------------------------------------------------------
-// Zod schema — discriminated on $type
-// ---------------------------------------------------------------------------
-export const GradialAssetSchema = z.discriminatedUnion('$type', [
-    GradialImageSchema,
-    GradialVideoSchema,
-]);
-// ---------------------------------------------------------------------------
-// Type guards
-// ---------------------------------------------------------------------------
-export function isGradialImage(value) {
-    return (typeof value === 'object' &&
-        value !== null &&
-        value.$type === 'gradial.image');
-}
-export function isGradialVideo(value) {
-    return (typeof value === 'object' &&
-        value !== null &&
-        value.$type === 'gradial.video');
-}
-export function isGradialAsset(value) {
-    return isGradialImage(value) || isGradialVideo(value);
-}
-// ---------------------------------------------------------------------------
-// HTML string renderers (framework-agnostic)
-// ---------------------------------------------------------------------------
-/**
- * Renders a GradialVideo to an HTML string.
- * Uses poster.fallback.src for the poster attribute.
- * Includes <source> elements for format variants.
- */
-export function renderVideoHTML(video, attrs = {}) {
-    const posterSrc = video.poster?.fallback.src;
-    const attrPairs = [
-        ...Object.entries(attrs),
-        ['src', video.sources?.length ? undefined : video.src],
-        ['poster', posterSrc],
-        ['width', video.width > 0 ? video.width : undefined],
-        ['height', video.height > 0 ? video.height : undefined],
-    ];
-    const attrString = renderAttrs(attrPairs);
-    const sources = (video.sources ?? [])
-        .map((s) => `<source${renderAttrs([['src', s.src], ['type', s.type]])}>`)
-        .join('');
-    // If no format variants, src is on the <video> element itself
-    if (!sources) {
-        return `<video${attrString}></video>`;
-    }
-    return `<video${attrString}>${sources}</video>`;
-}
-/**
- * Renders any GradialAsset to an HTML string.
- * Delegates to renderImageHTML or renderVideoHTML based on $type.
- */
-export function renderAssetHTML(asset, attrs = {}) {
-    if (asset.$type === 'gradial.image') {
-        return renderImageHTML(asset, attrs);
-    }
-    return renderVideoHTML(asset, attrs);
-}
-// ---------------------------------------------------------------------------
-// Internal helpers
-// ---------------------------------------------------------------------------
-function renderAttrs(pairs) {
-    const rendered = pairs
-        .filter(([, value]) => value !== undefined && value !== null && value !== false)
-        .map(([name, value]) => value === true
-        ? escapeName(name)
-        : `${escapeName(name)}="${escapeAttr(String(value))}"`);
-    if (!rendered.length)
-        return '';
-    return ' ' + rendered.join(' ');
-}
-function escapeName(name) {
-    return name.replace(/[^A-Za-z0-9_:-]/g, '');
-}
-function escapeAttr(value) {
-    return value
-        .replace(/&/g, '&amp;')
-        .replace(/"/g, '&quot;')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;');
+import { ImageSchema } from './image.js';
+import { VideoSchema } from './video.js';
+/** Zod schema for a resolved asset value. */
+export const AssetSchema = z.union([ImageSchema, VideoSchema]);
+/** Runtime guard: value is a resolved asset. */
+export function isAsset(value) {
+    return ImageSchema.safeParse(value).success || VideoSchema.safeParse(value).success;
+}
+/** Runtime guard: value is a resolved image asset. */
+export function isImage(value) {
+    return ImageSchema.safeParse(value).success;
+}
+/** Runtime guard: value is a resolved video asset. */
+export function isVideo(value) {
+    return VideoSchema.safeParse(value).success;
 }

package/dist/types/renderer.d.ts

@@ -7,7 +7,7 @@ export interface RenderCapabilities {
     clientIslands: boolean;
     fragmentRender: boolean;
 }
-export interface GradialRenderer {
+export interface Renderer {
     renderPage(request: RenderPageRequest): Promise<RenderPageResult>;
     renderFragment?(request: RenderFragmentRequest): Promise<RenderResult>;
     renderIsland?(request: RenderIslandRequest): Promise<RenderResult>;

package/dist/types/rich-text.d.ts

@@ -0,0 +1,40 @@
+import { z } from 'zod';
+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 declare const InlineContentSchema: z.ZodType<InlineContent>;
+export declare const HeadingSchema: z.ZodObject<{
+    type: z.ZodLiteral<"heading">;
+    level: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<5>, z.ZodLiteral<6>]>;
+    content: z.ZodArray<z.ZodType<InlineContent, unknown, z.core.$ZodTypeInternals<InlineContent, unknown>>>;
+    variant: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const RichTextValueSchema: z.ZodType<RichTextValue>;

package/dist/types/rich-text.js

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+export const InlineContentSchema = 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(),
+});
+export const RichTextValueSchema = z.object({
+    format: z.literal('html'),
+    html: z.string(),
+}).or(z.object({
+    format: z.literal('markdown'),
+    markdown: z.string(),
+}));

package/dist/types/video.d.ts

@@ -1,10 +1,10 @@
 import { z } from 'zod';
-import { type GradialImage } from './image.js';
+import { type Image } from './image.js';
 export interface VideoSource {
     src: string;
     type: string;
 }
-export interface GradialVideo {
+export interface Video {
     /** Discriminator — always 'gradial.video'. */
     $type: 'gradial.video';
     /** DAM asset identifier. */
@@ -22,10 +22,10 @@ export interface GradialVideo {
     /** Intrinsic height in pixels. */
     height: number;
     /**
-     * Poster frame — a full GradialImage with responsive srcset.
+     * Poster frame — a full Image with responsive srcset.
      * The compiler extracts or generates this from the video asset.
      */
-    poster?: GradialImage;
+    poster?: Image;
     /** Format variants (e.g. mp4 + webm). Maps to <video><source> elements. */
     sources?: VideoSource[];
     /** Duration in seconds (if known). */
@@ -35,7 +35,7 @@ export declare const VideoSourceSchema: z.ZodObject<{
     src: z.ZodString;
     type: z.ZodString;
 }, z.core.$strip>;
-export declare const GradialVideoSchema: z.ZodObject<{
+export declare const VideoSchema: z.ZodObject<{
     $type: z.ZodLiteral<"gradial.video">;
     assetId: z.ZodString;
     versionId: z.ZodString;
@@ -49,18 +49,12 @@ export declare const GradialVideoSchema: z.ZodObject<{
         assetId: z.ZodString;
         versionId: z.ZodString;
         alt: z.ZodString;
-        fallback: z.ZodObject<{
+        sources: z.ZodArray<z.ZodObject<{
             src: z.ZodString;
             width: z.ZodNumber;
             height: z.ZodNumber;
             type: z.ZodString;
-        }, z.core.$strip>;
-        sources: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodObject<{
-            media: z.ZodOptional<z.ZodString>;
-            type: z.ZodString;
-            srcset: z.ZodString;
-            sizes: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>>>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
     sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
         src: z.ZodString;

package/dist/types/video.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { GradialImageSchema } from './image.js';
+import { ImageSchema } from './image.js';
 // ---------------------------------------------------------------------------
 // Zod schema
 // ---------------------------------------------------------------------------
@@ -7,7 +7,7 @@ export const VideoSourceSchema = z.object({
     src: z.string().min(1),
     type: z.string().min(1),
 });
-export const GradialVideoSchema = z.object({
+export const VideoSchema = z.object({
     $type: z.literal('gradial.video'),
     assetId: z.string().min(1),
     versionId: z.string().min(1),
@@ -16,7 +16,7 @@ export const GradialVideoSchema = z.object({
     type: z.string().min(1),
     width: z.number().int().nonnegative(),
     height: z.number().int().nonnegative(),
-    poster: GradialImageSchema.optional(),
+    poster: ImageSchema.optional(),
     sources: z.array(VideoSourceSchema).optional(),
     duration: z.number().nonnegative().optional(),
 });

package/package.json

@@ -1,15 +1,18 @@
 {
   "name": "@gradial/aci",
-  "version": "0.1.20-preview.3",
+  "version": "0.1.20",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
     "dist",
     "bin/aci.js",
-    "bin/aci",
+    "bin/aci-*",
     "src/cli/*.mjs",
-    "src/types/*.ts",
+    "src/types/image.ts",
+    "templates/common",
+    "templates/nextjs",
+    "templates/astro",
     "README.md"
   ],
   "bin": {
@@ -23,29 +26,13 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
-    "./compiler": {
-      "types": "./dist/compiler/index.d.ts",
-      "import": "./dist/compiler/index.js"
-    },
     "./content": {
       "types": "./dist/content/index.d.ts",
       "import": "./dist/content/index.js"
     },
-    "./content/contract": {
-      "types": "./dist/content/contract.d.ts",
-      "import": "./dist/content/contract.js"
-    },
-    "./content/cache": {
-      "types": "./dist/content/cache.d.ts",
-      "import": "./dist/content/cache.js"
-    },
-    "./content/validation": {
-      "types": "./dist/content/validation.d.ts",
-      "import": "./dist/content/validation.js"
-    },
-    "./content/tailwind-validator": {
-      "types": "./dist/content/tailwind-validator.d.ts",
-      "import": "./dist/content/tailwind-validator.js"
+    "./compiler": {
+      "types": "./dist/compiler/index.d.ts",
+      "import": "./dist/compiler/index.js"
     },
     "./providers/file": {
       "types": "./dist/providers/file.d.ts",
@@ -59,51 +46,19 @@
       "types": "./dist/dev/index.d.ts",
       "import": "./dist/dev/index.js"
     },
-    "./assets": {
-      "types": "./dist/assets/index.d.ts",
-      "import": "./dist/assets/index.js"
-    },
-    "./runtime": {
-      "types": "./dist/runtime/page.d.ts",
-      "import": "./dist/runtime/page.js"
-    },
     "./react": {
       "types": "./dist/react/index.d.ts",
       "import": "./dist/react/index.js"
     },
-    "./astro": {
-      "types": "./dist/astro/index.d.ts",
-      "import": "./dist/astro/index.js"
-    },
-    "./preview": {
-      "types": "./dist/preview/core.d.ts",
-      "import": "./dist/preview/core.js",
-      "default": "./dist/preview/core.js"
-    },
     "./next": {
       "types": "./dist/next/index.d.ts",
       "import": "./dist/next/index.js",
       "default": "./dist/next/index.js"
     },
-    "./next/page": {
-      "types": "./dist/next/page.d.ts",
-      "import": "./dist/next/page.js",
-      "default": "./dist/next/page.js"
-    },
-    "./next/root-layout": {
-      "types": "./dist/next/root-layout.d.ts",
-      "import": "./dist/next/root-layout.js",
-      "default": "./dist/next/root-layout.js"
-    },
-    "./next/render": {
-      "types": "./dist/next/render.d.ts",
-      "import": "./dist/next/render.js",
-      "default": "./dist/next/render.js"
-    },
-    "./next/server": {
-      "types": "./dist/next/server.d.ts",
-      "import": "./dist/next/server.js",
-      "default": "./dist/next/server.js"
+    "./next/config": {
+      "types": "./dist/next/config.d.ts",
+      "import": "./dist/next/config.js",
+      "default": "./dist/next/config.js"
     },
     "./next/middleware": {
       "types": "./dist/next/middleware.d.ts",
@@ -114,28 +69,22 @@
       "types": "./dist/next/dev-refresh.d.ts",
       "import": "./dist/next/dev-refresh.js"
     },
-    "./next/asset-route": {
-      "types": "./dist/next/asset-route.d.ts",
-      "import": "./dist/next/asset-route.js"
-    },
-    "./sveltekit": {
-      "types": "./dist/sveltekit/index.d.ts",
-      "import": "./dist/sveltekit/index.js"
-    },
-    "./testing": {
-      "types": "./dist/testing/index.d.ts",
-      "import": "./dist/testing/index.js"
-    },
-    "./cli/compile-registry": "./src/cli/compile-registry.mjs",
-    "./cli/validate-content": "./src/cli/validate-content.mjs",
-    "./cli/verify-renderer": "./src/cli/verify-renderer.mjs"
+    "./astro": {
+      "types": "./dist/astro/index.d.ts",
+      "import": "./dist/astro/index.js",
+      "default": "./dist/astro/index.js"
+    }
   },
   "scripts": {
-    "build": "tsc -p tsconfig.json",
+    "build": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\" && tsc -p tsconfig.json",
     "build:cli": "cd ../.. && ./scripts/build-cli.sh",
-    "compile-registry": "tsx src/cli/compile-registry.mjs"
+    "generate-starters": "cd ../.. && tsx scripts/generate-starters.ts",
+    "compile-registry": "tsx src/cli/compile-registry.mjs",
+    "prepack": "npm run generate-starters && npm run build && npm run build:cli"
   },
   "dependencies": {
+    "markdown-it": "^14.1.0",
+    "sanitize-html": "^2.13.1",
     "ws": "^8.18.0"
   },
   "peerDependencies": {
@@ -162,13 +111,16 @@
   "devDependencies": {
     "@types/node": "^24.10.1",
     "@types/react": "^19.0.0",
+    "@types/markdown-it": "^14.1.2",
+    "@types/sanitize-html": "^2.16.0",
     "@types/ws": "^8.18.0",
     "@vercel/edge-config": "^1.4.3",
     "next": "^15.5.6",
     "react": "^19.0.0",
+    "react-dom": "^19.0.0",
     "tsx": "^4.20.0",
     "typescript": "^5.9.3",
     "ws": "^8.18.0",
     "zod": "^4.0.0"
   }
-}
+}