@jay-framework/compiler-shared 0.9.0 → 0.11.0

package/dist/index.d.ts

@@ -31,6 +31,7 @@ declare const Import: {
     svgDynamicElement: ImportName;
     mathMLDynamicElement: ImportName;
     forEach: ImportName;
+    slowForEachItem: ImportName;
     resolved: ImportName;
     pending: ImportName;
     rejected: ImportName;
@@ -267,6 +268,114 @@ declare function getModeFromExtension(filename: string): RuntimeMode;
 declare function getJayTsFileSourcePath(filename: string): string;
 declare function withoutExtension(filename: string, extension: string): string;
 
+/**
+ * Utilities for handling Jay environment metadata in module specifiers.
+ *
+ * Jay uses query parameters to pass environment information through the import chain:
+ * - `?jay-client` / `?jay-server` - Client/server code splitting
+ * - `?jay-mainSandbox` / `?jay-workerTrusted` / `?jay-workerSandbox` - Security sandbox modes
+ *
+ * These utilities provide a consistent way to parse, add, and detect these parameters
+ * while correctly handling file extensions like `.jay-contract` and `.jay-html`.
+ */
+
+/**
+ * Environment types for Jay code splitting
+ */
+declare enum JayBuildEnvironment {
+    Client = "client",
+    Server = "server"
+}
+/**
+ * All possible Jay environment query parameter values
+ */
+type JayEnvironment = JayBuildEnvironment | RuntimeMode;
+/**
+ * Query parameter strings for build environments
+ */
+declare const JAY_QUERY_CLIENT = "?jay-client";
+declare const JAY_QUERY_SERVER = "?jay-server";
+/**
+ * Parsed module specifier with environment information separated
+ */
+interface ParsedJayModuleSpecifier {
+    /** The base path without any jay query parameters */
+    basePath: string;
+    /** The build environment (client/server) if present */
+    buildEnvironment?: JayBuildEnvironment;
+    /** The runtime mode (sandbox modes) if present */
+    runtimeMode?: RuntimeMode;
+    /** Any remaining query parameters (not jay-related) */
+    otherQueryParams: string;
+    /** The full query string for reconstruction */
+    fullQueryString: string;
+}
+/**
+ * Parse a module specifier to extract the base path and any jay environment information.
+ *
+ * @example
+ * parseJayModuleSpecifier('./component?jay-client')
+ * // { basePath: './component', buildEnvironment: 'client', ... }
+ *
+ * @example
+ * parseJayModuleSpecifier('./file.jay-contract?jay-server')
+ * // { basePath: './file.jay-contract', buildEnvironment: 'server', ... }
+ */
+declare function parseJayModuleSpecifier(specifier: string): ParsedJayModuleSpecifier;
+/**
+ * Add a build environment (client/server) to a module specifier.
+ * If the specifier already has an environment, it will be replaced.
+ *
+ * @example
+ * addBuildEnvironment('./component', 'client')
+ * // './component?jay-client'
+ *
+ * @example
+ * addBuildEnvironment('./file?existing=param', 'server')
+ * // './file?jay-server&existing=param'
+ */
+declare function addBuildEnvironment(specifier: string, environment: JayBuildEnvironment): string;
+/**
+ * Check if a module specifier has a specific extension, ignoring any query parameters.
+ * This is the query-param-aware version of the simple `string.endsWith()` check.
+ *
+ * Handles cases where .ts/.tsx may appear:
+ * - After the extension: `file.jay-html.ts`
+ * - After query params: `file.jay-html?jay-mainSandbox.ts`
+ * - Before query params: `file.jay-contract.ts?jay-client`
+ *
+ * @example
+ * hasJayExtension('./file.jay-contract?jay-client', '.jay-contract')
+ * // true
+ *
+ * @example
+ * hasJayExtension('./file.jay-html?jay-mainSandbox.ts', '.jay-html', { withTs: true })
+ * // true
+ */
+declare function hasJayExtension(specifier: string, extension: string, { withTs }?: {
+    withTs?: boolean;
+}): boolean;
+/**
+ * Get the base path of a module specifier without any query parameters.
+ *
+ * @example
+ * getBasePath('./component?jay-client')
+ * // './component'
+ */
+declare function getBasePath(specifier: string): string;
+/**
+ * Check if a module specifier has a build environment (client or server).
+ */
+declare function hasBuildEnvironment(specifier: string): boolean;
+/**
+ * Get the build environment from a module specifier, if present.
+ */
+declare function getBuildEnvironment(specifier: string): JayBuildEnvironment | undefined;
+/**
+ * Check if a module specifier is a local file (relative path).
+ */
+declare function isLocalModule(specifier: string): boolean;
+
 type JayValidations = Array<string>;
 declare class WithValidations<Value> {
     val?: Value;
@@ -351,4 +460,92 @@ declare function prettify(code: string, options?: prettier.Options): Promise<str
 declare function prettifyHtml(html: string): string;
 declare function removeComments(code: string): string;
 
-export { CSS_EXTENSION, type CompilerSourceFile, GenerateTarget, type GenericTypescriptSourceFile, Import, type ImportName, type ImportedRefsTree, Imports, ImportsFor, JAY_4_REACT, JAY_COMPONENT, JAY_CONTRACT_DTS_EXTENSION, JAY_CONTRACT_EXTENSION, JAY_DTS_EXTENSION, JAY_EXTENSION, JAY_FULLSTACK_COMPONENTS, JAY_QUERY_MAIN_SANDBOX, JAY_QUERY_MAIN_SANDBOX_TS, JAY_QUERY_PREFIX, JAY_QUERY_WORKER_SANDBOX, JAY_QUERY_WORKER_SANDBOX_TS, JAY_QUERY_WORKER_TRUSTED, JAY_QUERY_WORKER_TRUSTED_TS, JAY_RUNTIME, JAY_SECURE, JAY_TS_EXTENSION, JayArrayType, JayAtomicType, JayBoolean, JayComponentApiMember, JayComponentType, JayDate, JayElementConstructorType, JayElementType, JayEnumType, JayErrorType, JayHTMLType, type JayImportLink, type JayImportName, JayImportedType, JayNumber, JayObjectType, JayPromiseType, JayRecursiveType, JayString, type JayType, JayTypeAlias, JayTypeKind, JayUnionType, JayUnknown, type JayValidations, MAKE_JAY_4_REACT_COMPONENT, MAKE_JAY_COMPONENT, MAKE_JAY_TSX_COMPONENT, type MainRuntimeModes, REACT, type RecursiveRegion, type Ref, type RefsTree, RenderFragment, RuntimeMode, SourceFileFormat, TSX_EXTENSION, TS_EXTENSION, WithValidations, checkValidationErrors, equalJayTypes, getJayTsFileSourcePath, getMode, getModeFileExtension, getModeFromExtension, hasExtension, hasJayModeExtension, hasRefs, isArrayType, isAtomicType, isComponentType, isCurrencyType, isDateWithTimezoneType, isElementConstructorType, isElementType, isEnumType, isHTMLType, isImportedType, isObjectType, isPromiseType, isRecursiveType, isTypeAliasType, isUnionType, mergeRefsTrees, mkRef, mkRefsTree, nestRefs, prettify, prettifyHtml, removeComments, resolvePrimitiveType, withOriginalTrace, withoutExtension };
+/**
+ * Plugin initialization configuration.
+ *
+ * For the `makeJayInit` pattern:
+ * - undefined: Auto-discover `lib/init.ts` (for uncompiled/local plugins)
+ * - string: Export name for the JayInit constant (for compiled/NPM packages)
+ *
+ * @example
+ * ```yaml
+ * # For compiled NPM packages - specify the export name
+ * name: my-plugin
+ * init: myPluginInit
+ * ```
+ */
+type PluginInitConfig = string;
+/**
+ * Plugin manifest structure from plugin.yaml
+ */
+interface PluginManifest {
+    name: string;
+    version?: string;
+    module?: string;
+    contracts?: Array<{
+        name: string;
+        contract: string;
+        component: string;
+        description?: string;
+    }>;
+    dynamic_contracts?: {
+        generator: string;
+        component: string;
+        prefix: string;
+    };
+    /** Named exports from plugin backend bundle that are JayAction instances */
+    actions?: string[];
+    /** Plugin initialization configuration */
+    init?: PluginInitConfig;
+}
+/**
+ * Result of resolving a plugin component
+ */
+interface PluginComponentResolution {
+    /** Absolute path to the contract file */
+    contractPath: string;
+    /** Absolute path to the component file (without extension) - used for local plugins */
+    componentPath: string;
+    /** Component name to import */
+    componentName: string;
+    /** Whether this is an NPM package (vs local plugin) */
+    isNpmPackage: boolean;
+    /** For NPM packages: the package name to import from */
+    packageName?: string;
+}
+/**
+ * Loads and parses a plugin.yaml file
+ *
+ * @param pluginDir - Absolute path to plugin directory
+ * @returns Parsed plugin manifest or null if not found/invalid
+ */
+declare function loadPluginManifest(pluginDir: string): PluginManifest | null;
+/**
+ * Resolves a plugin component from a local plugin directory (src/plugins/)
+ *
+ * @param projectRoot - Project root directory
+ * @param pluginName - Name of the plugin
+ * @param contractName - Name of the contract to resolve
+ * @returns Resolution result with validation messages
+ */
+declare function resolveLocalPlugin(projectRoot: string, pluginName: string, contractName: string): WithValidations<PluginComponentResolution> | null;
+/**
+ * Resolves a plugin component from an NPM package (node_modules/)
+ *
+ * @param projectRoot - Project root directory
+ * @param pluginName - Name of the NPM package
+ * @param contractName - Name of the contract to resolve
+ * @returns Resolution result with validation messages
+ */
+declare function resolveNpmPlugin(projectRoot: string, pluginName: string, contractName: string): WithValidations<PluginComponentResolution> | null;
+/**
+ * Resolves a plugin component, trying local plugins first, then NPM packages
+ *
+ * @param projectRoot - Project root directory
+ * @param pluginName - Name of the plugin
+ * @param contractName - Name of the contract to resolve
+ * @returns Resolution result with validation messages
+ */
+declare function resolvePluginComponent(projectRoot: string, pluginName: string, contractName: string): WithValidations<PluginComponentResolution>;
+
+export { CSS_EXTENSION, type CompilerSourceFile, GenerateTarget, type GenericTypescriptSourceFile, Import, type ImportName, type ImportedRefsTree, Imports, ImportsFor, JAY_4_REACT, JAY_COMPONENT, JAY_CONTRACT_DTS_EXTENSION, JAY_CONTRACT_EXTENSION, JAY_DTS_EXTENSION, JAY_EXTENSION, JAY_FULLSTACK_COMPONENTS, JAY_QUERY_CLIENT, JAY_QUERY_MAIN_SANDBOX, JAY_QUERY_MAIN_SANDBOX_TS, JAY_QUERY_PREFIX, JAY_QUERY_SERVER, JAY_QUERY_WORKER_SANDBOX, JAY_QUERY_WORKER_SANDBOX_TS, JAY_QUERY_WORKER_TRUSTED, JAY_QUERY_WORKER_TRUSTED_TS, JAY_RUNTIME, JAY_SECURE, JAY_TS_EXTENSION, JayArrayType, JayAtomicType, JayBoolean, JayBuildEnvironment, JayComponentApiMember, JayComponentType, JayDate, JayElementConstructorType, JayElementType, JayEnumType, type JayEnvironment, JayErrorType, JayHTMLType, type JayImportLink, type JayImportName, JayImportedType, JayNumber, JayObjectType, JayPromiseType, JayRecursiveType, JayString, type JayType, JayTypeAlias, JayTypeKind, JayUnionType, JayUnknown, type JayValidations, MAKE_JAY_4_REACT_COMPONENT, MAKE_JAY_COMPONENT, MAKE_JAY_TSX_COMPONENT, type MainRuntimeModes, type ParsedJayModuleSpecifier, type PluginComponentResolution, type PluginInitConfig, type PluginManifest, REACT, type RecursiveRegion, type Ref, type RefsTree, RenderFragment, RuntimeMode, SourceFileFormat, TSX_EXTENSION, TS_EXTENSION, WithValidations, addBuildEnvironment, checkValidationErrors, equalJayTypes, getBasePath, getBuildEnvironment, getJayTsFileSourcePath, getMode, getModeFileExtension, getModeFromExtension, hasBuildEnvironment, hasExtension, hasJayExtension, hasJayModeExtension, hasRefs, isArrayType, isAtomicType, isComponentType, isCurrencyType, isDateWithTimezoneType, isElementConstructorType, isElementType, isEnumType, isHTMLType, isImportedType, isLocalModule, isObjectType, isPromiseType, isRecursiveType, isTypeAliasType, isUnionType, loadPluginManifest, mergeRefsTrees, mkRef, mkRefsTree, nestRefs, parseJayModuleSpecifier, prettify, prettifyHtml, removeComments, resolveLocalPlugin, resolveNpmPlugin, resolvePluginComponent, resolvePrimitiveType, withOriginalTrace, withoutExtension };

package/dist/index.js

@@ -6,6 +6,9 @@ var __publicField = (obj, key, value) => {
 };
 import * as prettier from "prettier";
 import jsBeautify from "js-beautify";
+import fs from "fs";
+import path from "path";
+import YAML from "yaml";
 import { createRequire } from "module";
 const JAY_EXTENSION = ".jay-html";
 const CSS_EXTENSION = ".css";
@@ -152,6 +155,12 @@ const Import = {
     1
     /* implementation */
   ),
+  slowForEachItem: importStatementFragment(
+    JAY_RUNTIME,
+    "slowForEachItem",
+    1
+    /* implementation */
+  ),
   resolved: importStatementFragment(
     JAY_RUNTIME,
     "resolved",
@@ -750,6 +759,133 @@ function withoutExtension(filename, extension) {
   }
   return filename.slice(0, -extension.length);
 }
+var JayBuildEnvironment = /* @__PURE__ */ ((JayBuildEnvironment2) => {
+  JayBuildEnvironment2["Client"] = "client";
+  JayBuildEnvironment2["Server"] = "server";
+  return JayBuildEnvironment2;
+})(JayBuildEnvironment || {});
+const JAY_QUERY_CLIENT = `${JAY_QUERY_PREFIX}${"client"}`;
+const JAY_QUERY_SERVER = `${JAY_QUERY_PREFIX}${"server"}`;
+const JAY_QUERY_PATTERNS = [
+  // Build environments
+  {
+    pattern: `${JAY_QUERY_PREFIX}${"client"}`,
+    buildEnv: "client"
+    /* Client */
+  },
+  {
+    pattern: `${JAY_QUERY_PREFIX}${"server"}`,
+    buildEnv: "server"
+    /* Server */
+  },
+  // Runtime modes (with .ts suffix)
+  {
+    pattern: `${JAY_QUERY_PREFIX}${RuntimeMode.MainSandbox}${TS_EXTENSION}`,
+    runtimeMode: RuntimeMode.MainSandbox
+  },
+  {
+    pattern: `${JAY_QUERY_PREFIX}${RuntimeMode.WorkerTrusted}${TS_EXTENSION}`,
+    runtimeMode: RuntimeMode.WorkerTrusted
+  },
+  {
+    pattern: `${JAY_QUERY_PREFIX}${RuntimeMode.WorkerSandbox}${TS_EXTENSION}`,
+    runtimeMode: RuntimeMode.WorkerSandbox
+  },
+  // Runtime modes (without .ts suffix)
+  {
+    pattern: `${JAY_QUERY_PREFIX}${RuntimeMode.MainSandbox}`,
+    runtimeMode: RuntimeMode.MainSandbox
+  },
+  {
+    pattern: `${JAY_QUERY_PREFIX}${RuntimeMode.WorkerTrusted}`,
+    runtimeMode: RuntimeMode.WorkerTrusted
+  },
+  {
+    pattern: `${JAY_QUERY_PREFIX}${RuntimeMode.WorkerSandbox}`,
+    runtimeMode: RuntimeMode.WorkerSandbox
+  }
+];
+function parseJayModuleSpecifier(specifier) {
+  const queryIndex = specifier.indexOf("?");
+  if (queryIndex === -1) {
+    return {
+      basePath: specifier,
+      otherQueryParams: "",
+      fullQueryString: ""
+    };
+  }
+  const basePath = specifier.substring(0, queryIndex);
+  const fullQueryString = specifier.substring(queryIndex);
+  let buildEnvironment;
+  let runtimeMode;
+  let remainingQuery = fullQueryString;
+  for (const { pattern, buildEnv, runtimeMode: rtMode } of JAY_QUERY_PATTERNS) {
+    if (remainingQuery.includes(pattern)) {
+      if (buildEnv)
+        buildEnvironment = buildEnv;
+      if (rtMode)
+        runtimeMode = rtMode;
+      remainingQuery = remainingQuery.replace(pattern, "");
+    }
+  }
+  const otherQueryParams = remainingQuery.replace(/^\?&/, "?").replace(/&&/g, "&").replace(/&$/, "").replace(/^\?$/, "");
+  return {
+    basePath,
+    buildEnvironment,
+    runtimeMode,
+    otherQueryParams,
+    fullQueryString
+  };
+}
+function addBuildEnvironment(specifier, environment) {
+  const parsed = parseJayModuleSpecifier(specifier);
+  const jayQuery = `${JAY_QUERY_PREFIX}${environment}`;
+  let result = parsed.basePath + jayQuery;
+  if (parsed.runtimeMode) {
+    result += `${JAY_QUERY_PREFIX}${parsed.runtimeMode}`;
+  }
+  if (parsed.otherQueryParams) {
+    if (parsed.otherQueryParams.startsWith("?")) {
+      result += "&" + parsed.otherQueryParams.substring(1);
+    } else if (parsed.otherQueryParams) {
+      result += "&" + parsed.otherQueryParams;
+    }
+  }
+  return result;
+}
+function hasJayExtension(specifier, extension, { withTs = false } = {}) {
+  let normalizedSpecifier = specifier;
+  if (withTs) {
+    if (specifier.endsWith(TS_EXTENSION)) {
+      normalizedSpecifier = specifier.slice(0, -TS_EXTENSION.length);
+    } else if (specifier.endsWith(TSX_EXTENSION)) {
+      normalizedSpecifier = specifier.slice(0, -TSX_EXTENSION.length);
+    }
+  }
+  let { basePath } = parseJayModuleSpecifier(normalizedSpecifier);
+  if (withTs) {
+    if (basePath.endsWith(TS_EXTENSION)) {
+      basePath = basePath.slice(0, -TS_EXTENSION.length);
+    } else if (basePath.endsWith(TSX_EXTENSION)) {
+      basePath = basePath.slice(0, -TSX_EXTENSION.length);
+    }
+  }
+  return basePath.endsWith(extension) && basePath.length > extension.length;
+}
+function getBasePath(specifier) {
+  return parseJayModuleSpecifier(specifier).basePath;
+}
+function hasBuildEnvironment(specifier) {
+  const { buildEnvironment } = parseJayModuleSpecifier(specifier);
+  return buildEnvironment !== void 0;
+}
+function getBuildEnvironment(specifier) {
+  return parseJayModuleSpecifier(specifier).buildEnvironment;
+}
+function isLocalModule(specifier) {
+  const { basePath } = parseJayModuleSpecifier(specifier);
+  return basePath.startsWith("./") || basePath.startsWith("../");
+}
 class WithValidations {
   constructor(val, validations = []) {
     __publicField(this, "val");
@@ -826,12 +962,12 @@ function hasRefs(refs, includingAutoRefs) {
   const allRefs = (ref) => true;
   return refs.refs.filter(includingAutoRefs ? allRefs : onlyNonAutoRefs).length > 0 || refs.imported || Object.entries(refs.children).map(([ref, refs2]) => hasRefs(refs2, includingAutoRefs)).reduce((prev, curr) => prev || curr, false);
 }
-function nestRefs(path, renderFragment) {
+function nestRefs(path2, renderFragment) {
   let refs = renderFragment.refs;
-  for (let index = path.length - 1; index >= 0; --index) {
-    if (path[index] === ".")
+  for (let index = path2.length - 1; index >= 0; --index) {
+    if (path2[index] === ".")
       continue;
-    refs = mkRefsTree([], { [path[index]]: refs }, refs.repeated);
+    refs = mkRefsTree([], { [path2[index]]: refs }, refs.repeated);
   }
   return new RenderFragment(
     renderFragment.rendered,
@@ -953,6 +1089,157 @@ function removeComments(code) {
     (line) => !(line.includes("// @ts-expect-error ") || line.includes("// @ts-ignore") || line.includes("{/* @ts-ignore */}"))
   ).join("\n");
 }
+const require2 = createRequire(import.meta.url);
+function loadPluginManifest(pluginDir) {
+  const pluginYamlPath = path.join(pluginDir, "plugin.yaml");
+  if (!fs.existsSync(pluginYamlPath)) {
+    return null;
+  }
+  try {
+    const yamlContent = fs.readFileSync(pluginYamlPath, "utf-8");
+    return YAML.parse(yamlContent);
+  } catch (error) {
+    return null;
+  }
+}
+function resolveLocalPlugin(projectRoot, pluginName, contractName) {
+  const localPluginPath = path.join(projectRoot, "src/plugins", pluginName);
+  const pluginYamlPath = path.join(localPluginPath, "plugin.yaml");
+  if (!fs.existsSync(localPluginPath)) {
+    return null;
+  }
+  if (!fs.existsSync(pluginYamlPath)) {
+    return new WithValidations(null, [
+      `Local plugin "${pluginName}" found at ${localPluginPath} but plugin.yaml is missing`
+    ]);
+  }
+  const manifest = loadPluginManifest(localPluginPath);
+  if (!manifest) {
+    return new WithValidations(null, [
+      `Failed to parse plugin.yaml for local plugin "${pluginName}" at ${pluginYamlPath}`
+    ]);
+  }
+  if (!manifest.contracts || manifest.contracts.length === 0) {
+    return new WithValidations(null, [
+      `Local plugin "${pluginName}" has no contracts defined in plugin.yaml`
+    ]);
+  }
+  const contract = manifest.contracts.find((c2) => c2.name === contractName);
+  if (!contract) {
+    const availableContracts = manifest.contracts.map((c2) => c2.name).join(", ");
+    return new WithValidations(null, [
+      `Contract "${contractName}" not found in local plugin "${pluginName}". Available contracts: ${availableContracts}`
+    ]);
+  }
+  const componentModule = manifest.module || "index.js";
+  const componentPath = path.join(localPluginPath, componentModule);
+  return new WithValidations(
+    {
+      contractPath: path.join(localPluginPath, contract.contract),
+      componentPath,
+      componentName: contract.component,
+      // This is the exported member name
+      isNpmPackage: false
+    },
+    []
+  );
+}
+function resolveNpmPlugin(projectRoot, pluginName, contractName) {
+  let pluginYamlPath;
+  try {
+    pluginYamlPath = require2.resolve(`${pluginName}/plugin.yaml`, {
+      paths: [projectRoot]
+    });
+  } catch (error) {
+    return new WithValidations(null, [
+      `NPM package "${pluginName}" not found or plugin.yaml is not exported. Is this a Jay Stack plugin?`
+    ]);
+  }
+  const npmPluginPath = path.dirname(pluginYamlPath);
+  if (!fs.existsSync(pluginYamlPath)) {
+    return new WithValidations(null, [
+      `NPM package "${pluginName}" found but plugin.yaml is missing. Is this a Jay Stack plugin?`
+    ]);
+  }
+  const manifest = loadPluginManifest(npmPluginPath);
+  if (!manifest) {
+    return new WithValidations(null, [
+      `Failed to parse plugin.yaml for NPM package "${pluginName}" at ${pluginYamlPath}`
+    ]);
+  }
+  if (!manifest.contracts || manifest.contracts.length === 0) {
+    return new WithValidations(null, [
+      `NPM package "${pluginName}" has no contracts defined in plugin.yaml`
+    ]);
+  }
+  const contract = manifest.contracts.find((c2) => c2.name === contractName);
+  if (!contract) {
+    const availableContracts = manifest.contracts.map((c2) => c2.name).join(", ");
+    return new WithValidations(null, [
+      `Contract "${contractName}" not found in NPM package "${pluginName}". Available contracts: ${availableContracts}`
+    ]);
+  }
+  const packageJsonPath = path.join(npmPluginPath, "package.json");
+  let componentPath;
+  let contractPath;
+  if (fs.existsSync(packageJsonPath)) {
+    try {
+      const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
+      const packageName = packageJson.name;
+      const moduleName = manifest.module || packageName;
+      if ((moduleName === packageName || !manifest.module) && packageJson.exports && packageJson.exports["."]) {
+        const mainExport = packageJson.exports["."];
+        const mainPath = typeof mainExport === "string" ? mainExport : mainExport.default || mainExport.import;
+        componentPath = path.join(npmPluginPath, mainPath);
+      } else {
+        componentPath = path.join(npmPluginPath, "dist/index.js");
+      }
+      const contractSpec = contract.contract;
+      const contractExportKey = "./" + contractSpec;
+      if (packageJson.exports && packageJson.exports[contractExportKey]) {
+        const exportPath = packageJson.exports[contractExportKey];
+        contractPath = path.join(npmPluginPath, exportPath);
+      } else {
+        const possiblePaths = [
+          path.join(npmPluginPath, "dist", contractSpec),
+          path.join(npmPluginPath, "lib", contractSpec),
+          path.join(npmPluginPath, contractSpec)
+        ];
+        contractPath = possiblePaths.find((p) => fs.existsSync(p)) || possiblePaths[0];
+      }
+    } catch (error) {
+      componentPath = path.join(npmPluginPath, "dist/index.js");
+      contractPath = path.join(npmPluginPath, "dist", contract.contract);
+    }
+  } else {
+    componentPath = path.join(npmPluginPath, "dist/index.js");
+    contractPath = path.join(npmPluginPath, "dist", contract.contract);
+  }
+  return new WithValidations(
+    {
+      contractPath,
+      componentPath,
+      componentName: contract.component,
+      // This is the exported member name
+      isNpmPackage: true,
+      packageName: pluginName
+    },
+    []
+  );
+}
+function resolvePluginComponent(projectRoot, pluginName, contractName) {
+  const localResult = resolveLocalPlugin(projectRoot, pluginName, contractName);
+  if (localResult !== null) {
+    return localResult;
+  }
+  const npmResult = resolveNpmPlugin(projectRoot, pluginName, contractName);
+  if (npmResult !== null) {
+    return npmResult;
+  }
+  return new WithValidations(null, [
+    `Plugin "${pluginName}" not found. Searched in src/plugins/${pluginName}/ and node_modules/${pluginName}/. Ensure the plugin is installed or exists in your project.`
+  ]);
+}
 const s = createRequire(import.meta.url), e = s("typescript"), u = e, c = new Proxy(e, {
   get(t, r) {
     return t[r];
@@ -974,9 +1261,11 @@ export {
   JAY_DTS_EXTENSION,
   JAY_EXTENSION,
   JAY_FULLSTACK_COMPONENTS,
+  JAY_QUERY_CLIENT,
   JAY_QUERY_MAIN_SANDBOX,
   JAY_QUERY_MAIN_SANDBOX_TS,
   JAY_QUERY_PREFIX,
+  JAY_QUERY_SERVER,
   JAY_QUERY_WORKER_SANDBOX,
   JAY_QUERY_WORKER_SANDBOX_TS,
   JAY_QUERY_WORKER_TRUSTED,
@@ -987,6 +1276,7 @@ export {
   JayArrayType,
   JayAtomicType,
   JayBoolean,
+  JayBuildEnvironment,
   JayComponentApiMember,
   JayComponentType,
   JayDate,
@@ -1015,14 +1305,19 @@ export {
   TSX_EXTENSION,
   TS_EXTENSION,
   WithValidations,
+  addBuildEnvironment,
   checkValidationErrors,
   equalJayTypes,
+  getBasePath,
+  getBuildEnvironment,
   getJayTsFileSourcePath,
   getMode,
   getModeFileExtension,
   getModeFromExtension,
   i as getTs,
+  hasBuildEnvironment,
   hasExtension,
+  hasJayExtension,
   hasJayModeExtension,
   hasRefs,
   isArrayType,
@@ -1035,18 +1330,24 @@ export {
   isEnumType,
   isHTMLType,
   isImportedType,
+  isLocalModule,
   isObjectType,
   isPromiseType,
   isRecursiveType,
   isTypeAliasType,
   isUnionType,
+  loadPluginManifest,
   mergeRefsTrees,
   mkRef,
   mkRefsTree,
   nestRefs,
+  parseJayModuleSpecifier,
   prettify,
   prettifyHtml,
   removeComments,
+  resolveLocalPlugin,
+  resolveNpmPlugin,
+  resolvePluginComponent,
   resolvePrimitiveType,
   u as ts,
   c as tsBridge,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jay-framework/compiler-shared",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "type": "module",
   "description": "",
   "license": "Apache-2.0",
@@ -25,10 +25,10 @@
   },
   "author": "",
   "dependencies": {
-    "@jay-framework/component": "^0.9.0",
-    "@jay-framework/runtime": "^0.9.0",
-    "@jay-framework/secure": "^0.9.0",
-    "@jay-framework/typescript-bridge": "^0.4.0",
+    "@jay-framework/component": "^0.11.0",
+    "@jay-framework/runtime": "^0.11.0",
+    "@jay-framework/secure": "^0.11.0",
+    "@jay-framework/typescript-bridge": "^0.6.0",
     "@types/js-yaml": "^4.0.9",
     "change-case": "^4.1.2",
     "js-beautify": "^1.14.11",
@@ -41,7 +41,7 @@
   },
   "devDependencies": {
     "@caiogondim/strip-margin": "^1.0.0",
-    "@jay-framework/dev-environment": "^0.9.0",
+    "@jay-framework/dev-environment": "^0.11.0",
     "@testing-library/jest-dom": "^6.2.0",
     "@types/js-beautify": "^1",
     "@types/node": "^20.11.5",