@jjlmoya/utils-books 1.1.0

package/src/tool/book-pagination-and-spine-calculator/i18n/tr.ts

@@ -0,0 +1,78 @@
+import type { ToolLocaleContent } from '../../../types';
+import type { BookPaginationUI } from '../ui';
+
+const ui: BookPaginationUI = {
+  title: 'Kitap sayfası ve sırt hesaplayıcı',
+  scenarioLabel: 'Senaryo adı',
+  scenarioPlaceholder: 'Kitabım',
+  wordsLabel: 'El yazması kelimeleri',
+  widthLabel: 'Kesim genişliği',
+  heightLabel: 'Kesim yüksekliği',
+  marginLabel: 'İç kenar boşluğu',
+  fontSizeLabel: 'Yazı boyutu (pt)',
+  lineHeightLabel: 'Satır aralığı (×)',
+  paperLabel: 'Kitap ayarları',
+  caliperLabel: 'Kâğıt kalınlığı',
+  bindingLabel: 'Cilt',
+  softcoverLabel: 'Karton kapak',
+  hardcoverLabel: 'Sert kapak',
+  saddleLabel: 'Tel dikiş',
+  presetLabel: 'Bir formatla başlayın',
+  novelPreset: 'Roman',
+  largePrintPreset: 'Büyük punto',
+  workbookPreset: 'Çalışma kitabı',
+  metricLabel: 'Metrik mm',
+  imperialLabel: 'İngiliz ölçüsü inç',
+  resetLabel: 'Roman ayarlarına dön',
+  pagesLabel: 'Tahmini sayfa',
+  spineLabel: 'Sırt genişliği',
+  coverLabel: 'Kapak açılımı',
+  wordsPerPageLabel: 'Sayfa başına kelime',
+  linesLabel: 'Sayfa başına satır',
+  previewLabel: 'Kitap maketi',
+  previewHint: 'Kâğıt bloğu büyüdükçe sırt da genişler. Sonucu üretim tahmini olarak kullanın.',
+  methodTitle: 'Baskıdan önce kitabın biçimini belirleyin',
+  methodHint: 'Bir format seçin, ardından sayfa sayısı ile kapak ölçüsünün birlikte nasıl değiştiğini görmek için yazıyı ve kâğıdı ayarlayın.',
+  sourceLabel: 'Tahmin, girdiğiniz değerleri kullanır. Son sırt ölçüsünü matbaa, kâğıt ve cilt yöntemiyle doğrulayın.',
+};
+
+const seo: ToolLocaleContent<BookPaginationUI>['seo'] = [
+  { type: 'title', text: 'El yazmasından kitap sayfası ve sırt genişliği hesaplayın', level: 2 },
+  { type: 'paragraph', html: 'Kelime sayısını ve sayfa tasarımını basılı bir kitap için pratik bir ilk tahmine dönüştürün. Bu hesaplayıcı, kullanılabilir metin alanını, yaklaşık sayfa başına kelime sayısını, cilt katlama kurallarını, kâğıt kalınlığını, sırt genişliğini ve tam kapak açılımını tek bir görsel çalışma alanında modeller.' },
+  { type: 'title', text: 'Hesaplayıcının tahmin ettikleri', level: 2 },
+  { type: 'paragraph', html: 'Sayfa tahmini; kesim ölçülerini, kenar boşluklarını, yazı boyutunu ve satır aralığını kullanarak satır başına karakter ve sayfa başına satır sayısını yaklaşık hesaplar. Sonuç, karton ve sert kapak için çift sayıya, tel dikişli çalışma kitapları için dördün katına yuvarlanır. Sırt genişliği daha sonra kâğıt bloğuna küçük bir cilt payı eklenerek bulunur.' },
+  { type: 'list', items: ['Kompakt bir cep kitabı için roman ön ayarını başlangıç noktası olarak kullanın.', 'Büyük yazı, sayfa başına kelime sayısını değiştiriyorsa büyük puntoyu seçin.', 'Daha geniş sayfa ve dördün katı sayfa sayısı için çalışma kitabını kullanın.', 'Kitabın fiziksel ölçüsünü değiştirmeden milimetre ve inç arasında geçiş yapın.'] },
+  { type: 'title', text: 'Matbaa provası değil üretim tahmini', level: 2 },
+  { type: 'paragraph', html: 'Kâğıt üreticileri kalınlığı farklı biçimlerde belirtir, yazı karakterlerinin genişliği değişir ve matbaalar kendi forma yerleştirme ve cilt toleranslarını uygular. Sonucu yazarlar, editörler ve tasarımcılar için hızlı bir planlama aracı olarak değerlendirin. Sipariş vermeden veya dosya dışa aktarmadan önce son kapak şablonunu matbaa özellikleriyle karşılaştırın.' },
+  { type: 'tip', title: 'Okunabilir yazı ayarlarını koruyun', html: 'Daha küçük yazı veya daha sıkı satır aralığı, sırtı inceltse bile kitabı daha ucuz gösterebilir ve okumayı zorlaştırabilir. Ön ayarları görsel olarak karşılaştırın ve kararı okuma deneyimine göre verin.' },
+];
+
+export const content: ToolLocaleContent<BookPaginationUI> = {
+  slug: 'kitap-sayfa-ve-sirt-hesaplayici',
+  title: 'Kitap sayfası ve sırt hesaplayıcı',
+  description: 'El yazması, kesim ölçüsü, tipografi, kâğıt ve ciltten basılı sayfa, sırt genişliği ve kapak açılımı tahmini alın.',
+  ui,
+  seo,
+  faq: [
+    { question: 'Sayfa tahmini hangi verileri kullanır?', answer: 'El yazması kelimelerini, kesim ölçüsünü, kenar boşluklarını, yazı boyutunu ve satır aralığını kullanarak karakter, satır ve sayfa başına kelime sayısını tahmin eder.' },
+    { question: 'Sayfalar neden yuvarlanır?', answer: 'Karton ve sert kapak tahminleri çift sayıya yuvarlanır. Tel dikişli kitaplar, katlanmış formalar nedeniyle dördün katına yuvarlanır.' },
+    { question: 'Sırt genişliği nasıl tahmin edilir?', answer: 'Hesaplayıcı sayfa sayısını yaprak başına kâğıt kalınlığıyla çarpar, bloğu ikiye böler ve seçilen cilt için küçük bir pay ekler.' },
+    { question: 'Sonuç matbaaya gönderilmeye hazır mı?', answer: 'Hayır. Bu bir planlama tahminidir. Kâğıt kalınlığını, kapak ölçülerini, taşmayı ve cilt toleranslarını matbaanızla doğrulayın.' },
+  ],
+  bibliography: [
+    { name: 'ISO 216:2007 Kâğıt boyutları', url: 'https://www.iso.org/standard/36631.html' },
+    { name: 'Instituto Nacional de Estadística. Producción editorial de libros', url: 'https://www.ine.es/dyngs/INEbase/es/operacion.htm?c=Estadistica_C&cid=1254736176767&idp=1254735573113&menu=ultiDatos' },
+    { name: 'UNESCO küresel yayıncılık sektörü raporu', url: 'https://doi.org/10.58337/SRUH6078' },
+  ],
+  howTo: [
+    { name: 'Bir format seçin', text: 'Roman, büyük punto veya çalışma kitabı ön ayarıyla başlayın.' },
+    { name: 'El yazmasını ayarlayın', text: 'Kelime sayısını girin; ölçü, kenar boşluğu, yazı tipi ve satır aralığını ayarlayın.' },
+    { name: 'Kâğıt ve cilt seçin', text: 'Kâğıt kalınlığını girin ve karton kapak, sert kapak veya tel dikişi seçin.' },
+    { name: 'Kapağı inceleyin', text: 'Tahmini sırt genişliğini ve kapak açılımını tasarım dosyanız için başlangıç olarak kullanın.' },
+  ],
+  schemas: [
+    { '@context': 'https://schema.org', '@type': 'SoftwareApplication', name: 'Kitap sayfası ve sırt hesaplayıcı', applicationCategory: 'DesignApplication', operatingSystem: 'Any', offers: { '@type': 'Offer', price: '0', priceCurrency: 'TRY' } },
+    { '@context': 'https://schema.org', '@type': 'FAQPage', mainEntity: [{ '@type': 'Question', name: 'Sayfa tahmini hangi verileri kullanır?', acceptedAnswer: { '@type': 'Answer', text: 'Kelime, ölçü, kenar boşluğu, yazı boyutu ve satır aralığını kullanır.' } }, { '@type': 'Question', name: 'Sırt genişliği nasıl tahmin edilir?', acceptedAnswer: { '@type': 'Answer', text: 'Sayfa sayısını, kâğıt kalınlığını ve cilt payını kullanır.' } }] },
+    { '@context': 'https://schema.org', '@type': 'HowTo', name: 'Kitap sayfası ve sırt genişliği tahmin etmek', step: [{ '@type': 'HowToStep', name: 'Bir format seçin', text: 'Bir ön ayar seçin.' }, { '@type': 'HowToStep', name: 'El yazmasını ayarlayın', text: 'Kelime ve tipografi değerlerini girin.' }, { '@type': 'HowToStep', name: 'Kâğıt ve cilt seçin', text: 'Kalınlık ve cilt yöntemini ayarlayın.' }, { '@type': 'HowToStep', name: 'Kapağı inceleyin', text: 'Sırt ve kapak tahminini kullanın.' }] },
+  ],
+};

