@answerable-kit/schemas 0.1.0

package/README.md

@@ -0,0 +1,39 @@
+# @answerable-kit/schemas
+
+Type-safe JSON-LD generators for the [Answerable](https://github.com/Anuj7411/answerable) SEO toolkit. Each generator returns a fully-typed `WithContext<T>` object validated at the type level by [`schema-dts`](https://github.com/google/schema-dts).
+
+> **Pre-alpha.** Only `organization()` and `webSite()` ship today. Eight generators land in Phase 1 — see the [project roadmap](../../docs/internal/ROADMAP.md).
+
+## Install
+
+```bash
+pnpm add @answerable-kit/schemas
+```
+
+## Usage
+
+```ts
+import { organization, webSite } from '@answerable-kit/schemas';
+
+const org = organization({
+  name: 'Acme',
+  url: 'https://acme.com',
+  logo: 'https://acme.com/logo.png',
+  sameAs: ['https://twitter.com/acme', 'https://github.com/acme'],
+});
+
+const site = webSite({
+  name: 'Acme',
+  url: 'https://acme.com',
+  searchUrlTemplate: 'https://acme.com/search?q={search_term_string}',
+});
+
+// Inject as JSON-LD in your Next.js layout:
+// <script type="application/ld+json">{JSON.stringify(org)}</script>
+```
+
+All URL inputs are validated as absolute `http(s)` URLs at runtime — invalid input throws `InvalidUrlError` from `@answerable-kit/core`.
+
+## License
+
+[MIT](../../LICENSE) © 2026 Anuj Ojha

package/dist/_internal.d.ts

@@ -0,0 +1,14 @@
+import type { Thing, WithContext } from 'schema-dts';
+/**
+ * schema-dts models every schema.org class as `XLeaf | … | string`,
+ * where the trailing string is the JSON-LD `@id` reference form. This
+ * helper strips that reference variant so callers of our generators
+ * can access fields directly (e.g. `.logo`, `.mainEntity`) without
+ * first having to rule out the string branch.
+ *
+ * Constrained to `Thing` because `WithContext` requires it.
+ *
+ * Internal — not part of the public API.
+ */
+export type Schema<T extends Thing> = WithContext<Exclude<T, string>>;
+//# sourceMappingURL=_internal.d.ts.map

package/dist/_internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_internal.d.ts","sourceRoot":"","sources":["../src/_internal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAErD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,SAAS,KAAK,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC"}

package/dist/_internal.js

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

package/dist/_internal.js.map

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

package/dist/_offers.d.ts

@@ -0,0 +1,47 @@
+import type { AggregateRating, Offer } from 'schema-dts';
+/**
+ * Availability values accepted by schema.org's `ItemAvailability`
+ * enumeration. We accept the short form here and emit the full
+ * `https://schema.org/<value>` URI in JSON-LD output (Google's
+ * preferred form).
+ */
+export type OfferAvailability = 'InStock' | 'OutOfStock' | 'PreOrder' | 'BackOrder' | 'Discontinued' | 'LimitedAvailability' | 'SoldOut';
+export interface OffersInput {
+    /** Price as a number. `0` is valid (free app, free product). */
+    readonly price: number;
+    /** ISO 4217 three-letter currency code, e.g. `"USD"`, `"EUR"`. */
+    readonly priceCurrency: string;
+    readonly availability?: OfferAvailability | undefined;
+    /** Optional purchase / pricing-page URL. Must be absolute http(s). */
+    readonly url?: string | undefined;
+}
+export interface AggregateRatingInput {
+    /** Average rating. Must be between `worstRating` and `bestRating`. */
+    readonly ratingValue: number;
+    /** Number of ratings. Must be a non-negative integer. */
+    readonly ratingCount: number;
+    /** Defaults to 5 when omitted (the schema.org default). */
+    readonly bestRating?: number | undefined;
+    /** Defaults to 1 when omitted (the schema.org default). */
+    readonly worstRating?: number | undefined;
+}
+/**
+ * Collect every validation issue in an offers block. Returns an empty
+ * array on valid input; callers concat into one batched
+ * `SchemaValidationError`.
+ */
+export declare function validateOffers(o: OffersInput, prefix: string): string[];
+/**
+ * Collect every validation issue in an aggregate-rating block.
+ */
+export declare function validateAggregateRating(r: AggregateRatingInput, prefix: string): string[];
+/**
+ * Build the JSON-LD `Offer` nested object. URL validation runs here —
+ * call only after `validateOffers` has confirmed the other fields.
+ */
+export declare function buildOffer(o: OffersInput): Exclude<Offer, string>;
+/**
+ * Build the JSON-LD `AggregateRating` nested object.
+ */
+export declare function buildAggregateRating(r: AggregateRatingInput): Exclude<AggregateRating, string>;
+//# sourceMappingURL=_offers.d.ts.map

package/dist/_offers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_offers.d.ts","sourceRoot":"","sources":["../src/_offers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GACzB,SAAS,GACT,YAAY,GACZ,UAAU,GACV,WAAW,GACX,cAAc,GACd,qBAAqB,GACrB,SAAS,CAAC;AAEd,MAAM,WAAW,WAAW;IAC1B,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACtD,sEAAsE;IACtE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,MAAM,WAAW,oBAAoB;IACnC,sEAAsE;IACtE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,yDAAyD;IACzD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,2DAA2D;IAC3D,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C;AAKD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAavE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAkBzF;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAajE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,EAAE,MAAM,CAAC,CAa9F"}

package/dist/_offers.js

@@ -0,0 +1,78 @@
+import { parseAbsoluteUrl } from '@answerable-kit/core';
+/** ISO 4217 currency codes are exactly three uppercase letters. */
+const ISO_4217 = /^[A-Z]{3}$/;
+/**
+ * Collect every validation issue in an offers block. Returns an empty
+ * array on valid input; callers concat into one batched
+ * `SchemaValidationError`.
+ */
+export function validateOffers(o, prefix) {
+    const issues = [];
+    if (!Number.isFinite(o.price)) {
+        issues.push(`${prefix}.price must be a finite number (got ${o.price})`);
+    }
+    else if (o.price < 0) {
+        issues.push(`${prefix}.price must be non-negative (got ${o.price})`);
+    }
+    if (!ISO_4217.test(o.priceCurrency)) {
+        issues.push(`${prefix}.priceCurrency must be a 3-letter ISO 4217 code (got "${o.priceCurrency}")`);
+    }
+    return issues;
+}
+/**
+ * Collect every validation issue in an aggregate-rating block.
+ */
+export function validateAggregateRating(r, prefix) {
+    const issues = [];
+    const best = r.bestRating ?? 5;
+    const worst = r.worstRating ?? 1;
+    if (worst > best) {
+        issues.push(`${prefix}: worstRating (${worst}) cannot exceed bestRating (${best})`);
+    }
+    if (!Number.isFinite(r.ratingValue)) {
+        issues.push(`${prefix}.ratingValue must be a finite number (got ${r.ratingValue})`);
+    }
+    else if (r.ratingValue < worst || r.ratingValue > best) {
+        issues.push(`${prefix}.ratingValue must be between ${worst} and ${best} (got ${r.ratingValue})`);
+    }
+    if (!Number.isInteger(r.ratingCount) || r.ratingCount < 0) {
+        issues.push(`${prefix}.ratingCount must be a non-negative integer (got ${r.ratingCount})`);
+    }
+    return issues;
+}
+/**
+ * Build the JSON-LD `Offer` nested object. URL validation runs here —
+ * call only after `validateOffers` has confirmed the other fields.
+ */
+export function buildOffer(o) {
+    const out = {
+        '@type': 'Offer',
+        price: o.price,
+        priceCurrency: o.priceCurrency,
+    };
+    if (o.availability !== undefined) {
+        out.availability = `https://schema.org/${o.availability}`;
+    }
+    if (o.url !== undefined) {
+        out.url = parseAbsoluteUrl(o.url);
+    }
+    return out;
+}
+/**
+ * Build the JSON-LD `AggregateRating` nested object.
+ */
+export function buildAggregateRating(r) {
+    const out = {
+        '@type': 'AggregateRating',
+        ratingValue: r.ratingValue,
+        ratingCount: r.ratingCount,
+    };
+    if (r.bestRating !== undefined) {
+        out.bestRating = r.bestRating;
+    }
+    if (r.worstRating !== undefined) {
+        out.worstRating = r.worstRating;
+    }
+    return out;
+}
+//# sourceMappingURL=_offers.js.map

package/dist/_offers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_offers.js","sourceRoot":"","sources":["../src/_offers.ts"],"names":[],"mappings":"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"}

package/dist/article.d.ts

@@ -0,0 +1,64 @@
+import type { Article, BlogPosting } from 'schema-dts';
+import type { Schema } from './_internal.js';
+/**
+ * The author of an article. A discriminated union so the type system
+ * knows whether `url` is required (Organization) or optional (Person)
+ * and whether `logo` is meaningful at all (Organization only).
+ */
+export type AuthorInput = {
+    readonly type: 'Person';
+    readonly name: string;
+    readonly url?: string | undefined;
+} | {
+    readonly type: 'Organization';
+    readonly name: string;
+    readonly url: string;
+    readonly logo?: string | undefined;
+};
+/**
+ * The publisher of an article — always an Organization per Google's
+ * structured-data guidelines for Article / BlogPosting.
+ */
+export interface PublisherInput {
+    readonly name: string;
+    readonly url: string;
+    readonly logo?: string | undefined;
+}
+export interface ArticleInput {
+    readonly headline: string;
+    /** Canonical URL of the article. */
+    readonly url: string;
+    readonly description?: string | undefined;
+    /** Hero/cover image absolute URL. */
+    readonly image?: string | undefined;
+    /**
+     * ISO 8601 date string. Accepts date-only (`"2026-05-14"`) or
+     * date-time (`"2026-05-14T12:00:00Z"`, `"2026-05-14T12:00:00+05:30"`).
+     */
+    readonly datePublished: string;
+    /** Same format as `datePublished`. */
+    readonly dateModified?: string | undefined;
+    readonly author: AuthorInput;
+    readonly publisher: PublisherInput;
+}
+/**
+ * Generate a fully-typed JSON-LD `Article` object. Drives audit
+ * check **C5** and supplies the date/author signals that the
+ * E-E-A-T checks **D7** and **D8** look for.
+ *
+ * @throws SchemaValidationError batching every empty-string and
+ *   bad-date issue found in `input`.
+ * @throws InvalidUrlError for the first malformed URL encountered
+ *   (`url`, `image`, `author.url`, `author.logo`, `publisher.url`,
+ *   `publisher.logo`).
+ */
+export declare function article(input: ArticleInput): Schema<Article>;
+/**
+ * Same shape as `article()` but emits `@type: 'BlogPosting'`. In
+ * schema.org, `BlogPosting` extends `Article`, so every field that
+ * works on `article()` works here too.
+ *
+ * @throws SchemaValidationError / InvalidUrlError — see `article()`.
+ */
+export declare function blogPosting(input: ArticleInput): Schema<BlogPosting>;
+//# sourceMappingURL=article.d.ts.map

package/dist/article.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"article.d.ts","sourceRoot":"","sources":["../src/article.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAwB,MAAM,YAAY,CAAC;AAC7E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;GAIG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACrF;IACE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC,CAAC;AAEN;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,oCAAoC;IACpC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,qCAAqC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,sCAAsC;IACtC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;CACpC;AA8GD;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,CAO5D;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAAC,WAAW,CAAC,CAOpE"}

package/dist/article.js

@@ -0,0 +1,139 @@
+import { SchemaValidationError, parseAbsoluteUrl } from '@answerable-kit/core';
+/**
+ * ISO 8601 date (`YYYY-MM-DD`) or date-time with optional fractional
+ * seconds and timezone. Tighter than `Date.parse`, which (a) accepts
+ * loose formats like `"5/14/2026"` and (b) silently rolls over
+ * impossible dates like `"2026-02-30"` to March 2. We catch both.
+ */
+const ISO_DATE_OR_DATETIME = /^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}(:\d{2}(\.\d{1,9})?)?(Z|[+-]\d{2}:?\d{2})?)?$/;
+function isValidIso8601(s) {
+    if (!ISO_DATE_OR_DATETIME.test(s))
+        return false;
+    if (Number.isNaN(Date.parse(s)))
+        return false;
+    // Date.parse rolls impossible calendar dates over silently
+    // ("2026-02-30" → March 2). Validate the date portion by
+    // round-tripping the year/month/day through a UTC Date.
+    const [yearStr, monthStr, dayStr] = s.slice(0, 10).split('-');
+    if (yearStr === undefined || monthStr === undefined || dayStr === undefined)
+        return false;
+    const year = Number(yearStr);
+    const month = Number(monthStr);
+    const day = Number(dayStr);
+    const d = new Date(Date.UTC(year, month - 1, day));
+    return d.getUTCFullYear() === year && d.getUTCMonth() === month - 1 && d.getUTCDate() === day;
+}
+function validateArticleInput(input) {
+    const issues = [];
+    if (input.headline.trim() === '') {
+        issues.push('headline is empty');
+    }
+    if (input.author.name.trim() === '') {
+        issues.push('author.name is empty');
+    }
+    if (input.publisher.name.trim() === '') {
+        issues.push('publisher.name is empty');
+    }
+    if (!isValidIso8601(input.datePublished)) {
+        issues.push(`datePublished is not a valid ISO 8601 date (got "${input.datePublished}")`);
+    }
+    if (input.dateModified !== undefined && !isValidIso8601(input.dateModified)) {
+        issues.push(`dateModified is not a valid ISO 8601 date (got "${input.dateModified}")`);
+    }
+    if (issues.length > 0) {
+        throw new SchemaValidationError(issues);
+    }
+}
+function buildAuthor(a) {
+    if (a.type === 'Person') {
+        const out = {
+            '@type': 'Person',
+            name: a.name,
+        };
+        if (a.url !== undefined) {
+            out.url = parseAbsoluteUrl(a.url);
+        }
+        return out;
+    }
+    const out = {
+        '@type': 'Organization',
+        name: a.name,
+        url: parseAbsoluteUrl(a.url),
+    };
+    if (a.logo !== undefined) {
+        out.logo = parseAbsoluteUrl(a.logo);
+    }
+    return out;
+}
+function buildPublisher(p) {
+    const out = {
+        '@type': 'Organization',
+        name: p.name,
+        url: parseAbsoluteUrl(p.url),
+    };
+    if (p.logo !== undefined) {
+        out.logo = parseAbsoluteUrl(p.logo);
+    }
+    return out;
+}
+/**
+ * Common body shared by `article()` and `blogPosting()`. Returns
+ * everything except `@context` and `@type` so each entry point can
+ * supply its own discriminator.
+ */
+function buildArticleBody(input) {
+    const url = parseAbsoluteUrl(input.url);
+    const body = {
+        headline: input.headline,
+        url,
+        mainEntityOfPage: url,
+        datePublished: input.datePublished,
+        author: buildAuthor(input.author),
+        publisher: buildPublisher(input.publisher),
+    };
+    if (input.description !== undefined) {
+        body.description = input.description;
+    }
+    if (input.image !== undefined) {
+        body.image = parseAbsoluteUrl(input.image);
+    }
+    if (input.dateModified !== undefined) {
+        body.dateModified = input.dateModified;
+    }
+    return body;
+}
+/**
+ * Generate a fully-typed JSON-LD `Article` object. Drives audit
+ * check **C5** and supplies the date/author signals that the
+ * E-E-A-T checks **D7** and **D8** look for.
+ *
+ * @throws SchemaValidationError batching every empty-string and
+ *   bad-date issue found in `input`.
+ * @throws InvalidUrlError for the first malformed URL encountered
+ *   (`url`, `image`, `author.url`, `author.logo`, `publisher.url`,
+ *   `publisher.logo`).
+ */
+export function article(input) {
+    validateArticleInput(input);
+    return {
+        '@context': 'https://schema.org',
+        '@type': 'Article',
+        ...buildArticleBody(input),
+    };
+}
+/**
+ * Same shape as `article()` but emits `@type: 'BlogPosting'`. In
+ * schema.org, `BlogPosting` extends `Article`, so every field that
+ * works on `article()` works here too.
+ *
+ * @throws SchemaValidationError / InvalidUrlError — see `article()`.
+ */
+export function blogPosting(input) {
+    validateArticleInput(input);
+    return {
+        '@context': 'https://schema.org',
+        '@type': 'BlogPosting',
+        ...buildArticleBody(input),
+    };
+}
+//# sourceMappingURL=article.js.map

