nuxt-ui-tools 1.11.2 → 1.13.0

package/dist/runtime/spreadsheet/composables/use-spreadsheet-internals.js

@@ -1,68 +0,0 @@
-import { computed, inject, provide, toValue } from "vue";
-import { normalizeSpreadsheetSchema } from "../schema/index.js";
-import { useSpreadsheetContext } from "./use-spreadsheet-context.js";
-import { useSpreadsheetResolutions } from "./use-spreadsheet-resolutions.js";
-import { useSpreadsheetRows } from "./use-spreadsheet-rows.js";
-import { useSpreadsheetSource } from "./use-spreadsheet-source.js";
-function resolveSpreadsheetSchemaSource(schema) {
-  return toValue(schema);
-}
-function resolveSpreadsheetValue(value) {
-  return toValue(value);
-}
-function createSpreadsheetInternals(options) {
-  const publicSchema = computed(() => resolveSpreadsheetSchemaSource(options.rawSchema));
-  const schema = computed(() => normalizeSpreadsheetSchema(publicSchema.value));
-  const source = useSpreadsheetSource({
-    fileName: computed(
-      () => options.fileName ? resolveSpreadsheetValue(options.fileName) : void 0
-    ),
-    source: options.source
-  });
-  const context = useSpreadsheetContext({
-    schema
-  });
-  const rows = useSpreadsheetRows({
-    contextData: context.contextData,
-    headers: source.headers,
-    rows: source.rows,
-    schema
-  });
-  const resolutions = useSpreadsheetResolutions({
-    contextData: context.contextData,
-    rows: computed(() => rows.parsedRows.value),
-    schema
-  });
-  return {
-    context,
-    references: resolutions,
-    resolutions,
-    rows,
-    schema,
-    source
-  };
-}
-const SPREADSHEET_INTERNALS_KEY = Symbol(
-  "nuxt-ui-tools.spreadsheet.internals"
-);
-function provideSpreadsheetInternals(internals) {
-  provide(SPREADSHEET_INTERNALS_KEY, internals);
-}
-function useProvideSpreadsheetInternals(options) {
-  const internals = createSpreadsheetInternals(options);
-  provideSpreadsheetInternals(internals);
-  return internals;
-}
-function useSpreadsheetInternals() {
-  const internals = inject(SPREADSHEET_INTERNALS_KEY, null);
-  if (!internals) {
-    throw new Error("useSpreadsheetInternals must be called inside a spreadsheet provider");
-  }
-  return internals;
-}
-export {
-  createSpreadsheetInternals,
-  provideSpreadsheetInternals,
-  useProvideSpreadsheetInternals,
-  useSpreadsheetInternals
-};

package/dist/runtime/spreadsheet/composables/use-spreadsheet-references.d.ts

@@ -1 +0,0 @@
-export { useSpreadsheetResolutions as useSpreadsheetReferences, type UseSpreadsheetResolutionsParams as UseSpreadsheetReferencesParams, } from './use-spreadsheet-resolutions.js';

package/dist/runtime/spreadsheet/composables/use-spreadsheet-references.js

@@ -1,3 +0,0 @@
-export {
-  useSpreadsheetResolutions as useSpreadsheetReferences
-} from "./use-spreadsheet-resolutions.js";

package/dist/runtime/spreadsheet/composables/use-spreadsheet-resolutions.d.ts

