@jay-framework/compiler-shared 0.18.1 → 0.18.3

package/dist/index.d.ts

@@ -628,6 +628,12 @@ interface PluginManifest {
         /** Path to .jay-command metadata file (for input schema and description) */
         command?: string;
     }>;
+    /** Jay-HTML validators provided by this plugin (DL#145) */
+    validators?: Array<{
+        name: string;
+        handler: string;
+        description?: string;
+    }>;
     /** Plugin setup configuration (Design Log #87) */
     setup?: {
         /** Export name (NPM) or relative path (local) to setup handler function */
@@ -704,6 +710,69 @@ declare function resolvePluginComponent(projectRoot: string, pluginName: string,
  */
 declare function resolvePluginManifest(projectRoot: string, pluginName: string): WithValidations<PluginManifest>;
 
+interface JayHtmlValidationFinding {
+    severity: 'error' | 'warning';
+    message: string;
+    suggestion?: string;
+    element?: string;
+    attribute?: string;
+}
+interface JayHtmlValidationContext {
+    body: any;
+    filePath: string;
+    projectRoot: string;
+    contract?: {
+        name: string;
+        tags: Array<{
+            tag: string;
+            type: number[];
+            meta?: Record<string, string>;
+            tags?: any[];
+            repeated?: boolean;
+            [key: string]: any;
+        }>;
+        props?: Array<{
+            name: string;
+            required?: boolean;
+            [key: string]: any;
+        }>;
+        params?: Array<{
+            name: string;
+            kind: string;
+        }>;
+    };
+    headlessImports: Array<{
+        key?: string;
+        contractName: string;
+        contract?: JayHtmlValidationContext['contract'];
+    }>;
+}
+type JayHtmlValidatorFn = (context: JayHtmlValidationContext) => JayHtmlValidationFinding[] | Promise<JayHtmlValidationFinding[]>;
+
+interface TemplatePart {
+    kind: 'static' | 'binding';
+    value: string;
+}
+interface DataScope {
+    tags: Array<{
+        tag: string;
+        tags?: any[];
+        meta?: Record<string, string>;
+        [key: string]: any;
+    }>;
+    parent?: DataScope;
+}
+interface ResolvedBinding {
+    path: string;
+    tag?: {
+        tag: string;
+        meta?: Record<string, string>;
+        [key: string]: any;
+    };
+}
+declare function resolveBinding(bindingPath: string, scope: DataScope): ResolvedBinding;
+declare function walkElements(root: any, ctx: JayHtmlValidationContext, visitor: (el: any, scope: DataScope) => void): void;
+
 /**
  * Build-time utilities for coordinate template compilation.
  *
@@ -777,4 +846,4 @@ declare function compileForEachInstanceKeyExpr(coordinateSuffix: string, trackBy
  */
 declare function computeForEachInstanceKey(trackByValue: string, coordinateSuffix: string): string;
 
-export { type ActionManifestEntry, CSS_EXTENSION, type CompilerSourceFile, 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, JayHtmlString, 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_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, 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, resolvePluginComponent, resolvePluginManifest, resolvePrimitiveType, withOriginalTrace, withoutExtension };
+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, 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_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 };

package/dist/index.js

@@ -1595,6 +1595,74 @@ function resolvePluginManifest(projectRoot, pluginName) {
     `Plugin "${pluginName}" not found. Searched in src/plugins/${pluginName}/ and node_modules/${pluginName}/. Ensure the plugin is installed or exists in your project.`
   ]);
 }
+function resolveBinding(bindingPath, scope) {
+  const segments = bindingPath.split(".");
+  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 };
+    tags = match.tags;
+  }
+  return { path: bindingPath };
+}
+function resolveTagPath(dotPath, tags) {
+  const segments = dotPath.split(".");
+  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;
+    currentTags = match.tags;
+  }
+  return void 0;
+}
+function walkElements(root, ctx, visitor) {
+  const pageScope = {
+    tags: ctx.contract?.tags ?? []
+  };
+  doWalk(root, ctx, pageScope, visitor);
+}
+function doWalk(el, ctx, scope, visitor) {
+  let currentScope = scope;
+  const tagName = el.rawTagName?.toLowerCase();
+  if (tagName?.startsWith("jay:")) {
+    const contractName = tagName.substring(4);
+    const headless = ctx.headlessImports.find(
+      (h) => h.contractName === contractName && h.contract
+    );
+    if (headless?.contract) {
+      currentScope = {
+        tags: headless.contract.tags,
+        parent: scope
+      };
+    }
+  }
+  const forEach = el.getAttribute?.("forEach");
+  if (forEach) {
+    const arrayTag = resolveTagPath(forEach, currentScope.tags);
+    if (arrayTag?.tags) {
+      currentScope = {
+        tags: arrayTag.tags,
+        parent: currentScope
+      };
+    }
+  }
+  visitor(el, currentScope);
+  for (const child of el.childNodes ?? []) {
+    if (child.nodeType === 1) {
+      doWalk(child, ctx, currentScope, visitor);
+    }
+  }
+}
 function compileCoordinateExpr(template, varMappings) {
   if (!template.includes("$")) {
     return `'${template}'`;
@@ -1757,11 +1825,13 @@ export {
   prettify,
   prettifyHtml,
   removeComments,
+  resolveBinding,
   resolvePluginComponent,
   resolvePluginManifest,
   resolvePrimitiveType,
   u as ts,
   c as tsBridge,
+  walkElements,
   withOriginalTrace,
   withoutExtension
 };

package/package.json

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