mirror of
https://github.com/ZSeven-W/openpencil.git
synced 2026-05-31 19:04:29 +07:00
cb7fa00f5b
The previous commit renamed isBadgeOverlayNode → isOverlayNode without a compat export, which would break external consumers of the published @zseven-w/pen-core package on upgrade. Add a deprecated alias so the old import name keeps resolving. JSDoc flags the behavior change — the alias no longer matches role:'badge'|'pill'|'tag', since those are inline-component roles and must flow in auto-layout.
43 lines
1.5 KiB
TypeScript
43 lines
1.5 KiB
TypeScript
import type { PenNode } from '@zseven-w/pen-types';
|
|
|
|
/**
|
|
* Check if a node is an overlay that uses absolute positioning and should
|
|
* not participate in layout flow.
|
|
*
|
|
* Requires explicit `role: 'overlay'`. Earlier versions matched on
|
|
* `role: 'badge' | 'pill' | 'tag'` plus name regexes, but those are
|
|
* inline-component markers in this repo (see `role-resolver.ts` and
|
|
* `strip-redundant-section-fills.ts` PROTECTED_ROLES) — pulling them out
|
|
* of layout flow collapsed them to (0,0) of their parent and stacked
|
|
* them on top of siblings. `role: 'overlay'` is the dedicated opt-in for
|
|
* notification dots and true floating decorations.
|
|
*/
|
|
export function isOverlayNode(node: PenNode): boolean {
|
|
if ('role' in node) {
|
|
const role = (node as { role?: string }).role;
|
|
if (role === 'overlay') return true;
|
|
}
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* @deprecated Renamed to `isOverlayNode`. Semantics also tightened:
|
|
* this alias no longer returns true for `role: 'badge' | 'pill' | 'tag'`
|
|
* (those are inline-component roles in this repo and should flow in
|
|
* auto-layout, not float). Use `isOverlayNode` and mark true floating
|
|
* decorations with `role: 'overlay'`.
|
|
*/
|
|
export const isBadgeOverlayNode = isOverlayNode;
|
|
|
|
/**
|
|
* Convert a name string to PascalCase.
|
|
* Strips non-alphanumeric characters and joins words.
|
|
*/
|
|
export function sanitizeName(name: string): string {
|
|
return name
|
|
.replace(/[^a-zA-Z0-9\s-_]/g, '')
|
|
.split(/[\s\-_]+/)
|
|
.filter(Boolean)
|
|
.map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
|
|
.join('');
|
|
}
|