package/dist/article.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"article.js","sourceRoot":"","sources":["../src/article.ts"],"names":[],"mappings":"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"}

package/dist/breadcrumb.d.ts

@@ -0,0 +1,22 @@
+import type { BreadcrumbList } from 'schema-dts';
+import type { Schema } from './_internal.js';
+export interface BreadcrumbItemInput {
+    readonly name: string;
+    /** Absolute http(s) URL the breadcrumb item links to. */
+    readonly url: string;
+}
+export interface BreadcrumbInput {
+    readonly items: readonly BreadcrumbItemInput[];
+}
+/**
+ * Generate a fully-typed JSON-LD `BreadcrumbList` object with positions
+ * assigned automatically starting from 1. Drives audit check `C7`.
+ *
+ * @throws SchemaValidationError if `items` is empty or any `name` is
+ *   blank after trimming.
+ * @throws InvalidUrlError if any `url` is not a valid http(s) URL.
+ *   URL validation runs after the empty-list / empty-name guards so
+ *   callers see the most useful failure first.
+ */
+export declare function breadcrumb(input: BreadcrumbInput): Schema<BreadcrumbList>;
+//# sourceMappingURL=breadcrumb.d.ts.map

package/dist/breadcrumb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"breadcrumb.d.ts","sourceRoot":"","sources":["../src/breadcrumb.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAChD;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAAC,cAAc,CAAC,CAyBzE"}

