openmaic-custom/lib/hooks/use-order-element.ts
wyuc 7cb129183d
chore(packages): publish the @openmaic/* SDK family to npm (#778) (#780)
* chore(packages): publish the @openmaic/* SDK family to npm (#778)

Prepares the @openmaic/{dsl,renderer,importer} family for its first npm
publish, and moves the SDK packages onto the @openmaic scope.

Why the scope move: the @maic org name is unavailable on npm (an unscoped
`maic` package already holds the name), so @maic/* is not claimable. @openmaic
matches the project name, the scope is free, and the repo already ships an
@openmaic/docs package — so the SDK family now lines up with that convention.

- rename @maic/{dsl,renderer,importer} -> @openmaic/* across packages, the
  workspace glob, the package dir, and all import sites; lockfile regenerated
- renderer: add publishConfig (public, registry.npmjs.org) — was missing, so
  a scoped publish would default to the wrong registry / restricted access
- importer: add a files allowlist (dist, README, LICENSE) and drop the
  fragile .npmignore blacklist that shipped src; add an exports map so ESM
  consumers resolve dist/index.js instead of falling back to the .cjs main
- all three: add a prepublishOnly build (+ test/typecheck) guard so a publish
  can never ship a stale or empty dist
- add a tag-triggered publish workflow with npm provenance, pinned by name to
  the three @openmaic packages so the vendored forks (mathml2omml, pptxgenjs)
  are never published

Refs #778, #720 (Phase 1).

* fix(packages): address cross-review on the @openmaic publish prep

Cross-review (Claude /code-review + codex) on this PR surfaced:

- renderer's advertised CJS entry was broken: it keeps @openmaic/dsl external
  and imports a runtime enum from it, but dsl is ESM-only (no `require`
  condition), so `require('@openmaic/renderer')` would throw
  ERR_PACKAGE_PATH_NOT_EXPORTED. Make renderer ESM-only: drop the `.cjs`
  rollup output, `main` now points at the ESM build, and the `require`
  conditions are removed from `exports`. (importer is unaffected — it bundles
  dsl, so its CJS build still works.)
- prepublishOnly re-ran the test suite during `pnpm -r publish`, so a flaky
  test after dsl had already published gave a non-atomic partial release.
  Reduce prepublishOnly to a build-only guard (never ship stale/empty dist)
  and move the real test/typecheck gate into the workflow, before any publish.
- document that an @openmaic/* tag publishes the whole family via `pnpm -r`
  (pnpm skips already-published versions); the tag is a release marker, not a
  per-package gate.

Verified: dsl + renderer + importer build; renderer emits ESM only (0 .cjs),
all exports entries resolve; `npm pack` ships dist + README + LICENSE with no
src leak; frozen-lockfile passes.

Refs #778.

* style: reflow @openmaic/dsl type imports past print-width after rename

The @maic -> @openmaic rename lengthened two single-line type imports past
prettier's 100-col width; prettier --check flagged them. Pure formatting.

Refs #778.

* docs(importer): mark @openmaic/importer browser-only (cr-loop accepted limitation)

codex cross-review flagged that the published @openmaic/importer throws
`XMLHttpRequest is not a constructor` when loaded in a pure Node process —
its rollup build is browser-targeted (`nodeResolve({browser:true})` + a
browser pdf.js build). The app only consumes it client-side ('use client'),
so this is by design. Document it as an accepted limitation: prominent
browser-only note in the README and a `browser` field in the manifest.

Refs #778.
2026-06-24 15:12:23 +08:00

192 lines
7.1 KiB
TypeScript

import type { PPTElement } from '@openmaic/dsl';
export function useOrderElement() {
/**
* Get the z-order range of grouped elements
* @param elementList All elements on the page
* @param combineElementList Grouped elements list
*/
const getCombineElementLevelRange = (
elementList: PPTElement[],
combineElementList: PPTElement[],
) => {
return {
minLevel: elementList.findIndex((_element) => _element.id === combineElementList[0].id),
maxLevel: elementList.findIndex(
(_element) => _element.id === combineElementList[combineElementList.length - 1].id,
),
};
};
/**
* Move up one layer
* @param elementList All elements on the page
* @param element The element being operated on
*/
const moveUpElement = (elementList: PPTElement[], element: PPTElement) => {
const copyOfElementList: PPTElement[] = JSON.parse(JSON.stringify(elementList));
// If the element is a group member, all group members must be moved together
if (element.groupId) {
// Get all group members and their z-order range
const combineElementList = copyOfElementList.filter(
(_element) => _element.groupId === element.groupId,
);
const { minLevel, maxLevel } = getCombineElementLevelRange(elementList, combineElementList);
// Already at the top level, cannot move further
if (maxLevel >= elementList.length - 1) return;
const nextElement = copyOfElementList[maxLevel + 1];
const movedElementList = copyOfElementList.splice(minLevel, combineElementList.length);
if (nextElement.groupId) {
const nextCombineElementList = copyOfElementList.filter(
(_element) => _element.groupId === nextElement.groupId,
);
copyOfElementList.splice(minLevel + nextCombineElementList.length, 0, ...movedElementList);
} else copyOfElementList.splice(minLevel + 1, 0, ...movedElementList);
}
// If the element is not a group member
else {
// Get the element's z-level in the list
const level = elementList.findIndex((item) => item.id === element.id);
// Already at the top level, cannot move further
if (level === elementList.length - 1) return;
// Get the element above, remove this element from the list (cache removed element).
// If the above element is in a group, insert above that group.
// If the above element is not in any group, insert above that element.
const nextElement = copyOfElementList[level + 1];
const [movedElement] = copyOfElementList.splice(level, 1);
if (nextElement.groupId) {
const combineElementList = copyOfElementList.filter(
(_element) => _element.groupId === nextElement.groupId,
);
copyOfElementList.splice(level + combineElementList.length, 0, movedElement);
} else copyOfElementList.splice(level + 1, 0, movedElement);
}
return copyOfElementList;
};
/**
* Move down one layer, same approach as move up
* @param elementList All elements on the page
* @param element The element being operated on
*/
const moveDownElement = (elementList: PPTElement[], element: PPTElement) => {
const copyOfElementList: PPTElement[] = JSON.parse(JSON.stringify(elementList));
if (element.groupId) {
const combineElementList = copyOfElementList.filter(
(_element) => _element.groupId === element.groupId,
);
const { minLevel } = getCombineElementLevelRange(elementList, combineElementList);
if (minLevel === 0) return;
const prevElement = copyOfElementList[minLevel - 1];
const movedElementList = copyOfElementList.splice(minLevel, combineElementList.length);
if (prevElement.groupId) {
const prevCombineElementList = copyOfElementList.filter(
(_element) => _element.groupId === prevElement.groupId,
);
copyOfElementList.splice(minLevel - prevCombineElementList.length, 0, ...movedElementList);
} else copyOfElementList.splice(minLevel - 1, 0, ...movedElementList);
} else {
const level = elementList.findIndex((item) => item.id === element.id);
if (level === 0) return;
const prevElement = copyOfElementList[level - 1];
const movedElement = copyOfElementList.splice(level, 1)[0];
if (prevElement.groupId) {
const combineElementList = copyOfElementList.filter(
(_element) => _element.groupId === prevElement.groupId,
);
copyOfElementList.splice(level - combineElementList.length, 0, movedElement);
} else copyOfElementList.splice(level - 1, 0, movedElement);
}
return copyOfElementList;
};
/**
* Bring to front
* @param elementList All elements on the page
* @param element The element being operated on
*/
const moveTopElement = (elementList: PPTElement[], element: PPTElement) => {
const copyOfElementList: PPTElement[] = JSON.parse(JSON.stringify(elementList));
// If the element is a group member, all group members must be moved together
if (element.groupId) {
// Get all group members and their z-order range
const combineElementList = copyOfElementList.filter(
(_element) => _element.groupId === element.groupId,
);
const { minLevel, maxLevel } = getCombineElementLevelRange(elementList, combineElementList);
// Already at the top level, cannot move further
if (maxLevel === elementList.length - 1) return null;
// Remove the group from the list, then append removed elements to the top
const movedElementList = copyOfElementList.splice(minLevel, combineElementList.length);
copyOfElementList.push(...movedElementList);
}
// If the element is not a group member
else {
// Get the element's z-level in the list
const level = elementList.findIndex((item) => item.id === element.id);
// Already at the top level, cannot move further
if (level === elementList.length - 1) return null;
// Remove the element from the list, then append it to the top
copyOfElementList.splice(level, 1);
copyOfElementList.push(element);
}
return copyOfElementList;
};
/**
* Send to back, same approach as bring to front
* @param elementList All elements on the page
* @param element The element being operated on
*/
const moveBottomElement = (elementList: PPTElement[], element: PPTElement) => {
const copyOfElementList: PPTElement[] = JSON.parse(JSON.stringify(elementList));
if (element.groupId) {
const combineElementList = copyOfElementList.filter(
(_element) => _element.groupId === element.groupId,
);
const { minLevel } = getCombineElementLevelRange(elementList, combineElementList);
if (minLevel === 0) return;
const movedElementList = copyOfElementList.splice(minLevel, combineElementList.length);
copyOfElementList.unshift(...movedElementList);
} else {
const level = elementList.findIndex((item) => item.id === element.id);
if (level === 0) return;
copyOfElementList.splice(level, 1);
copyOfElementList.unshift(element);
}
return copyOfElementList;
};
return {
moveUpElement,
moveDownElement,
moveTopElement,
moveBottomElement,
};
}