@buoy-design/core 0.1.0

package/dist/models/component.js

@@ -0,0 +1,116 @@
+import { z } from 'zod';
+// Component source location types
+export const ReactSourceSchema = z.object({
+    type: z.literal('react'),
+    path: z.string(),
+    exportName: z.string(),
+    line: z.number().optional(),
+});
+export const FigmaSourceSchema = z.object({
+    type: z.literal('figma'),
+    fileKey: z.string(),
+    nodeId: z.string(),
+    url: z.string().optional(),
+});
+export const StorybookSourceSchema = z.object({
+    type: z.literal('storybook'),
+    storyId: z.string(),
+    kind: z.string(),
+    url: z.string().optional(),
+});
+export const VueSourceSchema = z.object({
+    type: z.literal('vue'),
+    path: z.string(),
+    exportName: z.string(),
+    line: z.number().optional(),
+});
+export const SvelteSourceSchema = z.object({
+    type: z.literal('svelte'),
+    path: z.string(),
+    exportName: z.string(),
+    line: z.number().optional(),
+});
+export const ComponentSourceSchema = z.discriminatedUnion('type', [
+    ReactSourceSchema,
+    FigmaSourceSchema,
+    StorybookSourceSchema,
+    VueSourceSchema,
+    SvelteSourceSchema,
+]);
+// Prop definitions
+export const PropDefinitionSchema = z.object({
+    name: z.string(),
+    type: z.string(),
+    required: z.boolean(),
+    defaultValue: z.unknown().optional(),
+    description: z.string().optional(),
+});
+// Variant definitions
+export const VariantDefinitionSchema = z.object({
+    name: z.string(),
+    props: z.record(z.unknown()),
+});
+// Token references within components
+export const TokenReferenceSchema = z.object({
+    tokenId: z.string(),
+    tokenName: z.string(),
+    usage: z.enum(['color', 'spacing', 'typography', 'shadow', 'border', 'other']),
+    location: z.string(),
+});
+// Accessibility info
+export const AccessibilityInfoSchema = z.object({
+    hasAriaLabel: z.boolean().optional(),
+    hasRole: z.boolean().optional(),
+    issues: z.array(z.string()).optional(),
+});
+// Hardcoded style value (could be a token)
+export const HardcodedValueSchema = z.object({
+    type: z.enum(['color', 'spacing', 'fontSize', 'fontFamily', 'shadow', 'border', 'other']),
+    value: z.string(),
+    property: z.string(), // e.g., 'backgroundColor', 'padding', 'color'
+    location: z.string(), // line:column or description
+});
+// Component metadata
+export const ComponentMetadataSchema = z.object({
+    deprecated: z.boolean().optional(),
+    deprecationReason: z.string().optional(),
+    tags: z.array(z.string()).optional(),
+    accessibility: AccessibilityInfoSchema.optional(),
+    documentation: z.string().optional(),
+    hardcodedValues: z.array(HardcodedValueSchema).optional(),
+});
+// Main Component schema
+export const ComponentSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    source: ComponentSourceSchema,
+    props: z.array(PropDefinitionSchema),
+    variants: z.array(VariantDefinitionSchema),
+    tokens: z.array(TokenReferenceSchema),
+    dependencies: z.array(z.string()),
+    metadata: ComponentMetadataSchema,
+    scannedAt: z.date(),
+});
+// Helper to create component ID
+export function createComponentId(source, _name) {
+    switch (source.type) {
+        case 'react':
+            return `react:${source.path}:${source.exportName}`;
+        case 'figma':
+            return `figma:${source.fileKey}:${source.nodeId}`;
+        case 'storybook':
+            return `storybook:${source.storyId}`;
+        case 'vue':
+            return `vue:${source.path}:${source.exportName}`;
+        case 'svelte':
+            return `svelte:${source.path}:${source.exportName}`;
+    }
+}
+// Helper to normalize component name for matching
+export function normalizeComponentName(name) {
+    return name
+        .toLowerCase()
+        .replace(/[-_\s]/g, '')
+        .replace(/component$/i, '');
+}
+//# sourceMappingURL=component.js.map

