@adkinn/astro-ai-readiness 0.0.7

package/dist/chunk-THSVWYUX.js

@@ -0,0 +1,42 @@
+import {
+  writeOutput
+} from "./chunk-V22PCH7G.js";
+
+// src/outputs/llms-full.ts
+function composeLlmsFullTxt(config) {
+  const { llmsFull, llmsTxt, organization } = config;
+  const lines = [];
+  lines.push(`# ${llmsFull.title ?? organization.name}`);
+  lines.push("");
+  const summary = llmsFull.summary ?? llmsTxt?.summary;
+  if (summary) {
+    lines.push(`> ${summary}`);
+    lines.push("");
+  }
+  if (llmsFull.content) {
+    lines.push(llmsFull.content.trimEnd());
+    lines.push("");
+  }
+  if (llmsFull.sections) {
+    for (const section of llmsFull.sections) {
+      lines.push(`## ${section.title}`);
+      lines.push("");
+      lines.push(section.content.trimEnd());
+      lines.push("");
+    }
+  }
+  return lines.join("\n").replace(/\n+$/, "\n");
+}
+async function writeLlmsFullTxt(config, dir, logger) {
+  if (!config.llmsFull) return;
+  const content = composeLlmsFullTxt(
+    config
+  );
+  const target = new URL("llms-full.txt", dir);
+  await writeOutput(target, content, "llms-full.txt", logger);
+}
+
+export {
+  composeLlmsFullTxt,
+  writeLlmsFullTxt
+};

package/dist/chunk-V22PCH7G.js

@@ -0,0 +1,26 @@
+// src/outputs/write-output.ts
+import { mkdir, writeFile } from "fs/promises";
+async function writeOutput(target, content, label, logger, ensureDir) {
+  if (ensureDir) {
+    await mkdir(ensureDir, { recursive: true });
+  }
+  try {
+    await writeFile(target, content, { encoding: "utf-8", flag: "wx" });
+    logger.info(`wrote ${label} (${content.length} bytes)`);
+  } catch (err) {
+    const code = err?.code;
+    if (code === "EEXIST") {
+      logger.warn(
+        `${label} already exists \u2014 leaving your file untouched. Delete it if you want @adkinn/astro-ai-readiness to generate ${label}.`
+      );
+      return;
+    }
+    const msg = err instanceof Error ? err.message : String(err);
+    logger.warn(`failed to write ${label} at ${target.pathname}: ${msg}`);
+    throw err;
+  }
+}
+
+export {
+  writeOutput
+};

package/dist/chunk-WP6D4L7O.js

@@ -0,0 +1,48 @@
+import {
+  writeOutput
+} from "./chunk-V22PCH7G.js";
+
+// src/outputs/llms-txt.ts
+function composeLlmsTxt(config) {
+  const { llmsTxt, organization } = config;
+  const lines = [];
+  lines.push(`# ${organization.name}`);
+  lines.push("");
+  lines.push(`> ${llmsTxt.summary}`);
+  lines.push("");
+  if (llmsTxt.body) {
+    lines.push(llmsTxt.body.trimEnd());
+    lines.push("");
+  }
+  if (llmsTxt.sections && llmsTxt.sections.length > 0) {
+    for (const section of llmsTxt.sections) {
+      lines.push(`## ${section.title}`);
+      lines.push("");
+      for (const link of section.links) {
+        const desc = link.description ? `: ${link.description}` : "";
+        lines.push(`- [${link.title}](${link.url})${desc}`);
+      }
+      lines.push("");
+    }
+  }
+  if (llmsTxt.deferTo) {
+    lines.push("---");
+    lines.push("");
+    lines.push(`Canonical reference: [${llmsTxt.deferTo.title}](${llmsTxt.deferTo.url})`);
+    lines.push("");
+  }
+  return lines.join("\n").replace(/\n+$/, "\n");
+}
+async function writeLlmsTxt(config, dir, logger) {
+  if (!config.llmsTxt) return;
+  const content = composeLlmsTxt(
+    config
+  );
+  const target = new URL("llms.txt", dir);
+  await writeOutput(target, content, "llms.txt", logger);
+}
+
+export {
+  composeLlmsTxt,
+  writeLlmsTxt
+};

package/dist/components/BreadcrumbSchema.astro

@@ -0,0 +1,22 @@
+---
+import { jsonLd } from '../utils/json-ld'
+import type { BreadcrumbItem } from './types'
+
+interface Props {
+  items: BreadcrumbItem[]
+}
+
+const { items } = Astro.props
+
+const bl = {
+  '@context': 'https://schema.org',
+  '@type': 'BreadcrumbList',
+  itemListElement: items.map((item, index) => ({
+    '@type': 'ListItem',
+    position: index + 1,
+    name: item.name,
+    item: item.url,
+  })),
+}
+---
+{items.length > 0 && <script is:inline type="application/ld+json" set:html={jsonLd(bl)}></script>}

package/dist/components/CollectionSchema.astro

