npm - @webstir-io/webstir - Versions diffs - 0.1.0 - Mend

@webstir-io/webstir 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (123) hide show

package/README.md +69 -0
package/assets/features/client_nav/client_nav.ts +469 -0
package/assets/features/content_nav/content_nav.css +170 -0
package/assets/features/content_nav/content_nav.ts +358 -0
package/assets/features/router/router-types.ts +6 -0
package/assets/features/router/router.ts +118 -0
package/assets/features/search/search.css +204 -0
package/assets/features/search/search.ts +627 -0
package/assets/templates/api/src/backend/index.ts +13 -0
package/assets/templates/api/src/backend/tsconfig.json +15 -0
package/assets/templates/api/src/shared/router-types.ts +23 -0
package/assets/templates/api/src/shared/tsconfig.json +10 -0
package/assets/templates/api/src/shared/types/index.ts +4 -0
package/assets/templates/full/src/backend/index.ts +13 -0
package/assets/templates/full/src/backend/tsconfig.json +15 -0
package/assets/templates/full/src/frontend/app/app.css +65 -0
package/assets/templates/full/src/frontend/app/app.html +13 -0
package/assets/templates/full/src/frontend/app/app.ts +188 -0
package/assets/templates/full/src/frontend/app/error.ts +127 -0
package/assets/templates/full/src/frontend/app/hmr.js +355 -0
package/assets/templates/full/src/frontend/app/navigation.ts +8 -0
package/assets/templates/full/src/frontend/app/refresh.js +114 -0
package/assets/templates/full/src/frontend/app/router.ts +126 -0
package/assets/templates/full/src/frontend/app/styles/base.css +2 -0
package/assets/templates/full/src/frontend/app/styles/reset.css +48 -0
package/assets/templates/full/src/frontend/pages/home/index.css +21 -0
package/assets/templates/full/src/frontend/pages/home/index.html +10 -0
package/assets/templates/full/src/frontend/pages/home/index.ts +18 -0
package/assets/templates/full/src/frontend/pages/home/tests/home.test.ts +21 -0
package/assets/templates/full/src/frontend/tsconfig.json +20 -0
package/assets/templates/full/src/shared/router-types.ts +23 -0
package/assets/templates/full/src/shared/tsconfig.json +10 -0
package/assets/templates/full/src/shared/types/index.ts +4 -0
package/assets/templates/shared/Errors.404.html +23 -0
package/assets/templates/shared/Errors.500.html +23 -0
package/assets/templates/shared/Errors.default.html +23 -0
package/assets/templates/shared/types/global.d.ts +32 -0
package/assets/templates/shared/types.global.d.ts +32 -0
package/assets/templates/spa/src/frontend/app/app.css +65 -0
package/assets/templates/spa/src/frontend/app/app.html +13 -0
package/assets/templates/spa/src/frontend/app/app.ts +188 -0
package/assets/templates/spa/src/frontend/app/error.ts +127 -0
package/assets/templates/spa/src/frontend/app/hmr.js +355 -0
package/assets/templates/spa/src/frontend/app/navigation.ts +8 -0
package/assets/templates/spa/src/frontend/app/refresh.js +114 -0
package/assets/templates/spa/src/frontend/app/router.ts +126 -0
package/assets/templates/spa/src/frontend/app/styles/base.css +2 -0
package/assets/templates/spa/src/frontend/app/styles/reset.css +48 -0
package/assets/templates/spa/src/frontend/pages/home/index.css +21 -0
package/assets/templates/spa/src/frontend/pages/home/index.html +10 -0
package/assets/templates/spa/src/frontend/pages/home/index.ts +18 -0
package/assets/templates/spa/src/frontend/pages/home/tests/home.test.ts +21 -0
package/assets/templates/spa/src/frontend/tsconfig.json +20 -0
package/assets/templates/spa/src/shared/router-types.ts +23 -0
package/assets/templates/spa/src/shared/tsconfig.json +10 -0
package/assets/templates/spa/src/shared/types/index.ts +4 -0
package/assets/templates/ssg/src/frontend/app/app.css +12 -0
package/assets/templates/ssg/src/frontend/app/app.html +43 -0
package/assets/templates/ssg/src/frontend/app/app.ts +190 -0
package/assets/templates/ssg/src/frontend/app/error.ts +127 -0
package/assets/templates/ssg/src/frontend/app/hmr.js +370 -0
package/assets/templates/ssg/src/frontend/app/refresh.js +163 -0
package/assets/templates/ssg/src/frontend/app/scripts/components/drawer.ts +183 -0
package/assets/templates/ssg/src/frontend/app/scripts/components/menu.ts +75 -0
package/assets/templates/ssg/src/frontend/app/styles/base.css +77 -0
package/assets/templates/ssg/src/frontend/app/styles/components/buttons.css +108 -0
package/assets/templates/ssg/src/frontend/app/styles/components/drawer.css +12 -0
package/assets/templates/ssg/src/frontend/app/styles/components/header.css +164 -0
package/assets/templates/ssg/src/frontend/app/styles/components/markdown.css +25 -0
package/assets/templates/ssg/src/frontend/app/styles/layout.css +41 -0
package/assets/templates/ssg/src/frontend/app/styles/reset.css +56 -0
package/assets/templates/ssg/src/frontend/app/styles/tokens.css +72 -0
package/assets/templates/ssg/src/frontend/app/styles/utilities.css +14 -0
package/assets/templates/ssg/src/frontend/content/_sidebar.json +14 -0
package/assets/templates/ssg/src/frontend/content/content-pipeline.md +82 -0
package/assets/templates/ssg/src/frontend/content/css-playbook.md +68 -0
package/assets/templates/ssg/src/frontend/content/hosting.md +48 -0
package/assets/templates/ssg/src/frontend/pages/about/index.css +33 -0
package/assets/templates/ssg/src/frontend/pages/about/index.html +60 -0
package/assets/templates/ssg/src/frontend/pages/docs/index.css +505 -0
package/assets/templates/ssg/src/frontend/pages/docs/index.html +52 -0
package/assets/templates/ssg/src/frontend/pages/docs/index.ts +495 -0
package/assets/templates/ssg/src/frontend/pages/home/index.css +91 -0
package/assets/templates/ssg/src/frontend/pages/home/index.html +38 -0
package/assets/templates/ssg/src/frontend/pages/home/tests/home.test.ts +24 -0
package/assets/templates/ssg/src/frontend/tsconfig.json +13 -0
package/package.json +41 -0
package/scripts/pack-standalone.mjs +127 -0
package/scripts/sync-assets.mjs +87 -0
package/src/add-backend.ts +164 -0
package/src/add.ts +112 -0
package/src/api-watch.ts +84 -0
package/src/backend-inspect.ts +45 -0
package/src/backend-runtime.ts +286 -0
package/src/build-plan.ts +12 -0
package/src/build.ts +10 -0
package/src/cli.ts +569 -0
package/src/compile-tests.ts +61 -0
package/src/dev-server.ts +393 -0
package/src/enable-assets.ts +196 -0
package/src/enable.ts +477 -0
package/src/execute.ts +85 -0
package/src/format.ts +254 -0
package/src/frontend-watch.ts +145 -0
package/src/full-watch.ts +80 -0
package/src/index.ts +20 -0
package/src/init-assets.ts +96 -0
package/src/init.ts +339 -0
package/src/paths.ts +26 -0
package/src/providers.ts +88 -0
package/src/publish.ts +8 -0
package/src/refresh.ts +56 -0
package/src/repair.ts +414 -0
package/src/runtime.ts +48 -0
package/src/smoke.ts +161 -0
package/src/stop-signal.ts +26 -0
package/src/test.ts +215 -0
package/src/types.ts +29 -0
package/src/watch-daemon-client.ts +171 -0
package/src/watch-events.ts +195 -0
package/src/watch.ts +66 -0
package/src/workspace-watcher.ts +251 -0
package/src/workspace.ts +55 -0