@@ -1,40 +0,0 @@
-import type { ComputedRef } from 'vue';
-import type { SpreadsheetNormalizedSchema, SpreadsheetParsedRow, SpreadsheetRecord, SpreadsheetReferenceResolution } from '../types/index.js';
-export interface UseSpreadsheetResolutionsParams {
-    schema: ComputedRef<SpreadsheetNormalizedSchema>;
-    contextData: ComputedRef<SpreadsheetRecord>;
-    rows: ComputedRef<readonly SpreadsheetParsedRow<SpreadsheetRecord>[]>;
-}
-export declare function useSpreadsheetResolutions(params: UseSpreadsheetResolutionsParams): {
-    clearReference: (selection: {
-        referenceField: string;
-        sourceValue: string;
-    }) => void;
-    clearResolution: (selection: {
-        resolutionField: string;
-        sourceValue: string;
-    }) => void;
-    queryRequests: ComputedRef<import("../types/index.js").SpreadsheetReferenceQueryRequest[]>;
-    referenceDefinitions: ComputedRef<readonly import("../types/index.js").SpreadsheetResolutionDefinition<"reference" | "column", string, string, unknown, unknown, import("../types/index.js").SpreadsheetOptionItem, SpreadsheetRecord, SpreadsheetRecord, import("../types/index.js").SpreadsheetFieldRulesInput<unknown> | undefined>[]>;
-    resolutionDefinitions: ComputedRef<readonly import("../types/index.js").SpreadsheetResolutionDefinition<"reference" | "column", string, string, unknown, unknown, import("../types/index.js").SpreadsheetOptionItem, SpreadsheetRecord, SpreadsheetRecord, import("../types/index.js").SpreadsheetFieldRulesInput<unknown> | undefined>[]>;
-    resolutions: ComputedRef<SpreadsheetReferenceResolution<unknown, unknown>[]>;
-    resolvedRows: ComputedRef<import("../types/index.js").SpreadsheetResolvedReferenceRow<SpreadsheetRecord>[]>;
-    selectReference: (selection: {
-        referenceField: string;
-        sourceValue: string;
-        selectedValue: unknown;
-        selectedLabel: string;
-    }) => void;
-    selectResolution: (selection: {
-        resolutionField: string;
-        sourceValue: string;
-        selectedValue: unknown;
-        selectedLabel: string;
-    }) => void;
-    status: ComputedRef<{
-        initialized: boolean;
-        isReady: boolean;
-        unresolvedCount: number;
-    }>;
-    unresolvedResolutions: ComputedRef<SpreadsheetReferenceResolution<unknown, unknown>[]>;
-};

package/dist/runtime/spreadsheet/composables/use-spreadsheet-resolutions.js

@@ -1,97 +0,0 @@
-import { computed, shallowRef, watch } from "vue";
-import {
-  applySpreadsheetReferenceResolutions,
-  createSpreadsheetReferenceQueryRequests,
-  createSpreadsheetReferenceResolutions
-} from "../utils/index.js";
-function createResolutionId(resolution) {
-  return `${resolution.targetField ?? resolution.referenceField}::${resolution.sourceValue}`;
-}
-export function useSpreadsheetResolutions(params) {
-  const resolutionDefinitions = computed(
-    () => params.schema.value.resolutions ?? params.schema.value.references ?? []
-  );
-  const autoResolutions = computed(
-    () => createSpreadsheetReferenceResolutions({
-      context: params.contextData.value,
-      references: resolutionDefinitions.value,
-      rows: params.rows.value
-    })
-  );
-  const manualSelections = shallowRef({});
-  const resolutions = computed(
-    () => autoResolutions.value.map((resolution) => {
-      const manual = manualSelections.value[createResolutionId(resolution)];
-      return manual ?? resolution;
-    })
-  );
-  const unresolvedResolutions = computed(
-    () => resolutions.value.filter((resolution) => resolution.status === "unresolved")
-  );
-  const resolvedRows = computed(
-    () => applySpreadsheetReferenceResolutions({
-      references: resolutionDefinitions.value,
-      relations: params.schema.value.relations,
-      resolutions: resolutions.value,
-      rows: params.rows.value
-    })
-  );
-  const queryRequests = computed(
-    () => createSpreadsheetReferenceQueryRequests({
-      context: params.contextData.value,
-      references: resolutionDefinitions.value,
-      rows: params.rows.value
-    })
-  );
-  const status = computed(() => ({
-    initialized: true,
-    isReady: true,
-    unresolvedCount: unresolvedResolutions.value.length
-  }));
-  function selectResolution(selection) {
-    const key = `${selection.resolutionField}::${selection.sourceValue}`;
-    const current = resolutions.value.find((resolution) => createResolutionId(resolution) === key);
-    if (!current) {
-      return;
-    }
-    manualSelections.value = {
-      ...manualSelections.value,
-      [key]: {
-        ...current,
-        selectedLabel: selection.selectedLabel,
-        selectedValue: selection.selectedValue,
-        status: "matched"
-      }
-    };
-  }
-  function clearResolution(selection) {
-    const key = `${selection.resolutionField}::${selection.sourceValue}`;
-    const nextSelections = { ...manualSelections.value };
-    delete nextSelections[key];
-    manualSelections.value = nextSelections;
-  }
-  watch(resolutionDefinitions, () => {
-    manualSelections.value = {};
-  });
-  return {
-    clearReference: (selection) => clearResolution({
-      resolutionField: selection.referenceField,
-      sourceValue: selection.sourceValue
-    }),
-    clearResolution,
-    queryRequests,
-    referenceDefinitions: resolutionDefinitions,
-    resolutionDefinitions,
-    resolutions,
-    resolvedRows,
-    selectReference: (selection) => selectResolution({
-      resolutionField: selection.referenceField,
-      selectedLabel: selection.selectedLabel,
-      selectedValue: selection.selectedValue,
-      sourceValue: selection.sourceValue
-    }),
-    selectResolution,
-    status,
-    unresolvedResolutions
-  };
-}

