scribe-cms 0.0.20 → 0.0.21

package/dist/src/create-project.d.ts

@@ -1,4 +1,5 @@
 import type { ScribeConfig, ScribeProject } from "./core/types.js";
+import { type InlineLinkStyle } from "./inline/resolve-tokens.js";
 /**
  * Create the untyped project engine (CLI, validation, studio).
  * Apps should use `createScribe()` for typed per-type accessors.
@@ -13,8 +14,13 @@ import type { ScribeConfig, ScribeProject } from "./core/types.js";
  *   the CLI, validation, and studio keep raw token syntax.
  * @internal
  */
-export declare function createProject(config: ScribeConfig, options?: {
+export interface CreateProjectOptions {
     resolveAssets?: boolean;
     resolveInlineTokens?: boolean;
-}): ScribeProject;
+    /** How `:href` relation tokens resolve. Default `"app"`. */
+    inlineLinkStyle?: InlineLinkStyle;
+    /** Extension for `:href` in `"export"` mode. Default `.md`. */
+    exportLinkExtension?: `.${string}`;
+}
+export declare function createProject(config: ScribeConfig, options?: CreateProjectOptions): ScribeProject;
 //# sourceMappingURL=create-project.d.ts.map

package/dist/src/create-project.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-project.d.ts","sourceRoot":"","sources":["../../src/create-project.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAKV,YAAY,EAEZ,aAAa,EAEd,MAAM,iBAAiB,CAAC;AA2MzB;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAC;IAAC,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAAO,GACvE,aAAa,CAuCf"}
+{"version":3,"file":"create-project.d.ts","sourceRoot":"","sources":["../../src/create-project.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAKV,YAAY,EAEZ,aAAa,EAEd,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAEL,KAAK,eAAe,EAErB,MAAM,4BAA4B,CAAC;AAwMpC;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,oBAAoB;IACnC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,4DAA4D;IAC5D,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,+DAA+D;IAC/D,mBAAmB,CAAC,EAAE,IAAI,MAAM,EAAE,CAAC;CACpC;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,oBAAyB,GACjC,aAAa,CA0Cf"}

package/dist/src/create-scribe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-scribe.d.ts","sourceRoot":"","sources":["../../src/create-scribe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,gBAAgB,EAEhB,MAAM,EACN,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AAOzB;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,CAAC,MAAM,SAAS,SAAS,gBAAgB,CAAC,GAAG,CAAC,EAAE,EAChF,KAAK,EAAE,iBAAiB,CAAC,MAAM,CAAC,GAC/B,MAAM,CAAC,MAAM,CAAC,CA+BhB"}
+{"version":3,"file":"create-scribe.d.ts","sourceRoot":"","sources":["../../src/create-scribe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,gBAAgB,EAEhB,MAAM,EACN,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AAOzB;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,CAAC,MAAM,SAAS,SAAS,gBAAgB,CAAC,GAAG,CAAC,EAAE,EAChF,KAAK,EAAE,iBAAiB,CAAC,MAAM,CAAC,GAC/B,MAAM,CAAC,MAAM,CAAC,CAmChB"}

package/dist/src/inline/resolve-tokens.d.ts

@@ -13,7 +13,15 @@ import { type InlineToken } from "./tokens.js";
 export interface InlineResolver {
     resolve(token: InlineToken, enFrontmatter: Record<string, unknown>, locale: string): string;
 }
-export declare function createInlineResolver(config: ScribeConfig): InlineResolver;
+/** How `:href` relation tokens resolve (see `docs/inline-tokens.md`). */
+export type InlineLinkStyle = "app" | "export";
+export interface CreateInlineResolverOptions {
+    /** Default `"app"` — locale-free pathnames for framework routers. */
+    linkStyle?: InlineLinkStyle;
+    /** File extension appended to localized slugs in `"export"` mode. Default `.md`. */
+    exportExtension?: `.${string}`;
+}
+export declare function createInlineResolver(config: ScribeConfig, options?: CreateInlineResolverOptions): InlineResolver;
 /**
  * Substitute inline tokens in an EN body at read time: extract tokens, resolve
  * each for the default locale, fill the placeholder markers, and unescape any

package/dist/src/inline/resolve-tokens.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-tokens.d.ts","sourceRoot":"","sources":["../../../src/inline/resolve-tokens.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAKrD,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,aAAa,CAAC;AAErB;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,CACL,KAAK,EAAE,WAAW,EAClB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,MAAM,EAAE,MAAM,GACb,MAAM,CAAC;CACX;AAWD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,cAAc,CA2EzE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,cAAc,GACvB,MAAM,CAKR;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,cAAc,GACvB,MAAM,CAKR"}
+{"version":3,"file":"resolve-tokens.d.ts","sourceRoot":"","sources":["../../../src/inline/resolve-tokens.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAKrD,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,aAAa,CAAC;AAErB;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,CACL,KAAK,EAAE,WAAW,EAClB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,MAAM,EAAE,MAAM,GACb,MAAM,CAAC;CACX;AAED,yEAAyE;AACzE,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE/C,MAAM,WAAW,2BAA2B;IAC1C,qEAAqE;IACrE,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,oFAAoF;IACpF,eAAe,CAAC,EAAE,IAAI,MAAM,EAAE,CAAC;CAChC;AAWD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,2BAAgC,GACxC,cAAc,CAgFhB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,cAAc,GACvB,MAAM,CAKR;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,cAAc,GACvB,MAAM,CAKR"}

package/dist/src/inline/tokens.d.ts

@@ -23,8 +23,8 @@ export interface RelationInlineToken {
     kind: "relation";
     targetTypeId: string;
     enSlug: string;
-    /** `"url"` resolves to the localized URL; `"slug"` resolves to the EN slug. */
-    mode: "url" | "slug";
+    /** `"href"` resolves to a link path; `"slug"` resolves to the EN slug. */
+    mode: "href" | "slug";
     raw: string;
 }
 export interface AssetInlineToken {

package/dist/src/inline/tokens.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../../src/inline/tokens.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAQH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,KAAK,CAAC;AAEtE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,QAAQ,CAAC;IACf,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,UAAU,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,KAAK,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,WAAW,GACnB,iBAAiB,GACjB,mBAAmB,GACnB,gBAAgB,GAChB,cAAc,CAAC;AAEnB,kFAAkF;AAClF,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,yBAAyB;IACxC,sEAAsE;IACtE,eAAe,EAAE,MAAM,CAAC;IACxB,yDAAyD;IACzD,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,uDAAuD;IACvD,SAAS,EAAE,oBAAoB,EAAE,CAAC;CACnC;AAED,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnD;AAyGD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,yBAAyB,CAyC3E;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,MAAM,CAK/E;AAED,iFAAiF;AACjF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IACJ,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9C,MAAM,EAAE,MAAM,MAAM,CAAC;CACtB,GACA,MAAM,CAuBR;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK3D"}
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../../src/inline/tokens.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAQH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,KAAK,CAAC;AAEtE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,QAAQ,CAAC;IACf,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,UAAU,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,KAAK,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,WAAW,GACnB,iBAAiB,GACjB,mBAAmB,GACnB,gBAAgB,GAChB,cAAc,CAAC;AAEnB,kFAAkF;AAClF,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,yBAAyB;IACxC,sEAAsE;IACtE,eAAe,EAAE,MAAM,CAAC;IACxB,yDAAyD;IACzD,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,uDAAuD;IACvD,SAAS,EAAE,oBAAoB,EAAE,CAAC;CACnC;AAED,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnD;AAyGD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,yBAAyB,CAyC3E;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,MAAM,CAK/E;AAED,iFAAiF;AACjF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IACJ,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9C,MAAM,EAAE,MAAM,MAAM,CAAC;CACtB,GACA,MAAM,CAuBR;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK3D"}

package/dist/studio/server.cjs

@@ -299,18 +299,18 @@ function parseTokenInner(inner) {
     }
     case "relation": {
       const parts = rest.split(":");
-      if (parts.length < 2 || parts.length > 3) {
+      if (parts.length !== 3) {
         return {
           ok: false,
-          reason: `relation must be relation:<typeId>:<enSlug> or relation:<typeId>:<enSlug>:slug`
+          reason: `relation must be relation:<typeId>:<enSlug>:href or relation:<typeId>:<enSlug>:slug`
         };
       }
       const [targetTypeId, enSlug, mode] = parts;
       if (!targetTypeId || !enSlug) {
         return { ok: false, reason: `relation is missing a typeId or enSlug` };
       }
-      if (mode !== void 0 && mode !== "slug") {
-        return { ok: false, reason: `relation mode must be "slug" (got "${mode}")` };
+      if (mode !== "href" && mode !== "slug") {
+        return { ok: false, reason: `relation mode must be "href" or "slug" (got "${mode}")` };
       }
       return {
         ok: true,
@@ -318,7 +318,7 @@ function parseTokenInner(inner) {
           kind: "relation",
           targetTypeId,
           enSlug,
-          mode: mode === "slug" ? "slug" : "url"
+          mode
         }
       };
     }
@@ -993,7 +993,9 @@ function isStringRecord(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) return false;
   return Object.values(value).every((v) => typeof v === "string");
 }
-function createInlineResolver(config) {
+function createInlineResolver(config, options = {}) {
+  const linkStyle = options.linkStyle ?? "app";
+  const exportExtension = options.exportExtension ?? ".md";
   const urlBuilder = createUrlBuilder(config);
   const typeById = new Map(config.types.map((t) => [t.id, t]));
   const storePath = resolveStorePath(config);
@@ -1054,7 +1056,10 @@ function createInlineResolver(config) {
           if (token.mode === "slug") return token.enSlug;
           if (!isRoutableType(type)) return "";
           const slug = localizedSlug(token.targetTypeId, token.enSlug, locale);
-          return urlBuilder.resolvePath(type.path, slug, locale);
+          if (linkStyle === "export") {
+            return urlBuilder.resolvePath(type.path, `${slug}${exportExtension}`, locale);
+          }
+          return type.path.replace("{slug}", slug);
         }
       }
     }
@@ -1654,7 +1659,10 @@ function createProject(config, options = {}) {
     }
     return runtime;
   };
-  const inlineResolver = options.resolveInlineTokens ? createInlineResolver(config) : void 0;
+  const inlineResolver = options.resolveInlineTokens ? createInlineResolver(config, {
+    linkStyle: options.inlineLinkStyle,
+    exportExtension: options.exportLinkExtension
+  }) : void 0;
   for (const type of config.types) {
     runtimes.set(
       type.id,
@@ -2305,7 +2313,7 @@ function validateInlineTokens(config) {
               });
               break;
             }
-            if (token.mode === "url") {
+            if (token.mode === "href") {
               const targetType = typeById.get(token.targetTypeId);
               if (!isRoutableType(targetType)) {
                 issues.push({