npm - @polymorphism-tech/morph-spec - Versions diffs - 4.6.0 → 4.7.1 - Mend

@polymorphism-tech/morph-spec 4.6.0 → 4.7.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (239) hide show

package/.morph/framework/templates/examples/design-system-examples.md DELETED Viewed

@@ -1,357 +0,0 @@
-# Design System CSS Index Template
-> Template de indice estruturado para arquivos CSS grandes.
-> Copie este header para o inicio do seu `design-system.css`.
-## Indice Padrao
-```css
-/* ===========================================================================
-   {PROJECT_NAME} Design System
-   ===========================================================================
-   Indice de Secoes
-   ================
-   1-99:     Tokens e Variaveis CSS
-   100-199:  Reset e Base Styles
-   200-299:  Tipografia
-   300-399:  Layout e Containers
-   400-499:  Componentes Base (buttons, inputs, cards)
-   500-599:  Componentes Compostos (forms, tables, lists)
-   600-699:  Navegacao (header, sidebar, footer, menus)
-   700-799:  Paginas Especificas
-   800-849:  Modais e Overlays
-   850-899:  Animacoes e Keyframes
-   900-949:  Responsivo e Media Queries
-   950-979:  Utilities e Helpers
-   980-989:  Overrides de Fluent UI / MudBlazor
-   990-999:  Hotfixes e Temporarios
-   Convencoes de Nomenclatura
-   ==========================
-   Prefixo por Pagina:
-   - .home-*      : Pagina inicial
-   - .checkout-*  : Pagina de checkout
-   - .dashboard-* : Pagina de dashboard
-   - .auth-*      : Paginas de autenticacao
-   Prefixo por Componente:
-   - .btn-*       : Botoes
-   - .card-*      : Cards
-   - .modal-*     : Modais
-   - .form-*      : Formularios
-   - .nav-*       : Navegacao
-   Sufixos de Estado:
-   - *--active    : Estado ativo
-   - *--disabled  : Estado desabilitado
-   - *--loading   : Estado de loading
-   - *--error     : Estado de erro
-   Validacao:
-   morph-spec validate-css src/MyApp.Web
-   =========================================================================== */
-/* ===========================================================================
-   SECAO 1-99: TOKENS E VARIAVEIS CSS
-   =========================================================================== */
-:root {
-  /* Cores Primarias */
-  --primary: #3b82f6;
-  --primary-hover: #2563eb;
-  --primary-active: #1d4ed8;
-  /* Cores Secundarias */
-  --secondary: #6b7280;
-  --secondary-hover: #4b5563;
-  /* Cores Semanticas */
-  --success: #10b981;
-  --warning: #f59e0b;
-  --error: #ef4444;
-  --info: #06b6d4;
-  /* Neutros */
-  --neutral-50: #f9fafb;
-  --neutral-100: #f3f4f6;
-  --neutral-200: #e5e7eb;
-  --neutral-300: #d1d5db;
-  --neutral-400: #9ca3af;
-  --neutral-500: #6b7280;
-  --neutral-600: #4b5563;
-  --neutral-700: #374151;
-  --neutral-800: #1f2937;
-  --neutral-900: #111827;
-  /* Tipografia */
-  --font-family: 'Inter', system-ui, -apple-system, sans-serif;
-  --font-family-mono: 'JetBrains Mono', monospace;
-  --font-size-xs: 0.75rem;   /* 12px */
-  --font-size-sm: 0.875rem;  /* 14px */
-  --font-size-base: 1rem;    /* 16px */
-  --font-size-lg: 1.125rem;  /* 18px */
-  --font-size-xl: 1.25rem;   /* 20px */
-  --font-size-2xl: 1.5rem;   /* 24px */
-  --font-size-3xl: 1.875rem; /* 30px */
-  --font-size-4xl: 2.25rem;  /* 36px */
-  /* Espacamento (base 4px) */
-  --space-1: 0.25rem;  /* 4px */
-  --space-2: 0.5rem;   /* 8px */
-  --space-3: 0.75rem;  /* 12px */
-  --space-4: 1rem;     /* 16px */
-  --space-5: 1.25rem;  /* 20px */
-  --space-6: 1.5rem;   /* 24px */
-  --space-8: 2rem;     /* 32px */
-  --space-10: 2.5rem;  /* 40px */
-  --space-12: 3rem;    /* 48px */
-  /* Border Radius */
-  --radius-sm: 0.25rem;  /* 4px */
-  --radius-md: 0.5rem;   /* 8px */
-  --radius-lg: 0.75rem;  /* 12px */
-  --radius-xl: 1rem;     /* 16px */
-  --radius-full: 9999px;
-  /* Sombras */
-  --shadow-sm: 0 1px 2px 0 rgb(0 0 0 / 0.05);
-  --shadow-md: 0 4px 6px -1px rgb(0 0 0 / 0.1);
-  --shadow-lg: 0 10px 15px -3px rgb(0 0 0 / 0.1);
-  --shadow-xl: 0 20px 25px -5px rgb(0 0 0 / 0.1);
-  /* Transicoes */
-  --transition-fast: 150ms ease;
-  --transition-normal: 300ms ease;
-  --transition-slow: 500ms ease;
-  /* Z-Index */
-  --z-dropdown: 1000;
-  --z-sticky: 1020;
-  --z-fixed: 1030;
-  --z-modal-backdrop: 1040;
-  --z-modal: 1050;
-  --z-popover: 1060;
-  --z-tooltip: 1070;
-}
-/* ===========================================================================
-   SECAO 100-199: RESET E BASE STYLES
-   =========================================================================== */
-/* ... */
-/* ===========================================================================
-   SECAO 200-299: TIPOGRAFIA
-   =========================================================================== */
-/* ... */
-/* ===========================================================================
-   SECAO 300-399: LAYOUT E CONTAINERS
-   =========================================================================== */
-.page-layout {
-  min-height: 100vh;
-  display: flex;
-  flex-direction: column;
-}
-.page-content {
-  flex: 1;
-  padding: var(--space-6);
-}
-.container {
-  width: 100%;
-  max-width: 1280px;
-  margin: 0 auto;
-  padding: 0 var(--space-4);
-}
-/* ===========================================================================
-   SECAO 400-499: COMPONENTES BASE
-   =========================================================================== */
-/* Botoes */
-.btn-primary { /* ... */ }
-.btn-secondary { /* ... */ }
-/* Cards */
-.card { /* ... */ }
-.card-premium { /* ... */ }
-/* Inputs */
-.input { /* ... */ }
-/* ===========================================================================
-   SECAO 500-599: COMPONENTES COMPOSTOS
-   =========================================================================== */
-/* Forms */
-.form-group { /* ... */ }
-.form-label { /* ... */ }
-/* Tables */
-.data-table { /* ... */ }
-/* ===========================================================================
-   SECAO 600-699: NAVEGACAO
-   =========================================================================== */
-.page-header-nav { /* ... */ }
-.page-footer { /* ... */ }
-.sidebar { /* ... */ }
-/* ===========================================================================
-   SECAO 700-799: PAGINAS ESPECIFICAS
-   =========================================================================== */
-/* Home */
-.home-hero { /* ... */ }
-.home-features { /* ... */ }
-/* Checkout */
-.checkout-form { /* ... */ }
-.checkout-summary { /* ... */ }
-/* ===========================================================================
-   SECAO 800-849: MODAIS E OVERLAYS
-   =========================================================================== */
-.modal-overlay {
-  position: fixed;
-  inset: 0;
-  background: rgba(0, 0, 0, 0.5);
-  backdrop-filter: blur(4px);
-  z-index: var(--z-modal-backdrop);
-}
-.modal-container {
-  position: fixed;
-  top: 50%;
-  left: 50%;
-  transform: translate(-50%, -50%);
-  z-index: var(--z-modal);
-}
-/* ===========================================================================
-   SECAO 850-899: ANIMACOES E KEYFRAMES
-   =========================================================================== */
-@keyframes slideInUp {
-  from {
-    opacity: 0;
-    transform: translateY(20px);
-  }
-  to {
-    opacity: 1;
-    transform: translateY(0);
-  }
-}
-@keyframes scaleIn {
-  from {
-    opacity: 0;
-    transform: scale(0.95);
-  }
-  to {
-    opacity: 1;
-    transform: scale(1);
-  }
-}
-.animate-slideInUp {
-  animation: slideInUp var(--transition-normal) forwards;
-}
-.animate-scaleIn {
-  animation: scaleIn var(--transition-fast) forwards;
-}
-/* Stagger delays para animacoes em sequencia */
-.stagger-1 { animation-delay: 0.1s; }
-.stagger-2 { animation-delay: 0.2s; }
-.stagger-3 { animation-delay: 0.3s; }
-.stagger-4 { animation-delay: 0.4s; }
-.stagger-5 { animation-delay: 0.5s; }
-/* ===========================================================================
-   SECAO 900-949: RESPONSIVO E MEDIA QUERIES
-   =========================================================================== */
-@media (max-width: 768px) {
-  /* Tablet e Mobile */
-}
-@media (max-width: 480px) {
-  /* Mobile */
-}
-/* ===========================================================================
-   SECAO 950-979: UTILITIES E HELPERS
-   =========================================================================== */
-.sr-only {
-  position: absolute;
-  width: 1px;
-  height: 1px;
-  padding: 0;
-  margin: -1px;
-  overflow: hidden;
-  clip: rect(0, 0, 0, 0);
-  white-space: nowrap;
-  border: 0;
-}
-/* ===========================================================================
-   SECAO 980-989: OVERRIDES DE FLUENT UI / MUDBLAZOR
-   =========================================================================== */
-/* Fluent UI overrides */
-.fluent-card {
-  /* Customizacoes */
-}
-/* ===========================================================================
-   SECAO 990-999: HOTFIXES E TEMPORARIOS
-   =========================================================================== */
-/* TODO: Remover apos fix no componente X */
-```
-## Uso
-1. Copie o header para o inicio do seu `design-system.css`
-2. Substitua `{PROJECT_NAME}` pelo nome do seu projeto
-3. Adicione suas classes CSS nas secoes apropriadas
-4. Mantenha o indice atualizado conforme adiciona novas secoes
-## Beneficios
-- **Navegacao rapida:** Use Ctrl+G (go to line) para pular para secoes
-- **Organizacao clara:** Cada tipo de componente em sua secao
-- **Facil manutencao:** Encontre onde adicionar novos estilos
-- **Evita conflitos:** Prefixos por pagina previnem colisoes
----
-*Template MORPH-SPEC v2.2.0 by Polymorphism Tech*