package/src/tool/book-pagination-and-spine-calculator/i18n/zh.ts

@@ -0,0 +1,78 @@
+import type { ToolLocaleContent } from '../../../types';
+import type { BookPaginationUI } from '../ui';
+
+const ui: BookPaginationUI = {
+  title: '图书页数与书脊宽度计算器',
+  scenarioLabel: '方案名称',
+  scenarioPlaceholder: '我的书',
+  wordsLabel: '手稿字数',
+  widthLabel: '成品宽度',
+  heightLabel: '成品高度',
+  marginLabel: '内侧页边距',
+  fontSizeLabel: '字号 (pt)',
+  lineHeightLabel: '行距 (×)',
+  paperLabel: '图书设置',
+  caliperLabel: '纸张厚度',
+  bindingLabel: '装订方式',
+  softcoverLabel: '平装',
+  hardcoverLabel: '精装',
+  saddleLabel: '骑马钉',
+  presetLabel: '从一种格式开始',
+  novelPreset: '小说',
+  largePrintPreset: '大字版',
+  workbookPreset: '练习册',
+  metricLabel: '公制 mm',
+  imperialLabel: '英制 inch',
+  resetLabel: '重置为小说',
+  pagesLabel: '预计页数',
+  spineLabel: '书脊宽度',
+  coverLabel: '书封展开尺寸',
+  wordsPerPageLabel: '每页字数',
+  linesLabel: '每页行数',
+  previewLabel: '图书模型',
+  previewHint: '纸张叠层越厚，书脊就越宽。请把结果作为制作估算使用。',
+  methodTitle: '在印刷前确定图书形态',
+  methodHint: '选择一种格式，再调整文字和纸张，观察页数与书封尺寸如何一起变化。',
+  sourceLabel: '估算基于你的输入。请向印刷厂确认最终书脊，并核对纸张和装订方式。',
+};
+
+const seo: ToolLocaleContent<BookPaginationUI>['seo'] = [
+  { type: 'title', text: '根据手稿计算图书页数和书脊宽度', level: 2 },
+  { type: 'paragraph', html: '把字数和页面设计转换为印刷图书的实用初步估算。这个计算器会在同一个可视化工作区中模拟可用正文区域、每页大致字数、装订折页规则、纸张厚度、书脊宽度和整张书封的展开尺寸。' },
+  { type: 'title', text: '计算器会估算什么', level: 2 },
+  { type: 'paragraph', html: '页数估算使用成品尺寸、页边距、字号和行距，近似计算每行字数与每页行数。平装和精装会取整为偶数页，骑马钉练习册会取整为四的倍数。随后，计算器会把纸张叠层和少量装订余量结合起来得到书脊宽度。' },
+  { type: 'list', items: ['使用小说预设，作为紧凑型平装书的起点。', '当更大的字号改变每页字数时，使用大字版预设。', '需要更宽页面和四的倍数页数时，使用练习册预设。', '在毫米和英寸之间切换，不会改变图书的实际尺寸。'] },
+  { type: 'title', text: '制作估算而不是印刷打样', level: 2 },
+  { type: 'paragraph', html: '不同纸张制造商对厚度的标示方式不同，不同字体的字面宽度也不同，印刷厂还会使用自己的拼版和装订公差。请把结果当作作者、编辑和设计师的快速规划工具。下单或导出设计文件前，请根据印刷厂规格检查最终书封模板。' },
+  { type: 'tip', title: '保持文字设置易读', html: '较小的字号或过紧的行距虽然能缩小书脊，却可能让图书显得廉价并降低阅读舒适度。请用视觉方式比较各个预设，并以阅读体验为依据做决定。' },
+];
+
+export const content: ToolLocaleContent<BookPaginationUI> = {
+  slug: 'book-pagination-and-spine-calculator',
+  title: '图书页数与书脊宽度计算器',
+  description: '根据手稿、成品尺寸、字体、纸张和装订方式，估算印刷页数、书脊宽度与书封展开尺寸。',
+  ui,
+  seo,
+  faq: [
+    { question: '页数估算使用哪些数据？', answer: '它使用手稿字数、成品尺寸、页边距、字号和行距，估算每页的字数和行数。' },
+    { question: '为什么要对页数取整？', answer: '平装和精装会取整为偶数页。骑马钉图书会因为折叠书帖取整为四的倍数。' },
+    { question: '书脊宽度如何估算？', answer: '计算器将页数乘以每张纸的厚度，把纸张叠层除以二，再加上所选装订方式的少量余量。' },
+    { question: '结果可以直接交给印刷厂吗？', answer: '不可以。这是规划用估算值。请向印刷厂确认纸张厚度、书封尺寸、出血和装订公差。' },
+  ],
+  bibliography: [
+    { name: 'ISO 216:2007 纸张尺寸', url: 'https://www.iso.org/standard/36631.html' },
+    { name: 'Instituto Nacional de Estadística. Producción editorial de libros', url: 'https://www.ine.es/dyngs/INEbase/es/operacion.htm?c=Estadistica_C&cid=1254736176767&idp=1254735573113&menu=ultiDatos' },
+    { name: '联合国教科文组织全球出版业报告', url: 'https://doi.org/10.58337/SRUH6078' },
+  ],
+  howTo: [
+    { name: '选择格式', text: '从小说、大字版或练习册预设开始。' },
+    { name: '设置手稿', text: '输入字数，并调整尺寸、页边距、字体和行距。' },
+    { name: '选择纸张和装订', text: '输入纸张厚度，然后选择平装、精装或骑马钉。' },
+    { name: '检查书封', text: '把预计书脊和展开尺寸作为设计文件的起点。' },
+  ],
+  schemas: [
+    { '@context': 'https://schema.org', '@type': 'SoftwareApplication', name: '图书页数与书脊宽度计算器', applicationCategory: 'DesignApplication', operatingSystem: 'Any', offers: { '@type': 'Offer', price: '0', priceCurrency: 'CNY' } },
+    { '@context': 'https://schema.org', '@type': 'FAQPage', mainEntity: [{ '@type': 'Question', name: '页数估算使用哪些数据？', acceptedAnswer: { '@type': 'Answer', text: '它使用字数、尺寸、页边距、字号和行距。' } }, { '@type': 'Question', name: '书脊宽度如何估算？', acceptedAnswer: { '@type': 'Answer', text: '它使用页数、纸张厚度和装订余量。' } }] },
+    { '@context': 'https://schema.org', '@type': 'HowTo', name: '估算图书页数和书脊宽度', step: [{ '@type': 'HowToStep', name: '选择格式', text: '选择一个预设。' }, { '@type': 'HowToStep', name: '设置手稿', text: '输入字数和文字设置。' }, { '@type': 'HowToStep', name: '选择纸张和装订', text: '设置厚度和装订方式。' }, { '@type': 'HowToStep', name: '检查书封', text: '使用书脊和书封估算值。' }] },
+  ],
+};

