@things-factory/integration-label-studio 9.1.19

package/dist-server/types/prediction-types.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BatchPredictionResult = exports.PredictionGenerationResult = exports.BatchGeneratePredictionRequest = exports.GeneratePredictionRequest = void 0;
+const tslib_1 = require("tslib");
+const type_graphql_1 = require("type-graphql");
+// ============================================================================
+// Label Studio Prediction Generation Types
+// ============================================================================
+/**
+ * Label Studio prediction generation request
+ */
+let GeneratePredictionRequest = class GeneratePredictionRequest {
+};
+exports.GeneratePredictionRequest = GeneratePredictionRequest;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { description: 'Label Studio task ID' }),
+    tslib_1.__metadata("design:type", Number)
+], GeneratePredictionRequest.prototype, "taskId", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'Image URL from task data' }),
+    tslib_1.__metadata("design:type", String)
+], GeneratePredictionRequest.prototype, "imageUrl", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'AI model ID to use' }),
+    tslib_1.__metadata("design:type", String)
+], GeneratePredictionRequest.prototype, "modelId", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Float, { nullable: true, description: 'Confidence threshold (0-1)' }),
+    tslib_1.__metadata("design:type", Number)
+], GeneratePredictionRequest.prototype, "confidenceThreshold", void 0);
+exports.GeneratePredictionRequest = GeneratePredictionRequest = tslib_1.__decorate([
+    (0, type_graphql_1.InputType)({ description: 'Request to generate Label Studio predictions' })
+], GeneratePredictionRequest);
+/**
+ * Batch prediction generation request
+ */
+let BatchGeneratePredictionRequest = class BatchGeneratePredictionRequest {
+};
+exports.BatchGeneratePredictionRequest = BatchGeneratePredictionRequest;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { description: 'Label Studio project ID' }),
+    tslib_1.__metadata("design:type", Number)
+], BatchGeneratePredictionRequest.prototype, "projectId", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => [type_graphql_1.Int], { description: 'Array of task IDs' }),
+    tslib_1.__metadata("design:type", Array)
+], BatchGeneratePredictionRequest.prototype, "taskIds", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'AI model ID to use' }),
+    tslib_1.__metadata("design:type", String)
+], BatchGeneratePredictionRequest.prototype, "modelId", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Float, { nullable: true, description: 'Confidence threshold (0-1)' }),
+    tslib_1.__metadata("design:type", Number)
+], BatchGeneratePredictionRequest.prototype, "confidenceThreshold", void 0);
+exports.BatchGeneratePredictionRequest = BatchGeneratePredictionRequest = tslib_1.__decorate([
+    (0, type_graphql_1.InputType)({ description: 'Request to generate predictions for multiple tasks' })
+], BatchGeneratePredictionRequest);
+/**
+ * Prediction generation result
+ */
+let PredictionGenerationResult = class PredictionGenerationResult {
+};
+exports.PredictionGenerationResult = PredictionGenerationResult;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { description: 'Task ID' }),
+    tslib_1.__metadata("design:type", Number)
+], PredictionGenerationResult.prototype, "taskId", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { nullable: true, description: 'Created prediction ID' }),
+    tslib_1.__metadata("design:type", Number)
+], PredictionGenerationResult.prototype, "predictionId", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'Success status' }),
+    tslib_1.__metadata("design:type", Boolean)
+], PredictionGenerationResult.prototype, "success", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Error message if failed' }),
+    tslib_1.__metadata("design:type", String)
+], PredictionGenerationResult.prototype, "error", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { description: 'Number of detected objects' }),
+    tslib_1.__metadata("design:type", Number)
+], PredictionGenerationResult.prototype, "objectCount", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Float, { nullable: true, description: 'Average confidence score' }),
+    tslib_1.__metadata("design:type", Number)
+], PredictionGenerationResult.prototype, "avgConfidence", void 0);
+exports.PredictionGenerationResult = PredictionGenerationResult = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'Prediction generation result' })
+], PredictionGenerationResult);
+/**
+ * Batch prediction generation result
+ */
+let BatchPredictionResult = class BatchPredictionResult {
+};
+exports.BatchPredictionResult = BatchPredictionResult;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { description: 'Total tasks processed' }),
+    tslib_1.__metadata("design:type", Number)
+], BatchPredictionResult.prototype, "total", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { description: 'Number of successful predictions' }),
+    tslib_1.__metadata("design:type", Number)
+], BatchPredictionResult.prototype, "succeeded", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { description: 'Number of failed predictions' }),
+    tslib_1.__metadata("design:type", Number)
+], BatchPredictionResult.prototype, "failed", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => [PredictionGenerationResult], { description: 'Individual results' }),
+    tslib_1.__metadata("design:type", Array)
+], BatchPredictionResult.prototype, "results", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'Model version used' }),
+    tslib_1.__metadata("design:type", String)
+], BatchPredictionResult.prototype, "modelVersion", void 0);
+exports.BatchPredictionResult = BatchPredictionResult = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'Batch prediction generation result' })
+], BatchPredictionResult);
+//# sourceMappingURL=prediction-types.js.map

