@objectstack/studio 5.2.0 → 9.5.0

package/LICENSE.apache

@@ -0,0 +1,202 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute
+          must include a readable copy of the attribution notices
+          contained within such NOTICE file, excluding those notices
+          that do not pertain to any part of the Derivative Works,
+          in at least one of the following places: within a NOTICE
+          text file distributed as part of the Derivative Works; within
+          the Source form or documentation, if provided along with
+          the Derivative Works; or, within a display generated by the
+          Derivative Works, if and wherever such third-party notices
+          normally appear. The contents of the NOTICE file are for
+          informational purposes only and do not modify the License.
+          You may add Your own attribution notices within Derivative
+          Works that You distribute, alongside or as an addendum to
+          the NOTICE text from the Work, provided that such additional
+          attribution notices cannot be construed as modifying the
+          License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 ObjectStack
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/dist/index.d.mts

@@ -0,0 +1,71 @@
+export { STUDIO_APP } from '@objectstack/platform-objects/apps';
+import { Doc } from '@objectstack/spec/system';
+
+/**
+ * Studio app overview doc (ADR-0046), registered in this package's manifest so
+ * it groups under "Studio" in the `/_console/docs` index.
+ *
+ * Authored inline rather than as a flat `src/docs/*.md` file because this is a
+ * TS-first code package built by tsup, not a user app built by `os build` —
+ * `defineStack({ docs })` / manifest `docs[]` is the supported path for those
+ * (see `DocSchema` in `@objectstack/spec/system`). The `content` below is plain
+ * CommonMark + GFM with no images/MDX, per ADR-0046 §3.4.
+ *
+ * Principle (from the HotCRM reference docs): document the *invisible*
+ * business logic, not what the Studio UI already shows on screen.
+ *
+ * `translations` carries per-locale variants (ADR-0046 i18n); the REST layer
+ * collapses the doc to the request's `Accept-Language` and serves one body.
+ */
+declare const STUDIO_OVERVIEW_DOC: Doc;
+
+/**
+ * `@objectstack/studio` — the Studio metadata-builder app as its own ObjectStack
+ * package (ADR-0048: one app per package).
+ *
+ * Studio is a console navigation-shell app (an `AppSchema`), not a kernel
+ * extension — but it still needs a thin registration entry to publish its
+ * manifest into the running kernel, mirroring how `@objectstack/plugin-auth`
+ * registers its own manifest. Giving it a distinct package id
+ * (`com.objectstack.studio`) is what lets `/apps/<packageId>` resolve to exactly
+ * this app instead of being ambiguous inside a multi-app package.
+ *
+ * NOTE (transitional): the `STUDIO_APP` schema is still imported from
+ * `@objectstack/platform-objects/apps`; a follow-up moves the definition into
+ * this package and drops the dependency. This package is intentionally NOT yet
+ * wired into the dev/serve plugin set — that boot-path switch (and removing the
+ * app from plugin-auth's manifest) lands separately so it can be verified
+ * against a live `os dev` boot.
+ */
+
+declare const STUDIO_APP_PACKAGE_ID = "com.objectstack.studio";
+declare const STUDIO_APP_NAMESPACE = "studio";
+declare const STUDIO_APP_VERSION = "9.3.0";
+/** Manifest header for the Studio app package. */
+declare const studioAppManifestHeader: {
+    id: string;
+    namespace: string;
+    version: string;
+    type: "plugin";
+    scope: "system";
+    name: string;
+    description: string;
+    dependencies: string[];
+};
+/**
+ * Thin plugin that registers the Studio app manifest. Structurally typed
+ * against the kernel `Plugin` contract (no compile-time kernel dependency),
+ * exactly like `AuthPlugin`.
+ */
+declare class StudioAppPlugin {
+    readonly name = "com.objectstack.studio";
+    readonly type = "standard";
+    readonly version = "9.3.0";
+    readonly dependencies: string[];
+    init(_ctx: any): Promise<void>;
+    start(ctx: any): Promise<void>;
+}
+/** Convenience factory mirroring the rest of the plugin ecosystem. */
+declare function createStudioAppPlugin(): StudioAppPlugin;
+
+export { STUDIO_APP_NAMESPACE, STUDIO_APP_PACKAGE_ID, STUDIO_APP_VERSION, STUDIO_OVERVIEW_DOC, StudioAppPlugin, createStudioAppPlugin, studioAppManifestHeader };

package/dist/index.d.ts

@@ -0,0 +1,71 @@
+export { STUDIO_APP } from '@objectstack/platform-objects/apps';
+import { Doc } from '@objectstack/spec/system';
+
+/**
+ * Studio app overview doc (ADR-0046), registered in this package's manifest so
+ * it groups under "Studio" in the `/_console/docs` index.
+ *
+ * Authored inline rather than as a flat `src/docs/*.md` file because this is a
+ * TS-first code package built by tsup, not a user app built by `os build` —
+ * `defineStack({ docs })` / manifest `docs[]` is the supported path for those
+ * (see `DocSchema` in `@objectstack/spec/system`). The `content` below is plain
+ * CommonMark + GFM with no images/MDX, per ADR-0046 §3.4.
+ *
+ * Principle (from the HotCRM reference docs): document the *invisible*
+ * business logic, not what the Studio UI already shows on screen.
+ *
+ * `translations` carries per-locale variants (ADR-0046 i18n); the REST layer
+ * collapses the doc to the request's `Accept-Language` and serves one body.
+ */
+declare const STUDIO_OVERVIEW_DOC: Doc;
+
+/**
+ * `@objectstack/studio` — the Studio metadata-builder app as its own ObjectStack
+ * package (ADR-0048: one app per package).
+ *
+ * Studio is a console navigation-shell app (an `AppSchema`), not a kernel
+ * extension — but it still needs a thin registration entry to publish its
+ * manifest into the running kernel, mirroring how `@objectstack/plugin-auth`
+ * registers its own manifest. Giving it a distinct package id
+ * (`com.objectstack.studio`) is what lets `/apps/<packageId>` resolve to exactly
+ * this app instead of being ambiguous inside a multi-app package.
+ *
+ * NOTE (transitional): the `STUDIO_APP` schema is still imported from
+ * `@objectstack/platform-objects/apps`; a follow-up moves the definition into
+ * this package and drops the dependency. This package is intentionally NOT yet
+ * wired into the dev/serve plugin set — that boot-path switch (and removing the
+ * app from plugin-auth's manifest) lands separately so it can be verified
+ * against a live `os dev` boot.
+ */
+
+declare const STUDIO_APP_PACKAGE_ID = "com.objectstack.studio";
+declare const STUDIO_APP_NAMESPACE = "studio";
+declare const STUDIO_APP_VERSION = "9.3.0";
+/** Manifest header for the Studio app package. */
+declare const studioAppManifestHeader: {
+    id: string;
+    namespace: string;
+    version: string;
+    type: "plugin";
+    scope: "system";
+    name: string;
+    description: string;
+    dependencies: string[];
+};
+/**
+ * Thin plugin that registers the Studio app manifest. Structurally typed
+ * against the kernel `Plugin` contract (no compile-time kernel dependency),
+ * exactly like `AuthPlugin`.
+ */
+declare class StudioAppPlugin {
+    readonly name = "com.objectstack.studio";
+    readonly type = "standard";
+    readonly version = "9.3.0";
+    readonly dependencies: string[];
+    init(_ctx: any): Promise<void>;
+    start(ctx: any): Promise<void>;
+}
+/** Convenience factory mirroring the rest of the plugin ecosystem. */
+declare function createStudioAppPlugin(): StudioAppPlugin;
+
+export { STUDIO_APP_NAMESPACE, STUDIO_APP_PACKAGE_ID, STUDIO_APP_VERSION, STUDIO_OVERVIEW_DOC, StudioAppPlugin, createStudioAppPlugin, studioAppManifestHeader };

