@jay-framework/compiler-shared 0.22.2 → 0.23.1

package/dist/index.d.ts

@@ -629,6 +629,10 @@ interface PluginManifest {
         component: string;
         /** Human-readable description */
         description?: string;
+        /** When true, route is dev-server tooling only (e.g. plugin settings UI).
+         *  Exposed in RouteInfo for consumers like AIditor to filter from page pickers.
+         *  Future: excluded from production builds. See Design Log #171. */
+        devOnly?: boolean;
     }>;
     /** CLI commands exposed by this plugin (Design Log #142).
      *  Run via `jay-stack run <plugin>/<command>`. */
@@ -869,4 +873,11 @@ declare function compileForEachInstanceKeyExpr(coordinateSuffix: string, trackBy
  */
 declare function computeForEachInstanceKey(trackByValue: string, coordinateSuffix: string): string;
 
-export { type ActionManifestEntry, CSS_EXTENSION, type CompilerSourceFile, type DataScope, type DynamicContractConfig, GenerateTarget, type GenericTypescriptSourceFile, Import, type ImportName, type ImportedRefsTree, Imports, ImportsFor, JAY_4_REACT, JAY_ACTION_DTS_EXTENSION, JAY_ACTION_EXTENSION, JAY_COMPONENT, JAY_CONTRACT_DTS_EXTENSION, JAY_CONTRACT_EXTENSION, JAY_DTS_EXTENSION, JAY_EXTENSION, JAY_FULLSTACK_COMPONENTS, JAY_QUERY_CLIENT, JAY_QUERY_HYDRATE, 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_SSR_RUNTIME, JAY_STACK_CLIENT_RUNTIME, JAY_TS_EXTENSION, JayArrayType, JayAtomicType, JayBoolean, JayBuildEnvironment, JayComponentApiMember, JayComponentType, JayDate, JayElementConstructorType, JayElementType, JayEnumType, type JayEnvironment, JayErrorType, JayFileType, JayHTMLType, type JayHtmlHeadMeta, JayHtmlString, type JayHtmlValidationContext, type JayHtmlValidationFinding, type JayHtmlValidatorFn, type JayImportLink, type JayImportName, JayImportedType, JayNumber, JayObjectType, JayOptionalType, JayPromiseType, JayRecordType, JayRecursiveType, JayString, type JayType, JayTypeAlias, JayTypeKind, JayUnionType, JayUnknown, type JayValidations, type JsonSchemaProperty, LOCAL_PLUGIN_PATH, MAKE_JAY_4_REACT_COMPONENT, MAKE_JAY_COMPONENT, MAKE_JAY_STACK_COMPONENT, MAKE_JAY_TSX_COMPONENT, type MainRuntimeModes, type ParsedJayModuleSpecifier, type PluginComponentResolution, type PluginInitConfig, type PluginManifest, REACT, type RecursiveRegion, type Ref, type RefsTree, RenderFragment, type ResolvedBinding, RuntimeMode, SourceFileFormat, TSX_EXTENSION, TS_EXTENSION, type TemplatePart, WithValidations, addBuildEnvironment, checkValidationErrors, compileCoordinateExpr, compileForEachInstanceKeyExpr, computeForEachInstanceKey, equalJayTypes, findDynamicContract, getBasePath, getBuildEnvironment, getJayTsFileSourcePath, getMode, getModeFileExtension, getModeFromExtension, hasBuildEnvironment, hasExtension, hasJayExtension, hasJayModeExtension, hasRefs, isArrayType, isAtomicType, isComponentType, isCurrencyType, isDateWithTimezoneType, isElementConstructorType, isElementType, isEnumType, isHTMLType, isHtmlStringType, isImportedType, isLocalModule, isObjectType, isOptionalType, isPromiseType, isRecordType, isRecursiveType, isStaticCoordinate, isTypeAliasType, isUnionType, jayTypeToJsonSchema, loadPluginManifest, mergeRefsTrees, mkRef, mkRefsTree, nestRefs, normalizeActionEntry, parseJayModuleSpecifier, prettify, prettifyHtml, removeComments, resolveBinding, resolvePluginComponent, resolvePluginManifest, resolvePrimitiveType, walkElements, withOriginalTrace, withoutExtension };
+/**
+ * camelCase that preserves leading underscores.
+ * The standard camelCase from 'change-case' strips them
+ * (e.g., '_id' becomes 'id'), which breaks contract tag names.
+ */
+declare function camelCase(str: string): string;
+
+export { type ActionManifestEntry, CSS_EXTENSION, type CompilerSourceFile, type DataScope, type DynamicContractConfig, GenerateTarget, type GenericTypescriptSourceFile, Import, type ImportName, type ImportedRefsTree, Imports, ImportsFor, JAY_4_REACT, JAY_ACTION_DTS_EXTENSION, JAY_ACTION_EXTENSION, JAY_COMPONENT, JAY_CONTRACT_DTS_EXTENSION, JAY_CONTRACT_EXTENSION, JAY_DTS_EXTENSION, JAY_EXTENSION, JAY_FULLSTACK_COMPONENTS, JAY_QUERY_CLIENT, JAY_QUERY_HYDRATE, 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_SSR_RUNTIME, JAY_STACK_CLIENT_RUNTIME, JAY_TS_EXTENSION, JayArrayType, JayAtomicType, JayBoolean, JayBuildEnvironment, JayComponentApiMember, JayComponentType, JayDate, JayElementConstructorType, JayElementType, JayEnumType, type JayEnvironment, JayErrorType, JayFileType, JayHTMLType, type JayHtmlHeadMeta, JayHtmlString, type JayHtmlValidationContext, type JayHtmlValidationFinding, type JayHtmlValidatorFn, type JayImportLink, type JayImportName, JayImportedType, JayNumber, JayObjectType, JayOptionalType, JayPromiseType, JayRecordType, JayRecursiveType, JayString, type JayType, JayTypeAlias, JayTypeKind, JayUnionType, JayUnknown, type JayValidations, type JsonSchemaProperty, LOCAL_PLUGIN_PATH, MAKE_JAY_4_REACT_COMPONENT, MAKE_JAY_COMPONENT, MAKE_JAY_STACK_COMPONENT, MAKE_JAY_TSX_COMPONENT, type MainRuntimeModes, type ParsedJayModuleSpecifier, type PluginComponentResolution, type PluginInitConfig, type PluginManifest, REACT, type RecursiveRegion, type Ref, type RefsTree, RenderFragment, type ResolvedBinding, RuntimeMode, SourceFileFormat, TSX_EXTENSION, TS_EXTENSION, type TemplatePart, WithValidations, addBuildEnvironment, camelCase, checkValidationErrors, compileCoordinateExpr, compileForEachInstanceKeyExpr, computeForEachInstanceKey, equalJayTypes, findDynamicContract, getBasePath, getBuildEnvironment, getJayTsFileSourcePath, getMode, getModeFileExtension, getModeFromExtension, hasBuildEnvironment, hasExtension, hasJayExtension, hasJayModeExtension, hasRefs, isArrayType, isAtomicType, isComponentType, isCurrencyType, isDateWithTimezoneType, isElementConstructorType, isElementType, isEnumType, isHTMLType, isHtmlStringType, isImportedType, isLocalModule, isObjectType, isOptionalType, isPromiseType, isRecordType, isRecursiveType, isStaticCoordinate, isTypeAliasType, isUnionType, jayTypeToJsonSchema, loadPluginManifest, mergeRefsTrees, mkRef, mkRefsTree, nestRefs, normalizeActionEntry, parseJayModuleSpecifier, prettify, prettifyHtml, removeComments, resolveBinding, resolvePluginComponent, resolvePluginManifest, resolvePrimitiveType, walkElements, withOriginalTrace, withoutExtension };

package/dist/index.js

@@ -1,15 +1,13 @@
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField = (obj, key, value) => {
-  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-  return value;
-};
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : 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";
+import { camelCase as camelCase$1 } from "change-case";
 const JAY_EXTENSION = ".jay-html";
 const CSS_EXTENSION = ".css";
 const JAY_CONTRACT_EXTENSION = ".jay-contract";
@@ -535,8 +533,7 @@ class Imports {
       if (this.imports[importName.index] && importName.usage.includes(importsFor)) {
         if (moduleImportStatements.has(importName.module))
           moduleImportStatements.get(importName.module).push(importName.statement);
-        else
-          moduleImportStatements.set(importName.module, [importName.statement]);
+        else moduleImportStatements.set(importName.module, [importName.statement]);
       }
     }
     const modulesToImport = [...moduleImportStatements.keys()].sort(
@@ -783,10 +780,8 @@ function isDateWithTimezoneType(aType) {
   return aType.kind === 0 && aType.name === "DateWithTimezone";
 }
 function equalJayTypes(a, b) {
-  if (a.name !== b.name)
-    return false;
-  if (a instanceof JayAtomicType && b instanceof JayAtomicType)
-    return a.name === b.name;
+  if (a.name !== b.name) return false;
+  if (a instanceof JayAtomicType && b instanceof JayAtomicType) return a.name === b.name;
   else if (a instanceof JayEnumType && b instanceof JayEnumType)
     return a.values.length === b.values.length && a.values.reduce(
       (res, a_val, currentIndex) => res && a_val === b.values[currentIndex],
@@ -796,14 +791,11 @@ function equalJayTypes(a, b) {
     return equalJayTypes(a.itemType, b.itemType);
   else if (a instanceof JayRecordType && b instanceof JayRecordType)
     return equalJayTypes(a.itemType, b.itemType);
-  else if (a instanceof JayTypeAlias && b instanceof JayTypeAlias)
-    return true;
-  else if (a instanceof JayHTMLType && b instanceof JayHTMLType)
-    return true;
+  else if (a instanceof JayTypeAlias && b instanceof JayTypeAlias) return true;
+  else if (a instanceof JayHTMLType && b instanceof JayHTMLType) return true;
   else if (a instanceof JayImportedType && b instanceof JayImportedType)
     return equalJayTypes(a.type, b.type);
-  else if (a instanceof JayElementType && b instanceof JayElementType)
-    return true;
+  else if (a instanceof JayElementType && b instanceof JayElementType) return true;
   else if (a instanceof JayElementConstructorType && b instanceof JayElementConstructorType)
     return a.typeName === b.typeName;
   else if (a instanceof JayComponentType && b instanceof JayComponentType)
@@ -823,8 +815,7 @@ function equalJayTypes(a, b) {
     return equalJayTypes(a.itemType, b.itemType);
   } else if (a instanceof JayRecursiveType && b instanceof JayRecursiveType) {
     return a.referencePath === b.referencePath;
-  } else
-    ;
+  } else ;
 }
 function jayTypeToJsonSchema(type) {
   if (isOptionalType(type)) {
@@ -1023,12 +1014,9 @@ function parseJayModuleSpecifier(specifier) {
     isHydrate: hydrate
   } of JAY_QUERY_PATTERNS) {
     if (remainingQuery.includes(pattern)) {
-      if (buildEnv)
-        buildEnvironment = buildEnv;
-      if (rtMode)
-        runtimeMode = rtMode;
-      if (hydrate)
-        isHydrate = true;
+      if (buildEnv) buildEnvironment = buildEnv;
+      if (rtMode) runtimeMode = rtMode;
+      if (hydrate) isHydrate = true;
       remainingQuery = remainingQuery.replace(pattern, "");
     }
   }
@@ -1099,10 +1087,8 @@ class WithValidations {
     this.validations = validations;
   }
   map(func) {
-    if (this.val !== void 0)
-      return new WithValidations(func(this.val), this.validations);
-    else
-      return new WithValidations(void 0, this.validations);
+    if (this.val !== void 0) return new WithValidations(func(this.val), this.validations);
+    else return new WithValidations(void 0, this.validations);
   }
   async mapAsync(func) {
     if (this.val !== void 0) {
@@ -1116,8 +1102,7 @@ class WithValidations {
     if (this.val !== void 0) {
       let that = func(this.val);
       return new WithValidations(that.val, [...this.validations, ...that.validations]);
-    } else
-      return new WithValidations(void 0, this.validations);
+    } else return new WithValidations(void 0, this.validations);
   }
   async flatMapAsync(func) {
     if (this.val !== void 0) {
@@ -1206,8 +1191,7 @@ function hasRefs(refs, includingAutoRefs) {
 function nestRefs(path2, renderFragment) {
   let refs = renderFragment.refs;
   for (let index = path2.length - 1; index >= 0; --index) {
-    if (path2[index] === ".")
-      continue;
+    if (path2[index] === ".") continue;
     refs = mkRefsTree([], { [path2[index]]: refs }, refs.repeated);
   }
   return new RenderFragment(
@@ -1227,8 +1211,7 @@ function mkRefsTree(refs, children, repeated = false, refsTypeName, repeatedRefs
       repeated,
       imported: { refsTypeName, repeatedRefsTypeName }
     };
-  else
-    return { kind: "refTree", refs, children, repeated };
+  else return { kind: "refTree", refs, children, repeated };
 }
 function mkRef(ref, originalName, constName, repeated, autoRef, viewStateType, elementType) {
   return {
@@ -1330,7 +1313,7 @@ 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);
+const require$1 = createRequire(import.meta.url);
 const LOCAL_PLUGIN_PATH = "src/plugins";
 function normalizeActionEntry(entry) {
   if (typeof entry === "string") {
@@ -1434,7 +1417,7 @@ function resolveLocalPlugin(projectRoot, pluginName, contractName) {
 function resolveNpmPluginManifest(projectRoot, pluginName) {
   let pluginYamlPath;
   try {
-    pluginYamlPath = require2.resolve(`${pluginName}/plugin.yaml`, {
+    pluginYamlPath = require$1.resolve(`${pluginName}/plugin.yaml`, {
       paths: [projectRoot]
     });
   } catch (error) {
@@ -1469,7 +1452,7 @@ function resolveNpmPlugin(projectRoot, pluginName, contractName) {
   if (!manifestWithValidations.val || manifestWithValidations.validations.length > 0)
     return new WithValidations(null, manifestWithValidations.validations);
   const manifest = manifestWithValidations.val;
-  const pluginYamlPath = require2.resolve(`${pluginName}/plugin.yaml`, {
+  const pluginYamlPath = require$1.resolve(`${pluginName}/plugin.yaml`, {
     paths: [projectRoot]
   });
   const npmPluginPath = path.dirname(pluginYamlPath);
@@ -1602,12 +1585,9 @@ function resolveBinding(bindingPath, scope) {
   let tags = scope.tags;
   for (let i2 = 0; i2 < segments.length; i2++) {
     const match = tags.find((t) => t.tag === segments[i2]);
-    if (!match)
-      return { path: bindingPath };
-    if (i2 === segments.length - 1)
-      return { path: bindingPath, tag: match };
-    if (!match.tags)
-      return { path: bindingPath };
+    if (!match) return { path: bindingPath };
+    if (i2 === segments.length - 1) return { path: bindingPath, tag: match };
+    if (!match.tags) return { path: bindingPath };
     tags = match.tags;
   }
   return { path: bindingPath };
@@ -1617,12 +1597,9 @@ function resolveTagPath(dotPath, tags) {
   let currentTags = tags;
   for (let i2 = 0; i2 < segments.length; i2++) {
     const match = currentTags.find((t) => t.tag === segments[i2]);
-    if (!match)
-      return void 0;
-    if (i2 === segments.length - 1)
-      return match;
-    if (!match.tags)
-      return void 0;
+    if (!match) return void 0;
+    if (i2 === segments.length - 1) return match;
+    if (!match.tags) return void 0;
     currentTags = match.tags;
   }
   return void 0;
@@ -1709,6 +1686,22 @@ function compileForEachInstanceKeyExpr(coordinateSuffix, trackByExpr) {
 function computeForEachInstanceKey(trackByValue, coordinateSuffix) {
   return [trackByValue, coordinateSuffix].toString();
 }
+function camelCase(str) {
+  let leadingUnderscores = 0;
+  for (const char of str) {
+    if (char === "_") {
+      leadingUnderscores++;
+    } else {
+      break;
+    }
+  }
+  if (leadingUnderscores === 0) {
+    return camelCase$1(str);
+  }
+  const withoutLeadingUnderscores = str.slice(leadingUnderscores);
+  const camelCased = camelCase$1(withoutLeadingUnderscores);
+  return "_".repeat(leadingUnderscores) + camelCased;
+}
 const s = createRequire(import.meta.url), e = s("typescript"), u = e, c = new Proxy(e, {
   get(t, r) {
     return t[r];
@@ -1786,6 +1779,7 @@ export {
   TS_EXTENSION,
   WithValidations,
   addBuildEnvironment,
+  camelCase,
   checkValidationErrors,
   compileCoordinateExpr,
   compileForEachInstanceKeyExpr,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jay-framework/compiler-shared",
-  "version": "0.22.2",
+  "version": "0.23.1",
   "type": "module",
   "description": "",
   "license": "Apache-2.0",
@@ -25,10 +25,10 @@
   },
   "author": "",
   "dependencies": {
-    "@jay-framework/component": "^0.22.2",
-    "@jay-framework/runtime": "^0.22.2",
-    "@jay-framework/secure": "^0.22.2",
-    "@jay-framework/typescript-bridge": "^0.22.2",
+    "@jay-framework/component": "^0.23.1",
+    "@jay-framework/runtime": "^0.23.1",
+    "@jay-framework/secure": "^0.23.1",
+    "@jay-framework/typescript-bridge": "^0.23.1",
     "@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.22.2",
+    "@jay-framework/dev-environment": "^0.23.1",
     "@testing-library/jest-dom": "^6.2.0",
     "@types/js-beautify": "^1",
     "@types/node": "^20.11.5",