package/.morph/framework/templates/examples/spec-examples.md DELETED Viewed

@@ -1,90 +0,0 @@
-# Spec Template Reference
-> **Layer:** 3 | **Load:** on-demand | **Keywords:** spec, specification, template
-**Use the stack's `.morph/framework/templates/spec.md` as the canonical template.**
-This file contains extended examples for each spec section.
----
-## Example: Entity (Pseudo-code)
-```csharp
-class ProcessingJob {
-  Guid Id
-  string OriginalPhotoUrl     // Azure Blob URL, max 500 chars
-  string? ProcessedPhotoUrl   // Nullable, populated after processing
-  ProcessingStatus Status     // Enum: Pending, Processing, Completed, Failed
-  DateTime CreatedAt
-  ICollection<ExecutionLog> Logs  // 1:N relationship
-}
-enum ProcessingStatus {
-  Pending = 0, Processing = 1, Completed = 2,  // Normal flow
-  Failed = 100                                   // Error states (high values)
-}
-```
-## Example: Command (Pseudo-code)
-```csharp
-UploadPhotoCommand {
-  Input: IFormFile photo, string? email
-  Output: Guid jobId
-  Handler:
-    1. Validate file (size <= 10MB, type in [.jpg, .png])
-    2. Upload to Azure Blob Storage
-    3. Create ProcessingJob entity (status = Pending)
-    4. Enqueue Hangfire background job
-    5. Return jobId
-}
-```
-## Example: API Endpoints
-```csharp
-PhotoProcessingController {
-  POST /api/upload        → multipart/form-data → { jobId: Guid }
-  GET  /api/status/{id}   → jobId → { status, progress, createdAt }
-  GET  /api/download/{id} → jobId → Redirect to Blob URL or 404
-}
-```
-## Example: Flow
-```
-Upload Flow (Actor: User)
-1. User selects photo → System validates (size, type) → If invalid: show error
-2. User sees preview → clicks "Upload"
-3. System creates ProcessingJob → uploads to Blob → enqueues Hangfire job → returns jobId
-4. System navigates to /processing/{jobId} → polls every 5s
-End State: User on progress page, job processing in background
-```
-## Example: ADR
-### ADR-001: Use Hangfire for Background Jobs
-**Status:** Accepted
-**Context:** Need background processing for AI photo transformation (30-120s).
-**Decision:** Hangfire (self-hosted).
-**Alternatives:**
-1. Azure Functions — serverless, auto-scaling, but cold start + $10/mo for 50k jobs
-2. Hangfire — zero cost, simpler, but scales with app
-3. Quartz.NET — more features, but steeper learning curve
-**Trade-offs:** Simplicity vs Features (Hangfire sufficient for MVP)
-## Example: Cost Estimate
-| Resource | SKU | Monthly | Justification |
-|----------|-----|---------|---------------|
-| Blob Storage | LRS | $0.02 | Store photos, low redundancy OK |
-| Azure SQL | Basic | $4.99 | < 100k jobs/month |
-| Container App | Consumption | $0.49 | Scale to zero |
-| Hangfire | Self-hosted | $0.00 | In-process |
-| **Total** | | **~$5.50** | |
----
-*MORPH-SPEC by Polymorphism Tech*

