docs: Adicionar guia de publicação no npm

- Documentar fluxo completo: changeset → version → publish
- Incluir instruções de consumo dos pacotes
- Adicionar estratégia de versionamento e troubleshooting

Author: wilcorrea

ai-friendly/.github/instructions/ybyra-domain.instructions.md

@@ -33,4 +33,4 @@ When editing files in `domain/` directories, follow these rules:
 
 ## Reference
 
-See `ai-friendly/rules/` and `ai-friendly/skills/create-domain/` for full details.
+See the [Core Concepts](https://devitools.github.io/ybyra/guide/schema-definition) and [Domain Layer](https://devitools.github.io/ybyra/react/domain) guides for full details.

ai-friendly/.github/instructions/ybyra-react-web.instructions.md

@@ -8,22 +8,31 @@ When editing React Web pages for Ybyra:
 
 ## Page Pattern
 
-```
-import { Scope } from "@ybyra/core";
-import { allPermissions, {Domain}Schema } from "@ybyra/demo";
-import { DataForm, DataPage, useComponent } from "@ybyra/react-web";
-import { useNavigate } from "react-router-dom";
+```tsx-no-check
+import { useNavigate } from 'react-router-dom';
+import { DataForm, DataPage, useComponent } from '@ybyra/react-web';
+import { permissions } from '@src/auth';
+import { ExampleSchema } from '@src/domain/example';
 
-export function {Domain}Page() {
+export function ExamplePage () {
   const navigate = useNavigate();
   const component = useComponent(scope, scopes, navigate);
-  const schema = {Domain}Schema.provide();
+  const schema = ExampleSchema.provide();
 
   return (
-    <DataPage domain={schema.domain} scope={scope} permissions={allPermissions(schema)}>
-      <DataForm schema={schema} scope={scope} ... />
+    <DataPage
+      domain={schema.domain}
+      scope={scope}
+      permissions={permissions}
+    >
+      <DataForm
+        schema={schema}
+        scope={scope}
+        permissions={permissions}
+        ...
+      />
     </DataPage>
-  );
+  )
 }
 ```
 
@@ -37,4 +46,4 @@ export function {Domain}Page() {
 
 ## Reference
 
-See `ai-friendly/frameworks/react-web.md` for complete guide.
+See the [React Web guide](https://devitools.github.io/ybyra/react/overview) for complete documentation.

ai-friendly/.github/instructions/ybyra-svelte.instructions.md

@@ -8,19 +8,20 @@ When editing SvelteKit pages for Ybyra:
 
 ## Page Pattern
 
-```
+```svelte-no-check
 <script lang="ts">
   import { goto } from "$app/navigation";
   import { base } from "$app/paths";
   import { Scope } from "@ybyra/core";
-  import { allPermissions, {Domain}Schema } from "@ybyra/demo";
+  import { permissions } from "@src/auth";
+  import { ExampleSchema } from "@/domain/example";
   import { createComponent, DataForm, DataPage } from "@ybyra/sveltekit";
 
-  const schema = {Domain}Schema.provide();
+  const schema = ExampleSchema.provide();
   const component = createComponent(scope, scopes, goto, base);
 </script>
 
-<DataPage domain={schema.domain} scope={scope} permissions={allPermissions(schema)}>
+<DataPage domain={schema.domain} scope={scope} permissions={permissions}>
   <DataForm schema={schema} scope={scope} ... />
 </DataPage>
 ```
@@ -35,4 +36,4 @@ When editing SvelteKit pages for Ybyra:
 
 ## Reference
 
-See `ai-friendly/frameworks/sveltekit.md` for complete guide.
+See the [SvelteKit guide](https://devitools.github.io/ybyra/svelte/overview) for complete documentation.

ai-friendly/.github/instructions/ybyra-vue.instructions.md

@@ -8,7 +8,7 @@ When editing Vue pages for Ybyra:
 
 ## Page Pattern
 
-```
+```vue-no-check
 <template>
   <DataPage :domain="domain" :scope="scope" :permissions="permissions">
     <DataForm :schema="schema" :scope="scope" ... />
@@ -17,10 +17,11 @@ When editing Vue pages for Ybyra:
 
 <script setup lang="ts">
 import { Scope } from "@ybyra/core";
-import { allPermissions, {Domain}Schema } from "@ybyra/demo";
+import { permissions } from "@src/auth";
+import { ExampleSchema } from "@/domain/example";
 import { DataForm, DataPage, useComponent } from "@ybyra/vue-quasar";
 
-const schema = {Domain}Schema.provide();
+const schema = ExampleSchema.provide();
 const component = useComponent(scope, scopes);
 </script>
 ```
@@ -34,4 +35,4 @@ const component = useComponent(scope, scopes);
 
 ## Reference
 
-See `ai-friendly/frameworks/vue-quasar.md` for complete guide.
+See the [Vue + Quasar guide](https://devitools.github.io/ybyra/vue/overview) for complete documentation.

ai-friendly/examples/person/domain.md

@@ -2,9 +2,9 @@
 
 ## Schema Definition (`domain/person/schema.ts`)
 
-```typescript
+```ts-no-check
 import { action, date, group, text, Text, toggle, Position, Scope } from "@ybyra/core";
-import { schema } from "../../settings/schema";
+import { schema } from "@/settings/schema";
 
 export const PersonSchema = schema.create("person", {
   groups: {
@@ -29,8 +29,8 @@ export const PersonSchema = schema.create("person", {
 
 ## Events (`domain/person/events.ts`)
 
-```typescript
-import { PersonSchema } from "./schema";
+```ts-no-check
+import { PersonSchema } from "@/domain/person/schema";
 
 export const personEvents = PersonSchema.events({
   active: {
@@ -55,10 +55,10 @@ export const personEvents = PersonSchema.events({
 
 ## Handlers (`domain/person/handlers.ts`)
 
-```typescript
+```ts-no-check
 import type { ServiceContract } from "@ybyra/core";
-import { PersonSchema } from "./schema";
-import { createDefault } from "../../settings/handlers";
+import { PersonSchema } from "@/domain/person/schema";
+import { createDefault } from "@/settings/handlers";
 
 export function createPersonHandlers(service: ServiceContract) {
   return PersonSchema.handlers({
@@ -72,10 +72,10 @@ export function createPersonHandlers(service: ServiceContract) {
 
 ## Hooks (`domain/person/hooks.ts`)
 
-```typescript
+```ts-no-check
 import type { ServiceContract } from "@ybyra/core";
-import { PersonSchema } from "./schema";
-import { createDefault } from "../../settings/hooks";
+import { PersonSchema } from "@/domain/person/schema";
+import { createDefault } from "@/settings/hooks";
 
 export function createPersonHooks(service: ServiceContract) {
   return PersonSchema.hooks(createDefault(service));
@@ -84,8 +84,8 @@ export function createPersonHooks(service: ServiceContract) {
 
 ## Barrel Export (`domain/person/index.ts`)
 
-```typescript
-export { PersonSchema } from "./schema";
+```ts-no-check
+export { PersonSchema } from "@/domain/person/schema";
 export { personEvents } from "./events";
 export { createPersonHandlers } from "./handlers";
 export { createPersonHooks } from "./hooks";

ai-friendly/examples/person/i18n.md

@@ -2,7 +2,7 @@
 
 ## Locale File
 
-```typescript
+```ts-no-check
 // settings/locales/pt-BR.ts
 export const ptBR = {
   person: {
@@ -43,7 +43,7 @@ export const ptBR = {
 
 ## Merge with core translations
 
-```typescript
+```ts-no-check
 import { ptBR } from "@ybyra/core";       // common translations
 import { ptBR as local } from "./locales/pt-BR";  // domain translations
 

ai-friendly/examples/person/pages/react-native.md

@@ -1,9 +1,10 @@
 # Person Domain — React Native Screens
 
 ## Setup (demo.ts)
-```typescript
+
+```ts-no-check
 import { createLocalDriver } from "@ybyra/persistence";
-import { createPersonService, createPersonHandlers, createPersonHooks } from "@ybyra/demo";
+import { createPersonService, createPersonHandlers, createPersonHooks } from "@/domain/person";
 
 const driver = createLocalDriver();
 export const personService = createPersonService(driver);