@@ -0,0 +1,24 @@
+---
+import { config } from 'virtual:ai-readiness-config'
+import { jsonLd } from '../utils/json-ld'
+
+interface Props {
+  name: string
+  url: string
+  description?: string
+}
+
+const { name, url, description } = Astro.props
+
+const cp: Record<string, unknown> = {
+  '@context': 'https://schema.org',
+  '@type': 'CollectionPage',
+  name,
+  url,
+  isPartOf: { '@id': `${config.site}#website` },
+  publisher: { '@id': `${config.site}#organization` },
+}
+
+if (description) cp.description = description
+---
+<script type="application/ld+json" is:inline set:html={jsonLd(cp)}></script>

package/dist/components/FAQPageSchema.astro

@@ -0,0 +1,24 @@
+---
+import { jsonLd } from '../utils/json-ld'
+import type { FAQItem } from './types'
+
+interface Props {
+  items: FAQItem[]
+}
+
+const { items } = Astro.props
+
+const fp = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: items.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: {
+      '@type': 'Answer',
+      text: item.answer,
+    },
+  })),
+}
+---
+{items.length > 0 && <script is:inline type="application/ld+json" set:html={jsonLd(fp)}></script>}

package/dist/components/OrganizationSchema.astro

@@ -0,0 +1,33 @@
+---
+import { config } from 'virtual:ai-readiness-config'
+import { jsonLd } from '../utils/json-ld'
+
+const org = config.organization
+
+type SchemaJson = Record<string, unknown>
+
+const orgLd: SchemaJson = {
+  '@context': 'https://schema.org',
+  '@type': 'Organization',
+  '@id': `${config.site}#organization`,
+  name: org.name,
+}
+
+if (org.url) orgLd.url = org.url
+if (org.logo) orgLd.logo = org.logo
+if (org.foundingDate) orgLd.foundingDate = org.foundingDate
+if (org.knowsAbout && org.knowsAbout.length > 0) orgLd.knowsAbout = org.knowsAbout
+if (org.areaServed) orgLd.areaServed = org.areaServed
+
+if (org.founder) {
+  const founder: SchemaJson = {
+    '@type': 'Person',
+    name: org.founder.name,
+  }
+  if (org.founder.jobTitle) founder.jobTitle = org.founder.jobTitle
+  if (org.founder.description) founder.description = org.founder.description
+  if (org.founder.sameAs && org.founder.sameAs.length > 0) founder.sameAs = org.founder.sameAs
+  orgLd.founder = founder
+}
+---
+<script type="application/ld+json" is:inline set:html={jsonLd(orgLd)}></script>

package/dist/components/TechArticleSchema.astro

@@ -0,0 +1,88 @@
+---
+import { config } from 'virtual:ai-readiness-config'
+import { jsonLd } from '../utils/json-ld'
+import type { TechArticleAuthor, TechArticleImage } from './types'
+
+interface Props {
+  // Required
+  headline: string
+  description: string
+  datePublished: string
+
+  // Optional — common
+  dateModified?: string
+  author?: TechArticleAuthor
+  image?: TechArticleImage
+  url?: string
+
+  // Optional — Schema.org TechArticle extensions
+  articleSection?: string
+  keywords?: string[]
+  proficiencyLevel?: string
+  dependencies?: string[]
+}
+
+const {
+  headline,
+  description,
+  datePublished,
+  dateModified,
+  author,
+  image,
+  url,
+  articleSection,
+  keywords,
+  proficiencyLevel,
+  dependencies,
+} = Astro.props
+
+// D-21: author defaults to a Person synthesized from config.organization.founder.
+// Founder-precondition guard: if author is omitted AND founder is unset, fail loudly
+// at build time rather than tighten the global schema (which would break consumers
+// who don't use TechArticle and don't set founder).
+const founder = config.organization.founder
+let resolvedAuthor: TechArticleAuthor
+if (author) {
+  resolvedAuthor = author
+} else {
+  if (!founder) {
+    throw new Error(
+      'TechArticleSchema: `author` prop omitted and `config.organization.founder` ' +
+      'is unset. Either pass an explicit `author` prop, or add a `founder` block to ' +
+      'the `organization` config in your `aiReadiness({...})` integration call.'
+    )
+  }
+  resolvedAuthor = {
+    name: founder.name,
+    ...(founder.sameAs && founder.sameAs[0] && { url: founder.sameAs[0] }),
+  }
+}
+
+const resolvedImage =
+  typeof image === 'string'
+    ? { '@type': 'ImageObject', url: image }
+    : image
+      ? { '@type': 'ImageObject', ...image }
+      : undefined
+
+const resolvedUrl = url ?? new URL(Astro.url.pathname, config.site).toString()
+
+const ta: Record<string, unknown> = {
+  '@context': 'https://schema.org',
+  '@type': 'TechArticle',
+  headline,
+  description,
+  datePublished,
+  dateModified: dateModified ?? datePublished,
+  author: { '@type': 'Person', ...resolvedAuthor },
+  publisher: { '@id': `${config.site}#organization` },
+  url: resolvedUrl,
+}
+
+if (resolvedImage) ta.image = resolvedImage
+if (articleSection) ta.articleSection = articleSection
+if (keywords && keywords.length > 0) ta.keywords = keywords.join(', ')
+if (proficiencyLevel) ta.proficiencyLevel = proficiencyLevel
+if (dependencies && dependencies.length > 0) ta.dependencies = dependencies.join(', ')
+---
+<script is:inline type="application/ld+json" set:html={jsonLd(ta)}></script>

