@sharadox/metadata-web-library 0.0.0-stage → 0.1.0

package/LICENCA.md

@@ -0,0 +1,76 @@
+# Licença Sharadox de Código Aberto
+
+Versão 0.1.0
+
+O texto em língua portuguesa é o único texto original e vinculativo desta licença. A tradução para inglês (`LICENSE.md`) é meramente informativa; em caso de divergência prevalece o texto em português.
+
+## 1. Definições
+
+Para efeitos desta licença:
+
+1. **«Obra»** — o programa de computador, a sua documentação e quaisquer outros conteúdos disponibilizados pelo Licenciante ao abrigo desta licença, em código-fonte ou em qualquer outra forma.
+2. **«Licenciante»** — o titular dos direitos de autor identificado no aviso de direitos de autor que acompanha a Obra.
+3. **«Licenciado»** — qualquer pessoa, singular ou coletiva, que exerça os direitos concedidos por esta licença.
+4. **«Obra Derivada»** — qualquer obra baseada na Obra ou que a incorpore, total ou parcialmente, com ou sem modificações, incluindo traduções, adaptações e programas que a integrem.
+5. **«Aviso»** — o aviso de direitos de autor do Licenciante e a indicação de que a Obra está licenciada ao abrigo desta licença, incluindo a respetiva versão.
+
+## 2. Concessão de direitos
+
+1. Nos termos desta licença, o Licenciante concede ao Licenciado uma licença mundial, gratuita, não exclusiva e por todo o prazo de proteção dos direitos de autor para:
+   1. utilizar a Obra para qualquer finalidade, incluindo finalidades comerciais;
+   2. reproduzir a Obra, total ou parcialmente, por qualquer meio e sob qualquer forma;
+   3. modificar, traduzir, adaptar e transformar a Obra e criar Obras Derivadas;
+   4. distribuir, publicar, comunicar ao público, colocar à disposição, vender e sublicenciar a Obra e as Obras Derivadas.
+2. Na medida em que o Licenciante seja titular de patentes necessariamente infringidas pela Obra tal como por si disponibilizada, concede igualmente ao Licenciado, nos mesmos termos, uma licença para utilizar essas patentes no exercício dos direitos previstos no número anterior.
+3. Esta licença não transmite a titularidade de quaisquer direitos, que permanecem do Licenciante.
+
+## 3. Condições
+
+O exercício dos direitos concedidos fica sujeito às seguintes condições:
+
+1. Todas as cópias da Obra, ou de partes substanciais da mesma, e todas as Obras Derivadas distribuídas devem incluir o Aviso e uma cópia desta licença ou uma ligação estável para o seu texto.
+2. Quem distribuir uma versão modificada da Obra deve indicar de forma visível que a mesma foi modificada, não podendo apresentá-la como versão original do Licenciante.
+3. O Licenciado pode licenciar as suas próprias modificações ao abrigo de outros termos, desde que a parte da Obra que delas faça parte continue sujeita às condições desta licença.
+
+## 4. Nomes e marcas
+
+Esta licença não concede qualquer direito sobre o nome, as marcas, os logótipos ou outros sinais distintivos do Licenciante, incluindo a designação «Sharadox», salvo na medida estritamente necessária para cumprir o dever de incluir o Aviso. É proibido utilizá-los para promover ou sugerir o apoio do Licenciante a Obras Derivadas ou a quaisquer produtos ou serviços sem autorização prévia e escrita.
+
+## 5. Exclusão de garantias
+
+A Obra é disponibilizada «tal como está» e «conforme disponível», sem qualquer garantia, expressa ou tácita, incluindo, designadamente, garantias de comerciabilidade, de adequação a um fim específico, de ausência de erros ou de não violação de direitos de terceiros, na medida máxima permitida pela lei aplicável.
+
+## 6. Limitação de responsabilidade
+
+1. Na medida máxima permitida pela lei aplicável, o Licenciante não é responsável por quaisquer danos, diretos ou indiretos, incluindo lucros cessantes, perda de dados ou interrupção de atividade, resultantes da utilização ou da impossibilidade de utilização da Obra, ainda que tenha sido avisado da possibilidade da sua ocorrência.
+2. Nada nesta licença exclui ou limita a responsabilidade do Licenciante nos casos em que tal exclusão ou limitação não seja permitida por lei, designadamente por atos praticados com dolo ou culpa grave, nos termos do artigo 809.º e do n.º 2 do artigo 800.º do Código Civil, nem afeta os direitos que a lei imperativamente reconheça aos consumidores.
+
+## 7. Cessação
+
+1. Os direitos concedidos por esta licença cessam automaticamente se o Licenciado violar qualquer das suas condições.
+2. Os direitos são repostos se a violação for sanada no prazo de 30 dias a contar do momento em que o Licenciado dela tome conhecimento, salvo se o Licenciante tiver entretanto comunicado por escrito a sua oposição.
+3. A cessação não afeta as licenças validamente concedidas pelo Licenciado a terceiros que cumpram esta licença.
+
+## 8. Lei aplicável e foro
+
+1. Esta licença rege-se pela lei portuguesa, designadamente pelo Código do Direito de Autor e dos Direitos Conexos, aprovado pelo Decreto-Lei n.º 63/85, de 14 de março, e pelo Decreto-Lei n.º 252/94, de 20 de outubro, relativo à proteção jurídica dos programas de computador.
+2. Para a resolução de quaisquer litígios emergentes desta licença é competente o Tribunal Judicial da Comarca de Faro, sem prejuízo das normas imperativas de competência aplicáveis, nomeadamente as que protegem os consumidores.
+
+## 9. Versões da licença
+
+O Licenciante pode publicar novas versões desta licença, identificadas por um número de versão. A Obra fica sujeita à versão indicada no Aviso. O Licenciado pode, se o Aviso o permitir, optar por qualquer versão posterior.
+
+## 10. Disposições finais
+
+1. Se alguma disposição desta licença for considerada inválida ou ineficaz, as restantes mantêm-se em vigor, devendo a disposição afetada ser interpretada de forma a aproximar-se, tanto quanto possível, da intenção original.
+2. A não exigência, em qualquer momento, do cumprimento de uma disposição desta licença não constitui renúncia ao direito de o exigir posteriormente.
+
+## Como aplicar esta licença
+
+Inclua na Obra um ficheiro `LICENCA.md` com este texto, a tradução `LICENSE.md` e o seguinte aviso, preenchendo o ano e o titular:
+
+```
+Direitos de autor © <ano> <titular>.
+Licenciado ao abrigo da Licença Sharadox de Código Aberto, versão 0.1.0.
+https://github.com/Sharadox/sharadox-open-source-license
+```

