@defai.digital/ax-cli 3.14.9 → 3.14.11

package/node_modules/@ax-cli/schemas/dist/public/design/alias-types.js

@@ -0,0 +1,171 @@
+/**
+ * Design Alias Schemas
+ *
+ * Zod schemas for the alias system that maps human-readable names
+ * to Figma file keys and node IDs.
+ *
+ * @module design/alias-types
+ */
+import { z } from 'zod';
+import { brand } from '../core/brand-types.js';
+/**
+ * Alias format pattern
+ */
+const ALIAS_PATTERN = /^[a-z][a-z0-9]*(\.[a-z][a-z0-9]*)*(-[a-z0-9]+)*$/;
+/**
+ * Validate alias format: lowercase letters, numbers, dots, hyphens
+ * Examples: "landing.hero", "ds.colors.primary", "button-primary"
+ *
+ * Note: This schema validates but does NOT transform to branded type
+ * to avoid TypeScript declaration emit issues with __brand symbol.
+ * Use `createDesignAlias()` to create branded values.
+ */
+export const DesignAliasSchema = z
+    .string()
+    .min(1, 'Alias cannot be empty')
+    .max(100, 'Alias too long (max 100 characters)')
+    .regex(ALIAS_PATTERN, 'Alias must start with lowercase letter, use dots for hierarchy (e.g., "landing.hero")');
+/**
+ * Create a branded DesignAlias from a validated string
+ */
+export function createDesignAlias(value) {
+    const validated = DesignAliasSchema.parse(value);
+    return brand(validated);
+}
+/**
+ * Safely parse and create a DesignAlias
+ */
+export function parseDesignAlias(value) {
+    const result = DesignAliasSchema.safeParse(value);
+    if (result.success) {
+        return { success: true, data: brand(result.data) };
+    }
+    return { success: false, error: result.error };
+}
+// =============================================================================
+// Alias Target Schema
+// =============================================================================
+/**
+ * Target reference for an alias
+ */
+export const AliasTargetSchema = z.object({
+    /** Figma file key */
+    fileKey: z.string().min(1, 'File key required'),
+    /** Node ID within the file */
+    nodeId: z.string().regex(/^\d+:\d+$/, 'Invalid node ID format'),
+    /** Optional description of this alias */
+    description: z.string().optional(),
+    /** When this alias was created/updated */
+    updatedAt: z.string().datetime().optional(),
+});
+// =============================================================================
+// Alias Configuration File Schema
+// =============================================================================
+/**
+ * Complete alias configuration stored in .ax-cli/design.json
+ */
+export const DesignConfigSchema = z.object({
+    /** Schema version for future migrations */
+    version: z.literal(1),
+    /** Default file key when not specified in alias */
+    defaultFile: z.string().min(1).optional(),
+    /** Optional design system file key (for DS-specific operations) */
+    dsFile: z.string().min(1).optional(),
+    /** Map of alias names to targets */
+    aliases: z.record(z.string(), // Key is the alias name (validated separately)
+    AliasTargetSchema),
+    /** Metadata about the configuration */
+    meta: z.object({
+        /** When config was last modified */
+        lastModified: z.string().datetime().optional(),
+        /** Figma file names for display */
+        fileNames: z.record(z.string(), z.string()).optional(),
+    }).optional(),
+});
+/**
+ * Create empty design config
+ */
+export function createEmptyDesignConfig() {
+    return {
+        version: 1,
+        aliases: {},
+    };
+}
+// =============================================================================
+// Alias Operation Schemas
+// =============================================================================
+/**
+ * Input for adding a new alias
+ */
+export const AddAliasInputSchema = z.object({
+    alias: DesignAliasSchema,
+    fileKey: z.string().min(1, 'File key required'),
+    nodeId: z.string().regex(/^\d+:\d+$/, 'Invalid node ID format'),
+    description: z.string().optional(),
+});
+/**
+ * Result of alias operations
+ */
+export const AliasOperationResultSchema = z.object({
+    success: z.boolean(),
+    alias: z.string(),
+    message: z.string(),
+    target: AliasTargetSchema.optional(),
+});
+// =============================================================================
+// Alias Resolution Schema
+// =============================================================================
+/**
+ * Resolved alias with all information
+ */
+export const ResolvedAliasSchema = z.object({
+    /** Original alias name */
+    alias: z.string(),
+    /** Resolved file key */
+    fileKey: z.string(),
+    /** Resolved node ID */
+    nodeId: z.string(),
+    /** Whether this was explicitly defined or derived */
+    source: z.enum(['explicit', 'default-file', 'ds-file']),
+    /** Description if available */
+    description: z.string().optional(),
+});
+/**
+ * Alias resolution error
+ */
+export const AliasResolutionErrorSchema = z.object({
+    alias: z.string(),
+    error: z.enum([
+        'not_found',
+        'no_default_file',
+        'invalid_format',
+        'ambiguous',
+    ]),
+    message: z.string(),
+    suggestions: z.array(z.string()).optional(),
+});
+// =============================================================================
+// Alias List Display Schema
+// =============================================================================
+/**
+ * Alias entry for display in list command
+ */
+export const AliasListEntrySchema = z.object({
+    alias: z.string(),
+    fileKey: z.string(),
+    nodeId: z.string(),
+    fileName: z.string().optional(),
+    nodeName: z.string().optional(),
+    description: z.string().optional(),
+    updatedAt: z.string().optional(),
+});
+/**
+ * Full alias list response
+ */
+export const AliasListResponseSchema = z.object({
+    defaultFile: z.string().optional(),
+    dsFile: z.string().optional(),
+    aliases: z.array(AliasListEntrySchema),
+    total: z.number(),
+});
+//# sourceMappingURL=alias-types.js.map

package/node_modules/@ax-cli/schemas/dist/public/design/alias-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alias-types.js","sourceRoot":"","sources":["../../../src/public/design/alias-types.ts"],"names":[],"mappings":"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"}