@407dev/cms-astro 0.1.0

package/dist/types-CEYS5Fzc.d.ts

@@ -0,0 +1,112 @@
+import { z, CmsAsset } from '@407dev/blocks';
+
+interface FieldReadOptions<T = unknown> {
+    defaultValue?: T;
+}
+interface FieldComponentProps<T = unknown> {
+    k?: string;
+    key?: string;
+    defaultValue?: T;
+    as?: string;
+    tag?: string;
+    class?: string;
+    [key: string]: unknown;
+}
+interface DualCallableHelper<TValue = unknown, TDefault = TValue> {
+    /** Synchronous read call: f.text('home.hero.heading', { defaultValue: '...' }) or group.field() */
+    (key?: string, options?: FieldReadOptions<TDefault>): TValue;
+    (options?: FieldReadOptions<TDefault>): TValue;
+    /** JSX / Astro template component call: <f.text k="home.hero.heading" /> */
+    (props?: FieldComponentProps<TDefault>): unknown;
+    /** Astro component factory call: ($$result, $$props, $$slots) */
+    (result: unknown, props: FieldComponentProps<TDefault>, slots?: unknown): unknown;
+    isAstroComponentFactory: true;
+    typeId: string;
+    publicName: string;
+    prefix?: string;
+    defaultKey?: string;
+}
+interface FieldHelpersMap {
+    text: DualCallableHelper<string>;
+    number: DualCallableHelper<number>;
+    toggle: DualCallableHelper<boolean>;
+    select: DualCallableHelper<string>;
+    img: DualCallableHelper<CmsAsset | string>;
+    image: DualCallableHelper<CmsAsset | string>;
+    vid: DualCallableHelper<CmsAsset | string>;
+    video: DualCallableHelper<CmsAsset | string>;
+    richText: DualCallableHelper<unknown>;
+    richtext: DualCallableHelper<unknown>;
+    [key: string]: any;
+}
+type FieldScope = FieldHelpersMap & {
+    (key: string): string;
+    key(key: string): string;
+    scope(subPrefix: string): FieldScope;
+    readonly prefix: string;
+};
+interface GroupAccessor<TShape = Record<string, unknown>> {
+    attrs(): {
+        'data-cms-group': string;
+    };
+    key(key: string): string;
+    (key: string): string;
+    readonly groupName: string;
+    readonly prefix: string;
+}
+type BoundGroupAccessor<TShape> = GroupAccessor<TShape> & {
+    [K in keyof TShape]: TShape[K] extends DualCallableHelper<infer TVal, infer TDef> ? DualCallableHelper<TVal, TDef> : DualCallableHelper<unknown>;
+};
+interface GroupDefinition<TShape = Record<string, unknown>> {
+    (scopeKey: string): BoundGroupAccessor<TShape>;
+    readonly groupName: string;
+    readonly shape: TShape;
+}
+interface DefineCollectionOptions<TSchema extends z.ZodTypeAny> {
+    key: string;
+    schema: TSchema;
+    route?: string;
+    presentation?: 'visual' | 'form';
+    titleField?: string;
+    listColumns?: string[];
+    bodyField?: string;
+    orderable?: boolean;
+    seed?: Array<{
+        slug: string;
+        content: z.input<TSchema>;
+    }>;
+}
+interface CollectionHandle<TSchema extends z.ZodTypeAny = z.ZodTypeAny> {
+    readonly key: string;
+    readonly schema: TSchema;
+    readonly route?: string;
+    readonly presentation?: 'visual' | 'form';
+    readonly titleField?: string;
+    readonly listColumns?: string[];
+    readonly bodyField?: string;
+    readonly orderable?: boolean;
+    readonly jsonSchema: Record<string, unknown>;
+    readonly schemaVersion: number;
+    readonly seed?: Array<{
+        slug: string;
+        content: z.input<TSchema>;
+    }>;
+}
+interface CollectionEntry<TContent = Record<string, unknown>> {
+    slug: string;
+    content: TContent;
+    status: 'draft' | 'published' | 'scheduled';
+    published_at?: string | null;
+    position?: string | null;
+}
+type InferEntryContent<T> = T extends CollectionHandle<infer TSchema> ? z.infer<TSchema> : Record<string, unknown>;
+interface CollectionStaticPath<TContent = Record<string, unknown>> {
+    params: {
+        slug: string;
+    };
+    props: {
+        entry: CollectionEntry<TContent>;
+    };
+}
+
+export type { BoundGroupAccessor as B, CollectionHandle as C, DefineCollectionOptions as D, FieldScope as F, GroupDefinition as G, InferEntryContent as I, CollectionEntry as a, CollectionStaticPath as b, DualCallableHelper as c, FieldHelpersMap as d, FieldComponentProps as e, FieldReadOptions as f, GroupAccessor as g };