package/dist/runtime/spreadsheet/composables/use-spreadsheet-row-state.d.ts

@@ -1,24 +0,0 @@
-import type { ComputedRef } from 'vue';
-import type { SpreadsheetColumnMatch, SpreadsheetDynamicColumnMatch, SpreadsheetParsedRow, SpreadsheetRecord, SpreadsheetRowSummary } from '../types/index.js';
-export interface UseSpreadsheetRowStateParams {
-    rows: ComputedRef<readonly (readonly unknown[])[]>;
-    contextData: ComputedRef<SpreadsheetRecord>;
-    columnMatches: ComputedRef<readonly SpreadsheetColumnMatch[]>;
-    dynamicColumnMatches: ComputedRef<readonly SpreadsheetDynamicColumnMatch[]>;
-    refreshSources: readonly unknown[];
-}
-export declare function useSpreadsheetRowState(params: UseSpreadsheetRowStateParams): {
-    error: import("vue").ShallowRef<unknown, unknown>;
-    parsedRows: import("vue").ShallowRef<SpreadsheetParsedRow<SpreadsheetRecord>[], SpreadsheetParsedRow<SpreadsheetRecord>[]>;
-    refreshRows: () => Promise<void>;
-    status: import("vue").ShallowRef<{
-        initialized: boolean;
-        isParsing: boolean;
-        isReady: boolean;
-    }, {
-        initialized: boolean;
-        isParsing: boolean;
-        isReady: boolean;
-    }>;
-    summary: import("vue").ShallowRef<SpreadsheetRowSummary, SpreadsheetRowSummary>;
-};

package/dist/runtime/spreadsheet/composables/use-spreadsheet-row-state.js

@@ -1,74 +0,0 @@
-import { shallowRef, watch } from "vue";
-import { createSpreadsheetRowSummary, parseSpreadsheetRows } from "../utils/index.js";
-export function useSpreadsheetRowState(params) {
-  const parsedRows = shallowRef([]);
-  const summary = shallowRef({
-    invalidRows: 0,
-    issueCount: 0,
-    totalRows: 0,
-    validRows: 0
-  });
-  const status = shallowRef({
-    initialized: false,
-    isParsing: false,
-    isReady: false
-  });
-  const error = shallowRef(null);
-  let runId = 0;
-  async function refreshRows() {
-    const nextRunId = runId + 1;
-    runId = nextRunId;
-    status.value = {
-      initialized: true,
-      isParsing: true,
-      isReady: false
-    };
-    error.value = null;
-    try {
-      const nextRows = await parseSpreadsheetRows({
-        context: params.contextData.value,
-        dynamicMatches: params.dynamicColumnMatches.value,
-        matches: params.columnMatches.value,
-        rows: params.rows.value
-      });
-      if (runId !== nextRunId) {
-        return;
-      }
-      parsedRows.value = nextRows;
-      summary.value = createSpreadsheetRowSummary(nextRows);
-      status.value = {
-        initialized: true,
-        isParsing: false,
-        isReady: true
-      };
-    } catch (nextError) {
-      if (runId !== nextRunId) {
-        return;
-      }
-      parsedRows.value = [];
-      summary.value = createSpreadsheetRowSummary([]);
-      status.value = {
-        initialized: true,
-        isParsing: false,
-        isReady: false
-      };
-      error.value = nextError;
-    }
-  }
-  watch(
-    params.refreshSources,
-    () => {
-      void refreshRows();
-    },
-    {
-      immediate: true
-    }
-  );
-  return {
-    error,
-    parsedRows,
-    refreshRows,
-    status,
-    summary
-  };
-}

