@topogram/cli 0.3.34

package/src/import/extractors/ui/sveltekit.js

@@ -0,0 +1,123 @@
+import {
+  dedupeCandidateRecords,
+  detectUiPresentationFeatures,
+  entityIdForRoute,
+  inferNavigationStructure,
+  inferSvelteRoutes,
+  makeCandidateRecord,
+  navigationPatternsFromStructure,
+  relativeTo,
+  shellKindFromNavigation,
+  screenIdForRoute,
+  screenKindForRoute,
+  uiCapabilityHintsForRoute,
+  titleCase
+} from "../../core/shared.js";
+import path from "node:path";
+
+export const svelteKitUiExtractor = {
+  id: "ui.sveltekit",
+  track: "ui",
+  detect(context) {
+    const roots = [
+      path.join(context.paths.workspaceRoot, "apps", "web-sveltekit"),
+      path.join(context.paths.workspaceRoot, "apps", "local-stack", "web")
+    ];
+    const count = roots.reduce((total, rootDir) => total + inferSvelteRoutes(rootDir, context.helpers).length, 0);
+    return { score: count > 0 ? 65 : 0, reasons: count > 0 ? ["Found SvelteKit routes"] : [] };
+  },
+  extract(context) {
+    const findings = [];
+    const candidates = { screens: [], routes: [], actions: [], stacks: [] };
+    const roots = [
+      path.join(context.paths.workspaceRoot, "apps", "web-sveltekit"),
+      path.join(context.paths.workspaceRoot, "apps", "local-stack", "web")
+    ];
+    for (const rootDir of roots) {
+      const routes = inferSvelteRoutes(rootDir, context.helpers);
+      if (routes.length === 0) continue;
+      const provenance = relativeTo(context.paths.repoRoot, path.join(rootDir, "src", "routes"));
+      const navigation = inferNavigationStructure(rootDir, { filePatterns: [/(^|\/)\+layout\.svelte$/i] });
+      const features = detectUiPresentationFeatures(rootDir);
+      const shellKind = shellKindFromNavigation(navigation);
+      const navigationPatterns = navigationPatternsFromStructure(navigation);
+      findings.push({ kind: "sveltekit_ui_routes", file: provenance, routes });
+      findings.push({ kind: "sveltekit_ui_navigation", file: provenance, navigation });
+      findings.push({ kind: "sveltekit_ui_features", file: provenance, features });
+      candidates.stacks.push("sveltekit_web");
+      if (shellKind) {
+        candidates.actions.push(makeCandidateRecord({
+          kind: "ui_shell",
+          idHint: `${path.basename(rootDir)}_shell`,
+          label: titleCase(shellKind),
+          confidence: "medium",
+          sourceKind: "layout_code",
+          provenance,
+          track: "ui",
+          shell_kind: shellKind,
+          has_breadcrumbs: navigation.hasBreadcrumbs,
+          has_tabs: navigation.hasTabs
+        }));
+      }
+      for (const pattern of navigationPatterns) {
+        candidates.actions.push(makeCandidateRecord({
+          kind: "ui_navigation",
+          idHint: `${path.basename(rootDir)}_${pattern}`,
+          label: pattern,
+          confidence: "medium",
+          sourceKind: "layout_code",
+          provenance,
+          track: "ui",
+          navigation_pattern: pattern
+        }));
+      }
+      for (const routePath of routes) {
+        const screenId = screenIdForRoute(routePath);
+        const screenKind = screenKindForRoute(routePath);
+        const capabilityHints = uiCapabilityHintsForRoute(routePath);
+        candidates.screens.push(makeCandidateRecord({
+          kind: "screen",
+          idHint: screenId,
+          label: titleCase(screenId),
+          confidence: "medium",
+          sourceKind: "route_code",
+          provenance: `${provenance}#${routePath}`,
+          track: "ui",
+          entity_id: entityIdForRoute(routePath),
+          screen_kind: screenKind,
+          route_path: routePath,
+          capability_hints: capabilityHints
+        }));
+        candidates.routes.push(makeCandidateRecord({
+          kind: "ui_route",
+          idHint: `${screenId}_route`,
+          label: routePath,
+          confidence: "medium",
+          sourceKind: "route_code",
+          provenance: `${provenance}#${routePath}`,
+          track: "ui",
+          screen_id: screenId,
+          entity_id: entityIdForRoute(routePath),
+          path: routePath
+        }));
+      }
+      for (const feature of features) {
+        candidates.actions.push(makeCandidateRecord({
+          kind: "ui_presentation",
+          idHint: `${path.basename(rootDir)}_${feature}`,
+          label: feature,
+          confidence: "low",
+          sourceKind: "layout_code",
+          provenance,
+          track: "ui",
+          presentation: feature
+        }));
+      }
+    }
+    candidates.screens = dedupeCandidateRecords(candidates.screens, (record) => record.id_hint);
+    candidates.routes = dedupeCandidateRecords(candidates.routes, (record) => record.id_hint);
+    candidates.actions = dedupeCandidateRecords(candidates.actions, (record) => record.id_hint);
+    candidates.stacks = [...new Set(candidates.stacks)].sort();
+    return { findings, candidates };
+  }
+};