package/dist-server/types/prediction-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prediction-types.js","sourceRoot":"","sources":["../../server/types/prediction-types.ts"],"names":[],"mappings":"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","sourcesContent":["import { Field, ObjectType, InputType, Int, Float } from 'type-graphql'\n\n// ============================================================================\n// Label Studio Prediction Generation Types\n// ============================================================================\n\n/**\n * Label Studio prediction generation request\n */\n@InputType({ description: 'Request to generate Label Studio predictions' })\nexport class GeneratePredictionRequest {\n  @Field(type => Int, { description: 'Label Studio task ID' })\n  taskId: number\n\n  @Field({ description: 'Image URL from task data' })\n  imageUrl: string\n\n  @Field({ nullable: true, description: 'AI model ID to use' })\n  modelId?: string\n\n  @Field(type => Float, { nullable: true, description: 'Confidence threshold (0-1)' })\n  confidenceThreshold?: number\n}\n\n/**\n * Batch prediction generation request\n */\n@InputType({ description: 'Request to generate predictions for multiple tasks' })\nexport class BatchGeneratePredictionRequest {\n  @Field(type => Int, { description: 'Label Studio project ID' })\n  projectId: number\n\n  @Field(type => [Int], { description: 'Array of task IDs' })\n  taskIds: number[]\n\n  @Field({ nullable: true, description: 'AI model ID to use' })\n  modelId?: string\n\n  @Field(type => Float, { nullable: true, description: 'Confidence threshold (0-1)' })\n  confidenceThreshold?: number\n}\n\n/**\n * Prediction generation result\n */\n@ObjectType({ description: 'Prediction generation result' })\nexport class PredictionGenerationResult {\n  @Field(type => Int, { description: 'Task ID' })\n  taskId: number\n\n  @Field(type => Int, { nullable: true, description: 'Created prediction ID' })\n  predictionId?: number\n\n  @Field({ description: 'Success status' })\n  success: boolean\n\n  @Field({ nullable: true, description: 'Error message if failed' })\n  error?: string\n\n  @Field(type => Int, { description: 'Number of detected objects' })\n  objectCount: number\n\n  @Field(type => Float, { nullable: true, description: 'Average confidence score' })\n  avgConfidence?: number\n}\n\n/**\n * Batch prediction generation result\n */\n@ObjectType({ description: 'Batch prediction generation result' })\nexport class BatchPredictionResult {\n  @Field(type => Int, { description: 'Total tasks processed' })\n  total: number\n\n  @Field(type => Int, { description: 'Number of successful predictions' })\n  succeeded: number\n\n  @Field(type => Int, { description: 'Number of failed predictions' })\n  failed: number\n\n  @Field(type => [PredictionGenerationResult], { description: 'Individual results' })\n  results: PredictionGenerationResult[]\n\n  @Field({ description: 'Model version used' })\n  modelVersion: string\n}\n"]}