package/.morph/framework/templates/feature/decisions.md DELETED Viewed

@@ -1,187 +0,0 @@
-# Architecture Decision Records - {{titleCase FEATURE_NAME}}
-## ADR-001: {Decision Title}
-**Date:** {{DATE}}
-**Status:** Proposed | Accepted | Deprecated | Superseded
-**Deciders:** MORPH Agents, Developer
-### Context
-{Describe the context and problem that led to this decision}
-### Decision
-{Describe the decision made}
-### Consequences
-**Pros:**
-- {Positive consequence 1}
-- {Positive consequence 2}
-**Cons:**
-- {Negative consequence 1}
-**Risks:**
-- {Identified risk}
-### Alternatives Considered
-#### Option A: {Name}
-- Pros: {advantages}
-- Cons: {disadvantages}
-- **Rejected because:** {reason}
-#### Option B: {Name}
-- Pros: {advantages}
-- Cons: {disadvantages}
-- **Rejected because:** {reason}
-{{#if (eq STACK "blazor-azure")}}
-### Affected Flows
-- **Main flow:** {ex: Upload -> Payment -> Generation -> Email}
-- **Alternative flow:** {ex: Upload -> Generation -> Payment -> Email}
-- **Free flow:** {ex: Upload -> Generation -> Download}
-### Impacted State Validations
-> **Reference:** `framework/standards/status-validation.md`
-| Service | Method | Accepted States |
-|---------|--------|-----------------|
-| {ServiceName} | {MethodName} | {ex: PendingPayment, Completed} |
-### UI Components with Special Behavior
-- {ex: FluentDialog requires initial Hidden="true"}
-- {ex: Modal needs @ref for programmatic control}
-{{/if}}
----
-{{#if (eq STACK "blazor-azure")}}
-## ADR-002: Database Model
-**Date:** {{DATE}}
-**Status:** Accepted
-### Context
-Need to define how {Feature} data will be stored.
-### Decision
-Use Azure SQL with the following model:
-- {Entity} table with {columns}
-- JSON columns for {flexible data}
-### Consequences
-**Pros:**
-- Fits within free tier (32GB)
-- Good query performance
----
-## ADR-003: AI Integration
-**Date:** {{DATE}}
-**Status:** Accepted
-### Context
-Feature requires AI capabilities for {purpose}.
-### Decision
-Use MS Agent Framework with gpt-4o-mini model.
-### Consequences
-**Pros:**
-- Cost effective (~$0.15/1M input tokens)
-- Good enough quality for this use case
-**Cons:**
-- Slightly less capable than gpt-4o
-{{/if}}
-{{#if (eq STACK "nextjs-supabase")}}
-## ADR-002: Database Access Strategy
-**Date:** {{DATE}}
-**Status:** Accepted
-### Context
-Need to decide how the .NET API accesses Supabase PostgreSQL.
-### Decision
-Use Dapper with Npgsql for direct SQL queries. No EF Core.
-### Consequences
-**Pros:**
-- Full control over SQL queries
-- Better performance (no ORM overhead)
-- Direct access to PostgreSQL features (jsonb, pgvector, functions)
-- RLS policies apply naturally through connection
-**Cons:**
-- No automatic migrations (use Supabase CLI instead)
-- Manual SQL query writing
-- No change tracking
----
-## ADR-003: Auth Strategy
-**Date:** {{DATE}}
-**Status:** Accepted
-### Context
-Need authentication for both Next.js frontend and .NET API.
-### Decision
-Use Supabase Auth with @supabase/ssr on frontend. Validate JWT tokens in .NET API middleware.
-### Consequences
-**Pros:**
-- Single auth provider for both layers
-- RLS policies work automatically with auth.uid()
-- Built-in social login, magic links, email/password
-- No separate auth service to maintain
-**Cons:**
-- Coupled to Supabase ecosystem
-- JWT secret must be shared with .NET API
-{{/if}}
----
-## Template for New ADRs
-```markdown
-## ADR-XXX: {Title}
-**Date:**
-**Status:** Proposed | Accepted | Deprecated | Superseded
-### Context
-{Why is this decision needed?}
-### Decision
-{What was decided?}
-### Consequences
-**Pros:** {list}
-**Cons:** {list}
-```
----
-*Generated by MORPH Framework*