@horizon-js/property-web-nextjs

Frontend Next.js do módulo imóvel do Horizon.

Release 1.0.0 — Escopo mínimo

Esta primeira release contém apenas:

• PropertyURLBuilder — builder pra URLs /imovel/{slug}/{reference} com suporte a catch-all routes do Next.js

import { PropertyURLBuilder } from "@horizon-js/property-web-nextjs"

const builder = new PropertyURLBuilder({ basePath: "/imovel" })

// Montar URL
builder.build({ slug: "apartamento-3-quartos-centro", reference: "REF123" })
// → "/imovel/apartamento-3-quartos-centro/REF123"

builder.build({ reference: "REF456" })
// → "/imovel/REF456"

// Parsear catch-all slugs
builder.parse(["apartamento-3-quartos", "REF123"])
// → { slug: "apartamento-3-quartos", reference: "REF123" }

Roadmap

2.0.0 (planejada) — componentes + feature-based provider composition

Absorver das 127 files de apps/web/src/modules/property/features/item-display/ do GHI-7661:

• UI — PropertyCard, PropertyDetailPage, PropertyHeading, PropertyInfoCard, PropertyValuesCard
• 16 sub-features de página de imóvel com padrão Feature-Based Provider Composition: Location, Financing, Contact, Photo, Video, Tour, Status Stripe, Info Display, SEO, Media Nav, Options Buttons, Request Buttons, Share, Report, Inspect, Similar Properties
• Contratos tipados — interfaces estáveis por sub-feature, resolvers trocáveis por CRM
• Providers — PropertyPageProvider distribui estado pros sub-providers
• Docs em docs/FEATURE-BASED-PROVIDER-COMPOSITION.md (ver também projetão reorganizacao-pacotes-npm/07-PROPERTY-WEB-NEXTJS.md quando criado)

2.x — hooks de domínio

• useProperty(id), usePropertyList(filters), usePropertyFavorites()
• Dependente da finalização do @horizon-js/web-nextjs/frontend-query-engine com TanStack hooks

Parte do módulo complexo property

Conforme 06-MODULOS-COMPLEXOS-VS-LEVES.md do projetão Horizon 2.3, property é módulo complexo com 4 pacotes versionados independentemente:

| Pacote | Camada | Status | |---|---|---| | @horizon-js/property-domain-schema | Dados (shape de entidade) | 3.17.0 ✅ | | @horizon-js/property-api-nextjs | Backend (Prisma, endpoints) | pendente | | @horizon-js/property-web-nextjs | Frontend (este pacote) | 1.0.0 ✅ | | @horizon-js/property-automations-nextjs | Sync + automações | 1.0.0 ✅ |

Documentação

• docs/MODULO_FRONTEND.md — arquitetura planejada do módulo frontend (16 sub-features, padrões)
• docs/ISR_PROPERTY_PAGES.md — cache ISR + invalidação on-demand específico para páginas de imóvel
• CHANGELOG.md — histórico de versões