@warpgogol/werkstatt-shared 0.14.0 → 0.15.0

package/src/integration/port-barrel.ts

@@ -1,105 +0,0 @@
-/*
-<MODULE_CONTRACT>
-<purpose>
-  RFC-0168: Integration Port barrel — types and pure contracts only. Re-exports from
-  port.ts, funnel.ts, lifecycle.ts, sharding.ts, dispatch.ts, and qstash.ts.
-  Type-only consumers import from here to avoid transitively pulling in adapter
-  implementations (orchestration.ts → adapters.ts).
-</purpose>
-<non-goals>
-  <item>Do not re-export orchestration.ts, delivery-handler.ts, or adapters.ts — those are runtime.</item>
-  <item>Do not define logic here — pure re-export barrel.</item>
-</non-goals>
-</MODULE_CONTRACT>
-<CHANGE_SUMMARY>
-  <item>Architecture review: split from index.ts so type-only consumers don't transitively import adapter implementations.</item>
-</CHANGE_SUMMARY>
-*/
-
-export type { IntegrationSecrets } from "./port.ts";
-export type { LeadMessage, Lead, IntegrationChannelAdapter, CrmAdapter } from "./port.ts";
-export type { IntegrationEvent, DestinationAdapter } from "./port.ts";
-export { DESTINATION_KINDS, EXECUTION_MODES, eventToLeadMessage, eventToLead } from "./port.ts";
-export type { DestinationKind, ExecutionMode } from "./port.ts";
-
-export type {
-  VisitorFunnelEventPayload,
-  FunnelSystemTrigger,
-  FunnelTransitionTrigger,
-} from "./funnel.ts";
-export {
-  FUNNEL_VERSION,
-  VISITOR_FUNNEL_STAGES,
-  FUNNEL_ENTRY_STAGE,
-  FUNNEL_TERMINAL_STAGES,
-  VISITOR_FUNNEL_EVENT_KINDS,
-  VISITOR_FUNNEL_INTENTS,
-  VISITOR_FUNNEL_SOURCES,
-  VISITOR_BUYER_TYPES,
-  FUNNEL_TRANSITIONS,
-  isValidFunnelStage,
-  BUFFER_DEAL_STAGES,
-  FUNNEL_STAGE_TO_BUFFER_STAGE,
-  bridgeFunnelStage,
-  SYNC_OUTBOX_STATUSES,
-  SYNC_OUTBOX_OPS,
-  canTransition,
-  nextStages,
-  reachableStages,
-  FUNNEL_SYSTEM_TRIGGERS,
-  FUNNEL_TRANSITION_TRIGGERS,
-  LEGACY_FUNNEL_STAGES,
-  scanForMakeComReferences,
-} from "./funnel.ts";
-export type {
-  VisitorFunnelStage,
-  VisitorFunnelEventKind,
-  VisitorFunnelIntent,
-  VisitorFunnelSource,
-  VisitorBuyerType,
-  BufferDealStage,
-  SyncOutboxStatus,
-  SyncOutboxOp,
-} from "./funnel.ts";
-
-export type { LifecycleEventPayload } from "./lifecycle.ts";
-export {
-  LIFECYCLE_EVENT_KINDS,
-  SUBSCRIPTION_STATUSES,
-  INVOICE_KINDS,
-  INVOICE_STATUSES,
-  SUBSCRIPTION_PLANS,
-  LifecycleEventPayloadSchema,
-  isLifecycleEventKind,
-  SUBSCRIPTION_TRANSITIONS,
-  SUBSCRIPTION_TRANSITION_TRIGGERS,
-} from "./lifecycle.ts";
-export type {
-  LifecycleEventKind,
-  SubscriptionStatus,
-  InvoiceKind,
-  InvoiceStatus,
-  SubscriptionPlan,
-} from "./lifecycle.ts";
-
-export type { ShardAssignment, ResolveShardOptions } from "./sharding.ts";
-export { DELIVERY_REGIONS, DELIVERY_TIERS, fnv1a, resolveShard } from "./sharding.ts";
-export type { DeliveryRegion, DeliveryTier } from "./sharding.ts";
-
-export type {
-  DispatchExecuteRequest,
-  DispatchExecuteResult,
-  DispatchNamespaceBinding,
-  DispatchOutcome,
-} from "./dispatch.ts";
-export { DISPATCH_ROUTE, executeDispatch, dispatchToTenant } from "./dispatch.ts";
-
-export type { QstashPublishConfig, IdempotencyLedger, RestRedisConfig } from "./qstash.ts";
-export {
-  QSTASH_EU_BASE,
-  UPSTASH_QSTASH_SECRETS,
-  UPSTASH_REDIS_SECRETS,
-  UPSTASH_DELIVERY_SECRETS,
-  buildQstashPublish,
-  restRedisLedger,
-} from "./qstash.ts";