package/dist/runtime/spreadsheet/composables/use-spreadsheet-source.d.ts

@@ -1,27 +0,0 @@
-import type { ComputedRef, Ref } from 'vue';
-import type { SpreadsheetBinaryRef, SpreadsheetWorkbookData, SpreadsheetWorkbookSelection } from '../types/index.js';
-export interface UseSpreadsheetSourceParams {
-    source: SpreadsheetBinaryRef;
-    fileName?: Ref<string | undefined> | ComputedRef<string | undefined>;
-    initialSelection?: Partial<SpreadsheetWorkbookSelection>;
-}
-export declare function useSpreadsheetSource(params: UseSpreadsheetSourceParams): {
-    error: import("vue").ShallowRef<unknown, unknown>;
-    headers: ComputedRef<readonly unknown[]>;
-    refreshWorkbook: () => Promise<void>;
-    rows: ComputedRef<(readonly unknown[])[]>;
-    selection: import("vue").ShallowRef<SpreadsheetWorkbookSelection, SpreadsheetWorkbookSelection>;
-    setHeaderRowIndex: (headerRowIndex: number) => void;
-    setSheetName: (sheetName: string) => void;
-    sheet: ComputedRef<import("../types/index.js").SpreadsheetWorkbookSheet | null>;
-    status: import("vue").ShallowRef<{
-        initialized: boolean;
-        isParsing: boolean;
-        isReady: boolean;
-    }, {
-        initialized: boolean;
-        isParsing: boolean;
-        isReady: boolean;
-    }>;
-    workbook: import("vue").ShallowRef<SpreadsheetWorkbookData | null, SpreadsheetWorkbookData | null>;
-};

package/dist/runtime/spreadsheet/composables/use-spreadsheet-source.js

@@ -1,109 +0,0 @@
-import { computed, shallowRef, watch } from "vue";
-import {
-  getDefaultSpreadsheetSheetName,
-  getSpreadsheetDataRows,
-  getSpreadsheetHeaders,
-  getSpreadsheetSheet,
-  parseSpreadsheetWorkbook
-} from "../utils/index.js";
-export function useSpreadsheetSource(params) {
-  const workbook = shallowRef(null);
-  const selection = shallowRef({
-    headerRowIndex: params.initialSelection?.headerRowIndex ?? 0,
-    sheetName: params.initialSelection?.sheetName
-  });
-  const status = shallowRef({
-    initialized: false,
-    isParsing: false,
-    isReady: false
-  });
-  const error = shallowRef(null);
-  let runId = 0;
-  const sheet = computed(() => getSpreadsheetSheet(workbook.value, selection.value.sheetName));
-  const headers = computed(() => getSpreadsheetHeaders(sheet.value, selection.value.headerRowIndex));
-  const rows = computed(() => getSpreadsheetDataRows(sheet.value, selection.value.headerRowIndex));
-  async function refreshWorkbook() {
-    const source = params.source.value;
-    const nextRunId = runId + 1;
-    runId = nextRunId;
-    if (!source) {
-      workbook.value = null;
-      error.value = null;
-      status.value = {
-        initialized: true,
-        isParsing: false,
-        isReady: false
-      };
-      return;
-    }
-    status.value = {
-      initialized: true,
-      isParsing: true,
-      isReady: false
-    };
-    error.value = null;
-    try {
-      const nextWorkbook = await parseSpreadsheetWorkbook({
-        fileName: params.fileName?.value,
-        source
-      });
-      if (runId !== nextRunId) {
-        return;
-      }
-      workbook.value = nextWorkbook;
-      selection.value = {
-        ...selection.value,
-        sheetName: selection.value.sheetName ?? getDefaultSpreadsheetSheetName(nextWorkbook)
-      };
-      status.value = {
-        initialized: true,
-        isParsing: false,
-        isReady: true
-      };
-    } catch (nextError) {
-      if (runId !== nextRunId) {
-        return;
-      }
-      workbook.value = null;
-      error.value = nextError;
-      status.value = {
-        initialized: true,
-        isParsing: false,
-        isReady: false
-      };
-    }
-  }
-  function setSheetName(sheetName) {
-    selection.value = {
-      ...selection.value,
-      sheetName
-    };
-  }
-  function setHeaderRowIndex(headerRowIndex) {
-    selection.value = {
-      ...selection.value,
-      headerRowIndex
-    };
-  }
-  watch(
-    () => params.source.value,
-    () => {
-      void refreshWorkbook();
-    },
-    {
-      immediate: true
-    }
-  );
-  return {
-    error,
-    headers,
-    refreshWorkbook,
-    rows,
-    selection,
-    setHeaderRowIndex,
-    setSheetName,
-    sheet,
-    status,
-    workbook
-  };
-}