package/dist/components/WebSiteSchema.astro

@@ -0,0 +1,16 @@
+---
+import { config } from 'virtual:ai-readiness-config'
+import { jsonLd } from '../utils/json-ld'
+
+const ws: Record<string, unknown> = {
+  '@context': 'https://schema.org',
+  '@type': 'WebSite',
+  '@id': `${config.site}#website`,
+  name: config.webSite?.name ?? config.organization.name,
+  url: config.site,
+  publisher: { '@id': `${config.site}#organization` },
+}
+
+if (config.webSite?.description) ws.description = config.webSite.description
+---
+<script type="application/ld+json" is:inline set:html={jsonLd(ws)}></script>

package/dist/components/index.d.ts

@@ -0,0 +1,7 @@
+export { default as OrganizationSchema } from './OrganizationSchema.astro';
+export { default as WebSiteSchema } from './WebSiteSchema.astro';
+export { default as CollectionSchema } from './CollectionSchema.astro';
+export { default as BreadcrumbSchema } from './BreadcrumbSchema.astro';
+export { default as FAQPageSchema } from './FAQPageSchema.astro';
+export { default as TechArticleSchema } from './TechArticleSchema.astro';
+export { BreadcrumbItem, FAQItem, TechArticleAuthor, TechArticleImage } from './types.js';

package/dist/components/index.js

@@ -0,0 +1,15 @@
+// src/components/index.ts
+import { default as default2 } from "./OrganizationSchema.astro";
+import { default as default3 } from "./WebSiteSchema.astro";
+import { default as default4 } from "./CollectionSchema.astro";
+import { default as default5 } from "./BreadcrumbSchema.astro";
+import { default as default6 } from "./FAQPageSchema.astro";
+import { default as default7 } from "./TechArticleSchema.astro";
+export {
+  default5 as BreadcrumbSchema,
+  default4 as CollectionSchema,
+  default6 as FAQPageSchema,
+  default2 as OrganizationSchema,
+  default7 as TechArticleSchema,
+  default3 as WebSiteSchema
+};

package/dist/components/types.d.ts

@@ -0,0 +1,55 @@
+import './OrganizationSchema.astro';
+import './WebSiteSchema.astro';
+import './CollectionSchema.astro';
+import './BreadcrumbSchema.astro';
+import './FAQPageSchema.astro';
+import './TechArticleSchema.astro';
+
+/**
+ * Shared prop-shape types for components that need declarable interfaces
+ * (items-array element shapes, heavy-props nested-object shapes).
+ *
+ * @internal
+ *   Consumers should import from the barrel:
+ *   `import type { BreadcrumbItem, FAQItem, TechArticleAuthor, TechArticleImage } from '@adkinn/astro-ai-readiness/components'`
+ *   The `/components/types` subpath is intentionally not exposed in
+ *   `package.json.exports` — deep-importing
+ *   `@adkinn/astro-ai-readiness/components/types` will fail with
+ *   `ERR_PACKAGE_PATH_NOT_EXPORTED`. The file ships as a build artifact
+ *   so internal relative imports (`./types`) work; the barrel is the
+ *   public surface. Same pattern as `src/utils/json-ld.ts`.
+ *
+ * `.astro` files are externalized in `tsup.config.ts`, so their declaration
+ * types don't ship via tsup's `dts: true`. Interface types must live in a
+ * `.ts` file. This module is the single home for prop shapes — items-array
+ * elements (`BreadcrumbItem`, `FAQItem`) and heavy-props nested objects
+ * (`TechArticleAuthor`, `TechArticleImage`) — that both the component
+ * frontmatter and the package barrel re-export.
+ *
+ * Components import via relative path (`./types`); the barrel re-exports
+ * for consumer-side use.
+ */
+interface BreadcrumbItem {
+    name: string;
+    url: string;
+}
+interface FAQItem {
+    question: string;
+    answer: string;
+}
+interface TechArticleAuthor {
+    name: string;
+    url?: string;
+}
+/**
+ * URL string is the common case; object form supports width/height/caption
+ * when the consumer wants the richer Schema.org ImageObject shape.
+ */
+type TechArticleImage = string | {
+    url: string;
+    width?: number;
+    height?: number;
+    caption?: string;
+};
+
+export type { BreadcrumbItem, FAQItem, TechArticleAuthor, TechArticleImage };