canicode 0.10.5 → 0.11.1

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 import { GetFileResponse, Node } from '@figma/rest-api-spec';
 
-var version = "0.10.5";
+var version = "0.11.1";
 
 declare const SeveritySchema: z.ZodEnum<{
     blocking: "blocking";
@@ -13,17 +13,40 @@ type Severity = z.infer<typeof SeveritySchema>;
 declare const SEVERITY_WEIGHT: Record<Severity, number>;
 declare const SEVERITY_LABELS: Record<Severity, string>;
 
-declare const CategorySchema: z.ZodEnum<{
-    "pixel-critical": "pixel-critical";
-    "responsive-critical": "responsive-critical";
-    "code-quality": "code-quality";
-    "token-management": "token-management";
-    semantic: "semantic";
-    interaction: "interaction";
+/**
+ * #402 shared output-channel vocabulary.
+ * Detection stays rule-based; output channel and persistence intent vary by
+ * consumer payload (score/transient vs annotation/durable).
+ */
+declare const DetectionSchema: z.ZodLiteral<"rule-based">;
+declare const OutputChannelSchema: z.ZodEnum<{
+    score: "score";
+    annotation: "annotation";
 }>;
-type Category = z.infer<typeof CategorySchema>;
-declare const CATEGORIES: ("pixel-critical" | "responsive-critical" | "code-quality" | "token-management" | "semantic" | "interaction")[];
-declare const CATEGORY_LABELS: Record<Category, string>;
+declare const PersistenceIntentSchema: z.ZodEnum<{
+    transient: "transient";
+    durable: "durable";
+}>;
+type Detection = z.infer<typeof DetectionSchema>;
+type OutputChannel = z.infer<typeof OutputChannelSchema>;
+type PersistenceIntent = z.infer<typeof PersistenceIntentSchema>;
+/**
+ * #406 rule purpose classification.
+ * - `violation`: score-primary. Node is violating a best-practice expectation;
+ *   fixing the violation removes the rule fire. Gotcha question is secondary
+ *   context about how to resolve the violation.
+ * - `info-collection`: annotation-primary. Node is not necessarily "wrong,"
+ *   but implementation-critical context is absent from Figma (e.g. click
+ *   target, interaction states). Gotcha question is the primary output;
+ *   score impact is intentionally minimal (typically -1 or 0).
+ *
+ * Detection stays `rule-based` in both cases — see ADR-017.
+ */
+declare const RulePurposeSchema: z.ZodEnum<{
+    violation: "violation";
+    "info-collection": "info-collection";
+}>;
+type RulePurpose = z.infer<typeof RulePurposeSchema>;
 
 /**
  * Figma node types required for analysis
@@ -308,6 +331,51 @@ declare const AnalysisFileSchema: z.ZodObject<{
 }, z.core.$strip>;
 type AnalysisFile = z.infer<typeof AnalysisFileSchema>;
 
+/**
+ * #404: Analysis scope — what the user is asking canicode to reason about.
+ *
+ * - `page`: full screen / section / layout. Container frames are
+ *   responsible for bounds; repetition detection is meaningful; rules
+ *   that assume "this is a self-contained screen" apply.
+ * - `component`: standalone reusable UI unit (COMPONENT / COMPONENT_SET
+ *   / INSTANCE analyzed in isolation). Root FILL is the design contract
+ *   rather than a missing bound; repetition detection is generally a
+ *   false signal because a component is itself the unit of reuse.
+ *
+ * The enum is intentionally two-valued; multi-scope analysis (analyzing
+ * a page and its inner components in one run) is explicitly out of scope
+ * per the issue. Each rule decides how (or whether) to switch on `scope`;
+ * this PR only carries the context. Rule-level consumption lands in
+ * follow-up PRs (e.g. #403 for `missing-size-constraint`).
+ */
+declare const AnalysisScopeSchema: z.ZodEnum<{
+    page: "page";
+    component: "component";
+}>;
+type AnalysisScope = z.infer<typeof AnalysisScopeSchema>;
+/**
+ * Deterministically detect analysis scope from the root node type. Returns
+ * `"component"` for `COMPONENT` / `COMPONENT_SET` / `INSTANCE` roots, and
+ * `"page"` for everything else.
+ *
+ * The CLI / MCP layer may override this with an explicit `scope` flag when
+ * the user knows the heuristic mis-detects (e.g. analyzing a FRAME that
+ * ships as a standalone design-system example rather than a screen).
+ */
+declare function detectAnalysisScope(rootNode: AnalysisNode): AnalysisScope;
+
+declare const CategorySchema: z.ZodEnum<{
+    "pixel-critical": "pixel-critical";
+    "responsive-critical": "responsive-critical";
+    "code-quality": "code-quality";
+    "token-management": "token-management";
+    semantic: "semantic";
+    interaction: "interaction";
+}>;
+type Category = z.infer<typeof CategorySchema>;
+declare const CATEGORIES: ("pixel-critical" | "responsive-critical" | "code-quality" | "token-management" | "semantic" | "interaction")[];
+declare const CATEGORY_LABELS: Record<Category, string>;
+
 /**
  * Rule definition - static metadata (does not change)
  */
@@ -359,6 +427,28 @@ interface RuleContext {
     siblings?: AnalysisNode[] | undefined;
     /** Per-analysis shared state. Created fresh for each analysis run, eliminating module-level mutable state. */
     analysisState: Map<string, unknown>;
+    /**
+     * #404: Scope of the analysis root (`page` vs `component`). Rules use
+     * this to decide whether expectations like "container must define
+     * bounds" or "repetition should become a component" apply. Constant for
+     * all nodes in a single analysis — whether the CURRENT node happens to
+     * be a `COMPONENT` descendant of a page root is already signalled by
+     * `componentDepth`, not by re-deriving scope per node.
+     */
+    scope: AnalysisScope;
+    /**
+     * #403: Figma node type of the analysis root, captured once in
+     * `RuleEngine.analyze`. This is an *axis orthogonal to* `scope`:
+     * `scope === "component"` does not tell a rule whether the root is a
+     * `COMPONENT`/`COMPONENT_SET` (component being audited) or an
+     * `INSTANCE` (component being used, possibly with overrides). The
+     * `missing-size-constraint` redesign needs that distinction so the
+     * gotcha question can ask the right thing — "intentionally
+     * non-responsive?" vs "override intended? original may be FILL". The
+     * value is the raw Figma node type string (no new enum) so it stays in
+     * sync with `AnalysisNode.type` without a translation layer.
+     */
+    rootNodeType: string;
 }
 /**
  * Get or initialize per-analysis state for a rule.
@@ -522,6 +612,10 @@ declare const McpAnalyzeResponseSchema: z.ZodObject<{
     fileName: z.ZodString;
     nodeCount: z.ZodNumber;
     maxDepth: z.ZodNumber;
+    scope: z.ZodEnum<{
+        page: "page";
+        component: "component";
+    }>;
     issueCount: z.ZodNumber;
     isReadyForCodeGen: z.ZodBoolean;
     blockingIssueCount: z.ZodNumber;
@@ -577,6 +671,17 @@ declare const McpAnalyzeResponseSchema: z.ZodObject<{
     issuesByRule: z.ZodRecord<z.ZodString, z.ZodNumber>;
     issues: z.ZodArray<z.ZodObject<{
         ruleId: z.ZodString;
+        detection: z.ZodLiteral<"rule-based">;
+        outputChannel: z.ZodEnum<{
+            score: "score";
+        }>;
+        persistenceIntent: z.ZodEnum<{
+            transient: "transient";
+        }>;
+        purpose: z.ZodEnum<{
+            violation: "violation";
+            "info-collection": "info-collection";
+        }>;
         subType: z.ZodOptional<z.ZodString>;
         severity: z.ZodEnum<{
             blocking: "blocking";
@@ -606,9 +711,9 @@ type InstanceContext = z.infer<typeof InstanceContextSchema>;
  * declared as a Zod enum here so MCP responses validate end-to-end.
  */
 declare const RuleApplyStrategySchema: z.ZodEnum<{
+    annotation: "annotation";
     "property-mod": "property-mod";
     "structural-mod": "structural-mod";
-    annotation: "annotation";
     "auto-fix": "auto-fix";
 }>;
 type RuleApplyStrategy = z.infer<typeof RuleApplyStrategySchema>;
@@ -620,10 +725,33 @@ type RuleApplyStrategy = z.infer<typeof RuleApplyStrategySchema>;
 declare const AnnotationPropertySchema: z.ZodObject<{
     type: z.ZodString;
 }, z.core.$strip>;
+/**
+ * #402: Gotcha output is generated by a rule-based detection pass but flows
+ * to the annotation channel (not the score channel). Answers are durable
+ * context intended to survive beyond a single re-analysis cycle.
+ */
+declare const GotchaDetectionSchema: z.ZodLiteral<"rule-based">;
+declare const GotchaOutputChannelSchema: z.ZodEnum<{
+    annotation: "annotation";
+}>;
+declare const GotchaPersistenceIntentSchema: z.ZodEnum<{
+    durable: "durable";
+}>;
 declare const GotchaSurveyQuestionSchema: z.ZodObject<{
     nodeId: z.ZodString;
     nodeName: z.ZodString;
     ruleId: z.ZodString;
+    detection: z.ZodLiteral<"rule-based">;
+    outputChannel: z.ZodEnum<{
+        annotation: "annotation";
+    }>;
+    persistenceIntent: z.ZodEnum<{
+        durable: "durable";
+    }>;
+    purpose: z.ZodEnum<{
+        violation: "violation";
+        "info-collection": "info-collection";
+    }>;
     severity: z.ZodEnum<{
         blocking: "blocking";
         risk: "risk";
@@ -640,9 +768,9 @@ declare const GotchaSurveyQuestionSchema: z.ZodObject<{
         sourceComponentName: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     applyStrategy: z.ZodEnum<{
+        annotation: "annotation";
         "property-mod": "property-mod";
         "structural-mod": "structural-mod";
-        annotation: "annotation";
         "auto-fix": "auto-fix";
     }>;
     targetProperty: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
@@ -675,6 +803,17 @@ declare const SurveyQuestionBatchSchema: z.ZodObject<{
         nodeId: z.ZodString;
         nodeName: z.ZodString;
         ruleId: z.ZodString;
+        detection: z.ZodLiteral<"rule-based">;
+        outputChannel: z.ZodEnum<{
+            annotation: "annotation";
+        }>;
+        persistenceIntent: z.ZodEnum<{
+            durable: "durable";
+        }>;
+        purpose: z.ZodEnum<{
+            violation: "violation";
+            "info-collection": "info-collection";
+        }>;
         severity: z.ZodEnum<{
             blocking: "blocking";
             risk: "risk";
@@ -691,9 +830,9 @@ declare const SurveyQuestionBatchSchema: z.ZodObject<{
             sourceComponentName: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
         applyStrategy: z.ZodEnum<{
+            annotation: "annotation";
             "property-mod": "property-mod";
             "structural-mod": "structural-mod";
-            annotation: "annotation";
             "auto-fix": "auto-fix";
         }>;
         targetProperty: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
@@ -723,6 +862,17 @@ declare const SurveyQuestionGroupSchema: z.ZodObject<{
             nodeId: z.ZodString;
             nodeName: z.ZodString;
             ruleId: z.ZodString;
+            detection: z.ZodLiteral<"rule-based">;
+            outputChannel: z.ZodEnum<{
+                annotation: "annotation";
+            }>;
+            persistenceIntent: z.ZodEnum<{
+                durable: "durable";
+            }>;
+            purpose: z.ZodEnum<{
+                violation: "violation";
+                "info-collection": "info-collection";
+            }>;
             severity: z.ZodEnum<{
                 blocking: "blocking";
                 risk: "risk";
@@ -739,9 +889,9 @@ declare const SurveyQuestionGroupSchema: z.ZodObject<{
                 sourceComponentName: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>;
             applyStrategy: z.ZodEnum<{
+                annotation: "annotation";
                 "property-mod": "property-mod";
                 "structural-mod": "structural-mod";
-                annotation: "annotation";
                 "auto-fix": "auto-fix";
             }>;
             targetProperty: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
@@ -773,6 +923,17 @@ declare const GroupedSurveySchema: z.ZodObject<{
                 nodeId: z.ZodString;
                 nodeName: z.ZodString;
                 ruleId: z.ZodString;
+                detection: z.ZodLiteral<"rule-based">;
+                outputChannel: z.ZodEnum<{
+                    annotation: "annotation";
+                }>;
+                persistenceIntent: z.ZodEnum<{
+                    durable: "durable";
+                }>;
+                purpose: z.ZodEnum<{
+                    violation: "violation";
+                    "info-collection": "info-collection";
+                }>;
                 severity: z.ZodEnum<{
                     blocking: "blocking";
                     risk: "risk";
@@ -789,9 +950,9 @@ declare const GroupedSurveySchema: z.ZodObject<{
                     sourceComponentName: z.ZodOptional<z.ZodString>;
                 }, z.core.$strip>>;
                 applyStrategy: z.ZodEnum<{
+                    annotation: "annotation";
                     "property-mod": "property-mod";
                     "structural-mod": "structural-mod";
-                    annotation: "annotation";
                     "auto-fix": "auto-fix";
                 }>;
                 targetProperty: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
@@ -826,6 +987,17 @@ declare const GotchaSurveySchema: z.ZodObject<{
         nodeId: z.ZodString;
         nodeName: z.ZodString;
         ruleId: z.ZodString;
+        detection: z.ZodLiteral<"rule-based">;
+        outputChannel: z.ZodEnum<{
+            annotation: "annotation";
+        }>;
+        persistenceIntent: z.ZodEnum<{
+            durable: "durable";
+        }>;
+        purpose: z.ZodEnum<{
+            violation: "violation";
+            "info-collection": "info-collection";
+        }>;
         severity: z.ZodEnum<{
             blocking: "blocking";
             risk: "risk";
@@ -842,9 +1014,9 @@ declare const GotchaSurveySchema: z.ZodObject<{
             sourceComponentName: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
         applyStrategy: z.ZodEnum<{
+            annotation: "annotation";
             "property-mod": "property-mod";
             "structural-mod": "structural-mod";
-            annotation: "annotation";
             "auto-fix": "auto-fix";
         }>;
         targetProperty: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
@@ -872,6 +1044,17 @@ declare const GotchaSurveySchema: z.ZodObject<{
                     nodeId: z.ZodString;
                     nodeName: z.ZodString;
                     ruleId: z.ZodString;
+                    detection: z.ZodLiteral<"rule-based">;
+                    outputChannel: z.ZodEnum<{
+                        annotation: "annotation";
+                    }>;
+                    persistenceIntent: z.ZodEnum<{
+                        durable: "durable";
+                    }>;
+                    purpose: z.ZodEnum<{
+                        violation: "violation";
+                        "info-collection": "info-collection";
+                    }>;
                     severity: z.ZodEnum<{
                         blocking: "blocking";
                         risk: "risk";
@@ -888,9 +1071,9 @@ declare const GotchaSurveySchema: z.ZodObject<{
                         sourceComponentName: z.ZodOptional<z.ZodString>;
                     }, z.core.$strip>>;
                     applyStrategy: z.ZodEnum<{
+                        annotation: "annotation";
                         "property-mod": "property-mod";
                         "structural-mod": "structural-mod";
-                        annotation: "annotation";
                         "auto-fix": "auto-fix";
                     }>;
                     targetProperty: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
@@ -911,25 +1094,28 @@ declare const GotchaSurveySchema: z.ZodObject<{
 }, z.core.$strip>;
 type GotchaSurvey = z.infer<typeof GotchaSurveySchema>;
 
-/**
- * Acknowledgment marker — surfaced from a Figma Dev Mode annotation that
- * canicode itself wrote during a roundtrip. When the analysis pipeline
- * receives a list of acknowledgments, matching `(nodeId, ruleId)` issues are
- * flagged `acknowledged: true` and contribute half their normal weight to
- * the density score (#371).
- *
- * This contract is consumed by:
- * - The MCP `analyze` tool (`acknowledgments?: Acknowledgment[]` input)
- * - The CLI `analyze --acknowledgments <path>` flag
- * - `RuleEngineOptions.acknowledgments`
- *
- * It is produced by the Plugin-API helper
- * `extractAcknowledgmentsFromNode` / `readCanicodeAcknowledgments`
- * (see `src/core/roundtrip/read-acknowledgments.ts`).
- */
 declare const AcknowledgmentSchema: z.ZodObject<{
     nodeId: z.ZodString;
     ruleId: z.ZodString;
+    intent: z.ZodOptional<z.ZodObject<{
+        field: z.ZodString;
+        value: z.ZodUnknown;
+        scope: z.ZodEnum<{
+            instance: "instance";
+            definition: "definition";
+        }>;
+    }, z.core.$strip>>;
+    sceneWriteOutcome: z.ZodOptional<z.ZodObject<{
+        result: z.ZodEnum<{
+            unknown: "unknown";
+            succeeded: "succeeded";
+            "silent-ignored": "silent-ignored";
+            "api-rejected": "api-rejected";
+            "user-declined-propagation": "user-declined-propagation";
+        }>;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    codegenDirective: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type Acknowledgment = z.infer<typeof AcknowledgmentSchema>;
 
@@ -972,6 +1158,13 @@ interface AnalysisResult {
     maxDepth: number;
     nodeCount: number;
     analyzedAt: string;
+    /**
+     * #404: Resolved analysis scope (`page` vs `component`). Either detected
+     * from the root node type or taken from the caller's explicit override.
+     * Propagated to MCP / JSON output so downstream consumers (code-gen,
+     * reports) can branch the same way rules do.
+     */
+    scope: AnalysisScope;
 }
 /**
  * Options for the rule engine
@@ -991,6 +1184,15 @@ interface RuleEngineOptions {
      * (`123-456`) or Plugin-API form (`123:456`) — both normalize to `:`.
      */
     acknowledgments?: Acknowledgment[];
+    /**
+     * #404: Explicit scope override. When omitted, the engine auto-detects
+     * from the analysis root's node type via `detectAnalysisScope`. Supply
+     * this when the caller knows the heuristic would mis-detect — e.g. a
+     * FRAME that happens to be a design-system demo (component scope) or a
+     * COMPONENT_SET being audited as part of a full page inventory (page
+     * scope).
+     */
+    scope?: AnalysisScope;
 }
 /**
  * Rule engine for analyzing Figma files
@@ -1003,6 +1205,7 @@ declare class RuleEngine {
     private excludeNamePattern;
     private excludeNodeTypes;
     private acknowledgments;
+    private scopeOverride;
     constructor(options?: RuleEngineOptions);
     /**
      * Analyze a Figma file and return issues
@@ -1430,6 +1633,12 @@ declare class RuleRegistry {
      * Register a rule
      */
     register(rule: Rule): void;
+    /**
+     * Remove a rule by ID. Primarily used by tests that register a
+     * throwaway rule and need to restore the registry afterwards. Returns
+     * `true` if the rule was present.
+     */
+    unregister(id: RuleId): boolean;
     /**
      * Get a rule by ID
      */
@@ -1482,6 +1691,31 @@ interface AnnotationProperty {
  * - semantic: ΔV < 2%, negligible code difference — naming and semantic issues
  */
 declare const RULE_ID_CATEGORY: Record<RuleId, Category>;
+/**
+ * #406: Classifies each rule by primary output channel.
+ *
+ * - `violation` (default): score-primary. Rule fires when a best-practice
+ *   expectation is broken; the score penalty is the main signal, gotcha
+ *   questions are secondary context on how to resolve the violation.
+ * - `info-collection`: annotation-primary. Rule fires on nodes that need
+ *   implementation context Figma cannot encode natively (click target,
+ *   state variants). The gotcha annotation IS the output; score impact is
+ *   kept minimal (-1 range) so presence/absence of the annotation — not
+ *   the penalty — differentiates designs.
+ *
+ * Sibling map (mirrors `RULE_ID_CATEGORY`) so existing `RuleDefinition`
+ * call sites don't need to be touched. Look up via `getRulePurpose`.
+ */
+declare const RULE_PURPOSE: Record<RuleId, RulePurpose>;
+/**
+ * Resolve a rule's purpose. Accepts `string` (not `RuleId`) because the
+ * purpose concept must work for out-of-tree custom rules added via the
+ * config loader — callers pass `issue.violation.ruleId` which is a plain
+ * string. Defaults to `"violation"` for unknown ids. Keeping the cast
+ * inside this helper (rather than forcing every caller to do `as RuleId`)
+ * makes the fallback semantically honest.
+ */
+declare function getRulePurpose(ruleId: string): RulePurpose;
 /**
  * Central configuration for all rules.
  * Scores based on ablation experiment + AI implementation interview (#200):
@@ -1718,6 +1952,10 @@ declare const CalibrationConfigSchema: z.ZodObject<{
     }>>;
     outputPath: z.ZodDefault<z.ZodString>;
     runDir: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodEnum<{
+        page: "page";
+        component: "component";
+    }>>;
 }, z.core.$strip>;
 type CalibrationConfig = z.infer<typeof CalibrationConfigSchema>;
 type CalibrationConfigInput = z.input<typeof CalibrationConfigSchema>;
@@ -2107,4 +2345,4 @@ declare class ActivityLogger {
     getLogPath(): string;
 }
 
-export { ALL_STRIP_TYPES, ActivityLogger, type AnalysisAgentInput, type AnalysisAgentOutput, type AnalysisFile, AnalysisFileSchema, type AnalysisIssue, type AnalysisNode, AnalysisNodeSchema, type AnalysisNodeType, AnalysisNodeTypeSchema, type AnalysisResult, AnnotationPropertySchema, CATEGORIES, CATEGORY_LABELS, type CalibrationConfig, type CalibrationConfigInput, CalibrationConfigSchema, type CalibrationRun, type CalibrationStatus, CalibrationStatusSchema, type Category, CategorySchema, type CategoryScore, type CategoryScoreResult, CategoryScoreSchema, type Confidence, ConfidenceSchema, type ConversionRecord, ConversionRecordSchema, DEPTH_WEIGHT_CATEGORIES, DESIGN_TREE_INFO_TYPES, type DesignTreeInfoType, type DesignTreeOptions, type DesignTreeResult, type DesignTreeStripType, type Difficulty, DifficultySchema, type EvaluationAgentInput, type EvaluationAgentOutput, FigmaClient, FigmaClientError, type FigmaClientOptions, FigmaFileLoadError, type FigmaUrlInfo, FigmaUrlInfoSchema, FigmaUrlParseError, type GapAnalyzerOutput, GapAnalyzerOutputSchema, type GapEntry, GapEntrySchema, type GetFileNodesResponse, type GotchaApplyResolution, type GotchaApplyStrategy, type GotchaSurvey, type GotchaSurveyQuestion, GotchaSurveyQuestionSchema, GotchaSurveySchema, type Grade, type GridChildAlign, GridChildAlignSchema, type GroupedSurvey, GroupedSurveySchema, type InstanceChildIdParts, type InstanceContext, InstanceContextSchema, type Issue, IssueSchema, type LayoutAlign, LayoutAlignSchema, type LayoutConstraint, LayoutConstraintSchema, type LayoutMode, LayoutModeSchema, type LayoutPositioning, LayoutPositioningSchema, type LayoutWrap, LayoutWrapSchema, type McpAnalyzeResponse, McpAnalyzeResponseSchema, type MismatchCase, MismatchCaseSchema, type MismatchType, MismatchTypeSchema, type NewRuleProposal, NewRuleProposalSchema, type NodeIssueDetail, type NodeIssueSummary, NodeIssueSummarySchema, type OverflowDirection, OverflowDirectionSchema, type Preset, RULE_ANNOTATION_PROPERTIES, RULE_CONFIGS, RULE_ID_CATEGORY, type Report, type ReportMetadata, ReportMetadataSchema, ReportSchema, type Rule, type RuleApplyStrategy, RuleApplyStrategySchema, type RuleCheckFn, type RuleConfig, RuleConfigSchema, type RuleContext, type RuleDefinition, RuleDefinitionSchema, RuleEngine, type RuleEngineOptions, type RuleFailure, type RuleId, RuleImpactAssessmentSchema, type RuleRelatedStruggle, RuleRelatedStruggleSchema, type RuleViolation, SEVERITY_LABELS, SEVERITY_WEIGHT, type SamplingStrategy, SamplingStrategySchema, type ScoreAdjustment, ScoreAdjustmentSchema, type ScoreReport, type Severity, SeveritySchema, type StripDeltaForEval, type StripDeltaResult, StripDeltaResultSchema, StripDeltasArraySchema, StripTypeEnum, type SurveyQuestionBatch, SurveyQuestionBatchSchema, type SurveyQuestionGroup, SurveyQuestionGroupSchema, type TuningAgentInput, type TuningAgentOutput, type UncoveredStruggle, UncoveredStruggleSchema, UncoveredStrugglesInputSchema, version as VERSION, type VisualCompareCliOptions, VisualCompareCliOptionsSchema, absolutePositionInAutoLayout, analyzeFile, buildFigmaDeepLink, buildResultJson, calculateScores, collectComponentIds, collectInteractionDestinationIds, createRuleEngine, deepNesting, defineRule, detachedInstance, extractRuleScores, fixedSizeInAutoLayout, formatScoreSummary, generateCalibrationReport, generateDesignTree, generateDesignTreeWithStats, getAnalysisState, getAnnotationProperties, getCategoryLabel, getConfigsWithPreset, getRuleOption, getSeverityLabel, gradeToClassName, inconsistentNamingConvention, irregularSpacing, isInstanceChildNodeId, isReadyForCodeGen, loadFigmaFileFromJson, missingComponent, missingInteractionState, missingPrototype, missingSizeConstraint, noAutoLayout, nonLayoutContainer, nonSemanticName, nonStandardNaming, parseFigmaJson, parseFigmaUrl, parseInstanceChildNodeId, rawValue, resolveComponentDefinitions, resolveGotchaApplyTarget, resolveInteractionDestinations, ruleRegistry, runAnalysisAgent, runCalibrationAnalyze, runCalibrationEvaluate, runEvaluationAgent, runTuningAgent, stripDeltaToDifficulty, stripDesignTree, supportsDepthWeight, toCommentableNodeId, tokenDeltaToDifficulty, transformComponentMasterNodes, transformFigmaResponse, transformFileNodesResponse, variantStructureMismatch };
+export { ALL_STRIP_TYPES, ActivityLogger, type AnalysisAgentInput, type AnalysisAgentOutput, type AnalysisFile, AnalysisFileSchema, type AnalysisIssue, type AnalysisNode, AnalysisNodeSchema, type AnalysisNodeType, AnalysisNodeTypeSchema, type AnalysisResult, type AnalysisScope, AnalysisScopeSchema, AnnotationPropertySchema, CATEGORIES, CATEGORY_LABELS, type CalibrationConfig, type CalibrationConfigInput, CalibrationConfigSchema, type CalibrationRun, type CalibrationStatus, CalibrationStatusSchema, type Category, CategorySchema, type CategoryScore, type CategoryScoreResult, CategoryScoreSchema, type Confidence, ConfidenceSchema, type ConversionRecord, ConversionRecordSchema, DEPTH_WEIGHT_CATEGORIES, DESIGN_TREE_INFO_TYPES, type DesignTreeInfoType, type DesignTreeOptions, type DesignTreeResult, type DesignTreeStripType, type Detection, DetectionSchema, type Difficulty, DifficultySchema, type EvaluationAgentInput, type EvaluationAgentOutput, FigmaClient, FigmaClientError, type FigmaClientOptions, FigmaFileLoadError, type FigmaUrlInfo, FigmaUrlInfoSchema, FigmaUrlParseError, type GapAnalyzerOutput, GapAnalyzerOutputSchema, type GapEntry, GapEntrySchema, type GetFileNodesResponse, type GotchaApplyResolution, type GotchaApplyStrategy, GotchaDetectionSchema, GotchaOutputChannelSchema, GotchaPersistenceIntentSchema, type GotchaSurvey, type GotchaSurveyQuestion, GotchaSurveyQuestionSchema, GotchaSurveySchema, type Grade, type GridChildAlign, GridChildAlignSchema, type GroupedSurvey, GroupedSurveySchema, type InstanceChildIdParts, type InstanceContext, InstanceContextSchema, type Issue, IssueSchema, type LayoutAlign, LayoutAlignSchema, type LayoutConstraint, LayoutConstraintSchema, type LayoutMode, LayoutModeSchema, type LayoutPositioning, LayoutPositioningSchema, type LayoutWrap, LayoutWrapSchema, type McpAnalyzeResponse, McpAnalyzeResponseSchema, type MismatchCase, MismatchCaseSchema, type MismatchType, MismatchTypeSchema, type NewRuleProposal, NewRuleProposalSchema, type NodeIssueDetail, type NodeIssueSummary, NodeIssueSummarySchema, type OutputChannel, OutputChannelSchema, type OverflowDirection, OverflowDirectionSchema, type PersistenceIntent, PersistenceIntentSchema, type Preset, RULE_ANNOTATION_PROPERTIES, RULE_CONFIGS, RULE_ID_CATEGORY, RULE_PURPOSE, type Report, type ReportMetadata, ReportMetadataSchema, ReportSchema, type Rule, type RuleApplyStrategy, RuleApplyStrategySchema, type RuleCheckFn, type RuleConfig, RuleConfigSchema, type RuleContext, type RuleDefinition, RuleDefinitionSchema, RuleEngine, type RuleEngineOptions, type RuleFailure, type RuleId, RuleImpactAssessmentSchema, type RulePurpose, RulePurposeSchema, type RuleRelatedStruggle, RuleRelatedStruggleSchema, type RuleViolation, SEVERITY_LABELS, SEVERITY_WEIGHT, type SamplingStrategy, SamplingStrategySchema, type ScoreAdjustment, ScoreAdjustmentSchema, type ScoreReport, type Severity, SeveritySchema, type StripDeltaForEval, type StripDeltaResult, StripDeltaResultSchema, StripDeltasArraySchema, StripTypeEnum, type SurveyQuestionBatch, SurveyQuestionBatchSchema, type SurveyQuestionGroup, SurveyQuestionGroupSchema, type TuningAgentInput, type TuningAgentOutput, type UncoveredStruggle, UncoveredStruggleSchema, UncoveredStrugglesInputSchema, version as VERSION, type VisualCompareCliOptions, VisualCompareCliOptionsSchema, absolutePositionInAutoLayout, analyzeFile, buildFigmaDeepLink, buildResultJson, calculateScores, collectComponentIds, collectInteractionDestinationIds, createRuleEngine, deepNesting, defineRule, detachedInstance, detectAnalysisScope, extractRuleScores, fixedSizeInAutoLayout, formatScoreSummary, generateCalibrationReport, generateDesignTree, generateDesignTreeWithStats, getAnalysisState, getAnnotationProperties, getCategoryLabel, getConfigsWithPreset, getRuleOption, getRulePurpose, getSeverityLabel, gradeToClassName, inconsistentNamingConvention, irregularSpacing, isInstanceChildNodeId, isReadyForCodeGen, loadFigmaFileFromJson, missingComponent, missingInteractionState, missingPrototype, missingSizeConstraint, noAutoLayout, nonLayoutContainer, nonSemanticName, nonStandardNaming, parseFigmaJson, parseFigmaUrl, parseInstanceChildNodeId, rawValue, resolveComponentDefinitions, resolveGotchaApplyTarget, resolveInteractionDestinations, ruleRegistry, runAnalysisAgent, runCalibrationAnalyze, runCalibrationEvaluate, runEvaluationAgent, runTuningAgent, stripDeltaToDifficulty, stripDesignTree, supportsDepthWeight, toCommentableNodeId, tokenDeltaToDifficulty, transformComponentMasterNodes, transformFigmaResponse, transformFileNodesResponse, variantStructureMismatch };