@treeseed/core 0.1.2

package/dist/vendor/starlight/schemas/pagefind.js

@@ -0,0 +1,108 @@
+import { z } from "astro/zod";
+const indexWeightSchema = z.number().nonnegative().optional();
+const pagefindRankingWeightsSchema = z.object({
+  /**
+   * Set Pagefind’s `pageLength` ranking option.
+   *
+   * The default value is `0.1` and values must be in the range `0` to `1`.
+   *
+   * @see https://pagefind.app/docs/ranking/#configuring-page-length
+   */
+  pageLength: z.number().min(0).max(1).default(0.1),
+  /**
+   * Set Pagefind’s `termFrequency` ranking option.
+   *
+   * The default value is `0.1` and values must be in the range `0` to `1`.
+   *
+   * @see https://pagefind.app/docs/ranking/#configuring-term-frequency
+   */
+  termFrequency: z.number().min(0).max(1).default(0.1),
+  /**
+   * Set Pagefind’s `termSaturation` ranking option.
+   *
+   * The default value is `2` and values must be in the range `0` to `2`.
+   *
+   * @see https://pagefind.app/docs/ranking/#configuring-term-saturation
+   */
+  termSaturation: z.number().min(0).max(2).default(2),
+  /**
+   * Set Pagefind’s `termSimilarity` ranking option.
+   *
+   * The default value is `9` and values must be greater than or equal to `0`.
+   *
+   * @see https://pagefind.app/docs/ranking/#configuring-term-similarity
+   */
+  termSimilarity: z.number().min(0).default(9)
+});
+const pagefindIndexOptionsSchema = z.object({
+  /**
+   * Overrides the URL path that Pagefind uses to load its search bundle
+   */
+  basePath: z.string().optional(),
+  /**
+   * Appends the given baseURL to all search results. May be a path, or a full domain
+   */
+  baseUrl: z.string().optional(),
+  /**
+   * Multiply all rankings for this index by the given weight.
+   *
+   * @see https://pagefind.app/docs/multisite/#changing-the-weighting-of-individual-indexes
+   */
+  indexWeight: indexWeightSchema,
+  /**
+   * Apply this filter configuration to all search results from this index.
+   *
+   * Only applies in multisite setups.
+   *
+   * @see https://pagefind.app/docs/multisite/#filtering-results-by-index
+   */
+  mergeFilter: z.record(z.string(), z.string().or(z.array(z.string()).nonempty())).optional(),
+  /**
+   * Language of this index.
+   *
+   * @see https://pagefind.app/docs/multisite/#merging-a-specific-language-index
+   */
+  language: z.string().optional(),
+  /**
+   * Configure how search result rankings are calculated by Pagefind.
+   */
+  // We apply a default value to merged indexes in order to share the same ranking for them and the current site when not set explicitly.
+  ranking: pagefindRankingWeightsSchema.default({})
+});
+const pagefindSchema = z.object({
+  /**
+   * Configure how search results from the current website are weighted by Pagefind
+   * compared to results from other sites when using the `mergeIndex` option.
+   *
+   * @see https://pagefind.app/docs/multisite/#changing-the-weighting-of-individual-indexes
+   */
+  indexWeight: indexWeightSchema,
+  /** Configure how search result rankings are calculated by Pagefind. */
+  ranking: pagefindRankingWeightsSchema.default({}),
+  /**
+   * Configure how search indexes from different sites are merged by Pagefind.
+   *
+   * @see https://pagefind.app/docs/multisite/#searching-additional-sites-from-pagefind-ui
+   */
+  mergeIndex: z.array(
+    /**
+     * Each entry of this array represents a `PagefindIndexOptions` from pagefind.
+     *
+     * @see https://github.com/CloudCannon/pagefind/blob/v1.3.0/pagefind_web_js/lib/coupled_search.ts#L549
+     */
+    pagefindIndexOptionsSchema.extend({
+      /**
+       * Set Pagefind’s `bundlePath` mergeIndex option.
+       *
+       * @see https://pagefind.app/docs/multisite/#searching-additional-sites-from-pagefind-ui
+       */
+      bundlePath: z.string()
+    })
+  ).optional()
+});
+const PagefindConfigSchema = () => pagefindSchema;
+const PagefindConfigDefaults = () => pagefindSchema.parse({});
+export {
+  PagefindConfigDefaults,
+  PagefindConfigSchema
+};

package/dist/vendor/starlight/schemas/prevNextLink.js

@@ -0,0 +1,14 @@
+import { z } from "astro/zod";
+const PrevNextLinkConfigSchema = () => z.union([
+  z.boolean(),
+  z.string(),
+  z.object({
+    /** The navigation link URL. */
+    link: z.string().optional(),
+    /** The navigation link text. */
+    label: z.string().optional()
+  }).strict()
+]).optional();
+export {
+  PrevNextLinkConfigSchema
+};

