@schemyx/mcp 0.1.1 → 0.1.3

package/README.md

@@ -80,6 +80,7 @@ The MCP package can also build local-only codebase configs for agents. This does
     route.jsonl
     api.jsonl
     service.jsonl
+    database.jsonl
     model.jsonl
     style.jsonl
     cluster.jsonl
@@ -106,6 +107,8 @@ Supported `projectType` values:
 
 The output is a segmented universal graph plus grouped keyed recipes. The scanner produces broad baseline coverage for TypeScript/JavaScript, React, Next.js, NestJS, Prisma, CSS/Tailwind, raw HTML/templates, PHP/Laravel-style apps, SQL schemas, docs, tests, configs, and common package manifests. After scanning, use `schemyx_search_codebase`, `schemyx_get_codebase_recipe`, `schemyx_get_context_pack`, `schemyx_get_codebase_graph`, `schemyx_list_review_items`, `schemyx_check_context_freshness`, and `schemyx_read_codebase_file`.
 
+Frontend UI recipes expose the canonical `uiContract` + `relationships` shape. `uiContract` contains identity, semantics, visual classes, layout classes, responsive variants, interaction variants, safety rules, and source evidence. `relationships` contains parent context, child structure, compound structure, and graph keys.
+
 ## Development
 
 From the backend repo root:

package/dist/codebase-scanner/bundle.d.ts

@@ -1,9 +1,21 @@
-import type { AnalyzedFile, BackendEndpointContract, BackendServiceCall, CodebaseBundle, CodebaseProjectType, Confidence, ConnectedPatternCluster, ConnectedPatternInstance, GraphEdge, GraphNode, PatternDecision, PatternScores, RegistryEntry, ReviewItem, SourceInfo, UiElement, UiElementChildSummary } from './types';
+import type { AnalyzedFile, BackendEndpointContract, BackendServiceCall, CodebaseBundle, CodebaseProjectType, ComponentStyleDefinition, Confidence, ConnectedPatternCluster, ConnectedPatternInstance, DatabaseAccessContract, DatabaseModelContract, GraphEdge, GraphNode, PatternDecision, PatternScores, RegistryEntry, ReviewItem, SourceInfo, UiContract, UiElement, UiElementChildSummary, UiLayoutSafety, UiResponsiveProfile, UiRelationships, UiRoleSignature, UiScaleProfile, UiSemanticProfile } from './types';
 export declare function createBundle(rootPath: string, projectType: CodebaseProjectType, files: AnalyzedFile[]): CodebaseBundle;
 export declare function addEntry(entries: RegistryEntry[], usedKeys: Set<string>, entry: RegistryEntry): void;
 export declare function hasStyleSurface(file: AnalyzedFile): boolean;
 export declare function isBackendRouteFile(file: AnalyzedFile): boolean;
+export declare function hasDatabaseSurface(file: AnalyzedFile): boolean;
+export declare function addDatabaseSurfaceEntries(entries: RegistryEntry[], usedKeys: Set<string>, nodes: GraphNode[], edges: GraphEdge[], file: AnalyzedFile): void;
+export declare function databaseSurfaceText(file: AnalyzedFile): string;
+export declare function databaseSurfaceConfidence(file: AnalyzedFile): Confidence;
+export declare function databaseAccessDependencies(access: DatabaseAccessContract): string[];
+export declare function databaseAccessEdgeType(access: DatabaseAccessContract): string;
+export declare function databaseEnumKey(enumValue: {
+    name: string;
+    provider: string;
+    values: string[];
+}, file: AnalyzedFile): string;
 export declare function backendFileContext(file: AnalyzedFile): Record<string, unknown>;
+export declare function databaseFileContext(file: AnalyzedFile): Record<string, unknown>;
 export declare function findEndpointContract(file: AnalyzedFile, handler: string): BackendEndpointContract | undefined;
 export declare function createBackendEndpointFlow(file: AnalyzedFile, handlerKey: string, contract: BackendEndpointContract): Record<string, unknown>;
 export declare function backendCallDependencies(calls: BackendServiceCall[]): string[];