package/LICENSE.md

@@ -0,0 +1,76 @@
+# Sharadox Open Source Licence
+
+Version 0.1.0
+
+This is an informative English translation. The Portuguese text (`LICENCA.md`) is the only original and binding text of this licence; if the two differ, the Portuguese text prevails.
+
+## 1. Definitions
+
+For the purposes of this licence:
+
+1. **"Work"** — the computer program, its documentation and any other content made available by the Licensor under this licence, in source code or in any other form.
+2. **"Licensor"** — the copyright holder identified in the copyright notice that accompanies the Work.
+3. **"Licensee"** — any natural or legal person exercising the rights granted by this licence.
+4. **"Derivative Work"** — any work based on or incorporating the Work, in whole or in part, with or without modifications, including translations, adaptations and programs that integrate it.
+5. **"Notice"** — the Licensor's copyright notice and the statement that the Work is licensed under this licence, including its version.
+
+## 2. Grant of rights
+
+1. Under this licence, the Licensor grants the Licensee a worldwide, royalty-free, non-exclusive licence, for the whole term of copyright protection, to:
+   1. use the Work for any purpose, including commercial purposes;
+   2. reproduce the Work, in whole or in part, by any means and in any form;
+   3. modify, translate, adapt and transform the Work and create Derivative Works;
+   4. distribute, publish, communicate to the public, make available, sell and sublicense the Work and Derivative Works.
+2. To the extent the Licensor holds patents necessarily infringed by the Work as made available by it, the Licensor also grants the Licensee, on the same terms, a licence to use those patents in exercising the rights in the previous paragraph.
+3. This licence does not transfer ownership of any rights, which remain with the Licensor.
+
+## 3. Conditions
+
+The exercise of the rights granted is subject to the following conditions:
+
+1. Every copy of the Work, or of substantial parts of it, and every distributed Derivative Work must include the Notice and a copy of this licence or a stable link to its text.
+2. Anyone distributing a modified version of the Work must state visibly that it has been modified and may not present it as the Licensor's original version.
+3. The Licensee may license their own modifications under other terms, provided the part of the Work included in them remains subject to the conditions of this licence.
+
+## 4. Names and trademarks
+
+This licence grants no rights to the Licensor's name, trademarks, logos or other distinctive signs, including the name "Sharadox", except as strictly necessary to comply with the duty to include the Notice. Using them to promote or suggest the Licensor's endorsement of Derivative Works or of any products or services without prior written permission is prohibited.
+
+## 5. Disclaimer of warranties
+
+The Work is provided "as is" and "as available", without any warranty, express or implied, including in particular warranties of merchantability, fitness for a particular purpose, absence of errors or non-infringement of third-party rights, to the maximum extent permitted by applicable law.
+
+## 6. Limitation of liability
+
+1. To the maximum extent permitted by applicable law, the Licensor is not liable for any damages, direct or indirect, including loss of profits, loss of data or business interruption, arising from the use of or inability to use the Work, even if advised of the possibility of such damages.
+2. Nothing in this licence excludes or limits the Licensor's liability where such exclusion or limitation is not permitted by law, in particular for acts committed with intent or gross negligence, under article 809 and article 800(2) of the Portuguese Civil Code, nor does it affect rights that the law mandatorily grants to consumers.
+
+## 7. Termination
+
+1. The rights granted by this licence terminate automatically if the Licensee breaches any of its conditions.
+2. The rights are reinstated if the breach is remedied within 30 days of the Licensee becoming aware of it, unless the Licensor has meanwhile objected in writing.
+3. Termination does not affect licences validly granted by the Licensee to third parties who comply with this licence.
+
+## 8. Governing law and jurisdiction
+
+1. This licence is governed by Portuguese law, in particular the Code of Copyright and Related Rights, approved by Decree-Law no. 63/85 of 14 March, and Decree-Law no. 252/94 of 20 October on the legal protection of computer programs.
+2. The Judicial Court of the District of Faro has jurisdiction over any dispute arising from this licence, without prejudice to applicable mandatory rules of jurisdiction, in particular those protecting consumers.
+
+## 9. Licence versions
+
+The Licensor may publish new versions of this licence, identified by a version number. The Work is subject to the version stated in the Notice. If the Notice allows it, the Licensee may choose any later version.
+
+## 10. Final provisions
+
+1. If any provision of this licence is held invalid or unenforceable, the remaining provisions stay in force, and the affected provision shall be interpreted as closely as possible to its original intent.
+2. Failure to enforce any provision of this licence at any time does not waive the right to enforce it later.
+
+## How to apply this licence
+
+Include in the Work a `LICENCA.md` file with the Portuguese text, this translation as `LICENSE.md`, and the following notice, filling in the year and holder:
+
+```
+Direitos de autor © <ano> <titular>.
+Licenciado ao abrigo da Licença Sharadox de Código Aberto, versão 0.1.0.
+https://github.com/Sharadox/sharadox-open-source-license
+```

package/NOTICE.md

@@ -0,0 +1,3 @@
+Direitos de autor © 2026 Micael Pires (Sharadox).
+Licenciado ao abrigo da Licença Sharadox de Código Aberto, versão 0.1.0.
+https://github.com/Sharadox/sharadox-open-source-license

