@purestack/ts-common 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ahmed Yasin Koculu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,10 @@
+# @purestack/ts-common
+
+Shared TypeScript contracts for PureStack's site generator, components, and page
+scripts. This package defines site configuration, page frontmatter, navigation,
+logos, templates, and the rendering context so those packages agree on the same
+shapes.
+
+Import types such as `SiteConfig`, `PageFrontmatter`, and `TsSsgContext` when
+building a custom integration. The runtime exports `resolveTsSsgContext` and
+`tryResolveTsSsgContext` find the site context in a Regor component.

package/dist/ts-common.d.mts

@@ -0,0 +1,588 @@
+/*! @purestack/ts-common v1.1.0 | (c) 2026 Ahmed Yasin Koculu | MIT License */
+
+import { SemanticTone, ThemeOptions, ThemeOptionsInput, ThemeStylesheetLink } from "@purestack/ts-style";
+import { DeepPartial } from "@purestack/ts-util";
+import { BasicHeadConfig, TSNode } from "@purestack/ts-html";
+//#region packages/ts-common/src/consent-types.d.ts
+interface ConsentCategory {
+  id: string;
+  label: string;
+  description?: string;
+  required?: boolean;
+}
+interface ConsentScript {
+  src?: string;
+  content?: string;
+  type?: string;
+  async?: boolean;
+  defer?: boolean;
+  integrity?: string;
+  nonce?: string;
+  crossOrigin?: 'anonymous' | 'use-credentials';
+  referrerPolicy?: string;
+}
+interface ConsentService {
+  id: string;
+  category: string;
+  label?: string;
+  description?: string;
+  scripts: ConsentScript[];
+}
+interface ConsentConfig {
+  enabled: boolean;
+  storageKey: string;
+  policyVersion: string;
+  bannerTitle: string;
+  bannerDescription: string;
+  privacyPolicyUrl?: string;
+  privacyPolicyLabel: string;
+  acceptAllLabel: string;
+  rejectAllLabel: string;
+  manageLabel: string;
+  saveLabel: string;
+  settingsLabel: string;
+  categories: ConsentCategory[];
+  services: ConsentService[];
+}
+//#endregion
+//#region packages/ts-common/src/logo-types.d.ts
+type LogoLayout = 'horizontal' | 'stacked' | 'wordmark' | 'mark';
+type LogoSize = 'sm' | 'md' | 'lg' | 'xl';
+type LogoAppearance = 'plain' | 'badge' | 'outline';
+type LogoMarkStyle = 'plain' | 'soft' | 'solid' | 'outline';
+type LogoWordmarkStyle = 'plain' | 'accent' | 'gradient';
+type LogoShape = 'rounded' | 'square' | 'circle';
+interface LogoConfig {
+  brand: string;
+  subtitle?: string;
+  suffix?: string;
+  href?: string | null;
+  ariaLabel?: string;
+  icon?: string;
+  imageSrc?: string;
+  imageSrcDark?: string;
+  monogram?: string;
+  layout?: LogoLayout;
+  size?: LogoSize;
+  appearance?: LogoAppearance;
+  markStyle?: LogoMarkStyle;
+  wordmarkStyle?: LogoWordmarkStyle;
+  shape?: LogoShape;
+  tone?: SemanticTone;
+  brandColor?: string;
+  accentColor?: string;
+  markBackground?: string;
+  markColor?: string;
+  brandSize?: string;
+  subtitleSize?: string;
+  markSize?: string;
+  gap?: string;
+}
+/** The original uppercase, letter-colored logo. */
+interface ClassicLogoConfig {
+  brand: string;
+  letterColors?: string;
+  subtitleLetterColors?: string;
+  colors?: string[];
+  logoBackground?: number;
+  logoForeground?: number;
+  subtitle?: string;
+  brandSize?: string;
+  brandSizeSm?: string;
+  brandSizeMd?: string;
+  brandSizeLg?: string;
+  brandSizeXl?: string;
+  subtitleSize?: string;
+  subtitleSizeSm?: string;
+  subtitleSizeMd?: string;
+  subtitleSizeLg?: string;
+  subtitleSizeXl?: string;
+  iconSize?: string;
+  iconSizeSm?: string;
+  iconSizeMd?: string;
+  iconSizeLg?: string;
+  iconSizeXl?: string;
+  subtitleInset?: string;
+  subtitleInsetSm?: string;
+  subtitleInsetMd?: string;
+  subtitleInsetLg?: string;
+  subtitleInsetXl?: string;
+  href?: string | null;
+  icon?: string;
+  ariaLabel?: string;
+}
+/** Shared header configuration; each component reads its own presentation fields. */
+interface SiteLogoConfig extends LogoConfig, ClassicLogoConfig {
+  component?: string;
+}
+//#endregion
+//#region packages/ts-common/src/navMenu-types.d.ts
+type NavigationMode = 'auto' | 'custom' | 'hybrid' | 'none';
+type NavigationSort = 'order' | 'title' | 'path';
+interface NavigationConfig {
+  mode?: NavigationMode;
+  navFileName?: string;
+  maxDepth?: number;
+  includeIndex?: boolean;
+  sortBy?: NavigationSort;
+  roots?: string[];
+  tone?: SemanticTone;
+  /** Treatment of the navigation panel, such as flat, surfaceAlt or glass. */
+  variant?: string;
+  /** Extra classes for the navigation panel. */
+  class?: string;
+}
+interface NavItem {
+  id?: string;
+  title: string;
+  url?: string;
+  children?: NavItem[];
+  order?: number;
+  hidden?: boolean;
+  badge?: string;
+  icon?: string;
+  tone?: SemanticTone;
+}
+interface PageNavigationLink {
+  title: string;
+  url: string;
+}
+interface PageNavigationLinks {
+  previous?: PageNavigationLink;
+  next?: PageNavigationLink;
+}
+interface PageNavigation {
+  mode: NavigationMode;
+  folder: string;
+  root: string;
+  items: NavItem[];
+  global: NavItem[];
+  tone: SemanticTone;
+  pageLinks?: PageNavigationLinks;
+}
+//#endregion
+//#region packages/ts-common/src/site-config-types.d.ts
+interface SiteConfig {
+  rootDir: string;
+  contentDir: string;
+  outDir: string;
+  publishDir: string;
+  basePath: string;
+  siteTitle: string;
+  favicon?: string;
+  logo: SiteLogoConfig;
+  docLayout: DocLayoutConfig;
+  style: SiteStyleConfig;
+  html: SiteHtmlConfig;
+  navigation: NavigationConfig;
+  pageToc: PageTocConfig;
+  auth: AuthConfig;
+  scripts: SiteScriptsConfig;
+  sitemap: SitemapConfig;
+  consent: ConsentConfig;
+  analytics: AnalyticsConfig;
+  pagefind: PagefindConfig;
+  preview: PreviewConfig;
+  i18n: I18nConfig;
+  mdx: SiteMdxConfig;
+}
+interface DocLayoutConfig {
+  /** CSS length reserved above desktop navigation and TOC sidebars. */
+  sidebarTop: string;
+  /** CSS length reserved above mobile navigation and TOC drawers. */
+  sidebarTopMobile: string;
+}
+interface PageTocConfig {
+  enabled: boolean;
+  tone: SemanticTone;
+  /** Treatment of the table of contents panel, such as flat, surfaceAlt or glass. */
+  variant?: string;
+  /** Extra classes for the table of contents panel. */
+  class?: string;
+}
+interface AuthConfig {
+  enabled: boolean;
+  signUp: boolean;
+  signedInStorageKey: string;
+}
+interface SiteScriptsConfig {
+  cacheBusting: boolean;
+}
+interface SiteStyleConfig {
+  fileName: string;
+  href: string;
+  themes: string[];
+  pretty: boolean;
+  theme: ThemeOptions;
+}
+interface SiteHtmlConfig {
+  minify: boolean;
+}
+interface SitemapConfig {
+  enabled: boolean;
+  baseUrl: string;
+  fileName: string;
+  robots: RobotsConfig;
+}
+interface RobotsConfig {
+  enabled: boolean;
+  fileName: string;
+  userAgent: string;
+  allow: string[];
+  disallow: string[];
+  crawlDelay?: number;
+  host?: string;
+  additionalSitemaps: string[];
+  customDirectives: string[];
+}
+interface Ga4Config {
+  enabled: boolean;
+  measurementId?: string;
+  serviceId: string;
+  consentCategory: string;
+}
+interface AnalyticsConfig {
+  ga4: Ga4Config;
+}
+interface PagefindConfig {
+  enabled: boolean;
+  excludePaths: string[];
+}
+interface PreviewConfig {
+  title?: string;
+  description?: string;
+  image?: string;
+  imageAlt?: string;
+  imageWidth?: number;
+  imageHeight?: number;
+  siteName?: string;
+  type?: string;
+  locale?: string;
+  twitterCard?: string;
+  twitterSite?: string;
+  twitterCreator?: string;
+}
+type I18nUrlStrategy = 'prefix-all' | 'hidden';
+interface I18nConfig {
+  enabled: boolean;
+  defaultLocale: string;
+  locales: string[];
+  urlStrategy: I18nUrlStrategy;
+  queryParam: string;
+  cookieName: string;
+}
+interface SiteMdxConfig {
+  highlighter: 'shiki' | 'highlightjs';
+  disableHighlighter: boolean;
+  compileMdAsMdx: boolean;
+}
+type SiteStyleConfigInput = DeepPartial<Omit<SiteStyleConfig, 'theme'>> & {
+  theme?: ThemeOptionsInput;
+};
+type SiteConfigInput = DeepPartial<Omit<SiteConfig, 'style'>> & {
+  style?: SiteStyleConfigInput;
+};
+//#endregion
+//#region packages/ts-common/src/frontmatter-types.d.ts
+/**
+ * Normalized frontmatter for a content page.
+ *
+ * This shape is produced from MD/MDX frontmatter and is consumed by template
+ * rendering, navigation building, head generation, and page-level runtime
+ * embedding.
+ *
+ * Known keys are normalized case-insensitively. Custom keys are preserved.
+ */
+interface PageFrontmatter {
+  /**
+   * Primary page title.
+   *
+   * Used by templates, head generation, and as a fallback for navigation
+   * titles when `nav.title` is not provided.
+   */
+  title?: string;
+  /**
+   * Short page summary for metadata and presentation surfaces such as
+   * `<meta name="description">`.
+   */
+  description?: string;
+  /**
+   * Arbitrary head-related metadata.
+   *
+   * This is intentionally open-ended so projects can attach custom values such
+   * as canonical URLs or downstream head configuration inputs.
+   */
+  head?: Record<string, unknown>;
+  /**
+   * Social/search preview metadata for this page.
+   *
+   * Missing fields are filled from the page title/description and site-level
+   * preview defaults before Open Graph and Twitter tags are generated.
+   */
+  preview?: PreviewConfig;
+  /**
+   * Page template key.
+   *
+   * Built-in templates include `doc` and `splash`. Custom template names can
+   * also be provided by the host application.
+   *
+   * Defaults to `doc`.
+   */
+  template: string;
+  /**
+   * Page sort order.
+   *
+   * Used by generated navigation unless overridden by `nav.order`.
+   */
+  order?: number;
+  /**
+   * Hides the page from generated navigation when set to `true`.
+   */
+  hidden: boolean;
+  /**
+   * Marks the page as draft content.
+   *
+   * Draft pages are excluded from generated navigation.
+   */
+  draft: boolean;
+  /**
+   * Navigation-specific overrides for this page.
+   */
+  nav: FrontmatterNavOptions;
+  /**
+   * Layout and template presentation controls.
+   */
+  layout: FrontmatterLayoutOptions;
+  /**
+   * Page-level runtime embedding switches for supported MDX features.
+   */
+  embed?: FrontmatterEmbedOptions;
+  /**
+   * Preserves additional custom frontmatter keys.
+   */
+  [key: string]: unknown;
+}
+/**
+ * Layout controls for the built-in page templates.
+ *
+ * These options are normalized from MD/MDX frontmatter and primarily affect
+ * the built-in `doc` and `splash` templates.
+ */
+interface FrontmatterLayoutOptions {
+  /**
+   * Controls how the page navigation is presented in the `doc` template.
+   *
+   * - `sidebar`: persistent sidebar layout on larger screens
+   * - `drawer`: collapsible drawer-style navigation
+   *
+   * Defaults to `sidebar`. Any other value is invalid and should throw during
+   * frontmatter normalization.
+   */
+  navMode: 'sidebar' | 'drawer';
+  /**
+   * Expands the main content area to the wider documentation layout.
+   *
+   * In the built-in `doc` template this adds the full-width main-content
+   * treatment instead of the narrower default reading width.
+   *
+   * Defaults to `false`.
+   */
+  fullWidth: boolean;
+  /**
+   * Enables table-of-contents rendering when the page outline contains items.
+   *
+   * The TOC appears only when this flag is `true` and the page actually has
+   * extracted headings.
+   *
+   * Defaults to the site-level `pageToc.enabled` setting.
+   */
+  showToc: boolean;
+  /**
+   * Controls whether the generated page navigation menu is rendered.
+   *
+   * This is separate from `nav.hidden`: `nav.hidden` removes the current page
+   * from generated navigation, while `showNav` controls the navigation shell on
+   * the current page.
+   *
+   * Defaults to `true`.
+   */
+  showNav: boolean;
+  /**
+   * Starts the built-in TOC in its collapsed visual state.
+   *
+   * This does not disable the TOC. It only changes the initial presentation
+   * when `showToc` is enabled and a TOC is available.
+   *
+   * Defaults to `false`.
+   */
+  tocCollapsed?: boolean;
+  /**
+   * Overrides the page TOC tone for this page.
+   *
+   * When present, this takes precedence over the resolved site TOC tone for
+   * the current page render only.
+   */
+  tocTone?: SemanticTone;
+  /**
+   * Controls whether the resolved page footer is rendered.
+   *
+   * Defaults to `true`.
+   */
+  showFooter: boolean;
+  /**
+   * Allows template-specific custom layout keys without narrowing the public
+   * frontmatter surface to only the built-in options.
+   */
+  [key: string]: unknown;
+}
+/**
+ * Navigation-specific overrides for a single page.
+ *
+ * These values are consumed when building navigation trees and take precedence
+ * over the page-level equivalents where noted.
+ */
+interface FrontmatterNavOptions {
+  /**
+   * Overrides the title shown in generated navigation.
+   *
+   * Navigation title fallback order is:
+   * `nav.title` -> `title` -> first `# heading` -> filename.
+   */
+  title?: string;
+  /**
+   * Overrides page sort order inside navigation.
+   *
+   * When present, this takes precedence over the page-level `order` field.
+   */
+  order?: number;
+  /**
+   * Badge text shown with this page's generated navigation item.
+   */
+  badge?: string;
+  /**
+   * Icon name shown with this page's generated navigation item.
+   */
+  icon?: string;
+  /**
+   * Overrides the navigation menu tone for this page.
+   *
+   * When present, this takes precedence over the resolved site navigation tone
+   * for the current page render only.
+   */
+  tone?: SemanticTone;
+  /**
+   * Excludes the page from generated navigation when set to `true`.
+   *
+   * This is evaluated together with the page-level `hidden` and `draft` flags.
+   */
+  hidden: boolean;
+  /**
+   * Allows additional project-specific navigation metadata.
+   */
+  [key: string]: unknown;
+}
+/**
+ * Runtime asset injection controls for MDX features that require page-level
+ * scripts or supporting markup.
+ */
+interface FrontmatterEmbedOptions {
+  /**
+   * Chooses where the tabs runtime is injected.
+   *
+   * - `head`: inject supporting runtime into the page head
+   * - `body`: inject supporting runtime near the end of the body
+   */
+  tabs?: 'head' | 'body';
+  /**
+   * Chooses where the modal runtime is injected.
+   *
+   * - `head`: inject supporting runtime into the page head
+   * - `body`: inject supporting runtime near the end of the body
+   */
+  modal?: 'head' | 'body';
+  /**
+   * Allows future or project-specific embed flags.
+   */
+  [key: string]: unknown;
+}
+/**
+ * Parsed page source split into normalized frontmatter and markdown/MDX body.
+ */
+interface ParsedFrontmatterSource {
+  /**
+   * Page content without the frontmatter block.
+   */
+  body: string;
+  /**
+   * Normalized page frontmatter.
+   */
+  frontmatter: PageFrontmatter;
+}
+//#endregion
+//#region packages/ts-common/src/ts-ssg-context.d.ts
+interface PageOutlineItem {
+  id: string;
+  title: string;
+  depth?: number;
+  children?: PageOutlineItem[];
+}
+interface TsSsgNavigation {
+  folder?: string;
+  root?: string;
+  global?: NavItem[];
+  items?: NavItem[];
+  pageLinks?: PageNavigationLinks;
+}
+interface TsSsgContext {
+  site: SiteConfig;
+  pageInfo: PageInfo;
+  navigation?: TsSsgNavigation;
+  outline?: PageOutlineItem[];
+  theme: ThemeOptions;
+  basePath: string;
+  locale?: string;
+  locales: string[];
+  defaultLocale?: string;
+  resolveLocaleHref: (locale: string) => string | undefined;
+  resolvePublicHref: (href: string) => string;
+  recordScriptEntrypoint: (sourceRelPath: string) => void;
+  resolveScriptPublicPath?: (sourceRelPath: string) => string;
+  recordRuntimeEmbed: (name: string, position: 'body' | 'head') => void;
+}
+//#endregion
+//#region packages/ts-common/src/page-template-types.d.ts
+interface PageInfo {
+  relPath: string;
+  urlPath: string;
+  frontmatter: PageFrontmatter;
+  locale?: string;
+  translationKey?: string;
+  translations?: PageTranslationInfo[];
+}
+interface PageTranslationInfo {
+  locale: string;
+  urlPath: string;
+  relPath: string;
+}
+interface PageTemplateInput {
+  head: TSNode<'head'>;
+  bodyHtml: string;
+  headConfig?: BasicHeadConfig;
+  styleLinks?: ThemeStylesheetLink[];
+  templateName: string;
+  site: SiteConfig;
+  navigation?: PageNavigation;
+  outline?: PageOutlineItem[];
+  pageInfo: PageInfo;
+  headerHtml?: string;
+  footerHtml?: string;
+}
+type PageTemplate = (input: PageTemplateInput) => TSNode<'html'> | Promise<TSNode<'html'>>;
+type PageTemplateMap = Record<string, PageTemplate>;
+//#endregion
+//#region packages/ts-common/src/resolveTsSsgContext.d.ts
+export declare function resolveTsSsgContext(head: unknown): TsSsgContext;
+export declare function tryResolveTsSsgContext(head: unknown): TsSsgContext | undefined;
+//#endregion
+export type { AnalyticsConfig, AuthConfig, ClassicLogoConfig, ConsentCategory, ConsentConfig, ConsentScript, ConsentService, DocLayoutConfig, FrontmatterEmbedOptions, FrontmatterLayoutOptions, FrontmatterNavOptions, Ga4Config, I18nConfig, I18nUrlStrategy, LogoAppearance, LogoConfig, LogoLayout, LogoMarkStyle, LogoShape, LogoSize, LogoWordmarkStyle, NavItem, NavigationConfig, NavigationMode, NavigationSort, PageFrontmatter, PageInfo, PageNavigation, PageNavigationLink, PageNavigationLinks, PageOutlineItem, PageTemplate, PageTemplateInput, PageTemplateMap, PageTocConfig, PageTranslationInfo, PagefindConfig, ParsedFrontmatterSource, PreviewConfig, RobotsConfig, SiteConfig, SiteConfigInput, SiteHtmlConfig, SiteLogoConfig, SiteMdxConfig, SiteScriptsConfig, SiteStyleConfig, SiteStyleConfigInput, SitemapConfig, TsSsgContext, TsSsgNavigation };
+//# sourceMappingURL=ts-common.d.mts.map