package/dist/breadcrumb.js

@@ -0,0 +1,36 @@
+import { SchemaValidationError, parseAbsoluteUrl } from '@answerable-kit/core';
+/**
+ * Generate a fully-typed JSON-LD `BreadcrumbList` object with positions
+ * assigned automatically starting from 1. Drives audit check `C7`.
+ *
+ * @throws SchemaValidationError if `items` is empty or any `name` is
+ *   blank after trimming.
+ * @throws InvalidUrlError if any `url` is not a valid http(s) URL.
+ *   URL validation runs after the empty-list / empty-name guards so
+ *   callers see the most useful failure first.
+ */
+export function breadcrumb(input) {
+    if (input.items.length === 0) {
+        throw new SchemaValidationError(['breadcrumb requires at least one item']);
+    }
+    const issues = [];
+    input.items.forEach((it, i) => {
+        if (it.name.trim() === '') {
+            issues.push(`items[${i}].name is empty`);
+        }
+    });
+    if (issues.length > 0) {
+        throw new SchemaValidationError(issues);
+    }
+    return {
+        '@context': 'https://schema.org',
+        '@type': 'BreadcrumbList',
+        itemListElement: input.items.map((it, i) => ({
+            '@type': 'ListItem',
+            position: i + 1,
+            name: it.name,
+            item: parseAbsoluteUrl(it.url),
+        })),
+    };
+}
+//# sourceMappingURL=breadcrumb.js.map