package/README.md

@@ -1,3 +1,76 @@
-# Temporary Holding Version
+# @sharadox/metadata-web-library
 
-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.
+Everything search engines, share cards and installation need from a Next.js site, built from a few facts about it.
+
+- **Page metadata:** title and template, description, canonical address, hreflang alternates, Open Graph with locales, a large Twitter card, robots rules.
+- **Search engine routes:** a localized sitemap with alternates, and robots rules.
+- **Installation:** a web app manifest for an installable, online-only site (stable id, standalone window, icons including maskable).
+- **Structured data:** JSON-LD rendered safely, and a graph helper to link several nodes.
+- **Share images:** Open Graph and Twitter cards rendered from JSX with your fonts.
+
+## Install
+
+```sh
+pnpm add @sharadox/metadata-web-library @sharadox/internationalization-web-library
+```
+
+## Use
+
+```ts
+// src/app/[locale]/layout.tsx
+import { pageMetadata } from "@sharadox/metadata-web-library/page-metadata";
+
+export async function generateMetadata({ params }) {
+  const { locale } = await params;
+  return pageMetadata({
+    name: "Sharadox",
+    url: "https://sharadox.com",
+    locales: LOCALES,
+    locale,
+    title: "Sharadox • Technologies that simplify the world",
+    description: "…",
+    titleTemplate: "%s • Sharadox",
+  });
+}
+```
+
+```ts
+// src/app/sitemap.ts, robots.ts, manifest.ts
+export default () => localizedSitemap({ url: "https://sharadox.com", locales: LOCALES, otherPriority: 0.9 });
+export default () => robots({ url: "https://sharadox.com", indexable: true });
+export default () => webManifest({ name: "Sharadox", backgroundColor: "#000000", themeColor: "#000000" });
+```
+
+```tsx
+<StructuredData data={structuredDataGraph(organization, website)} />
+```
+
+```tsx
+// src/app/[locale]/opengraph-image.tsx
+export const size = SHARE_IMAGE_SIZE;
+export default async function Image() {
+  return shareImage(<div style={{ display: "flex" }}>Sharadox</div>, {
+    fonts: [{ name: "Geist", data: font, weight: 600 }],
+  });
+}
+```
+
+## API
+
+| Import                    | Export                                                                                                                                                                                            |
+| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `…/page-metadata`         | `pageMetadata({ name, url, locales, locale, title, description, path?, titleTemplate?, keywords?, indexable? })` → Next.js `Metadata`                                                             |
+| `…/sitemap`               | `localizedSitemap({ url, locales, paths?, priority?, otherPriority?, changeFrequency?, lastModified? })`                                                                                          |
+| `…/robots`                | `robots({ url, indexable })`                                                                                                                                                                      |
+| `…/manifest`              | `webManifest({ name, shortName?, description?, id?, startUrl?, backgroundColor, themeColor, icons? })`, `DEFAULT_ICONS` (`/icon.svg`, `/icon-192.png`, `/icon-512.png`, `/icon-maskable-512.png`) |
+| `…/structured-data`       | `<StructuredData data>` (escapes `<`)                                                                                                                                                             |
+| `…/structured-data-graph` | `structuredDataGraph(...nodes)` → `{ "@context", "@graph" }`                                                                                                                                      |
+| `…/share-image`           | `shareImage(element, { width?, height?, fonts? })`, `SHARE_IMAGE_SIZE` (1200×630)                                                                                                                 |
+
+## Develop
+
+`pnpm verify` runs formatting, lint, type-check, tests with 100% coverage and the build. Branches follow `<feature>.development` → `development` → `index`, and releases are `v<version>` tags on `index`.
+
+## Licence
+
+Licença Sharadox de Código Aberto, versão 0.1.0. See [português](LICENCA.md) (the binding text) and the [English translation](LICENSE.md).

package/distribution/manifest/index.d.ts

@@ -0,0 +1,14 @@
+import type { MetadataRoute } from "next";
+import type { WebManifestOptions } from "@sharadox/metadata-web-library/manifest/type";
+/** The icon files every installable Sharadox site ships in `public/`. */
+export declare const DEFAULT_ICONS: NonNullable<WebManifestOptions["icons"]>;
+/**
+ * The web app manifest of an installable, online-only site: it opens in its own window (`standalone`), with a
+ * stable id, its colours and icons. No service worker or offline support is involved.
+ *
+ * @example
+ * // src/app/manifest.ts
+ * export default () => webManifest({ name: "Sharadox", backgroundColor: "#000000", themeColor: "#000000" });
+ */
+export declare function webManifest({ name, shortName, description, id, startUrl, backgroundColor, themeColor, icons, }: WebManifestOptions): MetadataRoute.Manifest;
+//# sourceMappingURL=index.d.ts.map

package/distribution/manifest/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../source/manifest/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AAEvF,yEAAyE;AACzE,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAKlE,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,EAC1B,IAAI,EACJ,SAAgB,EAChB,WAAW,EACX,EAAQ,EACR,QAAc,EACd,eAAe,EACf,UAAU,EACV,KAAqB,GACtB,EAAE,kBAAkB,GAAG,aAAa,CAAC,QAAQ,CAY7C"}

package/distribution/manifest/index.js

@@ -0,0 +1,29 @@
+/** The icon files every installable Sharadox site ships in `public/`. */
+export const DEFAULT_ICONS = [
+    { src: "/icon.svg", sizes: "any", type: "image/svg+xml" },
+    { src: "/icon-192.png", sizes: "192x192", type: "image/png" },
+    { src: "/icon-512.png", sizes: "512x512", type: "image/png" },
+    { src: "/icon-maskable-512.png", sizes: "512x512", type: "image/png", purpose: "maskable" },
+];
+/**
+ * The web app manifest of an installable, online-only site: it opens in its own window (`standalone`), with a
+ * stable id, its colours and icons. No service worker or offline support is involved.
+ *
+ * @example
+ * // src/app/manifest.ts
+ * export default () => webManifest({ name: "Sharadox", backgroundColor: "#000000", themeColor: "#000000" });
+ */
+export function webManifest({ name, shortName = name, description, id = "/", startUrl = "/", backgroundColor, themeColor, icons = DEFAULT_ICONS, }) {
+    return {
+        id,
+        name,
+        short_name: shortName,
+        ...(description ? { description } : {}),
+        start_url: startUrl,
+        display: "standalone",
+        background_color: backgroundColor,
+        theme_color: themeColor,
+        icons: icons.map((icon) => ({ ...icon })),
+    };
+}
+//# sourceMappingURL=index.js.map

