@ressjs/assets 0.6.0-experimental.0

package/dist/catalog.d.ts

@@ -0,0 +1,16 @@
+import { type PlatformRegistry } from '@ressjs/platform';
+import type { AssetVariant } from './types';
+/**
+ * Formatos de estilos soportados, en orden de precedencia.
+ *
+ * Es una capacidad cerrada del pipeline, no una política configurable del
+ * proyecto. Agregar un formato implica implementarlo y probarlo en Ress.
+ */
+export declare const SUPPORTED_STYLE_EXTENSIONS: readonly ["css", "scss", "sass", "less", "styl"];
+/**
+ * Descubre las variantes de una hoja sin conocer nada del router.
+ *
+ * Si existen dos formatos para el mismo sufijo, gana el primero de esta lista
+ * (CSS antes que SCSS). Así el resultado no depende del orden del filesystem.
+ */
+export declare function discoverStyleVariants(base: string, registry?: PlatformRegistry): Promise<AssetVariant[]>;

package/dist/catalog.js

@@ -0,0 +1,57 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SUPPORTED_STYLE_EXTENSIONS = void 0;
+exports.discoverStyleVariants = discoverStyleVariants;
+const fast_glob_1 = __importDefault(require("fast-glob"));
+const platform_1 = require("@ressjs/platform");
+/**
+ * Formatos de estilos soportados, en orden de precedencia.
+ *
+ * Es una capacidad cerrada del pipeline, no una política configurable del
+ * proyecto. Agregar un formato implica implementarlo y probarlo en Ress.
+ */
+exports.SUPPORTED_STYLE_EXTENSIONS = Object.freeze(['css', 'scss', 'sass', 'less', 'styl']);
+/**
+ * Descubre las variantes de una hoja sin conocer nada del router.
+ *
+ * Si existen dos formatos para el mismo sufijo, gana el primero de esta lista
+ * (CSS antes que SCSS). Así el resultado no depende del orden del filesystem.
+ */
+async function discoverStyleVariants(base, registry = platform_1.defaultPlatformRegistry) {
+    const files = await (0, fast_glob_1.default)(exports.SUPPORTED_STYLE_EXTENSIONS.flatMap((ext) => [`${base}.${ext}`, `${base}.*.${ext}`]), { absolute: false });
+    const priority = new Map(exports.SUPPORTED_STYLE_EXTENSIONS.map((ext, index) => [ext, index]));
+    const ordered = files.sort((a, b) => {
+        const extA = extensionOf(a);
+        const extB = extensionOf(b);
+        return (priority.get(extA) ?? Number.MAX_SAFE_INTEGER) - (priority.get(extB) ?? Number.MAX_SAFE_INTEGER) || a.localeCompare(b);
+    });
+    const variants = new Map();
+    for (const file of ordered) {
+        const suffix = variantSuffixOf(file, base);
+        if (variants.has(suffix))
+            continue;
+        variants.set(suffix, {
+            suffix,
+            tags: (0, platform_1.parseVariantSuffix)(suffix, registry, file),
+            // El catálogo es portable y apto para diagnóstico: conserva la ruta
+            // relativa al proyecto. El consumidor que necesite una ruta absoluta
+            // (por ejemplo Vite al generar un import virtual) la resuelve en su
+            // propio límite.
+            sourceFile: file.replace(/\\/g, '/'),
+        });
+    }
+    if (!variants.has(''))
+        variants.set('', { suffix: '', tags: [] });
+    return [...variants.values()].sort((a, b) => a.suffix.localeCompare(b.suffix));
+}
+function extensionOf(file) {
+    return file.slice(file.lastIndexOf('.') + 1);
+}
+function variantSuffixOf(file, base) {
+    const rest = file.slice(base.length);
+    const withoutExt = rest.replace(/\.[^.]+$/, '');
+    return withoutExt.replace(/^\./, '');
+}

package/dist/client/entry.d.mts

@@ -0,0 +1,3 @@
+/** ESM browser entry reusing the single server/client component implementation. */
+export { Script, Style } from '../components.js';
+export type { ScriptProps, StyleProps } from '../components.js';

package/dist/client/entry.mjs