package/dist/runtime/spreadsheet/composables/use-spreadsheet-view.d.ts

@@ -1,15 +0,0 @@
-import type { SpreadsheetStepItem } from '../components/types.js';
-import type { SpreadsheetStepsDefinition } from '../types/index.js';
-export declare function useSpreadsheetView(params: {
-    hasReferences: () => boolean;
-    stepConfig?: () => SpreadsheetStepsDefinition | undefined;
-    t: (path: string, option?: Record<string, string | number>) => string;
-}): {
-    activeStep: import("vue").Ref<string, string>;
-    activeStepIndex: import("vue").ComputedRef<number>;
-    canGoNext: import("vue").ComputedRef<boolean>;
-    canGoPrev: import("vue").ComputedRef<boolean>;
-    goToNextStep: () => void;
-    goToPrevStep: () => void;
-    steps: import("vue").ComputedRef<SpreadsheetStepItem[]>;
-};

package/dist/runtime/spreadsheet/composables/use-spreadsheet-view.js

@@ -1,109 +0,0 @@
-import { computed, ref, watch } from "vue";
-import { resolveTextValue } from "#ui-tools/shared/utils/render";
-export function useSpreadsheetView(params) {
-  const activeStep = ref("upload");
-  const steps = computed(() => [
-    {
-      description: resolveTextValue(
-        params.stepConfig?.()?.upload?.description,
-        params.t("spreadsheet.steps.upload.description")
-      ),
-      icon: "i-lucide-upload",
-      title: resolveTextValue(
-        params.stepConfig?.()?.upload?.title,
-        params.t("spreadsheet.steps.upload.title")
-      ),
-      value: "upload"
-    },
-    {
-      description: resolveTextValue(
-        params.stepConfig?.()?.structure?.description,
-        params.t("spreadsheet.steps.structure.description")
-      ),
-      icon: "i-lucide-table-properties",
-      title: resolveTextValue(
-        params.stepConfig?.()?.structure?.title,
-        params.t("spreadsheet.steps.structure.title")
-      ),
-      value: "structure"
-    },
-    {
-      description: resolveTextValue(
-        params.stepConfig?.()?.matching?.description,
-        params.t("spreadsheet.steps.matching.description")
-      ),
-      icon: "i-lucide-columns-3",
-      title: resolveTextValue(
-        params.stepConfig?.()?.matching?.title,
-        params.t("spreadsheet.steps.matching.title")
-      ),
-      value: "matching"
-    },
-    ...params.hasReferences() ? [
-      {
-        description: resolveTextValue(
-          params.stepConfig?.()?.references?.description,
-          params.t("spreadsheet.steps.references.description")
-        ),
-        icon: "i-lucide-link-2",
-        title: resolveTextValue(
-          params.stepConfig?.()?.references?.title,
-          params.t("spreadsheet.steps.references.title")
-        ),
-        value: "references"
-      }
-    ] : [],
-    {
-      description: resolveTextValue(
-        params.stepConfig?.()?.review?.description,
-        params.t("spreadsheet.steps.review.description")
-      ),
-      icon: "i-lucide-clipboard-check",
-      title: resolveTextValue(
-        params.stepConfig?.()?.review?.title,
-        params.t("spreadsheet.steps.review.title")
-      ),
-      value: "review"
-    }
-  ]);
-  const activeStepIndex = computed(
-    () => steps.value.findIndex((step) => step.value === activeStep.value)
-  );
-  const canGoPrev = computed(() => activeStepIndex.value > 0);
-  const canGoNext = computed(
-    () => activeStepIndex.value >= 0 && activeStepIndex.value < steps.value.length - 1
-  );
-  function goToNextStep() {
-    if (!canGoNext.value) {
-      return;
-    }
-    activeStep.value = steps.value[activeStepIndex.value + 1]?.value ?? activeStep.value;
-  }
-  function goToPrevStep() {
-    if (!canGoPrev.value) {
-      return;
-    }
-    activeStep.value = steps.value[activeStepIndex.value - 1]?.value ?? activeStep.value;
-  }
-  watch(
-    steps,
-    (nextSteps) => {
-      if (nextSteps.some((step) => step.value === activeStep.value)) {
-        return;
-      }
-      activeStep.value = nextSteps[0]?.value ?? "upload";
-    },
-    {
-      immediate: true
-    }
-  );
-  return {
-    activeStep,
-    activeStepIndex,
-    canGoNext,
-    canGoPrev,
-    goToNextStep,
-    goToPrevStep,
-    steps
-  };
-}