package/dist/models/component.js.map

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

package/dist/models/component.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=component.test.d.ts.map

package/dist/models/component.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.test.d.ts","sourceRoot":"","sources":["../../src/models/component.test.ts"],"names":[],"mappings":""}

package/dist/models/component.test.js

@@ -0,0 +1,55 @@
+// packages/core/src/models/component.test.ts
+import { describe, it, expect } from 'vitest';
+import { createComponentId, normalizeComponentName } from './component.js';
+describe('component model helpers', () => {
+    describe('createComponentId', () => {
+        it('creates id for React component', () => {
+            const source = {
+                type: 'react',
+                path: 'src/Button.tsx',
+                exportName: 'Button',
+            };
+            const id = createComponentId(source, 'Button');
+            expect(id).toBe('react:src/Button.tsx:Button');
+        });
+        it('creates id for Figma component', () => {
+            const source = {
+                type: 'figma',
+                fileKey: 'abc123',
+                nodeId: '1:23',
+            };
+            const id = createComponentId(source, 'Button');
+            expect(id).toBe('figma:abc123:1:23');
+        });
+        it('creates id for Vue component', () => {
+            const source = {
+                type: 'vue',
+                path: 'src/Button.vue',
+                exportName: 'default',
+            };
+            const id = createComponentId(source, 'Button');
+            expect(id).toBe('vue:src/Button.vue:default');
+        });
+    });
+    describe('normalizeComponentName', () => {
+        it('lowercases names', () => {
+            expect(normalizeComponentName('Button')).toBe('button');
+        });
+        it('removes hyphens', () => {
+            expect(normalizeComponentName('my-button')).toBe('mybutton');
+        });
+        it('removes underscores', () => {
+            expect(normalizeComponentName('my_button')).toBe('mybutton');
+        });
+        it('removes spaces', () => {
+            expect(normalizeComponentName('My Button')).toBe('mybutton');
+        });
+        it('removes Component suffix', () => {
+            expect(normalizeComponentName('ButtonComponent')).toBe('button');
+        });
+        it('handles complex names', () => {
+            expect(normalizeComponentName('Primary-Button_Component')).toBe('primarybutton');
+        });
+    });
+});
+//# sourceMappingURL=component.test.js.map

package/dist/models/component.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.test.js","sourceRoot":"","sources":["../../src/models/component.test.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAG3E,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;QACjC,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;YACxC,MAAM,MAAM,GAAgB;gBAC1B,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,gBAAgB;gBACtB,UAAU,EAAE,QAAQ;aACrB,CAAC;YACF,MAAM,EAAE,GAAG,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAC/C,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;YACxC,MAAM,MAAM,GAAgB;gBAC1B,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,QAAQ;gBACjB,MAAM,EAAE,MAAM;aACf,CAAC;YACF,MAAM,EAAE,GAAG,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAC/C,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;YACtC,MAAM,MAAM,GAAc;gBACxB,IAAI,EAAE,KAAK;gBACX,IAAI,EAAE,gBAAgB;gBACtB,UAAU,EAAE,SAAS;aACtB,CAAC;YACF,MAAM,EAAE,GAAG,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAC/C,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;QACtC,EAAE,CAAC,kBAAkB,EAAE,GAAG,EAAE;YAC1B,MAAM,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iBAAiB,EAAE,GAAG,EAAE;YACzB,MAAM,CAAC,sBAAsB,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;YAC7B,MAAM,CAAC,sBAAsB,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gBAAgB,EAAE,GAAG,EAAE;YACxB,MAAM,CAAC,sBAAsB,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;YAClC,MAAM,CAAC,sBAAsB,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;YAC/B,MAAM,CAAC,sBAAsB,CAAC,0BAA0B,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACnF,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}