create-three-blocks-starter 0.0.14 → 0.3.0-alpha.176.g8ff8a72e6369

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# create-three-blocks-starter
+
+## 0.3.0-alpha.176.g8ff8a72e6369
+
+- ci: keep alpha readiness release-scoped (`8ff8a72e6369`).
+
+This changelog is generated from Changesets.
+
+## 0.2.0
+
+- Typed worker-first starter templates and project generator.

package/LICENSE

@@ -1,307 +1,76 @@
-Three.js Blocks Software License Agreement
-Version 2.0 — Effective January 2026
-
-Proprietary Software — All Rights Reserved
-Copyright (c) 2026 three-blocks
-
-Full License Terms: https://threejs-blocks.com/license
-
-================================================================================
-
-LICENSE NOTICE
-
-This software and all associated packages, including but not limited to:
-  - @three-blocks/core
-  - @three-blocks/pro
-  - @three-blocks/starter
-  - create-three-blocks-starter
-  - All related tools, examples, and documentation code
-
-are licensed exclusively to active, paid subscribers of the Three.js Blocks
-project. Without a valid and current subscription, you are NOT permitted to
-use this software.
-
-================================================================================
-
-PERMITTED USAGE (Active Subscribers Only)
-
-Subject to maintaining an active, paid subscription, you are granted a
-non-exclusive, non-transferable, non-sublicensable license to:
-
-  + Use the software in personal and commercial projects via the public API
-  + Deploy applications incorporating the software to production environments
-  + Integrate the software into your applications as a functional component
-  + Access updates, bug fixes, and new features during active subscription
-
-================================================================================
-
-RESTRICTIONS
-
-You may NOT:
-
-  - Reverse engineer, decompile, disassemble, or attempt to derive the source
-    code, underlying algorithms, or techniques employed in this software
-  - Study, analyze, inspect, or learn from the implementation details, code
-    structure, or internal workings of this software
-  - Modify, adapt, translate, or create derivative works
-  - Copy, share, distribute, publish, or resell any part of the software
-  - Sublicense or transfer rights to any third party
-  - Remove, alter, or obscure this license header or any copyright notices
-  - Use this software after your subscription has expired or been terminated
-
-================================================================================
-
-SUBLICENSING AND REDISTRIBUTION PROHIBITION
-
-This license is strictly non-transferable and non-sublicensable. You may NOT:
-
-  - Sublicense, relicense, or transfer any rights granted herein to any third
-    party under any circumstances
-  - Create any SDK, library, framework, plugin, extension, or middleware that
-    redistributes, bundles, or incorporates this software for use by third
-    parties
-  - Bundle this software into products, applications, or services where
-    end-users do not hold their own valid subscription to Three.js Blocks
-  - Offer this software as part of any hosted service, software-as-a-service
-    (SaaS), platform-as-a-service (PaaS), or similar cloud-based offering
-    where third parties access the software's functionality
-  - Create wrapper libraries, abstraction layers, or integration packages that
-    obscure, circumvent, or eliminate the subscription requirement from
-    downstream users
-  - Include this software in any product, template, boilerplate, starter kit,
-    code generator, or scaffolding tool intended for distribution to third
-    parties
-  - Provide access to this software through any API, service endpoint, or
-    programmatic interface that enables third-party usage
-  - License, sell, rent, lease, or otherwise commercially exploit access to
-    this software to any third party
-
-THIRD-PARTY INTEGRATION REQUIREMENT:
-If you develop any software, SDK, library, framework, application, or service
-that incorporates, depends upon, or integrates with this software, each
-end-user of your software must independently hold their own valid, active
-subscription to Three.js Blocks. You may not use your subscription to provide,
-enable, or facilitate access to this software to any third party. Any attempt
-to circumvent this requirement through technical or contractual means is
-expressly prohibited and constitutes a material breach of this license.
-
-================================================================================
-
-AI, MACHINE LEARNING, AND AUTOMATED ANALYSIS PROHIBITION
-
-The use of this software, source code, compiled code, documentation, outputs,
-or any data generated by this software for artificial intelligence, machine
-learning, or automated analysis purposes is strictly prohibited. You may NOT:
-
-  - Use this code, in whole or in part, to train, fine-tune, pre-train, or
-    develop any artificial intelligence models, machine learning systems,
-    neural networks, or large language models (LLMs)
-  - Use this code for reinforcement learning from human feedback (RLHF),
-    constitutional AI training, or any similar AI alignment or training
-    methodology
-  - Create embeddings, vector representations, semantic indices, or any other
-    mathematical or computational representations of this code
-  - Store this code in vector databases, retrieval systems, knowledge bases,
-    or any storage mechanism intended for AI/ML retrieval-augmented generation
-    (RAG) or similar AI-assisted retrieval
-  - Generate synthetic data, pseudocode, paraphrased code, or derivative
-    representations from this codebase for any purpose
-  - Use automated tools, scripts, or AI systems to extract patterns,
-    algorithms, architectural knowledge, or implementation techniques from
-    this software
-  - Input this code into AI coding assistants, code completion tools, or
-    any AI-powered development environment for the purpose of analysis,
-    learning, pattern extraction, or code generation
-  - Use this code as context, examples, few-shot prompts, or reference
-    material for AI code generation, code completion, or code suggestion
-  - Feed this code into any automated transformation tool, transpiler, or
-    code converter that uses AI/ML techniques
-  - Use any output, behavior, or data generated by this software to train
-    or improve any AI/ML system
-
-This prohibition applies to all AI/ML systems including but not limited to:
-large language models (LLMs), code completion tools (e.g., GitHub Copilot,
-Amazon CodeWhisperer, and similar tools), code generation systems, neural
-networks, transformer models, diffusion models, and any future AI technologies
-regardless of their architecture or methodology.
-
-This prohibition is perpetual and survives any termination or expiration of
-this license agreement.
-
-================================================================================
-
-SUBSCRIPTION REQUIREMENT
-
-This license is valid only while you maintain an active, paid subscription to
-the Three.js Blocks service. Upon expiration or termination of your
-subscription:
-
-  1. Your license to use this software immediately and automatically terminates
-  2. You must immediately cease all use of the software
-  3. You must remove the software from all projects, systems, and deployments
-  4. You must not deploy, distribute, or make available any applications
-     containing this software
-  5. You must delete all copies of this software in your possession or control
-
-Failure to comply with these requirements constitutes copyright infringement
-and breach of contract, and may result in legal action.
-
-================================================================================
-
-PACKAGE-SPECIFIC NOTES
-
-@three-blocks/core:
-  - Core library with proprietary algorithms and implementations
-  - Protected by code obfuscation and this license
-  - Subscription required
-
-@three-blocks/pro:
-  - Advanced physics engine with proprietary implementations
-  - Worker-based architecture with SharedArrayBuffer
-  - Protected by code obfuscation and this license
-  - Subscription required
-
-@three-blocks/starter:
-  - Starter template for building Three.js applications
-  - Includes licensed code and dependencies on @three-blocks/core
-  - Subscription required
-
-create-three-blocks-starter:
-  - Scaffolding tool for creating new projects
-  - Publicly available for convenience but proprietary
-  - Creates projects that require subscription
-
-================================================================================
-
-ENFORCEMENT
-
-Unauthorized use, reproduction, distribution, reverse engineering, sublicensing,
-or violation of the AI/ML prohibition is strictly prohibited and may result in:
-
-  * Immediate termination of your license and subscription without refund
-  * Legal action for copyright infringement
-  * Legal action for breach of contract
-  * Claims for damages, including actual damages, lost profits, and statutory
-    damages where available
-  * Recovery of attorneys' fees and costs of enforcement
-  * Injunctive relief to prevent further unauthorized use
-  * Civil liability under applicable copyright, trade secret, and contract law
-  * Criminal penalties under applicable law, including but not limited to the
-    Computer Fraud and Abuse Act (CFAA) and equivalent international statutes
+Required Notice: Copyright (c) 2025-2026 Three Blocks — https://threejs-blocks.com
+Required Notice: AI/ML training and dataset use are not licensed; text-and-data-mining rights reserved (EU 2019/790 Art. 4(3)). See NOTICE.
 