package/src/share/content/index.ts

@@ -1,16 +0,0 @@
-/*
-<MODULE_CONTRACT>
-<purpose>Maintains packages/share/src/content/index.ts as an authored share content module so agents can evolve it without rediscovering local boundaries.</purpose>
-<non-goals>
-  <item>Do not introduce app-specific runtime composition or deployment behavior into this reusable package source file.</item>
-</non-goals>
-</MODULE_CONTRACT>
-<CHANGE_SUMMARY>
-  <item>RFC-0133: backfilled MODULE_MAP and CHANGE_SUMMARY markers for compass.validate compliance.</item>
-  <item>Removed dispatch.ts re-export (merged into entity-id.ts).</item>
-</CHANGE_SUMMARY>
-*/
-
-export * from "./entity-id.ts";
-export * from "./merge.ts";
-export * from "./resolve-field-path.ts";

package/src/share/content-discipline/index.ts

@@ -1,14 +0,0 @@
-/*
-<MODULE_CONTRACT>
-<purpose>Maintains packages/share/src/content-discipline/index.ts as an authored share authored module so agents can evolve it without rediscovering local boundaries.</purpose>
-<non-goals>
-  <item>Do not define validation logic here.</item>
-</non-goals>
-</MODULE_CONTRACT>
-<CHANGE_SUMMARY>
-  <item>Added barrel exports for content-discipline submodules.</item>
-</CHANGE_SUMMARY>
-*/
-
-export * from "./types.ts";
-export * from "./parsers.ts";

package/src/share/index.ts

@@ -1,86 +0,0 @@
-/*
-<MODULE_CONTRACT>
-<purpose>
-Deprecated compatibility barrel for @warpgogol/werkstatt-shared/share (RFC-0264). New code MUST
-import from the domain subpath instead — see the map in
-packages/share/AGENTS.md. This root barrel re-exports each subpath module
-unchanged (never new logic) so existing consumers keep working while they
-migrate. The `page` and `i18n` domains have completed their migration wave:
-their re-export blocks are deleted here — import them from
-`@warpgogol/werkstatt-shared/share/page` / `@warpgogol/werkstatt-shared/share/i18n`.
-</purpose>
-<non-goals>
-  <item>Do not add business logic here — keep as a pure re-export barrel.</item>
-  <item>Do not re-add the page or i18n domains — those are fully migrated; import the subpath directly.</item>
-</non-goals>
-</MODULE_CONTRACT>
-<CHANGE_SUMMARY>
-  <item>Initial barrel created alongside package extraction.</item>
-  <item>RFC-0264: split into subpath entry points. Root barrel shrunk to a deprecated compatibility surface; page and i18n domains fully migrated (root re-export blocks deleted, all consumers rewritten).</item>
-  <item>C6: image-utils.ts shim deleted; root barrel re-exports from @warpgogol/werkstatt-site/content-source directly. page-handler.ts shim deleted; export map points to resolve-route.ts.</item>
-</CHANGE_SUMMARY>
-*/
-
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/content" instead */
-export * from "./content/index.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/semantic" instead */
-export * from "./semantic/index.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/middleware" instead */
-export * from "./middleware/language-redirect.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/entitlement" instead */
-export * from "./entitlement.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/offer-capacity" instead */
-export * from "./offer-capacity.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/knowledge" instead */
-export * from "./knowledge/index.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/schemas" instead */
-export * from "./schemas/index.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/feature-policy" instead */
-export * from "./feature-policy.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/counter-utils" instead */
-export * from "./counter-utils.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/image-provider" instead */
-export * from "./image-provider.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/runtime-context" instead */
-export { EMPTY_RUNTIME_CONTEXT } from "./runtime-context.ts";
-export type { RuntimeContext } from "./runtime-context.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/visibility" instead */
-export * from "./visibility.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/wrap-inline-numbers" instead */
-export * from "./wrap-inline-numbers.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/text-normalize" instead */
-export * from "./text-normalize.ts";
-// dev-props-validator is NOT re-exported from the root barrel. It imports
-// node:fs/promises and @warpgogol/werkstatt-shared/ontology/schemas (which also imports node:fs),
-// so re-exporting it here pulls Node-only modules into the Vite client bundle.
-// The sole consumer (resolve-route.ts) imports it via relative path.
-// Import from "@warpgogol/werkstatt-shared/share/dev-props-validator" subpath directly if needed.
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/rfc0042-utils" instead */
-export { need, cast, withDefault } from "./rfc0042-utils.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/shared-context" instead */
-export * from "./shared-context.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/content-discipline" instead */
-export * from "./content-discipline/types.ts";
-export * from "./content-discipline/parsers.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/legal" instead */
-export { resolveTranslationContext, TRANSLATION_STATUSES } from "./legal/translation-policy.ts";
-export type {
-  TranslationStatus,
-  PageTranslationPolicy,
-  ResolvedTranslationContext,
-} from "./legal/translation-policy.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/material-credits" instead */
-export {
-  parseMaterialCreditMap,
-  findMaterialCredit,
-  creditByTarget,
-  buildMaterialCreditJsonLd,
-  langFromCreditPath,
-} from "./material-credits.ts";
-export type { MaterialCreditRecord, RawMaterialCreditMap } from "./material-credits.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/attribution-display" instead */
-export * from "./attribution-display.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/string-utils" instead */
-export { toKebabCase } from "./string-utils.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/css-value-normalize" instead */
-export { normalizeCssValue } from "./css-value-normalize.ts";

