@timber-js/app 0.2.0-alpha.169 → 0.2.0-alpha.170

package/dist/server/metadata-routes.d.ts

@@ -34,8 +34,18 @@ export declare const METADATA_ROUTE_CONVENTIONS: Record<string, {
     nestable: boolean;
     staticExtensions: string[];
     dynamicExtensions: string[];
-    /** The URL path this file serves at (relative to segment). */
+    /**
+     * The URL path basename this file serves at (relative to segment).
+     * For image routes, the full serve path includes an extension via
+     * `resolveServePathForFile()`.
+     */
     servePath: string;
+    /**
+     * When set, image routes append `.{serveExtension}` to the serve path.
+     * Dynamic handlers (`.ts`/`.tsx`) use this as the default. Static files
+     * use their own extension instead. Non-image routes leave this undefined.
+     */
+    serveExtension?: string;
 }>;
 /**
  * Resolve the concrete MIME type for a static metadata route file.
@@ -72,10 +82,20 @@ export declare function isDynamicMetadataExtension(baseName: string, extension:
  */
 export declare function classifyMetadataRoute(fileName: string): MetadataRouteInfo | null;
 /**
- * Get the serve path for a metadata route type.
+ * Resolve the serve path for a metadata route file.
  *
- * @param type - The metadata route type
- * @returns The URL path fragment this route serves at
+ * For image routes (icon, opengraph-image, apple-icon), the serve path includes
+ * a file extension so CDNs cache correctly:
+ * - Dynamic handlers (.ts/.tsx) use the convention's `serveExtension` (default: .png)
+ * - Static files use their own extension (e.g., icon.svg → icon.svg)
+ *
+ * Non-image routes return the convention's `servePath` as-is (already includes
+ * extension: sitemap.xml, robots.txt, etc.).
+ */
+export declare function resolveServePathForFile(baseName: string, filePath: string): string;
+/**
+ * Get the default serve path for a metadata route type (using default extension
+ * for image routes). Used for auto-link generation when only the type is known.
  */
 export declare function getMetadataRouteServePath(type: MetadataRouteType): string;
 export declare function isMetadataRouteServePath(pathname: string): boolean;