@@ -24,22 +36,240 @@ export declare function sourceInfo(extractor: string, confidence: Confidence, ev
 export declare function toGraphNode(key: string, kind: string, name: string, relPath: string, file: AnalyzedFile, extractor: string, facets?: Record<string, unknown>): GraphNode;
 export declare function toGraphEdge(from: string, to: string, type: string, extractor: string, file: AnalyzedFile, confidence?: Confidence): GraphEdge;
 export declare function addRenderEdges(entries: RegistryEntry[], files: AnalyzedFile[], edges: GraphEdge[]): void;
-export declare function addUiPatternRules(entries: RegistryEntry[], usedKeys: Set<string>, nodes: GraphNode[], edges: GraphEdge[], files: AnalyzedFile[]): void;
-export declare function addUiCompositionRules(entries: RegistryEntry[], usedKeys: Set<string>, nodes: GraphNode[], edges: GraphEdge[], files: AnalyzedFile[]): void;
-export declare function addConnectedPatternRules(entries: RegistryEntry[], usedKeys: Set<string>, nodes: GraphNode[], edges: GraphEdge[], reviewItems: ReviewItem[], files: AnalyzedFile[]): void;
-export declare function buildConnectedPatternClusters(files: AnalyzedFile[]): ConnectedPatternCluster[];
-export declare function createFrontendPatternInstances(file: AnalyzedFile): ConnectedPatternInstance[];
+export declare function inferStyleDefinitionVariantRoles(styleDefinition: ComponentStyleDefinition): Record<string, Record<string, Record<string, unknown>>>;
+export declare function inferActionVariantRole(variantName: string, classes: string[]): Record<string, unknown>;
+export declare function createStyleDefinitionGuidance(styleDefinition: ComponentStyleDefinition): string[];
+export declare function summarizeUiElementPatterns(elements: UiElement[], styleContext?: StyleResolutionContext): Array<Record<string, unknown>>;
+export declare function uiElementPatternUsage(element: UiElement): 'root' | 'slot' | 'nested';
+export declare function rootUiElementsForKind(elements: UiElement[]): UiElement[];
+export declare function isLayoutSafetyProfile(value: unknown): value is UiLayoutSafety;
+export declare function isResponsiveProfile(value: unknown): value is UiResponsiveProfile;
+export declare function isScaleProfile(value: unknown): value is UiScaleProfile;
+export declare function isSemanticProfile(value: unknown): value is UiSemanticProfile;
+export interface UiContractInput {
+    kind: string;
+    tag?: string;
+    layoutRole?: string;
+    semanticRole?: string;
+    label?: string;
+    line?: number;
+    path?: string;
+    sourceHash?: string;
+    confidence?: Confidence;
+    evidence?: string;
+    classSource?: string;
+    classes: string[];
+    defaultClasses?: string[];
+    conditionalClasses?: string[];
+    decorativeAccentClasses?: string[];
+    classGroups?: Record<string, string[]>;
+    layoutSafety?: UiLayoutSafety;
+    responsiveProfile?: UiResponsiveProfile;
+    scaleProfile?: UiScaleProfile;
+    semanticProfile?: UiSemanticProfile;
+    roleSignature?: UiRoleSignature;
+    variants?: Record<string, unknown>;
+    props?: Record<string, unknown>;
+    styleHelper?: string;
+    styleHelperVariants?: Record<string, unknown>;
+    styleContext?: StyleResolutionContext;
+}
+export interface ResolvedStyleDeclaration {
+    property: string;
+    value: string;
+    source: 'css-rule' | 'tailwind-utility' | 'bootstrap-utility';
+    styleSystem: StyleSystemId;
+    className?: string;
+    selector?: string;
+    path?: string;
+    line?: number;
+    prefixes?: string[];
+    media?: string;
+    specificity?: number;
+    ruleOrder?: number;
+    cascadeRank?: number;
+    important?: boolean;
+    resolvedValue?: string;
+}
+export type StyleSystemId = 'raw-css' | 'tailwind' | 'bootstrap' | 'unknown';
+export interface StyleResolutionContext {
+    classRules: Map<string, ResolvedStyleDeclaration[]>;
+    cssVariables: Map<string, Array<{
+        value: string;
+        selector?: string;
+        path: string;
+        line: number;
+    }>>;
+    detectedStyleSystems: StyleSystemId[];
+}
+export declare function createStyleResolutionContext(files: AnalyzedFile[]): StyleResolutionContext;
+export declare function detectProjectStyleSystems(files: AnalyzedFile[]): StyleSystemId[];
+export declare function classNamesFromCssSelector(selector: string): string[];
+export declare function unescapeCssIdentifier(value: string): string;
+export declare function cssSelectorStatePrefixes(selector: string): string[];
+export declare function cssRuleMediaContext(selector: string): string | undefined;
+export declare function normalizeCssDeclarationValue(value: string): string;
+export declare function cssDeclarationImportant(value: string): boolean;
+export declare function estimateSelectorSpecificity(selector: string): number;
+export declare function resolveCssValueTokens(value: string, cssVariables?: StyleResolutionContext['cssVariables']): string;
+export declare function resolveUiClassDeclarations(classes: string[], styleContext?: StyleResolutionContext): ResolvedStyleDeclaration[];
+export declare function tailwindDeclarationsForClass(className: string, styleContext?: StyleResolutionContext): ResolvedStyleDeclaration[];
+export declare function tailwindAlignmentDeclaration(base: string): {
+    property: string;
+    value: string;
+} | undefined;
+export declare function tailwindSpacingDeclaration(base: string): Array<{
+    property: string;
+    value: string;
+}>;
+export declare function tailwindSizingDeclaration(base: string): Array<{
+    property: string;
+    value: string;
+}>;
+export declare function tailwindTypographyDeclaration(base: string): Array<{
+    property: string;
+    value: string;
+}>;
+export declare function tailwindBorderDeclaration(base: string, styleContext?: StyleResolutionContext): Array<{
+    property: string;
+    value: string;
+}>;
+export declare function tailwindColorDeclaration(base: string, styleContext?: StyleResolutionContext): Array<{
+    property: string;
+    value: string;
+}>;
+export declare function tailwindColorValue(token: string, styleContext?: StyleResolutionContext): string;
+export declare function cssTokenValue(token: string, styleContext?: StyleResolutionContext): string | undefined;
+export declare function colorKeywordValue(token: string): string | undefined;
+export declare function opacityToPercent(value: string): string;
+export declare function tailwindScaleValue(token: string): string | undefined;
+export declare function tailwindNamedSizeValue(token: string): string | undefined;
+export declare function arbitraryTokenValue(token: string): string | undefined;
+export declare function arbitraryValue(base: string): string;
+export declare function looksLikeCssLength(value: string): boolean;
+export declare function tailwindShadowValue(base: string): string;
+export declare function bootstrapDeclarationsForClass(className: string, styleContext?: StyleResolutionContext): ResolvedStyleDeclaration[];
+export declare function isBootstrapClass(className: string): boolean;
+export declare function bootstrapResponsivePrefixes(className: string): string[];
+export declare function stripBootstrapResponsiveInfix(className: string): string;
+export declare function bootstrapComponentDeclarations(base: string): Array<{
+    property: string;
+    value: string;
+}>;
+export declare function bootstrapSpacingDeclarations(base: string): Array<{
+    property: string;
+    value: string;
+}>;
+export declare function bootstrapDisplayDeclarations(base: string): Array<{
+    property: string;
+    value: string;
+}>;
+export declare function bootstrapFlexDeclarations(base: string): Array<{
+    property: string;
+    value: string;
+}>;
+export declare function bootstrapSizingDeclarations(base: string): Array<{
+    property: string;
+    value: string;
+}>;
+export declare function bootstrapTypographyDeclarations(base: string): Array<{
+    property: string;
+    value: string;
+}>;
+export declare function bootstrapColorDeclarations(base: string): Array<{
+    property: string;
+    value: string;
+}>;
+export declare function bootstrapBorderDeclarations(base: string): Array<{
+    property: string;
+    value: string;
+}>;
+export declare function bootstrapGridDeclarations(base: string): Array<{
+    property: string;
+    value: string;
+}>;
+export declare function categorizeResolvedStyleDeclarations(declarations: ResolvedStyleDeclaration[]): Record<string, ResolvedStyleDeclaration[]>;
+export declare function flattenResolvedStyleCategories(categories: Record<string, ResolvedStyleDeclaration[]>): ResolvedStyleDeclaration[];
+export declare function createStyleSystemEvidence(classes: string[], declarations: ResolvedStyleDeclaration[], styleContext?: StyleResolutionContext): Record<string, unknown>;
+export declare function isLikelyTailwindClass(className: string): boolean;
+export declare function resolvedStyleCategory(property: string): string;
+export declare function mergeResolvedStyleCategories(current: Record<string, unknown>, next: Record<string, ResolvedStyleDeclaration[]>): Record<string, unknown>;
+export declare function classBucketRecord(value: Record<string, unknown>): Record<string, string[]>;
+export declare function resolvedStyleRecord(value: unknown): Record<string, unknown>;
+export declare function createUiContract(input: UiContractInput): UiContract;
+export declare function createUiContractForElement(element: UiElement, file?: AnalyzedFile, confidence?: Confidence, styleContext?: StyleResolutionContext): UiContract;
+export declare function createUiContractForChild(child: UiElementChildSummary, styleContext?: StyleResolutionContext): UiContract;
+export declare function createUiPatternContract(input: UiContractInput & {
+    name: string;
+    count: number;
+}): UiContract;
+export declare function createUiRelationships(input: {
+    parentContext?: unknown;
+    childStructureContract?: unknown;
+    compoundStructure?: unknown;
+    graphKeys?: string[];
+}): UiRelationships;
+export declare function createUiResponsiveVariants(classes: string[], styleContext?: StyleResolutionContext): Record<string, unknown>;
+export declare function createUiInteractionVariants(classes: string[], styleContext?: StyleResolutionContext): Record<string, unknown>;
+export declare function uiContractClassBucket(className: string): Record<string, string[]>;
+export declare function mergeUiContractClassBuckets(current: Record<string, string[]>, next: Record<string, string[]>): Record<string, string[]>;
+export declare function filterUiContractClasses(classes: string[], predicate: (className: string) => boolean): string[];
+export declare function isResponsivePrefix(prefix: string): boolean;
+export declare function responsivePrefixesForClass(className: string): string[];
+export declare function isInteractionPrefix(prefix: string): boolean;
+export declare function omitEmptyRecord(value: Record<string, unknown>): Record<string, unknown>;
+export declare function mergeLayoutSafetyProfiles(items: Array<{
+    layoutSafety?: UiLayoutSafety;
+}>): UiLayoutSafety | undefined;
+export declare function mergeResponsiveProfiles(items: Array<{
+    responsiveProfile?: UiResponsiveProfile;
+}>): UiResponsiveProfile | undefined;
+export declare function mergeScaleProfiles(items: Array<{
+    scaleProfile?: UiScaleProfile;
+}>): UiScaleProfile | undefined;
+export declare function mergeSemanticProfiles(items: Array<{
+    semanticProfile?: UiSemanticProfile;
+}>): UiSemanticProfile | undefined;
+export declare function summarizePatternLayoutSafety(elements: UiElement[]): UiLayoutSafety | undefined;
+export declare function summarizePatternResponsiveProfile(elements: UiElement[]): UiResponsiveProfile | undefined;
+export declare function summarizePatternScaleProfile(elements: UiElement[]): UiScaleProfile | undefined;
+export declare function summarizePatternSemanticProfile(elements: UiElement[]): UiSemanticProfile | undefined;
+export declare function summarizePatternRoleSignatures(elements: UiElement[]): UiRoleSignature[];
+export declare function summarizeParentContexts(elements: UiElement[]): Array<Record<string, unknown>>;
+export declare function summarizeElementChildContract(children: UiElementChildSummary[], styleContext?: StyleResolutionContext): Record<string, unknown> | undefined;
+export declare function summarizePatternChildStructure(elements: UiElement[], styleContext?: StyleResolutionContext): Record<string, unknown> | undefined;
+export declare function summarizeCompoundStructure(elements: UiElement[], styleContext?: StyleResolutionContext): Record<string, unknown> | undefined;
+export declare function createUiGenerationConstraints(kind: string, elements: UiElement[], decorativeAccentClasses: string[]): Record<string, unknown>;
+export declare function createUiGenerationGuidance(kind: string, elements: UiElement[]): string[];
+export declare function summarizeActionUsages(elements: UiElement[]): Array<Record<string, unknown>>;
+export declare function actionVariantNamesForElement(element: UiElement): string[];
+export declare function addUiPatternRules(entries: RegistryEntry[], usedKeys: Set<string>, nodes: GraphNode[], edges: GraphEdge[], files: AnalyzedFile[], styleContext?: StyleResolutionContext): void;
+export declare function addUiCompositionRules(entries: RegistryEntry[], usedKeys: Set<string>, nodes: GraphNode[], edges: GraphEdge[], files: AnalyzedFile[], styleContext?: StyleResolutionContext): void;
+export declare function addGlobalUiContractRules(entries: RegistryEntry[], usedKeys: Set<string>, nodes: GraphNode[], edges: GraphEdge[], files: AnalyzedFile[]): void;
+export declare function addConnectedPatternRules(entries: RegistryEntry[], usedKeys: Set<string>, nodes: GraphNode[], edges: GraphEdge[], reviewItems: ReviewItem[], files: AnalyzedFile[], styleContext?: StyleResolutionContext): void;
+export declare function buildConnectedPatternClusters(files: AnalyzedFile[], styleContext?: StyleResolutionContext): ConnectedPatternCluster[];
+export declare function createFrontendPatternInstances(file: AnalyzedFile, styleContext?: StyleResolutionContext): ConnectedPatternInstance[];
 export declare function createBackendPatternInstances(files: AnalyzedFile[]): ConnectedPatternInstance[];
 export declare function createDataPatternInstances(files: AnalyzedFile[]): ConnectedPatternInstance[];
 export declare function isConnectedUiPatternRoot(element: UiElement): boolean;
-export declare function normalizeConnectedChildren(children: UiElementChildSummary[]): Array<Record<string, unknown> & {
+export declare function normalizeConnectedChildren(children: UiElementChildSummary[], styleContext?: StyleResolutionContext): Array<Record<string, unknown> & {
     signature: string;
 }>;
 export declare function withoutConnectedChildSignature(child: Record<string, unknown> & {
     signature: string;
 }): Record<string, unknown>;
 export declare function connectedChildKind(child: UiElementChildSummary): string;
+export declare function isRecordValue(value: unknown): value is Record<string, unknown>;
+export declare function isRoleSignatureRecord(value: unknown): value is UiRoleSignature;
+export declare function summarizeConnectedLayoutSafety(instances: ConnectedPatternInstance[]): UiLayoutSafety | undefined;
+export declare function summarizeConnectedResponsiveProfile(instances: ConnectedPatternInstance[]): UiResponsiveProfile | undefined;
+export declare function summarizeConnectedScaleProfile(instances: ConnectedPatternInstance[]): UiScaleProfile | undefined;
+export declare function summarizeConnectedSemanticProfile(instances: ConnectedPatternInstance[]): UiSemanticProfile | undefined;
+export declare function summarizeConnectedRoleSignatures(instances: ConnectedPatternInstance[]): UiRoleSignature[];
+export declare function summarizeConnectedCompoundStructure(instances: ConnectedPatternInstance[]): Record<string, unknown> | undefined;
+export declare function summarizeConnectedParentContexts(instances: ConnectedPatternInstance[]): Array<Record<string, unknown>>;
 export declare function summarizeConnectedChildren(instances: ConnectedPatternInstance[]): Array<Record<string, unknown>>;
+export declare function mergeChildVariants(children: Array<Record<string, unknown>>): Record<string, string[]>;
 export declare function compactConnectedPatternInstance(instance: ConnectedPatternInstance): Record<string, unknown>;
 export declare function scoreConnectedPatternGroup(instances: ConnectedPatternInstance[]): number;
 export declare function connectedPatternConfidence(score: number, usage: number): Confidence;
@@ -56,6 +286,7 @@ export declare function frontendPatternWeight(file: AnalyzedFile, element: UiEle
 export declare function backendPatternWeight(file: AnalyzedFile): number;
 export declare function hasBackendPatternSurface(file: AnalyzedFile): boolean;
 export declare function backendPatternConcept(file: AnalyzedFile): string;
+export declare function databaseFieldShapeInputs(model: DatabaseModelContract): string[];
 export declare function summarizeModelFieldShape(fields: string[]): {
     signature: string;
     tags: string[];
@@ -63,6 +294,7 @@ export declare function summarizeModelFieldShape(fields: string[]): {
 };
 export declare function createConnectedPatternGuidance(first: ConnectedPatternInstance, instances: ConnectedPatternInstance[], decorativeAccentClasses: string[]): string[];
 export declare function connectedPatternSlug(instance: ConnectedPatternInstance): string;
+export declare function roleSignatureKey(signature?: UiRoleSignature): string;
 export declare function classSignature(classes: string[]): string;
 export declare function normalizeLayoutRole(value?: string): string;
 export declare function normalizeTagForSignature(element: UiElement): string;
@@ -71,7 +303,9 @@ export declare function labelSignature(label: string): string;
 export declare function addImportEdges(entries: RegistryEntry[], files: AnalyzedFile[], edges: GraphEdge[], rootPath: string): void;
 export declare function addApiCallEdges(entries: RegistryEntry[], files: AnalyzedFile[], edges: GraphEdge[]): void;
 export declare function addStyleUsageEdges(entries: RegistryEntry[], files: AnalyzedFile[], edges: GraphEdge[]): void;
+export declare function addDatabaseUsageEdges(entries: RegistryEntry[], files: AnalyzedFile[], edges: GraphEdge[]): void;
 export declare function addModelUsageEdges(entries: RegistryEntry[], files: AnalyzedFile[], edges: GraphEdge[]): void;
+export declare function addDatabaseReviewItems(entries: RegistryEntry[], reviewItems: ReviewItem[]): void;
 export declare function addConceptClusters(entries: RegistryEntry[], usedKeys: Set<string>, nodes: GraphNode[], edges: GraphEdge[], reviewItems: ReviewItem[]): void;
 export declare function applyUsedBy(entries: RegistryEntry[], edges: GraphEdge[]): void;
 export declare function detectProjectFacts(files: AnalyzedFile[]): {