@staging-apiplus/essentials 0.0.0-stage → 0.0.1

package/README.md

@@ -1,3 +1,31 @@
-# Temporary Holding Version
+# `@staging-apiplus/essentials`
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+First-party QuickPage code package: **gallery** (code component) and **slider** / **tab** (logic). Source for the **System library** snapshot (`@staging-apiplus/essentials`).
+
+## Tooling dependencies
+
+| Context | `@packages/qp-sdk` / `@packages/qp-cli` |
+| --- | --- |
+| **Monorepo root** `pnpm install` | `workspace:@packages/qp-*@^0.0.1` — links in-tree packages (no Verdaccio required) |
+| **Registry-shaped** (same as external authors) | `make publish-qp-tooling-dev` with mock-registry up, then `pnpm install` in this folder — resolves via [`.npmrc`](../.npmrc) at `^0.0.1` |
+
+No Node `imports` map to `packages/qp_sdk/src` — builds use published SDK layout like third-party packages.
+
+## Commands
+
+```bash
+pnpm run dev        # qp dev — playground + HMR (+ QuickPage Link dev for editor/preview)
+pnpm run build      # qp build → dist/ (also via make build-code-packages)
+pnpm run validate   # qp validate
+pnpm run test:unit  # schema + DOM helper tests
+```
+
+## Author documentation
+
+Lifecycle (editor / preview / published), SDK APIs, and logic tiers — applies to **all** code packages:
+
+**[Module author guide](../../docs/code-packages/guides/module-author.md)** — CE + `designTime` logic. In QuickPage, attach tab/slider via **Code → Logic → Apply** on wired chrome ([logic presets](../../docs/code-packages/guides/logic-presets.md)).
+
+**Dev (Tilt + isolate):** [consolidated dev flow](../../docs/code-packages/guides/development.md#consolidated-dev-flow-canonical) — **Link dev** for HMR; **`qp publish`** to dev registry then **Refresh in editor** / reload staging.
+
+Broader context: [code packages hub](../../docs/code-packages/README.md), [artifact scenarios (all envs)](../../docs/code-packages/reference/artifact-scenarios.md), [author quickstart](../../packages/qp_sdk/docs/author-quickstart.md).

package/dist/derive_logic_editor_panel-D_bgZnMq.js

@@ -0,0 +1,56 @@
+//#region ../../packages/qp_sdk/src/define/define_logic_editor.ts
+function e(e) {
+	return {
+		kind: "logic-editor",
+		editorPanel: e.editorPanel,
+		mount: e.mount ?? (() => {}),
+		onAction: e.onAction
+	};
+}
+//#endregion
+//#region ../../packages/qp_sdk/src/editor/derive_logic_editor_panel.ts
+function t(e, t, n) {
+	if (!e?.items) return [];
+	let r = e.activeIndexStateKey, i = [], a = n?.includeSettings ?? !0, o = n?.includeStates ?? !0;
+	if (e.items.label && e.items.content && t.labelRole) i.push({
+		type: "linked-pairs",
+		id: "manage-tabs",
+		label: e.items.add?.label ?? "Items",
+		triggerRole: t.labelRole,
+		panelRole: t.contentRole,
+		activeStateKey: r,
+		actions: {
+			reorder: "reorderTab",
+			delete: "removeTab",
+			add: "addTab",
+			setActive: "setActiveTab"
+		}
+	});
+	else if (e.items.content && t.contentRole) {
+		let a = n?.contentActions ?? {
+			reorder: "reorderItem",
+			remove: "removeItem",
+			add: "addItem",
+			setActive: "setActiveItem"
+		};
+		i.push({
+			type: "collection",
+			id: "content-items",
+			label: e.items.add?.label ?? "Items",
+			role: t.contentRole,
+			activeStateKey: r,
+			suggestClass: n?.suggestClass,
+			actions: a
+		});
+	}
+	return o && e.states && i.push({
+		type: "logic-states",
+		id: "logic-states",
+		label: "States"
+	}), a && i.push({
+		type: "settings",
+		source: "logic-schema"
+	}), i;
+}
+//#endregion
+export { e as n, t };

package/dist/design_time-BeEBEFSF.js

@@ -0,0 +1,39 @@
+import { t as e } from "./logic_role_kind-DV5olnbL.js";
+//#region src/tab/editor/roles.ts
+var t = {
+	Host: "tabs",
+	TabList: "tabList",
+	Tab: "tab",
+	PanelList: "panelList",
+	Panel: "panel"
+};
+t.TabList, e.Container, t.Tab, e.Repeatable, t.PanelList, e.Container, t.Panel, e.Repeatable;
+//#endregion
+//#region src/tab/editor/design_time.ts
+var n = {
+	mode: "active-item",
+	activeIndexStateKey: "activeTabIndex",
+	items: {
+		label: { list: t.TabList },
+		content: {
+			list: t.PanelList,
+			hideInactive: !0
+		},
+		add: {
+			label: "Add tab",
+			name: "Tab {n}"
+		}
+	},
+	states: {
+		[t.Tab]: {
+			selected: {
+				marker: "aria-selected",
+				required: !0
+			},
+			hover: {}
+		},
+		[t.Panel]: { active: { automatic: !0 } }
+	}
+};
+//#endregion
+export { t as n, n as t };

package/dist/design_time-hqGakP97.js

@@ -0,0 +1,47 @@
+import { t as e } from "./logic_role_kind-DV5olnbL.js";
+//#region src/slider/editor/roles.ts
+var t = {
+	Host: "slider",
+	Wrapper: "wrapper",
+	Slide: "slide",
+	Pagination: "pagination",
+	PaginationDot: "paginationDot",
+	Prev: "prev",
+	Next: "next"
+};
+t.Wrapper, e.Container, t.Slide, e.Repeatable, t.Pagination, e.Control, t.PaginationDot, e.Repeatable, t.Prev, e.Control, t.Next, e.Control;
+//#endregion
+//#region src/slider/editor/design_time.ts
+var n = {
+	mode: "active-item",
+	activeIndexStateKey: "activeSlideIndex",
+	items: {
+		content: {
+			list: t.Wrapper,
+			hideInactive: !0
+		},
+		markers: {
+			list: t.Pagination,
+			template: t.PaginationDot,
+			variables: ["slideIndex", "slideNumber"]
+		},
+		add: {
+			label: "Add slide",
+			name: "Slide {n}"
+		}
+	},
+	states: { [t.PaginationDot]: { selected: {
+		marker: "aria-current",
+		required: !0
+	} } },
+	controls: {
+		[t.Prev]: { disabled: { marker: "aria-disabled" } },
+		[t.Next]: { disabled: { marker: "aria-disabled" } }
+	},
+	chromeNavigation: {
+		prevRole: t.Prev,
+		nextRole: t.Next
+	}
+};
+//#endregion
+export { t as n, n as t };

package/dist/gallery/package.json

@@ -0,0 +1,7 @@
+{
+  "quickpage": {
+    "id": "gallery",
+    "kind": "component",
+    "name": "gallery"
+  }
+}