package/src/tool/book-pagination-and-spine-calculator/index.ts

@@ -0,0 +1,11 @@
+import type { ToolDefinition } from '../../types';
+import { bookPaginationAndSpineCalculator } from './entry';
+
+export * from './entry';
+
+export const BOOK_PAGINATION_AND_SPINE_CALCULATOR_TOOL: ToolDefinition = {
+  entry: bookPaginationAndSpineCalculator,
+  Component: () => import('./component.astro'),
+  SEOComponent: () => import('./seo.astro'),
+  BibliographyComponent: () => import('./bibliography.astro'),
+};

package/src/tool/book-pagination-and-spine-calculator/logic.test.ts

@@ -0,0 +1,21 @@
+import { describe, expect, it } from 'vitest';
+import { LARGE_PRINT_PRESET, NOVEL_PRESET, WORKBOOK_PRESET, calculateBook } from './logic';
+
+describe('book pagination and spine logic', () => {
+  it('estimates a novel as an even page count', () => {
+    const result = calculateBook(NOVEL_PRESET);
+    expect(result.pages % 2).toBe(0);
+    expect(result.pages).toBeGreaterThan(200);
+    expect(result.spineMm).toBeGreaterThan(1);
+  });
+
+  it('rounds saddle stitch books to a multiple of four', () => {
+    expect(calculateBook(WORKBOOK_PRESET).pages % 4).toBe(0);
+  });
+
+  it('reduces words per page for large print', () => {
+    const novel = calculateBook(NOVEL_PRESET);
+    const largePrint = calculateBook(LARGE_PRINT_PRESET);
+    expect(largePrint.wordsPerPage).toBeLessThan(novel.wordsPerPage);
+  });
+});

