npm - @xylabs/sdk-meta - Versions diffs - 5.0.83 → 5.0.86 - Mend

@xylabs/sdk-meta 5.0.83 → 5.0.86

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (19) hide show

package/README.md CHANGED Viewed

@@ -15,6 +15,8 @@
 Base functionality used throughout XYO TypeScript/JavaScript libraries
 ## Reference
 **@xylabs/sdk-meta**
@@ -23,24 +25,30 @@ Base functionality used throughout XYO TypeScript/JavaScript libraries
 ## Interfaces
-- [Meta](#interfaces/Meta)
-- [OpenGraphMeta](#interfaces/OpenGraphMeta)
-- [OpenGraphStructured](#interfaces/OpenGraphStructured)
-- [TwitterMeta](#interfaces/TwitterMeta)
-- [TwitterApp](#interfaces/TwitterApp)
-- [TwitterPlayer](#interfaces/TwitterPlayer)
+| Interface | Description |
+| ------ | ------ |
+| [Meta](#interfaces/Meta) | Represents page metadata including Open Graph and Twitter card properties. |
+| [OpenGraphMeta](#interfaces/OpenGraphMeta) | Open Graph protocol metadata for rich link previews. |
+| [OpenGraphStructured](#interfaces/OpenGraphStructured) | Structured properties for an Open Graph media object (image, video, or audio). |
+| [TwitterMeta](#interfaces/TwitterMeta) | https://developer.twitter.com/en/docs/twitter-for-websites/cards/overview/markup |
+| [TwitterApp](#interfaces/TwitterApp) | Twitter App Card metadata containing app store identifiers, names, and URLs per platform. |
+| [TwitterPlayer](#interfaces/TwitterPlayer) | https://developer.twitter.com/en/docs/twitter-for-websites/cards/overview/player-card |
 ## Type Aliases
-- [StringIndexable](#type-aliases/StringIndexable)
-- [OpenGraphStructuredProperty](#type-aliases/OpenGraphStructuredProperty)
+| Type Alias | Description |
+| ------ | ------ |
+| [StringIndexable](#type-aliases/StringIndexable) | An object with string keys and arbitrary values, used for recursive meta flattening. |
+| [OpenGraphStructuredProperty](#type-aliases/OpenGraphStructuredProperty) | A structured Open Graph property value: a URL string, a structured object, or an array of either. |
 ## Functions
-- [mergeDocumentHead](#functions/mergeDocumentHead)
-- [getMetaAsDict](#functions/getMetaAsDict)
-- [addMetaToHead](#functions/addMetaToHead)
-- [metaBuilder](#functions/metaBuilder)
+| Function | Description |
+| ------ | ------ |
+| [mergeDocumentHead](#functions/mergeDocumentHead) | Merges meta tags from the source HTML head into the destination HTML head. Existing meta tags with matching property attributes are replaced; others are appended. |
+| [getMetaAsDict](#functions/getMetaAsDict) | Recursively flattens a nested meta object into a flat dictionary with colon-delimited keys. |
+| [addMetaToHead](#functions/addMetaToHead) | Adds or replaces a meta tag in the document head. |
+| [metaBuilder](#functions/metaBuilder) | Injects meta properties, title, and description into an HTML string. |
 ### functions
@@ -52,24 +60,20 @@ Base functionality used throughout XYO TypeScript/JavaScript libraries
 ```ts
 function addMetaToHead(
-   $,
-   name,
-   value): void;
+   $: CheerioAPI,
+   name: string,
+   value: string | object): void;
 ```
-## Parameters
-### $
-`CheerioAPI`
+Adds or replaces a meta tag in the document head.
-### name
-`string`
-### value
+## Parameters
-`string` | `object`
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `$` | `CheerioAPI` | The Cheerio API instance for the document. |
+| `name` | `string` | The meta property name. |
+| `value` | `string` \| `object` | The meta content value (string, array, or nested object). |
 ## Returns
@@ -82,23 +86,24 @@ function addMetaToHead(
 ***
 ```ts
-function getMetaAsDict(obj, parentKey?): Record<string, string>;
+function getMetaAsDict(obj: StringIndexable, parentKey?: string): Record<string, string>;
 ```
-## Parameters
-### obj
+Recursively flattens a nested meta object into a flat dictionary with colon-delimited keys.
-[`StringIndexable`](#../type-aliases/StringIndexable)
+## Parameters
-### parentKey?
-`string`
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `obj` | [`StringIndexable`](#../type-aliases/StringIndexable) | The nested object to flatten. |
+| `parentKey?` | `string` | The accumulated key prefix from parent levels. |
 ## Returns
 `Record`\<`string`, `string`\>
+A flat record mapping colon-delimited property names to string values.
   ### <a id="mergeDocumentHead"></a>mergeDocumentHead
 [**@xylabs/sdk-meta**](#../README)
@@ -106,23 +111,25 @@ function getMetaAsDict(obj, parentKey?): Record<string, string>;
 ***
 ```ts
-function mergeDocumentHead(destination, source): string;
+function mergeDocumentHead(destination: string, source: string): string;
 ```
-## Parameters
-### destination
+Merges meta tags from the source HTML head into the destination HTML head.
+Existing meta tags with matching property attributes are replaced; others are appended.
-`string`
+## Parameters
-### source
-`string`
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `destination` | `string` | The base HTML string to merge into. |
+| `source` | `string` | The HTML string whose head meta tags will be merged. |
 ## Returns
 `string`
+The merged HTML string.
   ### <a id="metaBuilder"></a>metaBuilder
 [**@xylabs/sdk-meta**](#../README)
@@ -131,29 +138,27 @@ function mergeDocumentHead(destination, source): string;
 ```ts
 function metaBuilder(
-   html,
-   meta,
-   handler?): string;
+   html: string,
+   meta: Meta,
+   handler?: string): string;
 ```
-## Parameters
-### html
-`string`
-### meta
-[`Meta`](#../interfaces/Meta)
+Injects meta properties, title, and description into an HTML string.
-### handler?
+## Parameters
-`string`
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `html` | `string` | The base HTML string to modify. |
+| `meta` | [`Meta`](#../interfaces/Meta) | The metadata to inject. |
+| `handler?` | `string` | Optional meta-handler property value to include. |
 ## Returns
 `string`
+The modified HTML string with injected metadata.
 ### interfaces
   ### <a id="Meta"></a>Meta
@@ -162,37 +167,16 @@ function metaBuilder(
 ***
-## Properties
-### description?
-```ts
-optional description: string;
-```
-***
-### og?
+Represents page metadata including Open Graph and Twitter card properties.
-```ts
-optional og: OpenGraphMeta;
-```
-***
-### title?
-```ts
-optional title: string;
-```
-***
+## Properties
-### twitter?
-```ts
-optional twitter: TwitterMeta;
-```
+| Property | Type |
+| ------ | ------ |
+| <a id="description"></a> `description?` | `string` |
+| <a id="og"></a> `og?` | [`OpenGraphMeta`](#OpenGraphMeta) |
+| <a id="title"></a> `title?` | `string` |
+| <a id="twitter"></a> `twitter?` | [`TwitterMeta`](#TwitterMeta) |
   ### <a id="OpenGraphMeta"></a>OpenGraphMeta
@@ -200,85 +184,22 @@ optional twitter: TwitterMeta;
 ***
-## Properties
-### audio?
-```ts
-optional audio: OpenGraphStructuredProperty;
-```
-***
-### description?
-```ts
-optional description: string;
-```
-***
-### determiner?
-```ts
-optional determiner: string;
-```
-***
-### image?
-```ts
-optional image: OpenGraphStructuredProperty;
-```
-***
-### locale?
-```ts
-optional locale: string | string[];
-```
-***
-### site\_name?
-```ts
-optional site_name: string;
-```
-***
-### title?
-```ts
-optional title: string;
-```
-***
-### type?
+Open Graph protocol metadata for rich link previews.
-```ts
-optional type: string;
-```
-***
-### url?
-```ts
-optional url: string;
-```
-***
-### video?
+## Properties
-```ts
-optional video: OpenGraphStructuredProperty;
-```
+| Property | Type |
+| ------ | ------ |
+| <a id="audio"></a> `audio?` | [`OpenGraphStructuredProperty`](#../type-aliases/OpenGraphStructuredProperty) |
+| <a id="description"></a> `description?` | `string` |
+| <a id="determiner"></a> `determiner?` | `string` |
+| <a id="image"></a> `image?` | [`OpenGraphStructuredProperty`](#../type-aliases/OpenGraphStructuredProperty) |
+| <a id="locale"></a> `locale?` | `string` \| `string`[] |
+| <a id="site_name"></a> `site_name?` | `string` |
+| <a id="title"></a> `title?` | `string` |
+| <a id="type"></a> `type?` | `string` |
+| <a id="url"></a> `url?` | `string` |
+| <a id="video"></a> `video?` | [`OpenGraphStructuredProperty`](#../type-aliases/OpenGraphStructuredProperty) |
   ### <a id="OpenGraphStructured"></a>OpenGraphStructured
@@ -286,61 +207,19 @@ optional video: OpenGraphStructuredProperty;
 ***
-## Properties
-### ?
-```ts
-optional : string;
-```
-***
-### alt?
-```ts
-optional alt: string;
-```
-***
-### height?
-```ts
-optional height: number;
-```
-***
-### secure\_url?
-```ts
-optional secure_url: string;
-```
-***
-### type?
+Structured properties for an Open Graph media object (image, video, or audio).
-```ts
-optional type: string;
-```
-***
-### url?
-```ts
-optional url: string;
-```
-***
+## Properties
-### width?
-```ts
-optional width: number;
-```
+| Property | Type |
+| ------ | ------ |
+| <a id="_"></a> `?` | `string` |
+| <a id="alt"></a> `alt?` | `string` |
+| <a id="height"></a> `height?` | `number` |
+| <a id="secure_url"></a> `secure_url?` | `string` |
+| <a id="type"></a> `type?` | `string` |
+| <a id="url"></a> `url?` | `string` |
+| <a id="width"></a> `width?` | `number` |
   ### <a id="TwitterApp"></a>TwitterApp
@@ -348,83 +227,24 @@ optional width: number;
 ***
-## Properties
-### id?
-```ts
-optional id: object;
-```
-### googleplay?
-```ts
-optional googleplay: string;
-```
-### ipad?
-```ts
-optional ipad: string;
-```
-### iphone?
-```ts
-optional iphone: string;
-```
-***
-### name?
-```ts
-optional name: object;
-```
-### googleplay?
-```ts
-optional googleplay: string;
-```
-### ipad?
-```ts
-optional ipad: string;
-```
-### iphone?
-```ts
-optional iphone: string;
-```
-***
-### url?
-```ts
-optional url: object;
-```
-### googleplay?
-```ts
-optional googleplay: string;
-```
-### ipad?
-```ts
-optional ipad: string;
-```
+Twitter App Card metadata containing app store identifiers, names, and URLs per platform.
-### iphone?
+## Properties
-```ts
-optional iphone: string;
-```
+| Property | Type |
+| ------ | ------ |
+| <a id="id"></a> `id?` | \{ `googleplay?`: `string`; `ipad?`: `string`; `iphone?`: `string`; \} |
+| `id.googleplay?` | `string` |
+| `id.ipad?` | `string` |
+| `id.iphone?` | `string` |
+| <a id="name"></a> `name?` | \{ `googleplay?`: `string`; `ipad?`: `string`; `iphone?`: `string`; \} |
+| `name.googleplay?` | `string` |
+| `name.ipad?` | `string` |
+| `name.iphone?` | `string` |
+| <a id="url"></a> `url?` | \{ `googleplay?`: `string`; `ipad?`: `string`; `iphone?`: `string`; \} |
+| `url.googleplay?` | `string` |
+| `url.ipad?` | `string` |
+| `url.iphone?` | `string` |
   ### <a id="TwitterMeta"></a>TwitterMeta
@@ -436,143 +256,22 @@ https://developer.twitter.com/en/docs/twitter-for-websites/cards/overview/markup
 ## Properties
-### app?
-```ts
-optional app: TwitterApp;
-```
-***
-### card?
-```ts
-optional card: "summary" | "summary_large_image" | "app" | "player";
-```
-The card type. Used with all cards. Fallback: og:type.
-If an og:type, og:title and og:description exist in the markup but
-twitter:card is absent, then a summary card may be rendered.
-***
-### creator?
-```ts
-optional creator: object;
-```
-### ?
-```ts
-optional : string;
-```
-The
-#### Username
-of content creator. Used with summary_large_image cards
-### id?
-```ts
-optional id: string;
-```
-Twitter user ID of content creator. Used with summary,
-summary_large_image cards
-***
-### description?
-```ts
-optional description: string;
-```
-Description of content (maximum 200 characters). Used with summary,
-summary_large_image, player cards. Fallback: og:description.
-***
-### image?
-```ts
-optional image: object;
-```
-### ?
-```ts
-optional : string;
-```
-URL of image to use in the card. Images must be less than 5MB in size.
-JPG, PNG, WEBP and GIF formats are supported. Only the first frame of
-an animated GIF will be used. SVG is not supported. Used with summary,
-summary_large_image, player cards. Fallback: og:image
-### alt?
-```ts
-optional alt: string;
-```
-A text description of the image conveying the essential nature of
-an image to users who are visually impaired. Maximum 420
-characters. Used with summary, summary_large_image, player cards
-***
-### player?
-```ts
-optional player: TwitterPlayer;
-```
-***
-### site?
-```ts
-optional site: object;
-```
-The
-### ?
-```ts
-optional : string;
-```
-### id?
-```ts
-optional id: string;
-```
-Same as twitter:site, but the user’s Twitter ID. Either
-twitter:site or twitter:site:id is required. Used with
-summary, summary_large_image, player cards
-### Username
-of website. Either twitter:site or twitter:site:id is
-required. Used with summary, summary_large_image, app, player
-cards
-***
-### title?
-```ts
-optional title: string;
-```
-Title of content (max 70 characters). Used with summary,
-summary_large_image, player cards. Fallback: og:title.
+| Property | Type | Description |
+| ------ | ------ | ------ |
+| <a id="app"></a> `app?` | [`TwitterApp`](#TwitterApp) | - |
+| <a id="card"></a> `card?` | `"summary"` \| `"summary_large_image"` \| `"app"` \| `"player"` | The card type. Used with all cards. Fallback: og:type. If an og:type, og:title and og:description exist in the markup but twitter:card is absent, then a summary card may be rendered. |
+| <a id="creator"></a> `creator?` | \{ `?`: `string`; `id?`: `string`; \} | - |
+| `creator.?` | `string` | The **Username** of content creator. Used with summary_large_image cards |
+| `creator.id?` | `string` | Twitter user ID of content creator. Used with summary, summary_large_image cards |
+| <a id="description"></a> `description?` | `string` | Description of content (maximum 200 characters). Used with summary, summary_large_image, player cards. Fallback: og:description. |
+| <a id="image"></a> `image?` | \{ `?`: `string`; `alt?`: `string`; \} | - |
+| `image.?` | `string` | URL of image to use in the card. Images must be less than 5MB in size. JPG, PNG, WEBP and GIF formats are supported. Only the first frame of an animated GIF will be used. SVG is not supported. Used with summary, summary_large_image, player cards. Fallback: og:image |
+| `image.alt?` | `string` | A text description of the image conveying the essential nature of an image to users who are visually impaired. Maximum 420 characters. Used with summary, summary_large_image, player cards |
+| <a id="player"></a> `player?` | [`TwitterPlayer`](#TwitterPlayer) | - |
+| <a id="site"></a> `site?` | \{ `?`: `string`; `id?`: `string`; \} | The **Username** of website. Either twitter:site or twitter:site:id is required. Used with summary, summary_large_image, app, player cards |
+| `site.?` | `string` | - |
+| `site.id?` | `string` | Same as twitter:site, but the user’s Twitter ID. Either twitter:site or twitter:site:id is required. Used with summary, summary_large_image, player cards |
+| <a id="title"></a> `title?` | `string` | Title of content (max 70 characters). Used with summary, summary_large_image, player cards. Fallback: og:title. |
   ### <a id="TwitterPlayer"></a>TwitterPlayer
@@ -584,45 +283,12 @@ https://developer.twitter.com/en/docs/twitter-for-websites/cards/overview/player
 ## Properties
-###
-```ts
-: string;
-```
-HTTPS URL to iFrame player. This must be a HTTPS URL which does not
-generate active mixed content warnings in a web browser. The audio or
-video player must not require plugins such as Adobe Flash.
-***
-### height?
-```ts
-optional height: number;
-```
-Height of iframe in pixels. Used with player card
-***
-### stream?
-```ts
-optional stream: string;
-```
-URL to raw video or audio stream. Used with player card
-***
-### width?
-```ts
-optional width: number;
-```
-Width of iframe in pixels. Used with player card
+| Property | Type | Description |
+| ------ | ------ | ------ |
+| <a id="_"></a> `` | `string` | HTTPS URL to iFrame player. This must be a HTTPS URL which does not generate active mixed content warnings in a web browser. The audio or video player must not require plugins such as Adobe Flash. |
+| <a id="height"></a> `height?` | `number` | Height of iframe in pixels. Used with player card |
+| <a id="stream"></a> `stream?` | `string` | URL to raw video or audio stream. Used with player card |
+| <a id="width"></a> `width?` | `number` | Width of iframe in pixels. Used with player card |
 ### type-aliases
@@ -639,6 +305,8 @@ type OpenGraphStructuredProperty =
   | (string | OpenGraphStructured)[];
 ```
+A structured Open Graph property value: a URL string, a structured object, or an array of either.
   ### <a id="StringIndexable"></a>StringIndexable
 [**@xylabs/sdk-meta**](#../README)
@@ -646,9 +314,13 @@ type OpenGraphStructuredProperty =
 ***
 ```ts
-type StringIndexable = object;
+type StringIndexable = {
+[key: string]: any;
+};
 ```
+An object with string keys and arbitrary values, used for recursive meta flattening.
 ## Index Signature
 ```ts

package/dist/neutral/html/mergeDocumentHead.d.ts CHANGED Viewed

@@ -1,2 +1,9 @@
+/**
+ * Merges meta tags from the source HTML head into the destination HTML head.
+ * Existing meta tags with matching property attributes are replaced; others are appended.
+ * @param destination - The base HTML string to merge into.
+ * @param source - The HTML string whose head meta tags will be merged.
+ * @returns The merged HTML string.
+ */
 export declare const mergeDocumentHead: (destination: string, source: string) => string;
 //# sourceMappingURL=mergeDocumentHead.d.ts.map

package/dist/neutral/html/mergeDocumentHead.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"mergeDocumentHead.d.ts","sourceRoot":"","sources":["../../../src/html/mergeDocumentHead.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,iBAAiB,GAAI,aAAa,MAAM,EAAE,QAAQ,MAAM,WAwCpE,CAAA"}
1	+ {"version":3,"file":"mergeDocumentHead.d.ts","sourceRoot":"","sources":["../../../src/html/mergeDocumentHead.ts"],"names":[],"mappings":"AAMA;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAI,aAAa,MAAM,EAAE,QAAQ,MAAM,WAwCpE,CAAA"}

package/dist/neutral/index.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../../src/html/mergeDocumentHead.ts","../../src/lib/getMetaAsDict.ts","../../src/meta/builder.ts"],"sourcesContent":["import { isString } from '@xylabs/typeof'\nimport { load } from 'cheerio'\n\nconst opts = {}\n// const opts = { decodeEntities: false }\n\nexport const mergeDocumentHead = (destination: string, source: string) => {\n const $destination = load(destination, opts)\n const $source = load(source, opts)\n\n // For each child node of the source head\n $source('head')\n .children()\n .each((_, element) => {\n const el = $destination(element)\n\n // Special case for meta tags: We want to match them by the name attribute\n if (el[0].tagName === 'meta') {\n const property = el.attr('property')\n if (isString(property)) {\n const match = $destination(`head meta[property=\"${property}\"]`)\n\n // If it exists, replace it, otherwise append it\n if (match.length > 0) {\n match.replaceWith(el)\n return\n } else {\n $destination('head').append(el)\n }\n }\n // else {\n // // For all other elements, just check if the same element exists in the first HTML string\n // const match = $destination(el[0].tagName)\n\n // // If it exists, replace it, otherwise append it\n // if (match.length > 0) {\n // match.replaceWith(el)\n // } else {\n // $destination('head').append(el)\n // }\n // }\n }\n })\n\n // Return the merged HTML\n return $destination.html(opts)\n}\n","import { isString } from '@xylabs/typeof'\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type StringIndexable = { [key: string]: any }\n\nconst propertyDelimiter = ':'\n\nexport const getMetaAsDict = (obj: StringIndexable, parentKey?: string): Record<string, string> => {\n let flatRecord: StringIndexable = {}\n for (const key in obj) {\n if (typeof obj[key] === 'object' && obj[key] !== null) {\n // If the value is another object, we want to iterate through its keys as well.\n const childRecord = getMetaAsDict(obj[key] as StringIndexable, `${isString(parentKey) ? parentKey : ''}${key}${propertyDelimiter}`)\n flatRecord = { ...flatRecord, ...childRecord }\n } else {\n // Concatenate the key with its parent key.\n const newKey = isString(parentKey) ? `${parentKey}${key}` : key\n const trimmed = newKey.endsWith(propertyDelimiter) ? newKey.slice(0, -1) : newKey\n flatRecord[trimmed] = `${obj[key]}`\n }\n }\n return flatRecord\n}\n","import { isString } from '@xylabs/typeof'\nimport type { CheerioAPI } from 'cheerio'\nimport { load } from 'cheerio'\n\nimport { getMetaAsDict } from '../lib/index.ts'\nimport type { Meta } from '../models/index.ts'\n\n/* test change */\n\nexport const addMetaToHead = ($: CheerioAPI, name: string, value: string \| object) => {\n if (typeof value === 'string') {\n const newMeta = `<meta property=\"${name}\" content=\"${value}\" />`\n const existingMeta = $(`head meta[property=\"${name}\"]`)\n if ((existingMeta?.length ?? 0) > 0) {\n existingMeta.replaceWith(newMeta)\n } else {\n $('head').append(newMeta)\n }\n } else if (Array.isArray(value)) {\n for (const item of value) addMetaToHead($, `${name}`, item)\n } else if (typeof value === 'object') {\n for (let [key, v] of Object.entries(value)) {\n if (key === 'url') {\n addMetaToHead($, name, v)\n } else {\n addMetaToHead($, `${name}:${key}`, v)\n }\n }\n } else {\n throw new TypeError(`Invalid item type [${name}, ${typeof value}]`)\n }\n}\n\nexport const metaBuilder = (html: string, meta: Meta, handler?: string) => {\n const $ = load(html)\n // NOTE: This assumes unique meta properties (no duplicates)\n // which is generally the case, but not always (you can have\n // multiple og:video:tag tags, for example)\n const metaProperties = getMetaAsDict(meta)\n for (const [key, value] of Object.entries(metaProperties)) {\n addMetaToHead($, key, value)\n }\n if (isString(meta.description)) {\n addMetaToHead($, 'description', meta.description)\n }\n if (isString(meta.title)) {\n $('title').text(meta.title)\n }\n if (isString(handler)) {\n addMetaToHead($, 'meta-handler', handler)\n }\n return $.html()\n}\n"],"mappings":";AAAA,SAAS,gBAAgB;AACzB,SAAS,YAAY;AAErB,IAAM,OAAO,CAAC;~~AAGP~~,IAAM,oBAAoB,CAAC,aAAqB,WAAmB;AACxE,QAAM,eAAe,KAAK,aAAa,IAAI;AAC3C,QAAM,UAAU,KAAK,QAAQ,IAAI;AAGjC,UAAQ,MAAM,EACX,SAAS,EACT,KAAK,CAAC,GAAG,YAAY;AACpB,UAAM,KAAK,aAAa,OAAO;AAG/B,QAAI,GAAG,CAAC,EAAE,YAAY,QAAQ;AAC5B,YAAM,WAAW,GAAG,KAAK,UAAU;AACnC,UAAI,SAAS,QAAQ,GAAG;AACtB,cAAM,QAAQ,aAAa,uBAAuB,QAAQ,IAAI;AAG9D,YAAI,MAAM,SAAS,GAAG;AACpB,gBAAM,YAAY,EAAE;AACpB;AAAA,QACF,OAAO;AACL,uBAAa,MAAM,EAAE,OAAO,EAAE;AAAA,QAChC;AAAA,MACF;AAAA,IAYF;AAAA,EACF,CAAC;AAGH,SAAO,aAAa,KAAK,IAAI;AAC/B;;;~~AC9CA~~,SAAS,YAAAA,iBAAgB;~~AAIzB~~,IAAM,oBAAoB;~~AAEnB~~,IAAM,gBAAgB,CAAC,KAAsB,cAA+C;AACjG,MAAI,aAA8B,CAAC;AACnC,aAAW,OAAO,KAAK;AACrB,QAAI,OAAO,IAAI,GAAG,MAAM,YAAY,IAAI,GAAG,MAAM,MAAM;AAErD,YAAM,cAAc,cAAc,IAAI,GAAG,GAAsB,GAAGA,UAAS,SAAS,IAAI,YAAY,EAAE,GAAG,GAAG,GAAG,iBAAiB,EAAE;AAClI,mBAAa,EAAE,GAAG,YAAY,GAAG,YAAY;AAAA,IAC/C,OAAO;AAEL,YAAM,SAASA,UAAS,SAAS,IAAI,GAAG,SAAS,GAAG,GAAG,KAAK;AAC5D,YAAM,UAAU,OAAO,SAAS,iBAAiB,IAAI,OAAO,MAAM,GAAG,EAAE,IAAI;AAC3E,iBAAW,OAAO,IAAI,GAAG,IAAI,GAAG,CAAC;AAAA,IACnC;AAAA,EACF;AACA,SAAO;AACT;;;~~ACrBA~~,SAAS,YAAAC,iBAAgB;AAEzB,SAAS,QAAAC,aAAY;~~AAOd~~,IAAM,gBAAgB,CAAC,GAAe,MAAc,UAA2B;AACpF,MAAI,OAAO,UAAU,UAAU;AAC7B,UAAM,UAAU,mBAAmB,IAAI,cAAc,KAAK;AAC1D,UAAM,eAAe,EAAE,uBAAuB,IAAI,IAAI;AACtD,SAAK,cAAc,UAAU,KAAK,GAAG;AACnC,mBAAa,YAAY,OAAO;AAAA,IAClC,OAAO;AACL,QAAE,MAAM,EAAE,OAAO,OAAO;AAAA,IAC1B;AAAA,EACF,WAAW,MAAM,QAAQ,KAAK,GAAG;AAC/B,eAAW,QAAQ,MAAO,eAAc,GAAG,GAAG,IAAI,IAAI,IAAI;AAAA,EAC5D,WAAW,OAAO,UAAU,UAAU;AACpC,aAAS,CAAC,KAAK,CAAC,KAAK,OAAO,QAAQ,KAAK,GAAG;AAC1C,UAAI,QAAQ,OAAO;AACjB,sBAAc,GAAG,MAAM,CAAC;AAAA,MAC1B,OAAO;AACL,sBAAc,GAAG,GAAG,IAAI,IAAI,GAAG,IAAI,CAAC;AAAA,MACtC;AAAA,IACF;AAAA,EACF,OAAO;AACL,UAAM,IAAI,UAAU,sBAAsB,IAAI,KAAK,OAAO,KAAK,GAAG;AAAA,EACpE;AACF;~~AAEO~~,IAAM,cAAc,CAAC,MAAc,MAAY,YAAqB;AACzE,QAAM,IAAIC,MAAK,IAAI;AAInB,QAAM,iBAAiB,cAAc,IAAI;AACzC,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,cAAc,GAAG;AACzD,kBAAc,GAAG,KAAK,KAAK;AAAA,EAC7B;AACA,MAAIC,UAAS,KAAK,WAAW,GAAG;AAC9B,kBAAc,GAAG,eAAe,KAAK,WAAW;AAAA,EAClD;AACA,MAAIA,UAAS,KAAK,KAAK,GAAG;AACxB,MAAE,OAAO,EAAE,KAAK,KAAK,KAAK;AAAA,EAC5B;AACA,MAAIA,UAAS,OAAO,GAAG;AACrB,kBAAc,GAAG,gBAAgB,OAAO;AAAA,EAC1C;AACA,SAAO,EAAE,KAAK;AAChB;","names":["isString","isString","load","load","isString"]}
1	+ {"version":3,"sources":["../../src/html/mergeDocumentHead.ts","../../src/lib/getMetaAsDict.ts","../../src/meta/builder.ts"],"sourcesContent":["import { isString } from '@xylabs/typeof'\nimport { load } from 'cheerio'\n\nconst opts = {}\n// const opts = { decodeEntities: false }\n\n/*\n Merges meta tags from the source HTML head into the destination HTML head.\n * Existing meta tags with matching property attributes are replaced; others are appended.\n * @param destination - The base HTML string to merge into.\n * @param source - The HTML string whose head meta tags will be merged.\n * @returns The merged HTML string.\n /\nexport const mergeDocumentHead = (destination: string, source: string) => {\n const $destination = load(destination, opts)\n const $source = load(source, opts)\n\n // For each child node of the source head\n $source('head')\n .children()\n .each((_, element) => {\n const el = $destination(element)\n\n // Special case for meta tags: We want to match them by the name attribute\n if (el[0].tagName === 'meta') {\n const property = el.attr('property')\n if (isString(property)) {\n const match = $destination(`head meta[property=\"${property}\"]`)\n\n // If it exists, replace it, otherwise append it\n if (match.length > 0) {\n match.replaceWith(el)\n return\n } else {\n $destination('head').append(el)\n }\n }\n // else {\n // // For all other elements, just check if the same element exists in the first HTML string\n // const match = $destination(el[0].tagName)\n\n // // If it exists, replace it, otherwise append it\n // if (match.length > 0) {\n // match.replaceWith(el)\n // } else {\n // $destination('head').append(el)\n // }\n // }\n }\n })\n\n // Return the merged HTML\n return $destination.html(opts)\n}\n","import { isString } from '@xylabs/typeof'\n\n/* An object with string keys and arbitrary values, used for recursive meta flattening. /\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type StringIndexable = { [key: string]: any }\n\nconst propertyDelimiter = ':'\n\n/\n Recursively flattens a nested meta object into a flat dictionary with colon-delimited keys.\n * @param obj - The nested object to flatten.\n * @param parentKey - The accumulated key prefix from parent levels.\n * @returns A flat record mapping colon-delimited property names to string values.\n /\nexport const getMetaAsDict = (obj: StringIndexable, parentKey?: string): Record<string, string> => {\n let flatRecord: StringIndexable = {}\n for (const key in obj) {\n if (typeof obj[key] === 'object' && obj[key] !== null) {\n // If the value is another object, we want to iterate through its keys as well.\n const childRecord = getMetaAsDict(obj[key] as StringIndexable, `${isString(parentKey) ? parentKey : ''}${key}${propertyDelimiter}`)\n flatRecord = { ...flatRecord, ...childRecord }\n } else {\n // Concatenate the key with its parent key.\n const newKey = isString(parentKey) ? `${parentKey}${key}` : key\n const trimmed = newKey.endsWith(propertyDelimiter) ? newKey.slice(0, -1) : newKey\n flatRecord[trimmed] = `${obj[key]}`\n }\n }\n return flatRecord\n}\n","import { isString } from '@xylabs/typeof'\nimport type { CheerioAPI } from 'cheerio'\nimport { load } from 'cheerio'\n\nimport { getMetaAsDict } from '../lib/index.ts'\nimport type { Meta } from '../models/index.ts'\n\n/ test change /\n\n/\n Adds or replaces a meta tag in the document head.\n * @param $ - The Cheerio API instance for the document.\n * @param name - The meta property name.\n * @param value - The meta content value (string, array, or nested object).\n /\nexport const addMetaToHead = ($: CheerioAPI, name: string, value: string \| object) => {\n if (typeof value === 'string') {\n const newMeta = `<meta property=\"${name}\" content=\"${value}\" />`\n const existingMeta = $(`head meta[property=\"${name}\"]`)\n if ((existingMeta?.length ?? 0) > 0) {\n existingMeta.replaceWith(newMeta)\n } else {\n $('head').append(newMeta)\n }\n } else if (Array.isArray(value)) {\n for (const item of value) addMetaToHead($, `${name}`, item)\n } else if (typeof value === 'object') {\n for (let [key, v] of Object.entries(value)) {\n if (key === 'url') {\n addMetaToHead($, name, v)\n } else {\n addMetaToHead($, `${name}:${key}`, v)\n }\n }\n } else {\n throw new TypeError(`Invalid item type [${name}, ${typeof value}]`)\n }\n}\n\n/\n Injects meta properties, title, and description into an HTML string.\n * @param html - The base HTML string to modify.\n * @param meta - The metadata to inject.\n * @param handler - Optional meta-handler property value to include.\n * @returns The modified HTML string with injected metadata.\n */\nexport const metaBuilder = (html: string, meta: Meta, handler?: string) => {\n const $ = load(html)\n // NOTE: This assumes unique meta properties (no duplicates)\n // which is generally the case, but not always (you can have\n // multiple og:video:tag tags, for example)\n const metaProperties = getMetaAsDict(meta)\n for (const [key, value] of Object.entries(metaProperties)) {\n addMetaToHead($, key, value)\n }\n if (isString(meta.description)) {\n addMetaToHead($, 'description', meta.description)\n }\n if (isString(meta.title)) {\n $('title').text(meta.title)\n }\n if (isString(handler)) {\n addMetaToHead($, 'meta-handler', handler)\n }\n return $.html()\n}\n"],"mappings":";AAAA,SAAS,gBAAgB;AACzB,SAAS,YAAY;AAErB,IAAM,OAAO,CAAC;AAUP,IAAM,oBAAoB,CAAC,aAAqB,WAAmB;AACxE,QAAM,eAAe,KAAK,aAAa,IAAI;AAC3C,QAAM,UAAU,KAAK,QAAQ,IAAI;AAGjC,UAAQ,MAAM,EACX,SAAS,EACT,KAAK,CAAC,GAAG,YAAY;AACpB,UAAM,KAAK,aAAa,OAAO;AAG/B,QAAI,GAAG,CAAC,EAAE,YAAY,QAAQ;AAC5B,YAAM,WAAW,GAAG,KAAK,UAAU;AACnC,UAAI,SAAS,QAAQ,GAAG;AACtB,cAAM,QAAQ,aAAa,uBAAuB,QAAQ,IAAI;AAG9D,YAAI,MAAM,SAAS,GAAG;AACpB,gBAAM,YAAY,EAAE;AACpB;AAAA,QACF,OAAO;AACL,uBAAa,MAAM,EAAE,OAAO,EAAE;AAAA,QAChC;AAAA,MACF;AAAA,IAYF;AAAA,EACF,CAAC;AAGH,SAAO,aAAa,KAAK,IAAI;AAC/B;;;ACrDA,SAAS,YAAAA,iBAAgB;AAMzB,IAAM,oBAAoB;AAQnB,IAAM,gBAAgB,CAAC,KAAsB,cAA+C;AACjG,MAAI,aAA8B,CAAC;AACnC,aAAW,OAAO,KAAK;AACrB,QAAI,OAAO,IAAI,GAAG,MAAM,YAAY,IAAI,GAAG,MAAM,MAAM;AAErD,YAAM,cAAc,cAAc,IAAI,GAAG,GAAsB,GAAGA,UAAS,SAAS,IAAI,YAAY,EAAE,GAAG,GAAG,GAAG,iBAAiB,EAAE;AAClI,mBAAa,EAAE,GAAG,YAAY,GAAG,YAAY;AAAA,IAC/C,OAAO;AAEL,YAAM,SAASA,UAAS,SAAS,IAAI,GAAG,SAAS,GAAG,GAAG,KAAK;AAC5D,YAAM,UAAU,OAAO,SAAS,iBAAiB,IAAI,OAAO,MAAM,GAAG,EAAE,IAAI;AAC3E,iBAAW,OAAO,IAAI,GAAG,IAAI,GAAG,CAAC;AAAA,IACnC;AAAA,EACF;AACA,SAAO;AACT;;;AC7BA,SAAS,YAAAC,iBAAgB;AAEzB,SAAS,QAAAC,aAAY;AAad,IAAM,gBAAgB,CAAC,GAAe,MAAc,UAA2B;AACpF,MAAI,OAAO,UAAU,UAAU;AAC7B,UAAM,UAAU,mBAAmB,IAAI,cAAc,KAAK;AAC1D,UAAM,eAAe,EAAE,uBAAuB,IAAI,IAAI;AACtD,SAAK,cAAc,UAAU,KAAK,GAAG;AACnC,mBAAa,YAAY,OAAO;AAAA,IAClC,OAAO;AACL,QAAE,MAAM,EAAE,OAAO,OAAO;AAAA,IAC1B;AAAA,EACF,WAAW,MAAM,QAAQ,KAAK,GAAG;AAC/B,eAAW,QAAQ,MAAO,eAAc,GAAG,GAAG,IAAI,IAAI,IAAI;AAAA,EAC5D,WAAW,OAAO,UAAU,UAAU;AACpC,aAAS,CAAC,KAAK,CAAC,KAAK,OAAO,QAAQ,KAAK,GAAG;AAC1C,UAAI,QAAQ,OAAO;AACjB,sBAAc,GAAG,MAAM,CAAC;AAAA,MAC1B,OAAO;AACL,sBAAc,GAAG,GAAG,IAAI,IAAI,GAAG,IAAI,CAAC;AAAA,MACtC;AAAA,IACF;AAAA,EACF,OAAO;AACL,UAAM,IAAI,UAAU,sBAAsB,IAAI,KAAK,OAAO,KAAK,GAAG;AAAA,EACpE;AACF;AASO,IAAM,cAAc,CAAC,MAAc,MAAY,YAAqB;AACzE,QAAM,IAAIC,MAAK,IAAI;AAInB,QAAM,iBAAiB,cAAc,IAAI;AACzC,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,cAAc,GAAG;AACzD,kBAAc,GAAG,KAAK,KAAK;AAAA,EAC7B;AACA,MAAIC,UAAS,KAAK,WAAW,GAAG;AAC9B,kBAAc,GAAG,eAAe,KAAK,WAAW;AAAA,EAClD;AACA,MAAIA,UAAS,KAAK,KAAK,GAAG;AACxB,MAAE,OAAO,EAAE,KAAK,KAAK,KAAK;AAAA,EAC5B;AACA,MAAIA,UAAS,OAAO,GAAG;AACrB,kBAAc,GAAG,gBAAgB,OAAO;AAAA,EAC1C;AACA,SAAO,EAAE,KAAK;AAChB;","names":["isString","isString","load","load","isString"]}

package/dist/neutral/lib/getMetaAsDict.d.ts CHANGED Viewed

@@ -1,5 +1,12 @@
+/** An object with string keys and arbitrary values, used for recursive meta flattening. */
 export type StringIndexable = {
     [key: string]: any;
 };
+/**
+ * Recursively flattens a nested meta object into a flat dictionary with colon-delimited keys.
+ * @param obj - The nested object to flatten.
+ * @param parentKey - The accumulated key prefix from parent levels.
+ * @returns A flat record mapping colon-delimited property names to string values.
+ */
 export declare const getMetaAsDict: (obj: StringIndexable, parentKey?: string) => Record<string, string>;
 //# sourceMappingURL=getMetaAsDict.d.ts.map

package/dist/neutral/lib/getMetaAsDict.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"getMetaAsDict.d.ts","sourceRoot":"","sources":["../../../src/lib/getMetaAsDict.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,eAAe,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,CAAA;AAIpD,eAAO,MAAM,aAAa,GAAI,KAAK,eAAe,EAAE,YAAY,MAAM,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAe7F,CAAA"}
1	+ {"version":3,"file":"getMetaAsDict.d.ts","sourceRoot":"","sources":["../../../src/lib/getMetaAsDict.ts"],"names":[],"mappings":"AAEA,2FAA2F;AAE3F,MAAM,MAAM,eAAe,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,CAAA;AAIpD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,eAAe,EAAE,YAAY,MAAM,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAe7F,CAAA"}

package/dist/neutral/meta/builder.d.ts CHANGED Viewed

@@ -1,5 +1,18 @@
 import type { CheerioAPI } from 'cheerio';
 import type { Meta } from '../models/index.ts';
+/**
+ * Adds or replaces a meta tag in the document head.
+ * @param $ - The Cheerio API instance for the document.
+ * @param name - The meta property name.
+ * @param value - The meta content value (string, array, or nested object).
+ */
 export declare const addMetaToHead: ($: CheerioAPI, name: string, value: string | object) => void;
+/**
+ * Injects meta properties, title, and description into an HTML string.
+ * @param html - The base HTML string to modify.
+ * @param meta - The metadata to inject.
+ * @param handler - Optional meta-handler property value to include.
+ * @returns The modified HTML string with injected metadata.
+ */
 export declare const metaBuilder: (html: string, meta: Meta, handler?: string) => string;
 //# sourceMappingURL=builder.d.ts.map

package/dist/neutral/meta/builder.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../src/meta/builder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAIzC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AAI9C,eAAO,MAAM,aAAa,GAAI,GAAG,UAAU,EAAE,MAAM,MAAM,EAAE,OAAO,MAAM,GAAG,MAAM,SAsBhF,CAAA;AAED,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,EAAE,MAAM,IAAI,EAAE,UAAU,MAAM,WAmBrE,CAAA"}
1	+ {"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../src/meta/builder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAIzC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AAI9C;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,GAAG,UAAU,EAAE,MAAM,MAAM,EAAE,OAAO,MAAM,GAAG,MAAM,SAsBhF,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,EAAE,MAAM,IAAI,EAAE,UAAU,MAAM,WAmBrE,CAAA"}

package/dist/neutral/models/Meta.d.ts CHANGED Viewed

@@ -1,5 +1,6 @@
 import type { OpenGraphMeta } from './OpenGraph/index.ts';
 import type { TwitterMeta } from './Twitter/index.ts';
+/** Represents page metadata including Open Graph and Twitter card properties. */
 export interface Meta {
     description?: string;
     og?: OpenGraphMeta;

package/dist/neutral/models/Meta.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"Meta.d.ts","sourceRoot":"","sources":["../../../src/models/Meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAErD,MAAM,WAAW,IAAI;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,EAAE,CAAC,EAAE,aAAa,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,WAAW,CAAA;CACtB"}
1	+ {"version":3,"file":"Meta.d.ts","sourceRoot":"","sources":["../../../src/models/Meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAErD,iFAAiF;AACjF,MAAM,WAAW,IAAI;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,EAAE,CAAC,EAAE,aAAa,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,WAAW,CAAA;CACtB"}

package/dist/neutral/models/OpenGraph/OpenGraphMeta.d.ts CHANGED Viewed

@@ -1,4 +1,5 @@
 import type { OpenGraphStructuredProperty } from './OpenGraphStructuredProperty.ts';
+/** Open Graph protocol metadata for rich link previews. */
 export interface OpenGraphMeta {
     audio?: OpenGraphStructuredProperty;
     description?: string;

package/dist/neutral/models/OpenGraph/OpenGraphMeta.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"OpenGraphMeta.d.ts","sourceRoot":"","sources":["../../../../src/models/OpenGraph/OpenGraphMeta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAA;AAKnF,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,2BAA2B,CAAA;IACnC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,2BAA2B,CAAA;IACnC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,2BAA2B,CAAA;CACpC"}
1	+ {"version":3,"file":"OpenGraphMeta.d.ts","sourceRoot":"","sources":["../../../../src/models/OpenGraph/OpenGraphMeta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAA;AAKnF,2DAA2D;AAC3D,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,2BAA2B,CAAA;IACnC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,2BAA2B,CAAA;IACnC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,2BAA2B,CAAA;CACpC"}

package/dist/neutral/models/OpenGraph/OpenGraphStructured.d.ts CHANGED Viewed

@@ -1,3 +1,4 @@
+/** Structured properties for an Open Graph media object (image, video, or audio). */
 export interface OpenGraphStructured {
     ''?: string;
     'alt'?: string;

package/dist/neutral/models/OpenGraph/OpenGraphStructured.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"OpenGraphStructured.d.ts","sourceRoot":"","sources":["../../../../src/models/OpenGraph/OpenGraphStructured.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB"}
1	+ {"version":3,"file":"OpenGraphStructured.d.ts","sourceRoot":"","sources":["../../../../src/models/OpenGraph/OpenGraphStructured.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,MAAM,WAAW,mBAAmB;IAClC,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB"}

package/dist/neutral/models/OpenGraph/OpenGraphStructuredProperty.d.ts CHANGED Viewed

@@ -1,3 +1,4 @@
 import type { OpenGraphStructured } from './OpenGraphStructured.ts';
+/** A structured Open Graph property value: a URL string, a structured object, or an array of either. */
 export type OpenGraphStructuredProperty = string | OpenGraphStructured | (string | OpenGraphStructured)[];
 //# sourceMappingURL=OpenGraphStructuredProperty.d.ts.map

package/dist/neutral/models/OpenGraph/OpenGraphStructuredProperty.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"OpenGraphStructuredProperty.d.ts","sourceRoot":"","sources":["../../../../src/models/OpenGraph/OpenGraphStructuredProperty.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAEnE,MAAM,MAAM,2BAA2B,GAAG,MAAM,GAAG,mBAAmB,GAAG,CAAC,MAAM,GAAG,mBAAmB,CAAC,EAAE,CAAA"}
1	+ {"version":3,"file":"OpenGraphStructuredProperty.d.ts","sourceRoot":"","sources":["../../../../src/models/OpenGraph/OpenGraphStructuredProperty.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAEnE,wGAAwG;AACxG,MAAM,MAAM,2BAA2B,GAAG,MAAM,GAAG,mBAAmB,GAAG,CAAC,MAAM,GAAG,mBAAmB,CAAC,EAAE,CAAA"}

package/dist/neutral/models/Twitter/TwitterApp.d.ts CHANGED Viewed

@@ -1,3 +1,4 @@
+/** Twitter App Card metadata containing app store identifiers, names, and URLs per platform. */
 export interface TwitterApp {
     id?: {
         googleplay?: string;

package/dist/neutral/models/Twitter/TwitterApp.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"TwitterApp.d.ts","sourceRoot":"","sources":["../../../../src/models/Twitter/TwitterApp.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,EAAE,CAAC,EAAE;QACH,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,CAAA;IACD,IAAI,CAAC,EAAE;QACL,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,CAAA;IACD,GAAG,CAAC,EAAE;QACJ,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,CAAA;CACF"}
1	+ {"version":3,"file":"TwitterApp.d.ts","sourceRoot":"","sources":["../../../../src/models/Twitter/TwitterApp.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,MAAM,WAAW,UAAU;IACzB,EAAE,CAAC,EAAE;QACH,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,CAAA;IACD,IAAI,CAAC,EAAE;QACL,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,CAAA;IACD,GAAG,CAAC,EAAE;QACJ,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,CAAA;CACF"}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@xylabs/sdk-meta",
-  "version": "5.0.83",
+  "version": "5.0.86",
   "description": "Base functionality used throughout XYO TypeScript/JavaScript libraries",
   "keywords": [
     "meta",
@@ -37,13 +37,13 @@
     "!**/*.test.*"
   ],
   "dependencies": {
-    "@xylabs/typeof": "~5.0.83",
+    "@xylabs/typeof": "~5.0.86",
     "cheerio": "~1.2.0"
   },
   "devDependencies": {
     "@types/node": "~25.4.0",
-    "@xylabs/ts-scripts-yarn3": "~7.4.11",
-    "@xylabs/tsconfig": "~7.4.11",
+    "@xylabs/ts-scripts-yarn3": "~7.4.16",
+    "@xylabs/tsconfig": "~7.4.16",
     "typescript": "~5.9.3",
     "vitest": "~4.0.18"
   },