package/assets/templates/full/src/backend/index.ts ADDED Viewed

@@ -0,0 +1,13 @@
+import http from 'node:http';
+const PORT = Number(process.env.PORT || 4321);
+const server = http.createServer((req, res) => {
+  res.writeHead(200, { 'Content-Type': 'text/plain' });
+  res.end('API server running');
+});
+server.listen(PORT, '0.0.0.0', () => {
+  console.log(`API server running at http://localhost:${PORT}`);
+});
+export default server;

package/assets/templates/full/src/backend/tsconfig.json ADDED Viewed

@@ -0,0 +1,15 @@
+{
+  "extends": "../../base.tsconfig.json",
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022"],
+    "outDir": "../../build/backend",
+    "rootDir": ".",
+    "baseUrl": ".",
+    "incremental": true,
+    "tsBuildInfoFile": "../../build/backend/.tsbuildinfo"
+  },
+  "include": ["**/*.ts", "../../types/**/*.d.ts"],
+  "exclude": ["node_modules", "../../build", "../../dist"],
+  "references": []
+}

package/assets/templates/full/src/frontend/app/app.css ADDED Viewed

@@ -0,0 +1,65 @@
+/* Main App Stylesheet */
+@import "./styles/reset.css";
+/* Base body styles */
+html, body {
+  margin: 0;
+  padding: 0;
+  height: 100%;
+}
+body {
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen,
+    Ubuntu, Cantarell, 'Fira Sans', 'Droid Sans', 'Helvetica Neue', Arial,
+    sans-serif;
+  line-height: 1.5;
+  color: #1f2937;
+  background: #f8fafc;
+}
+main {
+  display: block;
+}
+/* Layout helpers */
+.container {
+  width: 100%;
+  max-width: 1200px;
+  margin-left: auto;
+  margin-right: auto;
+  padding-left: 1rem;
+  padding-right: 1rem;
+}
+/* Utility classes */
+.sr-only {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  padding: 0;
+  margin: -1px;
+  overflow: hidden;
+  clip: rect(0, 0, 0, 0);
+  white-space: nowrap; /* added line */
+  border: 0;
+}
+/* Basic typography */
+h1, h2, h3, h4, h5, h6 {
+  color: #111827;
+  line-height: 1.25;
+  margin: 0 0 0.5rem 0;
+}
+p {
+  margin: 0 0 1rem 0;
+}
+a {
+  color: #2563eb;
+  text-decoration: none;
+}
+a:hover {
+  text-decoration: underline;
+}