package/dist/ts-common.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-common.d.mts","names":[],"sources":["../src/consent-types.ts","../src/logo-types.ts","../src/navMenu-types.ts","../src/site-config-types.ts","../src/frontmatter-types.ts","../src/ts-ssg-context.ts","../src/page-template-types.ts","../src/resolveTsSsgContext.ts"],"mappings":";;;;UAAiB;EACf;EACA;EACA;EACA;;UAGe;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;UAGe;EACf;EACA;EACA;EACA;EACA,SAAS;;UAGM;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,YAAY;EACZ,UAAU;;;;KCvCA;KACA;KACA;KACA;KACA;KACA;UAEK;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,SAAS;EACT,OAAO;EACP,aAAa;EACb,YAAY;EACZ,gBAAgB;EAChB,QAAQ;EACR,OAAO;EACP;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;;UAIe;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;;UAIe,uBAAuB,YAAY;EAClD;;;;KCtEU;KACA;UAEK;EACf,OAAO;EACP;EACA;EACA;EACA,SAAS;EACT;EACA,OAAO;;EAEP;;EAEA;;UAGe;EACf;EACA;EACA;EACA,WAAW;EACX;EACA;EACA;EACA;EACA,OAAO;;UAGQ;EACf;EACA;;UAGe;EACf,WAAW;EACX,OAAO;;UAGQ;EACf,MAAM;EACN;EACA;EACA,OAAO;EACP,QAAQ;EACR,MAAM;EACN,YAAY;;;;UCtCG;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA,MAAM;EACN,WAAW;EACX,OAAO;EACP,MAAM;EACN,YAAY;EACZ,SAAS;EACT,MAAM;EACN,SAAS;EACT,SAAS;EACT,SAAS;EACT,WAAW;EACX,UAAU;EACV,SAAS;EACT,MAAM;EACN,KAAK;;UAGU;;EAEf;;EAEA;;UAGe;EACf;EACA,MAAM;;EAEN;;EAEA;;UAGe;EACf;EACA;EACA;;UAGe;EACf;;UAGe;EACf;EACA;EACA;EACA;EACA,OAAO;;UAGQ;EACf;;UAGe;EACf;EACA;EACA;EACA,QAAQ;;UAGO;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;UAGe;EACf;EACA;EACA;EACA;;UAGe;EACf,KAAK;;UAGU;EACf;EACA;;UAGe;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;KAGU;UAEK;EACf;EACA;EACA;EACA,aAAa;EACb;EACA;;UAGe;EACf;EACA;EACA;;KAGU,uBAAuB,YACjC,KAAK;EAEL,QAAQ;;KAGE,kBAAkB,YAAY,KAAK;EAC7C,QAAQ;;;;;;;;;;;;;UCvIO;;;;;;;EAOf;;;;;EAMA;;;;;;;EAQA,OAAO;;;;;;;EAQP,UAAU;;;;;;;;;EAUV;;;;;;EAOA;;;;EAKA;;;;;;EAOA;;;;EAKA,KAAK;;;;EAKL,QAAQ;;;;EAKR,QAAQ;;;;GAKP;;;;;;;;UASc;;;;;;;;;;EAUf;;;;;;;;;EAUA;;;;;;;;;EAUA;;;;;;;;;;EAWA;;;;;;;;;EAUA;;;;;;;EAQA,UAAU;;;;;;EAOV;;;;;GAMC;;;;;;;;UASc;;;;;;;EAOf;;;;;;EAOA;;;;EAKA;;;;EAKA;;;;;;;EAQA,OAAO;;;;;;EAOP;;;;GAKC;;;;;;UAOc;;;;;;;EAOf;;;;;;;EAQA;;;;GAKC;;;;;UAMc;;;;EAIf;;;;EAKA,aAAa;;;;UClQE;EACf;EACA;EACA;EACA,WAAW;;UAGI;EACf;EACA;EACA,SAAS;EACT,QAAQ;EACR,YAAY;;UAGG;EACf,MAAM;EACN,UAAU;EACV,aAAa;EACb,UAAU;EACV,OAAO;EACP;EACA;EACA;EACA;EACA,oBAAoB;EACpB,oBAAoB;EACpB,yBAAyB;EACzB,2BAA2B;EAC3B,qBAAqB,cAAc;;;;UC9BpB;EACf;EACA;EACA,aAAa;EACb;EACA;EACA,eAAe;;UAGA;EACf;EACA;EACA;;UAGe;EACf,MAAM;EACN;EACA,aAAa;EACb,aAAa;EACb;EACA,MAAM;EACN,aAAa;EACb,UAAU;EACV,UAAU;EACV;EACA;;KAGU,gBACV,OAAO,sBACJ,iBAAiB,QAAQ;KAElB,kBAAkB,eAAe;;;wBCtB7B,oBAAoB,gBAAgB;wBASpC,uBACd,gBACC"}

