@plitzi/plitzi-builder 0.38.3 → 0.38.5

package/dist/modules/Usages/helpers/copy.d.ts

@@ -0,0 +1,21 @@
+import { UsageCategory, UsageTreeKind } from './usageIndex';
+/** The order the panel offers them in. */
+export declare const USAGE_CATEGORIES: readonly UsageCategory[];
+export declare const isUsageCategory: (value: string) => value is UsageCategory;
+type CategoryCopy = {
+    /** What the category is called in the panel's picker. */
+    label: string;
+    /** What the search box searches. */
+    search: string;
+    /** Said when the space declares none. */
+    empty: string;
+    /** Said of an item nothing uses, under its name. */
+    unused: string;
+    /** What the unused filter is called. */
+    unusedFilter: string;
+};
+export declare const CATEGORY_COPY: Record<UsageCategory, CategoryCopy>;
+/** What "unused" can and cannot know, said once over every list. */
+export declare const UNUSED_NOTE = "\u201CUnused\u201D means nothing in this space uses it \u2014 a plugin\u2019s own code or stylesheet may still.";
+export declare const TREE_ICON: Record<UsageTreeKind, string>;
+export {};

package/dist/modules/Usages/helpers/grouping.d.ts

@@ -0,0 +1,14 @@
+import { ElementUsage, SpaceReference, UsageItem, UsageTree } from './usageIndex';
+export type TreeGroup = {
+    tree: UsageTree;
+    elements: ElementUsage[];
+};
+/** The uses of an item by the tree each is in, in the order the index found them: pages and layouts, then components. */
+export declare const groupByTree: (elements: ElementUsage[]) => TreeGroup[];
+/** `3 elements in 2 places`, or what reads it when no element does. */
+export declare const usageSummary: (elements: ElementUsage[], references: SpaceReference[]) => string;
+/**
+ * The count beside a name: the elements that use it; when none does, how many other things read it; and when nothing
+ * does but its name is still said somewhere — in prose, a setting — that it is named, which is why it is not unused.
+ */
+export declare const usageCount: (item: UsageItem) => string;

package/dist/modules/Usages/helpers/grouping.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/modules/Usages/helpers/providerTypes.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The built-in types that exist only to provide data, by the prefix their source is named under.
+ *
+ * Only these are listed when nothing reads them. A list, a modal or a form publishes a source too, but has a job of its
+ * own besides — one whose source nobody reads is not one to clean up — so those are listed once something reads them.
+ */
+export declare const PROVIDER_TYPES: Readonly<Record<string, string>>;

package/dist/modules/Usages/helpers/unusedParity.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/modules/Usages/helpers/usageIndex.d.ts

@@ -0,0 +1,67 @@
+import { Schema, Style } from '@plitzi/sdk-shared';
+export type UsageCategory = 'components' | 'classes' | 'variables' | 'dataSources';
+export type UsageTreeKind = 'page' | 'layout' | 'component';
+/** A tree of the document an element lives in: a page or a layout of `schema.flat`, or a component's own `flat`. */
+export type UsageTree = {
+    kind: UsageTreeKind;
+    id: string;
+    label: string;
+};
+/** One element that uses an item, and in which ways — `var(--brand) in .btn`, `apiContainer_products.data`. */
+export type ElementUsage = {
+    elementId: string;
+    elementType: string;
+    /** Free display text, only when it says something the id does not. */
+    label?: string;
+    tree: UsageTree;
+    via: string[];
+};
+/** A use that is not an element: a selector, another token, the space's custom CSS, a computed value. */
+export type SpaceReference = {
+    kind: 'selector' | 'variable' | 'customCss' | 'computed';
+    name: string;
+};
+export type UsageItem = {
+    /** Unique across the whole index: `component:card`, `class:btn`, `token:color:brand`, `source:state`. */
+    key: string;
+    name: string;
+    /** What it is within its category: a token's group, `space variable`, a provider's source prefix, `global`. */
+    detail: string;
+    /** The element that declares it, where one does: a component's root, a data source's provider. */
+    owner?: ElementUsage;
+    elements: ElementUsage[];
+    references: SpaceReference[];
+    /**
+     * Declared and used by nothing the space holds. For a class, a token or a component this is sdk-authoring's rule —
+     * the one its `unused-*` suggestions follow — which is more generous than `elements` and `references`: a class
+     * named as a word anywhere, in prose included, is not called unused.
+     */
+    unused: boolean;
+};
+export type UsageIndex = Record<UsageCategory, UsageItem[]>;
+export type UsageSource = {
+    schema: Schema;
+    style: Pick<Style, 'platform' | 'variables' | 'fonts'>;
+    /**
+     * Element type → the prefix the source it publishes is named under (`{ apiContainer: 'apiContainer' }`). A provider
+     * of these types is listed even when nothing reads it; any other element is listed as a source once something does.
+     */
+    providerTypes?: Readonly<Record<string, string>>;
+};
+/**
+ * Where everything the space declares is used: each component's instances, the elements wearing each class, what
+ * reads each style token and space variable, and what binds to each data source — in one pass over the document.
+ *
+ * Reads only what is written down. A class added by a plugin at run time, a token a plugin's own stylesheet reads, a
+ * source a template assembles from pieces: none of them can be seen from the document, so an item with no uses is
+ * one nothing in the SPACE uses.
+ */
+export declare const buildUsageIndex: (source: UsageSource) => UsageIndex;
+/** Declared, and used by nothing the space holds: a candidate to remove. */
+export declare const isUnused: (item: UsageItem) => boolean;
+/**
+ * `buildUsageIndex`, kept for the last document it was asked about: every reader of the same schema and style shares
+ * one index, and an edit rebuilds it reading again only the elements and selectors that changed — those are new
+ * objects, every other one is the object it was.
+ */
+export declare const usageIndexOf: (source: UsageSource) => UsageIndex;