package/dist-server/utils/annotation-exporter.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Annotation Exporter
+ *
+ * Flexible annotation export system with pluggable format converters.
+ * Supports custom export formats for different use cases.
+ */
+export interface LabelStudioAnnotation {
+    id: number;
+    task: number;
+    project: number;
+    completed_by: {
+        id: number;
+        email: string;
+        first_name: string;
+        last_name: string;
+    };
+    result: Array<{
+        from_name: string;
+        to_name: string;
+        type: string;
+        value: any;
+    }>;
+    created_at: string;
+    updated_at: string;
+    lead_time?: number;
+}
+export interface ExportContext {
+    projectId: number;
+    projectTitle?: string;
+    exportedAt: string;
+    metadata?: any;
+}
+/**
+ * Export format converter function type
+ * Converts Label Studio annotations to custom format
+ */
+export type FormatConverter<T = any> = (annotations: LabelStudioAnnotation[], context: ExportContext) => T | Promise<T>;
+/**
+ * Register a custom export format converter
+ *
+ * @param formatName - Unique format identifier (e.g., "csv", "coco", "yolo")
+ * @param converter - Converter function
+ *
+ * @example
+ * registerExportFormat('csv', (annotations, context) => {
+ *   const rows = annotations.map(a => ({
+ *     id: a.id,
+ *     task: a.task,
+ *     result: JSON.stringify(a.result)
+ *   }))
+ *   return Papa.unparse(rows)
+ * })
+ */
+export declare function registerExportFormat<T = any>(formatName: string, converter: FormatConverter<T>): void;
+/**
+ * Unregister an export format
+ */
+export declare function unregisterExportFormat(formatName: string): void;
+/**
+ * Get all registered format names
+ */
+export declare function getRegisteredFormats(): string[];
+/**
+ * Export annotations to specified format
+ *
+ * @param annotations - Label Studio annotations
+ * @param format - Export format name
+ * @param context - Export context
+ * @returns Converted data in requested format
+ */
+export declare function exportAnnotations<T = any>(annotations: LabelStudioAnnotation[], format: string, context: ExportContext): Promise<T>;
+/**
+ * Pre-built export formats
+ */
+export declare class ExportFormats {
+    /**
+     * Export as JSON (default Label Studio format)
+     */
+    static json(): FormatConverter<string>;
+    /**
+     * Export as JSON Lines (one annotation per line)
+     */
+    static jsonl(): FormatConverter<string>;
+    /**
+     * Export image classification results as CSV
+     */
+    static imageClassificationCSV(): FormatConverter<string>;
+    /**
+     * Export Rank N classification results
+     */
+    static rankNClassificationCSV(ranks?: number): FormatConverter<string>;
+    /**
+     * Export object detection results as COCO format
+     */
+    static coco(): FormatConverter<any>;
+    /**
+     * Export object detection results as YOLO format
+     */
+    static yolo(): FormatConverter<Map<number, string>>;
+    /**
+     * Export NER (Named Entity Recognition) results
+     */
+    static nerJSON(): FormatConverter<any[]>;
+}

package/dist-server/utils/annotation-exporter.js

