@segha/catalog 2.1.0 → 2.2.0

package/CHANGELOG.md

@@ -5,6 +5,17 @@ All notable changes to @segha/catalog will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.2.0] - 2026-02-06
+
+### Added
+
+- Schema `CatalogWikipediaSchema` was added
+- Schema `DetailedWikipediaSchema` was added
+- Schema `MetaWikipediaSchema` was added
+- Schema `WikipediaSchema` was added
+- **BREAKING** Property `status` in `ClothingSchema` changed from required to optional
+- **BREAKING** Property `status` in `DetailedClothingSchema` changed from required to optional
+
 ## [2.1.0] - 2026-02-05
 
 ### Added

package/README.md

@@ -41,17 +41,21 @@ import { MetaClothingSchema, CatalogClothingSchema, DetailedClothingSchema } fro
 - [CatalogBook](#catalogbook)
 - [CatalogClothing](#catalogclothing)
 - [CatalogMovie](#catalogmovie)
+- [CatalogWikipedia](#catalogwikipedia)
 - [Clothing](#clothing)
 - [DetailedArticle](#detailedarticle)
 - [DetailedBook](#detailedbook)
 - [DetailedClothing](#detailedclothing)
 - [DetailedMovie](#detailedmovie)
+- [DetailedWikipedia](#detailedwikipedia)
 - [MetaArticle](#metaarticle)
 - [MetaBook](#metabook)
 - [MetaClothing](#metaclothing)
 - [MetaMovie](#metamovie)
+- [MetaWikipedia](#metawikipedia)
 - [Movie](#movie)
 - [Note](#note)
+- [Wikipedia](#wikipedia)
 
 ## API Reference
 
@@ -188,6 +192,22 @@ _Object containing the following properties:_
 
 _(\*) Required._
 
+## CatalogWikipedia
+
+Wikipedia entry: Data obtainable from cataloging
+
+_Object containing the following properties:_
+
+| Property          | Description                  | Type            |
+| :---------------- | :--------------------------- | :-------------- |
+| **`title`** (\*)  | Title of the Wikipedia entry | `string`        |
+| `description`     | Description                  | `string`        |
+| `excerpt`         | Extract of the article       | `string`        |
+| **`author`** (\*) | Authors                      | `Array<string>` |
+| `published`       | Year of publication          | `string`        |
+
+_(\*) Required._
+
 ## Clothing
 
 Clothing item
@@ -287,6 +307,21 @@ _Object containing the following properties:_
 
 _(\*) Required._
 
+## DetailedWikipedia
+
+Wikipedia entry: Additional data
+
+_Object containing the following properties:_
+
+| Property            | Description           | Type                                                     |
+| :------------------ | :-------------------- | :------------------------------------------------------- |
+| **`status`** (\*)   | Reading status        | `'Pending' \| 'In Progress' \| 'Read' \| 'Consolidated'` |
+| **`projects`** (\*) | Projects              | `Array<string>`                                          |
+| **`topics`** (\*)   | Topics                | `Array<string>`                                          |
+| **`rating`** (\*)   | Rating of the article | `number`                                                 |
+
+_(\*) Required._
+
 ## MetaArticle
 
 Article: Metadata of Note
@@ -360,6 +395,25 @@ _Object containing the following properties:_
 
 _(\*) Required._
 
+## MetaWikipedia
+
+Wikipedia entry: Metadata of Note
+
+_Object containing the following properties:_
+
+| Property            | Description        | Type                         | Default       |
+| :------------------ | :----------------- | :--------------------------- | :------------ |
+| **`type`** (\*)     |                    | `'[[Sources]]'`              |               |
+| **`format`** (\*)   |                    | `'[[Encyclopedia Entries]]'` |               |
+| **`areas`** (\*)    |                    | `Array<'[[Knowledge]]'>`     |               |
+| **`color`** (\*)    |                    | `'#3171B2'`                  |               |
+| `icon`              | Lucide icon.       | `string`                     | `'wikipedia'` |
+| `banner`            |                    | `string`                     |               |
+| **`url`** (\*)      | URL of the article | `string`                     |               |
+| **`platform`** (\*) |                    | `'Wikipedia'`                |               |
+
+_(\*) Required._
+
 ## Movie
 
 Movie
@@ -401,3 +455,32 @@ _Union of the following possible types:_
 - [Book](#book)
 - [Clothing](#clothing)
 - [Movie](#movie)
+- [Wikipedia](#wikipedia)
+
+## Wikipedia
+
+Wikipedia entry
+
+_Object containing the following properties:_
+
+| Property            | Description                  | Type                                                     | Default       |
+| :------------------ | :--------------------------- | :------------------------------------------------------- | :------------ |
+| **`title`** (\*)    | Title of the Wikipedia entry | `string`                                                 |               |
+| `description`       | Description                  | `string`                                                 |               |
+| `excerpt`           | Extract of the article       | `string`                                                 |               |
+| **`author`** (\*)   | Authors                      | `Array<string>`                                          |               |
+| `published`         | Year of publication          | `string`                                                 |               |
+| **`status`** (\*)   | Reading status               | `'Pending' \| 'In Progress' \| 'Read' \| 'Consolidated'` |               |
+| **`projects`** (\*) | Projects                     | `Array<string>`                                          |               |
+| **`topics`** (\*)   | Topics                       | `Array<string>`                                          |               |
+| **`rating`** (\*)   | Rating of the article        | `number`                                                 |               |
+| **`type`** (\*)     |                              | `'[[Sources]]'`                                          |               |
+| **`format`** (\*)   |                              | `'[[Encyclopedia Entries]]'`                             |               |
+| **`areas`** (\*)    |                              | `Array<'[[Knowledge]]'>`                                 |               |
+| **`color`** (\*)    |                              | `'#3171B2'`                                              |               |
+| `icon`              | Lucide icon.                 | `string`                                                 | `'wikipedia'` |
+| `banner`            |                              | `string`                                                 |               |
+| **`url`** (\*)      | URL of the article           | `string`                                                 |               |
+| **`platform`** (\*) |                              | `'Wikipedia'`                                            |               |
+
+_(\*) Required._

package/en/Note.ts

@@ -4,10 +4,12 @@ import { ArticleSchema } from "./Article";
 import { BookSchema } from "./Book";
 import { ClothingSchema } from "./Clothing";
 import { MovieSchema } from "./Movie";
+import { WikipediaSchema } from "./Wikipedia";
 
 export const NoteSchema = z.union([
   ArticleSchema,
   BookSchema,
   ClothingSchema,
   MovieSchema,
+  WikipediaSchema,
 ]).describe('Note: Union of all note types');

package/en/Wikipedia/index.ts

@@ -0,0 +1,18 @@
+
+import z from "zod";
+import { MetaArticleSchema, CatalogArticleSchema, DetailedArticleSchema } from "../Article";
+
+export const MetaWikipediaSchema = MetaArticleSchema.extend({
+  icon: z.string().optional().default('wikipedia').describe('Lucide icon.'),
+  format: z.literal("[[Encyclopedia Entries]]"),
+  platform: z.literal("Wikipedia"),
+}).describe('Wikipedia entry: Metadata of Note');
+
+export const CatalogWikipediaSchema = CatalogArticleSchema.extend({
+  title: z.string().describe('Title of the Wikipedia entry'),
+}).describe('Wikipedia entry: Data obtainable from cataloging');
+
+export const DetailedWikipediaSchema = DetailedArticleSchema.extend({
+}).describe('Wikipedia entry: Additional data');
+
+export const WikipediaSchema = CatalogWikipediaSchema.extend(DetailedWikipediaSchema.shape).extend(MetaWikipediaSchema.shape).describe('Wikipedia entry');

package/en/Wikipedia/types.ts

@@ -0,0 +1,10 @@
+
+
+import type { z } from 'zod';
+
+import type { WikipediaSchema, CatalogWikipediaSchema, DetailedWikipediaSchema, MetaWikipediaSchema } from ".";
+
+export type Wikipedia = z.infer<typeof WikipediaSchema>;
+export type CatalogWikipedia = z.infer<typeof CatalogWikipediaSchema>;
+export type DetailedWikipedia = z.infer<typeof DetailedWikipediaSchema>;
+export type MetaWikipedia = z.infer<typeof MetaWikipediaSchema>;

package/en/index.ts

@@ -3,3 +3,4 @@ export * from './Book';
 export * from './Clothing';
 export * from './Movie';
 export * from './Note';
+export * from './Wikipedia';

package/es/Article/index.ts

@@ -1,29 +1,34 @@
 
 import z from "zod";
 
+import { Areas } from '../Areas';
+
 export const MetaArticleSchema = z.object({
   type: z.literal("[[Fuentes]]"),
   format: z.literal("[[Artículos]]"),
-  areas: z.array(z.literal("[[Conocimiento]]")),
-  color: z.literal("#3171B2"),
-  icon: z.literal("newspaper"),
-  banner: z.string().optional(),
-  url: z.string().describe('URL del artículo'),
+  areas: Areas.default(["[[Conocimiento]]"]),
+  color: z.string().optional().default("#3171B2").describe('Color de la nota.'),
+  icon: z.string().optional().default('newspaper').describe('Icono de Lucide.'),
+  banner: z.string().nullable().optional().describe('Banner de la nota.'),
+  url: z.string().optional().describe('URL del artículo'),
 }).describe('Artículo: Metadatos de Nota');
 
 export const CatalogArticleSchema = z.object({
   title: z.string().describe('Título del artículo'),
-  description: z.string().optional().describe('Descripción'),
+  description: z.string().nullable().optional().describe('Descripción'),
   excerpt: z.string().optional().describe('Extracto del artículo'),
-  author: z.array(z.string()).describe('Autores'),
-  published: z.string().optional().describe('Año de publicación'),
+  author: z.array(z.string()).optional().describe('Autores'),
+  published: z.union([z.string(), z.number()])
+    .transform((val) => String(val))
+    .optional()
+    .describe('Año de publicación'),
 }).describe('Artículo: Datos obtenibles de catalogación');
 
 export const DetailedArticleSchema = z.object({
   status: z.enum(["Pendiente", "En Proceso", "Leído", "Consolidado"]).describe('Estado de lectura'),
-  projects: z.array(z.string()).describe('Proyectos'),
-  topics: z.array(z.string()).describe('Temas'),
-  rating: z.number().describe('Puntuación del artículo'),
+  projects: z.array(z.string()).optional().describe('Proyectos'),
+  topics: z.array(z.string()).optional().describe('Temas'),
+  rating: z.number().optional().describe('Puntuación del artículo'),
 }).describe('Artículo: Datos adicionales');
 
 export const ArticleSchema = CatalogArticleSchema.extend(DetailedArticleSchema.shape).extend(MetaArticleSchema.shape).describe('Artículo');

package/es/Book/index.ts

@@ -1,15 +1,16 @@
 
 import z from "zod";
+import { Areas } from "../Areas";
 
 export const MetaBookSchema= z.object({
   type: z.literal("[[Fuentes]]"),
   format: z.literal("[[Libros]]"),
-  areas: z.array(z.literal("[[Knowledge]]")),
-  color: z.literal("#3171B2"),
-  icon: z.literal("book"),
-  cover: z.string().optional(),
-  url: z.string().describe('URL del libro en Amazon o similar'),
-  read_url: z.string().describe('URL de la lectura del libro'),
+  areas: Areas.default(["[[Conocimiento]]"]),
+  color: z.string().optional().default("#3171B2").describe('Color de la nota.'),
+  icon: z.string().optional().default('book').describe('Icono de Lucide.'),
+  cover: z.string().optional().describe('Portada del libro.'),
+  url: z.string().optional().describe('URL del libro en Amazon o similar'),
+  read_url: z.string().optional().describe('URL de la lectura del libro'),
 }).describe('Libro: Metadatos de Nota');
 
 export const CatalogBookSchema = z.object({
@@ -17,17 +18,19 @@ export const CatalogBookSchema = z.object({
   subtitle: z.string().optional().describe('Subtítulo del libro'),
   description: z.string().optional().describe('Descripción del libro'),
   author: z.array(z.string()).describe('Autores'),
-  published: z.string().describe('Año de publicación'),
-  categories: z.array(z.string()).describe('Géneros'),
+  published: z.union([z.string(), z.number()])
+  .transform((val) => String(val))
+  .optional().describe('Año de publicación'),
+  categories: z.array(z.string()).optional().describe('Géneros'),
 }).describe('Libro: Datos obtenibles de catalogación');
 
 export const DetailedBookSchema = z.object({
   status: z.enum(["Pendiente", "En Proceso", "Leído", "Consolidado"]).describe('Estado de lectura'),
-  topics: z.array(z.string()).describe('Temas'),
-  rating: z.number().describe('Puntuación del libro'),
-  online_rating: z.number().describe('Puntuación en línea'),
-  last_time_read: z.string().describe('Última vez leído'),
-  times_read: z.number().describe('Veces leído'),
+  topics: z.array(z.string()).optional().describe('Temas'),
+  rating: z.number().optional().describe('Puntuación del libro'),
+  online_rating: z.number().optional().describe('Puntuación en línea'),
+  last_time_read: z.string().optional().describe('Última vez leído'),
+  times_read: z.number().optional().describe('Veces leído'),
 }).describe('Libro: Datos adicionales');
 
 export const BookSchema = CatalogBookSchema.extend(DetailedBookSchema.shape).extend(MetaBookSchema.shape).describe('Libro');

package/es/Clothing/index.ts

@@ -14,14 +14,15 @@ import { Slot } from "./Slot";
 import { Status } from "./Status";
 import { UseCases } from "./UseCases";
 import { Variants } from "./Variants";
+import { Areas } from "../Areas";
 
 export const MetaClothingSchema = z.object({
   type: z.literal("[[Recursos]]"),
   subtype: z.literal("[[Prendas]]"),
-  areas: z.array(z.literal("[[Hogar]]")),
-  color: z.literal("#CB6120"),
-  icon: z.literal("shirt"),
-  cover: z.string().optional(),
+  areas: Areas.default(["[[Hogar]]"]),
+  color: z.string().optional().default("#CB6120").describe('Color de la nota.'),
+  icon: z.string().optional().default('shirt').describe('Icono de Lucide.'),
+  cover: z.string().optional().describe('Foto de la prenda de ropa.'),
 }).describe('Prenda de ropa: Metadatos de Nota');
 
 export const CatalogClothingSchema = z.object({