@sarjallab09/figma-intelligence 1.1.0 → 1.2.0

package/figma-intelligence-layer/src/shared/types.ts

@@ -1,346 +0,0 @@
-// ─────────────────────────────────────────────────────────────────────────────
-// Shared types used across all 22 tools
-// ─────────────────────────────────────────────────────────────────────────────
-
-export interface FigmaNode {
-  id: string;
-  name: string;
-  type: string;
-  children?: FigmaNode[];
-  fills?: Paint[];
-  strokes?: Paint[];
-  effects?: Effect[];
-  absoluteBoundingBox?: Rect;
-  constraints?: Constraints;
-  layoutMode?: "HORIZONTAL" | "VERTICAL" | "NONE";
-  primaryAxisSizingMode?: "FIXED" | "AUTO";
-  counterAxisSizingMode?: "FIXED" | "AUTO";
-  paddingLeft?: number;
-  paddingRight?: number;
-  paddingTop?: number;
-  paddingBottom?: number;
-  itemSpacing?: number;
-  opacity?: number;
-  componentId?: string;
-  componentProperties?: Record<string, ComponentProperty>;
-  variantProperties?: Record<string, string>;
-  description?: string;
-  characters?: string;
-  style?: TextStyle;
-  width?: number;
-  height?: number;
-}
-
-export interface Paint {
-  type: "SOLID" | "GRADIENT_LINEAR" | "GRADIENT_RADIAL" | "IMAGE" | "VARIABLE_ALIAS";
-  color?: RGBA;
-  opacity?: number;
-  variableId?: string;
-}
-
-export interface RGBA {
-  r: number;
-  g: number;
-  b: number;
-  a: number;
-}
-
-export interface Effect {
-  type: "DROP_SHADOW" | "INNER_SHADOW" | "LAYER_BLUR" | "BACKGROUND_BLUR";
-  color?: RGBA;
-  offset?: Vector;
-  radius?: number;
-  spread?: number;
-  visible?: boolean;
-}
-
-export interface Rect {
-  x: number;
-  y: number;
-  width: number;
-  height: number;
-}
-
-export interface Vector {
-  x: number;
-  y: number;
-}
-
-export interface Constraints {
-  horizontal: "LEFT" | "RIGHT" | "CENTER" | "SCALE" | "STRETCH";
-  vertical: "TOP" | "BOTTOM" | "CENTER" | "SCALE" | "STRETCH";
-}
-
-export interface ComponentProperty {
-  type: "BOOLEAN" | "TEXT" | "INSTANCE_SWAP" | "VARIANT";
-  value: boolean | string;
-  defaultValue?: boolean | string;
-  variantOptions?: string[];
-}
-
-export interface TextStyle {
-  fontFamily: string;
-  fontStyle: string;
-  fontSize: number;
-  fontWeight: number;
-  letterSpacing: number;
-  lineHeightPx: number;
-}
-
-export interface Token {
-  id: string;
-  name: string;
-  type: "COLOR" | "FLOAT" | "STRING" | "BOOLEAN";
-  value: string | number | boolean;
-  collectionId: string;
-  modeValues?: Record<string, string | number | boolean>;
-  description?: string;
-}
-
-export interface ComponentSet {
-  id: string;
-  name: string;
-  description?: string;
-  variantGroupProperties: Record<string, { values: string[] }>;
-  children: FigmaNode[];
-}
-
-export interface FigmaSelectionItem {
-  id: string;
-  name: string;
-  type: string;
-}
-
-export interface FigmaPageSummary {
-  id: string;
-  name: string;
-}
-
-export interface FigmaDocumentChangeSummary {
-  documentChanges: Array<{
-    id?: string;
-    type: string;
-    nodeId?: string;
-    nodeType?: string;
-  }>;
-}
-
-export type FigmaBridgeEventType =
-  | "bridge.ready"
-  | "selectionchange"
-  | "currentpagechange"
-  | "documentchange";
-
-export interface FigmaBridgeEvent<TPayload = unknown> {
-  type: "bridge-event";
-  eventType: FigmaBridgeEventType;
-  payload: TPayload;
-  timestamp: number;
-}
-
-export interface FigmaContextSnapshot {
-  status: "connected" | "disconnected";
-  fileName?: string;
-  currentPage?: FigmaPageSummary;
-  pageCount?: number;
-  selection: FigmaSelectionItem[];
-  lastDocumentChange?: FigmaDocumentChangeSummary;
-  lastUpdatedAt?: number;
-}
-
-export type LayoutNodeType =
-  | "page"
-  | "sidebar"
-  | "header"
-  | "toolbar"
-  | "content"
-  | "footer"
-  | "drawer"
-  | "modal"
-  | "card"
-  | "form"
-  | "form-row"
-  | "nav"
-  | "button-group"
-  | "tab-bar"
-  | "table"
-  | "table-row"
-  | "list"
-  | "list-item"
-  | "section"
-  | "overlay";
-
-export interface LayoutPadding {
-  top: number;
-  right: number;
-  bottom: number;
-  left: number;
-}
-
-export interface LayoutNodeAlignment {
-  direction?: "horizontal" | "vertical" | "none";
-  distribution?: "start" | "center" | "end" | "space-between";
-  crossAlignment?: "start" | "center" | "end" | "stretch";
-  gap?: number;
-  padding?: Partial<LayoutPadding>;
-  columns?: number;
-  stackingOrder?: "normal" | "reverse" | "overlay";
-}
-
-export interface LayoutSiblingHints {
-  alignedLeftWith?: string[];
-  equalSpacingWith?: string[];
-  repeatedChildren?: string[];
-  anchored?: "left" | "right" | "top" | "bottom" | "center";
-  overlay?: boolean;
-}
-
-export interface LayoutRepetition {
-  isRepeated: boolean;
-  pattern?: "row" | "column" | "grid" | "tabs" | "menu" | "list";
-  itemCount?: number;
-  canonicalChildId?: string;
-  repeatedChildIds?: string[];
-  repeatAxis?: "horizontal" | "vertical";
-}
-
-export interface LayoutNode {
-  id: string;
-  label: string;
-  boundingBox: Rect;
-  layoutType: LayoutNodeType;
-  childCount: number;
-  children?: LayoutNode[];
-  layout?: LayoutNodeAlignment;
-  siblingHints?: LayoutSiblingHints;
-  repetition?: LayoutRepetition;
-  zoneImage?: string;
-}
-
-export type LayoutZone = LayoutNode;
-
-export interface ComponentManifest {
-  componentType: string;
-  variants: Record<string, string>;
-  textContent?: string;
-  textContentConfidence?: number;
-  iconPresent: boolean;
-  iconName?: string;
-  iconNameConfidence?: number;
-  iconKind?: "system" | "brand" | "illustration" | "unknown";
-  preferredIconLibrary?: string;
-  openSourceIconName?: string;
-  interactiveElement: boolean;
-  estimatedSpacing: number;
-  estimatedSpacingConfidence?: number;
-  estimatedRadius?: number;
-  estimatedRadiusConfidence?: number;
-  estimatedFontSize?: number;
-  estimatedFontSizeConfidence?: number;
-  fontFamilyGuess?: string;
-  fontFamilyGuessConfidence?: number;
-  fontStyleGuess?: string;
-  fontStyleGuessConfidence?: number;
-  fontWeightGuess?: number;
-  fontWeightGuessConfidence?: number;
-  confidence: number;
-  dsBestMatch?: string;
-  dsNodeId?: string;
-}
-
-export interface VisionResult {
-  layoutTree?: LayoutNode[];
-  zones?: LayoutZone[];
-  manifest?: ComponentManifest;
-  rawAnalysis: string;
-  confidence: number;
-}
-
-export interface TokenRef {
-  tokenName: string;
-  tokenValue: number | string;
-  delta?: number;
-}
-
-export interface WCAGIssue {
-  severity: "error" | "warning" | "suggestion";
-  criterion: string;
-  nodeId: string;
-  nodeName: string;
-  issue: string;
-  currentValue: string;
-  suggestedFix: string;
-  autoFixAvailable: boolean;
-}
-
-export interface LintViolation {
-  ruleId: string;
-  severity: "error" | "warning";
-  nodeId: string;
-  nodeName: string;
-  message: string;
-  autoFixed?: boolean;
-}
-
-export interface LogEntry {
-  id: string;
-  timestamp: string;
-  tool: string;
-  nodeIds: string[];
-  rationale: string;
-  tokens?: string[];
-  reversible?: boolean;
-  metadata?: Record<string, unknown>;
-}
-
-export interface HealthScore {
-  overall: number;
-  tokenCoverage: number;
-  accessibility: number;
-  componentAdoption: number;
-  documentation: number;
-  lintScore: number;
-  driftScore: number;
-}
-
-export interface ExecuteResult {
-  success: boolean;
-  result?: unknown;
-  error?: string;
-  logs?: string[];
-}
-
-export interface DriftReport {
-  canonicalFileKey: string;
-  targetFileKey: string;
-  totalTokens: number;
-  driftingTokens: number;
-  driftScore: number;
-  violations: TokenDrift[];
-}
-
-export interface TokenDrift {
-  tokenName: string;
-  canonicalValue: string;
-  targetValue: string;
-  driftType: "typo" | "override" | "missing" | "extra";
-  severity: "warning" | "critical";
-  instancesAffected: number;
-}
-
-export interface PrototypeTransition {
-  from: string;
-  fromName: string;
-  to: string;
-  toName: string;
-  trigger: {
-    type: string;
-    nodeName?: string;
-  };
-  animation: {
-    type: string;
-    direction?: string;
-    duration: number;
-    easing?: number[];
-  };
-}