package/dist/vendor/starlight/schemas/sidebar.js

@@ -0,0 +1,80 @@
+import { z } from "astro/zod";
+import { I18nBadgeConfigSchema } from "./badge.js";
+import { stripLeadingAndTrailingSlashes } from "../utils/path.js";
+const SidebarBaseSchema = z.object({
+  /** The visible label for this item in the sidebar. */
+  label: z.string(),
+  /** Translations of the `label` for each supported language. */
+  translations: z.record(z.string()).default({}),
+  /** Adds a badge to the item */
+  badge: I18nBadgeConfigSchema()
+});
+const SidebarGroupSchema = SidebarBaseSchema.extend({
+  /**
+   * Explicitly prevent custom attributes on groups as the final type for supported sidebar item
+   * is a non-discriminated union where TypeScript will not perform excess property checks.
+   * This means that a user could define a sidebar group with custom attributes, not getting a
+   * TypeScript error, and only have it fail at runtime.
+   * @see https://github.com/microsoft/TypeScript/issues/20863
+   */
+  attrs: z.never().optional(),
+  /** Whether this item should be collapsed by default. */
+  collapsed: z.boolean().default(false)
+});
+const linkHTMLAttributesSchema = z.record(
+  z.union([z.string(), z.number(), z.boolean(), z.undefined(), z.null()])
+);
+const SidebarLinkItemHTMLAttributesSchema = () => linkHTMLAttributesSchema.default({});
+const SidebarLinkItemSchema = SidebarBaseSchema.extend({
+  /** The link to this item’s content. Can be a relative link to local files or the full URL of an external page. */
+  link: z.string(),
+  /** HTML attributes to add to the link item. */
+  attrs: SidebarLinkItemHTMLAttributesSchema()
+}).strict();
+const AutoSidebarGroupSchema = SidebarGroupSchema.extend({
+  /** Enable autogenerating a sidebar category from a specific docs directory. */
+  autogenerate: z.object({
+    /** The directory to generate sidebar items for. */
+    directory: z.string().transform(stripLeadingAndTrailingSlashes),
+    /**
+     * Whether the autogenerated subgroups should be collapsed by default.
+     * Defaults to the `AutoSidebarGroup` `collapsed` value.
+     */
+    collapsed: z.boolean().optional(),
+    /** HTML attributes to add to the autogenerated link items. */
+    attrs: SidebarLinkItemHTMLAttributesSchema()
+    // TODO: not supported by Docusaurus but would be good to have
+    /** How many directories deep to include from this directory in the sidebar. Default: `Infinity`. */
+    // depth: z.number().optional(),
+  })
+}).strict();
+const ManualSidebarGroupSchema = SidebarGroupSchema.extend({
+  /** Array of links and subcategories to display in this category. */
+  items: z.lazy(
+    () => z.union([
+      SidebarLinkItemSchema,
+      ManualSidebarGroupSchema,
+      AutoSidebarGroupSchema,
+      InternalSidebarLinkItemSchema,
+      InternalSidebarLinkItemShorthandSchema
+    ]).array()
+  )
+}).strict();
+const InternalSidebarLinkItemSchema = SidebarBaseSchema.partial({ label: true }).extend({
+  /** The link to this item’s content. Must be a slug of a Content Collection entry. */
+  slug: z.string(),
+  /** HTML attributes to add to the link item. */
+  attrs: SidebarLinkItemHTMLAttributesSchema()
+});
+const InternalSidebarLinkItemShorthandSchema = z.string().transform((slug) => InternalSidebarLinkItemSchema.parse({ slug }));
+const SidebarItemSchema = z.union([
+  SidebarLinkItemSchema,
+  ManualSidebarGroupSchema,
+  AutoSidebarGroupSchema,
+  InternalSidebarLinkItemSchema,
+  InternalSidebarLinkItemShorthandSchema
+]);
+export {
+  SidebarItemSchema,
+  SidebarLinkItemHTMLAttributesSchema
+};

package/dist/vendor/starlight/schemas/site-title.js

@@ -0,0 +1,19 @@
+import { z } from "astro/zod";
+const TitleConfigSchema = () => z.union([z.string(), z.record(z.string())]).describe("Title for your website. Will be used in metadata and as browser tab title.");
+const TitleTransformConfigSchema = (defaultLang) => TitleConfigSchema().transform((title, ctx) => {
+  if (typeof title === "string") {
+    return { [defaultLang]: title };
+  }
+  if (!title[defaultLang] && title[defaultLang] !== "") {
+    ctx.addIssue({
+      code: z.ZodIssueCode.custom,
+      message: `Title must have a key for the default language "${defaultLang}"`
+    });
+    return z.NEVER;
+  }
+  return title;
+});
+export {
+  TitleConfigSchema,
+  TitleTransformConfigSchema
+};