@@ -0,0 +1,2 @@
+/** ESM browser entry reusing the single server/client component implementation. */
+export { Script, Style } from '../components.js';

package/dist/client/index.d.ts

@@ -0,0 +1,2 @@
+export { Script, Style } from '../components';
+export type { ScriptProps, StyleProps } from '../components';

package/dist/client/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Style = exports.Script = void 0;
+var components_1 = require("../components");
+Object.defineProperty(exports, "Script", { enumerable: true, get: function () { return components_1.Script; } });
+Object.defineProperty(exports, "Style", { enumerable: true, get: function () { return components_1.Style; } });

package/dist/components.d.ts

@@ -0,0 +1,33 @@
+import { type ReactNode } from 'react';
+export interface StyleProps {
+    children?: ReactNode;
+    media?: string;
+    nonce?: string;
+    title?: string;
+    id?: string;
+}
+export declare function Style({ children, media, nonce, title, id }: StyleProps): import("react").DetailedReactHTMLElement<{
+    'data-ress-style': string;
+    id?: string | undefined;
+    title?: string | undefined;
+    nonce?: string | undefined;
+    media?: string | undefined;
+}, HTMLElement>;
+export interface ScriptProps {
+    children?: ReactNode;
+    src?: string;
+    type?: string;
+    nonce?: string;
+    id?: string;
+    async?: boolean;
+    defer?: boolean;
+}
+export declare function Script({ children, src, type, nonce, id, async, defer }: ScriptProps): import("react").DetailedReactHTMLElement<{
+    'data-ress-script': string;
+    defer?: boolean | undefined;
+    async?: boolean | undefined;
+    id?: string | undefined;
+    nonce?: string | undefined;
+    type?: string | undefined;
+    src?: string | undefined;
+}, HTMLElement>;

package/dist/components.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Style = Style;
+exports.Script = Script;
+const react_1 = require("react");
+function Style({ children, media, nonce, title, id }) {
+    return (0, react_1.createElement)('style', {
+        ...(media ? { media } : {}),
+        ...(nonce ? { nonce } : {}),
+        ...(title ? { title } : {}),
+        ...(id ? { id } : {}),
+        'data-ress-style': 'inline',
+    }, children);
+}
+function Script({ children, src, type, nonce, id, async, defer }) {
+    return (0, react_1.createElement)('script', {
+        ...(src ? { src } : {}),
+        ...(type ? { type } : {}),
+        ...(nonce ? { nonce } : {}),
+        ...(id ? { id } : {}),
+        ...(async ? { async: true } : {}),
+        ...(defer ? { defer: true } : {}),
+        'data-ress-script': children != null ? 'inline' : 'external',
+    }, children);
+}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { SUPPORTED_STYLE_EXTENSIONS, discoverStyleVariants } from './catalog';
+export { resolveAssetVariant } from './resolve';
+export { resolvePageAssets } from './page-assets';
+export { Script, Style } from './components';
+export type { AssetCatalog, AssetDefinition, AssetEntry, AssetIndex, AssetResolverOptions, AssetVariant, ResolvedAssetLinks } from './types';
+export type { ScriptProps, StyleProps } from './components';

package/dist/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Style = exports.Script = exports.resolvePageAssets = exports.resolveAssetVariant = exports.discoverStyleVariants = exports.SUPPORTED_STYLE_EXTENSIONS = void 0;
+var catalog_1 = require("./catalog");
+Object.defineProperty(exports, "SUPPORTED_STYLE_EXTENSIONS", { enumerable: true, get: function () { return catalog_1.SUPPORTED_STYLE_EXTENSIONS; } });
+Object.defineProperty(exports, "discoverStyleVariants", { enumerable: true, get: function () { return catalog_1.discoverStyleVariants; } });
+var resolve_1 = require("./resolve");
+Object.defineProperty(exports, "resolveAssetVariant", { enumerable: true, get: function () { return resolve_1.resolveAssetVariant; } });
+var page_assets_1 = require("./page-assets");
+Object.defineProperty(exports, "resolvePageAssets", { enumerable: true, get: function () { return page_assets_1.resolvePageAssets; } });
+var components_1 = require("./components");
+Object.defineProperty(exports, "Script", { enumerable: true, get: function () { return components_1.Script; } });
+Object.defineProperty(exports, "Style", { enumerable: true, get: function () { return components_1.Style; } });

