@gradial/aci 0.1.20-preview.3 → 0.1.20

package/dist/sveltekit/index.js

@@ -1,66 +0,0 @@
-import { gradialContentWatchPlugin, gradialDamAssetPlugin, devRefreshPort, devRefreshScriptTag, } from '../dev/index.js';
-import { getPendingRenderInputFromHeaders } from '../runtime/page.js';
-// ---------------------------------------------------------------------------
-// Entries helper — for SvelteKit SSG prerendering
-// ---------------------------------------------------------------------------
-/**
- * Generates prerender entries from the compiled content manifest for SvelteKit.
- *
- * Usage in svelte.config.js:
- * ```js
- * import { gradialEntries } from '@gradial/aci/sveltekit';
- * export default { kit: { prerender: { entries: await gradialEntries() } } };
- * ```
- *
- * Or in a catch-all `+page.server.ts`:
- * ```ts
- * import { gradialEntries } from '@gradial/aci/sveltekit';
- * export const entries = gradialEntries;
- * ```
- */
-export async function gradialEntries() {
-    const { FileContentProvider } = await import('../providers/file.js');
-    const { normalizeRoute } = await import('../content/routes.js');
-    const provider = new FileContentProvider();
-    const routes = await provider.listRoutes();
-    return routes.map((entry) => {
-        const normalized = normalizeRoute(entry.path);
-        return normalized === '/' ? '/' : `/${normalized.replace(/^\/|\/$/g, '')}/`;
-    });
-}
-export function getPageRuntimeRenderInput(event) {
-    return getPendingRenderInputFromHeaders(event.request.headers);
-}
-// ---------------------------------------------------------------------------
-// Registry helpers
-// ---------------------------------------------------------------------------
-export { createRegistry, registryLookup } from '../registry.js';
-// ---------------------------------------------------------------------------
-// Preview support
-// ---------------------------------------------------------------------------
-export { getPreviewMode, createPreviewBannerHTML, createPreviewCookies, } from './preview.js';
-// ---------------------------------------------------------------------------
-// SvelteKit Vite plugin
-// ---------------------------------------------------------------------------
-export function withGradialAci(options = {}) {
-    const watchPlugin = gradialContentWatchPlugin(options);
-    const damAssetPlugin = gradialDamAssetPlugin(options);
-    return {
-        ...watchPlugin,
-        name: 'gradial-sveltekit',
-        configureServer(server) {
-            damAssetPlugin.configureServer?.(server);
-            watchPlugin.configureServer?.(server);
-        },
-        transformIndexHtml(html) {
-            if (process.env.NODE_ENV === 'production') {
-                return html;
-            }
-            if (devRefreshPort(options) <= 0) {
-                return html;
-            }
-            const script = devRefreshScriptTag(options);
-            return html.includes('</body>') ? html.replace('</body>', `${script}</body>`) : `${html}${script}`;
-        },
-    };
-}

package/dist/sveltekit/preview.d.ts

@@ -1,5 +0,0 @@
-import { type PreviewContext, type PreviewCookie } from '../preview/core.js';
-export declare function getPreviewMode(request: Request, siteId: string): Promise<PreviewContext>;
-export declare function createPreviewBannerHTML(releaseId: string): string;
-export declare function createPreviewCookies(token: string, releaseId: string): PreviewCookie[];
-export type { PreviewContext, PreviewCookie };

package/dist/sveltekit/preview.js

@@ -1,33 +0,0 @@
-import { extractPreviewToken, resolvePreviewContext, createPreviewBannerHTML as coreCreatePreviewBannerHTML, createPreviewCookies as coreCreatePreviewCookies, previewSignKey, } from '../preview/core.js';
-export async function getPreviewMode(request, siteId) {
-    const url = new URL(request.url);
-    const token = extractPreviewToken({
-        query: url.searchParams,
-        cookies: parseCookieHeader(request.headers.get('cookie') || ''),
-        authorization: request.headers.get('authorization') || undefined,
-    });
-    if (!token)
-        return { isPreview: false };
-    return resolvePreviewContext({ token, siteId, signKey: previewSignKey() });
-}
-export function createPreviewBannerHTML(releaseId) {
-    return coreCreatePreviewBannerHTML(releaseId);
-}
-export function createPreviewCookies(token, releaseId) {
-    return coreCreatePreviewCookies(token, releaseId);
-}
-function parseCookieHeader(header) {
-    const cookies = new Map();
-    for (const part of header.split(';')) {
-        const trimmed = part.trim();
-        if (!trimmed)
-            continue;
-        const idx = trimmed.indexOf('=');
-        if (idx < 0)
-            continue;
-        const name = trimmed.slice(0, idx).trim();
-        const value = trimmed.slice(idx + 1).trim();
-        cookies.set(name, decodeURIComponent(value));
-    }
-    return cookies;
-}

