gorsee 0.2.13 → 0.2.14

package/dist-pkg/cli/canonical-import-rewrite.js

@@ -1,11 +1,11 @@
 import { readFile, readdir, stat, writeFile } from "node:fs/promises";
 import { join, relative } from "node:path";
-import { CLIENT_SCOPED_IMPORTS, SERVER_SCOPED_IMPORTS } from "./canonical-imports.js";
-const IMPORT_RE = /import\s*\{([\s\S]*?)\}\s*from\s*(["'])(gorsee\/(?:server|client))\2/g;
+import { CLIENT_SCOPED_IMPORTS, ROOT_SCOPED_IMPORTS, SERVER_SCOPED_IMPORTS } from "./canonical-imports.js";
+const IMPORT_RE = /import\s*\{([\s\S]*?)\}\s*from\s*(["'])(gorsee(?:\/(?:server|client))?)\2/g;
 export function rewriteCanonicalImports(source) {
   let changed = !1;
   const rewritten = source.replace(IMPORT_RE, (statement, bindings, _quote, specifier) => {
-    const scopedMap = specifier === "gorsee/server" ? SERVER_SCOPED_IMPORTS : CLIENT_SCOPED_IMPORTS, parsed = parseBindings(bindings), kept = [], moved = new Map;
+    const scopedMap = specifier === "gorsee" ? ROOT_SCOPED_IMPORTS : specifier === "gorsee/server" ? SERVER_SCOPED_IMPORTS : CLIENT_SCOPED_IMPORTS, parsed = parseBindings(bindings), kept = [], moved = new Map;
     for (const binding of parsed) {
       const target = scopedMap.get(binding.importedName);
       if (!target) {
@@ -21,7 +21,7 @@ export function rewriteCanonicalImports(source) {
     changed = !0;
     const rewrittenImports = [];
     if (kept.length > 0)
-      rewrittenImports.push(renderImport(specifier, kept));
+      rewrittenImports.push(renderImport(specifier === "gorsee" ? "gorsee/compat" : specifier, kept));
     for (const target of [...moved.keys()].sort())
       rewrittenImports.push(renderImport(target, moved.get(target) ?? []));
     return rewrittenImports.join(`

package/dist-pkg/cli/canonical-imports.d.ts

@@ -1,8 +1,9 @@
 import type { ModuleImportFact } from "../compiler/module-analysis.js";
 export declare const SERVER_SCOPED_IMPORTS: Map<string, string>;
 export declare const CLIENT_SCOPED_IMPORTS: Map<string, string>;
+export declare const ROOT_SCOPED_IMPORTS: Map<string, string>;
 export interface CanonicalImportDrift {
-    source: "gorsee/server" | "gorsee/client";
+    source: "gorsee" | "gorsee/server" | "gorsee/client";
     replacements: Map<string, string>;
 }
 export declare function collectCanonicalImportDrift(imports: ModuleImportFact[]): CanonicalImportDrift[];

package/dist-pkg/cli/canonical-imports.js

@@ -103,10 +103,104 @@ export const SERVER_SCOPED_IMPORTS = new Map([
   ["extractRouteParamKeys", "gorsee/routes"],
   ["TypedRouteDefinition", "gorsee/routes"],
   ["TypedRouteTarget", "gorsee/routes"]
+]), ROOT_SCOPED_IMPORTS = new Map([
+  ["createSignal", "gorsee/client"],
+  ["createComputed", "gorsee/client"],
+  ["createEffect", "gorsee/client"],
+  ["createResource", "gorsee/client"],
+  ["createDataQuery", "gorsee/client"],
+  ["createDataMutation", "gorsee/client"],
+  ["createStore", "gorsee/client"],
+  ["createLive", "gorsee/client"],
+  ["invalidateResource", "gorsee/client"],
+  ["invalidateAll", "gorsee/client"],
+  ["createMutation", "gorsee/client"],
+  ["Suspense", "gorsee/client"],
+  ["Link", "gorsee/client"],
+  ["Head", "gorsee/client"],
+  ["navigate", "gorsee/client"],
+  ["onNavigate", "gorsee/client"],
+  ["beforeNavigate", "gorsee/client"],
+  ["getCurrentPath", "gorsee/client"],
+  ["useFormAction", "gorsee/forms"],
+  ["FormActionResult", "gorsee/forms"],
+  ["FormState", "gorsee/forms"],
+  ["FormSubmitOptions", "gorsee/forms"],
+  ["Image", "gorsee/client"],
+  ["getImageProps", "gorsee/client"],
+  ["buildImageSrcSet", "gorsee/client"],
+  ["getImageCandidateWidths", "gorsee/client"],
+  ["isAllowedRemoteImage", "gorsee/client"],
+  ["defaultImageLoader", "gorsee/client"],
+  ["ImageProps", "gorsee/client"],
+  ["ImageLoader", "gorsee/client"],
+  ["ImageLoaderParams", "gorsee/client"],
+  ["ImageRuntimeConfig", "gorsee/client"],
+  ["ImageRemotePattern", "gorsee/client"],
+  ["ImageFormat", "gorsee/client"],
+  ["ErrorBoundary", "gorsee/client"],
+  ["island", "gorsee/client"],
+  ["createEventSource", "gorsee/client"],
+  ["setupI18n", "gorsee/i18n"],
+  ["loadLocale", "gorsee/i18n"],
+  ["getLocale", "gorsee/i18n"],
+  ["getLocales", "gorsee/i18n"],
+  ["getDefaultLocale", "gorsee/i18n"],
+  ["getFallbackLocales", "gorsee/i18n"],
+  ["setLocale", "gorsee/i18n"],
+  ["t", "gorsee/i18n"],
+  ["plural", "gorsee/i18n"],
+  ["negotiateLocale", "gorsee/i18n"],
+  ["resolveLocaleFromPath", "gorsee/i18n"],
+  ["stripLocalePrefix", "gorsee/i18n"],
+  ["withLocalePath", "gorsee/i18n"],
+  ["buildHreflangLinks", "gorsee/i18n"],
+  ["formatNumber", "gorsee/i18n"],
+  ["formatDate", "gorsee/i18n"],
+  ["formatRelativeTime", "gorsee/i18n"],
+  ["I18nConfig", "gorsee/i18n"],
+  ["LocaleNegotiationInput", "gorsee/i18n"],
+  ["LocaleNegotiationResult", "gorsee/i18n"],
+  ["typedLink", "gorsee/routes"],
+  ["typedNavigate", "gorsee/routes"],
+  ["typedPrefetch", "gorsee/routes"],
+  ["buildSearchParams", "gorsee/routes"],
+  ["buildTypedPath", "gorsee/routes"],
+  ["createTypedRoute", "gorsee/routes"],
+  ["extractRouteParamKeys", "gorsee/routes"],
+  ["defineForm", "gorsee/forms"],
+  ["defineFormAction", "gorsee/forms"],
+  ["validateForm", "gorsee/forms"],
+  ["validateAction", "gorsee/forms"],
+  ["toFieldErrors", "gorsee/forms"],
+  ["fieldAttrs", "gorsee/forms"],
+  ["FormField", "gorsee/forms"],
+  ["FormSchema", "gorsee/forms"],
+  ["ValidationResult", "gorsee/forms"],
+  ["ActionValidationResult", "gorsee/forms"],
+  ["ValidationError", "gorsee/forms"],
+  ["loadContentCollection", "gorsee/content"],
+  ["parseFrontmatter", "gorsee/content"],
+  ["extractExcerpt", "gorsee/content"],
+  ["queryContent", "gorsee/content"],
+  ["getContentEntryBySlug", "gorsee/content"],
+  ["ContentCollectionOptions", "gorsee/content"],
+  ["ContentEntry", "gorsee/content"],
+  ["ContentQueryOptions", "gorsee/content"],
+  ["createAuth", "gorsee/auth"],
+  ["definePlugin", "gorsee/plugins"],
+  ["createPluginRunner", "gorsee/plugins"],
+  ["GorseePlugin", "gorsee/plugins"],
+  ["PluginContext", "gorsee/plugins"]
 ]);
 export function collectCanonicalImportDrift(imports) {
   const drift = [];
   for (const entry of imports) {
+    if (entry.specifier === "gorsee") {
+      const replacements = collectScopedReplacements(entry, ROOT_SCOPED_IMPORTS);
+      if (replacements.size > 0)
+        drift.push({ source: "gorsee", replacements });
+    }
     if (entry.specifier === "gorsee/server") {
       const replacements = collectScopedReplacements(entry, SERVER_SCOPED_IMPORTS);
       if (replacements.size > 0)

package/dist-pkg/cli/cmd-check.js

@@ -350,10 +350,10 @@ function checkImportContracts(cwd, astFacts) {
     for (const drift of collectCanonicalImportDrift(facts.imports)) {
       const entries = [...drift.replacements.entries()].map(([name, target]) => `${name} -> ${target}`).join(", "), targets = [...new Set(drift.replacements.values())].join(", ");
       issues.push({
-        code: drift.source === "gorsee/server" ? "W914" : "W915",
+        code: drift.source === "gorsee" ? "W927" : drift.source === "gorsee/server" ? "W914" : "W915",
         file: rel,
-        message: `Domain APIs imported from "${drift.source}" should use scoped stable subpaths: ${entries}`,
-        fix: drift.source === "gorsee/server" ? `Keep runtime primitives on "gorsee/server" and move domain imports to scoped entrypoints such as ${targets}` : `Keep browser runtime primitives on "gorsee/client" and move domain imports to scoped entrypoints such as ${targets}`
+        message: drift.source === "gorsee" ? `Compatibility-root imports should move to canonical stable entrypoints: ${entries}` : `Domain APIs imported from "${drift.source}" should use scoped stable subpaths: ${entries}`,
+        fix: drift.source === "gorsee" ? `Split root imports across canonical stable entrypoints such as ${targets}, and keep "gorsee/compat" only for explicit legacy bridges` : drift.source === "gorsee/server" ? `Keep runtime primitives on "gorsee/server" and move domain imports to scoped entrypoints such as ${targets}` : `Keep browser runtime primitives on "gorsee/client" and move domain imports to scoped entrypoints such as ${targets}`
       });
     }
   }

package/dist-pkg/cli/cmd-upgrade.js

@@ -132,7 +132,7 @@ export async function collectUpgradeIssues(cwd) {
       issues.push(issue("UG008", relative(cwd, file), 'Compatibility-only root "gorsee" import is still used in application code', 'Move browser-safe imports to "gorsee/client", server code to "gorsee/server", or explicit compatibility bridges to "gorsee/compat"'));
     for (const drift of collectCanonicalImportDrift(facts.imports)) {
       const entries = [...drift.replacements.entries()].map(([name, target]) => `${name} -> ${target}`).join(", "), targets = [...new Set(drift.replacements.values())].join(", ");
-      issues.push(issue(drift.source === "gorsee/server" ? "UG009" : "UG010", relative(cwd, file), `Domain APIs still come from "${drift.source}" instead of scoped stable subpaths: ${entries}`, drift.source === "gorsee/server" ? `Keep runtime primitives on "gorsee/server" and move domain imports to ${targets}` : `Keep browser runtime primitives on "gorsee/client" and move domain imports to ${targets}`, "info"));
+      issues.push(issue(drift.source === "gorsee" ? "UG013" : drift.source === "gorsee/server" ? "UG009" : "UG010", relative(cwd, file), drift.source === "gorsee" ? `Compatibility-root imports still hide canonical stable entrypoints: ${entries}` : `Domain APIs still come from "${drift.source}" instead of scoped stable subpaths: ${entries}`, drift.source === "gorsee" ? `Split root imports across canonical stable entrypoints such as ${targets}, and keep "gorsee/compat" only where the import is intentionally compatibility-bound` : drift.source === "gorsee/server" ? `Keep runtime primitives on "gorsee/server" and move domain imports to ${targets}` : `Keep browser runtime primitives on "gorsee/client" and move domain imports to ${targets}`, "info"));
     }
     if (facts.exportedNames.has("loader"))
       issues.push(issue("UG011", relative(cwd, file), 'Route module still exports "loader" instead of canonical "load"', 'Rename exported "loader" to "load", or run `gorsee upgrade` to rewrite obvious cases automatically', "info"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gorsee",
-  "version": "0.2.13",
+  "version": "0.2.14",
   "description": "AI-first reactive full-stack TypeScript framework for deterministic human and agent collaboration",
   "type": "module",
   "packageManager": "bun@1.3.9",