package/src/tool/book-pagination-and-spine-calculator/logic.ts

@@ -0,0 +1,52 @@
+export type Binding = 'softcover' | 'hardcover' | 'saddle-stitch';
+
+export interface BookInputs {
+  words: number;
+  widthMm: number;
+  heightMm: number;
+  marginMm: number;
+  fontSizePt: number;
+  lineHeight: number;
+  caliperMm: number;
+  binding: Binding;
+}
+
+export interface BookCalculation {
+  linesPerPage: number;
+  charactersPerLine: number;
+  wordsPerPage: number;
+  pages: number;
+  sheets: number;
+  spineMm: number;
+  coverWidthMm: number;
+  coverHeightMm: number;
+}
+
+export const NOVEL_PRESET: BookInputs = { words: 80000, widthMm: 127, heightMm: 203, marginMm: 18, fontSizePt: 11, lineHeight: 1.2, caliperMm: 0.09, binding: 'softcover' };
+export const LARGE_PRINT_PRESET: BookInputs = { words: 60000, widthMm: 152, heightMm: 229, marginMm: 22, fontSizePt: 16, lineHeight: 1.35, caliperMm: 0.09, binding: 'softcover' };
+export const WORKBOOK_PRESET: BookInputs = { words: 30000, widthMm: 210, heightMm: 297, marginMm: 18, fontSizePt: 10, lineHeight: 1.15, caliperMm: 0.1, binding: 'saddle-stitch' };
+
+export function calculateBook(inputs: BookInputs): BookCalculation {
+  const contentWidth = Math.max(inputs.widthMm - inputs.marginMm * 2, 1);
+  const contentHeight = Math.max(inputs.heightMm - inputs.marginMm * 2, 1);
+  const fontMm = inputs.fontSizePt * 0.3528;
+  const charactersPerLine = Math.max(1, Math.floor(contentWidth / (fontMm * 0.5)));
+  const linesPerPage = Math.max(1, Math.floor(contentHeight / (fontMm * inputs.lineHeight)));
+  const wordsPerPage = Math.max(1, Math.floor((charactersPerLine * linesPerPage) / 6));
+  const rawPages = Math.max(1, Math.ceil(inputs.words / wordsPerPage));
+  const pages = roundPages(rawPages, inputs.binding);
+  const sheets = Math.ceil(pages / 2);
+  const spineMm = pages * inputs.caliperMm / 2 + bindingAllowance(inputs.binding);
+  return { linesPerPage, charactersPerLine, wordsPerPage, pages, sheets, spineMm, coverWidthMm: inputs.widthMm * 2 + spineMm, coverHeightMm: inputs.heightMm };
+}
+
+function roundPages(pages: number, binding: Binding): number {
+  const multiple = binding === 'saddle-stitch' ? 4 : 2;
+  return Math.ceil(pages / multiple) * multiple;
+}
+
+function bindingAllowance(binding: Binding): number {
+  if (binding === 'hardcover') return 3;
+  if (binding === 'softcover') return 1.2;
+  return 0;
+}

