@stacksjs/stx 0.2.26 → 0.2.29

package/dist/site-builder/build.d.ts

@@ -0,0 +1,18 @@
+import type { BuildOptions, SiteConfig } from './types';
+/**
+ * Build a static stx site end-to-end:
+ * 1. Bundle all pages with bun-plugin-stx
+ * 2. Inject Crosswind CSS into each HTML file
+ * 3. Replace stx default SEO tags with site-specific ones
+ * 4. Drop the empty bundle chunks bun-plugin-stx leaves behind
+ * 5. Copy public/ assets verbatim
+ * 6. Synthesize 404.html (uses pages/404.stx if present, else clones index)
+ * 7. Generate sitemap.xml and robots.txt
+ */
+export declare function buildStaticSite(options: BuildOptions): Promise<BuildResult>;
+export declare function defineSiteConfig<T extends SiteConfig>(config: T): T;
+export declare interface BuildResult {
+  outDir: string
+  pages: string[]
+  durationMs: number
+}

package/dist/site-builder/index.d.ts

@@ -0,0 +1,13 @@
+export type {
+  BuildOptions,
+  PageMeta,
+  SiteConfig,
+  SiteRouterOptions,
+  SiteSeo,
+  SiteSocial,
+} from './types';
+export { buildStaticSite, defineSiteConfig, type BuildResult } from './build';
+export { injectSeo } from './seo';
+export { generateSitemap, type SitemapEntry } from './sitemap';
+export { generateRobots } from './robots';
+export { injectRouterScript, type RouterOptions } from './router';

package/dist/site-builder/robots.d.ts

@@ -0,0 +1,2 @@
+import type { SiteConfig } from './types';
+export declare function generateRobots(site: SiteConfig): string | null;

package/dist/site-builder/router.d.ts

@@ -0,0 +1,10 @@
+import type { SiteRouterOptions } from './types';
+/**
+ * Inject the stx SPA router into HTML. The script is appended just
+ * before `</body>` (or at the end of the document if there is no body
+ * close). Configuration from `options` is exposed as
+ * `window.__stxRouterConfig` ahead of the runtime so the runtime picks
+ * it up on init.
+ */
+export declare function injectRouterScript(html: string, options?: RouterOptions): string;
+export type RouterOptions = SiteRouterOptions;

package/dist/site-builder/seo.d.ts

@@ -0,0 +1,8 @@
+import type { PageMeta, SiteConfig } from './types';
+/**
+ * Replace stx's auto-injected default SEO block (which says "stx Project")
+ * with site-specific tags. Looks for the marker comment stx inserts and
+ * swaps the wrapped meta tags. If the block isn't found, prepends the
+ * tags after <head>.
+ */
+export declare function injectSeo(html: string, site: SiteConfig, page?: PageMeta, pagePath?: string): string;

package/dist/site-builder/sitemap.d.ts

@@ -0,0 +1,10 @@
+import type { PageMeta, SiteConfig } from './types';
+/**
+ * Generate sitemap.xml content from a list of built pages.
+ * Pages with `sitemap: false` in their config are excluded.
+ */
+export declare function generateSitemap(site: SiteConfig, entries: SitemapEntry[]): string;
+export declare interface SitemapEntry {
+  path: string
+  page?: PageMeta
+}

package/dist/site-builder/types.d.ts

@@ -0,0 +1,54 @@
+export declare interface SiteSeo {
+  title?: string
+  description?: string
+  siteName?: string
+  image?: string
+  twitter?: string
+  locale?: string
+  type?: string
+  favicon?: string
+}
+export declare interface SiteSocial {
+  twitter?: string
+  instagram?: string
+  youtube?: string
+  github?: string
+  linkedin?: string
+  [k: string]: string | undefined
+}
+export declare interface SiteConfig {
+  name: string
+  url: string
+  description?: string
+  social?: SiteSocial
+  seo?: SiteSeo
+  pagesDir?: string
+  publicDir?: string
+  outDir?: string
+  sitemap?: boolean
+  robots?: boolean | 'allow' | 'disallow' | string
+  pages?: Record<string, PageMeta>
+  spa?: boolean
+  router?: SiteRouterOptions
+}
+export declare interface PageMeta {
+  title?: string
+  description?: string
+  image?: string
+  sitemap?: boolean
+  priority?: number
+  changefreq?: 'always' | 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly' | 'never'
+}
+export declare interface BuildOptions extends SiteConfig {
+  noClean?: boolean
+}
+/**
+ * SPA router options (subset — see RouterOptions in router.ts).
+ * Inlined to avoid a circular import in this types file.
+ */
+export declare interface SiteRouterOptions {
+  color?: string
+  progress?: boolean
+  prefetch?: boolean
+  cache?: boolean
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/stx",
   "type": "module",
-  "version": "0.2.26",
+  "version": "0.2.29",
   "description": "A performant UI Framework. Powered by Bun.",
   "author": "Chris Breuer <chris@stacksjs.org>",
   "license": "MIT",
@@ -116,12 +116,12 @@
   "dependencies": {
     "@cwcss/crosswind": "^0.2.0",
     "@stacksjs/clapp": "^0.2.0",
-    "@stacksjs/desktop": "0.2.26",
-    "@stacksjs/sanitizer": "0.2.26",
+    "@stacksjs/desktop": "0.2.27",
+    "@stacksjs/sanitizer": "0.2.27",
     "@stacksjs/ts-craft": "^0.0.2",
-    "bun-plugin-stx": "0.2.26",
+    "bun-plugin-stx": "0.2.29",
     "bunfig": "^0.15.6",
-    "stx-router": "0.2.26",
+    "stx-router": "0.2.27",
     "ts-broadcasting": "^0.0.4",
     "ts-syntax-highlighter": "^0.2.1"
   }