@@ -0,0 +1,261 @@
+"use strict";
+/**
+ * Annotation Exporter
+ *
+ * Flexible annotation export system with pluggable format converters.
+ * Supports custom export formats for different use cases.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExportFormats = void 0;
+exports.registerExportFormat = registerExportFormat;
+exports.unregisterExportFormat = unregisterExportFormat;
+exports.getRegisteredFormats = getRegisteredFormats;
+exports.exportAnnotations = exportAnnotations;
+/**
+ * Registry for custom export formats
+ */
+const formatConverters = new Map();
+/**
+ * Register a custom export format converter
+ *
+ * @param formatName - Unique format identifier (e.g., "csv", "coco", "yolo")
+ * @param converter - Converter function
+ *
+ * @example
+ * registerExportFormat('csv', (annotations, context) => {
+ *   const rows = annotations.map(a => ({
+ *     id: a.id,
+ *     task: a.task,
+ *     result: JSON.stringify(a.result)
+ *   }))
+ *   return Papa.unparse(rows)
+ * })
+ */
+function registerExportFormat(formatName, converter) {
+    formatConverters.set(formatName.toLowerCase(), converter);
+}
+/**
+ * Unregister an export format
+ */
+function unregisterExportFormat(formatName) {
+    formatConverters.delete(formatName.toLowerCase());
+}
+/**
+ * Get all registered format names
+ */
+function getRegisteredFormats() {
+    return Array.from(formatConverters.keys());
+}
+/**
+ * Export annotations to specified format
+ *
+ * @param annotations - Label Studio annotations
+ * @param format - Export format name
+ * @param context - Export context
+ * @returns Converted data in requested format
+ */
+async function exportAnnotations(annotations, format, context) {
+    const converter = formatConverters.get(format.toLowerCase());
+    if (!converter) {
+        throw new Error(`Unknown export format: ${format}. Available formats: ${getRegisteredFormats().join(', ')}`);
+    }
+    return await converter(annotations, context);
+}
+/**
+ * Pre-built export formats
+ */
+class ExportFormats {
+    /**
+     * Export as JSON (default Label Studio format)
+     */
+    static json() {
+        return (annotations, context) => {
+            return JSON.stringify({
+                meta: context,
+                annotations
+            }, null, 2);
+        };
+    }
+    /**
+     * Export as JSON Lines (one annotation per line)
+     */
+    static jsonl() {
+        return annotations => {
+            return annotations.map(a => JSON.stringify(a)).join('\n');
+        };
+    }
+    /**
+     * Export image classification results as CSV
+     */
+    static imageClassificationCSV() {
+        return annotations => {
+            const rows = ['task_id,annotation_id,label,annotator,lead_time,created_at'];
+            for (const annotation of annotations) {
+                const label = annotation.result.find(r => r.type === 'choices');
+                if (label && label.value.choices) {
+                    const choice = label.value.choices[0];
+                    rows.push([
+                        annotation.task,
+                        annotation.id,
+                        choice,
+                        annotation.completed_by?.email || 'unknown',
+                        annotation.lead_time || 0,
+                        annotation.created_at
+                    ].join(','));
+                }
+            }
+            return rows.join('\n');
+        };
+    }
+    /**
+     * Export Rank N classification results
+     */
+    static rankNClassificationCSV(ranks = 3) {
+        return annotations => {
+            const rankHeaders = Array.from({ length: ranks }, (_, i) => `rank${i + 1}`).join(',');
+            const rows = [`task_id,annotation_id,${rankHeaders},annotator,lead_time,created_at`];
+            for (const annotation of annotations) {
+                const rankValues = [];
+                for (let i = 1; i <= ranks; i++) {
+                    const rankResult = annotation.result.find(r => r.from_name === `rank${i}`);
+                    rankValues.push(rankResult?.value?.choices?.[0] || '');
+                }
+                rows.push([
+                    annotation.task,
+                    annotation.id,
+                    ...rankValues,
+                    annotation.completed_by?.email || 'unknown',
+                    annotation.lead_time || 0,
+                    annotation.created_at
+                ].join(','));
+            }
+            return rows.join('\n');
+        };
+    }
+    /**
+     * Export object detection results as COCO format
+     */
+    static coco() {
+        return (annotations, context) => {
+            const images = [];
+            const cocoAnnotations = [];
+            const categories = new Map();
+            let imageId = 1;
+            let annotationId = 1;
+            let categoryId = 1;
+            for (const annotation of annotations) {
+                // Add image
+                images.push({
+                    id: imageId,
+                    file_name: `task_${annotation.task}.jpg`,
+                    width: 0, // TODO: extract from annotation if available
+                    height: 0
+                });
+                // Process bounding boxes
+                for (const result of annotation.result) {
+                    if (result.type === 'rectanglelabels') {
+                        const label = result.value.rectanglelabels[0];
+                        // Register category
+                        if (!categories.has(label)) {
+                            categories.set(label, categoryId++);
+                        }
+                        // Add annotation
+                        cocoAnnotations.push({
+                            id: annotationId++,
+                            image_id: imageId,
+                            category_id: categories.get(label),
+                            bbox: [result.value.x, result.value.y, result.value.width, result.value.height],
+                            area: result.value.width * result.value.height,
+                            iscrowd: 0
+                        });
+                    }
+                }
+                imageId++;
+            }
+            return {
+                info: {
+                    description: context.projectTitle || 'Label Studio Export',
+                    date_created: context.exportedAt
+                },
+                images,
+                annotations: cocoAnnotations,
+                categories: Array.from(categories.entries()).map(([name, id]) => ({
+                    id,
+                    name,
+                    supercategory: 'none'
+                }))
+            };
+        };
+    }
+    /**
+     * Export object detection results as YOLO format
+     */
+    static yolo() {
+        return annotations => {
+            const taskAnnotations = new Map();
+            const categoryIndex = new Map();
+            let nextCategoryId = 0;
+            for (const annotation of annotations) {
+                const lines = [];
+                for (const result of annotation.result) {
+                    if (result.type === 'rectanglelabels') {
+                        const label = result.value.rectanglelabels[0];
+                        // Register category
+                        if (!categoryIndex.has(label)) {
+                            categoryIndex.set(label, nextCategoryId++);
+                        }
+                        const classId = categoryIndex.get(label);
+                        // Convert to YOLO format (normalized center x, center y, width, height)
+                        const x = result.value.x / 100;
+                        const y = result.value.y / 100;
+                        const w = result.value.width / 100;
+                        const h = result.value.height / 100;
+                        const centerX = x + w / 2;
+                        const centerY = y + h / 2;
+                        lines.push(`${classId} ${centerX} ${centerY} ${w} ${h}`);
+                    }
+                }
+                if (lines.length > 0) {
+                    taskAnnotations.set(annotation.task, lines.join('\n'));
+                }
+            }
+            return taskAnnotations;
+        };
+    }
+    /**
+     * Export NER (Named Entity Recognition) results
+     */
+    static nerJSON() {
+        return annotations => {
+            return annotations.map(annotation => {
+                const entities = [];
+                for (const result of annotation.result) {
+                    if (result.type === 'labels') {
+                        entities.push({
+                            start: result.value.start,
+                            end: result.value.end,
+                            text: result.value.text,
+                            label: result.value.labels[0]
+                        });
+                    }
+                }
+                return {
+                    task_id: annotation.task,
+                    annotation_id: annotation.id,
+                    entities,
+                    annotator: annotation.completed_by?.email
+                };
+            });
+        };
+    }
+}
+exports.ExportFormats = ExportFormats;
+// Register default formats
+registerExportFormat('json', ExportFormats.json());
+registerExportFormat('jsonl', ExportFormats.jsonl());
+registerExportFormat('csv', ExportFormats.imageClassificationCSV());
+registerExportFormat('rank-csv', ExportFormats.rankNClassificationCSV());
+registerExportFormat('coco', ExportFormats.coco());
+registerExportFormat('yolo', ExportFormats.yolo());
+registerExportFormat('ner-json', ExportFormats.nerJSON());
+//# sourceMappingURL=annotation-exporter.js.map

