@jay-framework/compiler-shared 0.19.5 → 0.19.7

package/dist/index.d.ts

@@ -114,6 +114,7 @@ declare const JAY_STACK_CLIENT_RUNTIME = "@jay-framework/stack-client-runtime";
 declare const JAY_SSR_RUNTIME = "@jay-framework/ssr-runtime";
 declare const REACT = "react";
 declare const MAKE_JAY_COMPONENT = "makeJayComponent";
+declare const MAKE_JAY_STACK_COMPONENT = "makeJayStackComponent";
 declare const MAKE_JAY_TSX_COMPONENT = "makeJayTsxComponent";
 declare const MAKE_JAY_4_REACT_COMPONENT = "jay4react";
 
@@ -194,7 +195,8 @@ declare class JayComponentApiMember {
 declare class JayComponentType implements JayType {
     readonly name: string;
     readonly api: Array<JayComponentApiMember>;
-    constructor(name: string, api: Array<JayComponentApiMember>);
+    readonly fullStack: boolean;
+    constructor(name: string, api: Array<JayComponentApiMember>, fullStack?: boolean);
     readonly kind = JayTypeKind.component;
 }
 declare class JayObjectType implements JayType {
@@ -568,6 +570,10 @@ interface DynamicContractConfig {
      *  When the generator returns multiple contracts: used as prefix (e.g., "list" → "list/recipes").
      *  When the generator returns a single contract: the name can be omitted, using just the prefix as the contract name (e.g., "product-page"). */
     prefix: string;
+    /** Head tags this component provides dynamically via phaseOutput (DL#148).
+     *  Used by validators to suppress missing-title/description warnings.
+     *  Values: "title", "meta:description", "meta:og:title", "link:canonical", etc. */
+    headTags?: string[];
 }
 /**
  * Plugin manifest structure from plugin.yaml
@@ -584,6 +590,10 @@ interface PluginManifest {
         contract: string;
         component: string;
         description?: string;
+        /** Head tags this component provides dynamically via phaseOutput (DL#148).
+         *  Used by validators to suppress missing-title/description warnings.
+         *  Values: "title", "meta:description", "meta:og:title", "link:canonical", etc. */
+        headTags?: string[];
     }>;
     dynamic_contracts?: DynamicContractConfig | DynamicContractConfig[];
     /** Named exports from plugin backend bundle that are JayAction instances.
@@ -710,6 +720,30 @@ declare function resolvePluginComponent(projectRoot: string, pluginName: string,
  */
 declare function resolvePluginManifest(projectRoot: string, pluginName: string): WithValidations<PluginManifest>;
 
+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;
+
 interface JayHtmlValidationFinding {
     severity: 'error' | 'warning';
     message: string;
@@ -718,16 +752,16 @@ interface JayHtmlValidationFinding {
     attribute?: string;
 }
 interface JayHtmlHeadMeta {
-    title?: string;
+    title?: TemplatePart[];
     meta: Array<{
         name?: string;
         property?: string;
-        content: string;
+        content: TemplatePart[];
     }>;
     links: Array<{
         rel: string;
-        href: string;
-        [key: string]: string;
+        href: TemplatePart[];
+        [key: string]: any;
     }>;
 }
 interface JayHtmlValidationContext {
@@ -759,34 +793,11 @@ interface JayHtmlValidationContext {
         key?: string;
         contractName: string;
         contract?: JayHtmlValidationContext['contract'];
+        providedHeadTags?: string[];
     }>;
 }
 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.
  *
@@ -860,4 +871,4 @@ 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_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 };
+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 };

package/dist/index.js

@@ -27,6 +27,7 @@ const JAY_STACK_CLIENT_RUNTIME = "@jay-framework/stack-client-runtime";
 const JAY_SSR_RUNTIME = "@jay-framework/ssr-runtime";
 const REACT = "react";
 const MAKE_JAY_COMPONENT = "makeJayComponent";
+const MAKE_JAY_STACK_COMPONENT = "makeJayStackComponent";
 const MAKE_JAY_TSX_COMPONENT = "makeJayTsxComponent";
 const MAKE_JAY_4_REACT_COMPONENT = "jay4react";
 var ImportsFor = /* @__PURE__ */ ((ImportsFor2) => {
@@ -650,10 +651,11 @@ class JayComponentApiMember {
   }
 }
 class JayComponentType {
-  constructor(name, api) {
+  constructor(name, api, fullStack = false) {
     __publicField(this, "kind", 7);
     this.name = name;
     this.api = api;
+    this.fullStack = fullStack;
   }
 }
 class JayObjectType {
@@ -1774,6 +1776,7 @@ export {
   LOCAL_PLUGIN_PATH,
   MAKE_JAY_4_REACT_COMPONENT,
   MAKE_JAY_COMPONENT,
+  MAKE_JAY_STACK_COMPONENT,
   MAKE_JAY_TSX_COMPONENT,
   REACT,
   RenderFragment,

package/package.json

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