package/src/tool/book-pagination-and-spine-calculator/seo.astro

@@ -0,0 +1,16 @@
+---
+import { SEORenderer } from '@jjlmoya/utils-shared';
+import { bookPaginationAndSpineCalculator } from './index';
+import type { KnownLocale } from '../../types';
+
+interface Props {
+  locale?: KnownLocale;
+}
+
+const { locale = 'en' } = Astro.props as Props;
+const loader = bookPaginationAndSpineCalculator.i18n[locale] || bookPaginationAndSpineCalculator.i18n.en;
+const content = await loader?.();
+if (!content) return null;
+---
+
+<SEORenderer content={{ locale, sections: content.seo }} />

package/src/tool/book-pagination-and-spine-calculator/storage.ts

@@ -0,0 +1,22 @@
+const STORAGE_KEY = 'book-pagination-and-spine-calculator-state';
+
+export interface StoredBookState {
+  inputs: string;
+  unit: 'metric' | 'imperial';
+  scenarioName: string;
+}
+
+export function loadBookState(fallback: StoredBookState): StoredBookState {
+  try {
+    const raw = localStorage.getItem(STORAGE_KEY);
+    return raw ? { ...fallback, ...JSON.parse(raw) } as StoredBookState : fallback;
+  } catch {
+    return fallback;
+  }
+}
+
+export function saveBookState(state: StoredBookState): void {
+  try {
+    localStorage.setItem(STORAGE_KEY, JSON.stringify(state));
+  } catch {}
+}