package/distribution/manifest/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../source/manifest/index.ts"],"names":[],"mappings":"AAGA,yEAAyE;AACzE,MAAM,CAAC,MAAM,aAAa,GAA6C;IACrE,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE;IACzD,EAAE,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE;IAC7D,EAAE,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE;IAC7D,EAAE,GAAG,EAAE,wBAAwB,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE;CAC5F,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,EAC1B,IAAI,EACJ,SAAS,GAAG,IAAI,EAChB,WAAW,EACX,EAAE,GAAG,GAAG,EACR,QAAQ,GAAG,GAAG,EACd,eAAe,EACf,UAAU,EACV,KAAK,GAAG,aAAa,GACF;IACnB,OAAO;QACL,EAAE;QACF,IAAI;QACJ,UAAU,EAAE,SAAS;QACrB,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvC,SAAS,EAAE,QAAQ;QACnB,OAAO,EAAE,YAAY;QACrB,gBAAgB,EAAE,eAAe;QACjC,WAAW,EAAE,UAAU;QACvB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;KAC1C,CAAC;AACJ,CAAC"}

package/distribution/manifest/type.d.ts

@@ -0,0 +1,24 @@
+export interface WebManifestOptions {
+    name: string;
+    /** Shown under the home screen icon (about 12 characters); `name` by default. */
+    shortName?: string;
+    description?: string;
+    /** A stable identity, so browsers treat the app as the same one if `startUrl` changes; "/" by default. */
+    id?: string;
+    /** "/" by default. */
+    startUrl?: string;
+    /** Splash and window colours. */
+    backgroundColor: string;
+    themeColor: string;
+    /**
+     * Icons; by default `/icon.svg` (any size), `/icon-192.png`, `/icon-512.png` and `/icon-maskable-512.png`
+     * (purpose "maskable", with safe padding for round launchers).
+     */
+    icons?: {
+        src: string;
+        sizes: string;
+        type: string;
+        purpose?: "any" | "maskable" | "monochrome";
+    }[];
+}
+//# sourceMappingURL=type.d.ts.map

package/distribution/manifest/type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../source/manifest/type.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0GAA0G;IAC1G,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,KAAK,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,KAAK,GAAG,UAAU,GAAG,YAAY,CAAA;KAAE,EAAE,CAAC;CACrG"}

package/distribution/manifest/type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=type.js.map

package/distribution/manifest/type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.js","sourceRoot":"","sources":["../../source/manifest/type.ts"],"names":[],"mappings":""}

package/distribution/page-metadata/index.d.ts

@@ -0,0 +1,16 @@
+import type { Metadata } from "next";
+import type { PageMetadataOptions } from "@sharadox/metadata-web-library/page-metadata/type";
+/**
+ * Everything search engines and share cards need for a localized page, as a Next.js `Metadata` object: title and
+ * template, description, canonical address and hreflang alternates, Open Graph (with the locale and its
+ * alternatives), a large-image Twitter card and robots rules.
+ *
+ * @example
+ * export async function generateMetadata({ params }) {
+ *   const { locale } = await params;
+ *   return pageMetadata({ name: "Sharadox", url: "https://sharadox.com", locales: LOCALES, locale,
+ *     title: "Sharadox • Technologies that simplify the world", description: "…" });
+ * }
+ */
+export declare function pageMetadata<Locale extends string>({ name, url, locales, locale, title, description, path, titleTemplate, keywords, indexable, }: PageMetadataOptions<Locale>): Metadata;
+//# sourceMappingURL=index.d.ts.map

package/distribution/page-metadata/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../source/page-metadata/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mDAAmD,CAAC;AAE7F;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,MAAM,SAAS,MAAM,EAAE,EAClD,IAAI,EACJ,GAAG,EACH,OAAO,EACP,MAAM,EACN,KAAK,EACL,WAAW,EACX,IAAS,EACT,aAA8B,EAC9B,QAAQ,EACR,SAAgB,GACjB,EAAE,mBAAmB,CAAC,MAAM,CAAC,GAAG,QAAQ,CA4BxC"}

package/distribution/page-metadata/index.js

@@ -0,0 +1,42 @@
+/**
+ * Everything search engines and share cards need for a localized page, as a Next.js `Metadata` object: title and
+ * template, description, canonical address and hreflang alternates, Open Graph (with the locale and its
+ * alternatives), a large-image Twitter card and robots rules.
+ *
+ * @example
+ * export async function generateMetadata({ params }) {
+ *   const { locale } = await params;
+ *   return pageMetadata({ name: "Sharadox", url: "https://sharadox.com", locales: LOCALES, locale,
+ *     title: "Sharadox • Technologies that simplify the world", description: "…" });
+ * }
+ */
+export function pageMetadata({ name, url, locales, locale, title, description, path = "", titleTemplate = `%s | ${name}`, keywords, indexable = true, }) {
+    const address = locales.localePath(locale, path);
+    return {
+        metadataBase: new URL(url),
+        title: { default: title, template: titleTemplate },
+        description,
+        applicationName: name,
+        authors: [{ name, url }],
+        creator: name,
+        ...(keywords ? { keywords: [...keywords] } : {}),
+        alternates: { canonical: address, languages: locales.alternates(path) },
+        openGraph: {
+            type: "website",
+            url: address,
+            siteName: name,
+            title,
+            description,
+            locale: locales.openGraphLocale(locale),
+            alternateLocale: locales.locales
+                .filter((other) => other !== locale)
+                .map((other) => locales.openGraphLocale(other)),
+        },
+        twitter: { card: "summary_large_image", title, description },
+        robots: indexable
+            ? { index: true, follow: true, googleBot: { index: true, follow: true, "max-image-preview": "large" } }
+            : { index: false, follow: false },
+        formatDetection: { telephone: false },
+    };
+}
+//# sourceMappingURL=index.js.map

