@pixerate/schemas 1.3.0 → 1.5.0

package/dist/index.js

@@ -177,20 +177,193 @@ var CodeGenerationSchema = z.object({
   prompt: z.string(),
   language: z.string()
 });
-var ComponentPropDefinitionSchema = z.object({
+var PlatformLanguageSchema = z.enum(["svelte", "react", "webcomponent"]);
+var ThemeSupportSchema = z.enum(["default", "light-and-dark"]);
+var ComponentPropDocSchema = z.object({
   name: z.string(),
   type: z.string(),
   default: z.string().optional(),
-  description: z.string().optional()
+  description: z.string()
+});
+var ComponentPropDefinitionSchema = ComponentPropDocSchema;
+var ComponentDocsSchema = z.object({
+  usage: z.string().describe("Usage instructions and import examples"),
+  props: z.array(ComponentPropDocSchema).describe("List of prop definitions and types"),
+  notes: z.string().optional().describe("Additional usage or architectural notes")
+});
+var PreviewHarnessSchema = z.object({
+  driverCode: z.string().describe(
+    "Complete, runnable preview driver code harness demonstrating usage of the component with snippets/children or mock props"
+  ),
+  mockProps: z.record(z.any()).describe("JSON map of realistic mock prop values passed to the component"),
+  wrapperClass: z.string().optional().describe("Tailwind CSS class string for wrapping the preview container")
+});
+var GenerateHarnessOptionsSchema = z.object({
+  code: z.string(),
+  language: PlatformLanguageSchema,
+  componentName: z.string(),
+  docsProps: z.array(ComponentPropDocSchema).optional()
 });
 var ComponentSynthesisSchema = z.object({
-  svelte5: z.string().describe("Synthesized Svelte 5 component implementation using runes"),
-  reactTsx: z.string().describe("Synthesized React 19 TSX component implementation"),
-  webComponent: z.string().describe("Synthesized WebComponent custom element implementation"),
-  usageDocs: z.string().describe("Markdown documentation detailing props and usage patterns"),
-  propsSummary: z.array(ComponentPropDefinitionSchema).describe("List of prop definitions and types"),
-  supportedThemes: z.enum(["default", "light-and-dark"]).describe("Color theme support classification"),
-  previewHtml: z.string().optional().describe("Self-contained interactive preview HTML harness")
+  title: z.string().describe("Title of the synthesized component"),
+  description: z.string().describe("Detailed description of the component"),
+  tags: z.array(z.string()).describe("Keywords and categorization tags"),
+  platforms: z.object({
+    svelte: z.string().describe("Self-contained Svelte 5 component with runes ($props, $state, onclick, snippets, etc.)"),
+    react: z.string().describe("Self-contained React 19 TSX component with all subcomponents defined and exported"),
+    webcomponent: z.string().describe("Self-contained WebComponent custom element extending HTMLElement")
+  }),
+  harnesses: z.object({
+    svelte: PreviewHarnessSchema,
+    react: PreviewHarnessSchema,
+    webcomponent: PreviewHarnessSchema
+  }).optional(),
+  docs: ComponentDocsSchema
+});
+var ComponentTransformationResultSchema = z.object({
+  title: z.string(),
+  description: z.string(),
+  tags: z.array(z.string()),
+  platforms: z.record(PlatformLanguageSchema, z.string()),
+  harnesses: z.record(PlatformLanguageSchema, PreviewHarnessSchema),
+  docs: ComponentDocsSchema,
+  detectedLanguage: PlatformLanguageSchema,
+  themeSupport: ThemeSupportSchema
+});
+var ComponentPackageSchema = z.object({
+  language: PlatformLanguageSchema,
+  code: z.string().describe("Formatted code bundle with trimmed leading whitespace"),
+  docs: ComponentDocsSchema,
+  screenshot: z.string().describe("Data URI or URL of actual rendered component"),
+  themeSupport: ThemeSupportSchema,
+  tags: z.array(z.string()),
+  previewHarness: PreviewHarnessSchema.optional()
+});
+var UIComponentTypeSchema = z.object({
+  id: z.string().describe("Slug, e.g., 'button'"),
+  name: z.string().describe("e.g. 'Button'"),
+  description: z.string().describe("Official description e.g. from Shadcn documentation"),
+  tags: z.array(z.string()).describe("Freeform tags e.g. ['form', 'action']"),
+  createdAt: z.string().describe("ISO timestamp"),
+  updatedAt: z.string().describe("ISO timestamp")
+});
+var ComponentVariantSchema = z.object({
+  id: z.string().describe("Slug, e.g., 'glass-card' or 'glassmorphism'"),
+  componentTypeId: z.string().describe("References UIComponentType.id"),
+  name: z.string().describe("e.g. 'Glass Action Button'"),
+  aestheticId: z.string().describe("Style aesthetic, e.g. 'glassmorphism', 'neubrutalism', 'minimalist', 'modern', 'shadcn'"),
+  recommendedThemeId: z.string().optional().describe("Optional recommended theme ID (e.g., 'shadcn-zinc', 'tokyo-night')"),
+  description: z.string().optional().describe("Style & business logic description"),
+  imageUrl: z.string().optional().describe("Optional image URL"),
+  image: z.string().optional(),
+  screenshot: z.string().optional(),
+  createdAt: z.string().describe("ISO timestamp"),
+  updatedAt: z.string().describe("ISO timestamp")
+});
+var AestheticSchema = ComponentVariantSchema;
+var ComponentVersionSchema = z.object({
+  id: z.string().describe("Unique version ID e.g. 'button-glass-action-button-v1.0.0'"),
+  componentTypeId: z.string().describe("References UIComponentType.id"),
+  variantId: z.string().describe("References ComponentVariant.id"),
+  aestheticId: z.string().describe("References Aesthetic style e.g. 'glassmorphism'"),
+  version: z.string().describe("Semver e.g. '1.0.0'"),
+  changelogNote: z.string(),
+  createdBy: z.string(),
+  createdAt: z.string().describe("ISO timestamp"),
+  packages: z.record(PlatformLanguageSchema, ComponentPackageSchema)
+});
+var ActivityActionSchema = z.enum([
+  "CREATED",
+  "UPDATED",
+  "REVERTED",
+  "PACKAGE_GENERATED",
+  "DELETED"
+]);
+var ActivityLogSchema = z.object({
+  id: z.string(),
+  componentTypeId: z.string(),
+  componentTypeName: z.string(),
+  variantId: z.string().optional(),
+  aestheticId: z.string(),
+  action: ActivityActionSchema,
+  version: z.string(),
+  details: z.string(),
+  timestamp: z.string()
+});
+var IngestionInputSchema = z.object({
+  codeBundle: z.string().describe("Raw code bundle provided"),
+  css: z.string().optional().describe("Optional raw CSS or CSS bundle to extract and inline"),
+  componentTypeId: z.string().describe("Slug or Name of UI Component Type (e.g., 'button')"),
+  variantName: z.string().describe("Mandatory Variant Name text input (e.g., 'Glass Action Button')"),
+  variantId: z.string().optional().describe("Optional custom slug or ID for variant"),
+  aestheticId: z.string().optional().describe("Dropdown value for aesthetic style (e.g., 'glassmorphism', 'neubrutalism', 'minimalist', 'modern', 'shadcn')"),
+  recommendedThemeId: z.string().optional().describe("Optional recommended theme ID"),
+  componentTypeName: z.string().optional().describe("Optional display name if creating new component type"),
+  componentTypeDescription: z.string().optional().describe("Optional description if creating new component type"),
+  variantDescription: z.string().optional().describe("Optional description if creating new variant"),
+  aestheticName: z.string().optional().describe("Optional display name for aesthetic"),
+  aestheticDescription: z.string().optional().describe("Optional description if creating new aesthetic"),
+  sourcePlatform: PlatformLanguageSchema.optional().describe("Optional source platform - detected automatically if omitted"),
+  changelogNote: z.string().optional(),
+  tags: z.array(z.string()).optional()
+});
+var ThemeColorsSchema = z.object({
+  primary: z.string(),
+  primaryForeground: z.string().optional(),
+  secondary: z.string().optional(),
+  secondaryForeground: z.string().optional(),
+  accent: z.string().optional(),
+  accentForeground: z.string().optional(),
+  background: z.string(),
+  foreground: z.string(),
+  surface: z.string().optional(),
+  surfaceForeground: z.string().optional(),
+  muted: z.string().optional(),
+  mutedForeground: z.string().optional(),
+  destructive: z.string().optional(),
+  destructiveForeground: z.string().optional(),
+  border: z.string().optional(),
+  ring: z.string().optional(),
+  customProperties: z.record(z.string()).optional()
+});
+var ThemeTypographyTokensSchema = z.object({
+  fontSans: z.string().optional(),
+  fontMono: z.string().optional(),
+  fontHeading: z.string().optional(),
+  fontImports: z.array(z.string()).optional(),
+  fontCss: z.string().optional(),
+  fontSize: z.record(z.string()).optional(),
+  fontWeight: z.record(z.string()).optional()
+});
+var ThemeTokensSchema = z.object({
+  colors: z.object({
+    light: ThemeColorsSchema,
+    dark: ThemeColorsSchema.partial().optional()
+  }),
+  typography: ThemeTypographyTokensSchema.optional(),
+  radii: z.record(z.string().optional()).optional(),
+  spacing: z.record(z.string()).optional(),
+  paddings: z.record(z.string()).optional(),
+  shadows: z.record(z.string()).optional()
+});
+var ThemeSchema = z.object({
+  id: z.string().describe("e.g. 'shadcn-zinc', 'tokyo-night', 'glassmorphism-cyber'"),
+  name: z.string().describe("e.g. 'Shadcn Zinc Modern'"),
+  description: z.string().optional(),
+  tokens: ThemeTokensSchema,
+  supportsDarkMode: z.boolean().optional(),
+  isSystem: z.boolean().optional(),
+  createdAt: z.string().describe("ISO timestamp"),
+  updatedAt: z.string().describe("ISO timestamp")
+});
+var ThemeIngestionInputSchema = z.object({
+  id: z.string().optional(),
+  name: z.string(),
+  description: z.string().optional(),
+  tokens: ThemeTokensSchema.optional(),
+  rawCss: z.string().optional(),
+  supportsDarkMode: z.boolean().optional(),
+  isSystem: z.boolean().optional()
 });
 var JsonGenerationSchema = z.object({
   prompt: z.string(),
@@ -476,7 +649,268 @@ var FormSubmissionPayloadSchema = z.object({
   submittedAt: z.string().optional(),
   score: SubmissionScoreSchema.optional()
 });
+var formJsonCondition = {
+  type: "object",
+  properties: {
+    field: { type: "string" },
+    fieldId: { type: "string" },
+    operator: {
+      enum: [
+        "equals",
+        "notEquals",
+        "not_equals",
+        "includes",
+        "contains",
+        "greaterThan",
+        "greater_than",
+        "lessThan",
+        "less_than",
+        "exists"
+      ]
+    },
+    value: { type: ["string", "number", "boolean"] }
+  },
+  required: ["operator"]
+};
+var formJsonControl = {
+  type: "object",
+  properties: {
+    id: { type: "string" },
+    type: {
+      enum: [
+        "text",
+        "textarea",
+        "number",
+        "select",
+        "multiselect",
+        "radio",
+        "checkbox",
+        "date",
+        "file",
+        "company",
+        "user",
+        "slider",
+        "computed",
+        "repeater"
+      ]
+    },
+    label: { type: "string" },
+    description: { type: "string" },
+    helperText: { type: "string" },
+    placeholder: { type: "string" },
+    required: { type: "boolean" },
+    defaultValue: {},
+    options: {
+      type: "array",
+      items: {
+        type: "object",
+        properties: { label: { type: "string" }, value: { type: "string" } },
+        required: ["label", "value"]
+      }
+    },
+    dataSource: { enum: ["companies", "users"] },
+    validation: {
+      type: "object",
+      properties: {
+        min: { type: "number" },
+        max: { type: "number" },
+        minLength: { type: "number" },
+        maxLength: { type: "number" },
+        pattern: { type: "string" },
+        message: { type: "string" },
+        unit: { type: "string" }
+      }
+    },
+    pattern: { type: "string" },
+    min: { type: "number" },
+    max: { type: "number" },
+    step: { type: "number" },
+    minItems: { type: "number" },
+    maxItems: { type: "number" },
+    formula: { type: "string" },
+    computed: { type: "object", properties: { formula: { type: "string" } } },
+    visibleWhen: formJsonCondition,
+    condition: formJsonCondition,
+    itemControls: { type: "array", items: { $ref: "#/$defs/control" } },
+    controls: { type: "array", items: { $ref: "#/$defs/control" } }
+  },
+  required: ["id", "type", "label"]
+};
+var FORM_SCHEMA_JSON_SCHEMA = {
+  $schema: "https://json-schema.org/draft/2020-12/schema",
+  $id: "https://workspace.local/schemas/generative-forms/form-schema-v1.json",
+  type: "object",
+  $defs: { control: formJsonControl },
+  properties: {
+    id: { type: "string" },
+    title: { type: "string" },
+    description: { type: "string" },
+    version: { type: ["string", "number"] },
+    stages: {
+      type: "array",
+      items: {
+        type: "object",
+        properties: {
+          id: { type: "string" },
+          title: { type: "string" },
+          description: { type: "string" },
+          gate: { type: "string" },
+          sections: {
+            type: "array",
+            items: {
+              type: "object",
+              properties: {
+                id: { type: "string" },
+                title: { type: "string" },
+                description: { type: "string" },
+                controls: { type: "array", items: { $ref: "#/$defs/control" } },
+                visibleWhen: formJsonCondition,
+                condition: formJsonCondition
+              },
+              required: ["id", "title", "controls"]
+            }
+          }
+        },
+        required: ["id", "title", "sections"]
+      }
+    },
+    decisionGates: {
+      type: "array",
+      items: {
+        type: "object",
+        properties: {
+          id: { type: "string" },
+          title: { type: "string" },
+          description: { type: "string" },
+          stageId: { type: "string" },
+          kind: { enum: ["approval", "review", "decision"] },
+          trigger: { type: "string" },
+          requiredAction: { type: "string" },
+          consequence: { type: "string" },
+          condition: { anyOf: [formJsonCondition, { type: "string" }] },
+          blocking: { type: "boolean" },
+          reviewerRole: { type: "string" }
+        },
+        required: ["id", "title", "stageId", "blocking"]
+      }
+    },
+    validators: {
+      type: "array",
+      items: {
+        type: "object",
+        properties: {
+          id: { type: "string" },
+          description: { type: "string" },
+          fields: { type: "array", items: { type: "string" } },
+          severity: { type: "string" },
+          type: { type: "string" },
+          config: {}
+        },
+        required: ["id"]
+      }
+    },
+    handoffActions: {
+      type: "array",
+      items: {
+        type: "object",
+        properties: {
+          id: { type: "string" },
+          label: { type: "string" },
+          destination: { type: "string" },
+          condition: { anyOf: [formJsonCondition, { type: "string" }] },
+          payloadFields: { type: "array", items: { type: "string" } },
+          type: { type: "string" },
+          config: {}
+        }
+      }
+    },
+    review: {
+      type: "object",
+      properties: {
+        humanReviewRequired: { type: "boolean" },
+        reviewAreas: { type: "array", items: { type: "string" } }
+      },
+      required: ["humanReviewRequired", "reviewAreas"]
+    },
+    reviewMetadata: {
+      type: "object",
+      properties: {
+        approvers: { type: "array", items: { type: "string" } },
+        requirements: { type: "array", items: { type: "string" } }
+      },
+      required: ["approvers", "requirements"]
+    },
+    scoring: {
+      type: "object",
+      properties: {
+        description: { type: "string" },
+        dimensions: {
+          type: "array",
+          minItems: 1,
+          items: {
+            type: "object",
+            properties: {
+              id: { type: "string" },
+              label: { type: "string" },
+              description: { type: "string" },
+              weight: { type: "number" },
+              rules: {
+                type: "array",
+                minItems: 1,
+                items: {
+                  type: "object",
+                  properties: {
+                    field: { type: "string" },
+                    optionPoints: {
+                      type: "object",
+                      additionalProperties: { type: "number" }
+                    },
+                    ranges: {
+                      type: "array",
+                      items: {
+                        type: "object",
+                        properties: {
+                          min: { type: "number" },
+                          max: { type: "number" },
+                          points: { type: "number" }
+                        },
+                        required: ["points"]
+                      }
+                    },
+                    multiplier: { type: "number" },
+                    truePoints: { type: "number" },
+                    falsePoints: { type: "number" }
+                  },
+                  required: ["field"]
+                }
+              }
+            },
+            required: ["id", "label", "rules"]
+          }
+        },
+        bands: {
+          type: "array",
+          items: {
+            type: "object",
+            properties: {
+              id: { type: "string" },
+              label: { type: "string" },
+              min: { type: "number" },
+              max: { type: "number" }
+            },
+            required: ["id", "label", "min"]
+          }
+        }
+      },
+      required: ["dimensions"]
+    }
+  },
+  required: ["version", "stages"]
+};
 export {
+  ActivityActionSchema,
+  ActivityLogSchema,
+  AestheticSchema,
   AgentConfigSchema,
   AgentDocumentAttachmentSchema,
   AgentEnvironmentSchema,
@@ -489,8 +923,14 @@ export {
   AgentToolTypeSchema,
   AspectRatioSchema,
   CodeGenerationSchema,
+  ComponentDocsSchema,
+  ComponentPackageSchema,
   ComponentPropDefinitionSchema,
+  ComponentPropDocSchema,
   ComponentSynthesisSchema,
+  ComponentTransformationResultSchema,
+  ComponentVariantSchema,
+  ComponentVersionSchema,
   ConditionOperatorSchema,
   ConditionSchema,
   ControlValidationSchema,
@@ -498,6 +938,7 @@ export {
   DecisionGateSchema,
   DimensionScoreSchema,
   DropShadowSchema,
+  FORM_SCHEMA_JSON_SCHEMA,
   FidelitySchema,
   FormControlSchema,
   FormControlTypeSchema,
@@ -508,12 +949,16 @@ export {
   FormStageSchema,
   FormSubmissionPayloadSchema,
   FormValidatorSchema,
+  GenerateHarnessOptionsSchema,
   ImageCompositingSchema,
   ImageGenerationSchema,
   ImageTextOverlaySchema,
   ImageTransformationSchema,
   ImageWatermarkSchema,
+  IngestionInputSchema,
   JsonGenerationSchema,
+  PlatformLanguageSchema,
+  PreviewHarnessSchema,
   QueueJobSchema,
   QueueJobStatusSchema,
   QueueJobTypeSchema,
@@ -531,6 +976,13 @@ export {
   TechnicalFormSchema,
   TextAlignmentSchema,
   TextOverlayPositionSchema,
+  ThemeColorsSchema,
+  ThemeIngestionInputSchema,
+  ThemeSchema,
+  ThemeSupportSchema,
+  ThemeTokensSchema,
+  ThemeTypographyTokensSchema,
+  UIComponentTypeSchema,
   VideoAnalysisCategorySchema,
   VideoAnalysisSchema,
   VideoAspectRatioSchema,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pixerate/schemas",
-  "version": "1.3.0",
+  "version": "1.5.0",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",