package/src/share/legal/index.ts

@@ -1 +0,0 @@
-export * from "./translation-policy.ts";

package/src/share/redirects.ts

@@ -1,54 +0,0 @@
-/*
-<MODULE_CONTRACT>
-<purpose>App-agnostic _redirects file parsing for reuse across site-kernel-checks and site-kernel-handoff (RFC-0588).</purpose>
-<non-goals>
-  <item>Do not handle advanced Cloudflare Pages syntax (query parameters, placeholders) — only whitespace-delimited `from to status` lines.</item>
-  <item>Do not perform glob-to-regex conversion — that is the consumer's responsibility.</item>
-</non-goals>
-</MODULE_CONTRACT>
-<CHANGE_SUMMARY>
-  <item>RFC-0588: extracted parseRedirectRules and RedirectRule from site-kernel-checks/managed-public.ts into @warpgogol/werkstatt-shared/share/redirects subpath.</item>
-  <item>RFC-0595: add extractRedirectTarget helper for parsing url= from meta-refresh tags.</item>
-</CHANGE_SUMMARY>
-*/
-
-export type RedirectRule = {
-  from: string;
-  to: string | undefined;
-  status: number;
-  line: string;
-};
-
-export function parseRedirectRules(body: string): RedirectRule[] {
-  return body
-    .split(/\r?\n/)
-    .map((line) => line.trim())
-    .filter((line) => line && !line.startsWith("#"))
-    .map((line) => {
-      const [from, to, statusRaw] = line.split(/\s+/);
-      return {
-        from: from ?? "",
-        to,
-        status: Number(statusRaw ?? 301),
-        line,
-      };
-    })
-    .filter((rule) => rule.from.length > 0);
-}
-
-/**
- * Extract the redirect target URL from a `<meta http-equiv="refresh" content="0;url=...">` tag.
- * Returns the immediate target only (first hop). Returns null if the tag is
- * absent or the url= value cannot be parsed.
- */
-export function extractRedirectTarget(html: string): string | null {
-  const m = html.match(
-    /<meta[^>]+http-equiv=["']refresh["'][^>]*content=["']\s*\d+\s*;\s*url=([^"']+)['"][^>]*>/i,
-  );
-  if (m?.[1]) return m[1].trim();
-  const m2 = html.match(
-    /<meta[^>]+content=["']\s*\d+\s*;\s*url=([^"']+)['"][^>]*http-equiv=["']refresh["'][^>]*>/i,
-  );
-  if (m2?.[1]) return m2[1].trim();
-  return null;
-}

package/src/share/scripts/index.ts

@@ -1,26 +0,0 @@
-/* 
-<MODULE_CONTRACT> 
-<purpose>Serves as a central export point for various script modules utilized in dynamic loading contexts.</purpose> 
- 
- 
-<non-goals> 
-<item>Do not define new modules or components.</item> 
-<item>Do not manage application state or business logic.</item> 
-</non-goals> 
-</MODULE_CONTRACT> 
- 
-<CHANGE_SUMMARY>
-  <item>Added Compass scaffolding to clarify module roles and prevent scope creep.</item>
-</CHANGE_SUMMARY> 
-*/
-
-// scheduler.ts is loaded dynamically by orchestrator.ts and lordicon.ts
-export * from "./lordicon.ts";
-export * from "./external-links.ts";
-export * from "./external-link-qr.ts";
-export * from "./lenis.ts";
-export * from "./orchestrator.ts";
-// gsap-counter.ts (RFC-0040) is loaded dynamically by orchestrator.ts
-// inline-number-animation.ts (RFC-0041) is loaded dynamically by orchestrator.ts
-// gsap-reveal.ts / gsap-parallax.ts / gsap-stagger.ts (RFC-0106) are loaded
-// dynamically by orchestrator.ts via the reveal / parallax / stagger opt-ins.

package/src/share/semantic/jsonld/shared.ts

@@ -1,31 +0,0 @@
-/*
-<MODULE_CONTRACT>
-<purpose>Maintains packages/share/src/semantic/jsonld/shared.ts as an authored share authored module so agents can evolve it without rediscovering local boundaries.</purpose>
-<non-goals>
-  <item>Do not modify node structure.</item>
-</non-goals>
-</MODULE_CONTRACT>
-<CHANGE_SUMMARY>
-  <item>Added graph deduplication utility keyed by @id.</item>
-</CHANGE_SUMMARY>
-*/
-
-import type { JsonLdNode } from "./types.ts";
-
-export function dedupeGraph(nodes: JsonLdNode[]): JsonLdNode[] {
-  const seenIds = new Set<string>();
-
-  return nodes.filter((node) => {
-    const nodeId = typeof node["@id"] === "string" ? node["@id"] : null;
-    if (!nodeId) {
-      return true;
-    }
-
-    if (seenIds.has(nodeId)) {
-      return false;
-    }
-
-    seenIds.add(nodeId);
-    return true;
-  });
-}

package/src/share/semantic/jsonld/types.ts

@@ -1,18 +0,0 @@
-/*
-<MODULE_CONTRACT>
-<purpose>Maintains packages/share/src/semantic/jsonld/types.ts as an authored share authored module so agents can evolve it without rediscovering local boundaries.</purpose>
-<non-goals>
-  <item>Do not implement JSON-LD processing logic.</item>
-</non-goals>
-</MODULE_CONTRACT>
-<CHANGE_SUMMARY>
-  <item>Moved from app semantic/jsonld/types to packages/share.</item>
-</CHANGE_SUMMARY>
-*/
-
-export type JsonLdNode = Record<string, unknown>;
-
-export type JsonLdDocument = {
-  "@context": "https://schema.org";
-  "@graph": JsonLdNode[];
-};

package/src/share/semantic/jsonld/website.ts

@@ -1,27 +0,0 @@
-/*
-<MODULE_CONTRACT>
-<purpose>Maintains packages/share/src/semantic/jsonld/website.ts as an authored share authored module so agents can evolve it without rediscovering local boundaries.</purpose>
-<non-goals>
-  <item>Do not parse raw content.</item>
-</non-goals>
-</MODULE_CONTRACT>
-<CHANGE_SUMMARY>
-  <item>Added WebSite JSON-LD generation.</item>
-</CHANGE_SUMMARY>
-*/
-
-import type { JsonLdContext } from "./context.ts";
-import type { JsonLdNode } from "./types.ts";
-
-export function buildWebSiteNode(context: JsonLdContext): JsonLdNode {
-  const { page, ids } = context;
-
-  return {
-    "@type": "WebSite",
-    "@id": ids.website,
-    url: page.organization.url,
-    name: page.organization.name,
-    inLanguage: page.lang,
-    publisher: { "@id": ids.organization },
-  };
-}

package/src/share/string-utils.ts

@@ -1,19 +0,0 @@
-/*
-<MODULE_CONTRACT>
-<purpose>Maintains packages/share/src/string-utils.ts as an authored share authored module so agents can evolve it without rediscovering local boundaries.</purpose>
-<non-goals>
-  <item>Do not introduce app-specific runtime composition or deployment behavior into this reusable package source file.</item>
-</non-goals>
-</MODULE_CONTRACT>
-<CHANGE_SUMMARY>
-  <item>Dedup: centralise the kebab-case helper previously duplicated in site-kernel and site-kernel-checks.</item>
-</CHANGE_SUMMARY>
-*/
-
-/** Lowercase, dash-only kebab-case. Strips leading/trailing hyphens. */
-export function toKebabCase(value: string): string {
-  return value
-    .toLowerCase()
-    .replace(/[^a-z0-9]+/g, "-")
-    .replace(/^-+|-+$/g, "");
-}

package/src/share/types/axiom-study.d.ts

@@ -1,22 +0,0 @@
-declare module "@syrokomskyi/axiom-study" {
-  export interface Finding {
-    findingId: string;
-    semanticFingerprint: { algorithm: "sha256"; digest: string; size: number; mediaType: string };
-    methodologyId: string;
-    ruleId: string;
-    affectedSubjectId: string;
-    title: string;
-    severity: "info" | "low" | "medium" | "high" | "critical";
-    evidence: Array<{
-      evidenceRef: {
-        artifactId: string;
-        rootDigest: { algorithm: "sha256"; digest: string; size: number; mediaType: string };
-        schema: string;
-      };
-      selector: string;
-      evidenceClass: string;
-    }>;
-    uncertainty: unknown[];
-    extension: Record<string, unknown>;
-  }
-}

package/src/share/types/hls-js-light.d.ts

@@ -1,16 +0,0 @@
-/*
-<MODULE_CONTRACT>
-<purpose>Type shim for the official `hls.js/light` export used by the lazy feature-video runtime.</purpose>
-<non-goals>
-  <item>Do not change runtime resolution; this file only fills the missing package declaration.</item>
-</non-goals>
-</MODULE_CONTRACT>
-<CHANGE_SUMMARY>
-  <item>Use the hls.js light runtime without losing TypeScript strictness.</item>
-</CHANGE_SUMMARY>
-*/
-
-declare module "hls.js/light" {
-  export { default } from "hls.js";
-  export * from "hls.js";
-}

package/src/share/types/qrcode-browser.d.ts

@@ -1,18 +0,0 @@
-/*
-<MODULE_CONTRACT>
-<purpose>Type shim for the qrcode browser entry point (qrcode/lib/browser.js).
-The qrcode package only ships types for its main entry, but the browser entry
-exports the same toCanvas function. This shim re-exports all types from qrcode
-so the client-side QR code script gets full type safety.</purpose>
-<non-goals>
-  <item>Do not change runtime resolution; this file only fills the missing package declaration.</item>
-</non-goals>
-</MODULE_CONTRACT>
-<CHANGE_SUMMARY>
-  <item>Add type declaration for qrcode/lib/browser.js deep import used by external-link-qr.ts.</item>
-</CHANGE_SUMMARY>
-*/
-
-declare module "qrcode/lib/browser.js" {
-  export * from "qrcode";
-}

package/src/share/utility-registry.yaml

@@ -1,36 +0,0 @@
-utilities:
-  - id: slug
-    canonicalPath: packages/werkstatt-shared/src/share/slug/
-    forbiddenImports:
-      - "@sindresorhus/slugify"
-      - cyrillic-to-translit-js
-      - github-slugger
-    functionNames:
-      - slugify
-      - toSlug
-      - makeSlug
-      - createSlug
-      - slugUrl
-      - slugId
-    patterns:
-      - id: nkfd-diacritic-strip
-        regex: "\\.normalize\\(.{0,5}NFKD.{0,5}\\)\\.replace"
-        description: NFKD normalize + diacritic strip + non-alphanumeric replace (legacy custom slugify pattern)
-    allowlist:
-      - path: packages/werkstatt-shared/src/share/slug/
-        reason: Canonical slug module — owns all slug generation logic (RFC-0915, DNA-88)
-      - path: packages/werkstatt-shared/src/share/semantic/extract.ts
-        reason: CHANGE_SUMMARY comment references slugify removal — no function definition remains
-      - path: packages/werkstatt-site/src/checks/tests/utility-provenance.test.ts
-        reason: Test file intentionally contains forbidden patterns to validate the provenance validator (RFC-0916)
-      - path: packages/werkstatt-site/src/checks/utility-provenance.ts
-        reason: Validator implementation references forbidden imports/function names in string literals for detection logic (RFC-0916)
-  - id: template-filter
-    canonicalPath: packages/werkstatt-shared/src/share/routes/
-    forbiddenImports: []
-    functionNames:
-      - hasPlaceholderRoutes
-    patterns: []
-    allowlist:
-      - path: packages/werkstatt-shared/src/share/routes/
-        reason: Canonical placeholder route filter — owns all template detection logic (RFC-0917)

package/src/share/vitest.config.ts

@@ -1,8 +0,0 @@
-import { defineConfig } from "vitest/config";
-
-export default defineConfig({
-  test: {
-    environment: "node",
-    include: ["src/**/*.test.ts"],
-  },
-});