package/dist/breadcrumb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"breadcrumb.js","sourceRoot":"","sources":["../src/breadcrumb.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAc/E;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CAAC,KAAsB;IAC/C,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,qBAAqB,CAAC,CAAC,uCAAuC,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE;QAC5B,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO;QACL,UAAU,EAAE,oBAAoB;QAChC,OAAO,EAAE,gBAAgB;QACzB,eAAe,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3C,OAAO,EAAE,UAAU;YACnB,QAAQ,EAAE,CAAC,GAAG,CAAC;YACf,IAAI,EAAE,EAAE,CAAC,IAAI;YACb,IAAI,EAAE,gBAAgB,CAAC,EAAE,CAAC,GAAG,CAAC;SAC/B,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}

package/dist/faq-page.d.ts

@@ -0,0 +1,20 @@
+import type { FAQPage } from 'schema-dts';
+import type { Schema } from './_internal.js';
+export interface FaqQuestionInput {
+    readonly question: string;
+    readonly answer: string;
+}
+export interface FaqPageInput {
+    readonly questions: readonly FaqQuestionInput[];
+}
+/**
+ * Generate a fully-typed JSON-LD `FAQPage` object. AI answer engines
+ * (Perplexity, Claude, ChatGPT) and Google's rich-result FAQs both
+ * key off this schema, making it one of the highest-leverage helpers.
+ *
+ * @throws SchemaValidationError if `questions` is empty or if any
+ *   question / answer is blank after trimming whitespace. The error's
+ *   `issues` array enumerates every problem entry, not just the first.
+ */
+export declare function faqPage(input: FaqPageInput): Schema<FAQPage>;
+//# sourceMappingURL=faq-page.d.ts.map

package/dist/faq-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"faq-page.d.ts","sourceRoot":"","sources":["../src/faq-page.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACjD;AAED;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,CA8B5D"}

package/dist/faq-page.js

@@ -0,0 +1,40 @@
+import { SchemaValidationError } from '@answerable-kit/core';
+/**
+ * Generate a fully-typed JSON-LD `FAQPage` object. AI answer engines
+ * (Perplexity, Claude, ChatGPT) and Google's rich-result FAQs both
+ * key off this schema, making it one of the highest-leverage helpers.
+ *
+ * @throws SchemaValidationError if `questions` is empty or if any
+ *   question / answer is blank after trimming whitespace. The error's
+ *   `issues` array enumerates every problem entry, not just the first.
+ */
+export function faqPage(input) {
+    if (input.questions.length === 0) {
+        throw new SchemaValidationError(['faqPage requires at least one question']);
+    }
+    const issues = [];
+    input.questions.forEach((q, i) => {
+        if (q.question.trim() === '') {
+            issues.push(`questions[${i}].question is empty`);
+        }
+        if (q.answer.trim() === '') {
+            issues.push(`questions[${i}].answer is empty`);
+        }
+    });
+    if (issues.length > 0) {
+        throw new SchemaValidationError(issues);
+    }
+    return {
+        '@context': 'https://schema.org',
+        '@type': 'FAQPage',
+        mainEntity: input.questions.map((q) => ({
+            '@type': 'Question',
+            name: q.question,
+            acceptedAnswer: {
+                '@type': 'Answer',
+                text: q.answer,
+            },
+        })),
+    };
+}
+//# sourceMappingURL=faq-page.js.map

package/dist/faq-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"faq-page.js","sourceRoot":"","sources":["../src/faq-page.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAa7D;;;;;;;;GAQG;AACH,MAAM,UAAU,OAAO,CAAC,KAAmB;IACzC,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,qBAAqB,CAAC,CAAC,wCAAwC,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC/B,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,qBAAqB,CAAC,CAAC;QACnD,CAAC;QACD,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,mBAAmB,CAAC,CAAC;QACjD,CAAC;IACH,CAAC,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO;QACL,UAAU,EAAE,oBAAoB;QAChC,OAAO,EAAE,SAAS;QAClB,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACtC,OAAO,EAAE,UAAU;YACnB,IAAI,EAAE,CAAC,CAAC,QAAQ;YAChB,cAAc,EAAE;gBACd,OAAO,EAAE,QAAQ;gBACjB,IAAI,EAAE,CAAC,CAAC,MAAM;aACf;SACF,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}

package/dist/how-to.d.ts

@@ -0,0 +1,45 @@
+import type { HowTo } from 'schema-dts';
+import type { Schema } from './_internal.js';
+export interface HowToStepInput {
+    readonly name: string;
+    readonly text: string;
+    /** Absolute URL to an illustrative image for this step. */
+    readonly image?: string | undefined;
+    /** Absolute URL anchored to this step (e.g. a video timestamp). */
+    readonly url?: string | undefined;
+}
+export interface HowToInput {
+    readonly name: string;
+    readonly description?: string | undefined;
+    /**
+     * ISO 8601 duration string. Accepts the standard formats:
+     * - Time-only: `"PT15M"`, `"PT1H30M"`, `"PT30S"`, `"PT2H"`
+     * - Date-only: `"P1D"`, `"P2W"`, `"P1Y2M3D"`
+     * - Date + time: `"P1DT2H"`, `"P1Y2DT3H30M"`
+     *
+     * Fractional seconds are allowed (`"PT30.5S"`).
+     */
+    readonly totalTime?: string | undefined;
+    /** Absolute URL to a hero / cover image for the whole how-to. */
+    readonly image?: string | undefined;
+    /** Ordered list of steps. Must contain at least one entry. */
+    readonly steps: readonly HowToStepInput[];
+    /** Consumables needed (ingredients, materials). */
+    readonly supply?: readonly string[] | undefined;
+    /** Reusable tools needed (knives, hammers, software). */
+    readonly tool?: readonly string[] | undefined;
+}
+/**
+ * Generate a fully-typed JSON-LD `HowTo` object. Drives audit
+ * check **C8**.
+ *
+ * Steps are auto-numbered via the `position` field starting at 1 —
+ * callers don't supply positions themselves.
+ *
+ * @throws SchemaValidationError batching every issue across the
+ *   top-level fields and every step.
+ * @throws InvalidUrlError for the first malformed URL encountered
+ *   (`image`, any `steps[*].image`, any `steps[*].url`).
+ */
+export declare function howTo(input: HowToInput): Schema<HowTo>;
+//# sourceMappingURL=how-to.d.ts.map

package/dist/how-to.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"how-to.d.ts","sourceRoot":"","sources":["../src/how-to.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAqC,MAAM,YAAY,CAAC;AAC3E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,mEAAmE;IACnE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,iEAAiE;IACjE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IAC1C,mDAAmD;IACnD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAChD,yDAAyD;IACzD,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CAC/C;AA8ED;;;;;;;;;;;GAWG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CA2BtD"}

package/dist/how-to.js

@@ -0,0 +1,106 @@
+import { SchemaValidationError, parseAbsoluteUrl } from '@answerable-kit/core';
+/**
+ * Strict ISO 8601 duration. Schema.org accepts both the "weeks alone"
+ * form (`P2W`) and the "Y/M/D + T H/M/S" form, but not a mix of the two.
+ */
+const WEEK_ONLY = /^P(\d+)W$/;
+const DATE_AND_TIME = /^P(?:(\d+)Y)?(?:(\d+)M)?(?:(\d+)D)?(?:T(?:(\d+)H)?(?:(\d+)M)?(?:(\d+(?:\.\d+)?)S)?)?$/;
+function isValidIso8601Duration(s) {
+    // Quick rejects.
+    if (s.length < 3 || s.charAt(0) !== 'P')
+        return false;
+    // Weeks-only form (cannot combine with other components).
+    if (WEEK_ONLY.test(s))
+        return true;
+    const match = s.match(DATE_AND_TIME);
+    if (!match)
+        return false;
+    // A bare "T" with no time components is invalid (e.g. "P1DT").
+    if (s.includes('T') && !/T\d/.test(s))
+        return false;
+    // At least one component (Y/M/D/H/M/S) must be present —
+    // the regex itself would otherwise accept "P".
+    return match.slice(1).some((g) => g !== undefined);
+}
+function validateHowToInput(input) {
+    const issues = [];
+    if (input.name.trim() === '') {
+        issues.push('name is empty');
+    }
+    if (input.steps.length === 0) {
+        issues.push('steps must contain at least one step');
+    }
+    input.steps.forEach((step, i) => {
+        if (step.name.trim() === '') {
+            issues.push(`steps[${i}].name is empty`);
+        }
+        if (step.text.trim() === '') {
+            issues.push(`steps[${i}].text is empty`);
+        }
+    });
+    if (input.totalTime !== undefined && !isValidIso8601Duration(input.totalTime)) {
+        issues.push(`totalTime is not a valid ISO 8601 duration (got "${input.totalTime}"). Expected formats like "PT15M", "PT1H30M", or "P1D".`);
+    }
+    if (issues.length > 0) {
+        throw new SchemaValidationError(issues);
+    }
+}
+function buildStep(s, position) {
+    const out = {
+        '@type': 'HowToStep',
+        position,
+        name: s.name,
+        text: s.text,
+    };
+    if (s.image !== undefined) {
+        out.image = parseAbsoluteUrl(s.image);
+    }
+    if (s.url !== undefined) {
+        out.url = parseAbsoluteUrl(s.url);
+    }
+    return out;
+}
+function buildSupply(name) {
+    return { '@type': 'HowToSupply', name };
+}
+function buildTool(name) {
+    return { '@type': 'HowToTool', name };
+}
+/**
+ * Generate a fully-typed JSON-LD `HowTo` object. Drives audit
+ * check **C8**.
+ *
+ * Steps are auto-numbered via the `position` field starting at 1 —
+ * callers don't supply positions themselves.
+ *
+ * @throws SchemaValidationError batching every issue across the
+ *   top-level fields and every step.
+ * @throws InvalidUrlError for the first malformed URL encountered
+ *   (`image`, any `steps[*].image`, any `steps[*].url`).
+ */
+export function howTo(input) {
+    validateHowToInput(input);
+    const out = {
+        '@context': 'https://schema.org',
+        '@type': 'HowTo',
+        name: input.name,
+        step: input.steps.map((s, i) => buildStep(s, i + 1)),
+    };
+    if (input.description !== undefined) {
+        out.description = input.description;
+    }
+    if (input.totalTime !== undefined) {
+        out.totalTime = input.totalTime;
+    }
+    if (input.image !== undefined) {
+        out.image = parseAbsoluteUrl(input.image);
+    }
+    if (input.supply !== undefined && input.supply.length > 0) {
+        out.supply = input.supply.map(buildSupply);
+    }
+    if (input.tool !== undefined && input.tool.length > 0) {
+        out.tool = input.tool.map(buildTool);
+    }
+    return out;
+}
+//# sourceMappingURL=how-to.js.map

package/dist/how-to.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"how-to.js","sourceRoot":"","sources":["../src/how-to.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @answerable-kit/schemas — type-safe JSON-LD generators for the
+ * Answerable SEO toolkit. Each helper returns a `WithContext<T>`
+ * object from `schema-dts` (narrowed to remove the IRI-reference
+ * variant) that's ready to be embedded as
+ * `<script type="application/ld+json">{...}</script>`.
+ */
+export declare const VERSION = "0.0.0";
+export { article, blogPosting, type ArticleInput, type AuthorInput, type PublisherInput, } from './article.js';
+export { breadcrumb, type BreadcrumbInput, type BreadcrumbItemInput } from './breadcrumb.js';
+export { faqPage, type FaqPageInput, type FaqQuestionInput } from './faq-page.js';
+export { howTo, type HowToInput, type HowToStepInput } from './how-to.js';
+export { organization, type ContactPointInput, type OrganizationInput, } from './organization.js';
+export { product, type ProductInput } from './product.js';
+export { softwareApplication, type SoftwareApplicationInput, } from './software-application.js';
+export { webSite, type WebSiteInput } from './website.js';
+export type { AggregateRatingInput, OfferAvailability, OffersInput } from './_offers.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B,OAAO,EACL,OAAO,EACP,WAAW,EACX,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,cAAc,GACpB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE7F,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAElF,OAAO,EAAE,KAAK,EAAE,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAE1E,OAAO,EACL,YAAY,EACZ,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACvB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAE1D,OAAO,EACL,mBAAmB,EACnB,KAAK,wBAAwB,GAC9B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAE1D,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * @answerable-kit/schemas — type-safe JSON-LD generators for the
+ * Answerable SEO toolkit. Each helper returns a `WithContext<T>`
+ * object from `schema-dts` (narrowed to remove the IRI-reference
+ * variant) that's ready to be embedded as
+ * `<script type="application/ld+json">{...}</script>`.
+ */
+export const VERSION = '0.0.0';
+export { article, blogPosting, } from './article.js';
+export { breadcrumb } from './breadcrumb.js';
+export { faqPage } from './faq-page.js';
+export { howTo } from './how-to.js';
+export { organization, } from './organization.js';
+export { product } from './product.js';
+export { softwareApplication, } from './software-application.js';
+export { webSite } from './website.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,OAAO,EACL,OAAO,EACP,WAAW,GAIZ,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,UAAU,EAAkD,MAAM,iBAAiB,CAAC;AAE7F,OAAO,EAAE,OAAO,EAA4C,MAAM,eAAe,CAAC;AAElF,OAAO,EAAE,KAAK,EAAwC,MAAM,aAAa,CAAC;AAE1E,OAAO,EACL,YAAY,GAGb,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,OAAO,EAAqB,MAAM,cAAc,CAAC;AAE1D,OAAO,EACL,mBAAmB,GAEpB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,OAAO,EAAqB,MAAM,cAAc,CAAC"}

package/dist/organization.d.ts

@@ -0,0 +1,32 @@
+import type { Organization } from 'schema-dts';
+import type { Schema } from './_internal.js';
+export interface ContactPointInput {
+    readonly email?: string | undefined;
+    readonly telephone?: string | undefined;
+    /** Defaults to `"customer support"` when omitted. */
+    readonly contactType?: string | undefined;
+}
+export interface OrganizationInput {
+    readonly name: string;
+    /** Canonical home page URL. Must be an absolute http(s) URL. */
+    readonly url: string;
+    /** Absolute URL to the org's logo image. */
+    readonly logo?: string | undefined;
+    readonly description?: string | undefined;
+    /**
+     * URLs of official profiles on other authoritative sites
+     * (Twitter, LinkedIn, GitHub, Wikipedia, ...). Each entry must be
+     * an absolute http(s) URL.
+     */
+    readonly sameAs?: readonly string[] | undefined;
+    readonly contactPoint?: ContactPointInput | undefined;
+}
+/**
+ * Generate a fully-typed JSON-LD `Organization` object ready to be
+ * embedded in a `<script type="application/ld+json">` tag.
+ *
+ * @throws InvalidUrlError if `url`, `logo`, or any `sameAs` entry is
+ *   not a valid http(s) URL.
+ */
+export declare function organization(input: OrganizationInput): Schema<Organization>;
+//# sourceMappingURL=organization.d.ts.map

package/dist/organization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"organization.d.ts","sourceRoot":"","sources":["../src/organization.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAgB,YAAY,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,qDAAqD;IACrD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,YAAY,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;CACvD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAAC,YAAY,CAAC,CAwB3E"}

package/dist/organization.js

@@ -0,0 +1,44 @@
+import { parseAbsoluteUrl } from '@answerable-kit/core';
+/**
+ * Generate a fully-typed JSON-LD `Organization` object ready to be
+ * embedded in a `<script type="application/ld+json">` tag.
+ *
+ * @throws InvalidUrlError if `url`, `logo`, or any `sameAs` entry is
+ *   not a valid http(s) URL.
+ */
+export function organization(input) {
+    const url = parseAbsoluteUrl(input.url);
+    const out = {
+        '@context': 'https://schema.org',
+        '@type': 'Organization',
+        name: input.name,
+        url,
+    };
+    if (input.logo !== undefined) {
+        out.logo = parseAbsoluteUrl(input.logo);
+    }
+    if (input.description !== undefined) {
+        out.description = input.description;
+    }
+    if (input.sameAs !== undefined && input.sameAs.length > 0) {
+        out.sameAs = input.sameAs.map((u) => parseAbsoluteUrl(u));
+    }
+    if (input.contactPoint !== undefined) {
+        out.contactPoint = buildContactPoint(input.contactPoint);
+    }
+    return out;
+}
+function buildContactPoint(input) {
+    const cp = {
+        '@type': 'ContactPoint',
+        contactType: input.contactType ?? 'customer support',
+    };
+    if (input.email !== undefined) {
+        cp.email = input.email;
+    }
+    if (input.telephone !== undefined) {
+        cp.telephone = input.telephone;
+    }
+    return cp;
+}
+//# sourceMappingURL=organization.js.map

package/dist/organization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"organization.js","sourceRoot":"","sources":["../src/organization.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AA2BxD;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,KAAwB;IACnD,MAAM,GAAG,GAAW,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAEhD,MAAM,GAAG,GAAyB;QAChC,UAAU,EAAE,oBAAoB;QAChC,OAAO,EAAE,cAAc;QACvB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,GAAG;KACJ,CAAC;IAEF,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC7B,GAAG,CAAC,IAAI,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACpC,GAAG,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IACtC,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1D,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5D,CAAC;IACD,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACrC,GAAG,CAAC,YAAY,GAAG,iBAAiB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAwB;IACjD,MAAM,EAAE,GAAiB;QACvB,OAAO,EAAE,cAAc;QACvB,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,kBAAkB;KACrD,CAAC;IACF,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC9B,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IACzB,CAAC;IACD,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QAClC,EAAE,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;IACjC,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/product.d.ts

@@ -0,0 +1,28 @@
+import type { Product } from 'schema-dts';
+import type { Schema } from './_internal.js';
+import { type AggregateRatingInput, type OffersInput } from './_offers.js';
+export interface ProductInput {
+    readonly name: string;
+    /** Canonical product page URL. */
+    readonly url: string;
+    readonly description?: string | undefined;
+    /** Absolute URL to the primary product image. */
+    readonly image?: string | undefined;
+    /** Brand name. Emitted as `{ "@type": "Brand", "name": ... }`. */
+    readonly brand?: string | undefined;
+    /** Stock-keeping unit / unique product identifier. */
+    readonly sku?: string | undefined;
+    readonly offers?: OffersInput | undefined;
+    readonly aggregateRating?: AggregateRatingInput | undefined;
+}
+/**
+ * Generate a fully-typed JSON-LD `Product` object. Drives audit
+ * check **C6**.
+ *
+ * @throws SchemaValidationError batching every issue across the
+ *   top-level fields, `offers`, and `aggregateRating`.
+ * @throws InvalidUrlError for the first malformed URL encountered
+ *   (`url`, `image`, `offers.url`).
+ */
+export declare function product(input: ProductInput): Schema<Product>;
+//# sourceMappingURL=product.d.ts.map

package/dist/product.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product.d.ts","sourceRoot":"","sources":["../src/product.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAS,OAAO,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAKjB,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,iDAAiD;IACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,kEAAkE;IAClE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,sDAAsD;IACtD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,eAAe,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAC;CAC7D;AAED;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,CA8C5D"}

package/dist/product.js

@@ -0,0 +1,56 @@
+import { SchemaValidationError, parseAbsoluteUrl } from '@answerable-kit/core';
+import { buildAggregateRating, buildOffer, validateAggregateRating, validateOffers, } from './_offers.js';
+/**
+ * Generate a fully-typed JSON-LD `Product` object. Drives audit
+ * check **C6**.
+ *
+ * @throws SchemaValidationError batching every issue across the
+ *   top-level fields, `offers`, and `aggregateRating`.
+ * @throws InvalidUrlError for the first malformed URL encountered
+ *   (`url`, `image`, `offers.url`).
+ */
+export function product(input) {
+    const issues = [];
+    if (input.name.trim() === '') {
+        issues.push('name is empty');
+    }
+    if (input.offers !== undefined) {
+        issues.push(...validateOffers(input.offers, 'offers'));
+    }
+    if (input.aggregateRating !== undefined) {
+        issues.push(...validateAggregateRating(input.aggregateRating, 'aggregateRating'));
+    }
+    if (issues.length > 0) {
+        throw new SchemaValidationError(issues);
+    }
+    const out = {
+        '@context': 'https://schema.org',
+        '@type': 'Product',
+        name: input.name,
+        url: parseAbsoluteUrl(input.url),
+    };
+    if (input.description !== undefined) {
+        out.description = input.description;
+    }
+    if (input.image !== undefined) {
+        out.image = parseAbsoluteUrl(input.image);
+    }
+    if (input.brand !== undefined) {
+        const brand = {
+            '@type': 'Brand',
+            name: input.brand,
+        };
+        out.brand = brand;
+    }
+    if (input.sku !== undefined) {
+        out.sku = input.sku;
+    }
+    if (input.offers !== undefined) {
+        out.offers = buildOffer(input.offers);
+    }
+    if (input.aggregateRating !== undefined) {
+        out.aggregateRating = buildAggregateRating(input.aggregateRating);
+    }
+    return out;
+}
+//# sourceMappingURL=product.js.map

package/dist/product.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"product.js","sourceRoot":"","sources":["../src/product.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG/E,OAAO,EAGL,oBAAoB,EACpB,UAAU,EACV,uBAAuB,EACvB,cAAc,GACf,MAAM,cAAc,CAAC;AAiBtB;;;;;;;;GAQG;AACH,MAAM,UAAU,OAAO,CAAC,KAAmB;IACzC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,KAAK,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,GAAG,uBAAuB,CAAC,KAAK,CAAC,eAAe,EAAE,iBAAiB,CAAC,CAAC,CAAC;IACpF,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,GAAG,GAAoB;QAC3B,UAAU,EAAE,oBAAoB;QAChC,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,GAAG,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC;KACjC,CAAC;IAEF,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACpC,GAAG,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IACtC,CAAC;IACD,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC9B,GAAG,CAAC,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC;IACD,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,KAAK,GAA2B;YACpC,OAAO,EAAE,OAAO;YAChB,IAAI,EAAE,KAAK,CAAC,KAAK;SAClB,CAAC;QACF,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC;IACpB,CAAC;IACD,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAC5B,GAAG,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;IACtB,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,GAAG,CAAC,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,KAAK,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QACxC,GAAG,CAAC,eAAe,GAAG,oBAAoB,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/software-application.d.ts

@@ -0,0 +1,41 @@
+import type { SoftwareApplication } from 'schema-dts';
+import type { Schema } from './_internal.js';
+import { type AggregateRatingInput, type OffersInput } from './_offers.js';
+export interface SoftwareApplicationInput {
+    readonly name: string;
+    /** Canonical app page URL. */
+    readonly url: string;
+    readonly description?: string | undefined;
+    /**
+     * App category per schema.org's `ApplicationCategory`. Common values:
+     * `"GameApplication"`, `"BusinessApplication"`, `"DesignApplication"`,
+     * `"DeveloperApplication"`, `"EducationalApplication"`,
+     * `"UtilitiesApplication"`.
+     */
+    readonly applicationCategory: string;
+    /**
+     * Operating system support. Free-form per schema.org but conventional
+     * values are `"Web"`, `"iOS"`, `"Android"`, `"Windows"`, `"macOS"`,
+     * `"Linux"` — or a comma-separated list.
+     */
+    readonly operatingSystem?: string | undefined;
+    /** Absolute URL to the app's hero / screenshot image. */
+    readonly image?: string | undefined;
+    /**
+     * For free apps, pass `{ price: 0, priceCurrency: "USD" }` (or any
+     * currency). Required by Google's structured-data guidelines to
+     * appear as a SoftwareApplication rich result.
+     */
+    readonly offers?: OffersInput | undefined;
+    readonly aggregateRating?: AggregateRatingInput | undefined;
+}
+/**
+ * Generate a fully-typed JSON-LD `SoftwareApplication` object. Drives
+ * audit check **C2** for software products.
+ *
+ * @throws SchemaValidationError batching every issue across the
+ *   top-level fields, `offers`, and `aggregateRating`.
+ * @throws InvalidUrlError for the first malformed URL encountered.
+ */
+export declare function softwareApplication(input: SoftwareApplicationInput): Schema<SoftwareApplication>;
+//# sourceMappingURL=software-application.d.ts.map

package/dist/software-application.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"software-application.d.ts","sourceRoot":"","sources":["../src/software-application.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAKjB,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8BAA8B;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C;;;;;OAKG;IACH,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9C,yDAAyD;IACzD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,eAAe,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAC;CAC7D;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,GAAG,MAAM,CAAC,mBAAmB,CAAC,CA2ChG"}

package/dist/software-application.js

@@ -0,0 +1,52 @@
+import { SchemaValidationError, parseAbsoluteUrl } from '@answerable-kit/core';
+import { buildAggregateRating, buildOffer, validateAggregateRating, validateOffers, } from './_offers.js';
+/**
+ * Generate a fully-typed JSON-LD `SoftwareApplication` object. Drives
+ * audit check **C2** for software products.
+ *
+ * @throws SchemaValidationError batching every issue across the
+ *   top-level fields, `offers`, and `aggregateRating`.
+ * @throws InvalidUrlError for the first malformed URL encountered.
+ */
+export function softwareApplication(input) {
+    const issues = [];
+    if (input.name.trim() === '') {
+        issues.push('name is empty');
+    }
+    if (input.applicationCategory.trim() === '') {
+        issues.push('applicationCategory is empty');
+    }
+    if (input.offers !== undefined) {
+        issues.push(...validateOffers(input.offers, 'offers'));
+    }
+    if (input.aggregateRating !== undefined) {
+        issues.push(...validateAggregateRating(input.aggregateRating, 'aggregateRating'));
+    }
+    if (issues.length > 0) {
+        throw new SchemaValidationError(issues);
+    }
+    const out = {
+        '@context': 'https://schema.org',
+        '@type': 'SoftwareApplication',
+        name: input.name,
+        url: parseAbsoluteUrl(input.url),
+        applicationCategory: input.applicationCategory,
+    };
+    if (input.description !== undefined) {
+        out.description = input.description;
+    }
+    if (input.operatingSystem !== undefined) {
+        out.operatingSystem = input.operatingSystem;
+    }
+    if (input.image !== undefined) {
+        out.image = parseAbsoluteUrl(input.image);
+    }
+    if (input.offers !== undefined) {
+        out.offers = buildOffer(input.offers);
+    }
+    if (input.aggregateRating !== undefined) {
+        out.aggregateRating = buildAggregateRating(input.aggregateRating);
+    }
+    return out;
+}
+//# sourceMappingURL=software-application.js.map

package/dist/software-application.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"software-application.js","sourceRoot":"","sources":["../src/software-application.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG/E,OAAO,EAGL,oBAAoB,EACpB,UAAU,EACV,uBAAuB,EACvB,cAAc,GACf,MAAM,cAAc,CAAC;AA+BtB;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAA+B;IACjE,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,KAAK,CAAC,mBAAmB,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,KAAK,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,GAAG,uBAAuB,CAAC,KAAK,CAAC,eAAe,EAAE,iBAAiB,CAAC,CAAC,CAAC;IACpF,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,GAAG,GAAgC;QACvC,UAAU,EAAE,oBAAoB;QAChC,OAAO,EAAE,qBAAqB;QAC9B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,GAAG,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC;QAChC,mBAAmB,EAAE,KAAK,CAAC,mBAAmB;KAC/C,CAAC;IAEF,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACpC,GAAG,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IACtC,CAAC;IACD,IAAI,KAAK,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QACxC,GAAG,CAAC,eAAe,GAAG,KAAK,CAAC,eAAe,CAAC;IAC9C,CAAC;IACD,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC9B,GAAG,CAAC,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,GAAG,CAAC,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,KAAK,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QACxC,GAAG,CAAC,eAAe,GAAG,oBAAoB,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/website.d.ts

@@ -0,0 +1,29 @@
+import type { WebSite } from 'schema-dts';
+import type { Schema } from './_internal.js';
+export interface WebSiteInput {
+    readonly name: string;
+    /** Canonical site URL. Must be an absolute http(s) URL. */
+    readonly url: string;
+    readonly description?: string | undefined;
+    /**
+     * URL template for the sitelinks search box. Must contain
+     * `{search_term_string}` as the query placeholder.
+     *
+     * @example
+     * 'https://example.com/search?q={search_term_string}'
+     */
+    readonly searchUrlTemplate?: string | undefined;
+}
+/**
+ * Generate a fully-typed JSON-LD `WebSite` object.
+ *
+ * When `searchUrlTemplate` is supplied, a `potentialAction` of type
+ * `SearchAction` is emitted so search engines can render a sitelinks
+ * search box in results.
+ *
+ * @throws InvalidUrlError if `url` is not a valid http(s) URL.
+ * @throws SchemaValidationError if `searchUrlTemplate` is missing the
+ *   `{search_term_string}` placeholder.
+ */
+export declare function webSite(input: WebSiteInput): Schema<WebSite>;
+//# sourceMappingURL=website.d.ts.map

package/dist/website.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"website.d.ts","sourceRoot":"","sources":["../src/website.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C;;;;;;OAMG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,CAoC5D"}

package/dist/website.js

@@ -0,0 +1,46 @@
+import { SchemaValidationError, parseAbsoluteUrl } from '@answerable-kit/core';
+/**
+ * Generate a fully-typed JSON-LD `WebSite` object.
+ *
+ * When `searchUrlTemplate` is supplied, a `potentialAction` of type
+ * `SearchAction` is emitted so search engines can render a sitelinks
+ * search box in results.
+ *
+ * @throws InvalidUrlError if `url` is not a valid http(s) URL.
+ * @throws SchemaValidationError if `searchUrlTemplate` is missing the
+ *   `{search_term_string}` placeholder.
+ */
+export function webSite(input) {
+    const url = parseAbsoluteUrl(input.url);
+    const out = {
+        '@context': 'https://schema.org',
+        '@type': 'WebSite',
+        name: input.name,
+        url,
+    };
+    if (input.description !== undefined) {
+        out.description = input.description;
+    }
+    if (input.searchUrlTemplate !== undefined) {
+        if (!input.searchUrlTemplate.includes('{search_term_string}')) {
+            throw new SchemaValidationError([
+                'searchUrlTemplate must contain the {search_term_string} placeholder',
+            ]);
+        }
+        // schema-dts removed the `query-input` field after Google deprecated the
+        // sitelinks search box in 2024. The field is still valid schema.org JSON-LD
+        // and consumed by other search engines and AI answer engines, so we keep
+        // emitting it. The `as unknown as` bypass is intentional and isolated.
+        const action = {
+            '@type': 'SearchAction',
+            target: {
+                '@type': 'EntryPoint',
+                urlTemplate: input.searchUrlTemplate,
+            },
+            'query-input': 'required name=search_term_string',
+        };
+        out.potentialAction = action;
+    }
+    return out;
+}
+//# sourceMappingURL=website.js.map

package/dist/website.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"website.js","sourceRoot":"","sources":["../src/website.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAmB/E;;;;;;;;;;GAUG;AACH,MAAM,UAAU,OAAO,CAAC,KAAmB;IACzC,MAAM,GAAG,GAAW,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAEhD,MAAM,GAAG,GAAoB;QAC3B,UAAU,EAAE,oBAAoB;QAChC,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,GAAG;KACJ,CAAC;IAEF,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACpC,GAAG,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IACtC,CAAC;IAED,IAAI,KAAK,CAAC,iBAAiB,KAAK,SAAS,EAAE,CAAC;QAC1C,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,CAAC;YAC9D,MAAM,IAAI,qBAAqB,CAAC;gBAC9B,qEAAqE;aACtE,CAAC,CAAC;QACL,CAAC;QACD,yEAAyE;QACzE,4EAA4E;QAC5E,yEAAyE;QACzE,uEAAuE;QACvE,MAAM,MAAM,GAAG;YACb,OAAO,EAAE,cAAc;YACvB,MAAM,EAAE;gBACN,OAAO,EAAE,YAAY;gBACrB,WAAW,EAAE,KAAK,CAAC,iBAAiB;aACrC;YACD,aAAa,EAAE,kCAAkC;SACzC,CAAC;QACX,GAAG,CAAC,eAAe,GAAG,MAAoE,CAAC;IAC7F,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@answerable-kit/schemas",
+  "version": "0.1.0",
+  "description": "Type-safe JSON-LD generators for the Answerable SEO toolkit (Organization, FAQPage, Article, ...).",
+  "license": "MIT",
+  "author": "Anuj Ojha",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Anuj7411/answerable.git",
+    "directory": "packages/schemas"
+  },
+  "homepage": "https://github.com/Anuj7411/answerable/tree/main/packages/schemas#readme",
+  "bugs": "https://github.com/Anuj7411/answerable/issues",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": ["dist", "README.md"],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "clean": "rimraf dist .tsbuildinfo"
+  },
+  "dependencies": {
+    "@answerable-kit/core": "workspace:*",
+    "schema-dts": "^1.1.5"
+  },
+  "devDependencies": {
+    "rimraf": "^6.0.1",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.5"
+  }
+}