package/dist/index.js

@@ -0,0 +1,138 @@
+'use strict';
+
+var apps = require('@objectstack/platform-objects/apps');
+
+// src/index.ts
+
+// src/studio-overview.doc.ts
+var STUDIO_OVERVIEW_DOC = {
+  name: "studio_overview",
+  label: "Studio overview",
+  description: "Orientation for builders: the metadata-first model, overlay precedence, and publishing.",
+  content: `# Studio overview
+
+Studio is the builder app \u2014 the workbench for shaping the platform's
+*metadata*: objects, fields, views, flows, agents, and the rest. Most of its
+screens are self-explanatory; this page covers the one rule that is not visible
+on screen but governs everything you do here. For the full reference, see
+<https://docs.objectstack.ai>.
+
+## Metadata-first
+
+In Studio you do not edit a running database \u2014 you edit *definitions*. Every
+object, field, and view is a metadata record, and the live application is
+generated from that metadata. This is why a change in Studio can reshape the UI
+and the API at once: you are changing the model, not patching a screen.
+
+## Edits are overlays (the invisible rule)
+
+Your changes do not mutate the metadata shipped by a package in place. Studio
+writes an **overlay** on top of the base definition, and the runtime resolves
+the two by precedence: an unpublished **draft** wins for you while you work, a
+published **tenant overlay** wins over the package's baseline, and the package
+baseline is the fallback (ADR-0005, ADR-0033). The practical consequence: the
+base definition is never destroyed, so an overlay can always be reverted to
+recover the original \u2014 and a field that "won't change" is usually being shadowed
+by a higher-precedence layer.
+
+## Publishing & deploying
+
+A draft is visible only to you until you **publish** it, which promotes the
+overlay so the rest of the tenant sees it. Moving changes between environments
+(for example dev \u2192 production) is a separate **deploy** step, not an automatic
+side effect of publishing \u2014 keeping the two distinct is what lets you build
+safely in one environment before shipping.
+
+See <https://docs.objectstack.ai> for drafts, overlays, and deployment in depth.
+`,
+  translations: {
+    zh: {
+      label: "Studio \u6982\u89C8",
+      description: "\u642D\u5EFA\u8005\u5165\u95E8:\u5143\u6570\u636E\u4F18\u5148\u6A21\u578B\u3001\u8986\u76D6\u5C42\u4F18\u5148\u7EA7\u3001\u53D1\u5E03\u4E0E\u90E8\u7F72\u3002",
+      content: `# Studio \u6982\u89C8
+
+Studio \u662F\u642D\u5EFA\u8005\u5E94\u7528\u2014\u2014\u5851\u9020\u5E73\u53F0*\u5143\u6570\u636E*\u7684\u5DE5\u4F5C\u53F0:\u5BF9\u8C61\u3001\u5B57\u6BB5\u3001\u89C6\u56FE\u3001\u6D41\u7A0B\u3001\u667A\u80FD\u4F53\u7B49\u3002
+\u5B83\u7684\u5927\u591A\u6570\u754C\u9762\u4E00\u76EE\u4E86\u7136;\u672C\u9875\u8BB2\u7684\u662F\u90A3\u6761\u754C\u9762\u4E0A\u770B\u4E0D\u89C1\u3001\u5374\u652F\u914D\u4F60\u5728\u8FD9\u91CC\u4E00\u5207\u64CD\u4F5C\u7684\u89C4\u5219\u3002
+\u5B8C\u6574\u53C2\u8003\u89C1 <https://docs.objectstack.ai>\u3002
+
+## \u5143\u6570\u636E\u4F18\u5148
+
+\u5728 Studio \u91CC\u4F60\u7F16\u8F91\u7684\u4E0D\u662F\u8FD0\u884C\u4E2D\u7684\u6570\u636E\u5E93,\u800C\u662F*\u5B9A\u4E49*\u3002\u6BCF\u4E2A\u5BF9\u8C61\u3001\u5B57\u6BB5\u3001\u89C6\u56FE\u90FD\u662F\u4E00\u6761
+\u5143\u6570\u636E\u8BB0\u5F55,\u8FD0\u884C\u7684\u5E94\u7528\u7531\u8FD9\u4E9B\u5143\u6570\u636E\u751F\u6210\u3002\u8FD9\u5C31\u662F\u4E3A\u4EC0\u4E48 Studio \u91CC\u7684\u4E00\u5904\u6539\u52A8\u80FD\u540C\u65F6\u91CD\u5851
+UI \u548C API:\u4F60\u6539\u7684\u662F\u6A21\u578B,\u800C\u4E0D\u662F\u4FEE\u8865\u67D0\u4E2A\u754C\u9762\u3002
+
+## \u7F16\u8F91\u5373\u8986\u76D6\u5C42(\u770B\u4E0D\u89C1\u7684\u89C4\u5219)
+
+\u4F60\u7684\u6539\u52A8\u4E0D\u4F1A\u539F\u5730\u4FEE\u6539\u67D0\u4E2A\u5305\u53D1\u5E03\u7684\u5143\u6570\u636E\u3002Studio \u5728\u57FA\u7840\u5B9A\u4E49\u4E4B\u4E0A\u5199\u4E00\u5C42**\u8986\u76D6\u5C42**,
+\u8FD0\u884C\u65F6\u6309\u4F18\u5148\u7EA7\u89E3\u6790\u4E24\u8005:\u672A\u53D1\u5E03\u7684**\u8349\u7A3F**\u5728\u4F60\u7F16\u8F91\u65F6\u5BF9\u4F60\u751F\u6548,\u5DF2\u53D1\u5E03\u7684**\u79DF\u6237\u8986\u76D6\u5C42**
+\u4F18\u5148\u4E8E\u5305\u7684\u57FA\u7EBF,\u5305\u57FA\u7EBF\u5219\u662F\u515C\u5E95(ADR-0005\u3001ADR-0033)\u3002\u5B9E\u9645\u540E\u679C:\u57FA\u7840\u5B9A\u4E49\u6C38\u4E0D\u88AB
+\u9500\u6BC1,\u6240\u4EE5\u8986\u76D6\u5C42\u603B\u80FD\u56DE\u9000\u4EE5\u6062\u590D\u539F\u6837\u2014\u2014\u800C\u4E00\u4E2A"\u6539\u4E0D\u52A8"\u7684\u5B57\u6BB5,\u901A\u5E38\u662F\u88AB\u66F4\u9AD8\u4F18\u5148\u7EA7\u7684
+\u5C42\u906E\u4F4F\u4E86\u3002
+
+## \u53D1\u5E03\u4E0E\u90E8\u7F72
+
+\u8349\u7A3F\u53EA\u5BF9\u4F60\u81EA\u5DF1\u53EF\u89C1,\u76F4\u5230\u4F60**\u53D1\u5E03**\u5B83,\u628A\u8986\u76D6\u5C42\u63D0\u5347\u7ED9\u6574\u4E2A\u79DF\u6237\u770B\u5230\u3002\u5728\u73AF\u5883\u4E4B\u95F4\u642C\u8FD0
+\u6539\u52A8(\u4F8B\u5982\u5F00\u53D1 \u2192 \u751F\u4EA7)\u662F\u5355\u72EC\u7684**\u90E8\u7F72**\u6B65\u9AA4,\u4E0D\u662F\u53D1\u5E03\u7684\u81EA\u52A8\u526F\u4F5C\u7528\u2014\u2014\u628A\u4E24\u8005\u5206\u5F00,
+\u624D\u80FD\u8BA9\u4F60\u5728\u4E00\u4E2A\u73AF\u5883\u91CC\u5B89\u5168\u642D\u5EFA\u3001\u518D\u4E0A\u7EBF\u3002
+
+\u8349\u7A3F\u3001\u8986\u76D6\u5C42\u4E0E\u90E8\u7F72\u7684\u7EC6\u8282\u89C1 <https://docs.objectstack.ai>\u3002
+`
+    }
+  }
+};
+
+// src/index.ts
+var STUDIO_APP_PACKAGE_ID = "com.objectstack.studio";
+var STUDIO_APP_NAMESPACE = "studio";
+var STUDIO_APP_VERSION = "9.3.0";
+var studioAppManifestHeader = {
+  id: STUDIO_APP_PACKAGE_ID,
+  namespace: STUDIO_APP_NAMESPACE,
+  version: STUDIO_APP_VERSION,
+  type: "plugin",
+  scope: "system",
+  name: "Studio",
+  description: "ObjectStack Studio \u2014 metadata builder app.",
+  // Studio navigates platform metadata owned by plugin-auth; declare the
+  // dependency so it loads after the auth objects are registered.
+  dependencies: ["com.objectstack.plugin-auth"]
+};
+var StudioAppPlugin = class {
+  constructor() {
+    this.name = STUDIO_APP_PACKAGE_ID;
+    this.type = "standard";
+    this.version = STUDIO_APP_VERSION;
+    // Kernel plugin dependency is matched by plugin NAME (AuthPlugin.name =
+    // 'com.objectstack.auth'), not by package id.
+    this.dependencies = ["com.objectstack.auth"];
+  }
+  async init(_ctx) {
+  }
+  async start(ctx) {
+    const manifest = ctx?.getService?.("manifest");
+    if (!manifest || typeof manifest.register !== "function") return;
+    manifest.register({
+      ...studioAppManifestHeader,
+      apps: [apps.STUDIO_APP],
+      // ADR-0046 package docs — grouped under "Studio" at /_console/docs.
+      docs: [STUDIO_OVERVIEW_DOC]
+    });
+  }
+};
+function createStudioAppPlugin() {
+  return new StudioAppPlugin();
+}
+
+Object.defineProperty(exports, "STUDIO_APP", {
+  enumerable: true,
+  get: function () { return apps.STUDIO_APP; }
+});
+exports.STUDIO_APP_NAMESPACE = STUDIO_APP_NAMESPACE;
+exports.STUDIO_APP_PACKAGE_ID = STUDIO_APP_PACKAGE_ID;
+exports.STUDIO_APP_VERSION = STUDIO_APP_VERSION;
+exports.STUDIO_OVERVIEW_DOC = STUDIO_OVERVIEW_DOC;
+exports.StudioAppPlugin = StudioAppPlugin;
+exports.createStudioAppPlugin = createStudioAppPlugin;
+exports.studioAppManifestHeader = studioAppManifestHeader;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/studio-overview.doc.ts","../src/index.ts"],"names":["STUDIO_APP"],"mappings":";;;;;;;AAoBO,IAAM,mBAAA,GAA2B;AAAA,EACtC,IAAA,EAAM,iBAAA;AAAA,EACN,KAAA,EAAO,iBAAA;AAAA,EACP,WAAA,EAAa,yFAAA;AAAA,EACb,OAAA,EAAS,CAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;;AAAA;AAAA;AAAA;AAAA;;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA,CAAA;AAAA,EAoCT,YAAA,EAAc;AAAA,IACZ,EAAA,EAAI;AAAA,MACF,KAAA,EAAO,qBAAA;AAAA,MACP,WAAA,EAAa,+JAAA;AAAA,MACb,OAAA,EAAS,CAAA;;AAAA;AAAA;AAAA;;AAAA;;AAAA;AAAA;AAAA;;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;AA4BX;AAEJ;;;ACrEO,IAAM,qBAAA,GAAwB;AAC9B,IAAM,oBAAA,GAAuB;AAC7B,IAAM,kBAAA,GAAqB;AAG3B,IAAM,uBAAA,GAA0B;AAAA,EACrC,EAAA,EAAI,qBAAA;AAAA,EACJ,SAAA,EAAW,oBAAA;AAAA,EACX,OAAA,EAAS,kBAAA;AAAA,EACT,IAAA,EAAM,QAAA;AAAA,EACN,KAAA,EAAO,QAAA;AAAA,EACP,IAAA,EAAM,QAAA;AAAA,EACN,WAAA,EAAa,iDAAA;AAAA;AAAA;AAAA,EAGb,YAAA,EAAc,CAAC,6BAA6B;AAC9C;AAOO,IAAM,kBAAN,MAAsB;AAAA,EAAtB,WAAA,GAAA;AACL,IAAA,IAAA,CAAS,IAAA,GAAO,qBAAA;AAChB,IAAA,IAAA,CAAS,IAAA,GAAO,UAAA;AAChB,IAAA,IAAA,CAAS,OAAA,GAAU,kBAAA;AAGnB;AAAA;AAAA,IAAA,IAAA,CAAS,YAAA,GAAyB,CAAC,sBAAsB,CAAA;AAAA,EAAA;AAAA,EAEzD,MAAM,KAAK,IAAA,EAA0B;AAAA,EAErC;AAAA,EAEA,MAAM,MAAM,GAAA,EAAyB;AACnC,IAAA,MAAM,QAAA,GAAW,GAAA,EAAK,UAAA,GAAa,UAAU,CAAA;AAC7C,IAAA,IAAI,CAAC,QAAA,IAAY,OAAO,QAAA,CAAS,aAAa,UAAA,EAAY;AAC1D,IAAA,QAAA,CAAS,QAAA,CAAS;AAAA,MAChB,GAAG,uBAAA;AAAA,MACH,IAAA,EAAM,CAACA,eAAU,CAAA;AAAA;AAAA,MAEjB,IAAA,EAAM,CAAC,mBAAmB;AAAA,KAC3B,CAAA;AAAA,EACH;AACF;AAGO,SAAS,qBAAA,GAAyC;AACvD,EAAA,OAAO,IAAI,eAAA,EAAgB;AAC7B","file":"index.js","sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Doc } from '@objectstack/spec/system';\n\n/**\n * Studio app overview doc (ADR-0046), registered in this package's manifest so\n * it groups under \"Studio\" in the `/_console/docs` index.\n *\n * Authored inline rather than as a flat `src/docs/*.md` file because this is a\n * TS-first code package built by tsup, not a user app built by `os build` —\n * `defineStack({ docs })` / manifest `docs[]` is the supported path for those\n * (see `DocSchema` in `@objectstack/spec/system`). The `content` below is plain\n * CommonMark + GFM with no images/MDX, per ADR-0046 §3.4.\n *\n * Principle (from the HotCRM reference docs): document the *invisible*\n * business logic, not what the Studio UI already shows on screen.\n *\n * `translations` carries per-locale variants (ADR-0046 i18n); the REST layer\n * collapses the doc to the request's `Accept-Language` and serves one body.\n */\nexport const STUDIO_OVERVIEW_DOC: Doc = {\n  name: 'studio_overview',\n  label: 'Studio overview',\n  description: 'Orientation for builders: the metadata-first model, overlay precedence, and publishing.',\n  content: `# Studio overview\n\nStudio is the builder app — the workbench for shaping the platform's\n*metadata*: objects, fields, views, flows, agents, and the rest. Most of its\nscreens are self-explanatory; this page covers the one rule that is not visible\non screen but governs everything you do here. For the full reference, see\n<https://docs.objectstack.ai>.\n\n## Metadata-first\n\nIn Studio you do not edit a running database — you edit *definitions*. Every\nobject, field, and view is a metadata record, and the live application is\ngenerated from that metadata. This is why a change in Studio can reshape the UI\nand the API at once: you are changing the model, not patching a screen.\n\n## Edits are overlays (the invisible rule)\n\nYour changes do not mutate the metadata shipped by a package in place. Studio\nwrites an **overlay** on top of the base definition, and the runtime resolves\nthe two by precedence: an unpublished **draft** wins for you while you work, a\npublished **tenant overlay** wins over the package's baseline, and the package\nbaseline is the fallback (ADR-0005, ADR-0033). The practical consequence: the\nbase definition is never destroyed, so an overlay can always be reverted to\nrecover the original — and a field that \"won't change\" is usually being shadowed\nby a higher-precedence layer.\n\n## Publishing & deploying\n\nA draft is visible only to you until you **publish** it, which promotes the\noverlay so the rest of the tenant sees it. Moving changes between environments\n(for example dev → production) is a separate **deploy** step, not an automatic\nside effect of publishing — keeping the two distinct is what lets you build\nsafely in one environment before shipping.\n\nSee <https://docs.objectstack.ai> for drafts, overlays, and deployment in depth.\n`,\n  translations: {\n    zh: {\n      label: 'Studio 概览',\n      description: '搭建者入门:元数据优先模型、覆盖层优先级、发布与部署。',\n      content: `# Studio 概览\n\nStudio 是搭建者应用——塑造平台*元数据*的工作台:对象、字段、视图、流程、智能体等。\n它的大多数界面一目了然;本页讲的是那条界面上看不见、却支配你在这里一切操作的规则。\n完整参考见 <https://docs.objectstack.ai>。\n\n## 元数据优先\n\n在 Studio 里你编辑的不是运行中的数据库,而是*定义*。每个对象、字段、视图都是一条\n元数据记录,运行的应用由这些元数据生成。这就是为什么 Studio 里的一处改动能同时重塑\nUI 和 API:你改的是模型,而不是修补某个界面。\n\n## 编辑即覆盖层(看不见的规则)\n\n你的改动不会原地修改某个包发布的元数据。Studio 在基础定义之上写一层**覆盖层**,\n运行时按优先级解析两者:未发布的**草稿**在你编辑时对你生效,已发布的**租户覆盖层**\n优先于包的基线,包基线则是兜底(ADR-0005、ADR-0033)。实际后果:基础定义永不被\n销毁,所以覆盖层总能回退以恢复原样——而一个\"改不动\"的字段,通常是被更高优先级的\n层遮住了。\n\n## 发布与部署\n\n草稿只对你自己可见,直到你**发布**它,把覆盖层提升给整个租户看到。在环境之间搬运\n改动(例如开发 → 生产)是单独的**部署**步骤,不是发布的自动副作用——把两者分开,\n才能让你在一个环境里安全搭建、再上线。\n\n草稿、覆盖层与部署的细节见 <https://docs.objectstack.ai>。\n`,\n    },\n  },\n};\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\n/**\n * `@objectstack/studio` — the Studio metadata-builder app as its own ObjectStack\n * package (ADR-0048: one app per package).\n *\n * Studio is a console navigation-shell app (an `AppSchema`), not a kernel\n * extension — but it still needs a thin registration entry to publish its\n * manifest into the running kernel, mirroring how `@objectstack/plugin-auth`\n * registers its own manifest. Giving it a distinct package id\n * (`com.objectstack.studio`) is what lets `/apps/<packageId>` resolve to exactly\n * this app instead of being ambiguous inside a multi-app package.\n *\n * NOTE (transitional): the `STUDIO_APP` schema is still imported from\n * `@objectstack/platform-objects/apps`; a follow-up moves the definition into\n * this package and drops the dependency. This package is intentionally NOT yet\n * wired into the dev/serve plugin set — that boot-path switch (and removing the\n * app from plugin-auth's manifest) lands separately so it can be verified\n * against a live `os dev` boot.\n */\n\nimport { STUDIO_APP } from '@objectstack/platform-objects/apps';\n\nimport { STUDIO_OVERVIEW_DOC } from './studio-overview.doc.js';\n\nexport const STUDIO_APP_PACKAGE_ID = 'com.objectstack.studio';\nexport const STUDIO_APP_NAMESPACE = 'studio';\nexport const STUDIO_APP_VERSION = '9.3.0';\n\n/** Manifest header for the Studio app package. */\nexport const studioAppManifestHeader = {\n  id: STUDIO_APP_PACKAGE_ID,\n  namespace: STUDIO_APP_NAMESPACE,\n  version: STUDIO_APP_VERSION,\n  type: 'plugin' as const,\n  scope: 'system' as const,\n  name: 'Studio',\n  description: 'ObjectStack Studio — metadata builder app.',\n  // Studio navigates platform metadata owned by plugin-auth; declare the\n  // dependency so it loads after the auth objects are registered.\n  dependencies: ['com.objectstack.plugin-auth'],\n};\n\n/**\n * Thin plugin that registers the Studio app manifest. Structurally typed\n * against the kernel `Plugin` contract (no compile-time kernel dependency),\n * exactly like `AuthPlugin`.\n */\nexport class StudioAppPlugin {\n  readonly name = STUDIO_APP_PACKAGE_ID;\n  readonly type = 'standard';\n  readonly version = STUDIO_APP_VERSION;\n  // Kernel plugin dependency is matched by plugin NAME (AuthPlugin.name =\n  // 'com.objectstack.auth'), not by package id.\n  readonly dependencies: string[] = ['com.objectstack.auth'];\n\n  async init(_ctx: any): Promise<void> {\n    // No-op: registration happens in start() once the manifest service exists.\n  }\n\n  async start(ctx: any): Promise<void> {\n    const manifest = ctx?.getService?.('manifest');\n    if (!manifest || typeof manifest.register !== 'function') return;\n    manifest.register({\n      ...studioAppManifestHeader,\n      apps: [STUDIO_APP],\n      // ADR-0046 package docs — grouped under \"Studio\" at /_console/docs.\n      docs: [STUDIO_OVERVIEW_DOC],\n    });\n  }\n}\n\n/** Convenience factory mirroring the rest of the plugin ecosystem. */\nexport function createStudioAppPlugin(): StudioAppPlugin {\n  return new StudioAppPlugin();\n}\n\nexport { STUDIO_APP };\nexport { STUDIO_OVERVIEW_DOC };\n"]}

package/dist/index.mjs

@@ -0,0 +1,127 @@
+import { STUDIO_APP } from '@objectstack/platform-objects/apps';
+export { STUDIO_APP } from '@objectstack/platform-objects/apps';
+
+// src/index.ts
+
+// src/studio-overview.doc.ts
+var STUDIO_OVERVIEW_DOC = {
+  name: "studio_overview",
+  label: "Studio overview",
+  description: "Orientation for builders: the metadata-first model, overlay precedence, and publishing.",
+  content: `# Studio overview
+
+Studio is the builder app \u2014 the workbench for shaping the platform's
+*metadata*: objects, fields, views, flows, agents, and the rest. Most of its
+screens are self-explanatory; this page covers the one rule that is not visible
+on screen but governs everything you do here. For the full reference, see
+<https://docs.objectstack.ai>.
+
+## Metadata-first
+
+In Studio you do not edit a running database \u2014 you edit *definitions*. Every
+object, field, and view is a metadata record, and the live application is
+generated from that metadata. This is why a change in Studio can reshape the UI
+and the API at once: you are changing the model, not patching a screen.
+
+## Edits are overlays (the invisible rule)
+
+Your changes do not mutate the metadata shipped by a package in place. Studio
+writes an **overlay** on top of the base definition, and the runtime resolves
+the two by precedence: an unpublished **draft** wins for you while you work, a
+published **tenant overlay** wins over the package's baseline, and the package
+baseline is the fallback (ADR-0005, ADR-0033). The practical consequence: the
+base definition is never destroyed, so an overlay can always be reverted to
+recover the original \u2014 and a field that "won't change" is usually being shadowed
+by a higher-precedence layer.
+
+## Publishing & deploying
+
+A draft is visible only to you until you **publish** it, which promotes the
+overlay so the rest of the tenant sees it. Moving changes between environments
+(for example dev \u2192 production) is a separate **deploy** step, not an automatic
+side effect of publishing \u2014 keeping the two distinct is what lets you build
+safely in one environment before shipping.
+
+See <https://docs.objectstack.ai> for drafts, overlays, and deployment in depth.
+`,
+  translations: {
+    zh: {
+      label: "Studio \u6982\u89C8",
+      description: "\u642D\u5EFA\u8005\u5165\u95E8:\u5143\u6570\u636E\u4F18\u5148\u6A21\u578B\u3001\u8986\u76D6\u5C42\u4F18\u5148\u7EA7\u3001\u53D1\u5E03\u4E0E\u90E8\u7F72\u3002",
+      content: `# Studio \u6982\u89C8
+
+Studio \u662F\u642D\u5EFA\u8005\u5E94\u7528\u2014\u2014\u5851\u9020\u5E73\u53F0*\u5143\u6570\u636E*\u7684\u5DE5\u4F5C\u53F0:\u5BF9\u8C61\u3001\u5B57\u6BB5\u3001\u89C6\u56FE\u3001\u6D41\u7A0B\u3001\u667A\u80FD\u4F53\u7B49\u3002
+\u5B83\u7684\u5927\u591A\u6570\u754C\u9762\u4E00\u76EE\u4E86\u7136;\u672C\u9875\u8BB2\u7684\u662F\u90A3\u6761\u754C\u9762\u4E0A\u770B\u4E0D\u89C1\u3001\u5374\u652F\u914D\u4F60\u5728\u8FD9\u91CC\u4E00\u5207\u64CD\u4F5C\u7684\u89C4\u5219\u3002
+\u5B8C\u6574\u53C2\u8003\u89C1 <https://docs.objectstack.ai>\u3002
+
+## \u5143\u6570\u636E\u4F18\u5148
+
+\u5728 Studio \u91CC\u4F60\u7F16\u8F91\u7684\u4E0D\u662F\u8FD0\u884C\u4E2D\u7684\u6570\u636E\u5E93,\u800C\u662F*\u5B9A\u4E49*\u3002\u6BCF\u4E2A\u5BF9\u8C61\u3001\u5B57\u6BB5\u3001\u89C6\u56FE\u90FD\u662F\u4E00\u6761
+\u5143\u6570\u636E\u8BB0\u5F55,\u8FD0\u884C\u7684\u5E94\u7528\u7531\u8FD9\u4E9B\u5143\u6570\u636E\u751F\u6210\u3002\u8FD9\u5C31\u662F\u4E3A\u4EC0\u4E48 Studio \u91CC\u7684\u4E00\u5904\u6539\u52A8\u80FD\u540C\u65F6\u91CD\u5851
+UI \u548C API:\u4F60\u6539\u7684\u662F\u6A21\u578B,\u800C\u4E0D\u662F\u4FEE\u8865\u67D0\u4E2A\u754C\u9762\u3002
+
+## \u7F16\u8F91\u5373\u8986\u76D6\u5C42(\u770B\u4E0D\u89C1\u7684\u89C4\u5219)
+
+\u4F60\u7684\u6539\u52A8\u4E0D\u4F1A\u539F\u5730\u4FEE\u6539\u67D0\u4E2A\u5305\u53D1\u5E03\u7684\u5143\u6570\u636E\u3002Studio \u5728\u57FA\u7840\u5B9A\u4E49\u4E4B\u4E0A\u5199\u4E00\u5C42**\u8986\u76D6\u5C42**,
+\u8FD0\u884C\u65F6\u6309\u4F18\u5148\u7EA7\u89E3\u6790\u4E24\u8005:\u672A\u53D1\u5E03\u7684**\u8349\u7A3F**\u5728\u4F60\u7F16\u8F91\u65F6\u5BF9\u4F60\u751F\u6548,\u5DF2\u53D1\u5E03\u7684**\u79DF\u6237\u8986\u76D6\u5C42**
+\u4F18\u5148\u4E8E\u5305\u7684\u57FA\u7EBF,\u5305\u57FA\u7EBF\u5219\u662F\u515C\u5E95(ADR-0005\u3001ADR-0033)\u3002\u5B9E\u9645\u540E\u679C:\u57FA\u7840\u5B9A\u4E49\u6C38\u4E0D\u88AB
+\u9500\u6BC1,\u6240\u4EE5\u8986\u76D6\u5C42\u603B\u80FD\u56DE\u9000\u4EE5\u6062\u590D\u539F\u6837\u2014\u2014\u800C\u4E00\u4E2A"\u6539\u4E0D\u52A8"\u7684\u5B57\u6BB5,\u901A\u5E38\u662F\u88AB\u66F4\u9AD8\u4F18\u5148\u7EA7\u7684
+\u5C42\u906E\u4F4F\u4E86\u3002
+
+## \u53D1\u5E03\u4E0E\u90E8\u7F72
+
+\u8349\u7A3F\u53EA\u5BF9\u4F60\u81EA\u5DF1\u53EF\u89C1,\u76F4\u5230\u4F60**\u53D1\u5E03**\u5B83,\u628A\u8986\u76D6\u5C42\u63D0\u5347\u7ED9\u6574\u4E2A\u79DF\u6237\u770B\u5230\u3002\u5728\u73AF\u5883\u4E4B\u95F4\u642C\u8FD0
+\u6539\u52A8(\u4F8B\u5982\u5F00\u53D1 \u2192 \u751F\u4EA7)\u662F\u5355\u72EC\u7684**\u90E8\u7F72**\u6B65\u9AA4,\u4E0D\u662F\u53D1\u5E03\u7684\u81EA\u52A8\u526F\u4F5C\u7528\u2014\u2014\u628A\u4E24\u8005\u5206\u5F00,
+\u624D\u80FD\u8BA9\u4F60\u5728\u4E00\u4E2A\u73AF\u5883\u91CC\u5B89\u5168\u642D\u5EFA\u3001\u518D\u4E0A\u7EBF\u3002
+
+\u8349\u7A3F\u3001\u8986\u76D6\u5C42\u4E0E\u90E8\u7F72\u7684\u7EC6\u8282\u89C1 <https://docs.objectstack.ai>\u3002
+`
+    }
+  }
+};
+
+// src/index.ts
+var STUDIO_APP_PACKAGE_ID = "com.objectstack.studio";
+var STUDIO_APP_NAMESPACE = "studio";
+var STUDIO_APP_VERSION = "9.3.0";
+var studioAppManifestHeader = {
+  id: STUDIO_APP_PACKAGE_ID,
+  namespace: STUDIO_APP_NAMESPACE,
+  version: STUDIO_APP_VERSION,
+  type: "plugin",
+  scope: "system",
+  name: "Studio",
+  description: "ObjectStack Studio \u2014 metadata builder app.",
+  // Studio navigates platform metadata owned by plugin-auth; declare the
+  // dependency so it loads after the auth objects are registered.
+  dependencies: ["com.objectstack.plugin-auth"]
+};
+var StudioAppPlugin = class {
+  constructor() {
+    this.name = STUDIO_APP_PACKAGE_ID;
+    this.type = "standard";
+    this.version = STUDIO_APP_VERSION;
+    // Kernel plugin dependency is matched by plugin NAME (AuthPlugin.name =
+    // 'com.objectstack.auth'), not by package id.
+    this.dependencies = ["com.objectstack.auth"];
+  }
+  async init(_ctx) {
+  }
+  async start(ctx) {
+    const manifest = ctx?.getService?.("manifest");
+    if (!manifest || typeof manifest.register !== "function") return;
+    manifest.register({
+      ...studioAppManifestHeader,
+      apps: [STUDIO_APP],
+      // ADR-0046 package docs — grouped under "Studio" at /_console/docs.
+      docs: [STUDIO_OVERVIEW_DOC]
+    });
+  }
+};
+function createStudioAppPlugin() {
+  return new StudioAppPlugin();
+}
+
+export { STUDIO_APP_NAMESPACE, STUDIO_APP_PACKAGE_ID, STUDIO_APP_VERSION, STUDIO_OVERVIEW_DOC, StudioAppPlugin, createStudioAppPlugin, studioAppManifestHeader };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/studio-overview.doc.ts","../src/index.ts"],"names":[],"mappings":";;;;;;AAoBO,IAAM,mBAAA,GAA2B;AAAA,EACtC,IAAA,EAAM,iBAAA;AAAA,EACN,KAAA,EAAO,iBAAA;AAAA,EACP,WAAA,EAAa,yFAAA;AAAA,EACb,OAAA,EAAS,CAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;;AAAA;AAAA;AAAA;AAAA;;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA,CAAA;AAAA,EAoCT,YAAA,EAAc;AAAA,IACZ,EAAA,EAAI;AAAA,MACF,KAAA,EAAO,qBAAA;AAAA,MACP,WAAA,EAAa,+JAAA;AAAA,MACb,OAAA,EAAS,CAAA;;AAAA;AAAA;AAAA;;AAAA;;AAAA;AAAA;AAAA;;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;AA4BX;AAEJ;;;ACrEO,IAAM,qBAAA,GAAwB;AAC9B,IAAM,oBAAA,GAAuB;AAC7B,IAAM,kBAAA,GAAqB;AAG3B,IAAM,uBAAA,GAA0B;AAAA,EACrC,EAAA,EAAI,qBAAA;AAAA,EACJ,SAAA,EAAW,oBAAA;AAAA,EACX,OAAA,EAAS,kBAAA;AAAA,EACT,IAAA,EAAM,QAAA;AAAA,EACN,KAAA,EAAO,QAAA;AAAA,EACP,IAAA,EAAM,QAAA;AAAA,EACN,WAAA,EAAa,iDAAA;AAAA;AAAA;AAAA,EAGb,YAAA,EAAc,CAAC,6BAA6B;AAC9C;AAOO,IAAM,kBAAN,MAAsB;AAAA,EAAtB,WAAA,GAAA;AACL,IAAA,IAAA,CAAS,IAAA,GAAO,qBAAA;AAChB,IAAA,IAAA,CAAS,IAAA,GAAO,UAAA;AAChB,IAAA,IAAA,CAAS,OAAA,GAAU,kBAAA;AAGnB;AAAA;AAAA,IAAA,IAAA,CAAS,YAAA,GAAyB,CAAC,sBAAsB,CAAA;AAAA,EAAA;AAAA,EAEzD,MAAM,KAAK,IAAA,EAA0B;AAAA,EAErC;AAAA,EAEA,MAAM,MAAM,GAAA,EAAyB;AACnC,IAAA,MAAM,QAAA,GAAW,GAAA,EAAK,UAAA,GAAa,UAAU,CAAA;AAC7C,IAAA,IAAI,CAAC,QAAA,IAAY,OAAO,QAAA,CAAS,aAAa,UAAA,EAAY;AAC1D,IAAA,QAAA,CAAS,QAAA,CAAS;AAAA,MAChB,GAAG,uBAAA;AAAA,MACH,IAAA,EAAM,CAAC,UAAU,CAAA;AAAA;AAAA,MAEjB,IAAA,EAAM,CAAC,mBAAmB;AAAA,KAC3B,CAAA;AAAA,EACH;AACF;AAGO,SAAS,qBAAA,GAAyC;AACvD,EAAA,OAAO,IAAI,eAAA,EAAgB;AAC7B","file":"index.mjs","sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Doc } from '@objectstack/spec/system';\n\n/**\n * Studio app overview doc (ADR-0046), registered in this package's manifest so\n * it groups under \"Studio\" in the `/_console/docs` index.\n *\n * Authored inline rather than as a flat `src/docs/*.md` file because this is a\n * TS-first code package built by tsup, not a user app built by `os build` —\n * `defineStack({ docs })` / manifest `docs[]` is the supported path for those\n * (see `DocSchema` in `@objectstack/spec/system`). The `content` below is plain\n * CommonMark + GFM with no images/MDX, per ADR-0046 §3.4.\n *\n * Principle (from the HotCRM reference docs): document the *invisible*\n * business logic, not what the Studio UI already shows on screen.\n *\n * `translations` carries per-locale variants (ADR-0046 i18n); the REST layer\n * collapses the doc to the request's `Accept-Language` and serves one body.\n */\nexport const STUDIO_OVERVIEW_DOC: Doc = {\n  name: 'studio_overview',\n  label: 'Studio overview',\n  description: 'Orientation for builders: the metadata-first model, overlay precedence, and publishing.',\n  content: `# Studio overview\n\nStudio is the builder app — the workbench for shaping the platform's\n*metadata*: objects, fields, views, flows, agents, and the rest. Most of its\nscreens are self-explanatory; this page covers the one rule that is not visible\non screen but governs everything you do here. For the full reference, see\n<https://docs.objectstack.ai>.\n\n## Metadata-first\n\nIn Studio you do not edit a running database — you edit *definitions*. Every\nobject, field, and view is a metadata record, and the live application is\ngenerated from that metadata. This is why a change in Studio can reshape the UI\nand the API at once: you are changing the model, not patching a screen.\n\n## Edits are overlays (the invisible rule)\n\nYour changes do not mutate the metadata shipped by a package in place. Studio\nwrites an **overlay** on top of the base definition, and the runtime resolves\nthe two by precedence: an unpublished **draft** wins for you while you work, a\npublished **tenant overlay** wins over the package's baseline, and the package\nbaseline is the fallback (ADR-0005, ADR-0033). The practical consequence: the\nbase definition is never destroyed, so an overlay can always be reverted to\nrecover the original — and a field that \"won't change\" is usually being shadowed\nby a higher-precedence layer.\n\n## Publishing & deploying\n\nA draft is visible only to you until you **publish** it, which promotes the\noverlay so the rest of the tenant sees it. Moving changes between environments\n(for example dev → production) is a separate **deploy** step, not an automatic\nside effect of publishing — keeping the two distinct is what lets you build\nsafely in one environment before shipping.\n\nSee <https://docs.objectstack.ai> for drafts, overlays, and deployment in depth.\n`,\n  translations: {\n    zh: {\n      label: 'Studio 概览',\n      description: '搭建者入门:元数据优先模型、覆盖层优先级、发布与部署。',\n      content: `# Studio 概览\n\nStudio 是搭建者应用——塑造平台*元数据*的工作台:对象、字段、视图、流程、智能体等。\n它的大多数界面一目了然;本页讲的是那条界面上看不见、却支配你在这里一切操作的规则。\n完整参考见 <https://docs.objectstack.ai>。\n\n## 元数据优先\n\n在 Studio 里你编辑的不是运行中的数据库,而是*定义*。每个对象、字段、视图都是一条\n元数据记录,运行的应用由这些元数据生成。这就是为什么 Studio 里的一处改动能同时重塑\nUI 和 API:你改的是模型,而不是修补某个界面。\n\n## 编辑即覆盖层(看不见的规则)\n\n你的改动不会原地修改某个包发布的元数据。Studio 在基础定义之上写一层**覆盖层**,\n运行时按优先级解析两者:未发布的**草稿**在你编辑时对你生效,已发布的**租户覆盖层**\n优先于包的基线,包基线则是兜底(ADR-0005、ADR-0033)。实际后果:基础定义永不被\n销毁,所以覆盖层总能回退以恢复原样——而一个\"改不动\"的字段,通常是被更高优先级的\n层遮住了。\n\n## 发布与部署\n\n草稿只对你自己可见,直到你**发布**它,把覆盖层提升给整个租户看到。在环境之间搬运\n改动(例如开发 → 生产)是单独的**部署**步骤,不是发布的自动副作用——把两者分开,\n才能让你在一个环境里安全搭建、再上线。\n\n草稿、覆盖层与部署的细节见 <https://docs.objectstack.ai>。\n`,\n    },\n  },\n};\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\n/**\n * `@objectstack/studio` — the Studio metadata-builder app as its own ObjectStack\n * package (ADR-0048: one app per package).\n *\n * Studio is a console navigation-shell app (an `AppSchema`), not a kernel\n * extension — but it still needs a thin registration entry to publish its\n * manifest into the running kernel, mirroring how `@objectstack/plugin-auth`\n * registers its own manifest. Giving it a distinct package id\n * (`com.objectstack.studio`) is what lets `/apps/<packageId>` resolve to exactly\n * this app instead of being ambiguous inside a multi-app package.\n *\n * NOTE (transitional): the `STUDIO_APP` schema is still imported from\n * `@objectstack/platform-objects/apps`; a follow-up moves the definition into\n * this package and drops the dependency. This package is intentionally NOT yet\n * wired into the dev/serve plugin set — that boot-path switch (and removing the\n * app from plugin-auth's manifest) lands separately so it can be verified\n * against a live `os dev` boot.\n */\n\nimport { STUDIO_APP } from '@objectstack/platform-objects/apps';\n\nimport { STUDIO_OVERVIEW_DOC } from './studio-overview.doc.js';\n\nexport const STUDIO_APP_PACKAGE_ID = 'com.objectstack.studio';\nexport const STUDIO_APP_NAMESPACE = 'studio';\nexport const STUDIO_APP_VERSION = '9.3.0';\n\n/** Manifest header for the Studio app package. */\nexport const studioAppManifestHeader = {\n  id: STUDIO_APP_PACKAGE_ID,\n  namespace: STUDIO_APP_NAMESPACE,\n  version: STUDIO_APP_VERSION,\n  type: 'plugin' as const,\n  scope: 'system' as const,\n  name: 'Studio',\n  description: 'ObjectStack Studio — metadata builder app.',\n  // Studio navigates platform metadata owned by plugin-auth; declare the\n  // dependency so it loads after the auth objects are registered.\n  dependencies: ['com.objectstack.plugin-auth'],\n};\n\n/**\n * Thin plugin that registers the Studio app manifest. Structurally typed\n * against the kernel `Plugin` contract (no compile-time kernel dependency),\n * exactly like `AuthPlugin`.\n */\nexport class StudioAppPlugin {\n  readonly name = STUDIO_APP_PACKAGE_ID;\n  readonly type = 'standard';\n  readonly version = STUDIO_APP_VERSION;\n  // Kernel plugin dependency is matched by plugin NAME (AuthPlugin.name =\n  // 'com.objectstack.auth'), not by package id.\n  readonly dependencies: string[] = ['com.objectstack.auth'];\n\n  async init(_ctx: any): Promise<void> {\n    // No-op: registration happens in start() once the manifest service exists.\n  }\n\n  async start(ctx: any): Promise<void> {\n    const manifest = ctx?.getService?.('manifest');\n    if (!manifest || typeof manifest.register !== 'function') return;\n    manifest.register({\n      ...studioAppManifestHeader,\n      apps: [STUDIO_APP],\n      // ADR-0046 package docs — grouped under \"Studio\" at /_console/docs.\n      docs: [STUDIO_OVERVIEW_DOC],\n    });\n  }\n}\n\n/** Convenience factory mirroring the rest of the plugin ecosystem. */\nexport function createStudioAppPlugin(): StudioAppPlugin {\n  return new StudioAppPlugin();\n}\n\nexport { STUDIO_APP };\nexport { STUDIO_OVERVIEW_DOC };\n"]}