package/dist/types-DpeHpobR.d.ts

@@ -0,0 +1,104 @@
+import { z, CmsAsset } from '@407dev/blocks';
+
+interface FieldReadOptions<T = unknown> {
+    defaultValue?: T;
+}
+interface FieldComponentProps<T = unknown> {
+    k?: string;
+    key?: string;
+    defaultValue?: T;
+    as?: string;
+    tag?: string;
+    class?: string;
+    [key: string]: unknown;
+}
+interface DualCallableHelper<TValue = unknown, TDefault = TValue> {
+    /** Synchronous read call: f.text('home.hero.heading', { defaultValue: '...' }) or group.field() */
+    (key?: string, options?: FieldReadOptions<TDefault>): TValue;
+    (options?: FieldReadOptions<TDefault>): TValue;
+    /** JSX / Astro template component call: <f.text k="home.hero.heading" /> */
+    (props?: FieldComponentProps<TDefault>): unknown;
+    /** Astro component factory call: ($$result, $$props, $$slots) */
+    (result: unknown, props: FieldComponentProps<TDefault>, slots?: unknown): unknown;
+    isAstroComponentFactory: true;
+    typeId: string;
+    publicName: string;
+    prefix?: string;
+    defaultKey?: string;
+}
+interface FieldHelpersMap {
+    text: DualCallableHelper<string>;
+    number: DualCallableHelper<number>;
+    toggle: DualCallableHelper<boolean>;
+    select: DualCallableHelper<string>;
+    img: DualCallableHelper<CmsAsset | string>;
+    image: DualCallableHelper<CmsAsset | string>;
+    vid: DualCallableHelper<CmsAsset | string>;
+    video: DualCallableHelper<CmsAsset | string>;
+    richText: DualCallableHelper<unknown>;
+    richtext: DualCallableHelper<unknown>;
+    [key: string]: any;
+}
+type FieldScope = FieldHelpersMap & {
+    (key: string): string;
+    key(key: string): string;
+    scope(subPrefix: string): FieldScope;
+    readonly prefix: string;
+};
+interface GroupAccessor<TShape = Record<string, unknown>> {
+    attrs(): {
+        'data-cms-group': string;
+    };
+    key(key: string): string;
+    (key: string): string;
+    readonly groupName: string;
+    readonly prefix: string;
+}
+type BoundGroupAccessor<TShape> = GroupAccessor<TShape> & {
+    [K in keyof TShape]: TShape[K] extends DualCallableHelper<infer TVal, infer TDef> ? DualCallableHelper<TVal, TDef> : DualCallableHelper<unknown>;
+};
+interface GroupDefinition<TShape = Record<string, unknown>> {
+    (scopeKey: string): BoundGroupAccessor<TShape>;
+    readonly groupName: string;
+    readonly shape: TShape;
+}
+interface DefineCollectionOptions<TSchema extends z.ZodTypeAny> {
+    key: string;
+    schema: TSchema;
+    route?: string;
+    presentation?: 'visual' | 'form';
+    titleField?: string;
+    listColumns?: string[];
+    bodyField?: string;
+    orderable?: boolean;
+}
+interface CollectionHandle<TSchema extends z.ZodTypeAny = z.ZodTypeAny> {
+    readonly key: string;
+    readonly schema: TSchema;
+    readonly route?: string;
+    readonly presentation?: 'visual' | 'form';
+    readonly titleField?: string;
+    readonly listColumns?: string[];
+    readonly bodyField?: string;
+    readonly orderable?: boolean;
+    readonly jsonSchema: Record<string, unknown>;
+    readonly schemaVersion: number;
+}
+interface CollectionEntry<TContent = Record<string, unknown>> {
+    slug: string;
+    content: TContent;
+    status: 'draft' | 'published' | 'scheduled';
+    published_at?: string | null;
+    position?: string | null;
+}
+type InferEntryContent<T> = T extends CollectionHandle<infer TSchema> ? z.infer<TSchema> : Record<string, unknown>;
+interface CollectionStaticPath<TContent = Record<string, unknown>> {
+    params: {
+        slug: string;
+    };
+    props: {
+        entry: CollectionEntry<TContent>;
+    };
+}
+
+export type { BoundGroupAccessor as B, CollectionHandle as C, DefineCollectionOptions as D, FieldScope as F, GroupDefinition as G, InferEntryContent as I, CollectionEntry as a, CollectionStaticPath as b, DualCallableHelper as c, FieldHelpersMap as d, FieldComponentProps as e, FieldReadOptions as f, GroupAccessor as g };

