@wix/zero-config-implementation 1.36.0 → 1.37.0

package/README.md

@@ -15,19 +15,24 @@ Peer dependencies: `react` (^18 || ^19), `react-dom` (^18 || ^19), `typescript`
 ### Programmatic
 
 ```ts
-import { extractComponentManifest } from '@wix/zero-config'
+import { extractComponentManifest, extractComponentManifestResult } from '@wix/zero-config'
 
-const result = await extractComponentManifest(
+const manifest = await extractComponentManifest(
   './src/MyComponent.tsx',
   './dist/index.js', // path to the compiled JS entry of the component's package
 )
 
+console.log(manifest.component) // EditorReactComponent
+console.log(manifest.errors) // non-fatal ExtractionError[]
+
+// If you prefer neverthrow ResultAsync semantics:
+const result = await extractComponentManifestResult('./src/MyComponent.tsx', './dist/index.js')
 result.match(
-  (manifest) => {
-    console.log(manifest.component) // EditorReactComponent
-    console.log(manifest.errors)    // non-fatal ExtractionError[]
+  (manifestResult) => {
+    console.log(manifestResult.component)
+    console.log(manifestResult.errors)
   },
-  (err) => console.error(err),
+  (error) => console.error(error),
 )
 ```
 
@@ -53,7 +58,8 @@ npx @wix/zero-config
 
 ## API layers
 
-- **Tier 1 — High-level:** `extractComponentManifest()` — one call, default pipeline.
+- **Tier 1 — High-level:** `extractComponentManifest()` — one call, default pipeline (`Promise<ManifestResult>`).
+- **Tier 1 (neverthrow variant):** `extractComponentManifestResult()` — same pipeline with `ResultAsync` return.
 - **Tier 2 — Pipeline building blocks:** `compileTsFile`, `extractAllComponentInfo`, `extractCssImports`, `processComponent`, `runExtractors`, `ExtractorStore`, `buildElementTree`, `createPropTrackerExtractor`, `createCssPropertiesExtractor`, `parseCss`, `toEditorReactComponent`, and exported types (e.g. `ComponentInfo`, `PropInfo`, `ExtractionResult`, `ReactExtractor`).
 - **Tier 3 — Low-level:** `renderWithExtractors`, `CreateElementListener` for custom createElement/JSX interception.
 

package/dist/index.d.ts

@@ -813,7 +813,7 @@ declare type ExternalPluginsOptions<PluginsArg extends Plugins> = {
 
 export declare function extractAllComponentInfo(program: default_2.Program, filePath: string): ComponentInfo[];
 
-export declare function extractComponentManifest(componentPath: string, compiledEntryPath: string, options?: ExtractComponentManifestOptions): ResultAsync<ManifestResult, InstanceType<typeof NotFoundError> | InstanceType<typeof ParseError>>;
+export declare function extractComponentManifest(componentPath: string, compiledEntryPath: string, options?: ExtractComponentManifestOptions): Promise<ManifestResult>;
 
 /**
  * Extract component manifest from a TypeScript source file.
@@ -829,6 +829,8 @@ export declare interface ExtractComponentManifestOptions extends RunExtractorsOp
     onError?: (error: ExtractionError) => void;
 }
 
+export declare function extractComponentManifestResult(componentPath: string, compiledEntryPath: string, options?: ExtractComponentManifestOptions): ResultAsync<ManifestResult, InstanceType<typeof NotFoundError> | InstanceType<typeof ParseError>>;
+
 export declare function extractCssImports(program: Program): string[];
 
 /**

package/dist/index.js

@@ -2930,14 +2930,14 @@ const Np = {
     /** Process exit code used by BaseError.exit(). */
     exitCode: 1
   }
-}), Jp = hn.subclass("NotFoundError"), Ba = hn.subclass("ParseError"), B7 = hn.subclass("ValidationError"), $a = hn.subclass("IoError"), gw = hn.subclass("DefectError", {
+}), Jp = hn.subclass("NotFoundError"), Ba = hn.subclass("ParseError"), y7 = hn.subclass("ValidationError"), $a = hn.subclass("IoError"), gw = hn.subclass("DefectError", {
   props: {
     phase: "internal",
     isDefect: !0,
     exitCode: 70
   }
 }), fw = "https://github.com/wix-private/ZeroConfig/issues";
