@oprt/cli 0.1.0 → 0.4.0

package/dist/{read-8a9euzJx.d.cts → read-C7rE5UlY.d.cts}

@@ -44,12 +44,38 @@ interface ComponentGuidance {
     }[];
     values?: Record<string, Record<string, string>>;
 }
+/** What a project needs besides the source it copies or the package it imports. */
+interface ContractSetup {
+    tailwind: string;
+    packages: {
+        name: string;
+        dev: boolean;
+        why: string;
+        range?: string;
+    }[];
+    stylesheet: {
+        line: string;
+        why: string;
+    }[];
+    package_source: {
+        when: string;
+        line: string;
+        why: string;
+    };
+    root_import: string;
+    root_import_note: string;
+    not_needed: {
+        name: string;
+        why: string;
+    }[];
+}
 interface Contract {
     version: string;
     components: Record<string, ContractComponent>;
     composition_rules?: Record<string, CompositionRule>;
     patterns?: Record<string, ContractRecipe>;
     guidance: {
+        setup: ContractSetup;
         rules: GuidanceRule[];
         components: Record<string, ComponentGuidance>;
     };
@@ -111,6 +137,7 @@ type Command = {
     json: boolean;
 } | ({
     command: "add";
+    json: boolean;
 } & Required<AddOptions>) | {
     command: "component";
     names: string[];
@@ -155,26 +182,6 @@ declare class CliError extends Error {
     });
 }
 
