@jjlmoya/utils-performing-arts 1.1.0

package/src/tool/rehearsal-call-sheet-planner/i18n/zh.ts

@@ -0,0 +1,48 @@
+import type { FAQPage, HowTo, SoftwareApplication, WithContext } from 'schema-dts';
+import { bibliography } from '../bibliography';
+import type { RehearsalCallSheetLocaleContent, RehearsalCallSheetUI } from '../entry';
+import type { FAQItem, HowToStep, SEOSection } from '../../../types';
+
+const ui: RehearsalCallSheetUI = {
+  productionSection: '制作信息', showName: '剧目名称', showNamePlaceholder: '例如 樱桃园', date: '排练日期', timingSection: '时间与休息', dayStart: '工作日开始', dayEnd: '工作日结束', breakMinutes: '场次之间的休息时间（分钟）', sceneSection: '场次与工作顺序', scenesLabel: '场次', scenesHint: '每行一个场次：名称 | 分钟数 | 参与人员 | 房间', availabilitySection: '可用时间', participantAvailability: '参与人员的可用时间', participantHint: '每人一行：姓名 | 开始 | 结束。请加入场次所需的所有人员。', roomAvailability: '房间可用时间', roomHint: '每个房间一行：房间 | 开始 | 结束。', notes: '团队备注', notesPlaceholder: '添加目标、道具或重要提醒。', presets: '示例方案', presetDay: '普通工作日', presetTight: '紧凑日程', presetShowcase: '演出展示', resultSection: '排练计划草稿', scheduled: '已安排', conflicts: '冲突', unscheduled: '未安排', minutes: '分钟', timelineLabel: '时间线', callSheetLabel: '排练召集表', statusScheduled: '已安排', statusConflict: '需要检查', statusUnscheduled: '未安排', issueDayOverflow: '场次超出了工作日范围。', issueParticipantAvailability: '场次超出了一个或多个参与人员的可用时间。', issueRoomAvailability: '场次超出了房间的可用时间。', issueMissingParticipantAvailability: '没有填写该参与人员的可用时间。', issueMissingRoomAvailability: '没有填写该房间的可用时间。', participantSummary: '参与人员', roomSummary: '房间', scene: '场次', room: '房间', participants: '参与人员', time: '时间', status: '状态', detail: '详情', dateNotSet: '未设置日期', untitledProduction: '未命名制作', noRoom: '未填写房间', noPeople: '未填写参与人员', readyDetail: '所有场次都位于工作日和已填写的可用时间内。', scenes: '个场次', firstCall: '首次召集', lastCall: '最后召集', inputIssuesTitle: '请检查输入内容', inputIssuesHint: '部分行无法识别，因此没有被纳入计算。', scenesInput: '场次', peopleInput: '参与人员', roomsInput: '房间', line: '行', summaryReady: '这份草稿已经可以交给制作团队审核并打印。', summaryAttention: '发送排练召集表前，请先检查标记出的场次。', summaryInputIssues: '请修正有问题的行，让计划包含你输入的全部信息。', noScenes: '请至少添加一个场次来生成排练召集表。', exportData: '导出数据', print: '打印', reset: '重置', rulesNote: '计算会考虑场次时长、休息时间、参与人员和房间的可用时间。最终决定由制作团队负责。', rulesLinkLabel: '了解更多工作时间规则',
+};
+
+const faq: FAQItem[] = [
+  { question: '什么是排练召集表？', answer: '排练召集表是一天的工作计划，列出场次、召集时间、参与人员、房间和团队备注。' },
+  { question: '如何制作排练召集表？', answer: '填写场次时长、参与人员、房间、工作时间和休息时间，然后检查时间线与冲突。' },
+  { question: '为什么某个场次标记为需要检查？', answer: '该场次可能与参与人员或房间的不可用时间冲突，也可能超出工作日范围。' },
+  { question: '这个工具能生成完美的计划吗？', answer: '工具会生成连续的草稿并清楚显示限制，但制作团队仍需要检查优先级并作出最终决定。' },
+  { question: '我的数据会被保存吗？', answer: '不会。数据在浏览器中处理，本工具不会把数据发送到服务器。' },
+  { question: '工具会考虑工作时间规定吗？', answer: '工具可以帮助你查看工作时间和可用时间，但不能替代对适用法律、合同或机构规则的检查。' },
+];
+
+const howTo: HowToStep[] = [
+  { name: '填写制作信息和日期', text: '输入剧目名称和排练日期。' },
+  { name: '添加场次', text: '为每个场次填写名称、时长、参与人员和房间。' },
+  { name: '添加可用时间', text: '填写所需参与人员和房间的可用时间。' },
+  { name: '检查时间线', text: '查看召集时间、休息时间、冲突和无法安排的场次。' },
+  { name: '打印草稿', text: '添加团队备注，完成最终检查后打印召集表。' },
+];
+
+const faqSchema: WithContext<FAQPage> = { '@context': 'https://schema.org', '@type': 'FAQPage', mainEntity: faq.map((item) => ({ '@type': 'Question', name: item.question, acceptedAnswer: { '@type': 'Answer', text: item.answer } })) };
+const appSchema: WithContext<SoftwareApplication> = { '@context': 'https://schema.org', '@type': 'SoftwareApplication', name: '排练召集表', operatingSystem: 'All', applicationCategory: 'BusinessApplication', description: '根据场次、参与人员、房间和可用时间制作清晰的戏剧排练召集表。' };
+const howToSchema: WithContext<HowTo> = { '@context': 'https://schema.org', '@type': 'HowTo', name: '如何制作排练召集表', step: howTo.map((step) => ({ '@type': 'HowToStep', name: step.name, text: step.text })) };
+
+const seo: SEOSection[] = [
+  { type: 'title', text: '如何制作排练召集表', level: 2 },
+  { type: 'paragraph', html: '好的召集表会把排练计划变成团队都能理解的共同安排。本计划器会按时间放置场次，计算休息时间，并在排练开始前显示可用时间问题，让导演、舞台管理和演员都能提前发现需要协调的地方。' },
+  { type: 'title', text: '一份有用的召集表应包含什么', level: 2 },
+  { type: 'paragraph', html: '填写剧目名称、日期、场次时长、参与人员、房间和工作时间。输入信息越准确，团队审核草稿就越容易，也越能避免排练当天临时调整。' },
+  { type: 'table', headers: ['字段', '用途'], rows: [['场次', '确定工作顺序和时长'], ['参与人员', '显示每个场次需要哪些人'], ['房间', '帮助避免不同空间之间的冲突'], ['休息时间', '在场次之间留出实际可行的时间']] },
+  { type: 'title', text: '如何阅读时间线', level: 2 },
+  { type: 'paragraph', html: '首次召集表示第一个已安排场次的开始时间，最后召集帮助你看到工作计划的结束时间。需要检查表示草稿需要团队作出决定，不能直接当作最终通知。' },
+  { type: 'title', text: '发送前检查草稿', level: 2 },
+  { type: 'list', items: ['检查日期、工作时间和休息时长。', '确认参与人员和房间的名称前后一致。', '与制作团队一起处理所有可用时间冲突。', '补充道具、目标和当天优先事项等实际备注。'] },
+  { type: 'title', text: '透明的草稿把判断留给人', level: 2 },
+  { type: 'paragraph', html: '自动生成的计划适合作为第一版，但它不了解艺术优先级、团队疲劳程度或某个场次的紧迫性。请把它用于提高透明度，而不是替代制作团队的判断。' },
+  { type: 'tip', title: '把可用时间作为沟通的起点', html: '如果某一行无法识别，或某个场次超出了可用时间，请先修正输入，再把召集表发送给团队。' },
+  { type: 'title', text: '打印一份真正好用的排练召集表', level: 2 },
+  { type: 'paragraph', html: '完成审核后打印简明计划，并把它放在排练笔记旁边。召集表应该让团队快速知道何时以及在哪里集合。' },
+];
+
+export const content: RehearsalCallSheetLocaleContent = { slug: 'rehearsal-call-sheet-planner', title: '戏剧排练召集表', description: '根据场次、演员、房间、可用时间和休息安排制作戏剧排练召集表。打印清晰的日程，并在召集前发现冲突。', ui, faq, howTo, seo, bibliography, schemas: [faqSchema, appSchema, howToSchema] as unknown as Record<string, unknown>[] };