package/dist/types-NaKJe6Pg.d.ts

@@ -0,0 +1,140 @@
+import { CmsAsset } from '@407dev/blocks';
+
+interface RouteSeo {
+    title?: string;
+    description?: string;
+    canonical?: string;
+    og_image?: string | CmsAsset;
+    og_title?: string;
+    og_description?: string;
+    twitter_card?: 'summary' | 'summary_large_image' | string;
+    noindex?: boolean;
+    sitemap_changefreq?: 'always' | 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly' | 'never';
+    sitemap_priority?: number;
+    [key: string]: unknown;
+}
+interface CmsRedirect {
+    id?: string;
+    from_path: string;
+    to_path: string;
+    status_code: 301 | 302 | 307 | 308 | number;
+    enabled?: boolean;
+    order_key?: string;
+}
+interface CmsSiteConfig {
+    site_id?: string;
+    redirects: CmsRedirect[];
+    robots: {
+        rules?: Array<{
+            user_agent?: string;
+            allow?: string[];
+            disallow?: string[];
+        }>;
+        sitemap?: string | boolean;
+        raw?: string;
+        [key: string]: unknown;
+    };
+    default_seo: RouteSeo;
+    sitemap: {
+        enabled?: boolean;
+        exclude?: string[];
+        [key: string]: unknown;
+    };
+    not_found_path?: string | null;
+    version_number?: number;
+    published_at?: string;
+}
+interface ContentBundle {
+    bundleVersion: 1;
+    site_id: string;
+    fields: Record<string, unknown>;
+    collections: Record<string, {
+        presentation: 'visual' | 'form';
+        orderable: boolean;
+        route_pattern?: string | null;
+        schema_version: number;
+        title_field?: string | null;
+        list_columns?: string[] | null;
+        body_field?: string | null;
+    }>;
+    entries: Record<string, Array<{
+        slug: string;
+        content: Record<string, unknown>;
+        position?: string | null;
+        status: 'draft' | 'published' | 'scheduled';
+        published_at?: string | null;
+    }>>;
+    routes: Array<{
+        path?: string;
+        pattern?: string;
+        kind: 'static' | 'collection';
+        collection?: string | null;
+        sourcePath?: string;
+    }>;
+    settings: {
+        robots?: Record<string, unknown>;
+        default_seo?: RouteSeo;
+        sitemap?: Record<string, unknown>;
+        not_found_path?: string | null;
+    };
+    redirects: Array<{
+        id: string;
+        from_path: string;
+        to_path: string;
+        status_code: number;
+        enabled: boolean;
+        order_key: string;
+    }>;
+}
+interface CmsClientConfig {
+    siteId: string;
+    contentUrl: string;
+    previewSecret?: string;
+    fetch?: typeof fetch;
+}
+interface GetBundleOptions {
+    previewToken?: string | null;
+}
+interface CmsClient {
+    readonly siteId: string;
+    readonly contentUrl: string;
+    readonly previewSecret?: string;
+    getBundle(options?: GetBundleOptions): Promise<ContentBundle>;
+    getFields(options?: GetBundleOptions): Promise<Record<string, unknown>>;
+    getField<T = unknown>(key: string, options?: GetBundleOptions): Promise<T | null>;
+    getCollections(options?: GetBundleOptions): Promise<ContentBundle['collections']>;
+    getEntries(collectionKey: string, options?: GetBundleOptions): Promise<ContentBundle['entries'][string]>;
+    getEntry(collectionKey: string, slug: string, options?: GetBundleOptions): Promise<ContentBundle['entries'][string][number] | null>;
+    getRoutes(options?: GetBundleOptions): Promise<ContentBundle['routes']>;
+    getSiteConfig(options?: GetBundleOptions): Promise<CmsSiteConfig>;
+    clearCache(): void;
+}
+interface PreviewTokenPayload {
+    site_id: string;
+    sub?: string;
+    iat?: number;
+    exp?: number;
+    [key: string]: unknown;
+}
+interface VerifyTokenResult {
+    valid: boolean;
+    payload?: PreviewTokenPayload;
+    error?: string;
+}
+interface CmsIntegrationOptions {
+    siteId?: string;
+    apiUrl?: string;
+    contentUrl?: string;
+    previewSecret?: string;
+    previewEntrypoint?: string;
+    injectPreviewRoute?: boolean;
+    client?: CmsClient;
+    emitRedirects?: boolean;
+    emitRobots?: boolean;
+    emitSitemap?: boolean;
+    siteUrl?: string;
+    editorOrigins?: string[];
+}
+type CmsAstroOptions = CmsIntegrationOptions;
+
+export type { CmsClient as C, GetBundleOptions as G, PreviewTokenPayload as P, RouteSeo as R, VerifyTokenResult as V, CmsClientConfig as a, CmsSiteConfig as b, CmsAstroOptions as c, ContentBundle as d, CmsRedirect as e, CmsIntegrationOptions as f };

