@seniorsistemas/angular-components-mcp 1.0.0-beta.3 → 1.0.0

package/dist/data/ux-rules.md

@@ -0,0 +1,45 @@
+# UX Rules — Cross-Component
+
+Regras que se aplicam a qualquer componente ou template do projeto.
+
+---
+
+## tailwind-tokens (severity: error)
+
+Use exclusivamente os tokens customizados do `@seniorsistemas/tailwind-config`. **Não use classes padrão do Tailwind.**
+
+| Token         | Exemplos válidos                                                                                                  |
+| ------------- | ----------------------------------------------------------------------------------------------------------------- |
+| Cores         | `bg-primary`, `text-grayscale-100`, `border-criticality-red`                                                      |
+| Border radius | `rounded-xxsmall` `rounded-xsmall` `rounded-small` `rounded-medium` `rounded-xbig` `rounded-xxbig` `rounded-huge` |
+| Breakpoints   | `xs` `sm` `md` `lg` `xl` `xxl` `big`                                                                              |
+| Fonte         | `font-open-sans`                                                                                                  |
+
+**Proibido:** `bg-blue-500`, `text-red-600`, `rounded-lg`, `rounded-xl`, breakpoints padrão do Tailwind.
+
+---
+
+## loading-states (severity: warning)
+
+Use `s-loading-state` para indicar carregamento de página ou seção.
+
+---
+
+## empty-states (severity: warning)
+
+Use `s-empty-state` sempre que uma lista ou tabela não tiver dados. Inclua uma orientação acionável para o usuário.
+
+---
+
+## Qual componente usar
+
+| Necessidade                            | Componente                                           |
+| -------------------------------------- | ---------------------------------------------------- |
+| Qualquer formulário                    | `s-dynamic-form` — nunca campos individuais isolados |
+| Dados tabulares                        | `p-table` (PrimeNG)                                  |
+| Item individual                        | `s-card`                                             |
+| Hierarquia de navegação                | `s-breadcrumb`                                       |
+| Processo multi-etapa                   | `s-stepper`                                          |
+| Notificação de sucesso/erro            | `s-toast`                                            |
+| Confirmação que requer ação do usuário | `s-dialog`                                           |
+

package/dist/handlers/handleDetectRequiredProviders.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Detecta providers opcionais necessários a partir da configuração do formulário dinâmico.
+ */
+export declare function handleDetectRequiredProviders(dynamicFormMetadata: Record<string, unknown>, args: {
+    config: string;
+} | undefined): {
+    content: {
+        type: string;
+        text: string;
+    }[];
+};
+//# sourceMappingURL=handleDetectRequiredProviders.d.ts.map

package/dist/handlers/handleDetectRequiredProviders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleDetectRequiredProviders.d.ts","sourceRoot":"","sources":["../../src/handlers/handleDetectRequiredProviders.ts"],"names":[],"mappings":"AAWA;;GAEG;AACH,wBAAgB,6BAA6B,CACzC,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5C,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS;;;;;EA6BvC"}

package/dist/handlers/handleGetComponentDetails.d.ts

@@ -0,0 +1,13 @@
+import type { ComponentsData } from '../handlers.js';
+/**
+ * Retorna detalhes completos de um componente pelo nome ou selector.
+ */
+export declare function handleGetComponentDetails(componentsData: ComponentsData, args: {
+    name?: string;
+} | undefined): {
+    content: {
+        type: string;
+        text: string;
+    }[];
+};
+//# sourceMappingURL=handleGetComponentDetails.d.ts.map

package/dist/handlers/handleGetComponentDetails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleGetComponentDetails.d.ts","sourceRoot":"","sources":["../../src/handlers/handleGetComponentDetails.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,gBAAgB,CAAC;AACpE;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,cAAc,EAAE,cAAc,EAAE,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS;;;;;EA0C5G"}

package/dist/handlers/handleGetComponentRules.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Retorna as regras de UX de um componente específico, se existirem.
+ */
+import type { ComponentRulesIndex } from '../handlers.js';
+export declare function handleGetComponentRules(componentRulesIndex: ComponentRulesIndex, getComponentRulesFile: (componentName: string) => string, args: {
+    name?: string;
+} | undefined): {
+    content: {
+        type: string;
+        text: string;
+    }[];
+};
+//# sourceMappingURL=handleGetComponentRules.d.ts.map