-async function y7(e) {
+async function b7(e) {
   try {
     await e();
   } catch (t) {
@@ -20390,18 +20390,18 @@ const Hn = {
   ...eP,
   ...tP
 }), {
-  tokenize: w7,
+  tokenize: k7,
   parse: Oy,
   generate: ui,
   lexer: nP,
-  createLexer: k7,
+  createLexer: T7,
   walk: Hy,
-  find: T7,
-  findLast: N7,
-  findAll: R7,
-  toPlainObject: M7,
-  fromPlainObject: v7,
-  fork: L7
+  find: N7,
+  findLast: R7,
+  findAll: M7,
+  toPlainObject: v7,
+  fromPlainObject: L7,
+  fork: x7
 } = rP;
 function aP(e) {
   return e.atrule?.name === "keyframes";
@@ -45783,7 +45783,7 @@ function UV(e) {
     })
   ).map(({ result: r }) => xe.createProgram([e], r.options)) : Wn(new Jp(`File not found: ${t}`, { props: { phase: "compile" } }));
 }
-function Y7(e, t, r) {
+function OV(e, t, r) {
   const n = [], a = (i) => {
     n.push(i), r?.onError?.(i);
   };
@@ -45840,6 +45840,14 @@ function Y7(e, t, r) {
     });
   });
 }
+async function W7(e, t, r) {
+  return (await OV(e, t, r)).match(
+    (a) => a,
+    (a) => {
+      throw a;
+    }
+  );
+}
 export {
   hn as BaseError,
   gw as DefectError,
@@ -45849,7 +45857,7 @@ export {
   Ba as ParseError,
   Ea as Result,
   Tt as ResultAsync,
-  B7 as ValidationError,
+  y7 as ValidationError,
   s4 as buildElementTree,
   UV as compileTsFile,
   $3 as createCssPropertiesExtractor,
@@ -45857,7 +45865,8 @@ export {
   dr as err,
   Wn as errAsync,
   lg as extractAllComponentInfo,
-  Y7 as extractComponentManifest,
+  W7 as extractComponentManifest,
+  OV as extractComponentManifestResult,
   fk as extractCssImports,
   ak as extractDefaultComponentInfo,
   EV as findComponent,
@@ -45867,5 +45876,5 @@ export {
   iP as parseCss,
   pk as renderWithExtractors,
   u4 as runExtractors,
-  y7 as withDefectBoundary
+  b7 as withDefectBoundary
 };

package/package.json

@@ -4,7 +4,7 @@
     "registry": "https://registry.npmjs.org/",
     "access": "public"
   },
-  "version": "1.36.0",
+  "version": "1.37.0",
   "description": "Core library for extracting component manifests from JS and CSS files",
   "type": "module",
   "main": "dist/index.js",
@@ -84,5 +84,5 @@
       ]
     }
   },
-  "falconPackageHash": "783628b17db7e1730658c51eaaddf8d5abc8372807221c09c6828115"
+  "falconPackageHash": "ee9a93321f74030e3fae1f44881ad07be78e67c051afcb5ea562b546"
 }

package/src/index.ts

@@ -39,7 +39,7 @@ export interface ExtractComponentManifestOptions extends RunExtractorsOptions {
   onError?: (error: ExtractionError) => void
 }
 
-export function extractComponentManifest(
+export function extractComponentManifestResult(
   componentPath: string,
   compiledEntryPath: string,
   options?: ExtractComponentManifestOptions,
@@ -129,6 +129,20 @@ export function extractComponentManifest(
     })
 }
 
+export async function extractComponentManifest(
+  componentPath: string,
+  compiledEntryPath: string,
+  options?: ExtractComponentManifestOptions,
+): Promise<ManifestResult> {
+  const extractionResult = await extractComponentManifestResult(componentPath, compiledEntryPath, options)
+  return extractionResult.match(
+    (manifestResult) => manifestResult,
+    (error) => {
+      throw error
+    },
+  )
+}
+
 // ─────────────────────────────────────────────────────────────────────────────
 // Public API Exports
 //