package/package.json

@@ -0,0 +1,90 @@
+{
+  "name": "@407dev/cms-astro",
+  "version": "0.1.0",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/407dev/cms.git",
+    "directory": "packages/astro"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./collections": {
+      "source": "./src/fields/collections.ts",
+      "types": "./dist/fields/collections.d.ts",
+      "import": "./dist/fields/collections.js"
+    },
+    "./CmsImage.astro": "./src/CmsImage.astro",
+    "./CmsVideo.astro": "./src/CmsVideo.astro",
+    "./CmsHead.astro": "./src/CmsHead.astro",
+    "./RichText.astro": "./src/RichText.astro",
+    "./middleware": {
+      "source": "./src/middleware/index.ts",
+      "types": "./dist/middleware/index.d.ts",
+      "import": "./dist/middleware/index.js",
+      "default": "./dist/middleware/index.js"
+    },
+    "./toolbar": {
+      "source": "./src/toolbar/app.ts",
+      "types": "./dist/toolbar/app.d.ts",
+      "import": "./dist/toolbar/app.js",
+      "default": "./dist/toolbar/app.js"
+    },
+    "./dev": {
+      "source": "./src/dev/index.ts",
+      "types": "./dist/dev/index.d.ts",
+      "import": "./dist/dev/index.js",
+      "default": "./dist/dev/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "dependencies": {
+    "zod": "^4.4.3",
+    "@407dev/blocks": "0.1.0",
+    "@407dev/field-types": "0.1.0"
+  },
+  "peerDependencies": {
+    "astro": "^5.0.0",
+    "@407dev/cli": "0.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@407dev/cli": {
+      "optional": true
+    },
+    "astro": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "astro": "^5.3.0",
+    "expect-type": "^0.20.0",
+    "tsup": "^8.4.0",
+    "typescript": "^5.7.3",
+    "vite": "^6.1.0",
+    "vitest": "3.0.7",
+    "@407dev/api-client": "0.0.1",
+    "@407dev/cli": "0.1.0",
+    "@407dev/config": "0.0.1",
+    "@407dev/design-tokens": "0.0.1"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "biome check src",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}