package/dist-server/utils/annotation-exporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotation-exporter.js","sourceRoot":"","sources":["../../server/utils/annotation-exporter.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Annotation Exporter\n *\n * Flexible annotation export system with pluggable format converters.\n * Supports custom export formats for different use cases.\n */\n\nexport interface LabelStudioAnnotation {\n  id: number\n  task: number\n  project: number\n  completed_by: {\n    id: number\n    email: string\n    first_name: string\n    last_name: string\n  }\n  result: Array<{\n    from_name: string\n    to_name: string\n    type: string\n    value: any\n  }>\n  created_at: string\n  updated_at: string\n  lead_time?: number\n}\n\nexport interface ExportContext {\n  projectId: number\n  projectTitle?: string\n  exportedAt: string\n  metadata?: any\n}\n\n/**\n * Export format converter function type\n * Converts Label Studio annotations to custom format\n */\nexport type FormatConverter<T = any> = (\n  annotations: LabelStudioAnnotation[],\n  context: ExportContext\n) => T | Promise<T>\n\n/**\n * Registry for custom export formats\n */\nconst formatConverters: Map<string, FormatConverter> = new Map()\n\n/**\n * Register a custom export format converter\n *\n * @param formatName - Unique format identifier (e.g., \"csv\", \"coco\", \"yolo\")\n * @param converter - Converter function\n *\n * @example\n * registerExportFormat('csv', (annotations, context) => {\n *   const rows = annotations.map(a => ({\n *     id: a.id,\n *     task: a.task,\n *     result: JSON.stringify(a.result)\n *   }))\n *   return Papa.unparse(rows)\n * })\n */\nexport function registerExportFormat<T = any>(formatName: string, converter: FormatConverter<T>): void {\n  formatConverters.set(formatName.toLowerCase(), converter)\n}\n\n/**\n * Unregister an export format\n */\nexport function unregisterExportFormat(formatName: string): void {\n  formatConverters.delete(formatName.toLowerCase())\n}\n\n/**\n * Get all registered format names\n */\nexport function getRegisteredFormats(): string[] {\n  return Array.from(formatConverters.keys())\n}\n\n/**\n * Export annotations to specified format\n *\n * @param annotations - Label Studio annotations\n * @param format - Export format name\n * @param context - Export context\n * @returns Converted data in requested format\n */\nexport async function exportAnnotations<T = any>(\n  annotations: LabelStudioAnnotation[],\n  format: string,\n  context: ExportContext\n): Promise<T> {\n  const converter = formatConverters.get(format.toLowerCase())\n\n  if (!converter) {\n    throw new Error(`Unknown export format: ${format}. Available formats: ${getRegisteredFormats().join(', ')}`)\n  }\n\n  return await converter(annotations, context)\n}\n\n/**\n * Pre-built export formats\n */\nexport class ExportFormats {\n  /**\n   * Export as JSON (default Label Studio format)\n   */\n  static json(): FormatConverter<string> {\n    return (annotations, context) => {\n      return JSON.stringify(\n        {\n          meta: context,\n          annotations\n        },\n        null,\n        2\n      )\n    }\n  }\n\n  /**\n   * Export as JSON Lines (one annotation per line)\n   */\n  static jsonl(): FormatConverter<string> {\n    return annotations => {\n      return annotations.map(a => JSON.stringify(a)).join('\\n')\n    }\n  }\n\n  /**\n   * Export image classification results as CSV\n   */\n  static imageClassificationCSV(): FormatConverter<string> {\n    return annotations => {\n      const rows: string[] = ['task_id,annotation_id,label,annotator,lead_time,created_at']\n\n      for (const annotation of annotations) {\n        const label = annotation.result.find(r => r.type === 'choices')\n        if (label && label.value.choices) {\n          const choice = label.value.choices[0]\n          rows.push(\n            [\n              annotation.task,\n              annotation.id,\n              choice,\n              annotation.completed_by?.email || 'unknown',\n              annotation.lead_time || 0,\n              annotation.created_at\n            ].join(',')\n          )\n        }\n      }\n\n      return rows.join('\\n')\n    }\n  }\n\n  /**\n   * Export Rank N classification results\n   */\n  static rankNClassificationCSV(ranks: number = 3): FormatConverter<string> {\n    return annotations => {\n      const rankHeaders = Array.from({ length: ranks }, (_, i) => `rank${i + 1}`).join(',')\n      const rows: string[] = [`task_id,annotation_id,${rankHeaders},annotator,lead_time,created_at`]\n\n      for (const annotation of annotations) {\n        const rankValues: string[] = []\n\n        for (let i = 1; i <= ranks; i++) {\n          const rankResult = annotation.result.find(r => r.from_name === `rank${i}`)\n          rankValues.push(rankResult?.value?.choices?.[0] || '')\n        }\n\n        rows.push(\n          [\n            annotation.task,\n            annotation.id,\n            ...rankValues,\n            annotation.completed_by?.email || 'unknown',\n            annotation.lead_time || 0,\n            annotation.created_at\n          ].join(',')\n        )\n      }\n\n      return rows.join('\\n')\n    }\n  }\n\n  /**\n   * Export object detection results as COCO format\n   */\n  static coco(): FormatConverter<any> {\n    return (annotations, context) => {\n      const images: any[] = []\n      const cocoAnnotations: any[] = []\n      const categories: Map<string, number> = new Map()\n\n      let imageId = 1\n      let annotationId = 1\n      let categoryId = 1\n\n      for (const annotation of annotations) {\n        // Add image\n        images.push({\n          id: imageId,\n          file_name: `task_${annotation.task}.jpg`,\n          width: 0, // TODO: extract from annotation if available\n          height: 0\n        })\n\n        // Process bounding boxes\n        for (const result of annotation.result) {\n          if (result.type === 'rectanglelabels') {\n            const label = result.value.rectanglelabels[0]\n\n            // Register category\n            if (!categories.has(label)) {\n              categories.set(label, categoryId++)\n            }\n\n            // Add annotation\n            cocoAnnotations.push({\n              id: annotationId++,\n              image_id: imageId,\n              category_id: categories.get(label),\n              bbox: [result.value.x, result.value.y, result.value.width, result.value.height],\n              area: result.value.width * result.value.height,\n              iscrowd: 0\n            })\n          }\n        }\n\n        imageId++\n      }\n\n      return {\n        info: {\n          description: context.projectTitle || 'Label Studio Export',\n          date_created: context.exportedAt\n        },\n        images,\n        annotations: cocoAnnotations,\n        categories: Array.from(categories.entries()).map(([name, id]) => ({\n          id,\n          name,\n          supercategory: 'none'\n        }))\n      }\n    }\n  }\n\n  /**\n   * Export object detection results as YOLO format\n   */\n  static yolo(): FormatConverter<Map<number, string>> {\n    return annotations => {\n      const taskAnnotations: Map<number, string> = new Map()\n      const categoryIndex: Map<string, number> = new Map()\n      let nextCategoryId = 0\n\n      for (const annotation of annotations) {\n        const lines: string[] = []\n\n        for (const result of annotation.result) {\n          if (result.type === 'rectanglelabels') {\n            const label = result.value.rectanglelabels[0]\n\n            // Register category\n            if (!categoryIndex.has(label)) {\n              categoryIndex.set(label, nextCategoryId++)\n            }\n\n            const classId = categoryIndex.get(label)!\n\n            // Convert to YOLO format (normalized center x, center y, width, height)\n            const x = result.value.x / 100\n            const y = result.value.y / 100\n            const w = result.value.width / 100\n            const h = result.value.height / 100\n\n            const centerX = x + w / 2\n            const centerY = y + h / 2\n\n            lines.push(`${classId} ${centerX} ${centerY} ${w} ${h}`)\n          }\n        }\n\n        if (lines.length > 0) {\n          taskAnnotations.set(annotation.task, lines.join('\\n'))\n        }\n      }\n\n      return taskAnnotations\n    }\n  }\n\n  /**\n   * Export NER (Named Entity Recognition) results\n   */\n  static nerJSON(): FormatConverter<any[]> {\n    return annotations => {\n      return annotations.map(annotation => {\n        const entities: any[] = []\n\n        for (const result of annotation.result) {\n          if (result.type === 'labels') {\n            entities.push({\n              start: result.value.start,\n              end: result.value.end,\n              text: result.value.text,\n              label: result.value.labels[0]\n            })\n          }\n        }\n\n        return {\n          task_id: annotation.task,\n          annotation_id: annotation.id,\n          entities,\n          annotator: annotation.completed_by?.email\n        }\n      })\n    }\n  }\n}\n\n// Register default formats\nregisterExportFormat('json', ExportFormats.json())\nregisterExportFormat('jsonl', ExportFormats.jsonl())\nregisterExportFormat('csv', ExportFormats.imageClassificationCSV())\nregisterExportFormat('rank-csv', ExportFormats.rankNClassificationCSV())\nregisterExportFormat('coco', ExportFormats.coco())\nregisterExportFormat('yolo', ExportFormats.yolo())\nregisterExportFormat('ner-json', ExportFormats.nerJSON())\n"]}

package/dist-server/utils/label-config-builder.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Label Config Builder
+ *
+ * Flexible, declarative Label Studio configuration generator.
+ * Supports any data type and control combination without hardcoding templates.
+ */
+export interface LabelConfigSpec {
+    dataType: 'image' | 'text' | 'audio' | 'video' | 'timeseries' | 'html' | 'hypertext';
+    dataName?: string;
+    controls: ControlSpec[];
+}
+export interface ControlSpec {
+    type: 'choices' | 'labels' | 'textarea' | 'rating' | 'rectangles' | 'polygon' | 'keypoint' | 'brush';
+    name: string;
+    toName: string;
+    config: any;
+}
+export interface ChoicesConfig {
+    choices: string[];
+    choice?: 'single' | 'multiple';
+    required?: boolean;
+}
+export interface LabelsConfig {
+    labels: Array<{
+        value: string;
+        background?: string;
+        hotkey?: string;
+    }>;
+}
+export interface RatingConfig {
+    maxRating?: number;
+    icon?: string;
+    size?: 'small' | 'medium' | 'large';
+}
+export declare class LabelConfigBuilder {
+    /**
+     * Build Label Studio XML configuration from specification
+     */
+    static build(spec: LabelConfigSpec): string;
+    /**
+     * Build data source tag (Image, Text, Audio, etc.)
+     */
+    private static buildDataTag;
+    /**
+     * Build control tag based on type
+     */
+    private static buildControlTag;
+    /**
+     * Build Choices control (single or multiple selection)
+     */
+    private static buildChoices;
+    /**
+     * Build Labels control (for NER, classification, etc.)
+     */
+    private static buildLabels;
+    /**
+     * Build TextArea control
+     */
+    private static buildTextArea;
+    /**
+     * Build Rating control
+     */
+    private static buildRating;
+    /**
+     * Build Rectangle control (bounding boxes)
+     */
+    private static buildRectangles;
+    /**
+     * Build Polygon control
+     */
+    private static buildPolygon;
+    /**
+     * Build Keypoint control
+     */
+    private static buildKeypoint;
+    /**
+     * Build Brush control (semantic segmentation)
+     */
+    private static buildBrush;
+    /**
+     * Escape XML special characters
+     */
+    private static escapeXml;
+}
+/**
+ * Pre-built template generators for common use cases
+ */
+export declare class LabelConfigTemplates {
+    /**
+     * Generate Rank N image classification config
+     * Example: WBM Rank 3 classification
+     */
+    static imageRankN(ranks: number, classes: string[]): LabelConfigSpec;
+    /**
+     * Simple image classification
+     */
+    static imageClassification(classes: string[], multiLabel?: boolean): LabelConfigSpec;
+    /**
+     * Text classification (sentiment, intent, etc.)
+     */
+    static textClassification(classes: string[]): LabelConfigSpec;
+    /**
+     * Named Entity Recognition
+     */
+    static namedEntityRecognition(labels: Array<{
+        value: string;
+        background: string;
+    }>): LabelConfigSpec;
+    /**
+     * Object detection (bounding boxes)
+     */
+    static objectDetection(labels: string[]): LabelConfigSpec;
+    /**
+     * Semantic segmentation
+     */
+    static semanticSegmentation(labels: string[]): LabelConfigSpec;
+}