package/src/types/component.ts

@@ -1,49 +0,0 @@
-import type { IslandMode, VaryDimension } from './render-mode.js';
-import type { ImageSlotContract } from './image.js';
-import type { z } from 'zod';
-
-/**
- * A CMS-registered component — sync or async (server components).
- * Accepts content props derived from the Zod schema.
- */
-type CmsComponentFn<TProps = any> =
-  | ((props: TProps) => import('react').ReactElement | null)
-  | ((props: TProps) => Promise<import('react').ReactElement | null>);
-
-/**
- * Infers the props type from a schema.
- * If TSchema is a Zod type, returns z.infer<TSchema>.
- * Otherwise returns Record<string, unknown>.
- */
-type InferContentProps<TSchema> = TSchema extends z.ZodType<infer T> ? T : Record<string, unknown>;
-
-export interface ComponentDefinition<TSchema = unknown> {
-  name: string;
-  /**
-   * The React component that renders this CMS block.
-   * Accepts at least the schema-derived props, but may accept additional
-   * composition params (className, etc.) passed by parent sections.
-   */
-  component?: CmsComponentFn<any>;
-  schema: TSchema;
-  defaultIslandMode?: IslandMode;
-  varyDimensions?: VaryDimension[];
-  vary?: VaryDimension[];
-  imageSlots?: Record<string, ImageSlotContract>;
-}
-
-export interface ComponentContract<TSchema = unknown> {
-  name: string;
-  component?: CmsComponentFn<any>;
-  schema: TSchema;
-  defaultIslandMode?: IslandMode;
-  varyDimensions?: VaryDimension[];
-  vary?: VaryDimension[];
-  imageSlots?: Record<string, ImageSlotContract>;
-}
-
-export type InferComponentProps<TContract> = TContract extends ComponentContract<infer TSchema>
-  ? InferContentProps<TSchema>
-  : Record<string, unknown>;
-
-export type { CmsComponentFn, InferContentProps };

package/src/types/config.ts

@@ -1,37 +0,0 @@
-import type { RenderCapabilities } from './renderer.js';
-
-export interface BareMetalConfig {
-  version: '1';
-  siteId: string;
-  framework: 'astro' | 'next' | 'sveltekit' | 'custom';
-  source: {
-    root: string;
-    outDir?: string;
-    publicDir?: string;
-  };
-  componentRegistry: string;
-  dataRegistry?: string;
-  layoutRegistry: string;
-  capabilities: RenderCapabilities;
-  routes: RouteConfig;
-  dam?: DAMConfig;
-  externalDependencies?: ExternalDependency[];
-  rendererProtocol: 'http' | 'stdio-json';
-}
-
-export interface RouteConfig {
-  cmsManaged: string;
-  frameworkOwned?: string[];
-}
-
-export interface ExternalDependency {
-  name: string;
-  host: string;
-  kind?: 'api' | 'client-script';
-  description?: string;
-  cacheTTL?: number;
-}
-
-export interface DAMConfig {
-  autoApproveUploads?: boolean;
-}

package/src/types/data.ts