-declare const START = "<!-- OPERATOR:START -->";
-declare const END = "<!-- OPERATOR:END -->";
-/** The block for this contract, markers included, ending in a newline. */
-declare function renderAgentBlock(contract: Contract): string;
-/** The version of the installer that wrote the block in a text, if it holds one. */
-declare function blockVersion(text: string): string | undefined;
-/**
- * Put the block into a file's text. A file without one gains it at the end; a file with one has
- * only that part replaced, so whatever else the file says is kept.
- */
-declare function applyBlock(existing: string | null, block: string): {
-    text: string;
-    action: "create" | "append" | "update" | "unchanged";
-};
-/** Take the block out of a file's text, with the blank line that set it apart. */
-declare function removeBlock(existing: string): {
-    text: string;
-    found: boolean;
-};
-
 interface IndexEntry {
     name: string;
     /** What it is for, in the words a person would ask with. */
@@ -243,4 +250,24 @@ declare function renderComponent(detail: ComponentDetail, { dense }: {
  */
 declare function search(contract: Contract, registry: Registry, query: string, limit?: number): SearchResult[];
 
-export { type AddOptions as A, type Command as C, type DetailProp as D, END as E, type InstallResult as I, type Registry as R, type SearchResult as S, type Contract as a, type RegistryEntry as b, CliError as c, type ComponentDetail as d, type IndexEntry as e, type InstallFile as f, applyBlock as g, blockVersion as h, componentDetail as i, componentIndex as j, renderAgentBlock as k, renderComponent as l, START as m, removeBlock as r, search as s };
+declare const START = "<!-- OPERATOR:START -->";
+declare const END = "<!-- OPERATOR:END -->";
+/** The block for this contract, markers included, ending in a newline. */
+declare function renderAgentBlock(contract: Contract): string;
+/** The version of the installer that wrote the block in a text, if it holds one. */
+declare function blockVersion(text: string): string | undefined;
+/**
+ * Put the block into a file's text. A file without one gains it at the end; a file with one has
+ * only that part replaced, so whatever else the file says is kept.
+ */
+declare function applyBlock(existing: string | null, block: string): {
+    text: string;
+    action: "create" | "append" | "update" | "unchanged";
+};
+/** Take the block out of a file's text, with the blank line that set it apart. */
+declare function removeBlock(existing: string): {
+    text: string;
+    found: boolean;
+};
+
+export { type AddOptions as A, type Contract as C, type DetailProp as D, END as E, type InstallResult as I, type Registry as R, type SearchResult as S, type ComponentDetail as a, type Command as b, type RegistryEntry as c, CliError as d, type IndexEntry as e, type InstallFile as f, applyBlock as g, blockVersion as h, componentDetail as i, componentIndex as j, renderAgentBlock as k, renderComponent as l, START as m, removeBlock as r, search as s };

package/dist/{read-8a9euzJx.d.ts → read-C7rE5UlY.d.ts}

@@ -44,12 +44,38 @@ interface ComponentGuidance {
     }[];
     values?: Record<string, Record<string, string>>;
 }
+/** What a project needs besides the source it copies or the package it imports. */
+interface ContractSetup {
+    tailwind: string;
+    packages: {
+        name: string;
+        dev: boolean;
+        why: string;
+        range?: string;
+    }[];
+    stylesheet: {
+        line: string;
+        why: string;
+    }[];
+    package_source: {
+        when: string;
+        line: string;
+        why: string;
+    };
+    root_import: string;
+    root_import_note: string;
+    not_needed: {
+        name: string;
+        why: string;
+    }[];
+}
 interface Contract {
     version: string;
     components: Record<string, ContractComponent>;
     composition_rules?: Record<string, CompositionRule>;
     patterns?: Record<string, ContractRecipe>;
     guidance: {
+        setup: ContractSetup;
         rules: GuidanceRule[];
         components: Record<string, ComponentGuidance>;
     };
@@ -111,6 +137,7 @@ type Command = {
     json: boolean;
 } | ({
     command: "add";
+    json: boolean;
 } & Required<AddOptions>) | {
     command: "component";
     names: string[];
@@ -155,26 +182,6 @@ declare class CliError extends Error {
     });
 }
 
-declare const START = "<!-- OPERATOR:START -->";
-declare const END = "<!-- OPERATOR:END -->";
-/** The block for this contract, markers included, ending in a newline. */
-declare function renderAgentBlock(contract: Contract): string;
-/** The version of the installer that wrote the block in a text, if it holds one. */
-declare function blockVersion(text: string): string | undefined;
-/**
- * Put the block into a file's text. A file without one gains it at the end; a file with one has
- * only that part replaced, so whatever else the file says is kept.
- */
-declare function applyBlock(existing: string | null, block: string): {
-    text: string;
-    action: "create" | "append" | "update" | "unchanged";
-};
-/** Take the block out of a file's text, with the blank line that set it apart. */
-declare function removeBlock(existing: string): {
-    text: string;
-    found: boolean;
-};
-
 interface IndexEntry {
     name: string;
     /** What it is for, in the words a person would ask with. */
@@ -243,4 +250,24 @@ declare function renderComponent(detail: ComponentDetail, { dense }: {
  */
 declare function search(contract: Contract, registry: Registry, query: string, limit?: number): SearchResult[];
 
-export { type AddOptions as A, type Command as C, type DetailProp as D, END as E, type InstallResult as I, type Registry as R, type SearchResult as S, type Contract as a, type RegistryEntry as b, CliError as c, type ComponentDetail as d, type IndexEntry as e, type InstallFile as f, applyBlock as g, blockVersion as h, componentDetail as i, componentIndex as j, renderAgentBlock as k, renderComponent as l, START as m, removeBlock as r, search as s };
+declare const START = "<!-- OPERATOR:START -->";
+declare const END = "<!-- OPERATOR:END -->";
+/** The block for this contract, markers included, ending in a newline. */
+declare function renderAgentBlock(contract: Contract): string;
+/** The version of the installer that wrote the block in a text, if it holds one. */
+declare function blockVersion(text: string): string | undefined;
+/**
+ * Put the block into a file's text. A file without one gains it at the end; a file with one has
+ * only that part replaced, so whatever else the file says is kept.
+ */
+declare function applyBlock(existing: string | null, block: string): {
+    text: string;
+    action: "create" | "append" | "update" | "unchanged";
+};
+/** Take the block out of a file's text, with the blank line that set it apart. */
+declare function removeBlock(existing: string): {
+    text: string;
+    found: boolean;
+};
+
+export { type AddOptions as A, type Contract as C, type DetailProp as D, END as E, type InstallResult as I, type Registry as R, type SearchResult as S, type ComponentDetail as a, type Command as b, type RegistryEntry as c, CliError as d, type IndexEntry as e, type InstallFile as f, applyBlock as g, blockVersion as h, componentDetail as i, componentIndex as j, renderAgentBlock as k, renderComponent as l, START as m, removeBlock as r, search as s };

package/dist/read.cjs

@@ -45,6 +45,7 @@ var CliError = class extends Error {
 };
 
 // src/lookup.ts
+var SEARCH_LIMIT_DEFAULT = 10;
 var squash = (name) => name.toLowerCase().replace(/[^a-z0-9]/g, "");
 var firstSentence = (text) => /^.*?[.!?](?=\s|$)/.exec(text)?.[0] ?? text;
 function distance(a, b) {
@@ -171,7 +172,7 @@ var matched = (query, text) => {
   const present = new Set(words(text));
   return query.filter((word) => present.has(word)).length;
 };
-function search(contract, registry, query, limit = 10) {
+function search(contract, registry, query, limit = SEARCH_LIMIT_DEFAULT) {
   const wanted = words(query);
   if (wanted.length === 0) return [];
   const whole = squash(query);

package/dist/read.d.cts

@@ -1 +1 @@
-export { d as ComponentDetail, a as Contract, D as DetailProp, E as END, e as IndexEntry, m as START, S as SearchResult, i as componentDetail, j as componentIndex, k as renderAgentBlock, l as renderComponent, s as search } from './read-8a9euzJx.cjs';
+export { a as ComponentDetail, C as Contract, D as DetailProp, E as END, e as IndexEntry, m as START, S as SearchResult, i as componentDetail, j as componentIndex, k as renderAgentBlock, l as renderComponent, s as search } from './read-C7rE5UlY.cjs';

package/dist/read.d.ts

@@ -1 +1 @@
-export { d as ComponentDetail, a as Contract, D as DetailProp, E as END, e as IndexEntry, m as START, S as SearchResult, i as componentDetail, j as componentIndex, k as renderAgentBlock, l as renderComponent, s as search } from './read-8a9euzJx.js';
+export { a as ComponentDetail, C as Contract, D as DetailProp, E as END, e as IndexEntry, m as START, S as SearchResult, i as componentDetail, j as componentIndex, k as renderAgentBlock, l as renderComponent, s as search } from './read-C7rE5UlY.js';

package/dist/read.js

@@ -13,6 +13,7 @@ var CliError = class extends Error {
 };
 
 // src/lookup.ts
+var SEARCH_LIMIT_DEFAULT = 10;
 var squash = (name) => name.toLowerCase().replace(/[^a-z0-9]/g, "");
 var firstSentence = (text) => /^.*?[.!?](?=\s|$)/.exec(text)?.[0] ?? text;
 function distance(a, b) {
@@ -139,7 +140,7 @@ var matched = (query, text) => {
   const present = new Set(words(text));
   return query.filter((word) => present.has(word)).length;
 };
-function search(contract, registry, query, limit = 10) {
+function search(contract, registry, query, limit = SEARCH_LIMIT_DEFAULT) {
   const wanted = words(query);
   if (wanted.length === 0) return [];
   const whole = squash(query);