@malloydata/render 0.0.369 → 0.0.370

package/dist/module/api/plugin-types.d.ts

@@ -8,6 +8,11 @@ export interface RenderProps {
     field: Field;
     customProps?: Record<string, unknown>;
 }
+export interface RendererValidationSpec {
+    readonly renderer: string;
+    readonly ownedPaths?: string[][];
+    readonly childOwnedPaths?: string[][];
+}
 interface BaseRenderPluginInstance<TMetadata = unknown> {
     readonly name: string;
     readonly field: Field;
@@ -17,11 +22,9 @@ interface BaseRenderPluginInstance<TMetadata = unknown> {
     beforeRender?(metadata: RenderMetadata, options: GetResultMetadataOptions): void;
     getStyleOverrides?(): Record<string, string>;
     /**
-     * Declare tag paths this plugin reads during render or interaction.
-     * Each entry is a path of tag property names, e.g. ['viz', 'title'].
-     * The framework marks these as read at registration time so they
-     * don't produce false-positive "unknown tag" warnings when the
-     * component hasn't rendered yet (e.g. virtualized off-screen).
+     * Legacy compatibility for plugins that still declare self-owned paths
+     * from the instance. New code should use factory.getValidationSpec().
+     * @deprecated Use RenderPluginFactory.getValidationSpec() instead.
      */
     getDeclaredTagPaths?(): string[][];
 }
@@ -44,6 +47,30 @@ export interface CoreVizPluginMethods {
 export type CoreVizPluginInstance<TMetadata = unknown> = SolidJSRenderPluginInstance<TMetadata> & CoreVizPluginMethods;
 export interface RenderPluginFactory<TInstance extends RenderPluginInstance = RenderPluginInstance> {
     readonly name: string;
+    /**
+     * IMPORTANT: Declare the tags this renderer OWNS, not every tag it might
+     * ever read.
+     *
+     * Own a tag here if this renderer is the authority for its meaning:
+     * - the tag is only meaningful when this renderer is active
+     * - this renderer is responsible for validating it
+     * - this renderer should suppress "unknown render tag" warnings for it
+     *
+     * This applies to:
+     * - tags on the renderer field itself
+     * - context-sensitive tags on child fields
+     *
+     * Do NOT declare globally meaningful field tags just because this renderer
+     * happens to read them during implementation. Examples: `label`, `hidden`,
+     * `description`, `column`.
+     *
+     * Rule:
+     * - if the tag would be meaningless without this renderer, declare it here
+     * - if the tag is meaningful independently of this renderer, do not
+     *
+     * Think in terms of semantic ownership, not literal runtime reads.
+     */
+    getValidationSpec?(): RendererValidationSpec;
     matches(field: Field, fieldTag: Tag, fieldType: FieldType): boolean;
     create(field: Field, pluginOptions?: unknown, modelTag?: Tag): TInstance;
 }

package/dist/module/component/renderer-validation-specs.d.ts

@@ -0,0 +1,2 @@
+import { RendererValidationSpec } from '../api/plugin-types';
+export declare function getBuiltInRendererValidationSpec(renderAs: string): RendererValidationSpec | undefined;

package/dist/module/component/tag-configs.d.ts

@@ -69,7 +69,7 @@ export interface DashboardNestConfig {
  * Run the appropriate tag resolver for a field based on its renderAs type
  * and store the result on the field. Called during registerFields().
  *
- * Also resolves cross-cutting tag properties (label, column, tooltip, break)
+ * Also resolves cross-cutting tag properties (label, column)
  * for ALL fields, ensuring all tag access happens at setup time.
  * Components use the resolved configs instead of reading tags directly.
  */