package/assets/templates/full/src/frontend/app/app.html ADDED Viewed

@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="description" content="Starter description for your Webstir app. Update it to summarize this page for search results.">
+</head>
+<body>
+    <main> </main>
+    <script type="module" src="/hmr.js"></script>
+    <script src="/refresh.js" async></script>
+</body>
+</html>

package/assets/templates/full/src/frontend/app/app.ts ADDED Viewed

@@ -0,0 +1,188 @@
+// Global app initialization
+type HotAsset = {
+  type: 'js' | 'css';
+  url: string;
+  relativePath: string;
+};
+type HotModuleContext = {
+  changedFile: string | null;
+  modules: ReadonlyArray<HotAsset>;
+  styles: ReadonlyArray<HotAsset>;
+  cacheBuster: string;
+  timestamp: number;
+  asset?: HotAsset;
+  previousExports?: unknown;
+};
+type HotModuleHandlers = {
+  accept?: (moduleExports: unknown, context: HotModuleContext) => boolean | Promise<boolean>;
+  dispose?: (context: HotModuleContext) => void | Promise<void>;
+};
+type HotModuleRecord = HotModuleHandlers & {
+  currentExports?: unknown;
+};
+declare global {
+  interface Window {
+    __webstirEventSource?: EventSource;
+    __webstirSetDevStatus?: (status: string, message?: string) => void;
+    __webstirOnHmrFallback?: (info: { reason?: string; payload?: unknown; details?: unknown }) => void;
+    __webstirRegisterHotModule?: (moduleId: string, handlers: HotModuleHandlers) => void;
+    __webstirDispose?: (asset: HotAsset | undefined, context: HotModuleContext) => boolean | Promise<boolean>;
+    __webstirAccept?: (moduleExports: unknown, context: HotModuleContext) => boolean | Promise<boolean>;
+  }
+}
+const hotModuleRegistry = new Map<string, HotModuleRecord>();
+function ensureRecord(moduleId: string): HotModuleRecord {
+  const existing = hotModuleRegistry.get(moduleId);
+  if (existing) {
+    return existing;
+  }
+  const created: HotModuleRecord = {};
+  hotModuleRegistry.set(moduleId, created);
+  return created;
+}
+function normalizeModuleId(candidate?: string | null): string | null {
+  if (!candidate) {
+    return null;
+  }
+  try {
+    const url = new URL(candidate, window.location.origin);
+    return url.pathname;
+  } catch {
+    const index = candidate.indexOf('?');
+    return index === -1 ? candidate : candidate.slice(0, index);
+  }
+}
+function isPromise<T = unknown>(value: unknown): value is Promise<T> {
+  return !!value && typeof (value as PromiseLike<T>).then === 'function';
+}
+function withHistoryContext(context: HotModuleContext, record: HotModuleRecord): HotModuleContext {
+  if (!record.currentExports) {
+    return context;
+  }
+  return {
+    ...context,
+    previousExports: record.currentExports
+  };
+}
+async function evaluateHandlerResult(result: unknown): Promise<boolean> {
+  if (isPromise(result)) {
+    const resolved = await result;
+    return resolved !== false;
+  }
+  return result !== false;
+}
+// Lazy-load error handler on first error
+let errorHandlerLoaded = false;
+async function loadErrorHandler() {
+  if (errorHandlerLoaded) return;
+  errorHandlerLoaded = true;
+  try {
+    const { install } = await import('./error');
+    install();
+  } catch (e) {
+    console.error('Failed to load error handler:', e);
+  }
+}
+export function registerHotModule(moduleId: string, handlers: HotModuleHandlers): void {
+  const normalized = normalizeModuleId(moduleId);
+  if (!normalized) {
+    return;
+  }
+  const record = ensureRecord(normalized);
+  record.accept = handlers.accept;
+  record.dispose = handlers.dispose;
+  hotModuleRegistry.set(normalized, record);
+}
+window.__webstirRegisterHotModule = registerHotModule;
+window.__webstirDispose = async (asset, context) => {
+  const moduleId = normalizeModuleId(asset?.url ?? asset?.relativePath);
+  if (!moduleId) {
+    return true;
+  }
+  const record = hotModuleRegistry.get(moduleId);
+  if (!record) {
+    return true;
+  }
+  if (!record.dispose) {
+    return true;
+  }
+  const contextWithHistory = withHistoryContext(context, record);
+  try {
+    const result = record.dispose(contextWithHistory);
+    if (isPromise(result)) {
+      await result;
+    }
+    return true;
+  } catch (error) {
+    console.error(`[webstir-hmr] Dispose handler failed for ${moduleId}.`, error);
+    return false;
+  }
+};
+window.__webstirAccept = async (moduleExports, context) => {
+  const moduleId = normalizeModuleId(context?.asset?.url ?? context?.asset?.relativePath);
+  if (!moduleId) {
+    return true;
+  }
+  const record = ensureRecord(moduleId);
+  const contextWithHistory = withHistoryContext(context, record);
+  let accepted = true;
+  if (record.accept) {
+    try {
+      accepted = await evaluateHandlerResult(record.accept(moduleExports, contextWithHistory));
+    } catch (error) {
+      console.error(`[webstir-hmr] Accept handler failed for ${moduleId}.`, error);
+      accepted = false;
+    }
+  }
+  if (accepted) {
+    record.currentExports = moduleExports;
+  }
+  hotModuleRegistry.set(moduleId, record);
+  return accepted;
+};
+// Set up error listeners that will dynamically import the error handler
+window.addEventListener('error', async () => {
+  await loadErrorHandler();
+  // The installed handler will catch subsequent errors
+});
+window.addEventListener('unhandledrejection', async () => {
+  await loadErrorHandler();
+  // The installed handler will catch subsequent rejections
+});
+// Export for use by pages if needed
+export { loadErrorHandler };

