@sapphire-caitlyn/schema-kit-ng 0.0.0-stage → 0.0.2

package/README.md

@@ -1,3 +1,39 @@
-# Temporary Holding Version
+# schema-kit (`@sapphire-caitlyn/schema-kit-ng`)
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Lib de CRUD do backoffice: um `SchemaService` descreve a entidade, o `<schema-table>` faz a listagem e o
+`<schema-view>` faz o criar/editar. Cada componente tem um README ao lado do código, em `src/lib/components/`.
+
+## Entry points
+
+| Import                                 | Conteúdo                                                      |
+| -------------------------------------- | ------------------------------------------------------------- |
+| `@sapphire-caitlyn/schema-kit-ng`      | A lib (`src/public-api.ts`)                                   |
+| `@sapphire-caitlyn/schema-kit-ng/helm` | Componentes Spartan (helm) embutidos na lib (`helm/index.ts`) |
+
+No `front-backoffice` a app não usa o pacote: importa o código-fonte pelos aliases do `tsconfig.json`
+(`@schema-kit` e `@sapphire-caitlyn/schema-kit-ng/helm`), o que mantém o hot reload.
+
+> **Não edite o `dist/schema-kit/package.json`.** A lib importa o helm por `<name>/helm`, e esse texto
+> vai literal para o bundle. Renomear só no `dist` publica um pacote que importa o nome antigo
+> (`Failed to resolve import` em quem instala). Para renomear, troque o `name` aqui e o import do helm
+> em todo o código (lib, app, `tsconfig.json`, `components.json`, `helm-sync.mjs`) e gere o build.
+
+## Build e publicação
+
+Na raiz do `front-backoffice`:
+
+```bash
+npm run build:lib                  # helm:sync + ng build schema-kit → dist/schema-kit
+npm run publish:lib -- --dry-run   # empacota sem publicar
+npm run publish:lib                # build:lib + npm publish ./dist/schema-kit
+```
+
+Antes de publicar, suba a `version` neste `package.json`: o registry recusa uma versão já publicada.
+
+## Dependências
+
+Pacote externo usado pela lib ou pelo helm vai neste `package.json`:
+
+- em `peerDependencies`, quando a app deve fornecer uma cópia única (Angular, `@spartan-ng/brain`, embla, tanstack...);
+- em `dependencies`, para utilitários sem estado (`clsx`, `tailwind-merge`...). Nesse caso liste também em
+  `allowedNonPeerDependencies` do `ng-package.json`, senão o build recusa.