package/src/tool/rehearsal-call-sheet-planner/index.ts

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

package/src/tool/rehearsal-call-sheet-planner/logic.test.ts

@@ -0,0 +1,68 @@
+import { describe, expect, it } from 'vitest';
+import { calculateCallSheet, formatTime, parseAvailability, parseScenes, parseTime } from './logic';
+import { DEFAULT_SETTINGS } from './logic';
+
+describe('rehearsal call sheet logic', () => {
+  it('parses and formats clock values', () => {
+    expect(parseTime('09:30')).toBe(570);
+    expect(parseTime('25:00')).toBeNull();
+    expect(formatTime(1439)).toBe('23:59');
+  });
+
+  it('parses scene and availability rows', () => {
+    expect(parseScenes('Warm up | 30 | Studio | Alex, Bea | Notes')).toEqual([{
+      id: 'scene-1', name: 'Warm up', duration: 30, room: 'Studio', participants: ['Alex', 'Bea'], notes: 'Notes',
+    }]);
+    expect(Object.keys(parseAvailability('Alex | 09:00-12:00'))).toEqual(['alex']);
+  });
+
+  it('surfaces malformed input instead of dropping it silently', () => {
+    const result = calculateCallSheet({
+      ...DEFAULT_SETTINGS,
+      scenesText: 'Warm up | 30 | Studio | Alex | Notes\nBroken scene',
+      participantAvailabilityText: 'Alex | not-a-time',
+      roomAvailabilityText: 'Studio | 09:00-18:00\nBroken room',
+    });
+    expect(result.scenes).toHaveLength(1);
+    expect(result.inputIssues).toEqual([
+      { section: 'scenes', line: 2, value: 'Broken scene', detail: 'Add a scene name and a positive duration in minutes.' },
+      { section: 'people', line: 1, value: 'Alex | not-a-time', detail: 'Use times like 09:00-18:00 with the end after the start.' },
+      { section: 'rooms', line: 2, value: 'Broken room', detail: 'Use Name | first call-last call.' },
+    ]);
+  });
+
+  it('keeps the starter draft conflict free', () => {
+    const result = calculateCallSheet(DEFAULT_SETTINGS);
+    expect(result.conflictCount).toBe(0);
+    expect(result.unscheduledCount).toBe(0);
+    expect(result.inputIssues).toEqual([]);
+  });
+
+  it('marks availability conflicts and keeps the schedule readable', () => {
+    const result = calculateCallSheet({
+      ...DEFAULT_SETTINGS,
+      dayStart: '09:00',
+      dayEnd: '11:00',
+      breakMinutes: 0,
+      scenesText: 'Scene one | 60 | Studio | Alex | ',
+      participantAvailabilityText: 'Alex | 10:00-18:00',
+      roomAvailabilityText: 'Studio | 09:00-18:00',
+    });
+    expect(result.scenes[0]?.status).toBe('conflict');
+    expect(result.scenes[0]?.issues[0]?.key).toBe('participantAvailability');
+  });
+
+  it('marks scenes beyond the working day as unscheduled', () => {
+    const result = calculateCallSheet({
+      ...DEFAULT_SETTINGS,
+      dayStart: '09:00',
+      dayEnd: '10:00',
+      breakMinutes: 0,
+      scenesText: 'Scene one | 90 | Studio | Alex | ',
+      participantAvailabilityText: 'Alex | 09:00-18:00',
+      roomAvailabilityText: 'Studio | 09:00-18:00',
+    });
+    expect(result.unscheduledCount).toBe(1);
+    expect(result.scenes[0]?.status).toBe('unscheduled');
+  });
+});