package/figma-intelligence-layer/src/shared/typography-presets.ts

@@ -1,94 +0,0 @@
-// ─────────────────────────────────────────────────────────────────────────────
-// Typography Presets
-// Composite presets bundling size + weight + lineHeight + letterSpacing + font
-// role.  Used by component-script-builder and page-architect instead of
-// scattered inline font assignments.
-// ─────────────────────────────────────────────────────────────────────────────
-
-import { FontConfig, FontRole, fontNameLiteral, weightToStyle } from "./font-config.js";
-
-export interface TypographyPreset {
-  name: string;
-  fontRole: FontRole;
-  size: number;
-  weight: string;       // "regular" | "medium" | "semibold" | "bold"
-  lineHeight: number;
-  letterSpacing: number; // em-based (e.g. -0.02)
-}
-
-export const TYPOGRAPHY_PRESETS: TypographyPreset[] = [
-  // Headings
-  { name: "heading/h1", fontRole: "heading", size: 36, weight: "bold",     lineHeight: 40, letterSpacing: -0.02 },
-  { name: "heading/h2", fontRole: "heading", size: 30, weight: "bold",     lineHeight: 36, letterSpacing: -0.02 },
-  { name: "heading/h3", fontRole: "heading", size: 24, weight: "semibold", lineHeight: 32, letterSpacing: -0.01 },
-  { name: "heading/h4", fontRole: "heading", size: 20, weight: "semibold", lineHeight: 28, letterSpacing: -0.01 },
-  { name: "heading/h5", fontRole: "heading", size: 18, weight: "medium",   lineHeight: 28, letterSpacing: 0 },
-
-  // Body
-  { name: "body/lg", fontRole: "body", size: 18, weight: "regular", lineHeight: 28, letterSpacing: 0 },
-  { name: "body/md", fontRole: "body", size: 16, weight: "regular", lineHeight: 24, letterSpacing: 0 },
-  { name: "body/sm", fontRole: "body", size: 14, weight: "regular", lineHeight: 20, letterSpacing: 0 },
-  { name: "body/xs", fontRole: "body", size: 12, weight: "regular", lineHeight: 16, letterSpacing: 0 },
-
-  // Labels (UI)
-  { name: "label/lg", fontRole: "ui", size: 16, weight: "medium", lineHeight: 24, letterSpacing: 0 },
-  { name: "label/md", fontRole: "ui", size: 14, weight: "medium", lineHeight: 20, letterSpacing: 0 },
-  { name: "label/sm", fontRole: "ui", size: 12, weight: "medium", lineHeight: 16, letterSpacing: 0.01 },
-
-  // Code
-  { name: "code/md", fontRole: "mono", size: 14, weight: "regular", lineHeight: 20, letterSpacing: 0 },
-];
-
-/**
- * Look up a preset by name.
- */
-export function getPreset(name: string): TypographyPreset | undefined {
-  return TYPOGRAPHY_PRESETS.find((p) => p.name === name);
-}
-
-/**
- * Generate Figma Plugin API script lines that apply a typography preset to a
- * text node variable.
- *
- * Example output:
- *   node.fontName = { family: "Inter", style: "Bold" };
- *   node.fontSize = 36;
- *   node.lineHeight = { value: 40, unit: "PIXELS" };
- *   node.letterSpacing = { value: -2, unit: "PERCENT" };
- */
-export function applyTextPresetScript(
-  nodeVar: string,
-  presetName: string,
-  fontConfig: FontConfig
-): string {
-  const preset = getPreset(presetName);
-  if (!preset) {
-    // Fallback: body/md
-    return `${nodeVar}.fontSize = 16;`;
-  }
-
-  const style = weightToStyle(preset.weight);
-  const fontLiteral = fontNameLiteral(preset.fontRole, style, fontConfig);
-  const letterSpacingPercent = Math.round(preset.letterSpacing * 100);
-
-  const lines = [
-    `${nodeVar}.fontName = ${fontLiteral};`,
-    `${nodeVar}.fontSize = ${preset.size};`,
-    `${nodeVar}.lineHeight = { value: ${preset.lineHeight}, unit: "PIXELS" };`,
-  ];
-
-  if (letterSpacingPercent !== 0) {
-    lines.push(`${nodeVar}.letterSpacing = { value: ${letterSpacingPercent}, unit: "PERCENT" };`);
-  }
-
-  return lines.join("\n    ");
-}
-
-/**
- * Return the Figma fontName literal for a preset (for use in generated scripts).
- */
-export function presetFontLiteral(presetName: string, fontConfig: FontConfig): string {
-  const preset = getPreset(presetName);
-  if (!preset) return fontNameLiteral("body", "Regular", fontConfig);
-  return fontNameLiteral(preset.fontRole, weightToStyle(preset.weight), fontConfig);
-}

