@pacp/spec 3.4.1 → 3.5.0

package/dist/index.d.cts

@@ -475,6 +475,10 @@ interface PriceList {
 interface Catalog {
     id: string;
     name?: string;
+    /** Observações públicas sobre o catálogo. Consumidores PODEM exibir. */
+    notes?: string;
+    /** Anotações não-públicas. Consumidores que geram catálogos públicos DEVEM omitir. Ver spec §9.1. */
+    internal_notes?: string;
     default_price_list_id?: string;
     price_lists?: PriceList[];
     [key: `x-${string}`]: unknown;

package/dist/index.d.ts

@@ -475,6 +475,10 @@ interface PriceList {
 interface Catalog {
     id: string;
     name?: string;
+    /** Observações públicas sobre o catálogo. Consumidores PODEM exibir. */
+    notes?: string;
+    /** Anotações não-públicas. Consumidores que geram catálogos públicos DEVEM omitir. Ver spec §9.1. */
+    internal_notes?: string;
     default_price_list_id?: string;
     price_lists?: PriceList[];
     [key: `x-${string}`]: unknown;

package/dist/pacp.schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://cdn.jsdelivr.net/npm/@pacp/spec@latest/dist/pacp.schema.json",
-  "title": "PACP v3.4.1",
+  "title": "PACP v3.5.0",
   "oneOf": [
     {
       "$ref": "#/$defs/catalog_document"
@@ -183,6 +183,14 @@
           "type": "string",
           "minLength": 1
         },
+        "notes": {
+          "type": "string",
+          "description": "Observações públicas sobre o catálogo (vigência, escopo, instruções de uso). Texto livre, multilinha permitido. Consumidores PODEM exibir."
+        },
+        "internal_notes": {
+          "type": "string",
+          "description": "Anotações internas (não-públicas) sobre o catálogo. Consumidores que geram vitrines/catálogos públicos DEVEM omitir este campo. Ver spec §9.1."
+        },
         "default_price_list_id": {
           "type": "string",
           "minLength": 1
@@ -331,7 +339,7 @@
             },
             "minItems": 1
           },
-          "description": "Categorias hier\u00e1rquicas do produto. Cada item \u00e9 um path da raiz \u00e0 folha, ex.: [[\"M\u00f3veis\", \"Sof\u00e1\"], [\"Promo\u00e7\u00f5es\"]]."
+          "description": "Categorias hierárquicas do produto. Cada item é um path da raiz à folha, ex.: [[\"Móveis\", \"Sofá\"], [\"Promoções\"]]."
         },
         "gtin": {
           "type": "string",
@@ -364,7 +372,7 @@
             "type": "string",
             "minLength": 1
           },
-          "description": "Identificadores de cole\u00e7\u00f5es \u00e0s quais o produto pertence (ex.: \"verao_2026\", \"linha_premium\"). Cada item \u00e9 um ID est\u00e1vel, \u00fanico por cat\u00e1logo, com sem\u00e2ntica de agrupamento curatorial/sazonal."
+          "description": "Identificadores de coleções às quais o produto pertence (ex.: \"verao_2026\", \"linha_premium\"). Cada item é um ID estável, único por catálogo, com semântica de agrupamento curatorial/sazonal."
         },
         "weight": {
           "$ref": "#/$defs/measure"
@@ -401,7 +409,7 @@
           "items": {
             "$ref": "#/$defs/supplied_material"
           },
-          "description": "Materiais consumidos pelo produto, com sourcing factory/customer. Ver se\u00e7\u00e3o 4.8."
+          "description": "Materiais consumidos pelo produto, com sourcing factory/customer. Ver seção 4.8."
         },
         "ruleset_ids": {
           "type": "array",
@@ -1190,7 +1198,7 @@
         "position": {
           "type": "integer",
           "minimum": 0,
-          "description": "Ordem expl\u00edcita de exibi\u00e7\u00e3o; quando presente, consumidores DEVEM ordenar por position crescente."
+          "description": "Ordem explícita de exibição; quando presente, consumidores DEVEM ordenar por position crescente."
         },
         "type": {
           "type": "string",
@@ -1305,7 +1313,7 @@
           }
         }
       ],
-      "description": "Quantidade de insumo necess\u00e1ria. Aceita value fixo (number > 0) OU table_id (lookup). Sempre exige unit."
+      "description": "Quantidade de insumo necessária. Aceita value fixo (number > 0) OU table_id (lookup). Sempre exige unit."
     },
     "supplied_material_cost": {
       "type": "object",
@@ -1491,7 +1499,7 @@
           }
         }
       ],
-      "description": "Insumo consumido pelo produto, com regra de quem fornece (f\u00e1brica ou cliente). Ver se\u00e7\u00e3o 4.8 da spec."
+      "description": "Insumo consumido pelo produto, com regra de quem fornece (fábrica ou cliente). Ver seção 4.8 da spec."
     }
   }
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pacp/spec",
-  "version": "3.4.1",
+  "version": "3.5.0",
   "description": "PACP - Padrão Aberto de Catálogo e Precificação. Schema, profiles e validador para catálogos de produtos.",
   "type": "module",
   "main": "./dist/index.cjs",