@@ -1,47 +0,0 @@
-import { z } from 'zod';
-
-type InferDataProps<TSchema> = TSchema extends z.ZodType<infer T>
-  ? T
-  : Record<string, unknown>;
-
-const dataRefPattern = /^\$ref:data\/[A-Za-z0-9][A-Za-z0-9_./-]*$/;
-
-export interface DataModelDefinition<TSchema = unknown, TType extends string = string> {
-  type: TType;
-  schema: TSchema;
-}
-
-export interface DataModelContract<TSchema = unknown, TType extends string = string> {
-  type: TType;
-  schema: TSchema;
-}
-
-export interface DataEntry<TProps = Record<string, unknown>, TType extends string = string> {
-  $type: TType;
-  props: TProps;
-}
-
-export type InferDataModelProps<TContract> = TContract extends DataModelContract<infer TSchema, string>
-  ? InferDataProps<TSchema>
-  : Record<string, unknown>;
-
-export type InferDataModelType<TContract> = TContract extends DataModelContract<unknown, infer TType>
-  ? TType
-  : string;
-
-export type DataModelRef<TContract extends DataModelContract> = DataEntry<
-  InferDataModelProps<TContract>,
-  InferDataModelType<TContract>
->;
-
-export function dataModelRef<TContract extends DataModelContract<z.ZodTypeAny>>(
-  contract: TContract,
-): z.ZodType<DataModelRef<TContract>> {
-  return z.union([
-    z.string().regex(dataRefPattern, `expected a $ref:data/... pointer for ${contract.type}`),
-    z.object({
-      $type: z.literal(contract.type),
-      props: contract.schema,
-    }),
-  ]).describe(`data model reference: ${contract.type}`) as unknown as z.ZodType<DataModelRef<TContract>>;
-}

package/src/types/index.ts

@@ -1,10 +0,0 @@
-export * from './config.js';
-export * from './component.js';
-export * from './data.js';
-export * from './layout.js';
-export * from './page.js';
-export * from './renderer.js';
-export * from './render-mode.js';
-export * from './image.js';
-export * from './video.js';
-export * from './media.js';

package/src/types/layout.ts

@@ -1,29 +0,0 @@
-import type { FragmentRefNode } from './page.js';
-
-export interface LayoutSlot {
-  name: string;
-  required: boolean;
-}
-
-/** Default content for non-required layout slots, keyed by slot name. */
-export type LayoutDefaults = Record<string, FragmentRefNode[]>;
-
-export interface LayoutDefinition {
-  name: string;
-  slots: LayoutSlot[];
-  /** Default fragment references for slots not provided by the page. */
-  defaults?: LayoutDefaults;
-}
-
-export interface LayoutContract {
-  name: string;
-  slots: LayoutSlot[];
-  defaults?: LayoutDefaults;
-}
-
-/** A compiled layout file as stored on disk. */
-export interface CompiledLayout {
-  name: string;
-  slots: LayoutSlot[];
-  defaults: LayoutDefaults;
-}

package/src/types/media.ts