package/dist/page-assets.d.ts

@@ -0,0 +1,4 @@
+import { type PlatformInfo, type PlatformRegistry } from '@ressjs/platform';
+import type { AssetCatalog, AssetIndex, ResolvedAssetLinks } from './types';
+/** Resolves already-built links for one page and platform without filesystem access. */
+export declare function resolvePageAssets(pageId: string, platform: PlatformInfo | undefined, catalog: AssetCatalog, assets: AssetIndex, registry?: PlatformRegistry): ResolvedAssetLinks;

package/dist/page-assets.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolvePageAssets = resolvePageAssets;
+const platform_1 = require("@ressjs/platform");
+const resolve_1 = require("./resolve");
+/** Resolves already-built links for one page and platform without filesystem access. */
+function resolvePageAssets(pageId, platform = platform_1.DEFAULT_PLATFORM, catalog, assets, registry = platform_1.defaultPlatformRegistry) {
+    const variants = catalog.variantsByPage.get(pageId) ?? [];
+    const chosen = variants.length ? (0, resolve_1.resolveAssetVariant)(platform, variants, registry) : undefined;
+    return (chosen && assets.find(pageId, chosen.suffix)) ?? assets.find(pageId, '') ?? { js: '', css: [] };
+}

package/dist/resolve.d.ts

@@ -0,0 +1,4 @@
+import type { PlatformInfo, PlatformRegistry } from '@ressjs/platform';
+import type { AssetVariant } from './types';
+/** Selecciona la variante más específica para una plataforma. */
+export declare function resolveAssetVariant(platform: PlatformInfo, available: AssetVariant[], registry: PlatformRegistry): AssetVariant;

package/dist/resolve.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveAssetVariant = resolveAssetVariant;
+/** Selecciona la variante más específica para una plataforma. */
+function resolveAssetVariant(platform, available, registry) {
+    const base = available.find((variant) => variant.suffix === '');
+    const applicable = available.filter((variant) => variant.tags.every((tag) => registry.matches(tag, platform)));
+    if (!applicable.length) {
+        if (!base)
+            throw new Error('[ress] No hay una variante base para este asset.');
+        return base;
+    }
+    return applicable.reduce((best, candidate) => {
+        if (candidate.tags.length !== best.tags.length)
+            return candidate.tags.length > best.tags.length ? candidate : best;
+        return candidate.suffix.localeCompare(best.suffix) < 0 ? candidate : best;
+    });
+}

package/dist/types.d.ts

@@ -0,0 +1,28 @@
+import type { PlatformRegistry, VariantTag } from '@ressjs/platform';
+export interface AssetVariant {
+    suffix: string;
+    tags: VariantTag[];
+    sourceFile?: string;
+}
+export interface AssetEntry {
+    name: string;
+    sourceFile: string;
+    variants: AssetVariant[];
+}
+export interface AssetDefinition {
+    entries?: Record<string, string>;
+}
+export interface AssetResolverOptions {
+    registry: PlatformRegistry;
+}
+export interface ResolvedAssetLinks {
+    js: string;
+    css: string[];
+}
+/** Minimal shape consumed by the request resolver; the router owns its catalog details. */
+export interface AssetCatalog {
+    variantsByPage: Map<string, AssetVariant[]>;
+}
+export interface AssetIndex {
+    find(pageId: string, variantSuffix: string): ResolvedAssetLinks | undefined;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@ressjs/assets",
+  "version": "0.6.0-experimental.0",
+  "description": "Assets de ress.js: variantes de plataforma, Style y Script",
+  "types": "dist/index.d.ts",
+  "main": "dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "import": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client/entry.d.mts",
+      "require": "./dist/client/index.js",
+      "import": "./dist/client/entry.mjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@ressjs/platform": "0.6.0-experimental.0",
+    "fast-glob": "^3.3.3"
+  },
+  "peerDependencies": {
+    "react": "^19.0.0"
+  },
+  "engines": {
+    "node": ">=20.19.0"
+  }
+}