package/src/tool/rehearsal-call-sheet-planner/logic.ts

@@ -0,0 +1,229 @@
+import type {
+  AvailabilityMap,
+  AvailabilityWindow,
+  CallSheetResult,
+  InputIssue,
+  PersonSummary,
+  PlannerSettings,
+  RoomSummary,
+  SceneInput,
+  SceneIssue,
+  ScheduledScene,
+} from './types';
+
+export const DEFAULT_SETTINGS: PlannerSettings = {
+  showName: 'The Glass Menagerie',
+  date: '',
+  dayStart: '09:00',
+  dayEnd: '18:00',
+  breakMinutes: 15,
+  scenesText: 'Table read | 60 | Studio | Director, Alex, Bea | Pages 1 to 18\nBlocking scene 1 | 90 | Studio | Alex, Bea, Chris | Bring rehearsal props\nFight call | 45 | Black box | Alex, Chris | Slow work only\nRun scene 2 | 75 | Studio | Bea, Chris | Notes after the run',
+  participantAvailabilityText: 'Director | 09:00-18:00\nAlex | 09:00-17:00\nBea | 09:00-18:00\nChris | 09:00-16:30',
+  roomAvailabilityText: 'Studio | 09:00-18:00\nBlack box | 09:00-13:00',
+  notes: 'Wear rehearsal clothes. Bring the scene folders and water bottles.',
+};
+
+function clamp(value: number, min: number, max: number): number {
+  return Math.min(Math.max(value, min), max);
+}
+
+export function parseTime(value: string): number | null {
+  const match = value.trim().match(/^(\d{1,2}):([0-5]\d)$/);
+  if (!match) return null;
+  const hour = Number(match[1]);
+  const minute = Number(match[2]);
+  if (hour > 23) return null;
+  return hour * 60 + minute;
+}
+
+export function formatTime(totalMinutes: number): string {
+  const safeMinutes = ((Math.round(totalMinutes) % 1440) + 1440) % 1440;
+  const hour = Math.floor(safeMinutes / 60).toString().padStart(2, '0');
+  const minute = (safeMinutes % 60).toString().padStart(2, '0');
+  return `${hour}:${minute}`;
+}
+
+function parseRange(value: string): AvailabilityWindow | null {
+  const parts = value.split('-').map((part) => part.trim());
+  if (parts.length !== 2) return null;
+  const start = parseTime(parts[0] ?? '');
+  const end = parseTime(parts[1] ?? '');
+  if (start === null || end === null || end <= start) return null;
+  return { start, end };
+}
+
+function normalizeName(value: string): string {
+  return value.trim().toLocaleLowerCase();
+}
+
+export function parseAvailability(text: string): AvailabilityMap {
+  return parseAvailabilityDetailed(text, 'people').map;
+}
+
+interface AvailabilityParseResult {
+  map: AvailabilityMap;
+  issues: InputIssue[];
+}
+
+function parseAvailabilityDetailed(text: string, section: 'people' | 'rooms'): AvailabilityParseResult {
+  const result: AvailabilityMap = {};
+  const issues: InputIssue[] = [];
+  text.split('\n').forEach((line, index) => {
+    if (!line.trim()) return;
+    const [rawName, rawRange] = line.split('|').map((part) => part.trim());
+    if (!rawName || !rawRange) {
+      issues.push({ section, line: index + 1, value: line.trim(), detail: 'Use Name | first call-last call.' });
+      return;
+    }
+    const range = parseRange(rawRange);
+    if (!range) {
+      issues.push({ section, line: index + 1, value: line.trim(), detail: 'Use times like 09:00-18:00 with the end after the start.' });
+      return;
+    }
+    const key = normalizeName(rawName);
+    result[key] = [...(result[key] ?? []), range];
+  });
+  return { map: result, issues };
+}
+
+function parseParticipants(value: string): string[] {
+  return value.split(',').map((part) => part.trim()).filter(Boolean);
+}
+
+export function parseScenes(text: string): SceneInput[] {
+  return parseScenesDetailed(text).scenes;
+}
+
+interface SceneParseResult {
+  scenes: SceneInput[];
+  issues: InputIssue[];
+}
+
+function parseScenesDetailed(text: string): SceneParseResult {
+  const issues: InputIssue[] = [];
+  const scenes = text.split('\n').map((line, index) => {
+    if (!line.trim()) return null;
+    const [name, durationText, room, participantsText, notes] = line.split('|').map((part) => part.trim());
+    const duration = Number(durationText);
+    if (!name || !Number.isFinite(duration) || duration <= 0) {
+      issues.push({ section: 'scenes', line: index + 1, value: line.trim(), detail: 'Add a scene name and a positive duration in minutes.' });
+      return null;
+    }
+    return {
+      id: `scene-${index + 1}`,
+      name,
+      duration: clamp(Math.round(duration), 5, 720),
+      room: room ?? '',
+      participants: parseParticipants(participantsText ?? ''),
+      notes: notes ?? '',
+    };
+  }).filter((scene): scene is SceneInput => scene !== null);
+  return { scenes, issues };
+}
+
+function getWindows(map: AvailabilityMap, name: string): AvailabilityWindow[] {
+  return map[normalizeName(name)] ?? [];
+}
+
+function hasWindow(windows: AvailabilityWindow[], start: number, end: number): boolean {
+  return windows.some((window) => window.start <= start && window.end >= end);
+}
+
+function describeWindows(windows: AvailabilityWindow[]): string {
+  return windows.map((window) => `${formatTime(window.start)} to ${formatTime(window.end)}`).join(', ');
+}
+
+interface SchedulingContext {
+  settings: PlannerSettings;
+  people: AvailabilityMap;
+  rooms: AvailabilityMap;
+}
+
+function collectSceneIssues(scene: SceneInput, start: number, end: number, context: SchedulingContext): SceneIssue[] {
+  const { settings, people, rooms } = context;
+  const issues: SceneIssue[] = [];
+  if (end > parseTime(settings.dayEnd)!) issues.push({ key: 'dayOverflow', detail: settings.dayEnd });
+  scene.participants.forEach((person) => {
+    const key = normalizeName(person);
+    const windows = getWindows(people, person);
+    if (!people[key]) issues.push({ key: 'missingParticipantAvailability', detail: person });
+    else if (!hasWindow(windows, start, end)) issues.push({ key: 'participantAvailability', detail: `${person} (entered: ${describeWindows(windows)})` });
+  });
+  if (scene.room) {
+    const key = normalizeName(scene.room);
+    const windows = getWindows(rooms, scene.room);
+    if (!rooms[key]) issues.push({ key: 'missingRoomAvailability', detail: scene.room });
+    else if (!hasWindow(windows, start, end)) issues.push({ key: 'roomAvailability', detail: `${scene.room} (entered: ${describeWindows(windows)})` });
+  }
+  return issues;
+}
+
+function scheduleScenes(settings: PlannerSettings, scenes: SceneInput[], people: AvailabilityMap, rooms: AvailabilityMap): ScheduledScene[] {
+  const dayEnd = parseTime(settings.dayEnd)!;
+  let cursor = parseTime(settings.dayStart)!;
+  return scenes.map((scene) => {
+    const start = cursor;
+    const end = start + scene.duration;
+    const issues = collectSceneIssues(scene, start, end, { settings, people, rooms });
+    const isUnscheduled = start >= dayEnd || issues.some((issue) => issue.key === 'dayOverflow');
+    const status = getSceneStatus(isUnscheduled, issues);
+    cursor = end + clamp(Math.round(settings.breakMinutes), 0, 180);
+    return { ...scene, start, end, status, issues };
+  });
+}
+
+function getSceneStatus(isUnscheduled: boolean, issues: SceneIssue[]): ScheduledScene['status'] {
+  if (isUnscheduled) return 'unscheduled';
+  if (issues.length > 0) return 'conflict';
+  return 'scheduled';
+}
+
+function makePeopleSummary(scenes: ScheduledScene[]): PersonSummary[] {
+  const map = new Map<string, PersonSummary>();
+  scenes.filter((scene) => scene.status !== 'unscheduled').forEach((scene) => scene.participants.forEach((name) => {
+    const current = map.get(normalizeName(name));
+    if (current) {
+      current.sceneCount += 1;
+      current.firstCall = Math.min(current.firstCall, scene.start);
+      current.lastCall = Math.max(current.lastCall, scene.end);
+    } else map.set(normalizeName(name), { name, sceneCount: 1, firstCall: scene.start, lastCall: scene.end });
+  }));
+  return [...map.values()].sort((left, right) => left.firstCall - right.firstCall);
+}
+
+function makeRoomSummary(scenes: ScheduledScene[]): RoomSummary[] {
+  const map = new Map<string, RoomSummary>();
+  scenes.filter((scene) => scene.status !== 'unscheduled' && scene.room).forEach((scene) => {
+    const key = normalizeName(scene.room);
+    const current = map.get(key);
+    if (current) {
+      current.sceneCount += 1;
+      current.firstCall = Math.min(current.firstCall, scene.start);
+      current.lastCall = Math.max(current.lastCall, scene.end);
+    } else map.set(key, { name: scene.room, sceneCount: 1, firstCall: scene.start, lastCall: scene.end });
+  });
+  return [...map.values()].sort((left, right) => left.firstCall - right.firstCall);
+}
+
+export function calculateCallSheet(rawSettings: PlannerSettings): CallSheetResult {
+  const dayStart = parseTime(rawSettings.dayStart) ?? 540;
+  const parsedEnd = parseTime(rawSettings.dayEnd) ?? 1080;
+  const dayEnd = parsedEnd > dayStart ? parsedEnd : dayStart + 60;
+  const settings = { ...rawSettings, dayStart: formatTime(dayStart), dayEnd: formatTime(dayEnd) };
+  const parsedScenes = parseScenesDetailed(settings.scenesText);
+  const parsedPeople = parseAvailabilityDetailed(settings.participantAvailabilityText, 'people');
+  const parsedRooms = parseAvailabilityDetailed(settings.roomAvailabilityText, 'rooms');
+  const scenes = scheduleScenes(settings, parsedScenes.scenes, parsedPeople.map, parsedRooms.map);
+  return {
+    settings,
+    scenes,
+    dayStart,
+    dayEnd,
+    scheduledMinutes: scenes.filter((scene) => scene.status !== 'unscheduled').reduce((total, scene) => total + scene.duration, 0),
+    conflictCount: scenes.filter((scene) => scene.status === 'conflict').length,
+    unscheduledCount: scenes.filter((scene) => scene.status === 'unscheduled').length,
+    inputIssues: [...parsedScenes.issues, ...parsedPeople.issues, ...parsedRooms.issues],
+    people: makePeopleSummary(scenes),
+    rooms: makeRoomSummary(scenes),
+  };
+}