@finedesign/cli 0.1.0-rc.0 → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -2,15 +2,15 @@
2
2
  "schemaVersion": 1,
3
3
  "version": "1.24.9",
4
4
  "sourceKind": "repository-snapshot",
5
- "sourceRevision": "47587888b8857bab7565961347b2cf0de9a34693",
6
- "sourceDirty": true,
7
- "contentHash": "d5cc537c066dfe3537fcfb48929fa82daff9a46b4afd87770652a7e6e76bef5f",
8
- "catalogSha256": "336f4c4d3d163e73df57ba2a4eeab7deb76659e86eb48d3242d9971e9ada60fa",
5
+ "sourceRevision": "1ba338c3b7ed781b1909da59ff12f240e6e2740e",
6
+ "sourceDirty": false,
7
+ "contentHash": "1cf7da0c80b04eb8cd208bf3d00238013946b72c780b58482d940f9376ef4504",
8
+ "catalogSha256": "cb2f6de948ca9b34cd827924db46e2885680780601001559236db3768cd31bcf",
9
9
  "skillFiles": {
10
10
  "references/component-guide.md": "25508c9f1a36708d5dd221ca94a5942ba714cf199ce38a5eefd9cc4a9344bc36",
11
11
  "references/docs-slug-map.md": "87e6814abe1a9509e99fcd92590756416db16a9394ff35aafc1729a7bacd2ae5",
12
- "references/imports-and-setup.md": "a111bed0b13064b5be3bcec2b899fdd471e0e136c5d0a576ea62248fa35ac753",
12
+ "references/imports-and-setup.md": "9805fbdb4f2ee4d72b7ddc136299d533836918ed99c109528ebe37c64cc1b08c",
13
13
  "references/theme-and-dark-mode.md": "84aa0ff4245a989c1ccd6028e687946b71c1a0bebf8fd3893b09e5acd622478a",
14
- "SKILL.md": "c94b678c5e714d0afb9eddf196795cc80561de58fcda700d7bf7849a37791074"
14
+ "SKILL.md": "043f18f35c519681d53ba591f219860be4807620214c4e6f2f8c449e1b0ed6af"
15
15
  }
16
16
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@finedesign/cli",
3
- "version": "0.1.0-rc.0",
3
+ "version": "0.1.0",
4
4
  "description": "Read-only, versioned Fine Design documentation for coding agents",
5
5
  "license": "MIT",
6
6
  "publishConfig": {
@@ -27,5 +27,5 @@ Use `/fine-design` for component pages, fixes, and reviews. This folder guides A
27
27
 
28
28
  | Condition | Reference |
29
29
  | --- | --- |
30
- | Version mismatch, unavailable docs, imports, or standalone setup | [imports-and-setup.md](references/imports-and-setup.md) |
30
+ | Version mismatch, installation failures, unavailable docs, imports, or standalone setup | [imports-and-setup.md](references/imports-and-setup.md) |
31
31
  | Theme, dark mode, or scoped themes | [theme-and-dark-mode.md](references/theme-and-dark-mode.md) |
@@ -7,6 +7,32 @@
7
7
  - If docs are unavailable, use matching local declarations and examples; inspect only unresolved implementation details. State remaining uncertainty. Do not upgrade dependencies merely to fit an example, or infer full React-major compatibility from a permissive peer range.
8
8
  - Reuse the existing installation and package manager. A new project may install `@fx-ui/fine-design` when needed.
9
9
 
10
+ ## Component Installation And Registry
11
+
12
+ The public `@finedesign/cli` package does not require company-registry credentials. Installing the component library `@fx-ui/fine-design` is separate. CLI documentation queries can use an explicit supported `--fd-version` without installing the component library.
13
+
14
+ If component installation fails, inspect the effective configuration from the consuming project:
15
+
16
+ ```sh
17
+ npm config get @fx-ui:registry
18
+ npm config get registry
19
+ npm config get userconfig
20
+ ```
21
+
22
+ A missing project `.npmrc` does not prove missing configuration: npm also uses user/global files, environment variables and command-line options. An isolated directory or global install does not inherit another project's `.npmrc`. Reuse an existing authorized configuration by path instead of copying its credentials. For a project confirmed to use version 1.24.9:
23
+
24
+ ```sh
25
+ npm install @fx-ui/fine-design@1.24.9 --userconfig=/absolute/path/to/.npmrc
26
+ ```
27
+
28
+ For a new project that needs the company source, configure only the required scope; preserve existing settings and the default registry:
29
+
30
+ ```ini
31
+ @fx-ui:registry=https://npm.jdydevelop.com/
32
+ ```
33
+
34
+ Use `npm login --scope=@fx-ui --registry=https://npm.jdydevelop.com/` when authentication is needed. Never print, embed or distribute tokens. `E401`/`E403` require checking credentials and package permissions; `E404` may indicate a wrong registry, unavailable version or hidden access restriction. Connection errors require checking network/VPN/proxy access. Do not infer the cause from `.npmrc` existence or registry reachability alone.
35
+
10
36
  ## Package Imports And Styles
11
37
 
12
38
  ```tsx
@@ -20,6 +46,8 @@ Single-file output includes all required code and styles; no unresolved `styles.
20
46
 
21
47
  ## Standalone HTML
22
48
 
49
+ Use this path when the user wants a standalone preview. Do not silently replace an existing React project with CDN runtime code to bypass an installation failure.
50
+
23
51
  The public UMD runtime replaces package imports. Load in this order:
24
52
 
25
53
  ```html
@@ -19,5 +19,10 @@ export function resolveVersion(explicit, project = process.cwd()) {
19
19
  if (parent === directory) break;
20
20
  directory = parent;
21
21
  }
22
- throw new ToolError('VERSION_NOT_DETECTED', 'Cannot determine the installed Fine Design version.', 3, { suggestions: ['Install @fx-ui/fine-design in the project or specify --fd-version.'] });
22
+ throw new ToolError('VERSION_NOT_DETECTED', 'Cannot find an installed @fx-ui/fine-design version in this project or its parent directories.', 3, { suggestions: [
23
+ 'Run from the component project or pass --project <directory>.',
24
+ 'For offline documentation without installing components, pass --fd-version <exact-supported-version>.',
25
+ 'If component installation fails, check the effective registry with npm config get @fx-ui:registry and npm config get registry.',
26
+ 'Reuse existing npm credentials with --userconfig=/absolute/path/to/.npmrc; configuration may also come from user/global files or environment variables. See README installation troubleshooting.'
27
+ ] });
23
28
  }