@lupinum/ginko 0.4.0 → 0.6.0

package/i18n/it.json

@@ -0,0 +1,212 @@
+{
+  "issues": {
+    "unknownBrick": "Il blocco “{brick}” non esiste.",
+    "markdown": "“{label}”: {problem}",
+    "markdownAt": "“{label}”, riga {line}: {problem}",
+    "notObject": "È previsto un oggetto.",
+    "unknownField": "Campo sconosciuto.",
+    "fieldMissing": "Manca “{label}”.",
+    "notLocalized": "“{label}” deve essere salvato per lingua.",
+    "unknownLocale": "La lingua “{locale}” non è configurata.",
+    "fieldEmpty": "“{label}” è vuoto.",
+    "notText": "“{label}” deve essere un testo.",
+    "tooLong": "“{label}” è troppo lungo (al massimo {max} caratteri).",
+    "controlChars": "“{label}” contiene caratteri di controllo invisibili.",
+    "badFormat": "“{label}” non ha un formato valido.",
+    "badSlug": "“{label}” non è un indirizzo valido.",
+    "notNumber": "“{label}” deve essere un numero.",
+    "outOfRange": "“{label}” deve essere compreso tra {min} e {max}.",
+    "badStep": "“{label}” non corrisponde al passo {step}.",
+    "notMoney": "“{label}” deve essere un importo in centesimi.",
+    "moneyOutOfRange": "“{label}” è fuori dai limiti.",
+    "notBoolean": "“{label}” deve essere sì o no.",
+    "badDate": "“{label}” non è una data valida.",
+    "badTime": "“{label}” non è un orario valido.",
+    "badDateRange": "“{label}” non è un periodo valido.",
+    "dateRangeOrder": "“{label}”: “dal” viene dopo “al”.",
+    "timeOrder": "“{end}” deve essere dopo “{start}”.",
+    "notWeekStart": "“{label}” deve essere il primo giorno di una settimana.",
+    "badChoice": "“{label}” ha un valore non valido.",
+    "badChoices": "“{label}” ha valori non validi.",
+    "duplicateValues": "“{label}” contiene valori duplicati.",
+    "tooManyChosen": "“{label}”: al massimo {max}.",
+    "notIdList": "“{label}” deve essere un elenco di ID di voci.",
+    "notId": "“{label}” deve essere l’ID di una voce.",
+    "duplicateEntries": "“{label}” contiene voci duplicate.",
+    "refGone": "“{label}”: la voce non esiste più.",
+    "notList": "“{label}” deve essere un elenco.",
+    "tooManyRows": "“{label}” ha troppi elementi (al massimo {max}).",
+    "tooFewRows": "“{label}” richiede almeno {min} elementi.",
+    "duplicateRowValue": "“{label}”: “{value}” compare più di una volta.",
+    "badRowId": "“{label}”: la riga {row} non ha un ID valido.",
+    "duplicateRowId": "“{label}”: un ID di riga compare due volte.",
+    "notImage": "“{label}” non è un’immagine valida.",
+    "altMissing": "“{label}”: manca la descrizione dell’immagine (testo alternativo).",
+    "fileRefMissing": "“{label}”: un’immagine nel testo non è più nella libreria dei file. Sceglila di nuovo.",
+    "fileRefPdf": "Un PDF non può essere mostrato come immagine. Inseriscilo come link: [testo]($file.…).",
+    "markdownImageAltMissing": "“{label}”: un’immagine nel testo non ha una descrizione. Descrivila in breve per chi non può vederla.",
+    "altTooLong": "“{label}”: il testo alternativo è troppo lungo.",
+    "notFile": "“{label}” non è un file valido."
+  },
+  "file": {
+    "typeNotAllowed": "Questo tipo di file non è consentito (consentiti: {allowed}).",
+    "tooBig": "Il file è troppo grande (al massimo {max, number} MB)."
+  },
+  "markdown": {
+    "profile": {
+      "inline": "solo testo con grassetto, corsivo, codice e link",
+      "basic": "paragrafi, titoli, elenchi (anche con caselle di controllo), citazioni, avvisi e note a piè di pagina",
+      "rich": "anche tabelle, immagini, blocchi di codice, formule e diagrammi",
+      "page": "anche componenti"
+    },
+    "tagBlocked": "“{tag}” non è consentito.",
+    "tagNotInProfile": "“{tag}” non è consentito qui ({allowed}).",
+    "propBlocked": "La proprietà “{prop}” non è consentita.",
+    "unsafeLink": "Link non consentito (solo http, https, mailto, tel o /percorso).",
+    "oneParagraph": "Qui è consentito un solo paragrafo.",
+    "tooComplex": "Il testo è troppo complesso (al massimo {max} elementi).",
+    "componentNotClosed": "Il componente “{tag}” non è chiuso: dopo il suo contenuto manca una riga con “{close}”.",
+    "bracketText": "“[{text}” non è né un link né un’immagine: manca una “]” o l’indirizzo tra parentesi tonde. Parentesi quadre come testo: \\[ e \\]."
+  },
+  "component": {
+    "or": "{first} o {second}",
+    "and": "{first}, {second}",
+    "quoted": "“{name}”",
+    "unknown": "Il componente “{tag}” non esiste.",
+    "propUnknown": "Componente “{tag}”: la proprietà “{prop}” non esiste.",
+    "propInvalid": "Componente “{tag}”: la proprietà “{prop}” {problem}",
+    "propMissing": "Componente “{tag}”: manca la proprietà “{prop}”.",
+    "propEmpty": "Componente “{tag}”: la proprietà “{prop}” è vuota.",
+    "blockInParagraph": "Il componente “{tag}” è un blocco e non può stare in un paragrafo.",
+    "parentOnly": "Il componente “{tag}” può comparire solo in {parents}.",
+    "slotUnknown": "Componente “{tag}”: l’area “{slot}” non esiste (consentite: {allowed}).",
+    "noSlots": "Componente “{tag}”: non ha aree, “{slot}” non è consentita.",
+    "childNotAllowed": "Il componente “{tag}” può contenere solo {children}, non “{child}”.",
+    "prop": {
+      "notBoolean": "deve essere “true” o “false”.",
+      "notNumber": "deve essere un numero.",
+      "outOfRange": "deve essere compresa tra {min} e {max}.",
+      "badStep": "non corrisponde al passo {step}.",
+      "notText": "deve essere un testo.",
+      "tooLong": "è troppo lunga (al massimo {max} caratteri).",
+      "badChoice": "ha un valore non valido (consentiti: {allowed}).",
+      "badChoices": "ha valori non validi (consentiti: {allowed}).",
+      "duplicateValues": "contiene valori duplicati.",
+      "tooManyChosen": "ammette al massimo {max} valori.",
+      "badImage": "deve essere un percorso o un indirizzo web.",
+      "notId": "deve essere l’ID di una voce.",
+      "badType": "ha un tipo non consentito."
+    }
+  },
+  "links": {
+    "snippetMissing": "Frammento di testo “{name}” non trovato (voce snippets/{name} con il campo body).",
+    "linkBroken": "Il link {href} non porta a nessuna voce né a nessuna pagina.",
+    "linkRedirected": "Il link {href} porta a {to} tramite un reindirizzamento.",
+    "pathUnknown": "Il percorso {path} non corrisponde a nessuna voce, pagina o file in public/.",
+    "anchorMissing": "Manca l’ancora #{anchor}: nessun titolo ha questo id.",
+    "externalBroken": "Il link esterno {href} è interrotto ({reason})."
+  },
+  "editor": {
+    "component": {
+      "unknown": "“{tag}” non esiste qui.",
+      "more": "{first} Controlla {count, plural, one {# altra impostazione} other {# altre impostazioni}}."
+    },
+    "prop": {
+      "missing": "Manca {label}.",
+      "empty": "{label} è vuoto.",
+      "invalid": "{label} {problem}"
+    },
+    "problem": {
+      "imageNoDescription": "L’immagine non ha una descrizione."
+    },
+    "source": {
+      "unstable": "Il testo cambierebbe al salvataggio, quindi si modifica come Markdown.",
+      "lossy": "Il testo non può essere mostrato nell’editor senza perdere qualcosa.",
+      "failed": "Il testo non può essere mostrato nell’editor ({reason})."
+    }
+  },
+  "diff": {
+    "freshSetting": "{name}: {value}.",
+    "freshLocales": "Lingue: {locales}.",
+    "siteRenamed": "Il nome del sito (`site`) non può essere modificato.",
+    "currencyChanged": "La valuta del sito non può essere modificata.",
+    "mainLocaleChanged": "La lingua principale non può essere modificata.",
+    "localeRemoved": "La lingua “{locale}” non può essere rimossa.",
+    "localeOrder": "Le nuove lingue vanno in fondo all’elenco.",
+    "localeAdded": "Nuova lingua “{locale}”.",
+    "timezoneChanged": "Il fuso orario non può essere modificato.",
+    "valueChanged": "{name} è cambiato.",
+    "pagesChanged": "Le pagine statiche sono cambiate.",
+    "agentsChanged": "La revisione delle modifiche dell’IA è cambiata.",
+    "tasksChanged": "Le attività sono cambiate.",
+    "retiredBack": "“{path}” è stato ritirato e non può tornare.",
+    "unretired": "“{path}” è stato ritirato.",
+    "retiredRuleChanged": "La regola di “{path}” non può essere modificata.",
+    "retiredNow": "“{path}” sta per essere ritirato.",
+    "migrationChanged": "La migrazione “{id}” è cambiata.",
+    "migrationFillsExisting": "La migrazione “{id}” riempie “{target}”, che esiste già.",
+    "migrationAdded": "Nuova migrazione “{id}”.",
+    "migrationDropped": "La migrazione “{id}” non è più nella configurazione.",
+    "brickRemoved": "Manca il blocco “{key}”.",
+    "brickAdded": "Nuovo blocco “{key}”.",
+    "singleWithoutDefault": "Nuovo blocco singolo: il campo obbligatorio “{name}” ha bisogno di un valore predefinito.",
+    "unknownChange": "“{at}”: la proprietà “{prop}” è cambiata, ma non è consentito.",
+    "kindChanged": "“{key}” passa da blocco singolo a raccolta, o viceversa.",
+    "textChanged": "Il testo è cambiato.",
+    "maxLowered": "“{at}”: max non può essere abbassato.",
+    "maxRaised": "max è stato alzato.",
+    "routeAdded": "Nuove pagine di dettaglio.",
+    "routeAddedLocale": "Indirizzo per la nuova lingua.",
+    "routeChanged": "“{key}”: gli indirizzi (route) non possono essere modificati.",
+    "fieldRemoved": "Manca il campo “{at}”.",
+    "fieldAdded": "Nuovo campo “{at}”.",
+    "fieldAddedDefault": "Nuovo campo obbligatorio “{at}” con valore predefinito.",
+    "fieldAddedMigration": "Nuovo campo obbligatorio “{at}”, riempito da una migrazione.",
+    "requiredWithoutDefault": "Nuovo campo obbligatorio “{at}” senza valore predefinito né migrazione.",
+    "typeChanged": "“{at}”: tipo {from} → {to}.",
+    "retiredFieldChanged": "“{at}”: un campo ritirato mantiene la definizione di produzione.",
+    "madeRequired": "“{at}”: facoltativo → obbligatorio.",
+    "madeOptional": "“{at}” ora è facoltativo.",
+    "translationChanged": "“{at}”: la traducibilità è cambiata.",
+    "defaultChanged": "“{at}”: il valore predefinito non può essere modificato.",
+    "minRaised": "“{at}”: min non può essere alzato.",
+    "minLowered": "min è stato abbassato.",
+    "minOffGrid": "“{at}”: min può essere abbassato solo di un multiplo del passo {step}.",
+    "propChanged": "“{at}”: {prop} non può essere modificato.",
+    "optionRemoved": "“{at}”: manca l’opzione “{option}”.",
+    "optionRenamed": "Opzione rinominata.",
+    "optionAdded": "Nuova opzione “{option}”.",
+    "uniqueChanged": "“{at}”: unique non può essere impostato né modificato.",
+    "uniqueDropped": "“{at}”: unique è stato rimosso.",
+    "fix": {
+      "newField": "Aggiungi un nuovo campo, riempilo con una migrazione ed elenca il vecchio campo sotto `retired`.",
+      "newFieldOnly": "Aggiungi un nuovo campo.",
+      "newSite": "Crea un nuovo sito.",
+      "moneyFields": "Aggiungi nuovi campi di denaro con una `currency` fissa.",
+      "planMigration": "Pianifica una migrazione con il tuo team di sviluppo.",
+      "keepLocale": "Mantieni la lingua; le pagine in quella lingua possono essere nascoste.",
+      "keepLocaleOrder": "Mantieni l’ordine delle lingue esistenti.",
+      "keepTimezone": "Mantieni il fuso orario.",
+      "keepRule": "Lascia la regola com’è.",
+      "newMigrationId": "Una correzione riceve un nuovo ID.",
+      "fillNewFieldsOnly": "Riempi solo campi nuovi; per un campo esistente, aggiungi un nuovo campo.",
+      "retireBrick": "Elenca il blocco sotto `retired` invece di eliminarlo.",
+      "defaultOrOptional": "Imposta un valore `default` o rendi il campo facoltativo.",
+      "keepProperty": "Mantieni la proprietà.",
+      "keepMax": "Mantieni max.",
+      "keepRoute": "Mantieni l’indirizzo (route).",
+      "defaultMigrationOrOptional": "Imposta un valore `default`, scrivi una migrazione o rendi il campo facoltativo.",
+      "keepDefinition": "Lascia la definizione com’è; possono cambiare solo i testi.",
+      "keepDefault": "Mantieni il valore predefinito.",
+      "keepMin": "Mantieni min.",
+      "minOnGrid": "Abbassa min in modo che la differenza sia un multiplo di step.",
+      "keepOption": "Mantieni l’opzione; può essere rinominata (label).",
+      "newList": "Aggiungi un nuovo elenco e riempilo con una migrazione."
+    }
+  },
+  "preview": {
+    "notFound": "Questa pagina non esiste.",
+    "failed": "L’anteprima non si carica.",
+    "loading": "Caricamento dell’anteprima…"
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lupinum/ginko",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "Ginko: a typed, file-based content model for Nuxt sites (core, CLI and Nuxt module).",
   "license": "MIT",
   "author": "Lupinum OG <info@lupinum.com> (https://lupinum.com)",
@@ -36,6 +36,10 @@
       "types": "./dist/search.d.mts",
       "import": "./dist/search.mjs"
     },
+    "./basics": {
+      "types": "./dist/basics.d.mts",
+      "import": "./dist/basics.mjs"
+    },
     "./nuxt": {
       "types": "./dist/nuxt/module.d.mts",
       "import": "./dist/nuxt/module.mjs"
@@ -62,14 +66,14 @@
   },
   "dependencies": {
     "@comark/vue": "0.7.0",
-    "@lupinum/ginko-i18n": "^0.4.0",
+    "@lupinum/ginko-i18n": "^0.6.0",
     "@nuxt/kit": "^4.6.0",
     "@zbsearch/stemmers": "4.0.1",
     "comark": "0.7.0",
     "minisearch": "7.2.0"
   },
   "devDependencies": {
-    "@lupinum/ginko-content": "^0.4.0",
+    "@lupinum/ginko-content": "^0.6.0",
     "@vue/test-utils": "2.5.1",
     "happy-dom": "20.14.5",
     "nuxt": "4.6.0",

package/dist/shared/ginko.BTUfZCfa.d.mts

@@ -1,172 +0,0 @@
-import './ginko.akHewCGt.mjs';
-import { Z as Money, F as Fields, L as Locale } from './ginko.D-fNojn9.mjs';
-import { a as BundleItem, B as Bundle } from './ginko.Bwan3BB-.mjs';
-
-/** http(s), mailto, tel, a same-site path or fragment, or a `$` route link. Everything else (javascript:, data:, //host) is unsafe. */
-declare function isSafeHref(href: string): boolean;
-/** The link or image URL when it is safe (see `isSafeHref`), else undefined: for `href`/`src` from content. */
-declare function safeHref(href: string | undefined): string | undefined;
-
-/**
- * Money is stored as an integer count of the currency's minor units (cents for EUR, whole yen for JPY).
- * `minorDigits` says how many decimals one unit has: 2 for EUR, 0 for JPY, 3 for KWD.
- */
-declare function minorDigits(currency: string): number;
-/**
- * The amount in the notation of `language`, a BCP 47 tag such as `de-AT` (use `useI18n().language`, not the URL
- * code): `12,50 €` in de, `€ 12,50` in de-AT, `€12.50` in en, `¥1,250` for JPY.
- * Every space is a no-break space: Node and browsers ship different ICU data (one uses a plain
- * space), so a server-rendered price would otherwise differ from the hydrated one.
- */
-declare function formatMoney(money: Money, language: string): string;
-
-type Data = Record<string, unknown>;
-/** What a condition compares a value with: one element of a list value, money by `amount`, a daterange by its start date. */
-type Comparable<V> = V extends readonly (infer E)[] ? E : V extends Money ? Pick<Money, 'amount'> : V extends {
-    from: string;
-} ? string : V;
-/**
- * A test on one field. `eq`/`ne`: equal or not (for a list value: one element is). `gt`, `gte`, `lt`, `lte`: compare.
- * `in`: equal to one of these. `contains`: a text contains this text (case-insensitive), a list contains this element.
- */
-interface Condition<V = unknown> {
-    eq?: Comparable<V> | null;
-    ne?: Comparable<V> | null;
-    gt?: Comparable<V>;
-    gte?: Comparable<V>;
-    lt?: Comparable<V>;
-    lte?: Comparable<V>;
-    in?: readonly Comparable<V>[];
-    contains?: Comparable<V>;
-}
-/** A sort order: the text `'price desc, name'` (`asc` is the default) or `{ field, dir? }` like a brick's `order`. */
-type QueryOrder<D = Data> = string | {
-    field: keyof D & string;
-    dir?: 'asc' | 'desc';
-};
-/** `D` is the data of the brick's entries; `useGinkoQuery` sets it, so field names and values are checked. */
-interface Query<D = Data> {
-    /** Per field a value (equal to it) or a `Condition`; every field must match. */
-    where?: {
-        [K in keyof D]?: Comparable<D[K]> | null | Condition<D[K]>;
-    };
-    /** Default: the bundle's item order. */
-    order?: QueryOrder<D>;
-    /** At least 1; without it, every matching entry. */
-    limit?: number;
-    /** 1-based. */
-    page?: number;
-    fields?: (keyof D & string)[];
-    facets?: (keyof D & string)[];
-    include?: (keyof D & string)[];
-}
-interface QueryResult {
-    items: BundleItem[];
-    total: number;
-    page: number;
-    pages: number;
-    facets?: Record<string, Record<string, number>>;
-}
-/** What `query` reads of the schema: the fields of each brick (a full `Schema` fits). */
-interface QuerySchema {
-    bricks: Record<string, {
-        fields: Fields;
-    }>;
-}
-/** Filter, order, page, project and enrich the items of one collection brick. Pure; throws on a field the brick does not have. */
-declare function query(bundle: Bundle, brick: string, q?: Query, schema?: QuerySchema): QueryResult;
-/** The items before and after `id` in the given (or default) order. Both are missing for an unknown id. */
-declare function neighbors(bundle: Bundle, brick: string, id: string, order?: QueryOrder): {
-    prev?: BundleItem;
-    next?: BundleItem;
-};
-
-interface NavNode {
-    title: string;
-    path: string;
-    id?: string;
-    brick?: string;
-    children: NavNode[];
-}
-/**
- * Navigation tree of the collections `bricks` in `locale`, built from item URLs. An item is a child of the
- * node at its nearest existing path prefix, else a root node. A string `parent` field (item id) overrides that.
- * Siblings keep the item order of the bundle (bricks in the given order).
- */
-declare function navTree(bundle: Bundle, bricks: string[], locale: Locale): NavNode[];
-/** Nodes from the root down to the node at `path`; empty when the path is not in the tree. */
-declare function breadcrumbs(tree: NavNode[], path: string): NavNode[];
-
-interface SeoImage {
-    url: string;
-    width?: number;
-    height?: number;
-    alt?: string;
-}
-interface SeoInput {
-    siteName: string;
-    /** `%s` is replaced by the page title; default '%s · <siteName>'. A page without title gets siteName alone. */
-    titleTemplate?: string;
-    title?: string;
-    description?: string;
-    image?: SeoImage;
-    type?: 'website' | 'article';
-    noindex?: boolean;
-}
-interface SeoHead {
-    title: string;
-    meta: (({
-        name: string;
-    } | {
-        property: string;
-    }) & {
-        content: string;
-    })[];
-}
-declare function seoHead(input: SeoInput): SeoHead;
-/** True when a request for `host` (with port, as in the Host header) is not for the site's own address: preview deployments, staging, localhost. Those must never be indexed. */
-declare function isPreviewHost(host: string | undefined, siteUrl: string): boolean;
-declare function robotsTxt(options: {
-    sitemap?: string;
-    noindex?: boolean;
-    disallow?: string[];
-}): string;
-declare function websiteLd(o: {
-    name: string;
-    url: string;
-    lang: string;
-}): Record<string, unknown>;
-declare function organizationLd(o: {
-    name: string;
-    url: string;
-    logo?: string;
-    sameAs?: string[];
-}): Record<string, unknown>;
-declare function breadcrumbLd(nodes: NavNode[], origin: string): Record<string, unknown>;
-declare function articleLd(o: {
-    title: string;
-    url: string;
-    description?: string;
-    image?: string;
-    published?: string;
-    modified?: string;
-    author?: string;
-    lang: string;
-}): Record<string, unknown>;
-declare function faqLd(pairs: {
-    question: string;
-    answer: string;
-}[]): Record<string, unknown>;
-/**
- * Headers every response of a Ginko site carries. Only the platform may frame `/__ginko` (the preview); nothing
- * else is framed. `nosniff` stops a browser from reading user text (`.md`, `llms.txt`, JSON) as HTML, and the
- * referrer policy keeps full URLs from leaving the site.
- */
-declare function siteHeaders(input: {
-    preview: boolean;
-    platformOrigin: string;
-    noindex: boolean;
-}): Record<string, string>;
-
-export { articleLd as f, breadcrumbLd as g, breadcrumbs as h, faqLd as i, formatMoney as j, isPreviewHost as k, isSafeHref as l, minorDigits as m, navTree as n, neighbors as o, organizationLd as p, query as q, robotsTxt as r, safeHref as s, seoHead as t, siteHeaders as u, websiteLd as w };
-export type { Condition as C, NavNode as N, Query as Q, SeoHead as S, QueryOrder as a, QueryResult as b, QuerySchema as c, SeoImage as d, SeoInput as e };