package/src/tool/book-pagination-and-spine-calculator/ui.ts

@@ -0,0 +1,35 @@
+export interface BookPaginationUI {
+  [key: string]: string;
+  title: string;
+  scenarioLabel: string;
+  scenarioPlaceholder: string;
+  wordsLabel: string;
+  widthLabel: string;
+  heightLabel: string;
+  marginLabel: string;
+  fontSizeLabel: string;
+  lineHeightLabel: string;
+  paperLabel: string;
+  caliperLabel: string;
+  bindingLabel: string;
+  softcoverLabel: string;
+  hardcoverLabel: string;
+  saddleLabel: string;
+  presetLabel: string;
+  novelPreset: string;
+  largePrintPreset: string;
+  workbookPreset: string;
+  metricLabel: string;
+  imperialLabel: string;
+  resetLabel: string;
+  pagesLabel: string;
+  spineLabel: string;
+  coverLabel: string;
+  wordsPerPageLabel: string;
+  linesLabel: string;
+  previewLabel: string;
+  previewHint: string;
+  methodTitle: string;
+  methodHint: string;
+  sourceLabel: string;
+}

package/src/tools.ts

@@ -0,0 +1,5 @@
+export { ALL_ENTRIES } from './entries';
+import type { ToolDefinition } from './types';
+import { BOOK_PAGINATION_AND_SPINE_CALCULATOR_TOOL } from './tool/book-pagination-and-spine-calculator';
+
+export const ALL_TOOLS: ToolDefinition[] = [BOOK_PAGINATION_AND_SPINE_CALCULATOR_TOOL];