package/dist/ts-common.mjs

@@ -0,0 +1,28 @@
+/*! @purestack/ts-common v1.1.0 | (c) 2026 Ahmed Yasin Koculu | MIT License */
+
+//#region packages/ts-common/src/resolveTsSsgContext.ts
+function hasTsSsgContext(value) {
+	return typeof value === "object" && value !== null && "tsSsgContext" in value;
+}
+function hasContextStack(value) {
+	return typeof value === "object" && value !== null && "ctx" in value;
+}
+function resolveTsSsgContext(head) {
+	const stack = hasContextStack(head) && Array.isArray(head.ctx) ? head.ctx : [];
+	for (const ctx of stack) {
+		if (!hasTsSsgContext(ctx)) continue;
+		if (ctx.tsSsgContext) return ctx.tsSsgContext;
+	}
+	throw new Error("tsSsgContext is not available in the Regor context stack.");
+}
+function tryResolveTsSsgContext(head) {
+	const stack = hasContextStack(head) && Array.isArray(head.ctx) ? head.ctx : [];
+	for (const ctx of stack) {
+		if (!hasTsSsgContext(ctx)) continue;
+		if (ctx.tsSsgContext) return ctx.tsSsgContext;
+	}
+}
+
+//#endregion
+export { resolveTsSsgContext, tryResolveTsSsgContext };
+//# sourceMappingURL=ts-common.mjs.map