package/src/import/extractors/ui/swiftui.js

@@ -0,0 +1,193 @@
+import {
+  canonicalCandidateTerm,
+  dedupeCandidateRecords,
+  findImportFiles,
+  idHintify,
+  makeCandidateRecord,
+  relativeTo,
+  titleCase
+} from "../../core/shared.js";
+
+function inferScreenId(viewName) {
+  if (/CountriesList/i.test(viewName)) return "country_list";
+  if (/CountryDetails/i.test(viewName)) return "country_detail";
+  if (/ModalFlag/i.test(viewName)) return "country_flag_modal";
+  return idHintify(canonicalCandidateTerm(viewName.replace(/View$/, "").replace(/([a-z0-9])([A-Z])/g, "$1_$2")));
+}
+
+function inferRoutePath(screenId) {
+  if (screenId === "country_list") return "/countries";
+  if (screenId === "country_detail") return "/countries/:alpha3Code";
+  if (screenId === "country_flag_modal") return "/countries/:alpha3Code/flag";
+  return `/${screenId.replace(/_/g, "-")}`;
+}
+
+function entityIdForScreen(screenId) {
+  if (/country/.test(screenId)) return screenId === "country_detail" || screenId === "country_list" || screenId === "country_flag_modal" ? "entity_country" : "entity_country";
+  return null;
+}
+
+function parseSwiftUIView(filePath, text, repoRoot) {
+  const views = [];
+  for (const match of String(text || "").matchAll(/struct\s+([A-Za-z_][A-Za-z0-9_]*)\s*:\s*View\s*\{/g)) {
+    const viewName = match[1];
+    if (/^(ErrorView|ImageView|CountryCell|DetailRow)$/.test(viewName)) continue;
+    const screenId = inferScreenId(viewName);
+    const routePath = inferRoutePath(screenId);
+    const entityId = entityIdForScreen(screenId);
+    const provenance = `${relativeTo(repoRoot, filePath)}#${viewName}`;
+    const capabilityHints = [];
+    if (/loadCountriesList|refreshCountriesList/.test(text)) capabilityHints.push("cap_list_countries");
+    if (/loadCountryDetails/.test(text)) capabilityHints.push("cap_get_country_details");
+    views.push({
+      screen: makeCandidateRecord({
+        kind: "screen",
+        idHint: screenId,
+        label: titleCase(screenId),
+        confidence: "high",
+        sourceKind: "route_code",
+        provenance,
+        track: "ui",
+        entity_id: entityId,
+        concept_id: entityId || `surface_${screenId}`,
+        screen_kind: /detail/.test(screenId) ? "detail" : /modal/.test(screenId) ? "flow" : "list",
+        route_path: routePath,
+        capability_hints: capabilityHints
+      }),
+      route: makeCandidateRecord({
+        kind: "ui_route",
+        idHint: `${screenId}_route`,
+        label: routePath,
+        confidence: "high",
+        sourceKind: "route_code",
+        provenance,
+        track: "ui",
+        screen_id: screenId,
+        entity_id: entityId,
+        concept_id: entityId || `surface_${screenId}`,
+        path: routePath
+      }),
+      actions: capabilityHints.map((capabilityHint) => makeCandidateRecord({
+        kind: "ui_action",
+        idHint: `${screenId}_${idHintify(capabilityHint)}`,
+        label: capabilityHint,
+        confidence: "medium",
+        sourceKind: "route_code",
+        provenance,
+        track: "ui",
+        screen_id: screenId,
+        entity_id: entityId,
+        concept_id: entityId || `surface_${screenId}`,
+        capability_hint: capabilityHint,
+        prominence: "primary"
+      }))
+    });
+  }
+  return views;
+}
+
+function swiftUiNavigationSummary(text) {
+  const source = String(text || "");
+  return {
+    shellKind:
+      /\bNavigationSplitView\b/.test(source) ? "split_view"
+      : /\bTabView\b/.test(source) ? "bottom_tabs"
+      : /\bNavigationStack\b|\bNavigationView\b/.test(source) ? "topbar"
+      : null,
+    patterns: [
+      ...new Set([
+        /\bNavigationStack\b|\bNavigationView\b/.test(source) ? "stack_navigation" : null,
+        /\bTabView\b/.test(source) ? "bottom_tabs" : null,
+        /\bNavigationSplitView\b/.test(source) ? "split_view" : null,
+        /\bPicker\b|\bSegmentedPickerStyle\b/.test(source) ? "segmented_control" : null
+      ].filter(Boolean))
+    ],
+    features: [
+      ...new Set([
+        /\.sheet\s*\(/.test(source) ? "sheet" : null,
+        /\.popover\s*\(/.test(source) ? "popover" : null,
+        /\.refreshable\s*\{/.test(source) ? "pull_to_refresh" : null,
+        /\.searchable\s*\(/.test(source) ? "search" : null
+      ].filter(Boolean))
+    ]
+  };
+}
+
+export const swiftUiExtractor = {
+  id: "ui.swiftui",
+  track: "ui",
+  detect(context) {
+    const files = findImportFiles(context.paths, (filePath) => /\.swift$/i.test(filePath))
+      .filter((filePath) => /:\s*View\b/.test(context.helpers.readTextIfExists(filePath) || ""));
+    return {
+      score: files.length > 0 ? 84 : 0,
+      reasons: files.length > 0 ? ["Found SwiftUI views"] : []
+    };
+  },
+  extract(context) {
+    const files = findImportFiles(context.paths, (filePath) => /\.swift$/i.test(filePath))
+      .filter((filePath) => /:\s*View\b/.test(context.helpers.readTextIfExists(filePath) || ""));
+    const findings = [];
+    const candidates = { screens: [], routes: [], actions: [], stacks: [] };
+    for (const filePath of files) {
+      const text = context.helpers.readTextIfExists(filePath) || "";
+      const parsed = parseSwiftUIView(filePath, text, context.paths.repoRoot);
+      if (parsed.length === 0) continue;
+      const summary = swiftUiNavigationSummary(text);
+      findings.push({
+        kind: "swiftui_views",
+        file: relativeTo(context.paths.repoRoot, filePath),
+        screen_count: parsed.length
+      });
+      if (summary.shellKind) {
+        candidates.actions.push(makeCandidateRecord({
+          kind: "ui_shell",
+          idHint: `${idHintify(summary.shellKind)}_shell`,
+          label: titleCase(summary.shellKind),
+          confidence: "medium",
+          sourceKind: "layout_code",
+          provenance: relativeTo(context.paths.repoRoot, filePath),
+          track: "ui",
+          shell_kind: summary.shellKind
+        }));
+      }
+      for (const pattern of summary.patterns) {
+        candidates.actions.push(makeCandidateRecord({
+          kind: "ui_navigation",
+          idHint: `swiftui_${idHintify(pattern)}`,
+          label: pattern,
+          confidence: "medium",
+          sourceKind: "layout_code",
+          provenance: relativeTo(context.paths.repoRoot, filePath),
+          track: "ui",
+          navigation_pattern: pattern
+        }));
+      }
+      for (const feature of summary.features) {
+        candidates.actions.push(makeCandidateRecord({
+          kind: "ui_presentation",
+          idHint: `swiftui_${idHintify(feature)}`,
+          label: feature,
+          confidence: "low",
+          sourceKind: "layout_code",
+          provenance: relativeTo(context.paths.repoRoot, filePath),
+          track: "ui",
+          presentation: feature
+        }));
+      }
+      for (const entry of parsed) {
+        candidates.screens.push(entry.screen);
+        candidates.routes.push(entry.route);
+        candidates.actions.push(...entry.actions);
+      }
+    }
+    if (candidates.screens.length > 0) {
+      candidates.stacks.push("swiftui");
+    }
+    candidates.screens = dedupeCandidateRecords(candidates.screens, (record) => record.id_hint);
+    candidates.routes = dedupeCandidateRecords(candidates.routes, (record) => record.id_hint);
+    candidates.actions = dedupeCandidateRecords(candidates.actions, (record) => record.id_hint);
+    candidates.stacks = [...new Set(candidates.stacks)].sort();
+    return { findings, candidates };
+  }
+};

package/src/import/extractors/ui/uikit.js

@@ -0,0 +1,175 @@
+import {
+  canonicalCandidateTerm,
+  dedupeCandidateRecords,
+  findImportFiles,
+  idHintify,
+  makeCandidateRecord,
+  relativeTo,
+  titleCase
+} from "../../core/shared.js";
+
+function screenIdFromController(className) {
+  return idHintify(
+    canonicalCandidateTerm(
+      className
+        .replace(/(Table|Collection)?ViewController$/, "")
+        .replace(/ViewController$/, "")
+        .replace(/([a-z0-9])([A-Z])/g, "$1_$2")
+    )
+  );
+}
+
+function screenKindFromClass(className, screenId) {
+  if (/TableViewController$/.test(className) || /CollectionViewController$/.test(className)) return "list";
+  if (/Settings|Onboarding|Theme|Search/i.test(className) || /settings|onboarding|theme|search/.test(screenId)) return "settings";
+  if (/Browser|Home/i.test(className) || /browser|home/.test(screenId)) return "flow";
+  if (/About|Tip|TrackingProtection|SiriFavorite/i.test(className)) return "detail";
+  return "flow";
+}
+
+function conceptIdFromScreen(screenId) {
+  if (/browser|home/.test(screenId)) return "surface_browser";
+  if (/^setting$|settings|theme|about|search|tracking_protection|autocomplete|safari_instruction|siri_favorite|add_custom_domain|add_search_engine/.test(screenId)) {
+    return "surface_settings";
+  }
+  if (/onboarding|default_browser|show_me_how|get_started|tooltip|terms_of_service|privacy_policy/.test(screenId)) return "surface_onboarding";
+  return `surface_${screenId}`;
+}
+
+function routePathFromScreen(screenId) {
+  if (screenId === "browser") return "/browser";
+  if (screenId === "home") return "/";
+  return `/${screenId.replace(/_/g, "-")}`;
+}
+
+function navigationActions(text) {
+  const actions = [];
+  for (const match of String(text || "").matchAll(/pushViewController\(\s*([A-Z][A-Za-z0-9_]*)\(/g)) {
+    actions.push({ kind: "push", targetClass: match[1] });
+  }
+  for (const match of String(text || "").matchAll(/present\(\s*([A-Z][A-Za-z0-9_]*)\(/g)) {
+    actions.push({ kind: "present", targetClass: match[1] });
+  }
+  for (const match of String(text || "").matchAll(/show\(\s*([A-Z][A-Za-z0-9_]*)\(/g)) {
+    actions.push({ kind: "show", targetClass: match[1] });
+  }
+  return actions;
+}
+
+function shouldIgnoreFile(filePath) {
+  return /Tests\/|Preview Files\/|UIHelpers\/|Extensions\/|Widgets\/|InternalSettings\/.*View\.swift$/.test(filePath);
+}
+
+export const uiKitExtractor = {
+  id: "ui.uikit",
+  track: "ui",
+  detect(context) {
+    const controllerFiles = findImportFiles(context.paths, (filePath) => /\.swift$/i.test(filePath))
+      .filter((filePath) => !shouldIgnoreFile(filePath))
+      .filter((filePath) => /(UIViewController|UITableViewController|UICollectionViewController)/.test(context.helpers.readTextIfExists(filePath) || ""));
+    return {
+      score: controllerFiles.length > 0 ? 87 : 0,
+      reasons: controllerFiles.length > 0 ? ["Found UIKit view controllers"] : []
+    };
+  },
+  extract(context) {
+    const controllerFiles = findImportFiles(context.paths, (filePath) => /\.swift$/i.test(filePath))
+      .filter((filePath) => !shouldIgnoreFile(filePath))
+      .filter((filePath) => /(UIViewController|UITableViewController|UICollectionViewController)/.test(context.helpers.readTextIfExists(filePath) || ""));
+    const findings = [];
+    const candidates = { screens: [], routes: [], actions: [], stacks: [] };
+    const classIndex = new Map();
+
+    for (const filePath of controllerFiles) {
+      const text = context.helpers.readTextIfExists(filePath) || "";
+      for (const match of text.matchAll(/(?:final\s+)?class\s+([A-Z][A-Za-z0-9_]*)\s*:\s*([A-Za-z0-9_, ]*(?:UIViewController|UITableViewController|UICollectionViewController)[A-Za-z0-9_, ]*)/g)) {
+        classIndex.set(match[1], { filePath, text, base: match[2] });
+      }
+    }
+
+    for (const [className, entry] of classIndex.entries()) {
+      const screenId = screenIdFromController(className);
+      const routePath = routePathFromScreen(screenId);
+      const conceptId = conceptIdFromScreen(screenId);
+      const provenance = `${relativeTo(context.paths.repoRoot, entry.filePath)}#${className}`;
+      candidates.screens.push(makeCandidateRecord({
+        kind: "screen",
+        idHint: screenId,
+        label: titleCase(screenId),
+        confidence: "high",
+        sourceKind: "route_code",
+        provenance,
+        track: "ui",
+        entity_id: null,
+        concept_id: conceptId,
+        screen_kind: screenKindFromClass(className, screenId),
+        route_path: routePath
+      }));
+      candidates.routes.push(makeCandidateRecord({
+        kind: "ui_route",
+        idHint: `${screenId}_route`,
+        label: routePath,
+        confidence: "high",
+        sourceKind: "route_code",
+        provenance,
+        track: "ui",
+        screen_id: screenId,
+        entity_id: null,
+        concept_id: conceptId,
+        path: routePath
+      }));
+      for (const action of navigationActions(entry.text)) {
+        const targetScreenId = screenIdFromController(action.targetClass);
+        candidates.actions.push(makeCandidateRecord({
+          kind: "ui_action",
+          idHint: `${screenId}_${action.kind}_${targetScreenId}`,
+          label: `${action.kind} ${targetScreenId}`,
+          confidence: "medium",
+          sourceKind: "route_code",
+          provenance,
+          track: "ui",
+          screen_id: screenId,
+          entity_id: null,
+          concept_id: conceptId,
+          capability_hint: null,
+          prominence: "primary"
+        }));
+      }
+      findings.push({
+        kind: "uikit_controller",
+        file: relativeTo(context.paths.repoRoot, entry.filePath),
+        screen_id: screenId
+      });
+    }
+
+    if (candidates.screens.length > 0) {
+      candidates.actions.push(makeCandidateRecord({
+        kind: "ui_navigation",
+        idHint: "uikit_stack_navigation",
+        label: "stack_navigation",
+        confidence: "medium",
+        sourceKind: "layout_code",
+        provenance: controllerFiles.map((filePath) => relativeTo(context.paths.repoRoot, filePath)),
+        track: "ui",
+        navigation_pattern: "stack_navigation"
+      }));
+      candidates.actions.push(makeCandidateRecord({
+        kind: "ui_shell",
+        idHint: "uikit_navigation_shell",
+        label: "Navigation",
+        confidence: "medium",
+        sourceKind: "layout_code",
+        provenance: controllerFiles.map((filePath) => relativeTo(context.paths.repoRoot, filePath)),
+        track: "ui",
+        shell_kind: "topbar"
+      }));
+      candidates.stacks.push("uikit");
+    }
+
+    candidates.screens = dedupeCandidateRecords(candidates.screens, (record) => record.id_hint);
+    candidates.routes = dedupeCandidateRecords(candidates.routes, (record) => record.id_hint);
+    candidates.actions = dedupeCandidateRecords(candidates.actions, (record) => record.id_hint);
+    candidates.stacks = [...new Set(candidates.stacks)].sort();
+    return { findings, candidates };
+  }
+};