package/dist/server/metadata-routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metadata-routes.d.ts","sourceRoot":"","sources":["../../src/server/metadata-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,+CAA+C;AAC/C,MAAM,WAAW,iBAAiB;IAChC,+BAA+B;IAC/B,IAAI,EAAE,iBAAiB,CAAC;IACxB,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,iBAAiB,GACzB,SAAS,GACT,QAAQ,GACR,UAAU,GACV,SAAS,GACT,MAAM,GACN,iBAAiB,GACjB,YAAY,CAAC;AAIjB;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAC7C,MAAM,EACN;IACE,IAAI,EAAE,iBAAiB,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;CACnB,CA2DF,CAAC;AAoBF;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,qBAAqB,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAKjG;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAItF;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAIvF;AAID;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAoBhF;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAKzE;AAMD,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGlE;AAED,8BAA8B;AAC9B,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,8BAA8B;AAC9B,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,YAAY,CAAC;AAEtD;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CAgB7F"}
+{"version":3,"file":"metadata-routes.d.ts","sourceRoot":"","sources":["../../src/server/metadata-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,+CAA+C;AAC/C,MAAM,WAAW,iBAAiB;IAChC,+BAA+B;IAC/B,IAAI,EAAE,iBAAiB,CAAC;IACxB,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,iBAAiB,GACzB,SAAS,GACT,QAAQ,GACR,UAAU,GACV,SAAS,GACT,MAAM,GACN,iBAAiB,GACjB,YAAY,CAAC;AAIjB;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAC7C,MAAM,EACN;IACE,IAAI,EAAE,iBAAiB,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CA8DF,CAAC;AAoBF;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,qBAAqB,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAKjG;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAItF;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAIvF;AAID;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAoBhF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWlF;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAUzE;AAiBD,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAalE;AAED,8BAA8B;AAC9B,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,8BAA8B;AAC9B,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,YAAY,CAAC;AAEtD;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CAgB7F"}

package/dist/server/pipeline-interception.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline-interception.d.ts","sourceRoot":"","sources":["../../src/server/pipeline-interception.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,iDAAiD;AACjD,MAAM,WAAW,uBAAuB;IACtC,yEAAyE;IACzE,cAAc,EAAE,MAAM,CAAC;CACxB;AAcD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,OAAO,4BAA4B,EAAE,mBAAmB,EAAE,GACnE,uBAAuB,GAAG,IAAI,CAahC;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAyBjF"}
+{"version":3,"file":"pipeline-interception.d.ts","sourceRoot":"","sources":["../../src/server/pipeline-interception.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,iDAAiD;AACjD,MAAM,WAAW,uBAAuB;IACtC,yEAAyE;IACzE,cAAc,EAAE,MAAM,CAAC;CACxB;AAcD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,OAAO,4BAA4B,EAAE,mBAAmB,EAAE,GACnE,uBAAuB,GAAG,IAAI,CAahC;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAsCjF"}

package/dist/server/pipeline-phases.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline-phases.d.ts","sourceRoot":"","sources":["../../src/server/pipeline-phases.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAoBH,OAAO,EAA2C,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEpG,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAKrF,UAAU,aAAa;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,mBAAmB,CAAC;CACpC;AAwBD;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,aAAa,EACvB,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,GAC7B,OAAO,CAAC,YAAY,CAAC,CAmBvB;AAID;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,UAAU,EACjB,eAAe,EAAE,OAAO,EACxB,oBAAoB,EAAE,OAAO,EAC7B,aAAa,EAAE,aAAa,GAC3B,OAAO,CAAC,YAAY,CAAC,CA6DvB;AAID;;;GAGG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,UAAU,EACjB,eAAe,EAAE,OAAO,EACxB,oBAAoB,EAAE,OAAO,EAC7B,EAAE,iBAAiB,EAAE,YAAY,EAAE,EAAE,aAAa,GACjD,OAAO,CAAC,YAAY,CAAC,CAkBvB;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,eAAe,CAAC,EAAE,OAAO,GACxB,OAAO,CAAC,QAAQ,CAAC,CA6SnB"}
+{"version":3,"file":"pipeline-phases.d.ts","sourceRoot":"","sources":["../../src/server/pipeline-phases.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAoBH,OAAO,EAA2C,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEpG,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAKrF,UAAU,aAAa;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,mBAAmB,CAAC;CACpC;AAwBD;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,aAAa,EACvB,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,GAC7B,OAAO,CAAC,YAAY,CAAC,CAmBvB;AAID;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,UAAU,EACjB,eAAe,EAAE,OAAO,EACxB,oBAAoB,EAAE,OAAO,EAC7B,aAAa,EAAE,aAAa,GAC3B,OAAO,CAAC,YAAY,CAAC,CA6DvB;AAID;;;GAGG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,UAAU,EACjB,eAAe,EAAE,OAAO,EACxB,oBAAoB,EAAE,OAAO,EAC7B,EAAE,iBAAiB,EAAE,YAAY,EAAE,EAAE,aAAa,GACjD,OAAO,CAAC,YAAY,CAAC,CAkBvB;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,eAAe,CAAC,EAAE,OAAO,GACxB,OAAO,CAAC,QAAQ,CAAC,CAmTnB"}

package/dist/server/route-element-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route-element-builder.d.ts","sourceRoot":"","sources":["../../src/server/route-element-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AA6B9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC,YAAY,CAW/E;AAwCD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAM7D;AAID;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAID,+CAA+C;AAC/C,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;IAC3C,OAAO,EAAE,mBAAmB,CAAC;CAC9B;AAED,+CAA+C;AAC/C,MAAM,WAAW,kBAAkB;IACjC,wFAAwF;IACxF,OAAO,EAAE,KAAK,CAAC,YAAY,CAAC;IAC5B,wDAAwD;IACxD,gBAAgB,EAAE,oBAAoB,EAAE,CAAC;IACzC,qCAAqC;IACrC,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,4DAA4D;IAC5D,gBAAgB,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AA8DD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,UAAU,EACjB,YAAY,CAAC,EAAE,mBAAmB,EAClC,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,EACpC,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3C,OAAO,CAAC,kBAAkB,CAAC,CAkjB7B"}
+{"version":3,"file":"route-element-builder.d.ts","sourceRoot":"","sources":["../../src/server/route-element-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAiC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC,YAAY,CAW/E;AAwCD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAM7D;AAID;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAID,+CAA+C;AAC/C,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;IAC3C,OAAO,EAAE,mBAAmB,CAAC;CAC9B;AAED,+CAA+C;AAC/C,MAAM,WAAW,kBAAkB;IACjC,wFAAwF;IACxF,OAAO,EAAE,KAAK,CAAC,YAAY,CAAC;IAC5B,wDAAwD;IACxD,gBAAgB,EAAE,oBAAoB,EAAE,CAAC;IACzC,qCAAqC;IACrC,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,4DAA4D;IAC5D,gBAAgB,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AA8DD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,UAAU,EACjB,YAAY,CAAC,EAAE,mBAAmB,EAClC,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,EACpC,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3C,OAAO,CAAC,kBAAkB,CAAC,CAujB7B"}

package/dist/server/route-matcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route-matcher.d.ts","sourceRoot":"","sources":["../../src/server/route-matcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,sBAAsB,CAAC;AAY9B,6DAA6D;AAC7D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;AAE5D;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAa,SAAQ,SAAS,CAAC,YAAY,CAAC;IAC3D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,YAAY,GACrB,CAAC,QAAQ,EAAE,MAAM,KAAK,UAAU,GAAG,IAAI,CAEzC;AAsCD,2CAA2C;AAC3C,MAAM,WAAW,kBAAkB;IACjC,4DAA4D;IAC5D,IAAI,EAAE,iBAAiB,CAAC;IACxB,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,IAAI,EAAE,YAAY,CAAC;IACnB,0DAA0D;IAC1D,OAAO,EAAE,mBAAmB,CAAC;IAC7B;;;OAGG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB,wEAAwE;IACxE,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;CAClD;AAQD;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,YAAY,GACrB,CAAC,QAAQ,EAAE,MAAM,KAAK,kBAAkB,GAAG,IAAI,CAEjD"}
+{"version":3,"file":"route-matcher.d.ts","sourceRoot":"","sources":["../../src/server/route-matcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAKL,KAAK,iBAAiB,EACvB,MAAM,sBAAsB,CAAC;AAY9B,6DAA6D;AAC7D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;AAE5D;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAa,SAAQ,SAAS,CAAC,YAAY,CAAC;IAC3D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,YAAY,GACrB,CAAC,QAAQ,EAAE,MAAM,KAAK,UAAU,GAAG,IAAI,CAEzC;AAsCD,2CAA2C;AAC3C,MAAM,WAAW,kBAAkB;IACjC,4DAA4D;IAC5D,IAAI,EAAE,iBAAiB,CAAC;IACxB,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,IAAI,EAAE,YAAY,CAAC;IACnB,0DAA0D;IAC1D,OAAO,EAAE,mBAAmB,CAAC;IAC7B;;;OAGG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB,wEAAwE;IACxE,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;CAClD;AAcD;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,YAAY,GACrB,CAAC,QAAQ,EAAE,MAAM,KAAK,kBAAkB,GAAG,IAAI,CAEjD"}

package/dist/server/sitemap-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sitemap-generator.d.ts","sourceRoot":"","sources":["../../src/server/sitemap-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIvD,kEAAkE;AAClE,MAAM,WAAW,aAAa;IAC5B,yDAAyD;IACzD,OAAO,EAAE,OAAO,CAAC;IACjB,uFAAuF;IACvF,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,4DAA4D;IAC5D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,qFAAqF;IACrF,SAAS,EAAE,OAAO,CAAC;IACnB,wDAAwD;IACxD,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CACjE;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE;IAClC,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEvC,oCAAoC;AACpC,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC;AAIpE,8DAA8D;AAC9D,eAAO,MAAM,gBAAgB,QAAS,CAAC;AAIvC;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,GAAG,YAAY,EAAE,CAI7F;AAwDD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE3D;AAID;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,YAAY,EAAE,EACtB,MAAM,EAAE,aAAa,EACrB,UAAU,CAAC,EAAE,YAAY,GACxB,OAAO,CAAC,YAAY,EAAE,CAAC,CAqDzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,GACxC,MAAM,GAAG,IAAI,CA0Cf;AAID;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,aAAa,EACrB,UAAU,CAAC,EAAE,YAAY,GACxB,OAAO,CAAC,aAAa,CAAC,CA+BxB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAGzD"}
+{"version":3,"file":"sitemap-generator.d.ts","sourceRoot":"","sources":["../../src/server/sitemap-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIvD,kEAAkE;AAClE,MAAM,WAAW,aAAa;IAC5B,yDAAyD;IACzD,OAAO,EAAE,OAAO,CAAC;IACjB,uFAAuF;IACvF,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,4DAA4D;IAC5D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,qFAAqF;IACrF,SAAS,EAAE,OAAO,CAAC;IACnB,wDAAwD;IACxD,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CACjE;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE;IAClC,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEvC,oCAAoC;AACpC,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC;AAIpE,8DAA8D;AAC9D,eAAO,MAAM,gBAAgB,QAAS,CAAC;AAIvC;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,GAAG,YAAY,EAAE,CAI7F;AAwDD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE3D;AAID;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,YAAY,EAAE,EACtB,MAAM,EAAE,aAAa,EACrB,UAAU,CAAC,EAAE,YAAY,GACxB,OAAO,CAAC,YAAY,EAAE,CAAC,CAqDzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,GACxC,MAAM,GAAG,IAAI,CA2Cf;AAID;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,aAAa,EACrB,UAAU,CAAC,EAAE,YAAY,GACxB,OAAO,CAAC,aAAa,CAAC,CA+BxB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAGzD"}

package/docs/more/01-advanced-routing.mdx

@@ -1,6 +1,6 @@
 ---
 title: 'Advanced Routing'
-description: 'Route groups, parallel routes (slots), intercepting routes, catch-all segments, and API routes.'
+description: 'Route groups, parallel routes (slots), intercepting routes, catch-all segments, affixed dynamic segments, and API routes.'
 slug: 'advanced-routing'
 ---
 
@@ -45,6 +45,40 @@ app/blog/page.tsx           # /blog (index)
 app/blog/[year]/page.tsx    # /blog/2024 (filtered)
 ```
 
+## Affixed Dynamic Segments
+
+Dynamic segments can have literal prefixes and/or suffixes:
+
+```
+app/
+  images/
+    [id].png/
+      route.ts             # /images/123.png → id = "123"
+  user-[name]/
+    page.tsx               # /user-alice → name = "alice"
+  img-[id].webp/
+    page.tsx               # /img-photo.webp → id = "photo"
+```
+
+This is useful for CDN-cacheable file-extension routes (e.g. image generation endpoints) and prefixed slugs. The literal parts must match exactly; the dynamic middle is extracted as the param value.
+
+**Rules:**
+- The param must be non-empty — `img-[id].png` does NOT match `img-.png`
+- One param per segment — `[foo]-[bar]` is not supported
+- Affixes cannot be used with catch-all (`[...slug].png`) or optional catch-all segments
+- Matching is greedy: `[id].png` matching `a.png.png` yields `id = "a.png"`
+- `params.ts` codecs use the bare param name (`id`), not the full segment pattern
+
+**Priority:** static → affixed dynamic → bare dynamic → catch-all → optional catch-all. A static `foo.png` always wins over `[id].png`.
+
+`<Link>` interpolates affixed segments automatically:
+
+```tsx
+<Link href="/images/[id].png" segmentParams={{ id: 'photo' }}>
+  {/* renders href="/images/photo.png" */}
+</Link>
+```
+
 ## Parallel Routes (Slots)
 
 Directories prefixed with `@` are slots — they render simultaneously within a parent layout:

package/docs/more/04-metadata-and-fonts.mdx

@@ -81,9 +81,9 @@ Special files in your route tree generate metadata endpoints:
 | `sitemap.ts`          | `/sitemap.xml`            |
 | `robots.ts`           | `/robots.txt`             |
 | `manifest.ts`         | `/manifest.json`          |
-| `opengraph-image.tsx` | `/opengraph-image` + auto `og:image` and `twitter:image` meta tags |
+| `opengraph-image.tsx` | `/opengraph-image.png` + auto `og:image` and `twitter:image` meta tags |
 | `favicon.ico` / `favicon.tsx` | `/favicon.ico`    |
-| `icon.tsx`            | `/icon` + auto `<link rel="icon">` |
+| `icon.tsx`            | `/icon.png` + auto `<link rel="icon">` |
 
 When `opengraph-image.tsx` exists in a segment, timber automatically emits both `<meta property="og:image">` and `<meta name="twitter:image">` in `<head>` — no need to declare them in your `metadata` export. The auto-linked URL includes a cache-busting hash so social platforms pick up changes on redeploy.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@timber-js/app",
-  "version": "0.2.0-alpha.169",
+  "version": "0.2.0-alpha.170",
   "description": "Vite-native React framework built for Servers and Serverless Platforms — correct HTTP semantics, real status codes, pages that work without JavaScript",
   "keywords": [
     "cloudflare-workers",
@@ -150,12 +150,6 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "copy-docs": "node scripts/copy-docs.js",
-    "build": "vite build --config vite.lib.config.ts && tsc --emitDeclarationOnly --project tsconfig.json --outDir dist && pnpm run copy-docs",
-    "typecheck": "tsgo --noEmit",
-    "prepublishOnly": "pnpm run build"
-  },
   "dependencies": {
     "@opentelemetry/api": "^1.9.1",
     "@opentelemetry/context-async-hooks": "^2.9.0",
@@ -202,5 +196,10 @@
   },
   "engines": {
     "node": ">=22.18.0"
+  },
+  "scripts": {
+    "copy-docs": "node scripts/copy-docs.js",
+    "build": "vite build --config vite.lib.config.ts && tsc --emitDeclarationOnly --project tsconfig.json --outDir dist && pnpm run copy-docs",
+    "typecheck": "tsgo --noEmit"
   }
-}
+}

package/src/cli-schema-sync.ts

@@ -12,6 +12,18 @@ import { scanRoutes } from './routing/scanner.js';
 import type { SegmentNode } from './routing/types.js';
 import { resolveAppDir } from './plugin-context.js';
 
+function toBracketKey(node: SegmentNode): string {
+  if (node.paramPrefix || node.paramSuffix) return `[${node.paramName}]`;
+  switch (node.segmentType) {
+    case 'catch-all':
+      return `[...${node.paramName}]`;
+    case 'optional-catch-all':
+      return `[[...${node.paramName}]]`;
+    default:
+      return `[${node.paramName}]`;
+  }
+}
+
 /**
  * Collect all unique bracket-keyed dynamic segment names from the route tree.
  * Returns entries like '[artistSlug]', '[...slug]', '[[...topic]]'.
@@ -25,8 +37,9 @@ export function collectDynamicSegments(appDir: string): string[] {
 
 function walkSegments(node: SegmentNode, segments: Set<string>): void {
   if (node.paramName) {
-    // Reconstruct bracket key from segmentName (already has brackets)
-    segments.add(node.segmentName);
+    // Use bare bracket form for schema keys — affixed segments like
+    // `img-[id].png` register as `[id]`, matching runtime codec lookup.
+    segments.add(toBracketKey(node));
   }
   for (const child of node.children) {
     walkSegments(child, segments);

package/src/client/link.tsx

@@ -264,7 +264,10 @@ function resolveSegment(
       }
       const codec = getLinkCodec(`[${seg.name}]`);
       const str = codec ? (codec.serialize(value) ?? String(value)) : String(value);
-      return encodeURIComponent(str);
+      const encoded = encodeURIComponent(str);
+      const prefix = seg.prefix ?? '';
+      const suffix = seg.suffix ?? '';
+      return prefix + encoded + suffix;
     }
   }
 }

package/src/routing/codegen.ts

@@ -111,7 +111,7 @@ function collectRoutes(
     const legacyFallback = ownParamsFile ? undefined : findLegacyParamsExport(node);
     params.push({
       name: node.paramName,
-      bracketName: node.segmentName,
+      bracketName: bracketNameForSegment(node),
       type: paramTypeForSegment(node.segmentType),
       // Codec chain populated at leaf time. We carry the per-segment
       // legacy fallback (if any) so leaf-time resolution can fall back
@@ -238,6 +238,18 @@ function dedupeRoutesByUrlPath(routes: RouteEntry[]): RouteEntry[] {
 /**
  * Determine the TypeScript type for a segment's param.
  */
+/**
+ * Derive the bracket key for schema/codegen lookup.
+ * For bare segments like `[id]` this is the segmentName itself.
+ * For affixed segments like `img-[id].png` this is `[id]` — the bare bracket form.
+ */
+function bracketNameForSegment(node: SegmentNode): string {
+  if (node.paramPrefix || node.paramSuffix) {
+    return `[${node.paramName}]`;
+  }
+  return node.segmentName;
+}
+
 function paramTypeForSegment(segmentType: string): ParamEntry['type'] {
   switch (segmentType) {
     case 'catch-all':

package/src/routing/link-codegen.ts

@@ -29,6 +29,7 @@ import {
   buildSchemaParamType,
   formatSearchParamsType,
 } from './codegen-shared.js';
+import { classifyUrlSegment } from './segment-classify.js';
 
 /** Shared Link base-props type literal used in every emitted call signature. */
 export const LINK_BASE_PROPS_TYPE =
@@ -44,19 +45,21 @@ export const LINK_BASE_PROPS_TYPE =
 export function buildResolvedPattern(route: RouteEntry): string | null {
   const parts = route.urlPath.split('/');
   const templateParts = parts.map((part) => {
-    if (part.startsWith('[[...') && part.endsWith(']]')) {
-      // eslint-disable-next-line no-template-curly-in-string -- codegen output
-      return '${string}';
-    }
-    if (part.startsWith('[...') && part.endsWith(']')) {
-      // eslint-disable-next-line no-template-curly-in-string -- codegen output
-      return '${string}';
-    }
-    if (part.startsWith('[') && part.endsWith(']')) {
-      // eslint-disable-next-line no-template-curly-in-string -- codegen output
-      return '${string}';
+    const seg = classifyUrlSegment(part);
+    switch (seg.kind) {
+      case 'catch-all':
+      case 'optional-catch-all':
+        // eslint-disable-next-line no-template-curly-in-string -- codegen output
+        return '${string}';
+      case 'dynamic': {
+        const prefix = seg.prefix ?? '';
+        const suffix = seg.suffix ?? '';
+        // eslint-disable-next-line no-template-curly-in-string -- codegen output
+        return `${prefix}\${string}${suffix}`;
+      }
+      default:
+        return part;
     }
-    return part;
   });
   return templateParts.join('/');
 }

package/src/routing/manifest-codegen.ts

@@ -88,6 +88,12 @@ export function generateManifestModule(tree: RouteTree, viteRoot: string): strin
     if (node.paramName) {
       parts.push(`${nextIndent}paramName: ${JSON.stringify(node.paramName)},`);
     }
+    if (node.paramPrefix) {
+      parts.push(`${nextIndent}paramPrefix: ${JSON.stringify(node.paramPrefix)},`);
+    }
+    if (node.paramSuffix) {
+      parts.push(`${nextIndent}paramSuffix: ${JSON.stringify(node.paramSuffix)},`);
+    }
 
     if (node.interceptionMarker) {
       parts.push(`${nextIndent}interceptionMarker: ${JSON.stringify(node.interceptionMarker)},`);

package/src/routing/scanner.ts

@@ -98,6 +98,10 @@ export function scanRoutes(appDir: string, config: ScannerConfig = {}): RouteTre
   // e.g., [id] in one route and [...id] in another
   validateUniqueBracketForms(tree.root);
 
+  // Validate: detect affixed dynamic siblings with equal specificity
+  // e.g., a-[id] and [slug]-b both have prefix+suffix length = 2
+  validateAffixedSiblingConflicts(tree.root);
+
   return tree;
 }
 
@@ -110,13 +114,17 @@ function createSegmentNode(
   urlPath: string,
   paramName?: string,
   interceptionMarker?: InterceptionMarker,
-  interceptedSegmentName?: string
+  interceptedSegmentName?: string,
+  paramPrefix?: string,
+  paramSuffix?: string
 ): SegmentNode {
   return {
     segmentName,
     segmentType,
     urlPath,
     paramName,
+    paramPrefix,
+    paramSuffix,
     interceptionMarker,
     interceptedSegmentName,
     children: [],
@@ -331,7 +339,14 @@ function scanChildren(dirPath: string, parentNode: SegmentNode, extSet: Set<stri
       );
     }
 
-    const { type, paramName, interceptionMarker, interceptedSegmentName } = classifySegment(entry);
+    const {
+      type,
+      paramName,
+      paramPrefix,
+      paramSuffix,
+      interceptionMarker,
+      interceptedSegmentName,
+    } = classifySegment(entry);
 
     // Skip private folders — underscore-prefixed dirs are excluded from routing
     if (type === 'private') continue;
@@ -343,7 +358,9 @@ function scanChildren(dirPath: string, parentNode: SegmentNode, extSet: Set<stri
       urlPath,
       paramName,
       interceptionMarker,
-      interceptedSegmentName
+      interceptedSegmentName,
+      paramPrefix,
+      paramSuffix
     );
 
     // Scan this segment's files
@@ -527,6 +544,71 @@ function collectBracketForms(
   }
 }
 
+/**
+ * Validate that no sibling affixed dynamic segments have equal specificity.
+ *
+ * Among affixed siblings, longer combined prefix+suffix length wins. When two
+ * siblings tie (same total affix length), the router would fall back to
+ * filesystem scan order — which is platform-dependent. This is a build error.
+ *
+ * Route groups are URL-transparent, so affixed segments inside different groups
+ * at the same level still conflict with each other.
+ *
+ * See design/07-routing.md §"Priority"
+ */
+function validateAffixedSiblingConflicts(node: SegmentNode): void {
+  const affixed = collectEffectiveAffixed(node);
+
+  if (affixed.length >= 2) {
+    const byLength = new Map<number, SegmentNode[]>();
+    for (const child of affixed) {
+      const len = (child.paramPrefix?.length ?? 0) + (child.paramSuffix?.length ?? 0);
+      const group = byLength.get(len);
+      if (group) {
+        group.push(child);
+      } else {
+        byLength.set(len, [child]);
+      }
+    }
+
+    for (const [, group] of byLength) {
+      if (group.length >= 2) {
+        throw new Error(
+          `Build error: ambiguous affixed dynamic siblings with equal specificity.\n` +
+            `  Parent: ${node.urlPath || '/'}\n` +
+            `  Segments: ${group.map((s) => s.segmentName).join(', ')}\n` +
+            `  Combined prefix+suffix length: ${(group[0]!.paramPrefix?.length ?? 0) + (group[0]!.paramSuffix?.length ?? 0)}\n` +
+            `The router cannot deterministically choose between these — filesystem scan order is platform-dependent.\n` +
+            `Rename one segment to give it a longer or shorter combined affix.`
+        );
+      }
+    }
+  }
+
+  for (const child of node.children) {
+    validateAffixedSiblingConflicts(child);
+  }
+  for (const slotNode of Object.values(node.slots)) {
+    validateAffixedSiblingConflicts(slotNode);
+  }
+}
+
+/**
+ * Collect affixed dynamic segments that are effective children of a node.
+ * Route groups are URL-transparent, so we look through them recursively.
+ */
+function collectEffectiveAffixed(node: SegmentNode): SegmentNode[] {
+  const result: SegmentNode[] = [];
+  for (const child of node.children) {
+    if (child.segmentType === 'dynamic' && (child.paramPrefix || child.paramSuffix)) {
+      result.push(child);
+    } else if (child.segmentType === 'group') {
+      result.push(...collectEffectiveAffixed(child));
+    }
+  }
+  return result;
+}
+
 /**
  * Find a fixed-extension file (proxy.ts) in a directory.
  */

package/src/routing/schema-validation.ts

@@ -33,7 +33,13 @@ function walkTree(node: SegmentNode, segments: Set<string>): void {
   if (node.paramName && node.segmentName) {
     const classified = classifyUrlSegment(node.segmentName);
     if (classified.kind !== 'static') {
-      segments.add(node.segmentName);
+      // Use bare bracket form for schema keys — affixed segments like
+      // `img-[id].png` register as `[id]`, matching runtime codec lookup.
+      if (classified.kind === 'dynamic' && (classified.prefix || classified.suffix)) {
+        segments.add(`[${classified.name}]`);
+      } else {
+        segments.add(node.segmentName);
+      }
     }
   }
   for (const child of node.children) {

package/src/routing/segment-classify.ts

@@ -27,7 +27,7 @@ import { INTERCEPTION_MARKERS } from './types.js';
 
 export type UrlSegment =
   | { kind: 'static'; value: string }
-  | { kind: 'dynamic'; name: string }
+  | { kind: 'dynamic'; name: string; prefix?: string; suffix?: string }
   | { kind: 'catch-all'; name: string }
   | { kind: 'optional-catch-all'; name: string };
 
@@ -35,27 +35,31 @@ export type UrlSegment =
  * Classify a URL path segment token.
  *
  * Walks the string left-to-right in one pass:
- *   1. If it doesn't start with '[', it's static.
+ *   1. Find the first '[' — characters before it are the prefix.
  *   2. Count opening brackets (1 or 2) to detect optional.
  *   3. Check for '...' to detect catch-all.
  *   4. Read the param name up to the closing bracket.
  *   5. Validate the expected closing sequence (']' or ']]').
- *   6. Reject if there are leftover characters after the close.
+ *   6. Characters after the close are the suffix.
+ *   7. Reject affixes on catch-all/optional-catch-all.
+ *   8. Reject affixes that contain '[' or ']' (no multi-param segments).
  *
  * Any structural violation → static (safe default).
  */
 export function classifyUrlSegment(token: string): UrlSegment {
   const len = token.length;
+  if (len === 0) return { kind: 'static', value: token };
 
-  // Must start with '[' to be dynamic
-  if (len === 0 || token[0] !== '[') {
-    return { kind: 'static', value: token };
-  }
+  // Find first '[' — characters before it are the prefix
+  const bracketStart = token.indexOf('[');
+  if (bracketStart === -1) return { kind: 'static', value: token };
 
-  let i = 1;
+  const prefix = token.slice(0, bracketStart);
+
+  let i = bracketStart + 1;
 
   // Check for optional: '[[...'
-  const optional = token[i] === '[';
+  const optional = i < len && token[i] === '[';
   if (optional) i++;
 
   // Check for catch-all: '...'
@@ -82,17 +86,41 @@ export function classifyUrlSegment(token: string): UrlSegment {
     i++;
   }
 
-  // Must be at end of string — no trailing characters
-  if (i !== len) {
+  const suffix = token.slice(i);
+
+  // Reject affixes containing brackets (no multi-param segments like [foo]-[bar])
+  if (suffix.includes('[') || suffix.includes(']')) {
     return { kind: 'static', value: token };
   }
+  if (prefix.includes(']')) {
+    return { kind: 'static', value: token };
+  }
+
+  const hasAffixes = prefix.length > 0 || suffix.length > 0;
 
-  if (optional && catchAll) return { kind: 'optional-catch-all', name };
-  if (catchAll) return { kind: 'catch-all', name };
+  if (optional && catchAll) {
+    // No affixes on optional catch-all
+    if (hasAffixes) return { kind: 'static', value: token };
+    return { kind: 'optional-catch-all', name };
+  }
+  if (catchAll) {
+    // No affixes on catch-all
+    if (hasAffixes) return { kind: 'static', value: token };
+    return { kind: 'catch-all', name };
+  }
   if (optional) {
     // '[[name]]' without '...' is malformed — not a valid segment syntax
     return { kind: 'static', value: token };
   }
+
+  if (hasAffixes) {
+    return {
+      kind: 'dynamic',
+      name,
+      prefix: prefix || undefined,
+      suffix: suffix || undefined,
+    };
+  }
   return { kind: 'dynamic', name };
 }
 
@@ -102,6 +130,8 @@ export function classifyUrlSegment(token: string): UrlSegment {
 export interface SegmentClassification {
   type: SegmentType;
   paramName?: string;
+  paramPrefix?: string;
+  paramSuffix?: string;
   interceptionMarker?: InterceptionMarker;
   interceptedSegmentName?: string;
 }
@@ -151,7 +181,12 @@ export function classifySegment(dirName: string): SegmentClassification {
   // Bracket-syntax segments: [param], [...param], [[...param]]
   const urlSeg = classifyUrlSegment(dirName);
   if (urlSeg.kind !== 'static') {
-    return { type: urlSeg.kind, paramName: urlSeg.name };
+    const result: SegmentClassification = { type: urlSeg.kind, paramName: urlSeg.name };
+    if (urlSeg.kind === 'dynamic') {
+      if (urlSeg.prefix) result.paramPrefix = urlSeg.prefix;
+      if (urlSeg.suffix) result.paramSuffix = urlSeg.suffix;
+    }
+    return result;
   }
 
   return { type: 'static' };

package/src/routing/types.ts

@@ -76,6 +76,10 @@ export interface SegmentNode<TFile = RouteFile> {
   segmentType: SegmentType;
   /** The dynamic param name, if dynamic (e.g. "id" for "[id]", "slug" for "[...slug]") */
   paramName?: string;
+  /** Literal prefix before the dynamic bracket (e.g. "img-" for "img-[id].png") */
+  paramPrefix?: string;
+  /** Literal suffix after the dynamic bracket (e.g. ".png" for "img-[id].png") */
+  paramSuffix?: string;
   /** The URL path prefix at this segment level (e.g. "/dashboard") */
   urlPath: string;
   /** For intercepting segments: the marker used, e.g. "(.)". */