@jay-framework/compiler-jay-html 0.24.5 → 0.24.7

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { JayType, WithValidations, PluginComponentResolution, PluginManifest, JayEnumType, RefsTree, CompilerSourceFile, SourceFileFormat, JayImportLink, JayHtmlHeadMeta, TemplatePart, GenerateTarget, Imports, MainRuntimeModes, JayObjectType } from '@jay-framework/compiler-shared';
+import { JayType, WithValidations, PluginComponentResolution, PluginManifest, JayEnumType, RefsTree, JayImportLink, CompilerSourceFile, SourceFileFormat, JayHtmlHeadMeta, TemplatePart, GenerateTarget, Imports, MainRuntimeModes, JayObjectType } from '@jay-framework/compiler-shared';
 import { HTMLElement } from 'node-html-parser';
 import { ResolveTsConfigOptions } from '@jay-framework/compiler-analyze-exported-types';
 import { Coordinate } from '@jay-framework/runtime';
@@ -177,6 +177,8 @@ interface JayHeadlessImports {
     metadata?: Record<string, unknown>;
     headlessProps?: Record<string, string>;
     structural?: boolean;
+    template?: string;
+    suppressedValidations?: string[];
 }
 interface JayHtmlHeadLink {
     rel: string;
@@ -224,7 +226,7 @@ interface JayHtmlSourceFile extends CompilerSourceFile {
     clientTrackByMap?: Record<string, string>;
     headMeta?: JayHtmlHeadMeta;
     /** Per-page validation overrides from <script type="application/jay-validations">. */
-    validationOverrides?: Record<string, Record<string, boolean>>;
+    validationOverrides?: Record<string, Record<string, boolean | string[]>>;
     scripts?: JayHtmlScript[];
 }
 
@@ -232,7 +234,22 @@ declare function parseTemplateParts(value: string): TemplatePart[];
 declare function parseIsEnum(expression: string): boolean;
 declare function parseEnumValues(expression: string): string[];
 
-declare function renderRefsType(refs: RefsTree, refsType: string, generateTarget?: GenerateTarget): {
+declare function renderRefsType(refs: RefsTree, refsType: string, generateTarget?: GenerateTarget, 
+/**
+ * DL#193 Phase 3: when false, skip emitting the component-ref helper `export type` declarations
+ * (`XRef<ParentVS>` / `XRefs<ParentVS>`) and emit only the `export interface`. Used when two
+ * interfaces (single + repeated) share the same helpers — the helpers are emitted once by the
+ * companion call and re-emitting them would be a duplicate-identifier error.
+ */
+emitComponentRefHelpers?: boolean, 
+/**
+ * DL#193 Phase 3: shared set of helper identifiers (`CounterRef`, `CounterRefs`) already emitted
+ * elsewhere in the file. When provided, a helper whose identifier is already present is skipped
+ * and newly-emitted identifiers are added. This deduplicates the shared helpers across BOTH a
+ * single/repeated pair AND across multiple structural instances that embed the same inner
+ * component (each would otherwise re-declare `CounterRef` → duplicate-identifier error).
+ */
+emittedHelpers?: Set<string>): {
     imports: Imports;
     renderedRefs: string;
 };
@@ -292,21 +309,6 @@ declare function assignCoordinatesToJayHtml(jayHtml: string, headlessContractNam
  */
 declare function assignCoordinates(body: HTMLElement, options: AssignCoordinatesOptions): AssignCoordinatesResult;
 
-/**
- * Inject headfull full-stack component templates into jay-html.
- * Finds <script type="application/jay-headfull" contract="..."> tags,
- * reads each component's jay-html file, and injects the body content
- * into matching <jay:Name> tags that are empty/self-closing.
- *
- * This must be called on the raw HTML string BEFORE the slow render pipeline,
- * so that instance bindings can be resolved during pre-rendering.
- *
- * @param html - The raw jay-html content
- * @param sourceDir - Absolute path to the directory containing the jay-html file
- * @param importResolver - Resolver for reading component jay-html files
- * @returns The HTML with headfull FS templates injected (or unchanged if none found)
- */
-declare function injectHeadfullFSTemplates(html: string, sourceDir: string, importResolver: JayImportResolver): string;
 declare function parseJayFile(html: string, filename: string, filePath: string, options: ResolveTsConfigOptions, linkedContractResolver: JayImportResolver, projectRoot: string, 
 /** Optional source directory for resolving headfull FS files (jay-html, contracts).
  *  When parsing pre-rendered files, filePath is in build/pre-rendered/ but headfull
@@ -562,6 +564,12 @@ interface DiscoveredHeadlessInstance {
      * Built from ancestor slowForEach jayTrackBy values + "contractName:localIndex".
      */
     coordinate: Coordinate;
+    /**
+     * Coordinate of the nearest enclosing headless instance (DL#196). A nested instance's
+     * prop bindings resolve against this enclosing instance's resolved ViewState rather than
+     * the page ViewState. `undefined` for top-level instances (enclosing scope is the page).
+     */
+    parentCoordinate?: Coordinate;
 }
 /**
  * Resolved data for a headless component instance.
@@ -613,4 +621,4 @@ declare function resolveHeadlessInstances(preRenderedJayHtml: string, instanceDa
  */
 declare function hasSlowPhaseProperties(contract: Contract | undefined): boolean;
 
-export { type ActionDefinition, type AssignCoordinatesOptions, type AssignCoordinatesResult, type Contract, type ContractImportInfo, type ContractParam, type ContractParamKind, type ContractProp, type ContractResolver, type ContractTag, ContractTagType, type DiscoveredHeadlessInstance, type EnumToImport, type ForEachHeadlessInstance, type HeadlessContractInfo, type HeadlessInstanceDiscoveryResult, type HeadlessInstanceResolvedData, JAY_IMPORT_RESOLVER, type JayContractImportLink, type JayHtmlScript, type JayHtmlSourceFile, type JayImportResolver, type PhaseViewStates, type RenderingPhase, type ServerElementOptions, type SlowRenderInput, type SlowRenderOutput, assignCoordinates, assignCoordinatesToJayHtml, buildInstanceCoordinateKey, compileAction, compileContract, contractToAllPhaseViewStates, contractToImportsViewStateAndRefs, contractToPhaseViewState, createPhaseContract, defaultContractResolver, discoverHeadlessInstances, filterTagsByPhase, generateElementBridgeFile, generateElementDefinitionFile, generateElementFile, generateElementFileReactTarget, generateElementHydrateFile, generateSandboxRootFile, generateServerElementFile, generateTypes, getEffectivePhase, getJayHtmlImports, getLinkedContractDir, hasSlowPhaseProperties, htmlElementTagNameMap, injectHeadfullFSTemplates, isTagInPhase, loadLinkedContract, parseAction, parseContract, parseEnumValues, parseIsEnum, parseJayFile, parseTemplateParts, renderRefsType, resolveHeadlessInstances, slowRenderTransform, validateContractPhases };
+export { type ActionDefinition, type AssignCoordinatesOptions, type AssignCoordinatesResult, type Contract, type ContractImportInfo, type ContractParam, type ContractParamKind, type ContractProp, type ContractResolver, type ContractTag, ContractTagType, type DiscoveredHeadlessInstance, type EnumToImport, type ForEachHeadlessInstance, type HeadlessContractInfo, type HeadlessInstanceDiscoveryResult, type HeadlessInstanceResolvedData, JAY_IMPORT_RESOLVER, type JayContractImportLink, type JayHeadlessImports, type JayHtmlScript, type JayHtmlSourceFile, type JayImportResolver, type PhaseViewStates, type RenderingPhase, type ServerElementOptions, type SlowRenderInput, type SlowRenderOutput, assignCoordinates, assignCoordinatesToJayHtml, buildInstanceCoordinateKey, compileAction, compileContract, contractToAllPhaseViewStates, contractToImportsViewStateAndRefs, contractToPhaseViewState, createPhaseContract, defaultContractResolver, discoverHeadlessInstances, filterTagsByPhase, generateElementBridgeFile, generateElementDefinitionFile, generateElementFile, generateElementFileReactTarget, generateElementHydrateFile, generateSandboxRootFile, generateServerElementFile, generateTypes, getEffectivePhase, getJayHtmlImports, getLinkedContractDir, hasSlowPhaseProperties, htmlElementTagNameMap, isTagInPhase, loadLinkedContract, parseAction, parseContract, parseEnumValues, parseIsEnum, parseJayFile, parseTemplateParts, renderRefsType, resolveHeadlessInstances, slowRenderTransform, validateContractPhases };