package/figma-intelligence-layer/src/shared/unsplash.ts

@@ -1,165 +0,0 @@
-const UNSPLASH_API_BASE = "https://api.unsplash.com";
-
-export type UnsplashOrientation = "landscape" | "portrait" | "squarish";
-export type UnsplashContentFilter = "low" | "high";
-
-export interface SearchUnsplashPhotosArgs {
-  query: string;
-  page?: number;
-  perPage?: number;
-  orientation?: UnsplashOrientation;
-  contentFilter?: UnsplashContentFilter;
-  color?: string;
-}
-
-export interface UnsplashPhotoResult {
-  id: string;
-  slug: string;
-  description: string | null;
-  altDescription: string | null;
-  width: number;
-  height: number;
-  color: string | null;
-  blurHash: string | null;
-  photographer: {
-    name: string;
-    username: string;
-    profileUrl: string;
-  };
-  urls: {
-    raw: string;
-    full: string;
-    regular: string;
-    small: string;
-    thumb: string;
-  };
-  links: {
-    html: string;
-    downloadLocation: string;
-  };
-}
-
-interface UnsplashSearchResponse {
-  total: number;
-  total_pages: number;
-  results: Array<Record<string, unknown>>;
-}
-
-function getUnsplashAccessKey(): string {
-  const key = process.env.UNSPLASH_ACCESS_KEY?.trim();
-  if (!key) {
-    throw new Error(
-      "UNSPLASH_ACCESS_KEY is not set. Add an Unsplash API access key to enable photo search."
-    );
-  }
-  return key;
-}
-
-async function unsplashGet<T>(path: string, params: Record<string, string>): Promise<T> {
-  const accessKey = getUnsplashAccessKey();
-  const url = new URL(path, UNSPLASH_API_BASE);
-
-  for (const [key, value] of Object.entries(params)) {
-    if (value) url.searchParams.set(key, value);
-  }
-
-  const response = await fetch(url.toString(), {
-    headers: {
-      Authorization: `Client-ID ${accessKey}`,
-      "Accept-Version": "v1",
-    },
-  });
-
-  if (!response.ok) {
-    const errorText = await response.text().catch(() => "");
-    throw new Error(`Unsplash API error ${response.status}: ${errorText || response.statusText}`);
-  }
-
-  return response.json() as Promise<T>;
-}
-
-function normalizePhoto(photo: Record<string, unknown>): UnsplashPhotoResult {
-  const urls = (photo.urls as Record<string, unknown>) ?? {};
-  const user = (photo.user as Record<string, unknown>) ?? {};
-  const links = (photo.links as Record<string, unknown>) ?? {};
-  const userLinks = (user.links as Record<string, unknown>) ?? {};
-
-  return {
-    id: String(photo.id ?? ""),
-    slug: String(photo.slug ?? ""),
-    description: typeof photo.description === "string" ? photo.description : null,
-    altDescription: typeof photo.alt_description === "string" ? photo.alt_description : null,
-    width: Number(photo.width ?? 0),
-    height: Number(photo.height ?? 0),
-    color: typeof photo.color === "string" ? photo.color : null,
-    blurHash: typeof photo.blur_hash === "string" ? photo.blur_hash : null,
-    photographer: {
-      name: String(user.name ?? "Unknown"),
-      username: String(user.username ?? "unknown"),
-      profileUrl: String(userLinks.html ?? ""),
-    },
-    urls: {
-      raw: String(urls.raw ?? ""),
-      full: String(urls.full ?? ""),
-      regular: String(urls.regular ?? ""),
-      small: String(urls.small ?? ""),
-      thumb: String(urls.thumb ?? ""),
-    },
-    links: {
-      html: String(links.html ?? ""),
-      downloadLocation: String(links.download_location ?? ""),
-    },
-  };
-}
-
-export async function searchUnsplashPhotos(
-  args: SearchUnsplashPhotosArgs
-): Promise<{ total: number; totalPages: number; results: UnsplashPhotoResult[] }> {
-  const {
-    query,
-    page = 1,
-    perPage = 4,
-    orientation,
-    contentFilter = "high",
-    color,
-  } = args;
-
-  if (!query || query.trim().length === 0) {
-    throw new Error("Unsplash search requires a non-empty query.");
-  }
-
-  const response = await unsplashGet<UnsplashSearchResponse>("/search/photos", {
-    query: query.trim(),
-    page: String(page),
-    per_page: String(Math.min(Math.max(perPage, 1), 10)),
-    content_filter: contentFilter,
-    orientation: orientation ?? "",
-    color: color ?? "",
-  });
-
-  return {
-    total: response.total ?? 0,
-    totalPages: response.total_pages ?? 0,
-    results: Array.isArray(response.results) ? response.results.map(normalizePhoto) : [],
-  };
-}
-
-export async function trackUnsplashDownload(downloadLocation: string): Promise<void> {
-  if (!downloadLocation) return;
-  await unsplashGet(downloadLocation.replace(UNSPLASH_API_BASE, ""), {});
-}
-
-export async function fetchRemoteImageAsDataUri(imageUrl: string): Promise<string> {
-  if (!imageUrl) {
-    throw new Error("Image URL is required to fetch remote image data.");
-  }
-
-  const response = await fetch(imageUrl);
-  if (!response.ok) {
-    throw new Error(`Image fetch failed ${response.status}: ${response.statusText}`);
-  }
-
-  const contentType = response.headers.get("content-type") || "image/jpeg";
-  const buffer = Buffer.from(await response.arrayBuffer());
-  return `data:${contentType};base64,${buffer.toString("base64")}`;
-}