package/distribution/page-metadata/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../source/page-metadata/index.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,YAAY,CAAwB,EAClD,IAAI,EACJ,GAAG,EACH,OAAO,EACP,MAAM,EACN,KAAK,EACL,WAAW,EACX,IAAI,GAAG,EAAE,EACT,aAAa,GAAG,QAAQ,IAAI,EAAE,EAC9B,QAAQ,EACR,SAAS,GAAG,IAAI,GACY;IAC5B,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACjD,OAAO;QACL,YAAY,EAAE,IAAI,GAAG,CAAC,GAAG,CAAC;QAC1B,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE;QAClD,WAAW;QACX,eAAe,EAAE,IAAI;QACrB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;QACxB,OAAO,EAAE,IAAI;QACb,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChD,UAAU,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE;QACvE,SAAS,EAAE;YACT,IAAI,EAAE,SAAS;YACf,GAAG,EAAE,OAAO;YACZ,QAAQ,EAAE,IAAI;YACd,KAAK;YACL,WAAW;YACX,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC;YACvC,eAAe,EAAE,OAAO,CAAC,OAAO;iBAC7B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,MAAM,CAAC;iBACnC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;SAClD;QACD,OAAO,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE,KAAK,EAAE,WAAW,EAAE;QAC5D,MAAM,EAAE,SAAS;YACf,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,EAAE;YACvG,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE;QACnC,eAAe,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;KACtC,CAAC;AACJ,CAAC"}

package/distribution/page-metadata/type.d.ts

@@ -0,0 +1,23 @@
+import type { Locales } from "@sharadox/internationalization-web-library/locale/type";
+export interface PageMetadataOptions<Locale extends string> {
+    /** The site's name, for example "Sharadox". */
+    name: string;
+    /** The public address without a trailing slash, for example "https://sharadox.com". */
+    url: string;
+    /** The site's locales (from `defineLocales`). */
+    locales: Locales<Locale>;
+    /** The locale of this page. */
+    locale: Locale;
+    /** The page title, as shown in search results and share cards. */
+    title: string;
+    /** The page description (about 150 characters). */
+    description: string;
+    /** The path after the locale, for example "/contact"; the home page by default. */
+    path?: string;
+    /** How sub-pages build their titles from this one; `%s` is the sub-page's title. Default: "%s | <name>" (brands pass their own separator). */
+    titleTemplate?: string;
+    keywords?: readonly string[];
+    /** False keeps the page out of search engines (previews, demos). True by default. */
+    indexable?: boolean;
+}
+//# sourceMappingURL=type.d.ts.map

package/distribution/page-metadata/type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../source/page-metadata/type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wDAAwD,CAAC;AAEtF,MAAM,WAAW,mBAAmB,CAAC,MAAM,SAAS,MAAM;IACxD,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,uFAAuF;IACvF,GAAG,EAAE,MAAM,CAAC;IACZ,iDAAiD;IACjD,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACzB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8IAA8I;IAC9I,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,qFAAqF;IACrF,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB"}

package/distribution/page-metadata/type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=type.js.map

package/distribution/page-metadata/type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.js","sourceRoot":"","sources":["../../source/page-metadata/type.ts"],"names":[],"mappings":""}

package/distribution/robots/index.d.ts

@@ -0,0 +1,11 @@
+import type { RobotsOptions, RobotsRules } from "@sharadox/metadata-web-library/robots/type";
+/**
+ * robots.txt rules: everything allowed, with the sitemap and host, or everything disallowed while the site isn't
+ * indexable.
+ *
+ * @example
+ * // src/app/robots.ts
+ * export default () => robots({ url: "https://sharadox.com", indexable: true });
+ */
+export declare function robots({ url, indexable }: RobotsOptions): RobotsRules;
+//# sourceMappingURL=index.d.ts.map

package/distribution/robots/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../source/robots/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,4CAA4C,CAAC;AAE7F;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,aAAa,GAAG,WAAW,CAIrE"}

package/distribution/robots/index.js

@@ -0,0 +1,14 @@
+/**
+ * robots.txt rules: everything allowed, with the sitemap and host, or everything disallowed while the site isn't
+ * indexable.
+ *
+ * @example
+ * // src/app/robots.ts
+ * export default () => robots({ url: "https://sharadox.com", indexable: true });
+ */
+export function robots({ url, indexable }) {
+    return indexable
+        ? { rules: { userAgent: "*", allow: "/" }, sitemap: `${url}/sitemap.xml`, host: url }
+        : { rules: { userAgent: "*", disallow: "/" } };
+}
+//# sourceMappingURL=index.js.map

package/distribution/robots/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../source/robots/index.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,UAAU,MAAM,CAAC,EAAE,GAAG,EAAE,SAAS,EAAiB;IACtD,OAAO,SAAS;QACd,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,GAAG,GAAG,cAAc,EAAE,IAAI,EAAE,GAAG,EAAE;QACrF,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,CAAC;AACnD,CAAC"}

package/distribution/robots/type.d.ts

@@ -0,0 +1,17 @@
+export interface RobotsOptions {
+    /** The site's public address without a trailing slash. */
+    url: string;
+    /** False keeps the whole site out of search engines (previews before a launch). */
+    indexable: boolean;
+}
+/** The rules Next.js's `robots()` returns. */
+export interface RobotsRules {
+    rules: {
+        userAgent: string;
+        allow?: string;
+        disallow?: string;
+    };
+    sitemap?: string;
+    host?: string;
+}
+//# sourceMappingURL=type.d.ts.map