package/src/types.ts

@@ -0,0 +1,69 @@
+import type { SEOSection } from '@jjlmoya/utils-shared';
+
+export type { SEOSection };
+
+export type KnownLocale =
+  | 'ar' | 'da' | 'de' | 'en' | 'es' | 'fi'
+  | 'fr' | 'id' | 'it' | 'ja' | 'ko' | 'nb' | 'nl'
+  | 'pl' | 'pt' | 'ru' | 'sv' | 'tr' | 'zh';
+
+export interface FAQItem {
+  question: string;
+  answer: string;
+}
+
+export interface BibliographyEntry {
+  name: string;
+  url: string;
+}
+
+export interface HowToStep {
+  name: string;
+  text: string;
+}
+
+export interface ToolLocaleContent<TUI extends Record<string, string> = Record<string, string>> {
+  slug: string;
+  title: string;
+  description: string;
+  ui: TUI;
+  seo: SEOSection[];
+  faq: FAQItem[];
+  bibliography: BibliographyEntry[];
+  howTo: HowToStep[];
+  schemas: Record<string, unknown>[];
+}
+
+export interface CategoryLocaleContent {
+  slug: string;
+  title: string;
+  description: string;
+  seo: SEOSection[];
+}
+
+export type LocaleLoader<T> = () => Promise<T>;
+
+export type LocaleMap<T> = Partial<Record<KnownLocale, LocaleLoader<T>>>;
+
+export interface BooksToolEntry<TUI extends Record<string, string> = Record<string, string>> {
+  id: string;
+  icons: {
+    bg: string;
+    fg: string;
+  };
+  i18n: LocaleMap<ToolLocaleContent<TUI>>;
+}
+
+export interface BooksCategoryEntry {
+  icon: string;
+  tools: BooksToolEntry[];
+  i18n: LocaleMap<CategoryLocaleContent>;
+}
+
+export interface ToolDefinition {
+  entry: BooksToolEntry;
+  Component: unknown;
+  SEOComponent: unknown;
+  BibliographyComponent: unknown;
+}
+

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+    "extends": "astro/tsconfigs/strictest",
+    "include": ["src/**/*", ".astro/types.d.ts"],
+    "compilerOptions": {
+        "baseUrl": ".",
+        "strictNullChecks": true,
+        "noImplicitAny": true,
+        "strict": true,
+        "types": ["astro/client", "astro/jsx-runtime"],
+        "jsx": "preserve",
+        "jsxImportSource": "astro"
+    },
+    "exclude": ["node_modules", "dist"]
+}
+

package/vitest.config.ts

@@ -0,0 +1,20 @@
+import { defineConfig } from 'vitest/config';
+import path from 'path';
+
+export default defineConfig({
+  test: {
+    environment: 'node',
+  },
+  resolve: {
+    alias: [
+      {
+        find: /^(.*)\.astro$/,
+        replacement: path.resolve(__dirname, './src/tests/mocks/astro_mock.js')
+      }
+    ]
+  },
+  ssr: {
+    external: ['astro']
+  }
+});
+