package/dist/vendor/starlight/schemas/social.js

@@ -0,0 +1,19 @@
+import { z } from "astro/zod";
+import { IconSchema } from "./icon.js";
+const LinksSchema = z.object({ icon: IconSchema(), label: z.string().min(1), href: z.string() }).array().optional();
+const SocialLinksSchema = () => (
+  // Add a more specific error message to help people migrate from the old object syntax.
+  // TODO: remove once most people have updated to v0.33 or higher (e.g. when releasing Starlight v1)
+  z.preprocess((value, ctx) => {
+    if (value && typeof value === "object" && !Array.isArray(value)) {
+      ctx.addIssue({
+        code: z.ZodIssueCode.custom,
+        message: "Starlight v0.33.0 changed the `social` configuration syntax. Please specify an array of link items instead of an object.\nSee the Starlight changelog for details: https://github.com/withastro/starlight/blob/main/packages/starlight/CHANGELOG.md#0330\n"
+      });
+    }
+    return value;
+  }, LinksSchema)
+);
+export {
+  SocialLinksSchema
+};

package/dist/vendor/starlight/schemas/tableOfContents.js

@@ -0,0 +1,16 @@
+import { z } from "astro/zod";
+const defaults = { minHeadingLevel: 2, maxHeadingLevel: 3 };
+const TableOfContentsSchema = () => z.union([
+  z.object({
+    /** The level to start including headings at in the table of contents. Default: 2. */
+    minHeadingLevel: z.number().int().min(1).max(6).optional().default(2),
+    /** The level to stop including headings at in the table of contents. Default: 3. */
+    maxHeadingLevel: z.number().int().min(1).max(6).optional().default(3)
+  }),
+  z.boolean().transform((enabled) => enabled ? defaults : false)
+]).default(defaults).refine((toc) => toc ? toc.minHeadingLevel <= toc.maxHeadingLevel : true, {
+  message: "minHeadingLevel must be less than or equal to maxHeadingLevel"
+});
+export {
+  TableOfContentsSchema
+};

package/dist/vendor/starlight/style/anchor-links.css