package/distribution/robots/type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../source/robots/type.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,0DAA0D;IAC1D,GAAG,EAAE,MAAM,CAAC;IACZ,mFAAmF;IACnF,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,8CAA8C;AAC9C,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/distribution/robots/type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=type.js.map

package/distribution/robots/type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.js","sourceRoot":"","sources":["../../source/robots/type.ts"],"names":[],"mappings":""}

package/distribution/share-image/index.d.ts

@@ -0,0 +1,18 @@
+import { ImageResponse } from "next/og";
+import type { ShareImageElement, ShareImageOptions } from "@sharadox/metadata-web-library/share-image/type";
+/** The size Open Graph and Twitter cards expect. */
+export declare const SHARE_IMAGE_SIZE: {
+    readonly width: 1200;
+    readonly height: 630;
+};
+/**
+ * Renders a share card (Open Graph and Twitter image) from JSX with the given fonts, as a PNG response. Use it in
+ * `opengraph-image.tsx` and `twitter-image.tsx`; the design stays in the site's own library.
+ *
+ * @example
+ * export default async function Image() {
+ *   return shareImage(<div style={{ display: "flex" }}>Sharadox</div>, { fonts: [{ name: "Geist", data: font }] });
+ * }
+ */
+export declare function shareImage(element: ShareImageElement, { width, height, fonts }?: ShareImageOptions): ImageResponse;
+//# sourceMappingURL=index.d.ts.map

package/distribution/share-image/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../source/share-image/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,iDAAiD,CAAC;AAE5G,oDAAoD;AACpD,eAAO,MAAM,gBAAgB;;;CAAwC,CAAC;AAEtE;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,iBAAiB,EAC1B,EAAE,KAA8B,EAAE,MAAgC,EAAE,KAAU,EAAE,GAAE,iBAAsB,GACvG,aAAa,CAEf"}

package/distribution/share-image/index.js

@@ -0,0 +1,16 @@
+import { ImageResponse } from "next/og";
+/** The size Open Graph and Twitter cards expect. */
+export const SHARE_IMAGE_SIZE = { width: 1200, height: 630 };
+/**
+ * Renders a share card (Open Graph and Twitter image) from JSX with the given fonts, as a PNG response. Use it in
+ * `opengraph-image.tsx` and `twitter-image.tsx`; the design stays in the site's own library.
+ *
+ * @example
+ * export default async function Image() {
+ *   return shareImage(<div style={{ display: "flex" }}>Sharadox</div>, { fonts: [{ name: "Geist", data: font }] });
+ * }
+ */
+export function shareImage(element, { width = SHARE_IMAGE_SIZE.width, height = SHARE_IMAGE_SIZE.height, fonts = [] } = {}) {
+    return new ImageResponse(element, { width, height, fonts });
+}
+//# sourceMappingURL=index.js.map

package/distribution/share-image/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../source/share-image/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGxC,oDAAoD;AACpD,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAW,CAAC;AAEtE;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CACxB,OAA0B,EAC1B,EAAE,KAAK,GAAG,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAAC,MAAM,EAAE,KAAK,GAAG,EAAE,KAAwB,EAAE;IAExG,OAAO,IAAI,aAAa,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AAC9D,CAAC"}

package/distribution/share-image/type.d.ts

@@ -0,0 +1,16 @@
+import type { ReactElement } from "react";
+/** A font for the share image: its family name, file contents and weight. */
+export interface ShareImageFont {
+    name: string;
+    data: ArrayBuffer | Buffer;
+    weight?: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;
+    style?: "normal" | "italic";
+}
+export interface ShareImageOptions {
+    /** 1200×630 by default, the size Open Graph and Twitter cards expect. */
+    width?: number;
+    height?: number;
+    fonts?: ShareImageFont[];
+}
+export type ShareImageElement = ReactElement;
+//# sourceMappingURL=type.d.ts.map

package/distribution/share-image/type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../source/share-image/type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAE1C,6EAA6E;AAC7E,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IAC7D,KAAK,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;CAC1B;AAED,MAAM,MAAM,iBAAiB,GAAG,YAAY,CAAC"}

package/distribution/share-image/type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=type.js.map

package/distribution/share-image/type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.js","sourceRoot":"","sources":["../../source/share-image/type.ts"],"names":[],"mappings":""}

package/distribution/sitemap/index.d.ts

@@ -0,0 +1,10 @@
+import type { LocalizedSitemapOptions, SitemapEntry } from "@sharadox/metadata-web-library/sitemap/type";
+/**
+ * A sitemap with one entry per page and locale, each listing every language version (hreflang) as an alternate.
+ *
+ * @example
+ * // src/app/sitemap.ts
+ * export default () => localizedSitemap({ url: "https://sharadox.com", locales: LOCALES, otherPriority: 0.9 });
+ */
+export declare function localizedSitemap<Locale extends string>({ url, locales, paths, priority, otherPriority, changeFrequency, lastModified, }: LocalizedSitemapOptions<Locale>): SitemapEntry[];
+//# sourceMappingURL=index.d.ts.map

package/distribution/sitemap/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../source/sitemap/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,6CAA6C,CAAC;AAEzG;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,SAAS,MAAM,EAAE,EACtD,GAAG,EACH,OAAO,EACP,KAAY,EACZ,QAAY,EACZ,aAAwB,EACxB,eAA2B,EAC3B,YAAyB,GAC1B,EAAE,uBAAuB,CAAC,MAAM,CAAC,GAAG,YAAY,EAAE,CAalD"}

package/distribution/sitemap/index.js

