@screenbook/core 1.2.0 → 1.6.0

package/dist/index.cjs

@@ -139,7 +139,13 @@ const screenSchema = zod.z.object({
 	description: zod.z.string().optional(),
 	links: zod.z.array(zod.z.object({
 		label: zod.z.string(),
-		url: zod.z.string().url()
+		url: zod.z.string().url(),
+		type: zod.z.enum([
+			"figma",
+			"storybook",
+			"docs",
+			"other"
+		]).optional()
 	})).optional(),
 	mock: screenMockSchema.optional()
 });
@@ -153,6 +159,20 @@ const adoptionSchema = zod.z.object({
 	minimumCoverage: zod.z.number().min(0).max(100).optional()
 });
 /**
+* Schema for OpenAPI configuration (runtime validation)
+* @internal
+*/
+const openApiConfigSchema = zod.z.object({ sources: zod.z.array(zod.z.string()).min(1) });
+/**
+* Schema for API integration configuration (runtime validation)
+* @internal
+*/
+const apiIntegrationSchema = zod.z.object({
+	clientPackages: zod.z.array(zod.z.string()).optional(),
+	extractApiName: zod.z.any().optional(),
+	openapi: openApiConfigSchema.optional()
+});
+/**
 * Schema for Screenbook configuration (runtime validation)
 * @internal
 */