package/dist/modules/Usages/helpers/usageIndex.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/modules/Usages/hooks/useUsageIndex.d.ts

@@ -0,0 +1,9 @@
+import { UsageIndex } from '../helpers/usageIndex';
+/**
+ * The space's usage index, for what the builder holds now.
+ *
+ * Deferred: an edit is drawn first and the index catches up after it, so typing in a field is never held up by a
+ * rebuild — which re-reads only the elements and selectors the edit changed.
+ */
+declare const useUsageIndex: () => UsageIndex;
+export default useUsageIndex;

package/dist/modules/Usages/index.d.ts

@@ -0,0 +1,3 @@
+import { default as Usages } from './Usages';
+export * from './Usages';
+export default Usages;

package/dist/package.json.d.ts

@@ -1,6 +1,6 @@
 declare const _default: {
   "name": "@plitzi/plitzi-builder",
-  "version": "0.38.3",
+  "version": "0.38.5",
   "homepage": "./",
   "license": "AGPL-3.0",
   "files": [
@@ -34,7 +34,7 @@ declare const _default: {
     "@fortawesome/fontawesome-free": "^7.3.1",
     "@plitzi/nexus": "^1.4.0",
     "@plitzi/plitzi-sdk": "workspace:*",
-    "@plitzi/plitzi-ui": "^1.6.29",
+    "@plitzi/plitzi-ui": "^1.6.31",
     "@plitzi/sdk-auth": "workspace:*",
     "@plitzi/sdk-authoring": "workspace:*",
     "@plitzi/sdk-dev-tools": "workspace:*",
@@ -47,7 +47,6 @@ declare const _default: {
     "@plitzi/sdk-shared": "workspace:*",
     "@plitzi/sdk-style": "workspace:*",
     "@plitzi/sdk-variables": "workspace:*",
-    "@tanstack/react-virtual": "^3.14.13",
     "@typescript/vfs": "^1.6.5",
     "@valtown/codemirror-ts": "^2.3.1",
     "apollo-upload-client": "^20.0.0",
@@ -68,34 +67,18 @@ declare const _default: {
     "react-dom": "^19"
   },
   "devDependencies": {
-    "@babel/compat-data": "^8.0.5",
-    "@babel/core": "^8.0.6",
-    "@babel/helper-builder-react-jsx-experimental": "^7.12.11",
-    "@babel/helper-validator-identifier": "^8.0.6",
-    "@babel/plugin-proposal-class-properties": "^7.18.6",
-    "@babel/plugin-transform-private-methods": "^8.0.1",
-    "@babel/plugin-transform-runtime": "^8.0.6",
-    "@babel/polyfill": "^7.12.1",
-    "@babel/preset-env": "^8.0.6",
-    "@babel/preset-react": "^8.0.1",
     "@plitzi/sdk-server": "workspace:*",
+    "@tailwindcss/forms": "^0.5.11",
     "@tailwindcss/postcss": "^4.3.3",
-    "css-loader": "^7.1.5",
     "eslint": "^9.39.5",
     "eslint-plugin-import": "^2.32.0",
-    "flow-bin": "^0.334.0",
     "postcss": "^8.5.28",
-    "postcss-loader": "^8.2.1",
     "postcss-scss": "^4.0.9",
     "prettier": "^3.9.9",
-    "prop-types": "^15.8.1",
     "react": "^19.3.0",
     "react-dom": "^19.3.0",
-    "react-refresh": "^0.19.0",
-    "react-test-renderer": "^19.3.0",
     "sass": "^1.105.1",
     "sass-embedded": "^1.105.1",
-    "sass-loader": "^17.0.1",
     "stylelint": "^17.16.0",
     "stylelint-order": "^8.1.1",
     "stylelint-scss": "^7.3.0",
@@ -105,7 +88,6 @@ declare const _default: {
     "vite-plugin-dts": "^5.1.2",
     "vite-plugin-ejs": "^2.0.0",
     "vite-plugin-mkcert": "^2.1.0",
-    "vite-plugin-react": "^4.0.1",
     "vitest": "^5.0.3"
   },
   "scripts": {