@@ -0,0 +1,20 @@
+/**
+ * A sitemap with one entry per page and locale, each listing every language version (hreflang) as an alternate.
+ *
+ * @example
+ * // src/app/sitemap.ts
+ * export default () => localizedSitemap({ url: "https://sharadox.com", locales: LOCALES, otherPriority: 0.9 });
+ */
+export function localizedSitemap({ url, locales, paths = [""], priority = 1, otherPriority = priority, changeFrequency = "monthly", lastModified = new Date(), }) {
+    return paths.flatMap((path) => {
+        const languages = Object.fromEntries(locales.locales.map((locale) => [locale, `${url}${locales.localePath(locale, path)}`]));
+        return locales.locales.map((locale) => ({
+            url: `${url}${locales.localePath(locale, path)}`,
+            lastModified,
+            changeFrequency,
+            priority: locale === locales.defaultLocale ? priority : otherPriority,
+            alternates: { languages },
+        }));
+    });
+}
+//# sourceMappingURL=index.js.map

package/distribution/sitemap/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../source/sitemap/index.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAwB,EACtD,GAAG,EACH,OAAO,EACP,KAAK,GAAG,CAAC,EAAE,CAAC,EACZ,QAAQ,GAAG,CAAC,EACZ,aAAa,GAAG,QAAQ,EACxB,eAAe,GAAG,SAAS,EAC3B,YAAY,GAAG,IAAI,IAAI,EAAE,GACO;IAChC,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAC5B,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAClC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CACvF,CAAC;QACF,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACtC,GAAG,EAAE,GAAG,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE;YAChD,YAAY;YACZ,eAAe;YACf,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa;YACrE,UAAU,EAAE,EAAE,SAAS,EAAE;SAC1B,CAAC,CAAC,CAAC;IACN,CAAC,CAAC,CAAC;AACL,CAAC"}

package/distribution/sitemap/type.d.ts

@@ -0,0 +1,25 @@
+import type { Locales } from "@sharadox/internationalization-web-library/locale/type";
+export interface LocalizedSitemapOptions<Locale extends string> {
+    /** The site's public address without a trailing slash, for example "https://sharadox.com". */
+    url: string;
+    locales: Locales<Locale>;
+    /** Paths after the locale; the home page (`""`) by default. */
+    paths?: readonly string[];
+    /** Priority of the default locale's pages; the others get `otherPriority`. */
+    priority?: number;
+    otherPriority?: number;
+    changeFrequency?: "always" | "hourly" | "daily" | "weekly" | "monthly" | "yearly" | "never";
+    /** Now by default. */
+    lastModified?: Date;
+}
+/** One sitemap entry, in the shape Next.js's `sitemap()` returns. */
+export interface SitemapEntry {
+    url: string;
+    lastModified: Date;
+    changeFrequency: NonNullable<LocalizedSitemapOptions<string>["changeFrequency"]>;
+    priority: number;
+    alternates: {
+        languages: Record<string, string>;
+    };
+}
+//# sourceMappingURL=type.d.ts.map

package/distribution/sitemap/type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../source/sitemap/type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wDAAwD,CAAC;AAEtF,MAAM,WAAW,uBAAuB,CAAC,MAAM,SAAS,MAAM;IAC5D,8FAA8F;IAC9F,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACzB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC5F,sBAAsB;IACtB,YAAY,CAAC,EAAE,IAAI,CAAC;CACrB;AAED,qEAAqE;AACrE,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,IAAI,CAAC;IACnB,eAAe,EAAE,WAAW,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC;IACjF,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;CACnD"}

package/distribution/sitemap/type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=type.js.map

package/distribution/sitemap/type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.js","sourceRoot":"","sources":["../../source/sitemap/type.ts"],"names":[],"mappings":""}

package/distribution/structured-data/index.d.ts

@@ -0,0 +1,9 @@
+import type { StructuredDataProperties } from "@sharadox/metadata-web-library/structured-data/type";
+/**
+ * Renders JSON-LD for search engines. `<` is escaped, so the data can never close the script tag early.
+ *
+ * @example
+ * <StructuredData data={structuredDataGraph(organization, website)} />
+ */
+export declare function StructuredData({ data }: StructuredDataProperties): import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/distribution/structured-data/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../source/structured-data/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,qDAAqD,CAAC;AAEpG;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAAE,IAAI,EAAE,EAAE,wBAAwB,+BAOhE"}

package/distribution/structured-data/index.js

@@ -0,0 +1,11 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Renders JSON-LD for search engines. `<` is escaped, so the data can never close the script tag early.
+ *
+ * @example
+ * <StructuredData data={structuredDataGraph(organization, website)} />
+ */
+export function StructuredData({ data }) {
+    return (_jsx("script", { type: "application/ld+json", dangerouslySetInnerHTML: { __html: JSON.stringify(data).replace(/</g, "\\u003c") } }));
+}
+//# sourceMappingURL=index.js.map

package/distribution/structured-data/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../source/structured-data/index.tsx"],"names":[],"mappings":";AAEA;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,EAAE,IAAI,EAA4B;IAC/D,OAAO,CACL,iBACE,IAAI,EAAC,qBAAqB,EAC1B,uBAAuB,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,GAClF,CACH,CAAC;AACJ,CAAC"}

package/distribution/structured-data/type.d.ts

@@ -0,0 +1,6 @@
+/** A schema.org JSON-LD object, for example `{ "@context": "https://schema.org", "@type": "Restaurant", … }`. */
+export type JsonLinkedData = Readonly<Record<string, unknown>>;
+export interface StructuredDataProperties {
+    data: JsonLinkedData;
+}
+//# sourceMappingURL=type.d.ts.map

package/distribution/structured-data/type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../source/structured-data/type.ts"],"names":[],"mappings":"AAAA,iHAAiH;AACjH,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE/D,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,cAAc,CAAC;CACtB"}

package/distribution/structured-data/type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=type.js.map

package/distribution/structured-data/type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.js","sourceRoot":"","sources":["../../source/structured-data/type.ts"],"names":[],"mappings":""}

package/distribution/structured-data-graph/index.d.ts

