@jjlmoya/utils-textiles 1.1.0

package/src/tool/fabricProjectCalculator/i18n/fr.ts

@@ -0,0 +1,250 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { FabricProjectCalculatorUI } from '../ui';
+
+const slug = 'calculateur-tissu-projet';
+const title = 'Calculateur de Consommation de Tissu par Vêtement';
+const description =
+  'Calculez facilement la quantité de tissu nécessaire pour coudre une jupe, un pantalon, une robe ou une chemise. Ajustez selon la largeur du tissu et la taille pour une coupe professionnelle.';
+
+const faqData = [
+  {
+    question: 'Quelle quantité de tissu faut-il pour une jupe?',
+    answer:
+      'Cela dépend de la largeur du tissu. Pour une jupe droite en tissu de 140-150 cm, 1,20 mètre suffit généralement. Si le tissu fait 90-110 cm de large, vous aurez besoin de 2,00 mètres.',
+  },
+  {
+    question: 'Comment la largeur du tissu affecte-t-elle la consommation?',
+    answer:
+      'Plus le tissu est étroit, moins les pièces du patron peuvent être placées côte à côte (en parallèle), ce qui double souvent la consommation car les pièces doivent être placées l\'une sous l\'autre.',
+  },
+  {
+    question: 'Vaut-il mieux acheter plus de tissu?',
+    answer:
+      'Oui, une marge de 10% (environ 20 cm) est recommandée pour compenser le rétrécissement, les défauts du tissu ou les imprévus de couture.',
+  },
+  {
+    question: 'Qu\'est-ce que le droit fil et comment influence-t-il la coupe?',
+    answer:
+      'C\'est la direction parallèle aux lisières du tissu. Les patrons doivent être alignés avec ce fil pour que le vêtement ne se déforme pas à l\'usage.',
+  },
+];
+
+const howToData = [
+  {
+    name: 'Choisir le type de vêtement',
+    text: 'Sélectionnez le modèle que vous allez confectionner (jupe, pantalon, etc.) pour charger son tableau de consommation de base.',
+  },
+  {
+    name: 'Entrer la largeur du tissu',
+    text: 'Mesurez la largeur de lisière en lisière du tissu que vous prévoyez d\'acheter (90, 115, 140 ou 150 cm).',
+  },
+  {
+    name: 'Sélectionner la taille',
+    text: 'Ajustez le volume du vêtement selon la taille (XS-S, M-L, XL-XXL) pour recalculer le facteur multiplicatif.',
+  },
+  {
+    name: 'Obtenir les mètres totaux',
+    text: 'Vérifiez le résultat final avec et sans marge de couture pour savoir exactement combien commander en magasin.',
+  },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema: WithContext<HowTo> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((step) => ({
+    '@type': 'HowToStep',
+    name: step.name,
+    text: step.text,
+  })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'UtilityApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  inLanguage: 'fr',
+};
+
+export const content: ToolLocaleContent<FabricProjectCalculatorUI> = {
+  slug,
+  title,
+  description,
+  faqTitle: 'Questions Fréquentes',
+  faq: faqData,
+  bibliographyTitle: 'Bibliographie',
+  bibliography: [
+    {
+      name: 'Fabric Estimation Guide - Threads Magazine',
+      url: 'https://www.threadsmagazine.com/forum/measuring-fabric',
+    },
+    {
+      name: 'How much fabric do I need? - Seamwork',
+      url: 'https://www.seamwork.com/sewing-tutorials/the-anatomy-of-a-sewing-pattern',
+    },
+    {
+      name: 'Standard Fabric Consumption Charts - Textile School',
+      url: 'https://www.textileschool.com/209/fabric-consumption-in-garment-making/',
+    },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    {
+      type: 'title',
+      text: 'Calculateur de Mètres de Tissu pour la Couture: Guide de Consommation',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'L\'une des questions les plus fréquentes dans l\'atelier de couture est de déterminer la quantité de tissu à acheter pour un projet spécifique. La consommation de tissu dépend radicalement de trois facteurs: le modèle du vêtement, la taille de la personne et surtout la largeur du tissu (qui oscille généralement entre 90 cm et 150 cm). Ce calculateur technique systématise le calcul pour que vous n\'achetiez ni trop ni trop peu.',
+    },
+    {
+      type: 'title',
+      text: 'Quelle quantité de tissu pour une robe ou un pantalon?',
+      level: 3,
+    },
+    {
+      type: 'paragraph',
+      html: 'Le calcul traditionnel est basé sur la longueur du vêtement plus la longueur des manches, avec une marge pour les parements et l\'ourlet. Cependant, avec un tissu étroit (90-110 cm), les pièces ne peuvent souvent pas se placer côte à côte, obligeant à acheter le double de longueur. Notre outil tient compte de ces variations automatiquement selon les normes de l\'industrie textile.',
+    },
+    {
+      type: 'title',
+      text: 'Consommation Estimée selon la Largeur du Tissu (taille M-L)',
+      level: 3,
+    },
+    {
+      type: 'list',
+      items: [
+        '<strong>Jupe Droite:</strong> 2,00 m en tissu de 90 cm · 1,20 m en tissu de 140/150 cm.',
+        '<strong>Pantalon Long:</strong> 2,50 m en tissu de 90 cm · 1,50 m en tissu de 140/150 cm.',
+        '<strong>Chemise Manches Longues:</strong> 2,20 m en tissu de 90 cm · 1,40 m en tissu de 140/150 cm.',
+        '<strong>Robe Basique:</strong> 3,50 m en tissu de 90 cm · 2,20 m en tissu de 140/150 cm.',
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Facteurs qui Modifient la Consommation de Tissu',
+      level: 3,
+    },
+    {
+      type: 'list',
+      items: [
+        '<strong>Direction du motif (Raccord):</strong> Si le tissu a un motif directionnel ou des carreaux à faire correspondre, vous aurez besoin de 15 à 20% de matière supplémentaire.',
+        '<strong>Coupe en biais:</strong> Les coupes circulaires (comme les jupes cercle) consomment beaucoup plus de tissu à cause des pertes aux angles.',
+        '<strong>Sens du poil:</strong> Dans les tissus à poils comme le velours ou le velours côtelé, toutes les pièces doivent être coupées dans le même sens.',
+        '<strong>Rétrécissement:</strong> De nombreuses fibres naturelles (coton, lin, laine) rétrécissent après le premier lavage. Il est essentiel de pré-laver le tissu avant de couper.',
+      ],
+    },
+    {
+      type: 'tip',
+      title: 'Conseil du Couturier',
+      html: '<p>Si vous utilisez un tissu à grand motif ou à carreaux, ne vous fiez pas uniquement à la mesure standard. Ajoutez toujours une répétition complète du motif (le raccord) au total de mètres calculé pour garantir que les motifs correspondent aux coutures latérales.</p>',
+    },
+    {
+      type: 'title',
+      text: 'Avantages et Limites de ce Calculateur',
+      level: 3,
+    },
+    {
+      type: 'list',
+      items: [
+        'Calcul instantané pour plusieurs largeurs de tissu avec ajustement de taille.',
+        'Inclut une estimation de marge de couture personnalisable.',
+        'Guide visuel de disposition des pièces sur le tissu.',
+        'Ne remplace pas une disposition de patron réelle (marquage). Les grandes tailles peuvent nécessiter des ajustements manuels supplémentaires.',
+      ],
+    },
+    {
+      type: 'card',
+      title: 'Largeur du tissu',
+      icon: 'mdi:arrow-expand-horizontal',
+      html: 'La mesure transversale du tissu de <strong>lisière en lisière</strong>. Détermine si les pièces du patron peuvent être placées en parallèle ou doivent être disposées en série.',
+    },
+    {
+      type: 'card',
+      title: 'Marge de couture',
+      icon: 'mdi:tape-measure',
+      html: 'La distance entre le bord du patron et la <strong>ligne de couture finale</strong>. Une valeur standard est de 1,5 cm pour les coutures de vêtements.',
+    },
+    {
+      type: 'card',
+      title: 'Lisière',
+      icon: 'mdi:content-cut',
+      html: 'Les bords latéraux renforcés du tissu qui <strong>ne s\'effilochent pas</strong>. Ils indiquent la direction du fil et servent de référence pour la coupe.',
+    },
+  ],
+  ui: {
+    sectionProject: 'Projet',
+    sectionMaterial: 'Matière',
+    labelGarmentType: 'Type de vêtement',
+    labelSize: 'Taille',
+    labelFabricWidth: 'Largeur du tissu (cm)',
+    labelSeamAllowance: 'Marge de couture (cm)',
+    garmentSkirt: 'Jupe (Droite/Évasée)',
+    garmentPants: 'Pantalon',
+    garmentDress: 'Robe',
+    garmentShirt: 'Chemise / Blouse',
+    garmentCoat: 'Manteau / Veste',
+    garmentTote: 'Tote Bag',
+    garmentMerceria: {
+      skirt: '1 fermeture 20cm, 1 bouton',
+      pants: '1 fermeture 20cm, 1 bouton, 30cm entoilage',
+      dress: '1 fermeture 60cm, 50cm entoilage',
+      shirt: '7 boutons, 1m entoilage léger',
+      coat: '3 grands boutons, 1,5m entoilage, doublure',
+      tote: '2m sangle pour anses',
+    },
+    sizeXS: 'XS-S',
+    sizeM: 'M-L',
+    sizeXL: 'XL-XXL',
+    width90: '90 cm (Étroit)',
+    width115: '115 cm (Patchwork)',
+    width140: '140 cm (Standard EU)',
+    width150: '150 cm (Ameublement)',
+    btnClear: 'Effacer',
+    btnShare: 'Partager',
+    btnCopied: 'Copié!',
+    btnCopyList: 'Copier la liste',
+    resultLabel: 'Il vous faut:',
+    resultUnit: 'Mètres',
+    shopAdviceFormat: 'Commandez {m}m en magasin',
+    boardEmpty: 'Sélectionnez un projet pour voir la disposition',
+    boardDescFormat: 'Largeur: {w}cm | Longueur: {m}m',
+    merchTitle: 'Mercerie et Matériaux',
+    checklistThread: 'Fil assorti',
+    warningSerialFormat: 'En tissu de {w}cm, les pièces de votre taille ne tiennent pas en parallèle. Consommation ajustée pour la coupe en série.',
+    foldLabel: '⊟ pli',
+    pieceNames: {
+      front: 'Devant',
+      back: 'Dos',
+      waistband: 'Ceinture',
+      waistbelt: 'Ceinture',
+      sleeve: 'Manche',
+      collar: 'Col',
+      cuffs: 'Poignets',
+      facings: 'Parements',
+      lapels: 'Revers',
+      pocket: 'Poche',
+      body: 'Corps',
+      handleA: 'Anse A',
+      handleB: 'Anse B',
+    },
+  },
+};

package/src/tool/fabricProjectCalculator/index.ts

@@ -0,0 +1,34 @@
+import type { TextilesToolEntry, ToolLocaleContent, ToolDefinition } from '../../types';
+import FabricProjectCalculatorComponent from './component.astro';
+import FabricProjectCalculatorSEO from './seo.astro';
+import FabricProjectCalculatorBibliography from './bibliography.astro';
+
+import type { FabricProjectCalculatorUI } from './ui';
+
+export type FabricProjectCalculatorLocaleContent = ToolLocaleContent<FabricProjectCalculatorUI>;
+
+import { content as es } from './i18n/es';
+import { content as en } from './i18n/en';
+import { content as fr } from './i18n/fr';
+
+export const fabricProjectCalculator: TextilesToolEntry<FabricProjectCalculatorUI> = {
+  id: 'fabric-project-calculator',
+  icons: {
+    bg: 'mdi:content-cut',
+    fg: 'mdi:tape-measure',
+  },
+  i18n: {
+    es: async () => es,
+    en: async () => en,
+    fr: async () => fr,
+  },
+};
+
+export { FabricProjectCalculatorComponent, FabricProjectCalculatorSEO, FabricProjectCalculatorBibliography };
+
+export const FABRIC_PROJECT_CALCULATOR_TOOL: ToolDefinition = {
+  entry: fabricProjectCalculator,
+  Component: FabricProjectCalculatorComponent,
+  SEOComponent: FabricProjectCalculatorSEO,
+  BibliographyComponent: FabricProjectCalculatorBibliography,
+};

package/src/tool/fabricProjectCalculator/logic.ts

@@ -0,0 +1,89 @@
+export interface PieceSpec {
+  nameKey: string;
+  w: number;
+  fold?: boolean;
+  col: number;
+}
+
+export interface PieceRow {
+  h: number;
+  pieces: PieceSpec[];
+}
+
+export const PIECE_ROWS: Record<string, PieceRow[]> = {
+  skirt: [
+    { h: 0.38, pieces: [{ nameKey: 'front', w: 0.88, fold: true, col: 0 }] },
+    { h: 0.33, pieces: [{ nameKey: 'back', w: 0.44, col: 1 }, { nameKey: 'back', w: 0.44, col: 1 }] },
+    { h: 0.12, pieces: [{ nameKey: 'waistband', w: 0.88, col: 2 }] },
+  ],
+  pants: [
+    { h: 0.32, pieces: [{ nameKey: 'front', w: 0.44, col: 0 }, { nameKey: 'front', w: 0.44, col: 0 }] },
+    { h: 0.30, pieces: [{ nameKey: 'back', w: 0.44, col: 1 }, { nameKey: 'back', w: 0.44, col: 1 }] },
+    { h: 0.09, pieces: [{ nameKey: 'waistbelt', w: 0.88, fold: true, col: 2 }] },
+    { h: 0.12, pieces: [{ nameKey: 'pocket', w: 0.22, col: 5 }, { nameKey: 'pocket', w: 0.22, col: 5 }] },
+  ],
+  dress: [
+    { h: 0.36, pieces: [{ nameKey: 'front', w: 0.88, fold: true, col: 0 }] },
+    { h: 0.27, pieces: [{ nameKey: 'back', w: 0.44, col: 1 }, { nameKey: 'back', w: 0.44, col: 1 }] },
+    { h: 0.22, pieces: [{ nameKey: 'sleeve', w: 0.44, col: 3 }, { nameKey: 'sleeve', w: 0.44, col: 3 }] },
+    { h: 0.08, pieces: [{ nameKey: 'facings', w: 0.88, col: 4 }] },
+  ],
+  shirt: [
+    { h: 0.35, pieces: [{ nameKey: 'front', w: 0.44, col: 0 }, { nameKey: 'front', w: 0.44, col: 0 }] },
+    { h: 0.28, pieces: [{ nameKey: 'back', w: 0.88, fold: true, col: 1 }] },
+    { h: 0.20, pieces: [{ nameKey: 'sleeve', w: 0.44, col: 3 }, { nameKey: 'sleeve', w: 0.44, col: 3 }] },
+    { h: 0.08, pieces: [{ nameKey: 'collar', w: 0.40, col: 2 }, { nameKey: 'collar', w: 0.40, col: 2 }] },
+    { h: 0.06, pieces: [{ nameKey: 'cuffs', w: 0.35, col: 4 }, { nameKey: 'cuffs', w: 0.35, col: 4 }] },
+  ],
+  coat: [
+    { h: 0.32, pieces: [{ nameKey: 'front', w: 0.44, col: 0 }, { nameKey: 'front', w: 0.44, col: 0 }] },
+    { h: 0.30, pieces: [{ nameKey: 'back', w: 0.88, fold: true, col: 1 }] },
+    { h: 0.20, pieces: [{ nameKey: 'sleeve', w: 0.44, col: 3 }, { nameKey: 'sleeve', w: 0.44, col: 3 }] },
+    { h: 0.08, pieces: [{ nameKey: 'collar', w: 0.78, col: 2 }] },
+    { h: 0.06, pieces: [{ nameKey: 'lapels', w: 0.55, col: 4 }] },
+  ],
+  tote: [
+    { h: 0.62, pieces: [{ nameKey: 'body', w: 0.44, col: 0 }, { nameKey: 'body', w: 0.44, col: 0 }] },
+    { h: 0.20, pieces: [{ nameKey: 'handleA', w: 0.15, col: 5 }, { nameKey: 'handleB', w: 0.15, col: 5 }] },
+  ],
+};
+
+export const CONSUMPTION_MATRIX: Record<string, Record<string, number>> = {
+  skirt: { '90': 2.0, '115': 1.5, '140': 1.2, '150': 1.1 },
+  pants: { '90': 2.5, '115': 2.2, '140': 1.6, '150': 1.5 },
+  dress: { '90': 3.5, '115': 3.0, '140': 2.5, '150': 2.2 },
+  shirt: { '90': 2.2, '115': 1.8, '140': 1.4, '150': 1.2 },
+  coat: { '90': 4.5, '115': 3.8, '140': 3.0, '150': 2.8 },
+  tote: { '90': 1.2, '115': 1.0, '140': 0.8, '150': 0.7 },
+};
+
+export const SIZE_MULTS: Record<string, number> = {
+  xs_core: 0.88,
+  m_core: 1.0,
+  xl_core: 1.25,
+};
+
+export const SIZE_MIN_WIDTHS: Record<string, number> = {
+  xs_core: 40,
+  m_core: 55,
+  xl_core: 70,
+};
+
+export function isSerialCut(minWidth: number, fabricWidth: number, garment: string): boolean {
+  return garment !== 'tote' && minWidth * 2 > fabricWidth;
+}
+
+export function computeMeters(base: number, mult: number, serial: boolean, allowCm: number): number {
+  return parseFloat(((base * mult * (serial ? 1.4 : 1)) + allowCm * 0.1).toFixed(2));
+}
+
+export function shopAdviceMeters(meters: number): number {
+  const rounded = Math.ceil(meters * 4) / 4;
+  return rounded < meters + 0.1 ? rounded + 0.25 : rounded;
+}
+
+export function getRulerStep(totalMeters: number): number {
+  if (totalMeters <= 1.5) return 0.25;
+  if (totalMeters <= 3) return 0.5;
+  return 1;
+}

package/src/tool/fabricProjectCalculator/seo.astro

@@ -0,0 +1,40 @@
+---
+import {
+  SEOTitle,
+  SEOCard,
+  SEOTip,
+  SEOList,
+  SEOArticle
+} from '@jjlmoya/utils-shared';
+import { fabricProjectCalculator } from './index';
+import type { KnownLocale } from '../../types';
+
+interface Props {
+  locale?: KnownLocale;
+}
+
+const { locale = 'es' } = Astro.props;
+const content = await fabricProjectCalculator.i18n[locale]?.();
+if (!content) return null;
+
+const { seo } = content;
+---
+
+<SEOArticle>
+  {seo.map((section: any) => {
+    switch (section.type) {
+      case 'title':
+        return <SEOTitle title={section.text} level={section.level || 2} />;
+      case 'paragraph':
+        return <p set:html={section.html} />;
+      case 'list':
+        return <SEOList items={section.items} />;
+      case 'card':
+        return <SEOCard title={section.title} icon={section.icon}><Fragment set:html={section.html} /></SEOCard>;
+      case 'tip':
+        return <SEOTip title={section.title}><Fragment set:html={section.html} /></SEOTip>;
+      default:
+        return null;
+    }
+  })}
+</SEOArticle>

package/src/tool/fabricProjectCalculator/ui.ts

@@ -0,0 +1,57 @@
+export interface FabricProjectCalculatorUI {
+  sectionProject: string;
+  sectionMaterial: string;
+  labelGarmentType: string;
+  labelSize: string;
+  labelFabricWidth: string;
+  labelSeamAllowance: string;
+  garmentSkirt: string;
+  garmentPants: string;
+  garmentDress: string;
+  garmentShirt: string;
+  garmentCoat: string;
+  garmentTote: string;
+  garmentMerceria: {
+    skirt: string;
+    pants: string;
+    dress: string;
+    shirt: string;
+    coat: string;
+    tote: string;
+  };
+  sizeXS: string;
+  sizeM: string;
+  sizeXL: string;
+  width90: string;
+  width115: string;
+  width140: string;
+  width150: string;
+  btnClear: string;
+  btnShare: string;
+  btnCopied: string;
+  btnCopyList: string;
+  resultLabel: string;
+  resultUnit: string;
+  shopAdviceFormat: string;
+  boardEmpty: string;
+  boardDescFormat: string;
+  merchTitle: string;
+  checklistThread: string;
+  warningSerialFormat: string;
+  foldLabel: string;
+  pieceNames: {
+    front: string;
+    back: string;
+    waistband: string;
+    waistbelt: string;
+    sleeve: string;
+    collar: string;
+    cuffs: string;
+    facings: string;
+    lapels: string;
+    pocket: string;
+    body: string;
+    handleA: string;
+    handleB: string;
+  };
+}

package/src/tool/fabricTruth/bibliography.astro

@@ -0,0 +1,40 @@
+---
+---
+
+<div class="space-y-4">
+  <a
+    href="https://www.ftc.gov/business-guidance/resources/textile-fiber-products-guides"
+    target="_blank"
+    rel="noopener noreferrer"
+    class="block p-4 bg-white dark:bg-slate-800 rounded-lg border border-slate-200 dark:border-slate-700 hover:border-indigo-500 dark:hover:border-indigo-400 transition-colors"
+  >
+    <p class="font-semibold text-slate-900 dark:text-white">FTC - Guía de Etiquetado Textil</p>
+    <p class="text-sm text-slate-600 dark:text-slate-400">
+      Regulaciones oficiales sobre etiquetado de fibras textiles en EE.UU.
+    </p>
+  </a>
+
+  <a
+    href="https://ec.europa.eu/growth/tools-databases/nando/"
+    target="_blank"
+    rel="noopener noreferrer"
+    class="block p-4 bg-white dark:bg-slate-800 rounded-lg border border-slate-200 dark:border-slate-700 hover:border-indigo-500 dark:hover:border-indigo-400 transition-colors"
+  >
+    <p class="font-semibold text-slate-900 dark:text-white">Comisión Europea - Regulación Textil</p>
+    <p class="text-sm text-slate-600 dark:text-slate-400">
+      Base de datos de regulaciones textiles de la UE
+    </p>
+  </a>
+
+  <a
+    href="https://www.iso.org/standard/60465.html"
+    target="_blank"
+    rel="noopener noreferrer"
+    class="block p-4 bg-white dark:bg-slate-800 rounded-lg border border-slate-200 dark:border-slate-700 hover:border-indigo-500 dark:hover:border-indigo-400 transition-colors"
+  >
+    <p class="font-semibold text-slate-900 dark:text-white">ISO 3758:2012 - Símbolos de Cuidado Textil</p>
+    <p class="text-sm text-slate-600 dark:text-slate-400">
+      Estándar internacional para símbolos de mantenimiento textil
+    </p>
+  </a>
+</div>