package/dist/handlers/handleGetComponentRules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleGetComponentRules.d.ts","sourceRoot":"","sources":["../../src/handlers/handleGetComponentRules.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,wBAAgB,uBAAuB,CACnC,mBAAmB,EAAE,mBAAmB,EACxC,qBAAqB,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,MAAM,EACxD,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS;;;;;EAqDtC"}

package/dist/handlers/handleGetComponentRulesIndex.d.ts

@@ -0,0 +1,11 @@
+import type { ComponentRulesIndex } from '../handlers.js';
+/**
+ * Retorna o índice dos componentes que possuem regras de UX.
+ */
+export declare function handleGetComponentRulesIndex(componentRulesIndex: ComponentRulesIndex): {
+    content: {
+        type: string;
+        text: string;
+    }[];
+};
+//# sourceMappingURL=handleGetComponentRulesIndex.d.ts.map

package/dist/handlers/handleGetComponentRulesIndex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleGetComponentRulesIndex.d.ts","sourceRoot":"","sources":["../../src/handlers/handleGetComponentRulesIndex.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,mBAAmB,EAAE,mBAAmB;;;;;EASpF"}

package/dist/handlers/handleGetComponentTechnicalGuide.d.ts

@@ -0,0 +1,13 @@
+import type { ComponentTechnicalIndex } from '../handlers.js';
+/**
+ * Retorna o guia técnico de um componente específico, se existir.
+ */
+export declare function handleGetComponentTechnicalGuide(componentTechnicalIndex: ComponentTechnicalIndex, getComponentTechnicalFile: (componentName: string) => string, args: {
+    name?: string;
+} | undefined): {
+    content: {
+        type: string;
+        text: string;
+    }[];
+};
+//# sourceMappingURL=handleGetComponentTechnicalGuide.d.ts.map

package/dist/handlers/handleGetComponentTechnicalGuide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleGetComponentTechnicalGuide.d.ts","sourceRoot":"","sources":["../../src/handlers/handleGetComponentTechnicalGuide.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAE9D;;GAEG;AACH,wBAAgB,gCAAgC,CAC5C,uBAAuB,EAAE,uBAAuB,EAChD,yBAAyB,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,MAAM,EAC5D,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS;;;;;EA+CtC"}

package/dist/handlers/handleGetComponentTechnicalIndex.d.ts

@@ -0,0 +1,11 @@
+import type { ComponentTechnicalIndex } from '../handlers.js';
+/**
+ * Retorna o índice dos componentes que possuem guia técnico.
+ */
+export declare function handleGetComponentTechnicalIndex(componentTechnicalIndex: ComponentTechnicalIndex): {
+    content: {
+        type: string;
+        text: string;
+    }[];
+};
+//# sourceMappingURL=handleGetComponentTechnicalIndex.d.ts.map

package/dist/handlers/handleGetComponentTechnicalIndex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleGetComponentTechnicalIndex.d.ts","sourceRoot":"","sources":["../../src/handlers/handleGetComponentTechnicalIndex.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAE9D;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,uBAAuB,EAAE,uBAAuB;;;;;EAShG"}

package/dist/handlers/handleGetComponents.d.ts

@@ -0,0 +1,14 @@
+import type { ComponentsData } from '../handlers.js';
+/**
+ * Retorna lista de componentes filtrados por categoria ou palavra-chave.
+ */
+export declare function handleGetComponents(componentsData: ComponentsData, args: {
+    category?: string;
+    keyword?: string;
+} | undefined): {
+    content: {
+        type: string;
+        text: string;
+    }[];
+};
+//# sourceMappingURL=handleGetComponents.d.ts.map

package/dist/handlers/handleGetComponents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleGetComponents.d.ts","sourceRoot":"","sources":["../../src/handlers/handleGetComponents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,gBAAgB,CAAC;AAEpE;;GAEG;AACH,wBAAgB,mBAAmB,CAC/B,cAAc,EAAE,cAAc,EAC9B,IAAI,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS;;;;;EAkD5D"}

