@astryxdesign/charts 0.0.0-bootstrap.0 → 0.1.3-canary.e3beb97

package/CHANGELOG.md

@@ -0,0 +1 @@
+# @astryxdesign/charts

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Meta Platforms, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE 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 AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,33 @@
 # @astryxdesign/charts
 
-This is a `0.0.0-bootstrap.0` placeholder published only to claim the npm name while configuring npm trusted publishing. Do not install it; it will be superseded by the first real release.
+Astryx chart components. This package provides thin, themeable wrappers over a peer charting engine — it owns the design-system surface while leaving the rendering engine as a peer dependency the consumer manages.
+
+It ships to npm **only under the `@canary` dist-tag** — there is never a stable (`latest`) release yet.
+
+## Status
+
+**Bootstrap scaffold.** The package is set up and building but ships no components yet. Add components under `src/` and export them from `src/index.ts`. The StyleX + Astryx-token build setup mirrors `@astryxdesign/lab`, so components can consume `@astryxdesign/core` theme tokens directly.
+
+> When the first component adds StyleX styles, wire up a pre-compiled stylesheet the same way `lab` does: add a `charts` target to `scripts/build-css.mjs`, restore the `build:css` script and the `./charts.css` export in `package.json`, and document the `import '@astryxdesign/charts/charts.css'` step below.
+
+## Usage
+
+Inside the monorepo (storybook/sandbox), imports resolve via pnpm workspaces:
+
+```tsx
+import {} from /* ... */ '@astryxdesign/charts';
+```
+
+### Trying charts in your own project (canary)
+
+`@astryxdesign/charts` is published **only** under the `@canary` dist-tag, so you must request that tag explicitly. There is no `latest` version to install.
+
+```bash
+npm install @astryxdesign/charts@canary @astryxdesign/core@canary
+```
+
+> Canary builds track the latest commit on `main` (`0.x.y-canary.<sha>`). They can break between any two versions — pin an exact version if you need stability.
+
+## Why no stable release?
+
+`package.json` keeps `"private": true` plus an `"astryx": { "canaryOnly": true }` marker. The release workflow's stable (`latest`) job skips both private and `canaryOnly` packages, while the canary job strips `private` in its ephemeral CI checkout only (never in git) to publish the `@canary` tag. The committed `private: true` is npm's hard guarantee that no stable publish can ever happen — **do not remove it.**

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @astryxdesign/charts — Astryx chart components
+ *
+ * Thin, themeable wrappers over a peer charting engine. This package owns the
+ * design-system surface while leaving the rendering engine as a peer
+ * dependency the consumer manages.
+ *
+ * This package is published to npm ONLY under the @canary dist-tag
+ * (npm install @astryxdesign/charts@canary). It is never released as a
+ * stable (latest) version.
+ *
+ * Bootstrap scaffold — no components yet. Add exports here as components land.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @astryxdesign/charts — Astryx chart components
+ *
+ * Thin, themeable wrappers over a peer charting engine. This package owns the
+ * design-system surface while leaving the rendering engine as a peer
+ * dependency the consumer manages.
+ *
+ * This package is published to npm ONLY under the @canary dist-tag
+ * (npm install @astryxdesign/charts@canary). It is never released as a
+ * stable (latest) version.
+ *
+ * Bootstrap scaffold — no components yet. Add exports here as components land.
+ */
+
+export {};

package/package.json

@@ -1,11 +1,58 @@
 {
   "name": "@astryxdesign/charts",
-  "version": "0.0.0-bootstrap.0",
-  "description": "Placeholder published to claim the npm name during trusted publishing setup. Do not install.",
-  "homepage": "https://github.com/facebook/astryx",
+  "version": "0.1.3-canary.e3beb97",
+  "description": "Astryx chart components — thin, themeable wrappers over a peer charting engine. Published to npm only under the @canary dist-tag for early testing; never released as a stable (latest) version.",
+  "author": "Meta Open Source",
   "license": "MIT",
+  "homepage": "https://github.com/facebook/astryx#readme",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/facebook/astryx.git"
+    "url": "git+https://github.com/facebook/astryx.git",
+    "directory": "packages/charts"
+  },
+  "bugs": {
+    "url": "https://github.com/facebook/astryx/issues"
+  },
+  "keywords": [
+    "astryx",
+    "charts",
+    "data-visualization",
+    "design-system"
+  ],
+  "astryx": {
+    "canaryOnly": true,
+    "_comment": "Published ONLY to the @canary dist-tag (see .github/workflows/release.yml). Never published as a stable `latest` release. `private: true` is intentional and must stay — it is npm's hard guarantee against an accidental stable publish."
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "peerDependencies": {
+    "@stylexjs/stylex": ">=0.10.0",
+    "@astryxdesign/core": "0.1.3-canary.e3beb97",
+    "react": ">=19.0.0",
+    "react-dom": ">=19.0.0"
+  },
+  "scripts": {
+    "build": "rm -rf dist && pnpm build:esm && tsc --project tsconfig.build.json",
+    "build:esm": "babel src --out-dir dist --extensions '.ts,.tsx' --out-file-extension '.js' --ignore '**/*.test.ts,**/*.test.tsx,**/__tests__/**,**/*.perf.test.*,**/*.doc.mjs,**/*.d.ts,**/*.css,**/*.css.d.ts' --config-file ./babel.config.js",
+    "dev": "babel src --watch --out-dir dist --extensions '.ts,.tsx' --out-file-extension '.js' --ignore '**/*.test.*,**/*.doc.mjs,**/*.d.ts,**/*.css*' --config-file ./babel.config.js",
+    "test": "vitest run --root ../..",
+    "test:watch": "vitest --root ../..",
+    "lint": "eslint src",
+    "typecheck": "tsc --project tsconfig.json --noEmit"
   }
-}
+}

package/src/index.ts

@@ -0,0 +1,17 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @astryxdesign/charts — Astryx chart components
+ *
+ * Thin, themeable wrappers over a peer charting engine. This package owns the
+ * design-system surface while leaving the rendering engine as a peer
+ * dependency the consumer manages.
+ *
+ * This package is published to npm ONLY under the @canary dist-tag
+ * (npm install @astryxdesign/charts@canary). It is never released as a
+ * stable (latest) version.
+ *
+ * Bootstrap scaffold — no components yet. Add exports here as components land.
+ */
+
+export {};