@@ -0,0 +1,10 @@
+import type { JsonLinkedData } from "@sharadox/metadata-web-library/structured-data/type";
+/**
+ * Wraps schema.org nodes in one JSON-LD document (`@context` and `@graph`), so a page can describe several linked
+ * things (the business, the website, its services).
+ *
+ * @example
+ * structuredDataGraph({ "@type": "Organization", name: "Sharadox" }, { "@type": "WebSite", url: "https://sharadox.com" });
+ */
+export declare function structuredDataGraph(...nodes: JsonLinkedData[]): JsonLinkedData;
+//# sourceMappingURL=index.d.ts.map

package/distribution/structured-data-graph/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../source/structured-data-graph/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qDAAqD,CAAC;AAE1F;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,KAAK,EAAE,cAAc,EAAE,GAAG,cAAc,CAE9E"}

package/distribution/structured-data-graph/index.js

@@ -0,0 +1,11 @@
+/**
+ * Wraps schema.org nodes in one JSON-LD document (`@context` and `@graph`), so a page can describe several linked
+ * things (the business, the website, its services).
+ *
+ * @example
+ * structuredDataGraph({ "@type": "Organization", name: "Sharadox" }, { "@type": "WebSite", url: "https://sharadox.com" });
+ */
+export function structuredDataGraph(...nodes) {
+    return { "@context": "https://schema.org", "@graph": nodes };
+}
+//# sourceMappingURL=index.js.map

package/distribution/structured-data-graph/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../source/structured-data-graph/index.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAG,KAAuB;IAC5D,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC/D,CAAC"}

package/llms.txt

@@ -0,0 +1,11 @@
+# @sharadox/metadata-web-library
+
+> SEO/share/install metadata for Next.js App Router sites, built on @sharadox/internationalization-web-library locales.
+
+- `/page-metadata` pageMetadata({ name, url, locales, locale, title, description, path?, titleTemplate? = "%s | name", keywords?, indexable? = true }) → Metadata (metadataBase, title template, canonical, hreflang alternates incl. x-default, openGraph with locale/alternateLocale, twitter summary_large_image, robots, formatDetection)
+- `/sitemap` localizedSitemap({ url, locales, paths? = [""], priority?, otherPriority?, changeFrequency? = "monthly", lastModified? })
+- `/robots` robots({ url, indexable })
+- `/manifest` webManifest({ name, shortName?, description?, id? = "/", startUrl? = "/", backgroundColor, themeColor, icons? = DEFAULT_ICONS }) → standalone, online-only
+- `/structured-data` <StructuredData data /> ; `/structured-data-graph` structuredDataGraph(...nodes)
+- `/share-image` shareImage(jsx, { width?, height?, fonts? }) → ImageResponse; SHARE_IMAGE_SIZE 1200x630
+- Peer deps: next, react. Licence: Sharadox Open Source Licence 0.1.0

package/package.json

@@ -1,6 +1,94 @@
 {
   "name": "@sharadox/metadata-web-library",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Everything search engines, share cards and installation need: page metadata, sitemaps, robots rules, web app manifests, JSON-LD structured data and share images for Next.js.",
+  "private": false,
+  "license": "SEE LICENSE IN LICENCA.md",
+  "author": "Sharadox <contact@sharadox.com>",
+  "type": "module",
+  "exports": {
+    "./*/type": {
+      "sharadox-source": "./source/*/type.ts",
+      "types": "./distribution/*/type.d.ts"
+    },
+    "./*": {
+      "sharadox-source": [
+        "./source/*/index.ts",
+        "./source/*/index.tsx"
+      ],
+      "types": "./distribution/*/index.d.ts",
+      "default": "./distribution/*/index.js"
+    }
+  },
+  "files": [
+    "distribution",
+    "LICENCA.md",
+    "LICENSE.md",
+    "NOTICE.md",
+    "llms.txt"
+  ],
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "lint-staged": {
+    "*.{ts,tsx,js,mjs,cjs}": [
+      "prettier --write",
+      "eslint --fix --max-warnings=0"
+    ],
+    "*.{json,md,yml,yaml,scss}": "prettier --write"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Sharadox/metadata-web-library.git"
+  },
+  "homepage": "https://github.com/Sharadox/metadata-web-library#readme",
+  "devDependencies": {
+    "@sharadox/es-lint-configuration-web-library": "^0.1.1",
+    "@sharadox/prettier-configuration-web-library": "^0.1.0",
+    "@sharadox/turborepo-configuration-web-library": "^0.1.0",
+    "@sharadox/type-script-configuration-web-library": "^0.2.0",
+    "@sharadox/vitest-configuration-web-library": "^0.1.2",
+    "@testing-library/dom": "^10.4.2",
+    "@testing-library/react": "^16.3.3",
+    "@types/node": "^24.19.2",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
+    "@vitest/coverage-v8": "^5.1.0",
+    "eslint": "9.39.5",
+    "husky": "^9.1.7",
+    "lint-staged": "^17.6.0",
+    "next": "16.4.5",
+    "prettier": "^3.10.0",
+    "react": "^19.3.1",
+    "react-dom": "^19.3.1",
+    "turbo": "^2.11.10",
+    "typedoc": "^0.28.20",
+    "typescript": "6.0.3",
+    "vitest": "^5.1.0"
+  },
+  "dependencies": {
+    "@sharadox/internationalization-web-library": "^0.1.0",
+    "@sharadox/web-library": "^0.5.0"
+  },
+  "peerDependencies": {
+    "next": ">=16",
+    "react": ">=19"
+  },
+  "scripts": {
+    "build": "rm -rf distribution && tsc -p tsconfig.build.json",
+    "lint": "eslint --max-warnings=0 .",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "type-check": "tsc --noEmit",
+    "test:unit": "vitest run --coverage",
+    "documentation": "typedoc",
+    "verify": "turbo run format:check lint type-check test:unit build",
+    "test:benchmark": "vitest bench --run --passWithNoTests"
+  }
 }