package/assets/templates/full/src/frontend/app/error.ts ADDED Viewed

@@ -0,0 +1,127 @@
+// Global client-side error reporter (TypeScript)
+let lastSentAt = 0;
+let sentCount = 0;
+const MAX_PER_SESSION = 20;
+const MIN_INTERVAL_MS = 1000;
+const DEDUPE_WINDOW_MS = 60_000; // 60s
+const recent = new Map<string, number>(); // fingerprint -> timestamp
+function cid(): string {
+  const w = window as any;
+  if (!w.__WEBSTIR_CID__) {
+    w.__WEBSTIR_CID__ = 'c-' + Math.random().toString(36).slice(2) + Date.now().toString(36);
+  }
+  return String(w.__WEBSTIR_CID__);
+}
+type Payload = {
+  type: 'error' | 'unhandledrejection';
+  message: string;
+  stack: string;
+  filename: string;
+  lineno: number;
+  colno: number;
+  pageUrl: string;
+  userAgent: string;
+  timestamp: string;
+  correlationId: string;
+};
+function toPayload(e: ErrorEvent | PromiseRejectionEvent): Payload {
+  const isRejection = !!e && e.type === 'unhandledrejection';
+  const reason: any = isRejection ? ((e as PromiseRejectionEvent).reason || {}) : {};
+  const err: any = (e as ErrorEvent)?.error || reason || {};
+  const message = (e as ErrorEvent)?.message || reason.message || err?.message || 'Unknown error';
+  const stack = String(err?.stack || reason.stack || '');
+  const filename = String((e as ErrorEvent)?.filename || '');
+  const lineno = Number((e as ErrorEvent)?.lineno || 0);
+  const colno = Number((e as ErrorEvent)?.colno || 0);
+  return {
+    type: isRejection ? 'unhandledrejection' : 'error',
+    message: String(message || ''),
+    stack,
+    filename,
+    lineno,
+    colno,
+    pageUrl: String(location.href),
+    userAgent: String(navigator.userAgent || ''),
+    timestamp: new Date().toISOString(),
+    correlationId: cid(),
+  };
+}
+// Simple 32-bit FNV-1a
+function hash(str: string): string {
+  let h = 2166136261 >>> 0;
+  for (let i = 0; i < str.length; i++) {
+    h ^= str.charCodeAt(i);
+    h = (h + (h << 1) + (h << 4) + (h << 7) + (h << 8) + (h << 24)) >>> 0;
+  }
+  return h.toString(36);
+}
+function fingerprint(p: Payload): string {
+  return [
+    p.type || '',
+    p.message || '',
+    `${p.filename || ''}:${p.lineno || 0}:${p.colno || 0}`,
+    hash(p.stack || ''),
+  ].join('|');
+}
+function shouldSend(p: Payload): boolean {
+  const now = Date.now();
+  if (now - lastSentAt < MIN_INTERVAL_MS) return false;
+  if (sentCount >= MAX_PER_SESSION) return false;
+  const fp = fingerprint(p);
+  const last = recent.get(fp) || 0;
+  // prune old entries opportunistically
+  if (recent.size > 100) {
+    recent.forEach((ts, k) => {
+      if (now - ts > DEDUPE_WINDOW_MS) recent.delete(k);
+    });
+  }
+  if (now - last < DEDUPE_WINDOW_MS) return false;
+  recent.set(fp, now);
+  lastSentAt = now;
+  sentCount++;
+  return true;
+}
+export function report(e: ErrorEvent | PromiseRejectionEvent): void {
+  try {
+    const p = toPayload(e);
+    if (!shouldSend(p)) return;
+    const payload = JSON.stringify(p);
+    if (navigator.sendBeacon) {
+      const blob = new Blob([payload], { type: 'application/json' });
+      navigator.sendBeacon('/client-errors', blob);
+    } else {
+      fetch('/client-errors', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', 'X-Correlation-ID': cid() },
+        body: payload,
+        keepalive: true,
+      }).catch(() => { /* ignore */ });
+    }
+  } catch {
+    // ignore
+  }
+}
+export function install(): void {
+  const w = window as any;
+  if (w.__WEBSTIR_ERROR_HANDLER_INSTALLED__) return;
+  w.__WEBSTIR_ERROR_HANDLER_INSTALLED__ = true;
+  window.addEventListener('error', (e) => {
+    try { report(e); } catch { /* ignore */ }
+  });
+  window.addEventListener('unhandledrejection', (e) => {
+    try { report(e); } catch { /* ignore */ }
+  });
+}