@@ -162,7 +182,8 @@ const configSchema = zod.z.object({
 	routesPattern: zod.z.string().optional(),
 	routesFile: zod.z.string().optional(),
 	ignore: zod.z.array(zod.z.string()).default(["**/node_modules/**", "**/.git/**"]),
-	adoption: adoptionSchema.optional()
+	adoption: adoptionSchema.optional(),
+	apiIntegration: apiIntegrationSchema.optional()
 }).refine((data) => !(data.routesPattern && data.routesFile), {
 	message: "Cannot specify both 'routesPattern' and 'routesFile'. Use one or the other.",
 	path: ["routesFile"]
@@ -227,9 +248,11 @@ function defineConfig(input = {}) {
 
 //#endregion
 exports.adoptionSchema = adoptionSchema;
+exports.apiIntegrationSchema = apiIntegrationSchema;
 exports.configSchema = configSchema;
 exports.defineConfig = defineConfig;
 exports.defineScreen = defineScreen;
 exports.extractNavigationTargets = extractNavigationTargets;
+exports.openApiConfigSchema = openApiConfigSchema;
 exports.screenMockSchema = screenMockSchema;
 exports.screenSchema = screenSchema;

package/dist/index.d.cts

@@ -2,6 +2,10 @@ import { z } from "zod";
 
 //#region src/types.d.ts
 
+/**
+ * Type of external link for icon display
+ */
+type ScreenLinkType = "figma" | "storybook" | "docs" | "other";
 /**
  * External link to related resources
  */
@@ -18,6 +22,13 @@ interface ScreenLink {
    * @example "https://storybook.example.com/?path=/story/billing-invoice"
    */
   url: string;
+  /**
+   * Type of link for icon display
+   * If not specified, the type is inferred from the URL
+   * @example "figma"
+   * @example "storybook"
+   */
+  type?: ScreenLinkType;
 }
 /**
  * Screen metadata definition for the screen catalog.
@@ -248,6 +259,12 @@ declare const screenSchema: z.ZodObject<{
   links: z.ZodOptional<z.ZodArray<z.ZodObject<{
     label: z.ZodString;
     url: z.ZodString;
+    type: z.ZodOptional<z.ZodEnum<{
+      figma: "figma";
+      storybook: "storybook";
+      docs: "docs";
+      other: "other";
+    }>>;
   }, z.core.$strip>>>;
   mock: z.ZodOptional<z.ZodObject<{
     sections: z.ZodArray<z.ZodType<MockSection, unknown, z.core.$ZodTypeInternals<MockSection, unknown>>>;
@@ -300,6 +317,78 @@ declare const adoptionSchema: z.ZodObject<{
   includePatterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
   minimumCoverage: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
+/**
+ * API integration configuration for auto-detecting dependencies from
+ * OpenAPI-generated clients (Orval, openapi-typescript, etc.).
+ *
+ * @example
+ * ```ts
+ * const apiIntegration: ApiIntegrationConfig = {
+ *   clientPackages: ["@/api/generated", "@company/backend-client"],
+ *   extractApiName: (name) => name.replace(/^use/, ""),
+ * }
+ * ```
+ */
+/**
+ * OpenAPI specification configuration for validating dependsOn references.
+ *
+ * @example
+ * ```ts
+ * const openapi: OpenApiConfig = {
+ *   sources: ["./openapi.yaml", "https://api.example.com/openapi.json"],
+ * }
+ * ```
+ */
+interface OpenApiConfig {
+  /**
+   * OpenAPI specification sources (local files or remote URLs).
+   * Supports OpenAPI 2.0 (Swagger) and 3.x specifications.
+   * @example ["./openapi.yaml"]
+   * @example ["./openapi.yaml", "https://api.example.com/openapi.json"]
+   */
+  sources: string[];
+}
+interface ApiIntegrationConfig {
+  /**
+   * Package names to scan for API client imports.
+   * These should match the import paths used in your code.
+   * @example ["@/api/generated"]
+   * @example ["@company/backend-client", "@company/auth-client"]
+   */
+  clientPackages?: string[];
+  /**
+   * Optional transform function to convert import name to dependsOn format.
+   * If not provided, the import name is used as-is.
+   * @example (name) => name.replace(/^use/, "")
+   * @example (name) => `API.${name}`
+   */
+  extractApiName?: (importName: string) => string;
+  /**
+   * OpenAPI specification configuration for validating dependsOn references.
+   * When configured, `screenbook lint` will validate that dependsOn values
+   * match operationIds or HTTP method + path from the OpenAPI spec.
+   * @example { sources: ["./openapi.yaml"] }
+   */
+  openapi?: OpenApiConfig;
+}
+/**
+ * Schema for OpenAPI configuration (runtime validation)
+ * @internal
+ */
+declare const openApiConfigSchema: z.ZodObject<{
+  sources: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Schema for API integration configuration (runtime validation)
+ * @internal
+ */
+declare const apiIntegrationSchema: z.ZodObject<{
+  clientPackages: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  extractApiName: z.ZodOptional<z.ZodAny>;
+  openapi: z.ZodOptional<z.ZodObject<{
+    sources: z.ZodArray<z.ZodString>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
 /**
  * Screenbook configuration options.
  */
@@ -346,6 +435,12 @@ interface Config {
    * @example { mode: "progressive", includePatterns: ["src/pages/billing/**"], minimumCoverage: 80 }
    */
   adoption?: AdoptionConfig;
+  /**
+   * API integration configuration for auto-detecting dependencies
+   * from OpenAPI-generated clients (Orval, openapi-typescript, etc.)
+   * @example { clientPackages: ["@/api/generated"] }
+   */
+  apiIntegration?: ApiIntegrationConfig;
 }
 /**
  * Input type for defineConfig function.
@@ -395,6 +490,11 @@ interface ConfigInput {
    * Progressive adoption configuration
    */
   adoption?: AdoptionConfig;
+  /**
+   * API integration configuration for auto-detecting dependencies
+   * from OpenAPI-generated clients
+   */
+  apiIntegration?: ApiIntegrationConfig;
 }
 /**
  * Schema for Screenbook configuration (runtime validation)
@@ -414,6 +514,13 @@ declare const configSchema: z.ZodObject<{
     includePatterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
     minimumCoverage: z.ZodOptional<z.ZodNumber>;
   }, z.core.$strip>>;
+  apiIntegration: z.ZodOptional<z.ZodObject<{
+    clientPackages: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    extractApiName: z.ZodOptional<z.ZodAny>;
+    openapi: z.ZodOptional<z.ZodObject<{
+      sources: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>;
 }, z.core.$strip>;
 //#endregion
 //#region src/defineScreen.d.ts
@@ -487,5 +594,5 @@ declare function defineConfig(input?: ConfigInput): Config;
  */
 declare function extractNavigationTargets(mock: ScreenMock): string[];
 //#endregion
-export { type AdoptionConfig, type Config, type ConfigInput, type MockButtonElement, type MockElement, type MockElementType, type MockImageElement, type MockInputElement, type MockLayout, type MockLinkElement, type MockListElement, type MockSection, type MockTableElement, type MockTextElement, type Screen, type ScreenInput, type ScreenLink, type ScreenMock, adoptionSchema, configSchema, defineConfig, defineScreen, extractNavigationTargets, screenMockSchema, screenSchema };
+export { type AdoptionConfig, type ApiIntegrationConfig, type Config, type ConfigInput, type MockButtonElement, type MockElement, type MockElementType, type MockImageElement, type MockInputElement, type MockLayout, type MockLinkElement, type MockListElement, type MockSection, type MockTableElement, type MockTextElement, type OpenApiConfig, type Screen, type ScreenInput, type ScreenLink, type ScreenLinkType, type ScreenMock, adoptionSchema, apiIntegrationSchema, configSchema, defineConfig, defineScreen, extractNavigationTargets, openApiConfigSchema, screenMockSchema, screenSchema };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/types.ts","../src/defineScreen.ts","../src/extractNavigationTargets.ts"],"sourcesContent":[],"mappings":";;;;;;AAKA;AA+BiB,UA/BA,UAAA,CA6GR;EAiBG;AAKZ;AAOU;AAeV;AAWA;EAWiB,KAAA,EAAA,MAAA;EASA;AASjB;AASA;AAWA;AAaA;EACG,GAAA,EAAA,MAAA;;;;;;;;AAWH;;;;;AAcA;AAiFA;;;;UA9SiB,MAAA;;;;;AAwTjB;AAMA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAyB,WAAA,CAAA,EAAA,MAAA,EAAA;EAkCR;AA8BjB;;;;;;;;;;;EASiB,WAAM,CAAA,EAAA,OA+CX;EAeK;AA+CjB;;;;;;;;UAtaS;;;;;;SAOD;;;;;KAUI,UAAA;;;;AAqZa,KAhZb,eAAA,GAgZa,QAAA,GAAA,OAAA,GAAA,MAAA,GAAA,MAAA,GAAA,OAAA,GAAA,MAAA,GAAA,OAAA;;;;UApYf,eAAA;EC9GM;EA6BA,IAAA,EDmFT,eCnFqB;;;;ACzC5B;;;UFoIiB,iBAAA,SAA0B;;;;;;;;;;UAW1B,gBAAA,SAAyB;;;;;;;;;;UAWzB,eAAA,SAAwB;;;;;;;;UASxB,eAAA,SAAwB;;;;;;;;UASxB,gBAAA,SAAyB;;;;;;;;UASzB,eAAA,SAAwB;;;;;;;;;;UAWxB,gBAAA,SAAyB;;;;;;;;;;;;KAa9B,WAAA,GACT,oBACA,mBACA,kBACA,kBACA,mBACA,kBACA;;;;UAKc,WAAA;;;;WAIP;;YAEC;;aAEC;;;;;UAMK,UAAA;;YAEN;;;;;;cA+EE,kBAAgB,CAAA,CAAA;;;;;;;KAUjB,WAAA,GAAc;;;;;cAMb,cAAY,CAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAkCR,cAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;cA8BJ,gBAAc,CAAA,CAAA;;;;;;;;;;;UASV,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aA+CL;;;;;;;;;;;;;;UAeK,WAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAwCL;;;;;;cAOC,cAAY,CAAA,CAAA;;;;;;;;;;;;;;;;;;;AAnhBzB;AA+BA;AA+FA;AAKA;AAOU;AAeV;AAWA;AAWA;AASA;AASA;AASA;AAWA;AAaA;;;;;;;;;AAYA;;;;;AAciB,iBC3ND,YAAA,CD6NL,KAAW,EC7Nc,WD6Nd,CAAA,EC7N4B,MD6N5B;AA+EtB;;;;;;;;;AAUA;AAMA;;iBC/RgB,YAAA,SAAoB,cAAmB;;;;;AD9DvD;AA+BA;AA+FA;AAKA;AAOU;AAeV;AAWA;AAWA;AASA;AASA;AASA;AAWA;AAaA;;;;;;;;;AAYA;AAIU,iBE7NM,wBAAA,CF6NN,IAAA,EE7NqC,UF6NrC,CAAA,EAAA,MAAA,EAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/types.ts","../src/defineScreen.ts","../src/extractNavigationTargets.ts"],"sourcesContent":[],"mappings":";;;;;;AAKA;AAKiB,KALL,cAAA,GAwBJ,OAAA,GAAA,WAAc,GAAA,MAAA,GAAA,OAAA;AAmBtB;AA+FA;AAKA;AAYU,UAtJO,UAAA,CAsJQ;EAUR;AAWjB;AAWA;AASA;AASA;EASiB,KAAA,EAAA,MAAA;EAWA;AAajB;;;;EAIG,GAAA,EAAA,MAAA;EACA;;;;AAOH;;EAMW,IAAA,CAAA,EAxOH,cAwOG;;;AAQX;AAiFA;;;;;;;;;AAUA;AAMA;;;;UA9TiB,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiWjB;EA8Ba,SAAA,CAAA,EAAA,MAIX,EAAA;;;;;;;;;;;AAwBF;EAUiB,IAAA,CAAA,EAAA,MAAA,EAAA;EA8BJ;;;;;;EAQA,WAAA,CAAA,EAAA,OAAA;;;;;;;;;;UA7XJ;;;;AAuYT;AAqEA;EAqDa,IAAA,CAAA,EA1fL,UAwgBL;;;;;KA9fS,UAAA;;;;KAKA,eAAA;;;;UAYF,eAAA;;QAEH;;;;;;;UAQU,iBAAA,SAA0B;;;;;;;;;;UAW1B,gBAAA,SAAyB;;;;EA0cjB;EAAA,SAAA,CAAA,EAAA,MAAA,GAAA,OAAA,GAAA,UAAA,GAAA,UAAA,GAAA,QAAA;;;;ACzlBzB;AA6BgB,UD6HC,eAAA,SAAwB,eC7HoB,CAAA;;;;ACzC7D;;;;UF+KiB,eAAA,SAAwB;;;;;;;;UASxB,gBAAA,SAAyB;;;;;;;;UASzB,eAAA,SAAwB;;;;;;;;;;UAWxB,gBAAA,SAAyB;;;;;;;;;;;;KAa9B,WAAA,GACT,oBACA,mBACA,kBACA,kBACA,mBACA,kBACA;;;;UAKc,WAAA;;;;WAIP;;YAEC;;aAEC;;;;;UAMK,UAAA;;YAEN;;;;;;cA+EE,kBAAgB,CAAA,CAAA;;;;;;;KAUjB,WAAA,GAAc;;;;;cAMb,cAAY,CAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAmCR,cAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;cA8BJ,gBAAc,CAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UA4BV,aAAA;;;;;;;;;UAUA,oBAAA;;;;;;;;;;;;;;;;;;;;;YAuBN;;;;;;cAOE,qBAAmB,CAAA,CAAA;;;;;;;cAQnB,sBAAoB,CAAA,CAAA;;;;;;;;;;UAUhB,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aA+CL;;;;;;mBAOM;;;;;;;;;;;;;;UAeD,WAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAwCL;;;;;mBAMM;;;;;;cAOL,cAAY,CAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;AA1nBzB;AAKA;AAsCA;AA+FA;AAKA;AAOU;AAeV;AAWA;AAWA;AASA;AASA;AASA;AAWA;AAaA;;;;;;;;;AAYA;;;;AAQuB,iBCjOP,YAAA,CDiOO,KAAA,ECjOa,WDiOb,CAAA,ECjO2B,MDiO3B;AAMvB;AAiFA;;;;;;;;;AAUA;AAMA;iBC3SgB,YAAA,SAAoB,cAAmB;;;;;AD9DvD;AAKA;AAsCA;AA+FA;AAKA;AAOU;AAeV;AAWA;AAWA;AASA;AASA;AASA;AAWA;AAaA;;;;;;;;;AAYiB,iBErOD,wBAAA,CFqOY,IAAA,EErOmB,UFqOnB,CAAA,EAAA,MAAA,EAAA"}

package/dist/index.d.mts

@@ -2,6 +2,10 @@ import { z } from "zod";
 
 //#region src/types.d.ts
 
+/**
+ * Type of external link for icon display
+ */
+type ScreenLinkType = "figma" | "storybook" | "docs" | "other";
 /**
  * External link to related resources
  */
@@ -18,6 +22,13 @@ interface ScreenLink {
    * @example "https://storybook.example.com/?path=/story/billing-invoice"
    */
   url: string;
+  /**
+   * Type of link for icon display
+   * If not specified, the type is inferred from the URL
+   * @example "figma"
+   * @example "storybook"
+   */
+  type?: ScreenLinkType;
 }
 /**
  * Screen metadata definition for the screen catalog.
@@ -248,6 +259,12 @@ declare const screenSchema: z.ZodObject<{
   links: z.ZodOptional<z.ZodArray<z.ZodObject<{
     label: z.ZodString;
     url: z.ZodString;
+    type: z.ZodOptional<z.ZodEnum<{
+      figma: "figma";
+      storybook: "storybook";
+      docs: "docs";
+      other: "other";
+    }>>;
   }, z.core.$strip>>>;
   mock: z.ZodOptional<z.ZodObject<{
     sections: z.ZodArray<z.ZodType<MockSection, unknown, z.core.$ZodTypeInternals<MockSection, unknown>>>;
@@ -300,6 +317,78 @@ declare const adoptionSchema: z.ZodObject<{
   includePatterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
   minimumCoverage: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
+/**
+ * API integration configuration for auto-detecting dependencies from
+ * OpenAPI-generated clients (Orval, openapi-typescript, etc.).
+ *
+ * @example
+ * ```ts
+ * const apiIntegration: ApiIntegrationConfig = {
+ *   clientPackages: ["@/api/generated", "@company/backend-client"],
+ *   extractApiName: (name) => name.replace(/^use/, ""),
+ * }
+ * ```
+ */
+/**
+ * OpenAPI specification configuration for validating dependsOn references.
+ *
+ * @example
+ * ```ts
+ * const openapi: OpenApiConfig = {
+ *   sources: ["./openapi.yaml", "https://api.example.com/openapi.json"],
+ * }
+ * ```
+ */
+interface OpenApiConfig {
+  /**
+   * OpenAPI specification sources (local files or remote URLs).
+   * Supports OpenAPI 2.0 (Swagger) and 3.x specifications.
+   * @example ["./openapi.yaml"]
+   * @example ["./openapi.yaml", "https://api.example.com/openapi.json"]
+   */
+  sources: string[];
+}
+interface ApiIntegrationConfig {
+  /**
+   * Package names to scan for API client imports.
+   * These should match the import paths used in your code.
+   * @example ["@/api/generated"]
+   * @example ["@company/backend-client", "@company/auth-client"]
+   */
+  clientPackages?: string[];
+  /**
+   * Optional transform function to convert import name to dependsOn format.
+   * If not provided, the import name is used as-is.
+   * @example (name) => name.replace(/^use/, "")
+   * @example (name) => `API.${name}`
+   */
+  extractApiName?: (importName: string) => string;
+  /**
+   * OpenAPI specification configuration for validating dependsOn references.
+   * When configured, `screenbook lint` will validate that dependsOn values
+   * match operationIds or HTTP method + path from the OpenAPI spec.
+   * @example { sources: ["./openapi.yaml"] }
+   */
+  openapi?: OpenApiConfig;
+}
+/**
+ * Schema for OpenAPI configuration (runtime validation)
+ * @internal
+ */
+declare const openApiConfigSchema: z.ZodObject<{
+  sources: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Schema for API integration configuration (runtime validation)
+ * @internal
+ */
+declare const apiIntegrationSchema: z.ZodObject<{
+  clientPackages: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  extractApiName: z.ZodOptional<z.ZodAny>;
+  openapi: z.ZodOptional<z.ZodObject<{
+    sources: z.ZodArray<z.ZodString>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
 /**
  * Screenbook configuration options.
  */
@@ -346,6 +435,12 @@ interface Config {
    * @example { mode: "progressive", includePatterns: ["src/pages/billing/**"], minimumCoverage: 80 }
    */
   adoption?: AdoptionConfig;
+  /**
+   * API integration configuration for auto-detecting dependencies
+   * from OpenAPI-generated clients (Orval, openapi-typescript, etc.)
+   * @example { clientPackages: ["@/api/generated"] }
+   */
+  apiIntegration?: ApiIntegrationConfig;
 }
 /**
  * Input type for defineConfig function.
@@ -395,6 +490,11 @@ interface ConfigInput {
    * Progressive adoption configuration
    */
   adoption?: AdoptionConfig;
+  /**
+   * API integration configuration for auto-detecting dependencies
+   * from OpenAPI-generated clients
+   */
+  apiIntegration?: ApiIntegrationConfig;
 }
 /**
  * Schema for Screenbook configuration (runtime validation)
@@ -414,6 +514,13 @@ declare const configSchema: z.ZodObject<{
     includePatterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
     minimumCoverage: z.ZodOptional<z.ZodNumber>;
   }, z.core.$strip>>;
+  apiIntegration: z.ZodOptional<z.ZodObject<{
+    clientPackages: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    extractApiName: z.ZodOptional<z.ZodAny>;
+    openapi: z.ZodOptional<z.ZodObject<{
+      sources: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>;
 }, z.core.$strip>;
 //#endregion
 //#region src/defineScreen.d.ts
@@ -487,5 +594,5 @@ declare function defineConfig(input?: ConfigInput): Config;
  */
 declare function extractNavigationTargets(mock: ScreenMock): string[];
 //#endregion
-export { type AdoptionConfig, type Config, type ConfigInput, type MockButtonElement, type MockElement, type MockElementType, type MockImageElement, type MockInputElement, type MockLayout, type MockLinkElement, type MockListElement, type MockSection, type MockTableElement, type MockTextElement, type Screen, type ScreenInput, type ScreenLink, type ScreenMock, adoptionSchema, configSchema, defineConfig, defineScreen, extractNavigationTargets, screenMockSchema, screenSchema };
+export { type AdoptionConfig, type ApiIntegrationConfig, type Config, type ConfigInput, type MockButtonElement, type MockElement, type MockElementType, type MockImageElement, type MockInputElement, type MockLayout, type MockLinkElement, type MockListElement, type MockSection, type MockTableElement, type MockTextElement, type OpenApiConfig, type Screen, type ScreenInput, type ScreenLink, type ScreenLinkType, type ScreenMock, adoptionSchema, apiIntegrationSchema, configSchema, defineConfig, defineScreen, extractNavigationTargets, openApiConfigSchema, screenMockSchema, screenSchema };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/defineScreen.ts","../src/extractNavigationTargets.ts"],"sourcesContent":[],"mappings":";;;;;;AAKA;AA+BiB,UA/BA,UAAA,CA6GR;EAiBG;AAKZ;AAOU;AAeV;AAWA;EAWiB,KAAA,EAAA,MAAA;EASA;AASjB;AASA;AAWA;AAaA;EACG,GAAA,EAAA,MAAA;;;;;;;;AAWH;;;;;AAcA;AAiFA;;;;UA9SiB,MAAA;;;;;AAwTjB;AAMA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAyB,WAAA,CAAA,EAAA,MAAA,EAAA;EAkCR;AA8BjB;;;;;;;;;;;EASiB,WAAM,CAAA,EAAA,OA+CX;EAeK;AA+CjB;;;;;;;;UAtaS;;;;;;SAOD;;;;;KAUI,UAAA;;;;AAqZa,KAhZb,eAAA,GAgZa,QAAA,GAAA,OAAA,GAAA,MAAA,GAAA,MAAA,GAAA,OAAA,GAAA,MAAA,GAAA,OAAA;;;;UApYf,eAAA;EC9GM;EA6BA,IAAA,EDmFT,eCnFqB;;;;ACzC5B;;;UFoIiB,iBAAA,SAA0B;;;;;;;;;;UAW1B,gBAAA,SAAyB;;;;;;;;;;UAWzB,eAAA,SAAwB;;;;;;;;UASxB,eAAA,SAAwB;;;;;;;;UASxB,gBAAA,SAAyB;;;;;;;;UASzB,eAAA,SAAwB;;;;;;;;;;UAWxB,gBAAA,SAAyB;;;;;;;;;;;;KAa9B,WAAA,GACT,oBACA,mBACA,kBACA,kBACA,mBACA,kBACA;;;;UAKc,WAAA;;;;WAIP;;YAEC;;aAEC;;;;;UAMK,UAAA;;YAEN;;;;;;cA+EE,kBAAgB,CAAA,CAAA;;;;;;;KAUjB,WAAA,GAAc;;;;;cAMb,cAAY,CAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAkCR,cAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;cA8BJ,gBAAc,CAAA,CAAA;;;;;;;;;;;UASV,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aA+CL;;;;;;;;;;;;;;UAeK,WAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAwCL;;;;;;cAOC,cAAY,CAAA,CAAA;;;;;;;;;;;;;;;;;;;AAnhBzB;AA+BA;AA+FA;AAKA;AAOU;AAeV;AAWA;AAWA;AASA;AASA;AASA;AAWA;AAaA;;;;;;;;;AAYA;;;;;AAciB,iBC3ND,YAAA,CD6NL,KAAW,EC7Nc,WD6Nd,CAAA,EC7N4B,MD6N5B;AA+EtB;;;;;;;;;AAUA;AAMA;;iBC/RgB,YAAA,SAAoB,cAAmB;;;;;AD9DvD;AA+BA;AA+FA;AAKA;AAOU;AAeV;AAWA;AAWA;AASA;AASA;AASA;AAWA;AAaA;;;;;;;;;AAYA;AAIU,iBE7NM,wBAAA,CF6NN,IAAA,EE7NqC,UF6NrC,CAAA,EAAA,MAAA,EAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/defineScreen.ts","../src/extractNavigationTargets.ts"],"sourcesContent":[],"mappings":";;;;;;AAKA;AAKiB,KALL,cAAA,GAwBJ,OAAA,GAAA,WAAc,GAAA,MAAA,GAAA,OAAA;AAmBtB;AA+FA;AAKA;AAYU,UAtJO,UAAA,CAsJQ;EAUR;AAWjB;AAWA;AASA;AASA;EASiB,KAAA,EAAA,MAAA;EAWA;AAajB;;;;EAIG,GAAA,EAAA,MAAA;EACA;;;;AAOH;;EAMW,IAAA,CAAA,EAxOH,cAwOG;;;AAQX;AAiFA;;;;;;;;;AAUA;AAMA;;;;UA9TiB,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiWjB;EA8Ba,SAAA,CAAA,EAAA,MAIX,EAAA;;;;;;;;;;;AAwBF;EAUiB,IAAA,CAAA,EAAA,MAAA,EAAA;EA8BJ;;;;;;EAQA,WAAA,CAAA,EAAA,OAAA;;;;;;;;;;UA7XJ;;;;AAuYT;AAqEA;EAqDa,IAAA,CAAA,EA1fL,UAwgBL;;;;;KA9fS,UAAA;;;;KAKA,eAAA;;;;UAYF,eAAA;;QAEH;;;;;;;UAQU,iBAAA,SAA0B;;;;;;;;;;UAW1B,gBAAA,SAAyB;;;;EA0cjB;EAAA,SAAA,CAAA,EAAA,MAAA,GAAA,OAAA,GAAA,UAAA,GAAA,UAAA,GAAA,QAAA;;;;ACzlBzB;AA6BgB,UD6HC,eAAA,SAAwB,eC7HoB,CAAA;;;;ACzC7D;;;;UF+KiB,eAAA,SAAwB;;;;;;;;UASxB,gBAAA,SAAyB;;;;;;;;UASzB,eAAA,SAAwB;;;;;;;;;;UAWxB,gBAAA,SAAyB;;;;;;;;;;;;KAa9B,WAAA,GACT,oBACA,mBACA,kBACA,kBACA,mBACA,kBACA;;;;UAKc,WAAA;;;;WAIP;;YAEC;;aAEC;;;;;UAMK,UAAA;;YAEN;;;;;;cA+EE,kBAAgB,CAAA,CAAA;;;;;;;KAUjB,WAAA,GAAc;;;;;cAMb,cAAY,CAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAmCR,cAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;cA8BJ,gBAAc,CAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UA4BV,aAAA;;;;;;;;;UAUA,oBAAA;;;;;;;;;;;;;;;;;;;;;YAuBN;;;;;;cAOE,qBAAmB,CAAA,CAAA;;;;;;;cAQnB,sBAAoB,CAAA,CAAA;;;;;;;;;;UAUhB,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aA+CL;;;;;;mBAOM;;;;;;;;;;;;;;UAeD,WAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAwCL;;;;;mBAMM;;;;;;cAOL,cAAY,CAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;AA1nBzB;AAKA;AAsCA;AA+FA;AAKA;AAOU;AAeV;AAWA;AAWA;AASA;AASA;AASA;AAWA;AAaA;;;;;;;;;AAYA;;;;AAQuB,iBCjOP,YAAA,CDiOO,KAAA,ECjOa,WDiOb,CAAA,ECjO2B,MDiO3B;AAMvB;AAiFA;;;;;;;;;AAUA;AAMA;iBC3SgB,YAAA,SAAoB,cAAmB;;;;;AD9DvD;AAKA;AAsCA;AA+FA;AAKA;AAOU;AAeV;AAWA;AAWA;AASA;AASA;AASA;AAWA;AAaA;;;;;;;;;AAYiB,iBErOD,wBAAA,CFqOY,IAAA,EErOmB,UFqOnB,CAAA,EAAA,MAAA,EAAA"}

package/dist/index.mjs

@@ -139,7 +139,13 @@ const screenSchema = z.object({
 	description: z.string().optional(),
 	links: z.array(z.object({
 		label: z.string(),
-		url: z.string().url()
+		url: z.string().url(),
+		type: z.enum([
+			"figma",
+			"storybook",
+			"docs",
+			"other"
+		]).optional()
 	})).optional(),
 	mock: screenMockSchema.optional()
 });
@@ -153,6 +159,20 @@ const adoptionSchema = z.object({
 	minimumCoverage: z.number().min(0).max(100).optional()
 });
 /**
+* Schema for OpenAPI configuration (runtime validation)
+* @internal
+*/
+const openApiConfigSchema = z.object({ sources: z.array(z.string()).min(1) });
+/**
+* Schema for API integration configuration (runtime validation)
+* @internal
+*/
+const apiIntegrationSchema = z.object({
+	clientPackages: z.array(z.string()).optional(),
+	extractApiName: z.any().optional(),
+	openapi: openApiConfigSchema.optional()
+});
+/**
 * Schema for Screenbook configuration (runtime validation)
 * @internal
 */
@@ -162,7 +182,8 @@ const configSchema = z.object({
 	routesPattern: z.string().optional(),
 	routesFile: z.string().optional(),
 	ignore: z.array(z.string()).default(["**/node_modules/**", "**/.git/**"]),
-	adoption: adoptionSchema.optional()
+	adoption: adoptionSchema.optional(),
+	apiIntegration: apiIntegrationSchema.optional()
 }).refine((data) => !(data.routesPattern && data.routesFile), {
 	message: "Cannot specify both 'routesPattern' and 'routesFile'. Use one or the other.",
 	path: ["routesFile"]
@@ -226,5 +247,5 @@ function defineConfig(input = {}) {
 }
 
 //#endregion
-export { adoptionSchema, configSchema, defineConfig, defineScreen, extractNavigationTargets, screenMockSchema, screenSchema };
+export { adoptionSchema, apiIntegrationSchema, configSchema, defineConfig, defineScreen, extractNavigationTargets, openApiConfigSchema, screenMockSchema, screenSchema };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["mockSectionSchema: z.ZodType<MockSection>"],"sources":["../src/extractNavigationTargets.ts","../src/types.ts","../src/defineScreen.ts"],"sourcesContent":["import type { MockSection, ScreenMock } from \"./types.js\"\n\n/**\n * Extracts all navigation target screen IDs from a mock definition.\n *\n * This function collects all `navigateTo`, `itemNavigateTo`, and `rowNavigateTo`\n * values from mock elements to automatically derive the `next` array.\n * It recursively processes child sections.\n *\n * @param mock - The screen mock definition\n * @returns Array of unique screen IDs that can be navigated to\n *\n * @example\n * ```ts\n * const mock = {\n *   sections: [{\n *     elements: [\n *       { type: \"button\", label: \"Edit\", navigateTo: \"billing.invoice.edit\" },\n *       { type: \"list\", label: \"Items\", itemNavigateTo: \"billing.item.detail\" },\n *     ]\n *   }]\n * }\n * extractNavigationTargets(mock)\n * // => [\"billing.invoice.edit\", \"billing.item.detail\"]\n * ```\n */\nexport function extractNavigationTargets(mock: ScreenMock): string[] {\n\tconst targets = new Set<string>()\n\n\tfunction processSection(section: MockSection): void {\n\t\tfor (const element of section.elements) {\n\t\t\t// Button and Link elements have navigateTo\n\t\t\tif (\"navigateTo\" in element && element.navigateTo) {\n\t\t\t\ttargets.add(element.navigateTo)\n\t\t\t}\n\n\t\t\t// List elements have itemNavigateTo\n\t\t\tif (\"itemNavigateTo\" in element && element.itemNavigateTo) {\n\t\t\t\ttargets.add(element.itemNavigateTo)\n\t\t\t}\n\n\t\t\t// Table elements have rowNavigateTo\n\t\t\tif (\"rowNavigateTo\" in element && element.rowNavigateTo) {\n\t\t\t\ttargets.add(element.rowNavigateTo)\n\t\t\t}\n\t\t}\n\n\t\t// Recursively process child sections\n\t\tif (section.children) {\n\t\t\tfor (const child of section.children) {\n\t\t\t\tprocessSection(child)\n\t\t\t}\n\t\t}\n\t}\n\n\tfor (const section of mock.sections) {\n\t\tprocessSection(section)\n\t}\n\n\treturn Array.from(targets)\n}\n","import { z } from \"zod\"\n\n/**\n * External link to related resources\n */\nexport interface ScreenLink {\n\t/**\n\t * Display label for the link\n\t * @example \"Figma Design\"\n\t * @example \"Storybook\"\n\t */\n\tlabel: string\n\t/**\n\t * URL to the external resource\n\t * @example \"https://figma.com/file/...\"\n\t * @example \"https://storybook.example.com/?path=/story/billing-invoice\"\n\t */\n\turl: string\n}\n\n/**\n * Screen metadata definition for the screen catalog.\n *\n * @example\n * ```ts\n * const screen: Screen = {\n *   id: \"billing.invoice.detail\",\n *   title: \"Invoice Detail\",\n *   route: \"/billing/invoices/:id\",\n *   owner: [\"billing-team\"],\n *   tags: [\"billing\", \"invoice\"],\n *   dependsOn: [\"InvoiceAPI.getDetail\"],\n *   next: [\"billing.invoice.edit\"],\n * }\n * ```\n */\nexport interface Screen {\n\t/**\n\t * Unique identifier for the screen using dot notation\n\t * @example \"billing.invoice.detail\"\n\t * @example \"auth.login\"\n\t * @example \"settings.profile\"\n\t */\n\tid: string\n\n\t/**\n\t * Human-readable title displayed in the screen catalog\n\t * @example \"Invoice Detail\"\n\t * @example \"Login\"\n\t * @example \"User Profile Settings\"\n\t */\n\ttitle: string\n\n\t/**\n\t * Route path pattern with optional dynamic segments\n\t * @example \"/billing/invoices/:id\"\n\t * @example \"/auth/login\"\n\t * @example \"/settings/profile\"\n\t */\n\troute: string\n\n\t/**\n\t * Team(s) or domain(s) that own this screen\n\t * @example [\"billing-team\"]\n\t * @example [\"platform\", \"billing\"]\n\t */\n\towner?: string[]\n\n\t/**\n\t * Tags for categorization and filtering in the catalog\n\t * @example [\"billing\", \"invoice\"]\n\t * @example [\"auth\", \"security\"]\n\t */\n\ttags?: string[]\n\n\t/**\n\t * APIs or services this screen depends on for impact analysis\n\t * @example [\"InvoiceAPI.getDetail\", \"PaymentAPI.getStatus\"]\n\t * @example [\"UserAPI.getProfile\"]\n\t */\n\tdependsOn?: string[]\n\n\t/**\n\t * Screen IDs that can navigate to this screen (incoming edges)\n\t * @example [\"billing.invoice.list\"]\n\t * @example [\"dashboard.home\", \"nav.sidebar\"]\n\t */\n\tentryPoints?: string[]\n\n\t/**\n\t * Screen IDs this screen can navigate to (outgoing edges)\n\t * @example [\"billing.invoice.edit\", \"billing.payment.start\"]\n\t * @example [\"billing.invoice.list\"]\n\t */\n\tnext?: string[]\n\n\t/**\n\t * Allow circular navigation involving this screen.\n\t * When true, cycles that include this screen will not trigger warnings.\n\t * @default false\n\t * @example true\n\t */\n\tallowCycles?: boolean\n\n\t/**\n\t * Optional description explaining the screen's purpose\n\t * @example \"Displays detailed invoice information including line items and payment status\"\n\t */\n\tdescription?: string\n\n\t/**\n\t * Links to external resources like Storybook, Figma, or documentation\n\t * @example [{ label: \"Figma\", url: \"https://figma.com/file/...\" }]\n\t */\n\tlinks?: ScreenLink[]\n\n\t/**\n\t * Wireframe-level mock definition for UI documentation.\n\t * When defined, navigation targets (navigateTo, itemNavigateTo, rowNavigateTo)\n\t * are automatically extracted and merged into the `next` array.\n\t */\n\tmock?: ScreenMock\n}\n\n// =============================================================================\n// Mock Types - Wireframe-level UI mockups for screen flow documentation\n// =============================================================================\n\n/**\n * Layout direction for mock sections\n */\nexport type MockLayout = \"vertical\" | \"horizontal\"\n\n/**\n * Available element types for mock wireframes\n */\nexport type MockElementType =\n\t| \"button\"\n\t| \"input\"\n\t| \"link\"\n\t| \"text\"\n\t| \"image\"\n\t| \"list\"\n\t| \"table\"\n\n/**\n * Base interface for all mock elements\n */\ninterface MockElementBase {\n\t/** Element type identifier */\n\ttype: MockElementType\n\t/** Display label for the element */\n\tlabel: string\n}\n\n/**\n * Button element with optional navigation and styling\n */\nexport interface MockButtonElement extends MockElementBase {\n\ttype: \"button\"\n\t/** Screen ID to navigate to when clicked */\n\tnavigateTo?: string\n\t/** Visual style variant */\n\tvariant?: \"primary\" | \"secondary\" | \"danger\"\n}\n\n/**\n * Input field element\n */\nexport interface MockInputElement extends MockElementBase {\n\ttype: \"input\"\n\t/** Placeholder text */\n\tplaceholder?: string\n\t/** Input type for semantics */\n\tinputType?: \"text\" | \"email\" | \"password\" | \"textarea\" | \"search\"\n}\n\n/**\n * Link element with optional navigation\n */\nexport interface MockLinkElement extends MockElementBase {\n\ttype: \"link\"\n\t/** Screen ID to navigate to when clicked */\n\tnavigateTo?: string\n}\n\n/**\n * Text element for labels and headings\n */\nexport interface MockTextElement extends MockElementBase {\n\ttype: \"text\"\n\t/** Text style variant */\n\tvariant?: \"heading\" | \"subheading\" | \"body\" | \"caption\"\n}\n\n/**\n * Image placeholder element\n */\nexport interface MockImageElement extends MockElementBase {\n\ttype: \"image\"\n\t/** Aspect ratio (e.g., \"16:9\", \"1:1\") */\n\taspectRatio?: string\n}\n\n/**\n * List element for displaying multiple items\n */\nexport interface MockListElement extends MockElementBase {\n\ttype: \"list\"\n\t/** Number of items to display (default: 3) */\n\titemCount?: number\n\t/** Screen ID to navigate to when an item is clicked */\n\titemNavigateTo?: string\n}\n\n/**\n * Table element for displaying tabular data\n */\nexport interface MockTableElement extends MockElementBase {\n\ttype: \"table\"\n\t/** Column headers */\n\tcolumns?: string[]\n\t/** Number of rows to display (default: 3) */\n\trowCount?: number\n\t/** Screen ID to navigate to when a row is clicked */\n\trowNavigateTo?: string\n}\n\n/**\n * Union type of all mock element variants\n */\nexport type MockElement =\n\t| MockButtonElement\n\t| MockInputElement\n\t| MockLinkElement\n\t| MockTextElement\n\t| MockImageElement\n\t| MockListElement\n\t| MockTableElement\n\n/**\n * Section containing grouped mock elements\n */\nexport interface MockSection {\n\t/** Optional section title */\n\ttitle?: string\n\t/** Layout direction (default: \"vertical\") */\n\tlayout?: MockLayout\n\t/** Elements within this section */\n\telements: MockElement[]\n\t/** Nested child sections */\n\tchildren?: MockSection[]\n}\n\n/**\n * Complete mock definition for a screen\n */\nexport interface ScreenMock {\n\t/** Sections containing UI elements */\n\tsections: MockSection[]\n}\n\n// =============================================================================\n// Mock Zod Schemas\n// =============================================================================\n\nconst mockLayoutSchema = z.enum([\"vertical\", \"horizontal\"])\n\nconst mockElementBaseSchema = z.object({\n\ttype: z.enum([\"button\", \"input\", \"link\", \"text\", \"image\", \"list\", \"table\"]),\n\tlabel: z.string().min(1),\n})\n\nconst mockButtonElementSchema = mockElementBaseSchema.extend({\n\ttype: z.literal(\"button\"),\n\tnavigateTo: z.string().optional(),\n\tvariant: z.enum([\"primary\", \"secondary\", \"danger\"]).optional(),\n})\n\nconst mockInputElementSchema = mockElementBaseSchema.extend({\n\ttype: z.literal(\"input\"),\n\tplaceholder: z.string().optional(),\n\tinputType: z\n\t\t.enum([\"text\", \"email\", \"password\", \"textarea\", \"search\"])\n\t\t.optional(),\n})\n\nconst mockLinkElementSchema = mockElementBaseSchema.extend({\n\ttype: z.literal(\"link\"),\n\tnavigateTo: z.string().optional(),\n})\n\nconst mockTextElementSchema = mockElementBaseSchema.extend({\n\ttype: z.literal(\"text\"),\n\tvariant: z.enum([\"heading\", \"subheading\", \"body\", \"caption\"]).optional(),\n})\n\nconst mockImageElementSchema = mockElementBaseSchema.extend({\n\ttype: z.literal(\"image\"),\n\taspectRatio: z.string().optional(),\n})\n\nconst mockListElementSchema = mockElementBaseSchema.extend({\n\ttype: z.literal(\"list\"),\n\titemCount: z.number().int().positive().optional(),\n\titemNavigateTo: z.string().optional(),\n})\n\nconst mockTableElementSchema = mockElementBaseSchema.extend({\n\ttype: z.literal(\"table\"),\n\tcolumns: z.array(z.string()).optional(),\n\trowCount: z.number().int().positive().optional(),\n\trowNavigateTo: z.string().optional(),\n})\n\nconst mockElementSchema = z.discriminatedUnion(\"type\", [\n\tmockButtonElementSchema,\n\tmockInputElementSchema,\n\tmockLinkElementSchema,\n\tmockTextElementSchema,\n\tmockImageElementSchema,\n\tmockListElementSchema,\n\tmockTableElementSchema,\n])\n\nconst mockSectionSchema: z.ZodType<MockSection> = z.lazy(() =>\n\tz.object({\n\t\ttitle: z.string().optional(),\n\t\tlayout: mockLayoutSchema.optional(),\n\t\telements: z.array(mockElementSchema),\n\t\tchildren: z.array(mockSectionSchema).optional(),\n\t}),\n)\n\n/**\n * Schema for screen mock definition (runtime validation)\n * @internal\n */\nexport const screenMockSchema = z.object({\n\tsections: z.array(mockSectionSchema),\n})\n\n// =============================================================================\n\n/**\n * Input type for defineScreen function.\n * Same as Screen but used for input validation.\n */\nexport type ScreenInput = Screen\n\n/**\n * Schema for screen metadata definition (runtime validation)\n * @internal\n */\nexport const screenSchema = z.object({\n\tid: z.string().min(1),\n\ttitle: z.string().min(1),\n\troute: z.string().min(1),\n\towner: z.array(z.string()).optional(),\n\ttags: z.array(z.string()).optional(),\n\tdependsOn: z.array(z.string()).optional(),\n\tentryPoints: z.array(z.string()).optional(),\n\tnext: z.array(z.string()).optional(),\n\tallowCycles: z.boolean().optional(),\n\tdescription: z.string().optional(),\n\tlinks: z\n\t\t.array(\n\t\t\tz.object({\n\t\t\t\tlabel: z.string(),\n\t\t\t\turl: z.string().url(),\n\t\t\t}),\n\t\t)\n\t\t.optional(),\n\tmock: screenMockSchema.optional(),\n})\n\n/**\n * Progressive adoption configuration for gradual rollout.\n *\n * @example\n * ```ts\n * const adoption: AdoptionConfig = {\n *   mode: \"progressive\",\n *   includePatterns: [\"src/pages/billing/**\"],\n *   minimumCoverage: 80,\n * }\n * ```\n */\nexport interface AdoptionConfig {\n\t/**\n\t * Adoption mode for screen metadata coverage\n\t * - `\"full\"`: All routes must have screen.meta.ts (default)\n\t * - `\"progressive\"`: Only check coverage within includePatterns\n\t * @default \"full\"\n\t * @example \"full\"\n\t * @example \"progressive\"\n\t */\n\tmode?: \"full\" | \"progressive\"\n\n\t/**\n\t * Glob patterns to include for coverage checking (progressive mode only)\n\t * @example [\"src/pages/billing/**\"]\n\t * @example [\"src/pages/auth/**\", \"src/pages/settings/**\"]\n\t */\n\tincludePatterns?: string[]\n\n\t/**\n\t * Minimum coverage percentage required to pass lint (0-100)\n\t * @example 80\n\t * @example 100\n\t */\n\tminimumCoverage?: number\n}\n\n/**\n * Schema for progressive adoption configuration (runtime validation)\n * @internal\n */\nexport const adoptionSchema = z.object({\n\tmode: z.enum([\"full\", \"progressive\"]).default(\"full\"),\n\tincludePatterns: z.array(z.string()).optional(),\n\tminimumCoverage: z.number().min(0).max(100).optional(),\n})\n\n/**\n * Screenbook configuration options.\n */\nexport interface Config {\n\t/**\n\t * Output directory for generated files\n\t * @default \".screenbook\"\n\t * @example \".screenbook\"\n\t * @example \"dist/screenbook\"\n\t */\n\toutDir: string\n\n\t/**\n\t * Glob pattern for screen metadata files.\n\t * Supports colocation: place screen.meta.ts alongside your route files.\n\t * @default \"src/**\\/screen.meta.ts\"\n\t * @example \"src/**\\/screen.meta.ts\"\n\t * @example \"app/**\\/screen.meta.ts\"\n\t */\n\tmetaPattern: string\n\n\t/**\n\t * Glob pattern for route files (for generate/lint commands).\n\t * Use this for file-based routing frameworks (Next.js, Nuxt, Remix, etc.).\n\t * Cannot be used together with routesFile.\n\t * @example \"src/pages/**\\/page.tsx\"\n\t * @example \"app/**\\/page.tsx\"\n\t * @example \"src/routes/**\\/*.tsx\"\n\t */\n\troutesPattern?: string\n\n\t/**\n\t * Path to a router configuration file (for config-based routing).\n\t * Use this for frameworks like Vue Router, React Router, etc.\n\t * Cannot be used together with routesPattern.\n\t * @example \"src/router/routes.ts\"\n\t * @example \"src/router/index.ts\"\n\t */\n\troutesFile?: string\n\n\t/**\n\t * Patterns to ignore when scanning (glob patterns).\n\t * Defaults to node_modules and .git directories.\n\t */\n\tignore: string[]\n\n\t/**\n\t * Progressive adoption configuration for gradual rollout\n\t * @example { mode: \"progressive\", includePatterns: [\"src/pages/billing/**\"], minimumCoverage: 80 }\n\t */\n\tadoption?: AdoptionConfig\n}\n\n/**\n * Input type for defineConfig function.\n * All fields with defaults are optional in input.\n *\n * @example\n * ```ts\n * defineConfig({\n *   metaPattern: \"app/**\\/screen.meta.ts\",\n *   routesPattern: \"app/**\\/page.tsx\",\n * })\n * ```\n */\nexport interface ConfigInput {\n\t/**\n\t * Output directory for generated files\n\t * @default \".screenbook\"\n\t * @example \".screenbook\"\n\t */\n\toutDir?: string\n\n\t/**\n\t * Glob pattern for screen metadata files\n\t * @default \"src/**\\/screen.meta.ts\"\n\t * @example \"app/**\\/screen.meta.ts\"\n\t */\n\tmetaPattern?: string\n\n\t/**\n\t * Glob pattern for route files (for generate/lint commands).\n\t * Use this for file-based routing frameworks.\n\t * Cannot be used together with routesFile.\n\t * @example \"src/pages/**\\/page.tsx\"\n\t */\n\troutesPattern?: string\n\n\t/**\n\t * Path to a router configuration file (for config-based routing).\n\t * Use this for frameworks like Vue Router, React Router, etc.\n\t * Cannot be used together with routesPattern.\n\t * @example \"src/router/routes.ts\"\n\t */\n\troutesFile?: string\n\n\t/**\n\t * Patterns to ignore when scanning.\n\t * Defaults to node_modules and .git directories.\n\t */\n\tignore?: string[]\n\n\t/**\n\t * Progressive adoption configuration\n\t */\n\tadoption?: AdoptionConfig\n}\n\n/**\n * Schema for Screenbook configuration (runtime validation)\n * @internal\n */\nexport const configSchema = z\n\t.object({\n\t\toutDir: z.string().default(\".screenbook\"),\n\t\tmetaPattern: z.string().default(\"src/**/screen.meta.ts\"),\n\t\troutesPattern: z.string().optional(),\n\t\troutesFile: z.string().optional(),\n\t\tignore: z.array(z.string()).default([\"**/node_modules/**\", \"**/.git/**\"]),\n\t\tadoption: adoptionSchema.optional(),\n\t})\n\t.refine((data) => !(data.routesPattern && data.routesFile), {\n\t\tmessage:\n\t\t\t\"Cannot specify both 'routesPattern' and 'routesFile'. Use one or the other.\",\n\t\tpath: [\"routesFile\"],\n\t})\n","import { extractNavigationTargets } from \"./extractNavigationTargets.js\"\nimport {\n\ttype Config,\n\ttype ConfigInput,\n\tconfigSchema,\n\ttype Screen,\n\ttype ScreenInput,\n\tscreenSchema,\n} from \"./types.js\"\n\n/**\n * Define a screen with metadata for the screen catalog.\n *\n * When a `mock` is defined, navigation targets (navigateTo, itemNavigateTo,\n * rowNavigateTo) are automatically extracted and merged into the `next` array.\n *\n * @example\n * ```ts\n * export const screen = defineScreen({\n *   id: \"billing.invoice.detail\",\n *   title: \"Invoice Detail\",\n *   route: \"/billing/invoices/:id\",\n *   owner: [\"billing\"],\n *   tags: [\"billing\", \"invoice\"],\n *   dependsOn: [\"InvoiceAPI.getDetail\"],\n *   entryPoints: [\"billing.invoice.list\"],\n *   next: [\"billing.invoice.edit\"],\n *   mock: {\n *     sections: [{\n *       elements: [\n *         { type: \"button\", label: \"Pay\", navigateTo: \"billing.payment.start\" },\n *       ],\n *     }],\n *   },\n * })\n * // next will be [\"billing.invoice.edit\", \"billing.payment.start\"]\n * ```\n */\nexport function defineScreen(input: ScreenInput): Screen {\n\tconst validated = screenSchema.parse(input)\n\n\t// Auto-derive next from mock if mock exists\n\tif (validated.mock) {\n\t\tconst mockTargets = extractNavigationTargets(validated.mock)\n\t\tif (mockTargets.length > 0) {\n\t\t\t// Merge with existing next, avoiding duplicates\n\t\t\tconst existingNext = validated.next ?? []\n\t\t\tconst mergedNext = [...new Set([...existingNext, ...mockTargets])]\n\t\t\tvalidated.next = mergedNext\n\t\t}\n\t}\n\n\treturn validated\n}\n\n/**\n * Define Screenbook configuration.\n *\n * @example\n * ```ts\n * export default defineConfig({\n *   screensDir: \"src/screens\",\n *   outDir: \".screenbook\",\n *   metaPattern: \"**\\/screen.meta.ts\",\n * })\n * ```\n */\nexport function defineConfig(input: ConfigInput = {}): Config {\n\treturn configSchema.parse(input)\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":["mockSectionSchema: z.ZodType<MockSection>"],"sources":["../src/extractNavigationTargets.ts","../src/types.ts","../src/defineScreen.ts"],"sourcesContent":["import type { MockSection, ScreenMock } from \"./types.js\"\n\n/**\n * Extracts all navigation target screen IDs from a mock definition.\n *\n * This function collects all `navigateTo`, `itemNavigateTo`, and `rowNavigateTo`\n * values from mock elements to automatically derive the `next` array.\n * It recursively processes child sections.\n *\n * @param mock - The screen mock definition\n * @returns Array of unique screen IDs that can be navigated to\n *\n * @example\n * ```ts\n * const mock = {\n *   sections: [{\n *     elements: [\n *       { type: \"button\", label: \"Edit\", navigateTo: \"billing.invoice.edit\" },\n *       { type: \"list\", label: \"Items\", itemNavigateTo: \"billing.item.detail\" },\n *     ]\n *   }]\n * }\n * extractNavigationTargets(mock)\n * // => [\"billing.invoice.edit\", \"billing.item.detail\"]\n * ```\n */\nexport function extractNavigationTargets(mock: ScreenMock): string[] {\n\tconst targets = new Set<string>()\n\n\tfunction processSection(section: MockSection): void {\n\t\tfor (const element of section.elements) {\n\t\t\t// Button and Link elements have navigateTo\n\t\t\tif (\"navigateTo\" in element && element.navigateTo) {\n\t\t\t\ttargets.add(element.navigateTo)\n\t\t\t}\n\n\t\t\t// List elements have itemNavigateTo\n\t\t\tif (\"itemNavigateTo\" in element && element.itemNavigateTo) {\n\t\t\t\ttargets.add(element.itemNavigateTo)\n\t\t\t}\n\n\t\t\t// Table elements have rowNavigateTo\n\t\t\tif (\"rowNavigateTo\" in element && element.rowNavigateTo) {\n\t\t\t\ttargets.add(element.rowNavigateTo)\n\t\t\t}\n\t\t}\n\n\t\t// Recursively process child sections\n\t\tif (section.children) {\n\t\t\tfor (const child of section.children) {\n\t\t\t\tprocessSection(child)\n\t\t\t}\n\t\t}\n\t}\n\n\tfor (const section of mock.sections) {\n\t\tprocessSection(section)\n\t}\n\n\treturn Array.from(targets)\n}\n","import { z } from \"zod\"\n\n/**\n * Type of external link for icon display\n */\nexport type ScreenLinkType = \"figma\" | \"storybook\" | \"docs\" | \"other\"\n\n/**\n * External link to related resources\n */\nexport interface ScreenLink {\n\t/**\n\t * Display label for the link\n\t * @example \"Figma Design\"\n\t * @example \"Storybook\"\n\t */\n\tlabel: string\n\t/**\n\t * URL to the external resource\n\t * @example \"https://figma.com/file/...\"\n\t * @example \"https://storybook.example.com/?path=/story/billing-invoice\"\n\t */\n\turl: string\n\t/**\n\t * Type of link for icon display\n\t * If not specified, the type is inferred from the URL\n\t * @example \"figma\"\n\t * @example \"storybook\"\n\t */\n\ttype?: ScreenLinkType\n}\n\n/**\n * Screen metadata definition for the screen catalog.\n *\n * @example\n * ```ts\n * const screen: Screen = {\n *   id: \"billing.invoice.detail\",\n *   title: \"Invoice Detail\",\n *   route: \"/billing/invoices/:id\",\n *   owner: [\"billing-team\"],\n *   tags: [\"billing\", \"invoice\"],\n *   dependsOn: [\"InvoiceAPI.getDetail\"],\n *   next: [\"billing.invoice.edit\"],\n * }\n * ```\n */\nexport interface Screen {\n\t/**\n\t * Unique identifier for the screen using dot notation\n\t * @example \"billing.invoice.detail\"\n\t * @example \"auth.login\"\n\t * @example \"settings.profile\"\n\t */\n\tid: string\n\n\t/**\n\t * Human-readable title displayed in the screen catalog\n\t * @example \"Invoice Detail\"\n\t * @example \"Login\"\n\t * @example \"User Profile Settings\"\n\t */\n\ttitle: string\n\n\t/**\n\t * Route path pattern with optional dynamic segments\n\t * @example \"/billing/invoices/:id\"\n\t * @example \"/auth/login\"\n\t * @example \"/settings/profile\"\n\t */\n\troute: string\n\n\t/**\n\t * Team(s) or domain(s) that own this screen\n\t * @example [\"billing-team\"]\n\t * @example [\"platform\", \"billing\"]\n\t */\n\towner?: string[]\n\n\t/**\n\t * Tags for categorization and filtering in the catalog\n\t * @example [\"billing\", \"invoice\"]\n\t * @example [\"auth\", \"security\"]\n\t */\n\ttags?: string[]\n\n\t/**\n\t * APIs or services this screen depends on for impact analysis\n\t * @example [\"InvoiceAPI.getDetail\", \"PaymentAPI.getStatus\"]\n\t * @example [\"UserAPI.getProfile\"]\n\t */\n\tdependsOn?: string[]\n\n\t/**\n\t * Screen IDs that can navigate to this screen (incoming edges)\n\t * @example [\"billing.invoice.list\"]\n\t * @example [\"dashboard.home\", \"nav.sidebar\"]\n\t */\n\tentryPoints?: string[]\n\n\t/**\n\t * Screen IDs this screen can navigate to (outgoing edges)\n\t * @example [\"billing.invoice.edit\", \"billing.payment.start\"]\n\t * @example [\"billing.invoice.list\"]\n\t */\n\tnext?: string[]\n\n\t/**\n\t * Allow circular navigation involving this screen.\n\t * When true, cycles that include this screen will not trigger warnings.\n\t * @default false\n\t * @example true\n\t */\n\tallowCycles?: boolean\n\n\t/**\n\t * Optional description explaining the screen's purpose\n\t * @example \"Displays detailed invoice information including line items and payment status\"\n\t */\n\tdescription?: string\n\n\t/**\n\t * Links to external resources like Storybook, Figma, or documentation\n\t * @example [{ label: \"Figma\", url: \"https://figma.com/file/...\" }]\n\t */\n\tlinks?: ScreenLink[]\n\n\t/**\n\t * Wireframe-level mock definition for UI documentation.\n\t * When defined, navigation targets (navigateTo, itemNavigateTo, rowNavigateTo)\n\t * are automatically extracted and merged into the `next` array.\n\t */\n\tmock?: ScreenMock\n}\n\n// =============================================================================\n// Mock Types - Wireframe-level UI mockups for screen flow documentation\n// =============================================================================\n\n/**\n * Layout direction for mock sections\n */\nexport type MockLayout = \"vertical\" | \"horizontal\"\n\n/**\n * Available element types for mock wireframes\n */\nexport type MockElementType =\n\t| \"button\"\n\t| \"input\"\n\t| \"link\"\n\t| \"text\"\n\t| \"image\"\n\t| \"list\"\n\t| \"table\"\n\n/**\n * Base interface for all mock elements\n */\ninterface MockElementBase {\n\t/** Element type identifier */\n\ttype: MockElementType\n\t/** Display label for the element */\n\tlabel: string\n}\n\n/**\n * Button element with optional navigation and styling\n */\nexport interface MockButtonElement extends MockElementBase {\n\ttype: \"button\"\n\t/** Screen ID to navigate to when clicked */\n\tnavigateTo?: string\n\t/** Visual style variant */\n\tvariant?: \"primary\" | \"secondary\" | \"danger\"\n}\n\n/**\n * Input field element\n */\nexport interface MockInputElement extends MockElementBase {\n\ttype: \"input\"\n\t/** Placeholder text */\n\tplaceholder?: string\n\t/** Input type for semantics */\n\tinputType?: \"text\" | \"email\" | \"password\" | \"textarea\" | \"search\"\n}\n\n/**\n * Link element with optional navigation\n */\nexport interface MockLinkElement extends MockElementBase {\n\ttype: \"link\"\n\t/** Screen ID to navigate to when clicked */\n\tnavigateTo?: string\n}\n\n/**\n * Text element for labels and headings\n */\nexport interface MockTextElement extends MockElementBase {\n\ttype: \"text\"\n\t/** Text style variant */\n\tvariant?: \"heading\" | \"subheading\" | \"body\" | \"caption\"\n}\n\n/**\n * Image placeholder element\n */\nexport interface MockImageElement extends MockElementBase {\n\ttype: \"image\"\n\t/** Aspect ratio (e.g., \"16:9\", \"1:1\") */\n\taspectRatio?: string\n}\n\n/**\n * List element for displaying multiple items\n */\nexport interface MockListElement extends MockElementBase {\n\ttype: \"list\"\n\t/** Number of items to display (default: 3) */\n\titemCount?: number\n\t/** Screen ID to navigate to when an item is clicked */\n\titemNavigateTo?: string\n}\n\n/**\n * Table element for displaying tabular data\n */\nexport interface MockTableElement extends MockElementBase {\n\ttype: \"table\"\n\t/** Column headers */\n\tcolumns?: string[]\n\t/** Number of rows to display (default: 3) */\n\trowCount?: number\n\t/** Screen ID to navigate to when a row is clicked */\n\trowNavigateTo?: string\n}\n\n/**\n * Union type of all mock element variants\n */\nexport type MockElement =\n\t| MockButtonElement\n\t| MockInputElement\n\t| MockLinkElement\n\t| MockTextElement\n\t| MockImageElement\n\t| MockListElement\n\t| MockTableElement\n\n/**\n * Section containing grouped mock elements\n */\nexport interface MockSection {\n\t/** Optional section title */\n\ttitle?: string\n\t/** Layout direction (default: \"vertical\") */\n\tlayout?: MockLayout\n\t/** Elements within this section */\n\telements: MockElement[]\n\t/** Nested child sections */\n\tchildren?: MockSection[]\n}\n\n/**\n * Complete mock definition for a screen\n */\nexport interface ScreenMock {\n\t/** Sections containing UI elements */\n\tsections: MockSection[]\n}\n\n// =============================================================================\n// Mock Zod Schemas\n// =============================================================================\n\nconst mockLayoutSchema = z.enum([\"vertical\", \"horizontal\"])\n\nconst mockElementBaseSchema = z.object({\n\ttype: z.enum([\"button\", \"input\", \"link\", \"text\", \"image\", \"list\", \"table\"]),\n\tlabel: z.string().min(1),\n})\n\nconst mockButtonElementSchema = mockElementBaseSchema.extend({\n\ttype: z.literal(\"button\"),\n\tnavigateTo: z.string().optional(),\n\tvariant: z.enum([\"primary\", \"secondary\", \"danger\"]).optional(),\n})\n\nconst mockInputElementSchema = mockElementBaseSchema.extend({\n\ttype: z.literal(\"input\"),\n\tplaceholder: z.string().optional(),\n\tinputType: z\n\t\t.enum([\"text\", \"email\", \"password\", \"textarea\", \"search\"])\n\t\t.optional(),\n})\n\nconst mockLinkElementSchema = mockElementBaseSchema.extend({\n\ttype: z.literal(\"link\"),\n\tnavigateTo: z.string().optional(),\n})\n\nconst mockTextElementSchema = mockElementBaseSchema.extend({\n\ttype: z.literal(\"text\"),\n\tvariant: z.enum([\"heading\", \"subheading\", \"body\", \"caption\"]).optional(),\n})\n\nconst mockImageElementSchema = mockElementBaseSchema.extend({\n\ttype: z.literal(\"image\"),\n\taspectRatio: z.string().optional(),\n})\n\nconst mockListElementSchema = mockElementBaseSchema.extend({\n\ttype: z.literal(\"list\"),\n\titemCount: z.number().int().positive().optional(),\n\titemNavigateTo: z.string().optional(),\n})\n\nconst mockTableElementSchema = mockElementBaseSchema.extend({\n\ttype: z.literal(\"table\"),\n\tcolumns: z.array(z.string()).optional(),\n\trowCount: z.number().int().positive().optional(),\n\trowNavigateTo: z.string().optional(),\n})\n\nconst mockElementSchema = z.discriminatedUnion(\"type\", [\n\tmockButtonElementSchema,\n\tmockInputElementSchema,\n\tmockLinkElementSchema,\n\tmockTextElementSchema,\n\tmockImageElementSchema,\n\tmockListElementSchema,\n\tmockTableElementSchema,\n])\n\nconst mockSectionSchema: z.ZodType<MockSection> = z.lazy(() =>\n\tz.object({\n\t\ttitle: z.string().optional(),\n\t\tlayout: mockLayoutSchema.optional(),\n\t\telements: z.array(mockElementSchema),\n\t\tchildren: z.array(mockSectionSchema).optional(),\n\t}),\n)\n\n/**\n * Schema for screen mock definition (runtime validation)\n * @internal\n */\nexport const screenMockSchema = z.object({\n\tsections: z.array(mockSectionSchema),\n})\n\n// =============================================================================\n\n/**\n * Input type for defineScreen function.\n * Same as Screen but used for input validation.\n */\nexport type ScreenInput = Screen\n\n/**\n * Schema for screen metadata definition (runtime validation)\n * @internal\n */\nexport const screenSchema = z.object({\n\tid: z.string().min(1),\n\ttitle: z.string().min(1),\n\troute: z.string().min(1),\n\towner: z.array(z.string()).optional(),\n\ttags: z.array(z.string()).optional(),\n\tdependsOn: z.array(z.string()).optional(),\n\tentryPoints: z.array(z.string()).optional(),\n\tnext: z.array(z.string()).optional(),\n\tallowCycles: z.boolean().optional(),\n\tdescription: z.string().optional(),\n\tlinks: z\n\t\t.array(\n\t\t\tz.object({\n\t\t\t\tlabel: z.string(),\n\t\t\t\turl: z.string().url(),\n\t\t\t\ttype: z.enum([\"figma\", \"storybook\", \"docs\", \"other\"]).optional(),\n\t\t\t}),\n\t\t)\n\t\t.optional(),\n\tmock: screenMockSchema.optional(),\n})\n\n/**\n * Progressive adoption configuration for gradual rollout.\n *\n * @example\n * ```ts\n * const adoption: AdoptionConfig = {\n *   mode: \"progressive\",\n *   includePatterns: [\"src/pages/billing/**\"],\n *   minimumCoverage: 80,\n * }\n * ```\n */\nexport interface AdoptionConfig {\n\t/**\n\t * Adoption mode for screen metadata coverage\n\t * - `\"full\"`: All routes must have screen.meta.ts (default)\n\t * - `\"progressive\"`: Only check coverage within includePatterns\n\t * @default \"full\"\n\t * @example \"full\"\n\t * @example \"progressive\"\n\t */\n\tmode?: \"full\" | \"progressive\"\n\n\t/**\n\t * Glob patterns to include for coverage checking (progressive mode only)\n\t * @example [\"src/pages/billing/**\"]\n\t * @example [\"src/pages/auth/**\", \"src/pages/settings/**\"]\n\t */\n\tincludePatterns?: string[]\n\n\t/**\n\t * Minimum coverage percentage required to pass lint (0-100)\n\t * @example 80\n\t * @example 100\n\t */\n\tminimumCoverage?: number\n}\n\n/**\n * Schema for progressive adoption configuration (runtime validation)\n * @internal\n */\nexport const adoptionSchema = z.object({\n\tmode: z.enum([\"full\", \"progressive\"]).default(\"full\"),\n\tincludePatterns: z.array(z.string()).optional(),\n\tminimumCoverage: z.number().min(0).max(100).optional(),\n})\n\n/**\n * API integration configuration for auto-detecting dependencies from\n * OpenAPI-generated clients (Orval, openapi-typescript, etc.).\n *\n * @example\n * ```ts\n * const apiIntegration: ApiIntegrationConfig = {\n *   clientPackages: [\"@/api/generated\", \"@company/backend-client\"],\n *   extractApiName: (name) => name.replace(/^use/, \"\"),\n * }\n * ```\n */\n/**\n * OpenAPI specification configuration for validating dependsOn references.\n *\n * @example\n * ```ts\n * const openapi: OpenApiConfig = {\n *   sources: [\"./openapi.yaml\", \"https://api.example.com/openapi.json\"],\n * }\n * ```\n */\nexport interface OpenApiConfig {\n\t/**\n\t * OpenAPI specification sources (local files or remote URLs).\n\t * Supports OpenAPI 2.0 (Swagger) and 3.x specifications.\n\t * @example [\"./openapi.yaml\"]\n\t * @example [\"./openapi.yaml\", \"https://api.example.com/openapi.json\"]\n\t */\n\tsources: string[]\n}\n\nexport interface ApiIntegrationConfig {\n\t/**\n\t * Package names to scan for API client imports.\n\t * These should match the import paths used in your code.\n\t * @example [\"@/api/generated\"]\n\t * @example [\"@company/backend-client\", \"@company/auth-client\"]\n\t */\n\tclientPackages?: string[]\n\n\t/**\n\t * Optional transform function to convert import name to dependsOn format.\n\t * If not provided, the import name is used as-is.\n\t * @example (name) => name.replace(/^use/, \"\")\n\t * @example (name) => `API.${name}`\n\t */\n\textractApiName?: (importName: string) => string\n\n\t/**\n\t * OpenAPI specification configuration for validating dependsOn references.\n\t * When configured, `screenbook lint` will validate that dependsOn values\n\t * match operationIds or HTTP method + path from the OpenAPI spec.\n\t * @example { sources: [\"./openapi.yaml\"] }\n\t */\n\topenapi?: OpenApiConfig\n}\n\n/**\n * Schema for OpenAPI configuration (runtime validation)\n * @internal\n */\nexport const openApiConfigSchema = z.object({\n\tsources: z.array(z.string()).min(1),\n})\n\n/**\n * Schema for API integration configuration (runtime validation)\n * @internal\n */\nexport const apiIntegrationSchema = z.object({\n\tclientPackages: z.array(z.string()).optional(),\n\t// Function validation is complex in Zod v4, so we use z.any() for the optional transform function\n\textractApiName: z.any().optional(),\n\topenapi: openApiConfigSchema.optional(),\n})\n\n/**\n * Screenbook configuration options.\n */\nexport interface Config {\n\t/**\n\t * Output directory for generated files\n\t * @default \".screenbook\"\n\t * @example \".screenbook\"\n\t * @example \"dist/screenbook\"\n\t */\n\toutDir: string\n\n\t/**\n\t * Glob pattern for screen metadata files.\n\t * Supports colocation: place screen.meta.ts alongside your route files.\n\t * @default \"src/**\\/screen.meta.ts\"\n\t * @example \"src/**\\/screen.meta.ts\"\n\t * @example \"app/**\\/screen.meta.ts\"\n\t */\n\tmetaPattern: string\n\n\t/**\n\t * Glob pattern for route files (for generate/lint commands).\n\t * Use this for file-based routing frameworks (Next.js, Nuxt, Remix, etc.).\n\t * Cannot be used together with routesFile.\n\t * @example \"src/pages/**\\/page.tsx\"\n\t * @example \"app/**\\/page.tsx\"\n\t * @example \"src/routes/**\\/*.tsx\"\n\t */\n\troutesPattern?: string\n\n\t/**\n\t * Path to a router configuration file (for config-based routing).\n\t * Use this for frameworks like Vue Router, React Router, etc.\n\t * Cannot be used together with routesPattern.\n\t * @example \"src/router/routes.ts\"\n\t * @example \"src/router/index.ts\"\n\t */\n\troutesFile?: string\n\n\t/**\n\t * Patterns to ignore when scanning (glob patterns).\n\t * Defaults to node_modules and .git directories.\n\t */\n\tignore: string[]\n\n\t/**\n\t * Progressive adoption configuration for gradual rollout\n\t * @example { mode: \"progressive\", includePatterns: [\"src/pages/billing/**\"], minimumCoverage: 80 }\n\t */\n\tadoption?: AdoptionConfig\n\n\t/**\n\t * API integration configuration for auto-detecting dependencies\n\t * from OpenAPI-generated clients (Orval, openapi-typescript, etc.)\n\t * @example { clientPackages: [\"@/api/generated\"] }\n\t */\n\tapiIntegration?: ApiIntegrationConfig\n}\n\n/**\n * Input type for defineConfig function.\n * All fields with defaults are optional in input.\n *\n * @example\n * ```ts\n * defineConfig({\n *   metaPattern: \"app/**\\/screen.meta.ts\",\n *   routesPattern: \"app/**\\/page.tsx\",\n * })\n * ```\n */\nexport interface ConfigInput {\n\t/**\n\t * Output directory for generated files\n\t * @default \".screenbook\"\n\t * @example \".screenbook\"\n\t */\n\toutDir?: string\n\n\t/**\n\t * Glob pattern for screen metadata files\n\t * @default \"src/**\\/screen.meta.ts\"\n\t * @example \"app/**\\/screen.meta.ts\"\n\t */\n\tmetaPattern?: string\n\n\t/**\n\t * Glob pattern for route files (for generate/lint commands).\n\t * Use this for file-based routing frameworks.\n\t * Cannot be used together with routesFile.\n\t * @example \"src/pages/**\\/page.tsx\"\n\t */\n\troutesPattern?: string\n\n\t/**\n\t * Path to a router configuration file (for config-based routing).\n\t * Use this for frameworks like Vue Router, React Router, etc.\n\t * Cannot be used together with routesPattern.\n\t * @example \"src/router/routes.ts\"\n\t */\n\troutesFile?: string\n\n\t/**\n\t * Patterns to ignore when scanning.\n\t * Defaults to node_modules and .git directories.\n\t */\n\tignore?: string[]\n\n\t/**\n\t * Progressive adoption configuration\n\t */\n\tadoption?: AdoptionConfig\n\n\t/**\n\t * API integration configuration for auto-detecting dependencies\n\t * from OpenAPI-generated clients\n\t */\n\tapiIntegration?: ApiIntegrationConfig\n}\n\n/**\n * Schema for Screenbook configuration (runtime validation)\n * @internal\n */\nexport const configSchema = z\n\t.object({\n\t\toutDir: z.string().default(\".screenbook\"),\n\t\tmetaPattern: z.string().default(\"src/**/screen.meta.ts\"),\n\t\troutesPattern: z.string().optional(),\n\t\troutesFile: z.string().optional(),\n\t\tignore: z.array(z.string()).default([\"**/node_modules/**\", \"**/.git/**\"]),\n\t\tadoption: adoptionSchema.optional(),\n\t\tapiIntegration: apiIntegrationSchema.optional(),\n\t})\n\t.refine((data) => !(data.routesPattern && data.routesFile), {\n\t\tmessage:\n\t\t\t\"Cannot specify both 'routesPattern' and 'routesFile'. Use one or the other.\",\n\t\tpath: [\"routesFile\"],\n\t})\n","import { extractNavigationTargets } from \"./extractNavigationTargets.js\"\nimport {\n\ttype Config,\n\ttype ConfigInput,\n\tconfigSchema,\n\ttype Screen,\n\ttype ScreenInput,\n\tscreenSchema,\n} from \"./types.js\"\n\n/**\n * Define a screen with metadata for the screen catalog.\n *\n * When a `mock` is defined, navigation targets (navigateTo, itemNavigateTo,\n * rowNavigateTo) are automatically extracted and merged into the `next` array.\n *\n * @example\n * ```ts\n * export const screen = defineScreen({\n *   id: \"billing.invoice.detail\",\n *   title: \"Invoice Detail\",\n *   route: \"/billing/invoices/:id\",\n *   owner: [\"billing\"],\n *   tags: [\"billing\", \"invoice\"],\n *   dependsOn: [\"InvoiceAPI.getDetail\"],\n *   entryPoints: [\"billing.invoice.list\"],\n *   next: [\"billing.invoice.edit\"],\n *   mock: {\n *     sections: [{\n *       elements: [\n *         { type: \"button\", label: \"Pay\", navigateTo: \"billing.payment.start\" },\n *       ],\n *     }],\n *   },\n * })\n * // next will be [\"billing.invoice.edit\", \"billing.payment.start\"]\n * ```\n */\nexport function defineScreen(input: ScreenInput): Screen {\n\tconst validated = screenSchema.parse(input)\n\n\t// Auto-derive next from mock if mock exists\n\tif (validated.mock) {\n\t\tconst mockTargets = extractNavigationTargets(validated.mock)\n\t\tif (mockTargets.length > 0) {\n\t\t\t// Merge with existing next, avoiding duplicates\n\t\t\tconst existingNext = validated.next ?? []\n\t\t\tconst mergedNext = [...new Set([...existingNext, ...mockTargets])]\n\t\t\tvalidated.next = mergedNext\n\t\t}\n\t}\n\n\treturn validated\n}\n\n/**\n * Define Screenbook configuration.\n *\n * @example\n * ```ts\n * export default defineConfig({\n *   screensDir: \"src/screens\",\n *   outDir: \".screenbook\",\n *   metaPattern: \"**\\/screen.meta.ts\",\n * })\n * ```\n */\nexport function defineConfig(input: ConfigInput = {}): Config {\n\treturn configSchema.parse(input)\n}\n"],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@screenbook/core",
-	"version": "1.2.0",
-	"description": "Core library for Screenbook - screen metadata definitions and validation",
+	"version": "1.6.0",
+	"description": "Define screens in code with TypeScript. Core library for screen catalog and navigation graph generation.",
 	"type": "module",
 	"exports": {
 		".": {
@@ -31,10 +31,15 @@
 	},
 	"keywords": [
 		"screenbook",
-		"screen",
-		"catalog",
-		"navigation",
-		"graph"
+		"screen-catalog",
+		"navigation-graph",
+		"documentation",
+		"documentation-generator",
+		"frontend",
+		"developer-tools",
+		"impact-analysis",
+		"typescript",
+		"screen-documentation"
 	],
 	"license": "MIT",
 	"repository": {