package/dist/runtime/spreadsheet/schema/normalize.d.ts

@@ -1,73 +0,0 @@
-import type { SpreadsheetResolutionDefinition, SpreadsheetColumnsDefinition, SpreadsheetContextItem, SpreadsheetDynamicBuilder, SpreadsheetRecord } from '../types/index.js';
-export { type NormalizeSpreadsheetSchema } from '../types/index.js';
-export declare function resolveSpreadsheetDynamicColumns<TContext, TResult extends readonly unknown[]>(columns: {
-    dynamic: (params: {
-        dynamic: SpreadsheetDynamicBuilder<TContext>;
-        context: TContext;
-    }) => TResult;
-}, context: TContext): TResult;
-export declare function resolveSpreadsheetDynamicColumns<TContext>(columns: {
-    dynamic?: ((params: {
-        dynamic: SpreadsheetDynamicBuilder;
-        context: TContext;
-    }) => readonly unknown[]) | undefined;
-}, context: TContext): readonly [];
-export declare function resolveSpreadsheetBuildRow<TBuildRow>(buildRow: TBuildRow): TBuildRow;
-export declare function resolveSpreadsheetBuildRow(buildRow: undefined): undefined;
-export declare function normalizeSpreadsheetSchema<TSchema extends {
-    importKey: string;
-    file?: unknown;
-    sheet?: unknown;
-    header?: unknown;
-    matching?: unknown;
-    review?: unknown;
-    steps?: unknown;
-    context?: readonly SpreadsheetContextItem<string, unknown>[];
-    columns?: SpreadsheetColumnsDefinition<any>;
-    references?: unknown;
-    relations?: readonly unknown[];
-    buildRow?: unknown;
-}>(schema: TSchema): TSchema & {
-    buildRow: unknown;
-    columns: {
-        dynamic: (params: {
-            dynamic: SpreadsheetDynamicBuilder<any>;
-            context: any;
-        }) => readonly unknown[];
-        static: readonly unknown[];
-    };
-    context: readonly SpreadsheetContextItem<string, unknown>[];
-    header: {
-        [x: string]: unknown;
-    };
-    matching: {
-        [x: string]: unknown;
-    };
-    references: any[];
-    relations: readonly unknown[];
-    resolutions: readonly SpreadsheetResolutionDefinition<"reference" | "column", string, string, unknown, unknown, import("../types/index.js").SpreadsheetOptionItem, SpreadsheetRecord, SpreadsheetRecord, import("../types/index.js").SpreadsheetFieldRulesInput<unknown> | undefined>[];
-    review: {
-        [x: string]: unknown;
-    };
-    sheet: {
-        [x: string]: unknown;
-    };
-    steps: {
-        matching: {
-            [x: string]: unknown;
-        };
-        references: SpreadsheetRecord;
-        review: {
-            [x: string]: unknown;
-        };
-        structure: {
-            header: {
-                [x: string]: unknown;
-            };
-            sheet: {
-                [x: string]: unknown;
-            };
-        };
-        upload: SpreadsheetRecord;
-    };
-};