package/dist/ts-common.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-common.mjs","names":[],"sources":["../src/resolveTsSsgContext.ts"],"sourcesContent":["import type { TsSsgContext } from './ts-ssg-context'\n\ntype ContextCarrier = {\n  tsSsgContext?: TsSsgContext\n}\n\ntype HeadLike = {\n  ctx?: unknown[]\n}\n\nfunction hasTsSsgContext(value: unknown): value is ContextCarrier {\n  return typeof value === 'object' && value !== null && 'tsSsgContext' in value\n}\n\nfunction hasContextStack(value: unknown): value is HeadLike {\n  return typeof value === 'object' && value !== null && 'ctx' in value\n}\n\nexport function resolveTsSsgContext(head: unknown): TsSsgContext {\n  const stack = hasContextStack(head) && Array.isArray(head.ctx) ? head.ctx : []\n  for (const ctx of stack) {\n    if (!hasTsSsgContext(ctx)) continue\n    if (ctx.tsSsgContext) return ctx.tsSsgContext\n  }\n  throw new Error('tsSsgContext is not available in the Regor context stack.')\n}\n\nexport function tryResolveTsSsgContext(\n  head: unknown,\n): TsSsgContext | undefined {\n  const stack = hasContextStack(head) && Array.isArray(head.ctx) ? head.ctx : []\n  for (const ctx of stack) {\n    if (!hasTsSsgContext(ctx)) continue\n    if (ctx.tsSsgContext) return ctx.tsSsgContext\n  }\n  return undefined\n}\n"],"mappings":";AAUA,SAAS,gBAAgB,OAAyC;CAChE,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,kBAAkB;AAC1E;AAEA,SAAS,gBAAgB,OAAmC;CAC1D,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,SAAS;AACjE;AAEA,SAAgB,oBAAoB,MAA6B;CAC/D,MAAM,QAAQ,gBAAgB,IAAI,KAAK,MAAM,QAAQ,KAAK,GAAG,IAAI,KAAK,MAAM,CAAC;CAC7E,KAAK,MAAM,OAAO,OAAO;EACvB,IAAI,CAAC,gBAAgB,GAAG,GAAG;EAC3B,IAAI,IAAI,cAAc,OAAO,IAAI;CACnC;CACA,MAAM,IAAI,MAAM,2DAA2D;AAC7E;AAEA,SAAgB,uBACd,MAC0B;CAC1B,MAAM,QAAQ,gBAAgB,IAAI,KAAK,MAAM,QAAQ,KAAK,GAAG,IAAI,KAAK,MAAM,CAAC;CAC7E,KAAK,MAAM,OAAO,OAAO;EACvB,IAAI,CAAC,gBAAgB,GAAG,GAAG;EAC3B,IAAI,IAAI,cAAc,OAAO,IAAI;CACnC;AAEF"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@purestack/ts-common",
+  "version": "1.1.0",
+  "packageManager": "yarn@4.9.2",
+  "module": "./dist/ts-common.mjs",
+  "types": "./dist/ts-common.d.mts",
+  "type": "module",
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/PureStackStudio/PureStack.git",
+    "directory": "packages/ts-common"
+  },
+  "homepage": "https://purestack.studio",
+  "bugs": {
+    "url": "https://github.com/PureStackStudio/PureStack/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/ts-common.d.mts",
+      "import": "./dist/ts-common.mjs"
+    }
+  },
+  "dependencies": {
+    "@purestack/ts-html": "^1.1.0",
+    "@purestack/ts-style": "^1.1.0",
+    "@purestack/ts-util": "^1.1.0"
+  },
+  "license": "MIT",
+  "files": [
+    "dist/*.mjs",
+    "dist/*.mjs.map",
+    "dist/*.d.mts",
+    "dist/*.d.mts.map",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "lint": "biome check ./src --formatter-enabled=false --write",
+    "test": "vitest"
+  }
+}