-We employ various technical and legal measures to detect unauthorized use,
-including but not limited to code fingerprinting, license validation, usage
-analytics, and regular compliance audits. We reserve the right to pursue all
-available legal remedies against violators.
+# PolyForm Noncommercial License 1.0.0
 
-================================================================================
+<https://polyformproject.org/licenses/noncommercial/1.0.0>
 
-INDEMNIFICATION
+## Acceptance
 
-You agree to indemnify, defend, and hold harmless three-blocks, its affiliates,
-officers, directors, employees, and agents from and against any and all claims,
-damages, obligations, losses, liabilities, costs, and expenses (including
-reasonable attorneys' fees) arising from: (a) your use of the software;
-(b) your violation of any term of this license; (c) your violation of any
-third-party right, including any intellectual property or privacy right; or
-(d) any claim that your use of the software caused damage to a third party.
+In order to get any license under these terms, you must agree to them as both strict obligations and conditions to all your licenses.
 
-================================================================================
+## Copyright License
 
-ACCEPTANCE OF TERMS
+The licensor grants you a copyright license for the software to do everything you might do with the software that would otherwise infringe the licensor's copyright in it for any permitted purpose.  However, you may only distribute the software according to [Distribution License](#distribution-license) and make changes or new works based on the software according to [Changes and New Works License](#changes-and-new-works-license).
 
-By downloading, installing, copying, accessing, or otherwise using this
-software, you acknowledge that you have read, understood, and agree to be
-bound by the complete terms of this license agreement.
+## Distribution License
 
-If you do not agree to these terms, you are not authorized to use, access,
-download, install, or copy this software.
+The licensor grants you an additional copyright license to distribute copies of the software.  Your license to distribute covers distributing the software with changes and new works permitted by [Changes and New Works License](#changes-and-new-works-license).
 
-If you are accepting these terms on behalf of an organization, you represent
-and warrant that you have the authority to bind that organization to these
-terms.
+## Notices
 
-================================================================================
+You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these terms or the URL for them above, as well as copies of any plain-text lines beginning with `Required Notice:` that the licensor provided with the software.  For example:
 
-DISCLAIMER OF WARRANTY
+> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
 
-THIS SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE, TITLE, AND NONINFRINGEMENT.
+## Changes and New Works License
 
-THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE IS WITH YOU.
-SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
-SERVICING, REPAIR, OR CORRECTION.
+The licensor grants you an additional copyright license to make changes and new works based on the software for any permitted purpose.
 
-================================================================================
+## Patent License
 
-LIMITATION OF LIABILITY
+The licensor grants you a patent license for the software that covers patent claims the licensor can license, or becomes able to license, that you would infringe by using the software.
 
-IN NO EVENT SHALL THREE-BLOCKS, ITS AFFILIATES, LICENSORS, OR SUPPLIERS BE
-LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL, PUNITIVE, OR
-EXEMPLARY DAMAGES, INCLUDING BUT NOT LIMITED TO DAMAGES FOR LOSS OF PROFITS,
-GOODWILL, USE, DATA, OR OTHER INTANGIBLE LOSSES, ARISING OUT OF OR IN
-CONNECTION WITH THIS LICENSE OR THE USE OR INABILITY TO USE THE SOFTWARE,
-EVEN IF THREE-BLOCKS HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+## Noncommercial Purposes
 
-IN NO EVENT SHALL THREE-BLOCKS'S TOTAL CUMULATIVE LIABILITY TO YOU FOR ALL
-CLAIMS ARISING OUT OF OR RELATED TO THIS LICENSE OR THE SOFTWARE EXCEED THE
-AMOUNTS PAID BY YOU TO THREE-BLOCKS FOR THE SOFTWARE DURING THE TWELVE (12)
-MONTHS IMMEDIATELY PRECEDING THE EVENT GIVING RISE TO LIABILITY.
+Any noncommercial purpose is a permitted purpose.
 
-SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OR LIMITATION OF INCIDENTAL OR
-CONSEQUENTIAL DAMAGES, SO THE ABOVE LIMITATIONS MAY NOT APPLY TO YOU.
+## Personal Uses
 
-================================================================================
+Personal use for research, experiment, and testing for the benefit of public knowledge, personal study, private entertainment, hobby projects, amateur pursuits, or religious observance, without any anticipated commercial application, is use for a permitted purpose.
 
-SEVERABILITY
+## Noncommercial Organizations
 
-If any provision of this license is held to be unenforceable or invalid, that
-provision shall be enforced to the maximum extent possible, and the other
-provisions shall remain in full force and effect.
+Use by any charitable organization, educational institution, public research organization, public safety or health organization, environmental protection organization, or government institution is use for a permitted purpose regardless of the source of funding or obligations resulting from the funding.
 
-================================================================================
+## Fair Use
 
-WAIVER
+You may have "fair use" rights for the software under the law. These terms do not limit them.
 
-The failure of three-blocks to enforce any right or provision of this license
-shall not constitute a waiver of such right or provision. No waiver of any
-term of this license shall be deemed a further or continuing waiver of such
-term or any other term.
+## No Other Rights
 
-================================================================================
+These terms do not allow you to sublicense or transfer any of your licenses to anyone else, or prevent the licensor from granting licenses to anyone else.  These terms do not imply any other licenses.
 
-ENTIRE AGREEMENT
+## Patent Defense
 
-This license constitutes the entire agreement between you and three-blocks
-regarding the software and supersedes all prior agreements, understandings,
-and communications, whether written or oral, regarding the subject matter
-hereof.
+If you make any written claim that the software infringes or contributes to infringement of any patent, your patent license for the software granted under these terms ends immediately. If your company makes such a claim, your patent license ends immediately for work on behalf of your company.
 
-================================================================================
+## Violations
 
-CONTACT AND COMPLIANCE
+The first time you are notified in writing that you have violated any of these terms, or done anything with the software not covered by your licenses, your licenses can nonetheless continue if you come into full compliance with these terms, and take practical steps to correct past violations, within 32 days of receiving notice.  Otherwise, all your licenses end immediately.
 
-For licensing inquiries, subscription management, and compliance questions:
+## No Liability
 
-  Web: https://threejs-blocks.com/license
-  Email: support@threejs-blocks.com
+***As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will not be liable to you for any damages arising out of these terms or the use or nature of the software, under any kind of legal claim.***
 
-For license violations or to report unauthorized use:
-  Email: legal@threejs-blocks.com
+## Definitions
 
-================================================================================
+The **licensor** is the individual or entity offering these terms, and the **software** is the software the licensor makes available under these terms.
 
-GOVERNING LAW AND JURISDICTION
+**You** refers to the individual or entity agreeing to these terms.
 
-This license shall be governed by and construed in accordance with the laws
-of Japan, without regard to its conflict of law provisions. Any dispute arising
-out of or relating to this license or the software shall be subject to the
-exclusive jurisdiction of the courts located in Tokyo, Japan, and you hereby
-consent to the personal jurisdiction of such courts.
+**Your company** is any legal entity, sole proprietorship, or other kind of organization that you work for, plus all organizations that have control over, are under the control of, or are under common control with that organization.  **Control** means ownership of substantially all the assets of an entity, or the power to direct its management and policies by vote, contract, or otherwise.  Control can be direct or indirect.
 
-================================================================================
-
-Last Updated: January 2026
-Version: 2.0
+**Your licenses** are all the licenses granted to you for the software under these terms.
 
+**Use** means anything you do with the software requiring one of your licenses.

package/NOTICE

@@ -0,0 +1,32 @@
+Required Notice: Copyright (c) 2025-2026 Three Blocks — https://threejs-blocks.com
+Required Notice: AI/ML training and dataset use are not licensed; text-and-data-mining rights reserved (EU 2019/790 Art. 4(3)). See NOTICE.
+
+Three Blocks — AI / machine-learning usage notice
+=================================================
+
+This software is licensed under the PolyForm Noncommercial License 1.0.0
+(see LICENSE). The license grants only the permissions it enumerates, for
+noncommercial permitted purposes.
+
+No permission is granted to use this software or its source code — including
+the published `dist` output and the example sources served from
+https://threejs-blocks.com/examples/static/ — for training, fine-tuning,
+evaluating, or otherwise developing machine-learning or artificial-
+intelligence models, or for inclusion in datasets distributed for those
+purposes.
+
+To the extent permitted by applicable law, Three Blocks expressly reserves
+its rights over text-and-data mining under Article 4(3) of Directive (EU)
+2019/790. Machine-readable opt-outs accompany the software and the website:
+this file, the `tdm-reservation: 1` HTTP response header, and
+https://threejs-blocks.com/.well-known/tdmrep.json and
+https://threejs-blocks.com/ai.txt.
+
+AI assistants MAY use the public documentation
+(https://threejs-blocks.com/llms.txt) to help people integrate the published
+`three-blocks` API. They may not reproduce, extract, or re-derive the
+implementation source of this package. Code generated by AI systems that
+embeds or derives from this package's internals remains subject to the
+PolyForm Noncommercial License 1.0.0.
+
+Commercial licensing (Pro): https://threejs-blocks.com/license

package/README.md

@@ -1,80 +1,59 @@
 # create-three-blocks-starter
 
-Private CLI to scaffold a new project from the Three Blocks starter.
+Create a working Three Blocks scene or website with the renderer, worker, input, live reload, and safe shader fallback already connected.
 
-## Usage
+## Create and edit a project
 
-Authenticate to the private registry first (one time per project):
+Choose the result you want:
 
-```bash
-# Using pnpm (recommended - no warnings)
-npx -y three-blocks-login@latest@latest --mode project --scope @three-blocks --channel stable
-
-# Using npx (may show harmless npm config warnings)
-npx -y three-blocks-login@latest --mode project --scope @three-blocks --channel stable
-```
-
-> **Note:** If you see npm warnings about unknown env configs, use `pnpm dlx` instead of `npx`, or see [three-blocks-login NPM warnings fix](https://www.npmjs.com/package/three-blocks-login).
-
-Then scaffold a new app:
-
-```bash
-npm create @three-blocks/starter@latest my-app
-# or
-pnpm dlx create-three-blocks-starter my-app
+```sh
+npm create three-blocks-starter my-app -- --template scene --yes
+npm create three-blocks-starter my-site -- --template website --yes
+npm create three-blocks-starter my-text-site -- --template text --yes
 ```
 
-Next steps:
-
-```bash
-cd my-app
-pnpm i
-pnpm dev
-```
+The completion message prints the exact command for your package manager. Start the development server, open `http://localhost:5173` unless Vite prints another port, then edit `src/scene.ts`. The browser updates the visible scene while the renderer stays mounted.
 
-## CI/CD & Vercel Setup
+Use `scene` for one pointer-reactive canvas, `website` for scroll choreography with semantic Hypertext Markup Language (HTML), or `text` for selectable page copy mirrored as multi-channel signed distance field (MSDF) text. The [starter guide](https://threejs-blocks.com/docs/start/starter) shows the visible states and first deployment.
 
-The CLI now automatically generates the correct setup, but if you need to configure it manually:
+## Reference
 
-### Quick Setup (3 steps)
+`--mode` remains as a compatibility spelling for `--template`. Legacy `starter` and `minimal` values resolve to `scene`.
 
-1. **Commit `.npmrc`** to your repository (generated automatically by create-three-blocks-starter):
-   ```
-   @three-blocks:registry=https://three-blocks-196905988268.d.codeartifact.ap-northeast-1.amazonaws.com/npm/core/
-   ```
+Release templates include their shader capture. The generated app uses it only while it matches the scene and installed runtime. A changed or missing capture falls back to normal live shader building, while a strict production build can require a fresh capture.
 
-2. **Preinstall script** (added automatically by create-three-blocks-starter):
-   ```json
-   {
-     "scripts": {
-       "preinstall": "npx -y three-blocks-login@latest"
-     }
-   }
-   ```
+The text template includes Geist and Noto Sans JP browser and MSDF assets. Generated projects also configure Draco, KTX2, and lazy Meshopt support from the compatible installed Three.js package.
 
-3. **Set environment variable** in your CI/CD platform:
-   - **Vercel**: Project Settings → Environment Variables → Add `THREE_BLOCKS_SECRET_KEY`
-   - **GitHub Actions**: Repository Settings → Secrets → Add `THREE_BLOCKS_SECRET_KEY`
-   - **Other CI**: Add `THREE_BLOCKS_SECRET_KEY` secret with your license key
+## Development
 
-### How It Works
+```bash
+bun run typecheck
+bun run test
+bun run build
+```
 
-- Committed `.npmrc` tells pnpm WHERE to find packages (no auth needed yet)
-- Preinstall script fetches a short-lived token and adds it to `.npmrc`
-- This solves pnpm's timing issue (it resolves packages before running preinstall)
+The repository CLI sandbox sets `THREE_BLOCKS_LINK_DEPS` to the monorepo's
+`packages` directory and supplies a freshly packed runtime through
+`THREE_BLOCKS_LOCAL_TARBALL`. In that development-only mode, generated projects
+install the working-tree `three-blocks` archive through an absolute `file:`
+dependency. The archive mirrors a registry install and avoids external symlinks;
+release scaffolds continue to emit the catalog's exact published version.
 
-## Development (monorepo)
+## Generated handoff
 
-- The CLI pulls the template from `packages/three-blocks-starter/` during `prepack`.
-- To sync locally without publishing:
+Every project begins with the same visible proof: rendered in a worker, shaders
+precompiled, and `src/scene.ts` identified as the first edit. Its README lists
+the live-development, capture, strict-build, text, status, and browser-smoke
+commands, and the generated root includes `NOTICE` without inventing a second
+license file.
 
-```bash
-pnpm --filter create-three-blocks-starter run dev:sync
-```
+## License
 
-## Publish
+Free for personal and noncommercial projects. Commercial projects are covered
+by the Pro plan's lifetime license — each project you start while your plan is
+active is licensed forever, for the versions released while it was active. No
+runtime gating.
 
-```bash
-npx -y three-blocks-login@latest --mode project --scope @three-blocks
-pnpm --filter create-three-blocks-starter publish --access restricted
-```
+The scaffolder and template source use the
+[PolyForm Noncommercial 1.0.0 license](./LICENSE). Full commercial terms are at
+[threejs-blocks.com/license](https://threejs-blocks.com/license).

package/dist/artifacts.d.ts

@@ -0,0 +1,54 @@
+import { type ArtifactStatus, type CompatibilityVersions, type GeneratedFile, type TemplateName } from './types.js';
+declare const SHADER_COMPATIBILITY: "three-webgpu-r185-v1";
+declare const SHADER_ADDRESS_VERSION: 2;
+declare const SHADER_RECIPE_VERSION: 1;
+declare const SHADER_HYDRATION_VERSION: 2;
+declare const SHADER_TRANSFORM_VERSION: 3;
+interface ShaderCoverage {
+    readonly render: number;
+    readonly vertex: number;
+    readonly fragment: number;
+    readonly compute: number;
+}
+interface ShaderSceneReceipt {
+    readonly artifact: string;
+    readonly artifactHash: string;
+    readonly bytes: number;
+    readonly inputs: Readonly<Record<string, string>>;
+    readonly coverage: ShaderCoverage;
+    readonly skipped: {
+        readonly render: number;
+        readonly compute: number;
+    };
+}
+interface ShaderReceipt {
+    readonly schemaVersion: 2;
+    readonly runtime: Pick<CompatibilityVersions, 'three' | 'threeBlocks'> & {
+        readonly threeBlocksShaderClosure: string;
+    };
+    readonly tool: {
+        readonly name: '@three-blocks/devtools';
+        readonly version: string;
+        readonly compatibility: typeof SHADER_COMPATIBILITY;
+        readonly transform: typeof SHADER_TRANSFORM_VERSION;
+        readonly address: typeof SHADER_ADDRESS_VERSION;
+        readonly recipe: typeof SHADER_RECIPE_VERSION;
+        readonly hydration: typeof SHADER_HYDRATION_VERSION;
+    };
+    readonly scenes: Readonly<Record<string, ShaderSceneReceipt>>;
+}
+interface LoadedShaderArtifact {
+    readonly status: ArtifactStatus;
+    readonly files: readonly GeneratedFile[];
+    readonly note: string;
+}
+/** Validate the exact pair emitted by public shader capture before it can become a fresh catalog payload. */
+export declare function validateShaderArtifactPayload(template: TemplateName, manifest: string | Uint8Array, metadata: string | Uint8Array, versions?: Pick<CompatibilityVersions, 'three' | 'threeBlocks'>): ShaderReceipt;
+export declare function shaderArtifactPaths(template: TemplateName): readonly string[];
+export declare function shaderArtifactFiles(template: TemplateName): readonly GeneratedFile[];
+export declare function shaderArtifactState(template: TemplateName): Pick<LoadedShaderArtifact, 'status' | 'note'>;
+/** Prove that a fresh payload was captured from the exact fully composed generated template. */
+export declare function validateShaderArtifactProject(template: TemplateName, files: ReadonlyMap<string, GeneratedFile>, versions: Pick<CompatibilityVersions, 'three' | 'threeBlocks'>): void;
+export declare function textArtifactFiles(): readonly GeneratedFile[];
+export declare const textArtifactPaths: readonly string[];
+export {};