meno-core 1.0.39 → 1.0.40

package/lib/server/webflow/types.ts

@@ -0,0 +1,196 @@
+/**
+ * Webflow Export Types
+ * Defines the payload structure for Webflow Designer API consumption.
+ */
+
+import type { CMSFieldType } from '../../shared/types/cms';
+
+// ---------------------------------------------------------------------------
+// Style Classes
+// ---------------------------------------------------------------------------
+
+/** Webflow breakpoint identifiers */
+export type WebflowBreakpoint = 'Desktop' | 'Tablet' | 'MobilePortrait';
+
+/** Webflow pseudo-state identifiers */
+export type WebflowPseudoState = 'hover' | 'focus' | 'active' | 'visited' | 'focus-visible';
+
+/** CSS properties as a flat record */
+export type CSSProperties = Record<string, string>;
+
+/** A named Webflow style class with responsive + pseudo-state overrides */
+export interface WebflowStyleClass {
+  /** Unique class name (e.g., "c-navigation-hamburger") */
+  name: string;
+  /** Base (Desktop) CSS properties */
+  base: CSSProperties;
+  /** Breakpoint overrides */
+  breakpoints?: Partial<Record<WebflowBreakpoint, CSSProperties>>;
+  /** Pseudo-state overrides */
+  pseudoStates?: Partial<Record<WebflowPseudoState, CSSProperties>>;
+  /** Combo class parent (if this is a variant class) */
+  comboParent?: string;
+}
+
+// ---------------------------------------------------------------------------
+// Elements
+// ---------------------------------------------------------------------------
+
+/** A Webflow element (DOM node) */
+export interface WebflowElement {
+  /** HTML tag (div, section, h1, a, img, etc.) */
+  tag: string;
+  /** Primary class name applied to this element */
+  className?: string;
+  /** Additional combo class names (for StyleMapping variants) */
+  comboClasses?: string[];
+  /** Inline text content (for text nodes) */
+  textContent?: string;
+  /** Child elements */
+  children?: WebflowElement[];
+  /** HTML attributes (src, alt, href, target, etc.) */
+  attributes?: Record<string, string | number | boolean>;
+  /** Raw HTML content (for embed nodes) */
+  rawHtml?: string;
+  /** Whether this element is conditionally rendered */
+  conditional?: {
+    prop: string;
+    condition: 'truthy' | 'equals';
+    value?: string;
+  };
+}
+
+// ---------------------------------------------------------------------------
+// Pages
+// ---------------------------------------------------------------------------
+
+/** A Webflow page */
+export interface WebflowPage {
+  /** Page title */
+  title: string;
+  /** URL slug (e.g., "about", "blog/post-1") */
+  slug: string;
+  /** Meta description */
+  metaDescription?: string;
+  /** Open Graph title */
+  ogTitle?: string;
+  /** Open Graph description */
+  ogDescription?: string;
+  /** Open Graph image URL */
+  ogImage?: string;
+  /** Root elements of the page body */
+  elements: WebflowElement[];
+  /** Locale code */
+  locale?: string;
+}
+
+// ---------------------------------------------------------------------------
+// CMS
+// ---------------------------------------------------------------------------
+
+/** Webflow CMS field type mapping */
+export type WebflowFieldType =
+  | 'PlainText'
+  | 'RichText'
+  | 'Number'
+  | 'Switch'
+  | 'Image'
+  | 'Date'
+  | 'Option'
+  | 'File'
+  | 'Reference';
+
+/** A field in a Webflow CMS collection */
+export interface WebflowCMSField {
+  /** Field display name */
+  name: string;
+  /** Field slug (machine name) */
+  slug: string;
+  /** Webflow field type */
+  type: WebflowFieldType;
+  /** Whether this field is required */
+  required?: boolean;
+  /** Options for Option type fields */
+  options?: string[];
+}
+
+/** A Webflow CMS collection definition */
+export interface WebflowCMSCollection {
+  /** Collection display name */
+  name: string;
+  /** Collection slug */
+  slug: string;
+  /** URL pattern for detail pages */
+  urlPattern?: string;
+  /** Field definitions */
+  fields: WebflowCMSField[];
+  /** Collection items */
+  items: Record<string, unknown>[];
+}
+
+// ---------------------------------------------------------------------------
+// Assets
+// ---------------------------------------------------------------------------
+
+/** Reference to an asset that needs uploading to Webflow */
+export interface WebflowAssetRef {
+  /** Local file path relative to project root */
+  localPath: string;
+  /** Asset type */
+  type: 'image' | 'font' | 'video' | 'file';
+  /** File name */
+  fileName: string;
+}
+
+// ---------------------------------------------------------------------------
+// Export Payload
+// ---------------------------------------------------------------------------
+
+/** Complete Webflow export payload */
+export interface WebflowExportPayload {
+  /** Export format version */
+  version: 1;
+  /** Timestamp of export */
+  exportedAt: string;
+  /** All pages with their element trees */
+  pages: WebflowPage[];
+  /** All style class definitions */
+  styles: WebflowStyleClass[];
+  /** CMS collection definitions (if any) */
+  cms: WebflowCMSCollection[];
+  /** Asset references (images, fonts, etc.) */
+  assets: WebflowAssetRef[];
+  /** CSS variables used in styles (for global embed) */
+  cssVariables?: Record<string, string>;
+}
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+/** Map Meno CMS field type → Webflow field type */
+export function mapCMSFieldType(menoType: CMSFieldType): WebflowFieldType {
+  switch (menoType) {
+    case 'string':
+      return 'PlainText';
+    case 'text':
+    case 'rich-text':
+      return 'RichText';
+    case 'number':
+      return 'Number';
+    case 'boolean':
+      return 'Switch';
+    case 'image':
+      return 'Image';
+    case 'date':
+      return 'Date';
+    case 'select':
+      return 'Option';
+    case 'file':
+      return 'File';
+    case 'reference':
+      return 'Reference';
+    default:
+      return 'PlainText';
+  }
+}

package/lib/shared/constants.ts

@@ -69,6 +69,8 @@ export const API_ROUTES = {
   // Enums API routes
   ENUMS: '/api/enums', // Get enums config
   SAVE_ENUMS: '/api/save-enums', // Save enums config
+  // Component usage
+  COMPONENT_USAGE: '/api/component-usage', // Get component usage across project
 } as const;
 
 export const HMR_ROUTE = '/hmr';

package/lib/shared/types/components.ts

@@ -69,6 +69,7 @@ export interface BasePropDefinition {
   options?: readonly string[];  // Required for "select" type (inline options)
   enumName?: string;  // For "select" type: reference to project-level enum
   accept?: string;  // For "file" type: MIME pattern like "image/*", "video/*"
+  editor?: 'basic' | 'extended';  // For 'rich-text' type: which editor to use
 }
 
 /**

package/lib/shared/validation/schemas.ts

@@ -31,6 +31,7 @@ export const BasePropDefinitionSchema = z.object({
   options: z.array(z.string()).readonly().optional(),
   enumName: z.string().optional(), // For 'select' type: reference to project-level enum
   accept: z.string().optional(), // For 'file' type: MIME pattern like "image/*", "video/*"
+  editor: z.enum(['basic', 'extended']).optional(), // For 'rich-text' type: which editor to use
 }).passthrough();
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "meno-core",
-  "version": "1.0.39",
+  "version": "1.0.40",
   "type": "module",
   "bin": {
     "meno": "./dist/bin/cli.js"