@@ -1,125 +0,0 @@
-import { z } from 'zod';
-import { GradialImageSchema, renderImageHTML, type GradialImage } from './image.js';
-import { GradialVideoSchema, type GradialVideo } from './video.js';
-
-// ---------------------------------------------------------------------------
-// GradialAsset — union of all DAM-backed asset types
-//
-// Content authors write: { "$type": "dam.assetRef", "assetId": "..." }
-// The compiler resolves this to a GradialImage or GradialVideo based on
-// the asset's media type in the DAM.
-// ---------------------------------------------------------------------------
-
-/** Discriminated union of all compiler-resolved asset types. */
-export type GradialAsset = GradialImage | GradialVideo;
-
-// ---------------------------------------------------------------------------
-// Zod schema — discriminated on $type
-// ---------------------------------------------------------------------------
-
-export const GradialAssetSchema = z.discriminatedUnion('$type', [
-  GradialImageSchema,
-  GradialVideoSchema,
-]);
-
-// ---------------------------------------------------------------------------
-// Type guards
-// ---------------------------------------------------------------------------
-
-export function isGradialImage(value: unknown): value is GradialImage {
-  return (
-    typeof value === 'object' &&
-    value !== null &&
-    (value as Record<string, unknown>).$type === 'gradial.image'
-  );
-}
-
-export function isGradialVideo(value: unknown): value is GradialVideo {
-  return (
-    typeof value === 'object' &&
-    value !== null &&
-    (value as Record<string, unknown>).$type === 'gradial.video'
-  );
-}
-
-export function isGradialAsset(value: unknown): value is GradialAsset {
-  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: GradialVideo,
-  attrs: Record<string, string | number | boolean | undefined | null> = {},
-): string {
-  const posterSrc = video.poster?.fallback.src;
-  const attrPairs: Array<[string, string | number | boolean | undefined | null]> = [
-    ...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: GradialAsset,
-  attrs: Record<string, string | number | boolean | undefined | null> = {},
-): string {
-  if (asset.$type === 'gradial.image') {
-    return renderImageHTML(asset, attrs);
-  }
-  return renderVideoHTML(asset, attrs);
-}
-
-// ---------------------------------------------------------------------------
-// Internal helpers
-// ---------------------------------------------------------------------------
-
-function renderAttrs(
-  pairs: Array<[string, string | number | boolean | undefined | null]>,
-): string {
-  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: string): string {
-  return name.replace(/[^A-Za-z0-9_:-]/g, '');
-}
-
-function escapeAttr(value: string): string {
-  return value
-    .replace(/&/g, '&amp;')
-    .replace(/"/g, '&quot;')
-    .replace(/</g, '&lt;')
-    .replace(/>/g, '&gt;');
-}

package/src/types/page.ts

@@ -1,47 +0,0 @@
-import type { VaryDimension } from './render-mode.js';
-
-export interface PageDocument {
-  path: string;
-  layout: string;
-  locale: string;
-  metadata: PageMetadata;
-  regions: Record<string, RegionNode>;
-}
-
-export interface PageMetadata {
-  title: string;
-  description?: string;
-  openGraph?: Record<string, string>;
-  canonicalUrl?: string;
-  alternateLocales?: { locale: string; path: string }[];
-  customHead?: string[];
-}
-
-export interface RegionNode {
-  kind: 'region';
-  name: string;
-  children: Array<BlockNode | FragmentRefNode>;
-}
-
-export interface BlockNode {
-  kind: 'block';
-  id: string;
-  component: string;
-  props: Record<string, unknown>;
-  renderHints: BlockRenderHints;
-  contentRef?: string;
-}
-
-export interface BlockRenderHints {
-  canStatic: boolean;
-  needsSSR: boolean;
-  isIsland: boolean;
-  islandMode?: 'ssr' | 'client';
-  varyDimensions?: VaryDimension[];
-}
-
-export interface FragmentRefNode {
-  kind: 'fragment-ref';
-  fragmentId: string;
-  inline: boolean;
-}

package/src/types/render-mode.ts

@@ -1,10 +0,0 @@
-export type IslandMode = 'ssr' | 'client';
-
-export type VaryDimension =
-  | 'geo:country'
-  | 'geo:region'
-  | 'geo:city'
-  | `cookie:${string}`
-  | `header:${string}`
-  | 'locale'
-  | `query:${string}`;

package/src/types/renderer.ts

@@ -1,83 +0,0 @@
-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 GradialRenderer {
-  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/video.ts

@@ -1,66 +0,0 @@
-import { z } from 'zod';
-import { GradialImageSchema, type GradialImage } from './image.js';
-
-// ---------------------------------------------------------------------------
-// Video source variant (format alternatives)
-// ---------------------------------------------------------------------------
-
-export interface VideoSource {
-  src: string;
-  type: string; // MIME type: video/mp4, video/webm
-}
-
-// ---------------------------------------------------------------------------
-// GradialVideo — DAM-backed video asset with compiler-resolved derivatives
-// ---------------------------------------------------------------------------
-
-export interface GradialVideo {
-  /** Discriminator — always 'gradial.video'. */
-  $type: 'gradial.video';
-  /** DAM asset identifier. */
-  assetId: string;
-  /** DAM version identifier. */
-  versionId: string;
-  /** Accessible description of the video content. */
-  alt: string;
-  /** Primary video URL (compiler-resolved). */
-  src: string;
-  /** Primary video MIME type (e.g. 'video/mp4'). */
-  type: string;
-  /** Intrinsic width in pixels. */
-  width: number;
-  /** Intrinsic height in pixels. */
-  height: number;
-  /**
-   * Poster frame — a full GradialImage with responsive srcset.
-   * The compiler extracts or generates this from the video asset.
-   */
-  poster?: GradialImage;
-  /** Format variants (e.g. mp4 + webm). Maps to <video><source> elements. */
-  sources?: VideoSource[];
-  /** Duration in seconds (if known). */
-  duration?: number;
-}
-
-// ---------------------------------------------------------------------------
-// Zod schema
-// ---------------------------------------------------------------------------
-
-export const VideoSourceSchema = z.object({
-  src: z.string().min(1),
-  type: z.string().min(1),
-});
-
-export const GradialVideoSchema = 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: GradialImageSchema.optional(),
-  sources: z.array(VideoSourceSchema).optional(),
-  duration: z.number().nonnegative().optional(),
-});