@@ -0,0 +1,131 @@
+/* 
+How does anchor link placement work?
+
+Because anchor links need to placed inline at the end of a heading, but are not children of the
+heading element itself, positioning them to behave in a desirable way is a tiny bit tricky. Here’s
+how we do it.
+
+1. We wrap the heading and anchor link in a div and make the heading element inline:
+   <div class="sl-heading-wrapper">
+     <h2>...</h2><a class="sl-anchor-link">...</a>
+   </a>
+
+2. We need to avoid the anchor link wrapping onto a new line by itself like this because it looks
+   broken:
+
+   Some heading text
+   ⛓
+
+3. To achieve this we add an area of padding to the end of the heading and move the link over this
+   padding using negative margin:
+
+                        padding-inline-end creates space at the end of the line
+                         ↓
+      Some heading text[   ]⛓
+
+                        margin-inline-start then pulls the anchor link into that space
+                         ↓
+      Some heading text[ ⛓ ]
+
+   This ensures that when the anchor link wraps, the final word in the heading will wrap with it.
+
+*/
+@layer starlight.content {
+	/* ======================================================
+   WRAPPER
+   ====================================================== */
+	.sl-markdown-content .sl-heading-wrapper {
+		/* The size of the SVG icon. */
+		--sl-anchor-icon-size: 0.8275em;
+		/* The horizontal space between the SVG icon and the end of the heading text. */
+		--sl-anchor-icon-gap: 0.25em;
+		/* The end of line space required to accommodate the anchor link. */
+		--sl-anchor-icon-space: calc(var(--sl-anchor-icon-size) + var(--sl-anchor-icon-gap));
+
+		line-height: var(--sl-line-height-headings);
+	}
+
+	/* We need to apply the same rule we use for heading spacing to the parent wrapper. */
+	.sl-markdown-content
+		:not(h1, h2, h3, h4, h5, h6, .sl-heading-wrapper)
+		+ :is(.sl-heading-wrapper) {
+		margin-top: 1.5em;
+	}
+
+	/* These font sizes are set in `markdown.css` for heading elements, but we need them one level higher on the wrapper. */
+	.sl-markdown-content .sl-heading-wrapper.level-h1 {
+		font-size: var(--sl-text-h1);
+	}
+	.sl-markdown-content .sl-heading-wrapper.level-h2 {
+		font-size: var(--sl-text-h2);
+	}
+	.sl-markdown-content .sl-heading-wrapper.level-h3 {
+		font-size: var(--sl-text-h3);
+	}
+	.sl-markdown-content .sl-heading-wrapper.level-h4 {
+		font-size: var(--sl-text-h4);
+	}
+	.sl-markdown-content .sl-heading-wrapper.level-h5 {
+		font-size: var(--sl-text-h5);
+	}
+	.sl-markdown-content .sl-heading-wrapper.level-h6 {
+		font-size: var(--sl-text-h6);
+	}
+
+	/* ======================================================
+   HEADING
+   ====================================================== */
+	.sl-markdown-content .sl-heading-wrapper > :first-child {
+		display: inline;
+		/* Apply end-of-line padding to the heading element. */
+		padding-inline-end: var(--sl-anchor-icon-space);
+	}
+
+	/* ======================================================
+   LINK
+   ====================================================== */
+	.sl-markdown-content .sl-anchor-link {
+		position: relative;
+		/* Move the anchor link over the heading element’s end-of-line padding. */
+		margin-inline-start: calc(-1 * var(--sl-anchor-icon-size));
+		/* Prevent double or triple clicks from potentially selecting the anchor link a11y text. */
+		-webkit-user-select: none;
+		user-select: none;
+		/* Prevent double clicks on the last word (or single word) of a heading to include an extra new
+     line in Chrome and Safari. */
+		display: inline-flex;
+	}
+
+	/* Increase clickable area for anchor links with a pseudo element that doesn’t impact layout. */
+	.sl-markdown-content .sl-anchor-link::after {
+		content: '';
+		position: absolute;
+		/* While most icon spacing is done with `em` to be relative to the heading font-size, increasing
+     the touch area is most important for smaller headings like h5/h6, so we use absolute units,
+     which have a diminishing impact at larger font-sizes. */
+		inset: -0.25rem -0.5rem;
+	}
+
+	/* Size and position the SVG icon inside the link. */
+	.sl-markdown-content .sl-anchor-icon > svg {
+		display: inline;
+		width: var(--sl-anchor-icon-size);
+		/* Center the link icon SVG vertically in the line. */
+		vertical-align: top;
+		transform: translateY(
+			calc((var(--sl-line-height-headings) * 1em - var(--sl-anchor-icon-size)) / 2)
+		);
+	}
+
+	/* On devices with hover capability, hide the anchor link icons and show only show them when focused
+   or when the heading is hovered. */
+	@media (hover: hover) {
+		.sl-markdown-content .sl-anchor-link {
+			opacity: 0;
+		}
+		.sl-markdown-content .sl-anchor-link:focus,
+		.sl-markdown-content .sl-heading-wrapper:hover .sl-anchor-link {
+			opacity: 1;
+		}
+	}
+}

package/dist/vendor/starlight/style/asides.css

@@ -0,0 +1,51 @@
+@layer starlight.components {
+	.starlight-aside {
+		padding: 1rem;
+		border-inline-start: 0.25rem solid var(--sl-color-asides-border);
+		color: var(--sl-color-white);
+	}
+	.starlight-aside--note {
+		--sl-color-asides-text-accent: var(--sl-color-blue-high);
+		--sl-color-asides-border: var(--sl-color-blue);
+		background-color: var(--sl-color-blue-low);
+	}
+	.starlight-aside--tip {
+		--sl-color-asides-text-accent: var(--sl-color-purple-high);
+		--sl-color-asides-border: var(--sl-color-purple);
+		background-color: var(--sl-color-purple-low);
+	}
+	.starlight-aside--caution {
+		--sl-color-asides-text-accent: var(--sl-color-orange-high);
+		--sl-color-asides-border: var(--sl-color-orange);
+		background-color: var(--sl-color-orange-low);
+	}
+	.starlight-aside--danger {
+		--sl-color-asides-text-accent: var(--sl-color-red-high);
+		--sl-color-asides-border: var(--sl-color-red);
+		background-color: var(--sl-color-red-low);
+	}
+
+	.starlight-aside__title {
+		display: flex;
+		gap: 0.5rem;
+		align-items: center;
+		font-size: var(--sl-text-h5);
+		font-weight: 600;
+		line-height: var(--sl-line-height-headings);
+		color: var(--sl-color-asides-text-accent);
+	}
+
+	.starlight-aside__icon {
+		font-size: 1.333em;
+		width: 1em;
+		height: 1em;
+	}
+
+	.starlight-aside__title + .starlight-aside__content {
+		margin-top: 0.5rem;
+	}
+
+	.starlight-aside__content a {
+		color: var(--sl-color-asides-text-accent);
+	}
+}

package/dist/vendor/starlight/style/layers.css

@@ -0,0 +1 @@
+@layer starlight.base, starlight.reset, starlight.core, starlight.content, starlight.components, starlight.utils;