package/src/CmsHead.astro

@@ -0,0 +1,25 @@
+---
+import { buildHeadTags } from './head';
+import type { CmsRoute, CmsSiteConfig } from './types';
+
+interface Props {
+  route?: CmsRoute | null;
+  siteConfig?: CmsSiteConfig | null;
+  siteUrl?: string;
+}
+
+const { route, siteConfig, siteUrl } = Astro.props;
+const tags = buildHeadTags(route, siteConfig, { siteUrl });
+---
+{tags.map((t) => {
+  if (t.tag === 'title') {
+    return <title>{t.content}</title>;
+  }
+  if (t.tag === 'meta') {
+    return <meta {...t.attrs} />;
+  }
+  if (t.tag === 'link') {
+    return <link {...t.attrs} />;
+  }
+  return null;
+})}

package/src/CmsImage.astro

@@ -0,0 +1,62 @@
+---
+import type { CmsAsset } from '@407dev/blocks';
+import { buildCdnImageUrl, buildSrcSet, isCdnTransformableUrl } from './image';
+
+interface Props {
+  src: CmsAsset | string;
+  alt: string;
+  widths?: number[];
+  sizes?: string;
+  loading?: 'lazy' | 'eager';
+  class?: string;
+  style?: string;
+  width?: number;
+  height?: number;
+  [key: string]: unknown;
+}
+
+const {
+  src,
+  alt,
+  widths = [400, 800, 1200, 1600],
+  sizes = '100vw',
+  loading = 'lazy',
+  class: className,
+  style: userStyle = '',
+  width: explicitWidth,
+  height: explicitHeight,
+  ...rest
+} = Astro.props;
+
+const isAsset = typeof src === 'object' && src !== null;
+const asset = isAsset ? (src as CmsAsset) : null;
+const rawUrl = asset ? asset.url : (src as string);
+const altText = alt ?? asset?.alt ?? '';
+const intrinsicWidth = explicitWidth ?? asset?.width ?? undefined;
+const intrinsicHeight = explicitHeight ?? asset?.height ?? undefined;
+
+let focalStyle = '';
+if (asset && asset.focal_x !== undefined && asset.focal_y !== undefined) {
+  focalStyle = `object-position: ${Math.round(asset.focal_x * 100)}% ${Math.round(asset.focal_y * 100)}%;`;
+}
+
+const combinedStyle = [focalStyle, userStyle].filter(Boolean).join(' ');
+const canTransform = isCdnTransformableUrl(rawUrl);
+const srcset = canTransform ? buildSrcSet(rawUrl, widths) : undefined;
+const defaultSrc =
+  canTransform && widths.length > 0
+    ? buildCdnImageUrl(rawUrl, { width: widths[1] || widths[0] })
+    : rawUrl;
+---
+<img
+  src={defaultSrc}
+  srcset={srcset}
+  sizes={srcset ? sizes : undefined}
+  alt={altText}
+  width={intrinsicWidth}
+  height={intrinsicHeight}
+  loading={loading}
+  class={className}
+  style={combinedStyle || undefined}
+  {...rest}
+/>