package/dist/handlers/handleGetDynamicFormTypes.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Retorna tipos de campos, estruturas ou bases do formulário dinâmico, ou detalhes de um tipo específico.
+ */
+export declare function handleGetDynamicFormTypes(dynamicFormMetadata: Record<string, unknown>, args: {
+    typeKey?: string;
+    kind?: 'field' | 'structure' | 'base' | 'optional';
+} | undefined): {
+    content: {
+        type: string;
+        text: string;
+    }[];
+};
+//# sourceMappingURL=handleGetDynamicFormTypes.d.ts.map

package/dist/handlers/handleGetDynamicFormTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleGetDynamicFormTypes.d.ts","sourceRoot":"","sources":["../../src/handlers/handleGetDynamicFormTypes.ts"],"names":[],"mappings":"AAkBA;;GAEG;AACH,wBAAgB,yBAAyB,CACrC,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5C,IAAI,EACE;IACI,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,GAAG,WAAW,GAAG,MAAM,GAAG,UAAU,CAAC;CACtD,GACD,SAAS;;;;;EAWlB"}

package/dist/handlers/handleGetUxRules.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Retorna o conteúdo do arquivo de regras de UX.
+ */
+export declare function handleGetUxRules(getUxRulesFile: () => string): {
+    content: {
+        type: string;
+        text: string;
+    }[];
+};
+//# sourceMappingURL=handleGetUxRules.d.ts.map

package/dist/handlers/handleGetUxRules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleGetUxRules.d.ts","sourceRoot":"","sources":["../../src/handlers/handleGetUxRules.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,MAAM,MAAM;;;;;EAK5D"}

package/dist/handlers.d.ts

@@ -0,0 +1,112 @@
+export interface ComponentInput {
+    name: string;
+    description: string;
+    default?: string;
+    type?: string;
+    required?: boolean;
+    deprecated?: boolean;
+}
+export interface ComponentOutput {
+    name: string;
+    description: string;
+    type?: string;
+    deprecated?: boolean;
+}
+export interface ComponentInfo {
+    name: string;
+    selector: string;
+    description: string;
+    package: string;
+    priority: 'high' | 'medium' | 'low';
+    keywords: string[];
+    mustUse?: boolean;
+    reason?: string;
+    note?: string;
+    inputs?: ComponentInput[];
+    outputs?: ComponentOutput[];
+}
+export interface Category {
+    description: string;
+    components: ComponentInfo[];
+}
+export interface ComponentsData {
+    categories: Record<string, Category>;
+}
+export interface ComponentRulesIndex {
+    components: string[];
+}
+export interface ComponentTechnicalIndex {
+    components: string[];
+}
+export interface ToolHandlers {
+    handleGetComponents: (args: {
+        category?: string;
+        keyword?: string;
+    } | undefined) => {
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    };
+    handleGetComponentDetails: (args: {
+        name?: string;
+    } | undefined) => {
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    };
+    handleDetectRequiredProviders: (args: {
+        config: string;
+    } | undefined) => {
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    };
+    handleGetUxRules: (_args: unknown) => {
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    };
+    handleGetDynamicFormTypes: (args: {
+        typeKey?: string;
+        kind?: 'field' | 'structure' | 'base' | 'optional';
+    } | undefined) => {
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    };
+    handleGetComponentRulesIndex: (_args: unknown) => {
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    };
+    handleGetComponentRules: (args: {
+        name?: string;
+    } | undefined) => {
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    };
+    handleGetComponentTechnicalIndex: (_args: unknown) => {
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    };
+    handleGetComponentTechnicalGuide: (args: {
+        name?: string;
+    } | undefined) => {
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    };
+}
+export declare function createToolHandlers(componentsData: ComponentsData, dynamicFormMetadata: Record<string, unknown>, getUxRulesFile: () => string, componentRulesIndex: ComponentRulesIndex, getComponentRulesFile: (componentName: string) => string, componentTechnicalIndex: ComponentTechnicalIndex, getComponentTechnicalFile: (componentName: string) => string): ToolHandlers;
+//# sourceMappingURL=handlers.d.ts.map

package/dist/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../src/handlers.ts"],"names":[],"mappings":"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"}