@muni-sanfer/types-gestor-documental 0.0.1-beta.48 → 0.0.1-beta.49

package/dist/entities/document/richStyle.d.ts

@@ -128,9 +128,35 @@ export interface RichPage {
 }
 /** Página de siempre: Carta, con el espacio del membrete y los sellos, en Roboto 11. */
 export declare const RICH_DEFAULT_PAGE: RichPage;
+/**
+ * Una imagen del encabezado (logo, escudo, sello) en el diseño libre: imagen registrada en el gestor, con su lugar y su
+ * tamaño en puntos desde la esquina superior izquierda de la hoja. Cabe en el margen superior.
+ */
+export interface RichLetterheadImage {
+    imageId: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export type RichLetterheadAlign = 'left' | 'center' | 'right';
+/** El texto del membrete (nombre de la municipalidad, unidad y líneas propias) en el diseño libre. */
+export interface RichLetterheadText {
+    x: number;
+    y: number;
+    width: number;
+    align: RichLetterheadAlign;
+    /** Tamaño del nombre de la municipalidad, en puntos (sin valor, 10). */
+    organSize?: number;
+    /** Tamaño de la unidad y de las líneas propias, en puntos (sin valor, 8). */
+    lineSize?: number;
+}
 /**
  * Membrete de la plantilla, en el margen superior de cada página: un logo o escudo (opcional) y el nombre de la
  * municipalidad y de la unidad que emite. Va a la izquierda: a la derecha el sistema estampa el número y la fecha.
+ *
+ * Con `text`, el diseño es libre: las imágenes de `images` y el texto van donde se ubicaron (y `imageId` e
+ * `imageHeight` no se usan). Sin `text`, el de siempre: el logo de `imageId` y, a su lado, el texto.
  */
 export interface RichLetterhead {
     /** Imagen registrada en el gestor (`RichImage`), no un archivo de Drive. */
@@ -141,7 +167,33 @@ export interface RichLetterhead {
     showUnitName: boolean;
     /** Líneas propias bajo el nombre, como la dirección o el teléfono. */
     lines?: string[];
+    /** Diseño libre: las imágenes del encabezado, donde se ubicaron. */
+    images?: RichLetterheadImage[];
+    /** Diseño libre: dónde va el texto y con qué tamaño. */
+    text?: RichLetterheadText;
+    /** Línea divisoria bajo el encabezado, de margen a margen. */
+    rule?: boolean;
 }
+/** Límites del diseño libre del encabezado. */
+export declare const RICH_LETTERHEAD_LIMITS: {
+    readonly maxImages: 4;
+    /** Lado mínimo de una imagen, en puntos. */
+    readonly minImageSize: 12;
+    /** Ancho mínimo del texto, en puntos. */
+    readonly minTextWidth: 60;
+    readonly organSizes: readonly [8, 9, 10, 11, 12, 13, 14, 16];
+    readonly lineSizes: readonly [6, 7, 8, 9, 10, 11, 12];
+};
+/**
+ * Lo que ocupa en la primera página el número y la fecha que estampa el sistema, arriba a la derecha: el encabezado no
+ * debe taparlo. En puntos; `right` es la distancia al borde derecho.
+ */
+export declare const RICH_NUMBER_ZONE: {
+    readonly right: 36;
+    readonly top: 18;
+    readonly height: 30;
+    readonly width: 230;
+};
 export declare const RICH_DEFAULT_LETTERHEAD: RichLetterhead;
 /** Límites de una imagen: formatos, peso y tamaño en el texto. */
 export declare const RICH_IMAGE_LIMITS: {

package/dist/entities/document/richStyle.js

@@ -4,7 +4,7 @@
  * márgenes. Todo lo que el PDF muestra sale de aquí, así que el editor y el documento oficial se ven igual.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RICH_IMAGE_LIMITS = exports.RICH_DEFAULT_LETTERHEAD = exports.RICH_DEFAULT_PAGE = exports.RICH_MAX_MARGIN = exports.RICH_MIN_MARGINS = exports.RICH_PAGE_SIZES = exports.RICH_SPACING_LIMITS = exports.RICH_HIGHLIGHTS = exports.RICH_COLORS = exports.RICH_FONT_SIZES = exports.RICH_FONTS = void 0;
+exports.RICH_IMAGE_LIMITS = exports.RICH_DEFAULT_LETTERHEAD = exports.RICH_NUMBER_ZONE = exports.RICH_LETTERHEAD_LIMITS = exports.RICH_DEFAULT_PAGE = exports.RICH_MAX_MARGIN = exports.RICH_MIN_MARGINS = exports.RICH_PAGE_SIZES = exports.RICH_SPACING_LIMITS = exports.RICH_HIGHLIGHTS = exports.RICH_COLORS = exports.RICH_FONT_SIZES = exports.RICH_FONTS = void 0;
 /**
  * Tipografías incrustadas en el PDF (PDF/A exige fuentes incrustadas). Liberation Sans, Liberation Serif y Carlito
  * miden igual que Arial, Times New Roman y Calibri: lo que se pegó desde Word ocupa lo mismo.
@@ -56,6 +56,21 @@ exports.RICH_DEFAULT_PAGE = {
     fontSize: 11,
     lineHeight: 1.2,
 };
+/** Límites del diseño libre del encabezado. */
+exports.RICH_LETTERHEAD_LIMITS = {
+    maxImages: 4,
+    /** Lado mínimo de una imagen, en puntos. */
+    minImageSize: 12,
+    /** Ancho mínimo del texto, en puntos. */
+    minTextWidth: 60,
+    organSizes: [8, 9, 10, 11, 12, 13, 14, 16],
+    lineSizes: [6, 7, 8, 9, 10, 11, 12],
+};
+/**
+ * Lo que ocupa en la primera página el número y la fecha que estampa el sistema, arriba a la derecha: el encabezado no
+ * debe taparlo. En puntos; `right` es la distancia al borde derecho.
+ */
+exports.RICH_NUMBER_ZONE = { right: 36, top: 18, height: 30, width: 230 };
 exports.RICH_DEFAULT_LETTERHEAD = { imageId: null, showOrganName: true, showUnitName: true };
 /** Límites de una imagen: formatos, peso y tamaño en el texto. */
 exports.RICH_IMAGE_LIMITS = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@muni-sanfer/types-gestor-documental",
-  "version": "0.0.1-beta.48",
+  "version": "0.0.1-beta.49",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {

package/src/entities/document/richStyle.ts

@@ -106,9 +106,38 @@ export const RICH_DEFAULT_PAGE: RichPage = {
   lineHeight: 1.2,
 };
 
+/**
+ * Una imagen del encabezado (logo, escudo, sello) en el diseño libre: imagen registrada en el gestor, con su lugar y su
+ * tamaño en puntos desde la esquina superior izquierda de la hoja. Cabe en el margen superior.
+ */
+export interface RichLetterheadImage {
+  imageId: string;
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+}
+
+export type RichLetterheadAlign = 'left' | 'center' | 'right';
+
+/** El texto del membrete (nombre de la municipalidad, unidad y líneas propias) en el diseño libre. */
+export interface RichLetterheadText {
+  x: number;
+  y: number;
+  width: number;
+  align: RichLetterheadAlign;
+  /** Tamaño del nombre de la municipalidad, en puntos (sin valor, 10). */
+  organSize?: number;
+  /** Tamaño de la unidad y de las líneas propias, en puntos (sin valor, 8). */
+  lineSize?: number;
+}
+
 /**
  * Membrete de la plantilla, en el margen superior de cada página: un logo o escudo (opcional) y el nombre de la
  * municipalidad y de la unidad que emite. Va a la izquierda: a la derecha el sistema estampa el número y la fecha.
+ *
+ * Con `text`, el diseño es libre: las imágenes de `images` y el texto van donde se ubicaron (y `imageId` e
+ * `imageHeight` no se usan). Sin `text`, el de siempre: el logo de `imageId` y, a su lado, el texto.
  */
 export interface RichLetterhead {
   /** Imagen registrada en el gestor (`RichImage`), no un archivo de Drive. */
@@ -119,8 +148,31 @@ export interface RichLetterhead {
   showUnitName: boolean;
   /** Líneas propias bajo el nombre, como la dirección o el teléfono. */
   lines?: string[];
+  /** Diseño libre: las imágenes del encabezado, donde se ubicaron. */
+  images?: RichLetterheadImage[];
+  /** Diseño libre: dónde va el texto y con qué tamaño. */
+  text?: RichLetterheadText;
+  /** Línea divisoria bajo el encabezado, de margen a margen. */
+  rule?: boolean;
 }
 
+/** Límites del diseño libre del encabezado. */
+export const RICH_LETTERHEAD_LIMITS = {
+  maxImages: 4,
+  /** Lado mínimo de una imagen, en puntos. */
+  minImageSize: 12,
+  /** Ancho mínimo del texto, en puntos. */
+  minTextWidth: 60,
+  organSizes: [8, 9, 10, 11, 12, 13, 14, 16],
+  lineSizes: [6, 7, 8, 9, 10, 11, 12],
+} as const;
+
+/**
+ * Lo que ocupa en la primera página el número y la fecha que estampa el sistema, arriba a la derecha: el encabezado no
+ * debe taparlo. En puntos; `right` es la distancia al borde derecho.
+ */
+export const RICH_NUMBER_ZONE = { right: 36, top: 18, height: 30, width: 230 } as const;
+
 export const RICH_DEFAULT_LETTERHEAD: RichLetterhead = { imageId: null, showOrganName: true, showUnitName: true };
 
 /** Límites de una imagen: formatos, peso y tamaño en el texto. */